@arkyn/shared 3.0.1-beta.12 → 3.0.1-beta.120

package/dist/generators/generateColorByString.js

@@ -3,16 +3,20 @@
  * 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.
+ * @param {string} rawString - The input string used to generate the color.
+ *
+ * @returns {string} A hexadecimal color code (e.g., "#a1b2c3") derived from the input string.
+ *
  * @example
+ * ```typescript
  * const color = generateColorByString("example");
  * console.log(color); // Outputs a consistent hex color like "#5e8f9a"
+ * ```
  */
-const generateColorByString = (prop) => {
+function generateColorByString(rawString) {
     var hash = 0;
-    for (var i = 0; i < prop.length; i++) {
-        hash = prop.charCodeAt(i) + ((hash << 5) - hash);
+    for (var i = 0; i < rawString.length; i++) {
+        hash = rawString.charCodeAt(i) + ((hash << 5) - hash);
     }
     var red = (hash & 0xff0000) >> 16;
     var green = (hash & 0x00ff00) >> 8;
@@ -21,5 +25,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,13 +1,13 @@
 /**
  * Generates a unique identifier (UUID) in the specified format and type.
  *
- * @param type - The desired output type of the UUID. Can be:
+ * @param {"text" | "binary"} 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:
+ * @param {"v4" | "v7"} 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.
+ * @returns {string | Uint8Array} 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.

package/dist/generators/generateSlug.d.ts

@@ -9,9 +9,16 @@
  * - 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.
+ * @param {string} rawString - The input string to be converted into a slug.
+ *
+ * @returns {string} A URL-friendly slug derived from the input string.
+ *
+ * @example
+ * ```typescript
+ * const slug = generateSlug("Hello, World! This is a Test.");
+ * console.log(slug); // Outputs: "hello-world-this-is-a-test"
+ * ```
  */
-declare function generateSlug(prop: string): string;
+declare function generateSlug(rawString: 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;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,iBAAS,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAa/C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/generators/generateSlug.js

@@ -9,11 +9,18 @@
  * - 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.
+ * @param {string} rawString - The input string to be converted into a slug.
+ *
+ * @returns {string} A URL-friendly slug derived from the input string.
+ *
+ * @example
+ * ```typescript
+ * const slug = generateSlug("Hello, World! This is a Test.");
+ * console.log(slug); // Outputs: "hello-world-this-is-a-test"
+ * ```
  */
-function generateSlug(prop) {
-    let slug = prop.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+function generateSlug(rawString) {
+    let slug = rawString.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
     slug = slug
         .replace(/[^\w\s-]/g, "")
         .replace(/\s+/g, "-")

package/dist/index.d.ts

@@ -5,27 +5,21 @@ 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";
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";
-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";
-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 { parseLargeFields } from "./parsers/parseLargeFields";
+export { parseSensitiveData } from "./parsers/parseSensitiveData";
+export { parseToDate } from "./parsers/parseToDate";
+export { ValidateDateService } from "./services/validateDateService";
+export { calculateCardInstallment } from "./utilities/calculateCardInstallment";
+export { ensureQuotes } from "./utilities/ensureQuotes";
+export { isHtml } from "./utilities/isHtml";
+export { removeCurrencySymbols } from "./utilities/removeCurrencySymbols";
+export { removeNonNumeric } from "./utilities/removeNonNumeric";
+export { stripHtmlTags } from "./utilities/stripHtmlTags";
 //# 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":"AACA,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,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,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,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,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,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,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,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,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,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;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,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

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,16 @@ 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 { 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, 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, 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,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,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, 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"}