@arkyn/shared 3.0.1-beta.115 → 3.0.1-beta.117

package/dist/formats/formatToHiddenDigits.js

@@ -24,37 +24,37 @@ const within = (range, value) => value >= range[0] && value <= range[1];
  * 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:
+ * @param {string} value - The input string to be formatted.
+ * @param {FormatToHiddenDigitsOptions} options - Configuration options for formatting.
+ * @param {number | [number, number]} 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 `"*"`.
+ * @param {string} options.hider - The character used to hide digits. Defaults to `"*"`.
  *
- * @returns The formatted string with specified digits hidden.
+ * @returns {string} The formatted string with specified digits hidden.
  *
  * @example
  * ```typescript
- * import { formatToHiddenDigits } from "./formatToHiddenDigits";
- *
- * formatToHiddenDigits("123-456-7890", { range: 3 });
- * // Output: "***-456-7890"
+ * const formatted = formatToHiddenDigits("123-456-7890", { range: 3 });
+ * console.log(formatted); // Output: "***-456-7890"
+ * ```
  *
- * formatToHiddenDigits("123-456-7890", { range: [4, 6], hider: "#" });
- * // Output: "123-###-7890"
+ * @example
+ * ```typescript
+ * const formatted = formatToHiddenDigits("123-456-7890", { range: [4, 6], hider: "#" });
+ * console.log(formatted); // Output: "123-###-7890"
  * ```
  */
-const formatToHiddenDigits = (value, options) => {
+function formatToHiddenDigits(value, options) {
     const characters = parseToCharacters(value);
-    const range = normalizeRange(options.range ?? 3, characters.digits);
-    return characters.children
-        .map((node) => {
+    const range = normalizeRange(options?.range ?? 3, characters.digits);
+    const mappedCharacters = characters.children.map((node) => {
         if (node.kind === "digit" && within(range, node.digit))
-            return options.hider ?? "*";
+            return options?.hider ?? "*";
         return node.character;
-    })
-        .join("");
-};
+    });
+    return mappedCharacters.join("");
+}
 export { formatToHiddenDigits };

package/dist/formats/formatToPhone.d.ts

@@ -1,4 +1,4 @@
-type FormatToPhoneFunction = (prop: string) => string;
+type FormatToPhoneFunction = (rawString: string) => string;
 /**
  * Formats a phone number string based on the provided country code and optional prefix.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"formatToPhone.d.ts","sourceRoot":"","sources":["../../src/formats/formatToPhone.ts"],"names":[],"mappings":"AAaA,KAAK,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAmGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,KAAK,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAmG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,QAAA,MAAM,aAAa,EAAE,qBAwBpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/formats/formatToPhone.js

@@ -1,11 +1,11 @@
 import { countries } from "@arkyn/templates";
-import { removeNonNumeric } from "../services/removeNonNumeric";
+import { removeNonNumeric } from "../utilities/removeNonNumeric";
 function getMask(value) {
-    const mask = value.length > 10 ? "NINE" : "EIGTH";
+    const mask = value.length > 10 ? "NINE" : "EIGHT";
     return mask;
 }
 const TYPES = {
-    EIGTH: "(99) 9999-9999",
+    EIGHT: "(99) 9999-9999",
     NINE: "(99) 99999-9999",
 };
 const MAX_LENGTH = removeNonNumeric(TYPES.NINE).length;

package/dist/generators/generateColorByString.d.ts

@@ -1,15 +1,18 @@
-type GenerateColorByStringFunction = (prop: string) => string;
 /**
  * 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.
+ * @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"
+ * ```
  */
-declare const generateColorByString: GenerateColorByStringFunction;
+declare function generateColorByString(rawString: 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,KAAK,6BAA6B,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAE9D;;;;;;;;;;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;;;;;;;;;;;;;;GAcG;AAEH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

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,21 +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 { isHtml } from "./services/isHtml";
-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 { parseToDate } from "./parsers/parseDate";
+export { parseLargeFields } from "./parsers/parseLargeFields";
+export { parseSensitiveData } from "./parsers/parseSensitiveData";
+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,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,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"}
+{"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,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,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,12 +14,16 @@ export { formatToPhone } from "./formats/formatToPhone";
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";
+// parsers
+export { parseToDate } from "./parsers/parseDate";
+export { parseLargeFields } from "./parsers/parseLargeFields";
+export { parseSensitiveData } from "./parsers/parseSensitiveData";
 // services
-export { calculateCardInstallment } from "./services/calculateCardInstallment";
-export { ensureQuotes } from "./services/ensureQuotes";
-export { isHtml } from "./services/isHtml";
-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 { 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/parsers/parseDate.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=parseDate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseDate.d.ts","sourceRoot":"","sources":["../../src/parsers/parseDate.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/parseDate.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/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/services/validateDateService.d.ts

@@ -0,0 +1,9 @@
+declare class ValidateDateService {
+    private isLeapYear;
+    private getDaysInMonth;
+    private validateDayInMonth;
+    validateDateParts(year: number, month: number, day: number): void;
+    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,cAAM,mBAAmB;IACvB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IA2B1B,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAcjE,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAM1C;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}