@arkyn/shared 1.5.0 → 1.5.2

package/src/services/maskSensitiveData.ts

@@ -1,7 +1,32 @@
-function maskSensitiveData(
-  jsonString: string,
+import type { MaskSensitiveDataFunction } from "@arkyn/types";
+
+/**
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * const jsonString = JSON.stringify({
+ *   username: "user123",
+ *   password: "secret",
+ *   profile: {
+ *     creditCard: "1234-5678-9012-3456",
+ *   },
+ * });
+ *
+ * const result = maskSensitiveData(jsonString, ["password", "creditCard"]);
+ * console.log(result);
+ * // Output: '{"username":"user123","password":"****","profile":{"creditCard":"****"}}'
+ * ```
+ */
+
+const maskSensitiveData: MaskSensitiveDataFunction = (
+  jsonString,
   sensitiveKeys = ["password", "confirmPassword", "creditCard"]
-): string {
+) => {
   function maskValue(key: string, value: any): any {
     if (sensitiveKeys.includes(key)) return "****";
     return value;
@@ -35,6 +60,6 @@ function maskSensitiveData(
   } catch (error) {
     return jsonString;
   }
-}
+};
 
 export { maskSensitiveData };

package/src/services/removeCurrencySymbols.ts

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

package/src/services/removeNonNumeric.ts

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

package/src/services/truncateLargeFields.ts

@@ -1,5 +1,39 @@
-function truncateLargeFields(jsonString: string, maxLength = 1000): string {
-  function truncateValue(key: string, value: any): any {
+import type { TruncateLargeFieldsFunction } from "@arkyn/types";
+
+/**
+ * Truncates large string fields in a JSON string to a specified maximum length.
+ *
+ * This function parses a JSON string, traverses its structure recursively, and truncates
+ * 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.
+ *
+ * @throws {Error} Throws an error if the input is not a valid JSON string.
+ *
+ * @example
+ * ```typescript
+ * const json = JSON.stringify({
+ *   name: "John",
+ *   description: "A very long description that exceeds the maximum length...",
+ *   nested: {
+ *     details: "Another long string that needs truncation."
+ *   }
+ * });
+ *
+ * const result = truncateLargeFields(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: TruncateLargeFieldsFunction = (
+  jsonString,
+  maxLength = 1000
+) => {
+  function truncateValue(value: any): any {
     if (typeof value === "string" && value.length > maxLength) {
       return `To large information: field as ${value.length} characters`;
     }
@@ -8,16 +42,16 @@ function truncateLargeFields(jsonString: string, maxLength = 1000): string {
 
   function recursiveTruncate(obj: any): any {
     if (Array.isArray(obj)) {
-      return obj.map(recursiveTruncate);
+      return obj.map((item) => recursiveTruncate(item)); // Corrigido para processar elementos do array
     } else if (obj !== null && typeof obj === "object") {
       return Object.fromEntries(
         Object.entries(obj).map(([key, value]) => [
           key,
-          truncateValue(key, recursiveTruncate(value)),
+          recursiveTruncate(value), // Corrigido para aplicar recursão corretamente
         ])
       );
     }
-    return obj;
+    return truncateValue(obj); // Corrigido para truncar valores diretamente
   }
 
   try {
@@ -27,6 +61,6 @@ function truncateLargeFields(jsonString: string, maxLength = 1000): string {
   } catch (error) {
     throw new Error("Invalid JSON string");
   }
-}
+};
 
 export { truncateLargeFields };

package/src/validations/__test__/validateCep.spec.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { validateCep } from "../validateCep";
+
+describe("validateCep", () => {
+  it("should return true for a valid CEP with formatting", () => {
+    const validCep = "12345-678";
+    expect(validateCep(validCep)).toBe(true);
+  });
+
+  it("should return true for a valid CEP without formatting", () => {
+    const validCep = "12345678";
+    expect(validateCep(validCep)).toBe(true);
+  });
+
+  it("should return false for a CEP with letters", () => {
+    const invalidCep = "ABCDE-123";
+    expect(validateCep(invalidCep)).toBe(false);
+  });
+
+  it("should return false for a CEP with special characters", () => {
+    const invalidCep = "12345@678";
+    expect(validateCep(invalidCep)).toBe(false);
+  });
+
+  it("should return false for a CEP with invalid length", () => {
+    const shortCep = "12345";
+    const longCep = "123456789";
+    expect(validateCep(shortCep)).toBe(false);
+    expect(validateCep(longCep)).toBe(false);
+  });
+
+  it("should return false for an empty CEP", () => {
+    expect(validateCep("")).toBe(false);
+  });
+
+  it("should return false for a null or undefined CEP", () => {
+    expect(validateCep(null as unknown as string)).toBe(false);
+    expect(validateCep(undefined as unknown as string)).toBe(false);
+  });
+});

package/src/validations/__test__/validateCnpj.spec.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { validateCnpj } from "../validateCnpj";
+
+describe("validateCnpj", () => {
+  it("should return true for a valid CNPJ", () => {
+    const validCnpj = "11.444.777/0001-61";
+    expect(validateCnpj(validCnpj)).toBe(true);
+  });
+
+  it("should return false for an invalid CNPJ", () => {
+    const invalidCnpj = "12.345.679/0001-95";
+    expect(validateCnpj(invalidCnpj)).toBe(false);
+  });
+
+  it("should return false for a CNPJ with all digits equal", () => {
+    const invalidCnpj = "11111111111111";
+    expect(validateCnpj(invalidCnpj)).toBe(false);
+  });
+
+  it("should return false for a CNPJ with invalid length", () => {
+    const shortCnpj = "12345678";
+    const longCnpj = "123456789012345";
+    expect(validateCnpj(shortCnpj)).toBe(false);
+    expect(validateCnpj(longCnpj)).toBe(false);
+  });
+
+  it("should return false for an empty CNPJ", () => {
+    expect(validateCnpj("")).toBe(false);
+  });
+
+  it("should return false for a null or undefined CNPJ", () => {
+    expect(validateCnpj(null as unknown as string)).toBe(false);
+    expect(validateCnpj(undefined as unknown as string)).toBe(false);
+  });
+
+  it("should handle CNPJs with non-digit characters", () => {
+    const validCnpj = "11.444.777/0001-61";
+    const formattedCnpj = "11444777000161";
+    expect(validateCnpj(validCnpj)).toBe(true);
+    expect(validateCnpj(formattedCnpj)).toBe(true);
+  });
+});

package/src/validations/__test__/validateCpf.spec.ts

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest";
+import { validateCpf } from "../validateCpf";
+
+describe("validateCpf", () => {
+  it("should return false for an empty CPF", () => {
+    expect(validateCpf("")).toBe(false);
+  });
+
+  it("should return false for a CPF with invalid length", () => {
+    expect(validateCpf("123.456")).toBe(false);
+    expect(validateCpf("123.456.789.123")).toBe(false);
+  });
+
+  it("should return false for a CPF with all digits equal", () => {
+    expect(validateCpf("111.111.111-11")).toBe(false);
+    expect(validateCpf("222.222.222-22")).toBe(false);
+  });
+
+  it("should return false for an invalid CPF", () => {
+    expect(validateCpf("123.456.789-19")).toBe(false);
+    expect(validateCpf("987.654.321-01")).toBe(false);
+  });
+
+  it("should return true for a valid CPF", () => {
+    expect(validateCpf("111.444.777-35")).toBe(true);
+    expect(validateCpf("935.411.347-80")).toBe(true);
+  });
+
+  it("should ignore formatting characters and validate correctly", () => {
+    expect(validateCpf("11144477735")).toBe(true);
+    expect(validateCpf("935.411.347-80")).toBe(true);
+  });
+
+  it("should return false for a CPF with non-digit characters", () => {
+    expect(validateCpf("111.444.777-3a")).toBe(false);
+    expect(validateCpf("935.411.347-8x")).toBe(false);
+  });
+});

package/src/validations/__test__/validateDate.spec.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from "vitest";
+import { validateDate } from "../validateDate";
+
+describe("validateDate", () => {
+  it("should return true for valid dates in DD/MM/YYYY format", () => {
+    expect(validateDate("31/12/2023")).toBe(true);
+    expect(validateDate("29/02/2024", { inputFormat: "DD/MM/YYYY" })).toBe(
+      true
+    ); // Leap year
+  });
+
+  it("should return false for invalid dates in DD/MM/YYYY format", () => {
+    expect(validateDate("31/04/2023", { inputFormat: "DD/MM/YYYY" })).toBe(
+      false
+    ); // April has 30 days
+    expect(validateDate("29/02/2023", { inputFormat: "DD/MM/YYYY" })).toBe(
+      false
+    ); // Not a leap year
+    expect(validateDate("32/01/2023", { inputFormat: "DD/MM/YYYY" })).toBe(
+      false
+    ); // Invalid day
+  });
+
+  it("should return true for valid dates in MM-DD-YYYY format", () => {
+    expect(validateDate("12-31-2023", { inputFormat: "MM-DD-YYYY" })).toBe(
+      true
+    );
+  });
+
+  it("should return false for invalid dates in MM-DD-YYYY format", () => {
+    expect(validateDate("04-31-2023", { inputFormat: "MM-DD-YYYY" })).toBe(
+      false
+    ); // April has 30 days
+    expect(validateDate("02-29-2023", { inputFormat: "MM-DD-YYYY" })).toBe(
+      false
+    ); // Not a leap year
+    expect(validateDate("13-01-2023", { inputFormat: "MM-DD-YYYY" })).toBe(
+      false
+    ); // Invalid month
+  });
+
+  it("should return true for valid dates in YYYY-MM-DD format", () => {
+    expect(validateDate("2023-12-31", { inputFormat: "YYYY-MM-DD" })).toBe(
+      true
+    );
+    expect(validateDate("2024-02-29", { inputFormat: "YYYY-MM-DD" })).toBe(
+      true
+    ); // Leap year
+  });
+
+  it("should return false for invalid dates in YYYY-MM-DD format", () => {
+    expect(validateDate("2023-04-31", { inputFormat: "YYYY-MM-DD" })).toBe(
+      false
+    ); // April has 30 days
+    expect(validateDate("2023-02-29", { inputFormat: "YYYY-MM-DD" })).toBe(
+      false
+    ); // Not a leap year
+    expect(validateDate("2023-13-01", { inputFormat: "YYYY-MM-DD" })).toBe(
+      false
+    ); // Invalid month
+  });
+
+  it("should respect minYear and maxYear configuration", () => {
+    expect(validateDate("01/01/1899", { minYear: 1900 })).toBe(false); // Below minYear
+    expect(validateDate("01/01/1900", { minYear: 1900 })).toBe(true); // Equal to minYear
+    expect(validateDate("31/12/3001", { maxYear: 3000 })).toBe(false); // Above maxYear
+    expect(validateDate("31/12/3000", { maxYear: 3000 })).toBe(true); // Equal to maxYear
+  });
+
+  it("should throw an error for unsupported date formats", () => {
+    expect(() =>
+      validateDate("2023.12.31", { inputFormat: "YYYY.MM.DD" } as any)
+    ).toThrow("Invalid date format");
+  });
+
+  it("should return false for completely invalid date strings", () => {
+    expect(validateDate("invalid-date")).toBe(false);
+    expect(validateDate("12345678")).toBe(false);
+    expect(validateDate("")).toBe(false);
+  });
+});

package/src/validations/__test__/validatePassword.spec.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import { validatePassword } from "../validatePassword";
+
+describe("validatePassword", () => {
+  it("should return true for a valid password", () => {
+    const validPassword = "StrongP@ssw0rd!";
+    expect(validatePassword(validPassword)).toBe(true);
+  });
+
+  it("should return false for a password shorter than the minimum length", () => {
+    const shortPassword = "Short1!";
+    expect(validatePassword(shortPassword)).toBe(false);
+  });
+
+  it("should return false for a password without an uppercase letter", () => {
+    const noUppercase = "weakp@ssw0rd!";
+    expect(validatePassword(noUppercase)).toBe(false);
+  });
+
+  it("should return false for a password without a lowercase letter", () => {
+    const noLowercase = "WEAKP@SSW0RD!";
+    expect(validatePassword(noLowercase)).toBe(false);
+  });
+
+  it("should return false for a password without a number", () => {
+    const noNumber = "NoNumber@!";
+    expect(validatePassword(noNumber)).toBe(false);
+  });
+
+  it("should return false for a password without a special character", () => {
+    const noSpecialChar = "NoSpecialChar1";
+    expect(validatePassword(noSpecialChar)).toBe(false);
+  });
+
+  it("should return false for an empty password", () => {
+    expect(validatePassword("")).toBe(false);
+  });
+
+  it("should return false for a null or undefined password", () => {
+    expect(validatePassword(null as unknown as string)).toBe(false);
+    expect(validatePassword(undefined as unknown as string)).toBe(false);
+  });
+});

package/src/validations/__test__/validatePhone.spec.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect } from "vitest";
+import { validatePhone } from "../validatePhone";
+
+describe("validatePhone", () => {
+  it("should return true for valid Brazilian phone numbers", () => {
+    expect(validatePhone("+55 32912345678")).toBe(true); // Valid with 9th digit
+    expect(validatePhone("+55 3212345678")).toBe(true); // Valid without 9th digit
+  });
+
+  it("should return false for invalid Brazilian phone numbers", () => {
+    expect(validatePhone("+5532912345678")).toBe(false); // Missing space
+    expect(validatePhone("+55 123456789")).toBe(false); // Invalid format
+  });
+
+  it("should return true for valid American Samoa phone numbers", () => {
+    expect(validatePhone("+1-684 1234567")).toBe(true); // Valid format
+  });
+
+  it("should return false for invalid phone numbers", () => {
+    expect(validatePhone("+1-684 12345")).toBe(false); // Too few digits
+    expect(validatePhone("+99 1234567890")).toBe(false); // Non-existent country code
+  });
+
+  it("should return true for valid phone numbers from other countries", () => {
+    expect(validatePhone("+44 1234567890")).toBe(true); // Example for UK
+    expect(validatePhone("+91 9876543210")).toBe(true); // Example for India
+  });
+
+  it("should return false for phone numbers with incorrect prefixes", () => {
+    expect(validatePhone("+44-20 12345678")).toBe(false); // Invalid prefix for UK
+    expect(validatePhone("+91-80 12345678")).toBe(false); // Invalid prefix for India
+  });
+
+  it("should handle edge cases gracefully", () => {
+    expect(validatePhone("")).toBe(false); // Empty string
+    expect(validatePhone("+55")).toBe(false); // Only country code
+    expect(validatePhone("+55 329123456789")).toBe(false); // Too many digits
+  });
+});

package/src/validations/__test__/validateRg.spec.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import { validateRg } from "../validateRg";
+
+describe("validateRg", () => {
+  it("should return true for a valid RG with formatting", () => {
+    const validRg = "12.345.678-9";
+    expect(validateRg(validRg)).toBe(true);
+  });
+
+  it("should return true for a valid RG without formatting", () => {
+    const validRg = "123456789";
+    expect(validateRg(validRg)).toBe(true);
+  });
+
+  it("should return true for a valid RG with a verifier letter", () => {
+    const validRg = "12345678X";
+    expect(validateRg(validRg)).toBe(true);
+  });
+
+  it("should return false for an RG with invalid length (too short)", () => {
+    const invalidRg = "123456";
+    expect(validateRg(invalidRg)).toBe(false);
+  });
+
+  it("should return false for an RG with invalid length (too long)", () => {
+    const invalidRg = "1234567890";
+    expect(validateRg(invalidRg)).toBe(false);
+  });
+
+  it("should return false for an RG with special characters", () => {
+    const invalidRg = "12.345.678@9";
+    expect(validateRg(invalidRg)).toBe(false);
+  });
+
+  it("should return false for an RG with letters in the middle", () => {
+    const invalidRg = "12345A678";
+    expect(validateRg(invalidRg)).toBe(false);
+  });
+
+  it("should return false for an empty RG", () => {
+    expect(validateRg("")).toBe(false);
+  });
+
+  it("should return false for a null or undefined RG", () => {
+    expect(validateRg(null as unknown as string)).toBe(false);
+    expect(validateRg(undefined as unknown as string)).toBe(false);
+  });
+});

package/src/validations/validateCep.ts

@@ -0,0 +1,40 @@
+import type { ValidateCepFunction } from "@arkyn/types";
+import { removeNonNumeric } from "../services/removeNonNumeric";
+
+/**
+ * Removes all non-digit characters from the CEP.
+ * @param cep - Raw CEP string.
+ * @returns Only numeric characters.
+ */
+
+/**
+ * Validates a Brazilian CEP (Código de Endereçamento Postal).
+ *
+ * A valid CEP has 8 numeric digits.
+ *
+ * @param rawCep - CEP string, may include formatting (e.g., "12345-678").
+ * @returns `true` if the CEP is valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validateCep("12345-678"); // true
+ * validateCep("12345678");  // true
+ * validateCep("ABCDE-123"); // false
+ * ```
+ */
+
+const validateCep: ValidateCepFunction = (rawCep) => {
+  if (!rawCep) return false;
+
+  const validFormat = /^[0-9-]+$/.test(rawCep);
+  if (!validFormat) return false;
+
+  const cep = removeNonNumeric(rawCep);
+
+  const CEP_LENGTH = 8;
+  const isOnlyDigits = /^\d{8}$/.test(cep);
+
+  return cep.length === CEP_LENGTH && isOnlyDigits;
+};
+
+export { validateCep };

package/src/validations/validateCnpj.ts

@@ -0,0 +1,64 @@
+import type { ValidateCnpjFunction } from "@arkyn/types";
+import { removeNonNumeric } from "../services/removeNonNumeric";
+
+function isInvalidLength(cnpj: string) {
+  const CNPJ_LENGTH = 14;
+  return cnpj.length !== CNPJ_LENGTH;
+}
+
+function hasAllDigitsEqual(cnpj: string) {
+  const [firstDigit] = cnpj;
+  return [...cnpj].every((digit) => digit === firstDigit);
+}
+
+function calculateDigit(cnpj: string, multipliers: number[]) {
+  let total = 0;
+  for (let i = 0; i < multipliers.length; i++) {
+    total += parseInt(cnpj[i]) * multipliers[i];
+  }
+  const rest = total % 11;
+  return rest < 2 ? 0 : 11 - rest;
+}
+
+function extractDigit(cnpj: string) {
+  return cnpj.slice(12);
+}
+
+/**
+ * Validates a Brazilian CNPJ (Cadastro Nacional da Pessoa Jurídica) number.
+ *
+ * This function performs:
+ * - Sanitization (removes non-digit characters).
+ * - Length check (must be 14 digits).
+ * - Repeating digits check (invalid if all digits are the same).
+ * - Verifies the two check digits with the proper weights.
+ *
+ * @param rawCnpj - CNPJ string, possibly formatted.
+ * @returns `true` if valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validateCnpj("12.345.678/0001-95"); // false
+ * validateCnpj("11.444.777/0001-61"); // true
+ * ```
+ */
+
+const validateCnpj: ValidateCnpjFunction = (rawCnpj) => {
+  if (!rawCnpj) return false;
+
+  const cnpj = removeNonNumeric(rawCnpj);
+
+  if (isInvalidLength(cnpj)) return false;
+  if (hasAllDigitsEqual(cnpj)) return false;
+
+  const base = cnpj.slice(0, 12);
+  const digit1 = calculateDigit(base, [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]);
+  const digit2 = calculateDigit(
+    base + digit1,
+    [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]
+  );
+
+  return extractDigit(cnpj) === `${digit1}${digit2}`;
+};
+
+export { validateCnpj };

package/src/validations/validateCpf.ts

@@ -0,0 +1,61 @@
+import type { ValidateCpfFunction } from "@arkyn/types";
+import { removeNonNumeric } from "../services/removeNonNumeric";
+
+function isInvalidLength(cpf: string) {
+  const CPF_LENGTH = 11;
+  return cpf.length !== CPF_LENGTH;
+}
+
+function hasAllDigitsEqual(cpf: string) {
+  const [firstCpfDigit] = cpf;
+  return [...cpf].every((digit) => digit === firstCpfDigit);
+}
+
+function calculateDigit(cpf: string, factor: number) {
+  let total = 0;
+  for (const digit of cpf) {
+    if (factor > 1) total += parseInt(digit) * factor--;
+  }
+  const rest = total % 11;
+  return rest < 2 ? 0 : 11 - rest;
+}
+
+function extractDigit(cpf: string) {
+  return cpf.slice(9);
+}
+
+/**
+ * Validates a Brazilian CPF (Cadastro de Pessoas Físicas) number.
+ *
+ * The CPF is a unique identifier assigned to Brazilian citizens and residents.
+ * This function checks if the provided CPF is valid by performing the following steps:
+ * - Removes any non-digit characters from the input.
+ * - Verifies if the CPF has the correct length (11 digits).
+ * - Ensures that all digits are not the same (e.g., "111.111.111-11" is invalid).
+ * - Calculates the first and second verification digits using the CPF algorithm.
+ * - Compares the calculated verification digits with the ones provided in the CPF.
+ *
+ * @param rawCpf - The raw CPF string, which may include formatting characters (e.g., dots or dashes).
+ * @returns `true` if the CPF is valid, otherwise `false`.
+ *
+ * @example
+ * ```typescript
+ * validateCpf("123.456.789-09"); // false
+ * validateCpf("111.444.777-35"); // true
+ * ```
+ */
+
+const validateCpf: ValidateCpfFunction = (rawCpf) => {
+  if (!rawCpf) return false;
+  const cpf = removeNonNumeric(rawCpf);
+
+  if (isInvalidLength(cpf)) return false;
+  if (hasAllDigitsEqual(cpf)) return false;
+
+  const digit1 = calculateDigit(cpf, 10);
+  const digit2 = calculateDigit(cpf, 11);
+
+  return extractDigit(cpf) === `${digit1}${digit2}`;
+};
+
+export { validateCpf };