@arkyn/shared 3.0.1-beta.14 → 3.0.1-beta.140

package/dist/index.js

@@ -6,9 +6,7 @@ export { formatToCapitalizeFirstWordLetter } from "./formats/formatToCapitalizeF
 export { formatToCep } from "./formats/formatToCep";
 export { formatToCnpj } from "./formats/formatToCnpj";
 export { formatToCpf } from "./formats/formatToCpf";
-export { formatToCpfCnpj } from "./formats/formatToCpfCnpj";
 export { formatToCurrency } from "./formats/formatToCurrency";
-export { formatToDate } from "./formats/formatToDate";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
@@ -16,19 +14,17 @@ export { formatToPhone } from "./formats/formatToPhone";
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";
+// parsers
+export { parseLargeFields } from "./parsers/parseLargeFields";
+export { parseSensitiveData } from "./parsers/parseSensitiveData";
+export { parseToDate } from "./parsers/parseToDate";
 // services
-export { calculateCardInstallment } from "./services/calculateCardInstallment";
-export { ensureQuotes } from "./services/ensureQuotes";
-export { maskSensitiveData } from "./services/maskSensitiveData";
-export { removeCurrencySymbols } from "./services/removeCurrencySymbols";
-export { removeNonNumeric } from "./services/removeNonNumeric";
-export { stripHtmlTags } from "./services/stripHtmlTags";
-export { truncateLargeFields } from "./services/truncateLargeFields";
-// utils
-export { validateCep } from "./validations/validateCep";
-export { validateCnpj } from "./validations/validateCnpj";
-export { validateCpf } from "./validations/validateCpf";
-export { validateDate } from "./validations/validateDate";
-export { validatePassword } from "./validations/validatePassword";
-export { validatePhone } from "./validations/validatePhone";
-export { validateRg } from "./validations/validateRg";
+export { ValidateDateService } from "./services/validateDateService";
+// utilities
+export { calculateCardInstallment } from "./utilities/calculateCardInstallment";
+export { ensureQuotes } from "./utilities/ensureQuotes";
+export { findCountryMask } from "./utilities/findCountryMask";
+export { isHtml } from "./utilities/isHtml";
+export { removeCurrencySymbols } from "./utilities/removeCurrencySymbols";
+export { removeNonNumeric } from "./utilities/removeNonNumeric";
+export { stripHtmlTags } from "./utilities/stripHtmlTags";

package/dist/{services/truncateLargeFields.d.ts → parsers/parseLargeFields.d.ts}

@@ -1,4 +1,3 @@
-type TruncateLargeFieldsFunction = (jsonString: string, maxLength?: number) => string;
 /**
  * Truncates large string fields in a JSON string to a specified maximum length.
  *
@@ -6,9 +5,10 @@ type TruncateLargeFieldsFunction = (jsonString: string, maxLength?: number) => s
  * any string fields that exceed the specified maximum length. If a string field is truncated,
  * it is replaced with a message indicating the original length of the field.
  *
- * @param jsonString - The JSON string to process.
- * @param maxLength - The maximum allowed length for string fields. Defaults to 1000.
- * @returns A JSON string with large string fields truncated.
+ * @param {string} jsonString - The JSON string to process.
+ * @param {number} maxLength - The maximum allowed length for string fields. Defaults to 1000.
+ *
+ * @returns {string} A JSON string with large string fields truncated.
  *
  * @throws {Error} Throws an error if the input is not a valid JSON string.
  *
@@ -17,16 +17,14 @@ type TruncateLargeFieldsFunction = (jsonString: string, maxLength?: number) => s
  * const json = JSON.stringify({
  *   name: "John",
  *   description: "A very long description that exceeds the maximum length...",
- *   nested: {
- *     details: "Another long string that needs truncation."
- *   }
+ *   nested: { details: "Another long string that needs truncation." }
  * });
  *
- * const result = truncateLargeFields(json, 50);
+ * const result = parseLargeFields(json, 50);
  * console.log(result);
  * // Output: '{"name":"John","description":"To large information: field as 57 characters","nested":{"details":"To large information: field as 43 characters"}}'
  * ```
  */
