chore: Remove unused files and update project docs

Author: gabriel-logan

.gitignore

@@ -21,4 +21,4 @@
 
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
-replay_pid*
+replay_pid*

.idea/sonarlint/issuestore/1/0/1035b95fde851fd8381dabb4da89dd79908aed9b

@@ -3,10 +3,17 @@
 import java.util.Arrays;
 
 public class CnpjValidator {
+    // Prevent instantiation
     private CnpjValidator() {
         throw new IllegalStateException("Utility class");
     }
 
+    /**
+     * Calculate the first verifier digit of a CNPJ
+     *
+     * @param cnpjBase an array of integers with the first 12 digits of a CNPJ
+     * @return the first verifier digit
+     */
     private static int calculateFirstVerifier(int[] cnpjBase) {
         final int[] weight = {5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2};
         int sum = 0;
@@ -19,6 +26,13 @@ private static int calculateFirstVerifier(int[] cnpjBase) {
         return remainder < 2 ? 0 : 11 - remainder;
     }
 
+    /**
+     * Calculate the second verifier digit of a CNPJ
+     *
+     * @param cnpjBase an array of integers with the first 12 digits of a CNPJ
+     * @param firstVerifier the first verifier digit
+     * @return the second verifier digit
+     */
     private static int calculateSecondVerifier(int[] cnpjBase, int firstVerifier) {
         final int[] weight = {6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2};
         int sum = 0;
@@ -33,9 +47,16 @@ private static int calculateSecondVerifier(int[] cnpjBase, int firstVerifier) {
         return remainder < 2 ? 0 : 11 - remainder;
     }
 
+    /**
+     * Check if a CNPJ is valid
+     *
+     * @param cnpj the CNPJ to be validated
+     * @return true if the CNPJ is valid, false otherwise
+     * @throws NullPointerException if the CNPJ is null
+     */
     public static boolean cnpjIsValid(String cnpj) {
         if (cnpj == null) {
-            throw new NullPointerException("CNPJ cannot be null or empty");
+            throw new NullPointerException("CNPJ cannot be null");
         }
 
         final String cnpjClean = cnpj.replaceAll("\\D", "");
@@ -67,4 +88,4 @@ public static boolean cnpjIsValid(String cnpj) {
 
         return cnpjArray[12] == firstVerifier && cnpjArray[13] == secondVerifier;
     }
-}
+}

.idea/sonarlint/issuestore/5/8/5879b52636e240d2cfcbd5e54543d3959f957811

@@ -4,14 +4,25 @@
 import java.util.regex.Pattern;
 import java.util.stream.IntStream;
 
+/**
+ * The CpfValidator class provides a utility method to validate CPF (Cadastro de Pessoas Físicas) numbers.
+ */
 public class CpfValidator {
+    // Prevent instantiation
     private CpfValidator() {
         throw new IllegalStateException("Utility class");
     }
 
+    /**
+     * Validates a CPF number.
+     *
+     * @param cpf the CPF number to validate
+     * @return true if the CPF number is valid, false otherwise
+     * @throws NullPointerException if the CPF number is null
+     */
     public static boolean cpfIsValid(String cpf) {
         if (cpf == null) {
-            throw new NullPointerException("CPF cannot be null or empty");
+            throw new NullPointerException("CPF cannot be null");
         }
 
         final String cpfClean = cpf.replaceAll("\\D", "");
@@ -37,4 +48,4 @@ public static boolean cpfIsValid(String cpf) {
 
         return cpfArray[9] == validator1 && cpfArray[10] == validator2;
     }
-}
+}