@arkyn/shared 1.4.57 → 1.5.0

package/dist/formats/formatToHiddenDigits.js

@@ -1,52 +1,6 @@
-const DIGIT = /^\d$/;
-const parseToCharacters = (value) => {
-    let digits = 0;
-    const children = value
-        .split("")
-        .map((character) => {
-        if (DIGIT.test(character))
-            return { character, kind: "digit", digit: ++digits };
-        return { character, kind: "other" };
-    });
-    return { digits, children, kind: "root" };
-};
-const normalizeRange = (range, limit) => {
-    if (Array.isArray(range))
-        return range;
-    if (range >= 0)
-        return [0, range];
-    return [limit + 1 - Math.abs(range), limit];
-};
-const within = (range, value) => value >= range[0] && value <= range[1];
-/**
- * Formats a string by hiding specific digits within a given range.
- *
- * This function takes a string input and replaces digits within a specified range
- * with a hiding character (e.g., "*"). Non-digit characters remain unchanged.
- *
- * @param value - The input string to be formatted.
- * @param options - Configuration options for formatting.
- * @param options.range - The range of digits to hide. It can be:
- *   - A single number (e.g., `3`), which hides the first `n` digits if positive,
- *     or the last `n` digits if negative.
- *   - A tuple `[start, end]` specifying the range of digits to hide (inclusive).
- *   - Defaults to `3`, hiding the first three digits.
- * @param options.hider - The character used to hide digits. Defaults to `"*"`.
- *
- * @returns The formatted string with specified digits hidden.
- *
- * @example
- * ```typescript
- * import { formatToHiddenDigits } from "./formatToHiddenDigits";
- *
- * formatToHiddenDigits("123-456-7890", { range: 3 });
- * // Output: "***-456-7890"
- *
- * formatToHiddenDigits("123-456-7890", { range: [4, 6], hider: "#" });
- * // Output: "123-###-7890"
- * ```
- */
-const formatToHiddenDigits = (value, options) => {
+import { parseToCharacters } from "../parsers/parseToCharacters";
+import { normalizeRange, within } from "../services/range";
+const formatToHiddenDigits = (value, options = {}) => {
     const characters = parseToCharacters(value);
     const range = normalizeRange(options.range ?? 3, characters.digits);
     return characters.children

package/dist/formats/formatToPhone.d.ts

@@ -1,34 +1,3 @@
-import type { FormatToPhoneFunction } from "@arkyn/types";
-/**
- * Formats a phone number string based on the provided country code and optional prefix.
- *
- * The input string should follow the format: `"<countryCode>-<prefix> <phoneNumber>"` or `"<countryCode> <phoneNumber>"`.
- * The function determines the appropriate formatting mask based on the country and applies it to the phone number.
- *
- * @param prop - The phone number string to be formatted. It must include the country code and optionally a prefix.
- *               Example formats:
- *               - "+55-11 912345678"
- *               - "+1 1234567890"
- *
- * @returns The formatted phone number string based on the country's formatting rules.
- *
- * @throws {Error} If the input phone number does not match the expected format.
- * @throws {Error} If the country code or phone number is missing from the input string.
- * @throws {Error} If the provided country code and prefix combination is invalid.
- * @throws {Error} If the provided country code is invalid.
- * @throws {Error} If the provided country code has a prefix but none is supplied in the input.
- *
- * @example
- * ```typescript
- * import { formatToPhone } from "./formatToPhone";
- *
- * const formattedPhone1 = formatToPhone("+55 11912345678");
- * console.log(formattedPhone1); // Output: "(11) 91234-5678" (brazilian phone number format)
- *
- * const formattedPhone2 = formatToPhone("+1-123 4567890");
- * console.log(formattedPhone2); // Output: "(123) 456-7890" (us phone number format)
- * ```
- */
-declare const formatToPhone: FormatToPhoneFunction;
+declare function formatToPhone(value: string): string;
 export { formatToPhone };
 //# sourceMappingURL=formatToPhone.d.ts.map

package/dist/formats/formatToPhone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatToPhone.d.ts","sourceRoot":"","sources":["../../src/formats/formatToPhone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAqGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,QAAA,MAAM,aAAa,EAAE,qBAwBpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"formatToPhone.d.ts","sourceRoot":"","sources":["../../src/formats/formatToPhone.ts"],"names":[],"mappings":"AAAA,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/formats/formatToPhone.js

@@ -1,131 +1,9 @@
-import { countries } from "@arkyn/templates";
-import { removeNonNumeric } from "../services/removeNonNumeric";
-function getMask(value) {
-    const mask = value.length > 10 ? "NINE" : "EIGTH";
-    return mask;
-}
-const TYPES = {
-    EIGTH: "(99) 9999-9999",
-    NINE: "(99) 99999-9999",
-};
-const MAX_LENGTH = removeNonNumeric(TYPES.NINE).length;
-function applyMask(value, maskPattern) {
-    let result = "";
-    let digitIndex = 0;
-    for (let i = 0; i < maskPattern.length; i++) {
-        if (maskPattern[i] === "9") {
-            if (digitIndex < value.length) {
-                result += value[digitIndex];
-                digitIndex++;
-            }
-            else {
-                break;
-            }
-        }
-        else {
-            if (digitIndex < value.length) {
-                result += maskPattern[i];
-            }
-            else {
-                break;
-            }
-        }
-    }
-    return result;
-}
-function formatPhoneNumber(phoneNumber, country) {
-    if (country.code === "+55") {
-        let value = removeNonNumeric(phoneNumber);
-        const mask = getMask(value);
-        let nextLength = value.length;
-        if (nextLength > MAX_LENGTH)
-            return value;
-        value = applyMask(value, TYPES[mask]);
-        return value;
-    }
-    const mask = country.mask;
-    let formattedNumber = mask;
-    if (country.prefix) {
-        const prefixRegex = /\$+/g;
-        formattedNumber = formattedNumber.replace(prefixRegex, country.prefix);
-    }
-    for (let i = 0, j = 0; i < formattedNumber.length && j < phoneNumber.length; i++) {
-        if (formattedNumber[i] === "_") {
-            formattedNumber =
-                formattedNumber.substring(0, i) +
-                    phoneNumber[j] +
-                    formattedNumber.substring(i + 1);
-            j++;
-        }
-    }
-    return formattedNumber;
-}
-function getCountryWithPrefixCode(countryCode, prefix) {
-    const country = countries.find((country) => country.code === countryCode && country.prefix === prefix);
-    if (!country)
-        throw new Error("Invalid country code or prefix");
-    if (country.prefix !== prefix) {
-        throw new Error("Invalid country code or prefix");
-    }
-    if (!country.prefix) {
-        throw new Error("Invalid country code or prefix");
+function formatToPhone(value) {
+    const cleaned = value.replace(/\D/g, "");
+    const match = cleaned.match(/^(\d{2})(\d{5})(\d{4})$/);
+    if (match) {
+        return `(${match[1]}) ${match[2]}-${match[3]}`;
     }
-    return country;
-}
-function getCountryWithoutPrefixCode(countryCode) {
-    const country = countries.find((country) => country.code === countryCode);
-    if (!country)
-        throw new Error("Invalid country code");
-    if (country.prefix)
-        throw new Error("Invalid country code");
-    return country;
+    return value;
 }
-/**
- * Formats a phone number string based on the provided country code and optional prefix.
- *
- * The input string should follow the format: `"<countryCode>-<prefix> <phoneNumber>"` or `"<countryCode> <phoneNumber>"`.
- * The function determines the appropriate formatting mask based on the country and applies it to the phone number.
- *
- * @param prop - The phone number string to be formatted. It must include the country code and optionally a prefix.
- *               Example formats:
- *               - "+55-11 912345678"
- *               - "+1 1234567890"
- *
- * @returns The formatted phone number string based on the country's formatting rules.
- *
- * @throws {Error} If the input phone number does not match the expected format.
- * @throws {Error} If the country code or phone number is missing from the input string.
- * @throws {Error} If the provided country code and prefix combination is invalid.
- * @throws {Error} If the provided country code is invalid.
- * @throws {Error} If the provided country code has a prefix but none is supplied in the input.
- *
- * @example
- * ```typescript
- * import { formatToPhone } from "./formatToPhone";
- *
- * const formattedPhone1 = formatToPhone("+55 11912345678");
- * console.log(formattedPhone1); // Output: "(11) 91234-5678" (brazilian phone number format)
- *
- * const formattedPhone2 = formatToPhone("+1-123 4567890");
- * console.log(formattedPhone2); // Output: "(123) 456-7890" (us phone number format)
- * ```
- */
-const formatToPhone = (prop) => {
-    const phoneRegex = /^\+\d{1,4}(-\d{1,4})? \d+$/;
-    if (!phoneRegex.test(prop)) {
-        throw new Error("Invalid phone number format. Expected format: +<countryCode>-<optionalPrefix> <phoneNumber>");
-    }
-    const countryCode = prop.split(" ")[0].split("-")[0];
-    const prefixCode = prop.split(" ")[0].split("-")[1];
-    const phoneNumber = prop.split(" ")[1];
-    if (!countryCode || !phoneNumber) {
-        throw new Error("Invalid phone number format");
-    }
-    if (prefixCode) {
-        const country = getCountryWithPrefixCode(countryCode, prefixCode);
-        return formatPhoneNumber(phoneNumber, country);
-    }
-    const country = getCountryWithoutPrefixCode(countryCode);
-    return formatPhoneNumber(phoneNumber, country);
-};
 export { formatToPhone };

package/dist/generators/generateColorByString.d.ts

@@ -1,15 +1,3 @@
-import type { GenerateColorByStringFunction } from "@arkyn/types";
-/**
- * Generates a hexadecimal color code based on the input string.
- * The function creates a hash from the string and uses it to calculate
- * RGB values, which are then converted to a hexadecimal color code.
- *
- * @param prop - The input string used to generate the color.
- * @returns A hexadecimal color code (e.g., "#a1b2c3") derived from the input string.
- * @example
- * const color = generateColorByString("example");
- * console.log(color); // Outputs a consistent hex color like "#5e8f9a"
- */
-declare const generateColorByString: GenerateColorByStringFunction;
+declare function generateColorByString(string: string): string;
 export { generateColorByString };
 //# sourceMappingURL=generateColorByString.d.ts.map

package/dist/generators/generateColorByString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateColorByString.d.ts","sourceRoot":"","sources":["../../src/generators/generateColorByString.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;;;;GAUG;AAEH,QAAA,MAAM,qBAAqB,EAAE,6BAgB5B,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"generateColorByString.d.ts","sourceRoot":"","sources":["../../src/generators/generateColorByString.ts"],"names":[],"mappings":"AAAA,iBAAS,qBAAqB,CAAC,MAAM,EAAE,MAAM,UAgB5C;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/generators/generateColorByString.js

@@ -1,18 +1,7 @@
-/**
- * Generates a hexadecimal color code based on the input string.
- * The function creates a hash from the string and uses it to calculate
- * RGB values, which are then converted to a hexadecimal color code.
- *
- * @param prop - The input string used to generate the color.
- * @returns A hexadecimal color code (e.g., "#a1b2c3") derived from the input string.
- * @example
- * const color = generateColorByString("example");
- * console.log(color); // Outputs a consistent hex color like "#5e8f9a"
- */
-const generateColorByString = (prop) => {
+function generateColorByString(string) {
     var hash = 0;
-    for (var i = 0; i < prop.length; i++) {
-        hash = prop.charCodeAt(i) + ((hash << 5) - hash);
+    for (var i = 0; i < string.length; i++) {
+        hash = string.charCodeAt(i) + ((hash << 5) - hash);
     }
     var red = (hash & 0xff0000) >> 16;
     var green = (hash & 0x00ff00) >> 8;
@@ -21,5 +10,5 @@ const generateColorByString = (prop) => {
     var greenHex = green.toString(16).padStart(2, "0");
     var blueHex = blue.toString(16).padStart(2, "0");
     return "#" + redHex + greenHex + blueHex;
-};
+}
 export { generateColorByString };

package/dist/generators/generateId.d.ts

@@ -1,28 +1,6 @@
-/**
- * Generates a unique identifier (UUID) in the specified format and type.
- *
- * @param type - The desired output type of the UUID. Can be:
- *   - `"text"`: Returns the UUID as a string.
- *   - `"binary"`: Returns the UUID as a `Uint8Array` in binary format.
- * @param format - The version of the UUID to generate. Can be:
- *   - `"v4"`: Generates a random UUID (version 4).
- *   - `"v7"`: Generates a time-ordered UUID (version 7).
- * @returns The generated UUID in the specified type and format.
- *   - If `type` is `"text"`, a string representation of the UUID is returned.
- *   - If `type` is `"binary"`, a `Uint8Array` representation of the UUID is returned.
- * @throws {Error} If an invalid `type` or `format` is provided.
- *
- * @example
- * // Generate a version 4 UUID as a string
- * const idTextV4 = generateId("text", "v4");
- * console.log(idTextV4); // e.g., "550e8400-e29b-41d4-a716-446655440000"
- *
- * @example
- * // Generate a version 7 UUID as binary
- * const idBinaryV7 = generateId("binary", "v7");
- * console.log(idBinaryV7); // Uint8Array([...])
- */
-declare function generateId(type: "text", format: "v4" | "v7"): string;
-declare function generateId(type: "binary", format: "v4" | "v7"): Uint8Array;
+declare function generateId(type: "text" | "binary"): {
+    v4: string | Uint8Array<ArrayBuffer>;
+    v7: string | Uint8Array<ArrayBuffer>;
+};
 export { generateId };
 //# sourceMappingURL=generateId.d.ts.map

package/dist/generators/generateId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../src/generators/generateId.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAC/D,iBAAS,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,CAAC;AAYrE,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../src/generators/generateId.ts"],"names":[],"mappings":"AAsBA,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;;;EAK1C;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/generators/generateId.js

@@ -1,6 +1,5 @@
 import { v4, v7 } from "uuid";
 function hexToBin(hex) {
-    hex = hex.replace(/-/g, "");
     const buffer = new Uint8Array(hex.length / 2);
     for (let i = 0; i < hex.length; i += 2) {
         buffer[i / 2] = parseInt(hex.substring(i, i + 2), 16);
@@ -15,15 +14,10 @@ function uuidV7() {
     const uuid = v7();
     return { text: uuid, binary: hexToBin(uuid) };
 }
-function generateId(type, format) {
-    if (type === "text" && format === "v4")
-        return uuidV4().text;
-    if (type === "binary" && format === "v4")
-        return uuidV4().binary;
-    if (type === "text" && format === "v7")
-        return uuidV7().text;
-    if (type === "binary" && format === "v7")
-        return uuidV7().binary;
-    throw new Error("Invalid type or format");
+function generateId(type) {
+    return {
+        v4: uuidV4()[type],
+        v7: uuidV7()[type],
+    };
 }
 export { generateId };

package/dist/generators/generateSlug.d.ts

@@ -1,17 +1,3 @@
-/**
- * Generates a URL-friendly slug from a given string.
- *
- * The function performs the following transformations:
- * - Normalizes the string to remove diacritical marks (e.g., accents).
- * - Removes non-alphanumeric characters except for spaces and hyphens.
- * - Replaces spaces with hyphens.
- * - Converts the string to lowercase.
- * - Collapses multiple consecutive hyphens into a single hyphen.
- * - Trims leading and trailing hyphens.
- *
- * @param string - The input string to be converted into a slug.
- * @returns A URL-friendly slug derived from the input string.
- */
-declare function generateSlug(prop: string): string;
+declare function generateSlug(string: string): string;
 export { generateSlug };
 //# sourceMappingURL=generateSlug.d.ts.map

package/dist/generators/generateSlug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateSlug.d.ts","sourceRoot":"","sources":["../../src/generators/generateSlug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,UAajC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"generateSlug.d.ts","sourceRoot":"","sources":["../../src/generators/generateSlug.ts"],"names":[],"mappings":"AAAA,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,UAanC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/generators/generateSlug.js

@@ -1,19 +1,5 @@
-/**
- * Generates a URL-friendly slug from a given string.
- *
- * The function performs the following transformations:
- * - Normalizes the string to remove diacritical marks (e.g., accents).
- * - Removes non-alphanumeric characters except for spaces and hyphens.
- * - Replaces spaces with hyphens.
- * - Converts the string to lowercase.
- * - Collapses multiple consecutive hyphens into a single hyphen.
- * - Trims leading and trailing hyphens.
- *
- * @param string - The input string to be converted into a slug.
- * @returns A URL-friendly slug derived from the input string.
- */
-function generateSlug(prop) {
-    let slug = prop.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+function generateSlug(string) {
+    let slug = string.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
     slug = slug
         .replace(/[^\w\s-]/g, "")
         .replace(/\s+/g, "-")

package/dist/index.d.ts

@@ -1,23 +1,26 @@
-export { formatDate } from "./formats/formatDate";
+export { formatBrazilianDateHour } from "./formats/formatBrazilianDateHour";
+export { formatBrazilianDateToDate } from "./formats/formatBrazilianDateToDate";
+export { formatDateHour } from "./formats/formatDateHour";
 export { formatJsonObject } from "./formats/formatJsonObject";
 export { formatJsonString } from "./formats/formatJsonString";
+export { formatToBRL } from "./formats/formatToBRL";
 export { formatToCep } from "./formats/formatToCep";
-export { formatToCnpj } from "./formats/formatToCnpj";
-export { formatToCpf } from "./formats/formatToCpf";
+export { formatToCNPJ } from "./formats/formatToCNPJ";
+export { formatToCPF } from "./formats/formatToCPF";
 export { formatToCpfCnpj } from "./formats/formatToCpfCnpj";
-export { formatToCurrency } from "./formats/formatToCurrency";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";
-export { regex } from "./regex";
+export { parseToCharacters } from "./parsers/parseToCharacters";
 export { calculateCardInstallment } from "./services/calculateCardInstallment";
 export { maskSensitiveData } from "./services/maskSensitiveData";
-export { removeNonNumeric } from "./services/removeNonNumeric";
+export { normalizeRange, within } from "./services/range";
 export { truncateLargeFields } from "./services/truncateLargeFields";
-export { validateCpf } from "./validations/validateCpf";
+export { regex } from "./validations/regex";
+export { validateCPF } from "./validations/validateCPF";
 export { validateDate } from "./validations/validateDate";
 export { validatePhone } from "./validations/validatePhone";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,22 +1,30 @@
-export { formatDate } from "./formats/formatDate";
+// formats
+export { formatBrazilianDateHour } from "./formats/formatBrazilianDateHour";
+export { formatBrazilianDateToDate } from "./formats/formatBrazilianDateToDate";
+export { formatDateHour } from "./formats/formatDateHour";
 export { formatJsonObject } from "./formats/formatJsonObject";
 export { formatJsonString } from "./formats/formatJsonString";
+export { formatToBRL } from "./formats/formatToBRL";
 export { formatToCep } from "./formats/formatToCep";
-export { formatToCnpj } from "./formats/formatToCnpj";
-export { formatToCpf } from "./formats/formatToCpf";
+export { formatToCNPJ } from "./formats/formatToCNPJ";
+export { formatToCPF } from "./formats/formatToCPF";
 export { formatToCpfCnpj } from "./formats/formatToCpfCnpj";
-export { formatToCurrency } from "./formats/formatToCurrency";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
+// generators
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";
-export { regex } from "./regex";
+// parsers
+export { parseToCharacters } from "./parsers/parseToCharacters";
+// services
 export { calculateCardInstallment } from "./services/calculateCardInstallment";
 export { maskSensitiveData } from "./services/maskSensitiveData";
-export { removeNonNumeric } from "./services/removeNonNumeric";
+export { normalizeRange, within } from "./services/range";
 export { truncateLargeFields } from "./services/truncateLargeFields";
-export { validateCpf } from "./validations/validateCpf";
+// validations
+export { regex } from "./validations/regex";
+export { validateCPF } from "./validations/validateCPF";
 export { validateDate } from "./validations/validateDate";
 export { validatePhone } from "./validations/validatePhone";

package/dist/parsers/parseToCharacters.d.ts

@@ -0,0 +1,17 @@
+type DigitCharacterNode = {
+    kind: "digit";
+    digit: number;
+    character: string;
+};
+type OtherCharacterNode = {
+    kind: "other";
+    character: string;
+};
+type RootCharacterNode = {
+    kind: "root";
+    digits: number;
+    children: (DigitCharacterNode | OtherCharacterNode)[];
+};
+declare const parseToCharacters: (value: string) => RootCharacterNode;
+export { parseToCharacters };
+//# sourceMappingURL=parseToCharacters.d.ts.map

package/dist/parsers/parseToCharacters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseToCharacters.d.ts","sourceRoot":"","sources":["../../src/parsers/parseToCharacters.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,kBAAkB,GAAG,kBAAkB,CAAC,EAAE,CAAC;CACvD,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,iBAY1C,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/parsers/parseToCharacters.js

@@ -0,0 +1,13 @@
+const DIGIT = /^\d$/;
+const parseToCharacters = (value) => {
+    let digits = 0;
+    const children = value
+        .split("")
+        .map((character) => {
+        if (DIGIT.test(character))
+            return { character, kind: "digit", digit: ++digits };
+        return { character, kind: "other" };
+    });
+    return { digits, children, kind: "root" };
+};
+export { parseToCharacters };

package/dist/services/calculateCardInstallment.d.ts

@@ -1,33 +1,7 @@
-import type { CalculateCardInstallmentFunction } from "@arkyn/types";
-/**
- * Calculates the installment price and total price for a card payment plan.
- *
- * @remarks
- * **Important:** When the interest amount (`fees`) is equal to 0 or the number of installments (`numberInstallments`) is equal to 1, no interest will be charged.
- *
- * @throws Will throw an error if the number of installments is less than or equal to 0.
- * @throws Will throw an error if the fees are less than 0.
- *
- * @param props - The input parameters for the calculation.
- * @param props.cashPrice - The total cash price of the product or service.
- * @param props.numberInstallments - The number of installments for the payment plan.
- * @param props.fees - The interest rate per installment (default is 0.0349).
- *
- * @returns An object containing:
- * - `totalPrice`: The total price to be paid, rounded to two decimal places.
- * - `installmentPrice`: The price of each installment, rounded to two decimal places.
- *
- * @example
- * ```typescript
- * const result = calculateCardInstallment({
- *   cashPrice: 1000,
- *   numberInstallments: 12,
- *   fees: 0.02,
- * });
- * console.log(result);
- * // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
- * ```
- */
-declare const calculateCardInstallment: CalculateCardInstallmentFunction;
+import type { CalculateCardInstallmentProps } from "@arkyn/types";
+declare function calculateCardInstallment(args: CalculateCardInstallmentProps): {
+    total_price: number;
+    installment_price: number;
+};
 export { calculateCardInstallment };
 //# sourceMappingURL=calculateCardInstallment.d.ts.map

package/dist/services/calculateCardInstallment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculateCardInstallment.d.ts","sourceRoot":"","sources":["../../src/services/calculateCardInstallment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,QAAA,MAAM,wBAAwB,EAAE,gCA+B/B,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"calculateCardInstallment.d.ts","sourceRoot":"","sources":["../../src/services/calculateCardInstallment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAElE,iBAAS,wBAAwB,CAAC,IAAI,EAAE,6BAA6B;;;EAgBpE;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/services/calculateCardInstallment.js

@@ -1,55 +1,14 @@
-/**
- * Calculates the installment price and total price for a card payment plan.
- *
- * @remarks
- * **Important:** When the interest amount (`fees`) is equal to 0 or the number of installments (`numberInstallments`) is equal to 1, no interest will be charged.
- *
- * @throws Will throw an error if the number of installments is less than or equal to 0.
- * @throws Will throw an error if the fees are less than 0.
- *
- * @param props - The input parameters for the calculation.
- * @param props.cashPrice - The total cash price of the product or service.
- * @param props.numberInstallments - The number of installments for the payment plan.
- * @param props.fees - The interest rate per installment (default is 0.0349).
- *
- * @returns An object containing:
- * - `totalPrice`: The total price to be paid, rounded to two decimal places.
- * - `installmentPrice`: The price of each installment, rounded to two decimal places.
- *
- * @example
- * ```typescript
- * const result = calculateCardInstallment({
- *   cashPrice: 1000,
- *   numberInstallments: 12,
- *   fees: 0.02,
- * });
- * console.log(result);
- * // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
- * ```
- */
-const calculateCardInstallment = (props) => {
-    const { cashPrice, numberInstallments, fees = 0.0349 } = props;
-    if (fees === 0 || numberInstallments === 1) {
-        return {
-            totalPrice: cashPrice,
-            installmentPrice: cashPrice / numberInstallments,
-        };
-    }
-    if (numberInstallments <= 0) {
-        throw new Error("Number of installments must be greater than 0");
-    }
-    if (fees < 0) {
-        throw new Error("Fees must be greater than or equal to 0");
-    }
-    let installmentPrice = 0;
-    let totalPrice = 0;
-    let numerator = Math.pow(1 + fees, numberInstallments) * fees;
-    let denominator = Math.pow(1 + fees, numberInstallments) - 1;
-    installmentPrice = cashPrice * (numerator / denominator);
-    totalPrice = numberInstallments * installmentPrice;
+function calculateCardInstallment(args) {
+    const { cash_price, number_installments, fees = 0.0349 } = args;
+    let installment_price = 0;
+    let total_price = 0;
+    let numerator = Math.pow(1 + fees, number_installments) * fees;
+    let denominator = Math.pow(1 + fees, number_installments) - 1;
+    installment_price = cash_price * (numerator / denominator);
+    total_price = number_installments * installment_price;
     return {
-        totalPrice: +totalPrice.toFixed(2),
-        installmentPrice: +installmentPrice.toFixed(2),
+        total_price: +total_price.toFixed(2),
+        installment_price: +installment_price.toFixed(2),
     };
-};
+}
 export { calculateCardInstallment };