-declare const truncateLargeFields: TruncateLargeFieldsFunction;
-export { truncateLargeFields };
-//# sourceMappingURL=truncateLargeFields.d.ts.map
+declare function parseLargeFields(jsonString: string, maxLength?: number): string;
+export { parseLargeFields };
+//# sourceMappingURL=parseLargeFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseLargeFields.d.ts","sourceRoot":"","sources":["../../src/parsers/parseLargeFields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iBAAS,gBAAgB,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAa,GACvB,MAAM,CA6BR;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/{services/truncateLargeFields.js → parsers/parseLargeFields.js}

@@ -5,9 +5,10 @@
  * any string fields that exceed the specified maximum length. If a string field is truncated,
  * it is replaced with a message indicating the original length of the field.
  *
- * @param jsonString - The JSON string to process.
- * @param maxLength - The maximum allowed length for string fields. Defaults to 1000.
- * @returns A JSON string with large string fields truncated.
+ * @param {string} jsonString - The JSON string to process.
+ * @param {number} maxLength - The maximum allowed length for string fields. Defaults to 1000.
+ *
+ * @returns {string} A JSON string with large string fields truncated.
  *
  * @throws {Error} Throws an error if the input is not a valid JSON string.
  *
@@ -16,17 +17,15 @@
  * const json = JSON.stringify({
  *   name: "John",
  *   description: "A very long description that exceeds the maximum length...",
- *   nested: {
- *     details: "Another long string that needs truncation."
- *   }
+ *   nested: { details: "Another long string that needs truncation." }
  * });
  *
- * const result = truncateLargeFields(json, 50);
+ * const result = parseLargeFields(json, 50);
  * console.log(result);
  * // Output: '{"name":"John","description":"To large information: field as 57 characters","nested":{"details":"To large information: field as 43 characters"}}'
  * ```
  */
-const truncateLargeFields = (jsonString, maxLength = 1000) => {
+function parseLargeFields(jsonString, maxLength = 1000) {
     function truncateValue(value) {
         if (typeof value === "string" && value.length > maxLength) {
             return `To large information: field as ${value.length} characters`;
@@ -35,15 +34,15 @@ const truncateLargeFields = (jsonString, maxLength = 1000) => {
     }
     function recursiveTruncate(obj) {
         if (Array.isArray(obj)) {
-            return obj.map((item) => recursiveTruncate(item)); // Corrigido para processar elementos do array
+            return obj.map((item) => recursiveTruncate(item));
         }
         else if (obj !== null && typeof obj === "object") {
             return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
                 key,
-                recursiveTruncate(value), // Corrigido para aplicar recursão corretamente
+                recursiveTruncate(value),
             ]));
         }
-        return truncateValue(obj); // Corrigido para truncar valores diretamente
+        return truncateValue(obj);
     }
     try {
         const parsedJson = JSON.parse(jsonString);
@@ -53,5 +52,5 @@ const truncateLargeFields = (jsonString, maxLength = 1000) => {
     catch (error) {
         throw new Error("Invalid JSON string");
     }
-};
-export { truncateLargeFields };
+}
+export { parseLargeFields };

package/dist/parsers/parseSensitiveData.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Masks sensitive data in a JSON string by replacing the values of specified keys with "****".
+ *
+ * @param {string} jsonString - The JSON string to be processed.
+ * @param {string[]} sensitiveKeys - An array of keys whose values should be masked. Defaults to `["password", "confirmPassword", "creditCard"]`.
+ *
+ * @returns {string} A JSON string with sensitive data masked. If the input is not a valid JSON string, it returns the original string.
+ *
+ * @example
+ * ```typescript
+ * const jsonString = JSON.stringify({
+ *   username: "user123",
+ *   password: "secret",
+ *   profile: { creditCard: "1234-5678-9012-3456" },
+ * });
+ *
+ * const result = parseSensitiveData(jsonString, ["password", "creditCard"]);
+ * console.log(result); // Output: '{"username":"user123","password":"****","profile":{"creditCard":"****"}}'
+ * ```
+ */
+declare function parseSensitiveData(jsonString: string, sensitiveKeys?: string[]): string;
+export { parseSensitiveData };
+//# sourceMappingURL=parseSensitiveData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseSensitiveData.d.ts","sourceRoot":"","sources":["../../src/parsers/parseSensitiveData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,aAAa,GAAE,MAAM,EAAkD,GACtE,MAAM,CAkCR;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/{services/maskSensitiveData.js → parsers/parseSensitiveData.js}

@@ -1,26 +1,24 @@
 /**
  * Masks sensitive data in a JSON string by replacing the values of specified keys with "****".
  *
- * @param jsonString - The JSON string to be processed.
- * @param sensitiveKeys - An array of keys whose values should be masked. Defaults to `["password", "confirmPassword", "creditCard"]`.
- * @returns A JSON string with sensitive data masked. If the input is not a valid JSON string, it returns the original string.
+ * @param {string} jsonString - The JSON string to be processed.
+ * @param {string[]} sensitiveKeys - An array of keys whose values should be masked. Defaults to `["password", "confirmPassword", "creditCard"]`.
+ *
+ * @returns {string} A JSON string with sensitive data masked. If the input is not a valid JSON string, it returns the original string.
  *
  * @example
  * ```typescript
  * const jsonString = JSON.stringify({
  *   username: "user123",
  *   password: "secret",
- *   profile: {
- *     creditCard: "1234-5678-9012-3456",
- *   },
+ *   profile: { creditCard: "1234-5678-9012-3456" },
  * });
  *
