@arkyn/shared 3.0.1-beta.155 → 3.0.1-beta.157

package/dist/services/validateDateService.js

@@ -1,81 +0,0 @@
-/**
- * Validates date components and input format strings for date-parsing utilities.
- * Enforces 4-digit years, month/day ranges, month-specific day counts, and leap year rules.
- *
- * @example
- * ```typescript
- * const service = new ValidateDateService();
- * service.validateDateParts(2024, 2, 29); // OK — leap year
- * service.validateDateParts(2023, 2, 29); // throws — not a leap year
- * service.validateInputFormat("brazilianDate"); // OK
- * service.validateInputFormat("custom"); // throws
- * ```
- */
-class ValidateDateService {
-    isLeapYear(year) {
-        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
-    }
-    getDaysInMonth(month, year) {
-        const daysInMonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-        if (month === 2 && this.isLeapYear(year))
-            return 29;
-        return daysInMonth[month - 1];
-    }
-    validateDayInMonth(day, month, year) {
-        const maxDays = this.getDaysInMonth(month, year);
-        if (day > maxDays) {
-            const monthNames = [
-                "January",
-                "February",
-                "March",
-                "April",
-                "May",
-                "June",
-                "July",
-                "August",
-                "September",
-                "October",
-                "November",
-                "December",
-            ];
-            const errorMessage = `Day ${day} is not valid for ${monthNames[month - 1]}`;
-            const leapYearMessage = `Day ${day} is not valid for February ${year} (non-leap year)`;
-            if (month === 2 && day === 29)
-                throw new Error(leapYearMessage);
-            throw new Error(errorMessage);
-        }
-    }
-    /**
-     * Throws if year, month, or day are out of valid range or inconsistent with the calendar.
-     *
-     * @param year - 4-digit year (1000–9999).
-     * @param month - Month number (1–12).
-     * @param day - Day number (1–31, validated against the specific month).
-     */
-    validateDateParts(year, month, day) {
-        const messageErrors = {
-            year: "Year should be four digits",
-            month: "Month should be between 1 and 12",
-            day: "Day should be between 1 and 31",
-        };
-        if (`${year}`.length !== 4)
-            throw new Error(messageErrors.year);
-        if (month < 1 || month > 12)
-            throw new Error(messageErrors.month);
-        if (day < 1 || day > 31)
-            throw new Error(messageErrors.day);
-        this.validateDayInMonth(day, month, year);
-    }
-    /**
-     * Throws if `format` is not one of `"brazilianDate"`, `"isoDate"`, or `"timestamp"`.
-     *
-     * @param format - The format string to check.
-     */
-    validateInputFormat(format) {
-        const validFormats = ["brazilianDate", "isoDate", "timestamp"];
-        if (!validFormats.includes(format)) {
-            throw new Error(`Invalid input format: ${format}`);
-        }
-    }
-}
-export { ValidateDateService };

package/dist/utilities/calculateCardInstallment.js

@@ -1,39 +0,0 @@
-/**
- * Calculates the per-installment and total price for a card payment plan with compound interest.
- * No interest is applied when `fees` is `0` or `numberInstallments` is `1`.
- *
- * @param props.cashPrice - The base price of the item.
- * @param props.numberInstallments - Number of installments (must be > 0).
- * @param props.fees - Monthly interest rate (defaults to `0.0349`).
- * @returns `{ totalPrice, installmentPrice }` — both rounded to 2 decimal places.
- *
- * @example
- * ```typescript
- * calculateCardInstallment({ cashPrice: 1000, numberInstallments: 12, fees: 0.02 });
- * // { totalPrice: 1124.62, installmentPrice: 93.72 }
- * ```
- */
-function 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 numerator = Math.pow(1 + fees, numberInstallments) * fees;
-    let denominator = Math.pow(1 + fees, numberInstallments) - 1;
-    const installmentPrice = +(cashPrice * (numerator / denominator)).toFixed(2);
-    const totalPrice = +(installmentPrice * numberInstallments).toFixed(2);
-    return {
-        totalPrice: +totalPrice.toFixed(2),
-        installmentPrice: +installmentPrice.toFixed(2),
-    };
-}
-export { calculateCardInstallment };

package/dist/utilities/ensureQuotes.js

@@ -1,26 +0,0 @@
-/**
- * Ensures that a given rawValue string is enclosed in quotes.
- *
- * This function checks if the input string is already enclosed in either single
- * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
- * returned as-is. Otherwise, the function wraps the string in double quotes.
- *
- * @param rawValue - The string to be checked and potentially quoted.
- * @returns The original string if already quoted, otherwise the string wrapped in double quotes.
- *
- * @example
- * ```typescript
- * ensureQuotes('example'); // Returns: '"example"'
- * ensureQuotes('"already quoted"'); // Returns: '"already quoted"'
- * ensureQuotes("'single quoted'"); // Returns: "'single quoted'"
- * ```
- */
-function ensureQuotes(rawValue) {
-    const hasSingleQuotes = rawValue.startsWith("'") && rawValue.endsWith("'");
-    const hasDoubleQuotes = rawValue.startsWith('"') && rawValue.endsWith('"');
-    if (hasSingleQuotes || hasDoubleQuotes) {
-        return rawValue;
-    }
-    return `"${rawValue}"`;
-}
-export { ensureQuotes };

package/dist/utilities/findCountryMask.js