- * const result = maskSensitiveData(jsonString, ["password", "creditCard"]);
- * console.log(result);
- * // Output: '{"username":"user123","password":"****","profile":{"creditCard":"****"}}'
+ * const result = parseSensitiveData(jsonString, ["password", "creditCard"]);
+ * console.log(result); // Output: '{"username":"user123","password":"****","profile":{"creditCard":"****"}}'
  * ```
  */
-const maskSensitiveData = (jsonString, sensitiveKeys = ["password", "confirmPassword", "creditCard"]) => {
+function parseSensitiveData(jsonString, sensitiveKeys = ["password", "confirmPassword", "creditCard"]) {
     function maskValue(key, value) {
         if (sensitiveKeys.includes(key))
             return "****";
@@ -56,5 +54,5 @@ const maskSensitiveData = (jsonString, sensitiveKeys = ["password", "confirmPass
     catch (error) {
         return jsonString;
     }
-};
-export { maskSensitiveData };
+}
+export { parseSensitiveData };

package/dist/parsers/parseToDate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Converts a date and time input into a JavaScript `Date` object, formatted according to the specified input format and timezone.
+ *
+ * @remarks
+ * **Note:** This function works with UTC+0 by default. The returned Date object is not automatically converted to the machine's local timezone.
+ * To adjust the timezone, you must manually specify the `timezone` parameter (e.g., -3 for UTC-3).
+ *
+ * @param {string[]} dateTime - An array containing the date and optional time.
+ *   - The first element is the date string.
+ *   - The second element is the time string (default is "00:00:00")
+ * @param {"brazilianDate" | "isoDate" | "timestamp"} inputFormat - The format of the input date.
+ *   - "brazilianDate": Expects the date in "DD/MM/YYYY" or "D/M/YYYY" format.
+ *   - "isoDate": Expects the date in "MM-DD-YYYY" or "M-D-YYYY" format.
+ *   - "timestamp": Expects the date in "YYYY-MM-DD" or "YYYY-M-D" format.
+ * @param {number} [timezone=0] - The timezone offset in hours to apply to the date.
+ *   - Defaults to 0 (UTC).
+ *
+ * @returns {Date} A `Date` object representing the parsed date and time, adjusted for the specified timezone.
+ *
+ * @throws {Error} If the `inputFormat` is invalid.
+ * @throws {Error} If the provided date or time is invalid.
+ *
+ * @example Format a Brazilian date to Date
+ * ```typescript
+ * const date = parseToDate(["25/12/2023", "15:30:00"], "brazilianDate", -3);
+ * console.log(date); // Outputs a Date object for "2023-12-25T12:30:00.000Z" (UTC)
+ * ```
+ * @example Format an ISO date to Date
+ * ```typescript
+ * const date = parseToDate(["12-25-2023", "15:30:00"], "isoDate", 2);
+ * console.log(date); // Outputs a Date object for "2023-12-25T13:30:00.000Z" (UTC)
+ * ```
+ * @example Format a timestamp date to Date
+ * ```typescript
+ * const date = parseToDate(["2023-12-25", "15:30:00"], "timestamp");
+ * console.log(date); // Outputs a Date object for "2023-12-25T15:30:00.000Z" (UTC)
+ * ```
+ */
+declare function parseToDate([date, time]: string[], inputFormat: "brazilianDate" | "isoDate" | "timestamp", timezone?: number): Date;
+export { parseToDate };
+//# sourceMappingURL=parseToDate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseToDate.d.ts","sourceRoot":"","sources":["../../src/parsers/parseToDate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAS,WAAW,CAClB,CAAC,IAAI,EAAE,IAAiB,CAAC,EAAE,MAAM,EAAE,EACnC,WAAW,EAAE,eAAe,GAAG,SAAS,GAAG,WAAW,EACtD,QAAQ,GAAE,MAAU,GACnB,IAAI,CAkCN;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/parsers/parseToDate.js

@@ -0,0 +1,67 @@
+import { ValidateDateService } from "../services/validateDateService";
+/**
+ * Converts a date and time input into a JavaScript `Date` object, formatted according to the specified input format and timezone.
+ *
+ * @remarks
+ * **Note:** This function works with UTC+0 by default. The returned Date object is not automatically converted to the machine's local timezone.
+ * To adjust the timezone, you must manually specify the `timezone` parameter (e.g., -3 for UTC-3).
+ *
+ * @param {string[]} dateTime - An array containing the date and optional time.
+ *   - The first element is the date string.
+ *   - The second element is the time string (default is "00:00:00")
+ * @param {"brazilianDate" | "isoDate" | "timestamp"} inputFormat - The format of the input date.
+ *   - "brazilianDate": Expects the date in "DD/MM/YYYY" or "D/M/YYYY" format.
+ *   - "isoDate": Expects the date in "MM-DD-YYYY" or "M-D-YYYY" format.
+ *   - "timestamp": Expects the date in "YYYY-MM-DD" or "YYYY-M-D" format.
+ * @param {number} [timezone=0] - The timezone offset in hours to apply to the date.
+ *   - Defaults to 0 (UTC).
+ *
+ * @returns {Date} A `Date` object representing the parsed date and time, adjusted for the specified timezone.
+ *
+ * @throws {Error} If the `inputFormat` is invalid.
+ * @throws {Error} If the provided date or time is invalid.
+ *
+ * @example Format a Brazilian date to Date
+ * ```typescript
+ * const date = parseToDate(["25/12/2023", "15:30:00"], "brazilianDate", -3);
+ * console.log(date); // Outputs a Date object for "2023-12-25T12:30:00.000Z" (UTC)
+ * ```
+ * @example Format an ISO date to Date
+ * ```typescript
+ * const date = parseToDate(["12-25-2023", "15:30:00"], "isoDate", 2);
+ * console.log(date); // Outputs a Date object for "2023-12-25T13:30:00.000Z" (UTC)
+ * ```
+ * @example Format a timestamp date to Date
+ * ```typescript
+ * const date = parseToDate(["2023-12-25", "15:30:00"], "timestamp");
+ * console.log(date); // Outputs a Date object for "2023-12-25T15:30:00.000Z" (UTC)
+ * ```
+ */
+function parseToDate([date, time = "00:00:00"], inputFormat, timezone = 0) {
+    const validateDateService = new ValidateDateService();
+    validateDateService.validateInputFormat(inputFormat);
+    const dateParts = date.split(/[-/]/).map(Number);
+    const timeParts = time.split(".")[0].split(":").map(Number);
+    let day, month, year;
+    const [hours = 0, minutes = 0, seconds = 0] = timeParts;
+    switch (inputFormat) {
+        case "brazilianDate":
+            [day, month, year] = dateParts;
+            validateDateService.validateDateParts(year, month, day);
+            break;
+        case "isoDate":
+            [month, day, year] = dateParts;
+            validateDateService.validateDateParts(year, month, day);
+            break;
+        case "timestamp":
+            [year, month, day] = dateParts;
+            validateDateService.validateDateParts(year, month, day);
+            break;
+    }
+    const formattedDate = new Date(Date.UTC(year, month - 1, day, hours, minutes, seconds));
+    if (isNaN(formattedDate.getTime()))
+        throw new Error("Invalid date");
+    formattedDate.setUTCHours(formattedDate.getUTCHours() + timezone);
+    return formattedDate;
+}
+export { parseToDate };

package/dist/services/validateDateService.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Service for validating date components and input formats.
+ *
+ * This service provides methods to validate date parts (year, month, day) and
+ * input format strings used in date parsing operations. It includes leap year
+ * validation and month-specific day validation.
+ *
+ * @remarks
+ * The service validates:
+ * - Year must be exactly 4 digits (1000-9999)
+ * - Month must be between 1 and 12
+ * - Day must be between 1 and 31
+ * - Day must be valid for the specific month (e.g., no February 30)
+ * - Leap year rules for February 29
+ *
+ * @example Validate a valid date
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateDateParts(2024, 1, 15); // No error thrown
+ * ```
+ *
+ * @example Validate an invalid date
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateDateParts(2023, 2, 29); // Throws: "Day 29 is not valid for February 2023 (non-leap year)"
+ * ```
+ *
+ * @example Validate input format
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateInputFormat("brazilianDate"); // No error thrown
+ * service.validateInputFormat("invalidFormat"); // Throws: "Invalid input format: invalidFormat"
+ * ```
+ */
+declare class ValidateDateService {
+    private isLeapYear;
+    private getDaysInMonth;
+    private validateDayInMonth;
+    /**
+     * Validates the components of a date (year, month, and day).
+     *
+     * @param {number} year - The year to validate (must be 4 digits).
+     * @param {number} month - The month to validate (must be between 1 and 12).
+     * @param {number} day - The day to validate (must be between 1 and 31, and valid for the month).
+     *
+     * @throws {Error} "Year should be four digits" - If the year doesn't have exactly 4 digits.
+     * @throws {Error} "Month should be between 1 and 12" - If the month is out of valid range.
+     * @throws {Error} "Day should be between 1 and 31" - If the day is out of valid range.
+     * @throws {Error} Month-specific error - If the day is invalid for the specific month.
+     *
+     * @example
+     * ```typescript
+     * const service = new ValidateDateService();
+     * service.validateDateParts(2024, 2, 29); // Valid leap year date
+     * service.validateDateParts(2023, 2, 29); // Throws error - not a leap year
+     * service.validateDateParts(2024, 4, 31); // Throws error - April has only 30 days
+     * ```
+     */
+    validateDateParts(year: number, month: number, day: number): void;
+    /**
+     * Validates that a given format string is supported.
+     *
+     * @param {string} format - The format string to validate.
+     *
+     * @throws {Error} "Invalid input format: {format}" - If the format is not one of the valid formats.
+     *
+     * @remarks
+     * Valid formats are:
+     * - "brazilianDate": DD/MM/YYYY format
+     * - "isoDate": MM-DD-YYYY format
+     * - "timestamp": YYYY-MM-DD format
+     *
+     * @example
+     * ```typescript
+     * const service = new ValidateDateService();
+     * service.validateInputFormat("brazilianDate"); // Valid
+     * service.validateInputFormat("isoDate"); // Valid
+     * service.validateInputFormat("timestamp"); // Valid
+     * service.validateInputFormat("customFormat"); // Throws error
+     * ```
+     */
+    validateInputFormat(format: string): void;
+}
+export { ValidateDateService };
+//# sourceMappingURL=validateDateService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateDateService.d.ts","sourceRoot":"","sources":["../../src/services/validateDateService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,cAAM,mBAAmB;IACvB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IA2B1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAcjE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAM1C;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/services/validateDateService.js