@@ -1,49 +0,0 @@
-import { countries } from "@arkyn/templates";
-import { parsePhoneNumberWithError } from "libphonenumber-js";
-import { removeNonNumeric } from "./removeNonNumeric";
-/**
- * Resolves the matching phone mask and country metadata for a given phone number.
- * Masks use `"_"` as digit placeholders. For countries with multiple mask lengths
- * (e.g. Brazil with and without the ninth digit), the mask matching the number's
- * digit count is returned.
- *
- * @param phoneNumber - Phone number in E.164 format (e.g. `"+5511999999999"`).
- * @returns A tuple of `[maskString, CountryType]`.
- * @throws If the number is invalid or no mask is found for the parsed country.
- *
- * @example
- * ```typescript
- * const [mask, country] = findCountryMask("+5511999999999");
- * // mask: "(__) _____-____"
- * // country.name: "Brazil"
- * ```
- */
-function findCountryMask(phoneNumber) {
-    try {
-        const parsedPhone = parsePhoneNumberWithError(phoneNumber);
-        const countryCode = parsedPhone?.country;
-        if (!countryCode)
-            throw new Error("Invalid phone number");
-        const country = countries.find((c) => c.iso === countryCode);
-        if (!country)
-            throw new Error("Phone number country not supported");
-        if (typeof country.mask === "string")
-            return [country.mask, country];
-        const maskForLength = country.mask.find((mask) => {
-            const maskDigits = mask.replace(/[^_]/g, "");
-            const phoneDigits = removeNonNumeric(parsedPhone.nationalNumber);
-            const maskDigitsCount = maskDigits.length;
-            const phoneDigitsCount = phoneDigits.length;
-            return maskDigitsCount === phoneDigitsCount;
-        });
-        if (!maskForLength) {
-            throw new Error("No mask found for the given phone number length");
-        }
-        return [maskForLength, country];
-    }
-    catch (rawError) {
-        const error = rawError;
-        throw new Error(error.message);
-    }
-}
-export { findCountryMask };

package/dist/utilities/isHtml.js

@@ -1,23 +0,0 @@
-/**
- * Check if a string contains HTML markup.
- *
- * This function uses a regular expression to detect the presence of HTML tags
- * in a string. The check is case-insensitive and detects both opening
- * and closing tags.
- *
- * @param rawString - The string to check.
- * @returns `true` if the string contains HTML markup, `false` otherwise.
- *
- * @example
- * ```typescript
- * isHtml('<p>Hello world</p>'); // true
- * isHtml('<div>Content</div>'); // true
- * isHtml('Plain text'); // false
- * isHtml(''); // false
- * ```
- */
-function isHtml(rawString) {
-    const htmlRegex = /<\/?[a-z][\s\S]*>/i;
-    return htmlRegex.test(rawString);
-}
-export { isHtml };

package/dist/utilities/removeCurrencySymbols.js

@@ -1,23 +0,0 @@
-/**
- * Removes currency symbols from a given formatted string.
- *
- * This function takes a string that may contain currency symbols
- * and removes them using a regular expression. The resulting string
- * is also trimmed of any leading or trailing whitespace.
- *
- * @param rawString - The formatted string that may contain currency symbols.
- * @returns The string with all currency symbols removed and trimmed of whitespace.
- *
- * @example
- * ```typescript
- * removeCurrencySymbols("R$13,45"); // "13,45"
- * removeCurrencySymbols("$123.45"); // "123.45"
- * removeCurrencySymbols("€99.99"); // "99.99"
- * removeCurrencySymbols("¥1,000"); // "1,000"
- * removeCurrencySymbols("123.45"); // "123.45" (no symbols to remove)
- * ```
- */
-function removeCurrencySymbols(rawString) {
-    return rawString.replace(/(?:R\$|\p{Sc}|[$€¥£])/gu, "").trim();
-}
-export { removeCurrencySymbols };

package/dist/utilities/removeNonNumeric.js

@@ -1,16 +0,0 @@
-/**
- * Removes all non-numeric characters from a given string.
- *
- * @param rawString - The input string to strip non-numeric characters from.
- * @returns A new string containing only the numeric characters from the input.
- *
- * @example
- * ```typescript
- * const result = removeNonNumeric("abc123def456");
- * console.log(result); // Output: "123456"
- * ```
- */
-function removeNonNumeric(rawString) {
-    return rawString.replace(/[^0-9]/g, "");
-}
-export { removeNonNumeric };

package/dist/utilities/stripHtmlTags.js

@@ -1,23 +0,0 @@
-/**
- * Strips HTML tags from a string.
- *
- * This function removes all HTML tags from the provided string by replacing any content
- * that matches the HTML tag pattern with an empty string.
- *
- * @param rawHtml - The HTML string to strip tags from.
- * @returns The plain text with all HTML tags (including `<script>`, `<style>`, and comments) removed.
- *
- * @example
- * ```typescript
- * const strippedHtml = stripHtmlTags("<p>Hello <strong>World</strong></p>");
- * console.log(strippedHtml); // "Hello World"
- * ```
- */
-function stripHtmlTags(rawHtml) {
-    return rawHtml
-        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "")
-        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "")
-        .replace(/<!--[\s\S]*?-->/g, "")
-        .replace(/<\/?[a-z][a-z0-9]*[^>]*>/gi, "");
-}
-export { stripHtmlTags };