@@ -0,0 +1,132 @@
+/**
+ * Service for validating date components and input formats.
+ *
+ * This service provides methods to validate date parts (year, month, day) and
+ * input format strings used in date parsing operations. It includes leap year
+ * validation and month-specific day validation.
+ *
+ * @remarks
+ * The service validates:
+ * - Year must be exactly 4 digits (1000-9999)
+ * - Month must be between 1 and 12
+ * - Day must be between 1 and 31
+ * - Day must be valid for the specific month (e.g., no February 30)
+ * - Leap year rules for February 29
+ *
+ * @example Validate a valid date
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateDateParts(2024, 1, 15); // No error thrown
+ * ```
+ *
+ * @example Validate an invalid date
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateDateParts(2023, 2, 29); // Throws: "Day 29 is not valid for February 2023 (non-leap year)"
+ * ```
+ *
+ * @example Validate input format
+ * ```typescript
+ * const service = new ValidateDateService();
+ * service.validateInputFormat("brazilianDate"); // No error thrown
+ * service.validateInputFormat("invalidFormat"); // Throws: "Invalid input format: invalidFormat"
+ * ```
+ */
+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);
+        }
+    }
+    /**
+     * Validates the components of a date (year, month, and day).
+     *
+     * @param {number} year - The year to validate (must be 4 digits).
+     * @param {number} month - The month to validate (must be between 1 and 12).
+     * @param {number} day - The day to validate (must be between 1 and 31, and valid for the month).
+     *
+     * @throws {Error} "Year should be four digits" - If the year doesn't have exactly 4 digits.
+     * @throws {Error} "Month should be between 1 and 12" - If the month is out of valid range.
+     * @throws {Error} "Day should be between 1 and 31" - If the day is out of valid range.
+     * @throws {Error} Month-specific error - If the day is invalid for the specific month.
+     *
+     * @example
+     * ```typescript
+     * const service = new ValidateDateService();
+     * service.validateDateParts(2024, 2, 29); // Valid leap year date
+     * service.validateDateParts(2023, 2, 29); // Throws error - not a leap year
+     * service.validateDateParts(2024, 4, 31); // Throws error - April has only 30 days
+     * ```
+     */
+    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);
+    }
+    /**
+     * Validates that a given format string is supported.
+     *
+     * @param {string} format - The format string to validate.
+     *
+     * @throws {Error} "Invalid input format: {format}" - If the format is not one of the valid formats.
+     *
+     * @remarks
+     * Valid formats are:
+     * - "brazilianDate": DD/MM/YYYY format
+     * - "isoDate": MM-DD-YYYY format
+     * - "timestamp": YYYY-MM-DD format
+     *
+     * @example
+     * ```typescript
+     * const service = new ValidateDateService();
+     * service.validateInputFormat("brazilianDate"); // Valid
+     * service.validateInputFormat("isoDate"); // Valid
+     * service.validateInputFormat("timestamp"); // Valid
+     * service.validateInputFormat("customFormat"); // Throws error
+     * ```
+     */
+    validateInputFormat(format) {
+        const validFormats = ["brazilianDate", "isoDate", "timestamp"];
+        if (!validFormats.includes(format)) {
+            throw new Error(`Invalid input format: ${format}`);
+        }
+    }
+}
+export { ValidateDateService };

package/dist/{services → utilities}/calculateCardInstallment.d.ts

@@ -1,26 +1,18 @@
-type CalculateCardInstallmentFunction = (props: {
-    cashPrice: number;
-    numberInstallments: number;
-    fees?: number;
-}) => {
-    totalPrice: number;
-    installmentPrice: number;
-};
 /**
  * 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 {object} props - The input parameters for the calculation.
+ * @param {number} props.cashPrice - The total cash price of the product or service.
+ * @param {number} props.numberInstallments - The number of installments for the payment plan.
+ * @param {number} [props.fees=0.0349] - The interest rate per installment (default is 0.0349).
  *
- * @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).
+ * @throws {Error} If `numberInstallments` is less than or equal to 0.
+ * @throws {Error} If `fees` is less than 0.
  *
- * @returns An object containing:
+ * @returns {object} 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.
  *
@@ -31,10 +23,16 @@ type CalculateCardInstallmentFunction = (props: {
  *   numberInstallments: 12,
  *   fees: 0.02,
  * });
- * console.log(result);
- * // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
+ * console.log(result); // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
  * ```
  */
-declare const calculateCardInstallment: CalculateCardInstallmentFunction;
+declare function calculateCardInstallment(props: {
+    cashPrice: number;
+    numberInstallments: number;
+    fees?: number;
+}): {
+    totalPrice: number;
+    installmentPrice: number;
+};
 export { calculateCardInstallment };
 //# sourceMappingURL=calculateCardInstallment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculateCardInstallment.d.ts","sourceRoot":"","sources":["../../src/utilities/calculateCardInstallment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iBAAS,wBAAwB,CAAC,KAAK,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CA4BnD;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}