Merge pull request #77 from onixbyte/feature/rename-modules

feat: rename modules

common-toolbox/build.gradle.kts

@@ -64,14 +64,14 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("devkitUtils") {
+        create<MavenPublication>("commonToolbox") {
             groupId = group.toString()
-            artifactId = "devkit-utils"
+            artifactId = "common-toolbox"
             version = artefactVersion
 
             pom {
                 name = "OnixByte Common Toolbox"
-                description = "The utils module of JDevKit."
+                description = "The utils module of OnixByte toolbox."
                 url = projectUrl
 
                 licenses {
@@ -82,8 +82,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -107,7 +107,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["devkitUtils"])
+                sign(publishing.publications["commonToolbox"])
             }
         }
 

common-toolbox/src/main/java/com/onixbyte/common/util/AesUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import javax.crypto.Cipher;
 import javax.crypto.spec.IvParameterSpec;

common-toolbox/src/main/java/com/onixbyte/common/util/Base64Util.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;

common-toolbox/src/main/java/com/onixbyte/common/util/BoolUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Arrays;
 import java.util.Objects;

common-toolbox/src/main/java/com/onixbyte/common/util/BranchUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Objects;
 import java.util.function.BooleanSupplier;

common-toolbox/src/main/java/com/onixbyte/common/util/CollectionUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.ArrayList;
 import java.util.Collection;

common-toolbox/src/main/java/com/onixbyte/common/util/HashUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;

common-toolbox/src/main/java/com/onixbyte/common/util/MapUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Map;
 

common-toolbox/src/main/java/com/onixbyte/common/util/ObjectMapAdapter.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.Map;
 

common-toolbox/src/main/java/com/onixbyte/common/util/RangeUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import java.util.stream.IntStream;
 

common-toolbox/src/test/java/com/onixbyte/common/util/AesUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/Base64UtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/BoolUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/BranchUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/CollectionUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/HashUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

common-toolbox/src/test/java/com/onixbyte/common/util/RangeUtilTest.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;
 
 import org.junit.jupiter.api.Test;
 

crypto-toolbox/build.gradle.kts

@@ -68,9 +68,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("keyPairLoader") {
+        create<MavenPublication>("cryptoToolbox") {
             groupId = group.toString()
-            artifactId = "key-pair-loader"
+            artifactId = "crypto-toolbox"
             version = artefactVersion
 
             pom {
@@ -87,8 +87,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -112,7 +112,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["keyPairLoader"])
+                sign(publishing.publications["cryptoToolbox"])
             }
         }
 

crypto-toolbox/src/main/java/com/onixbyte/crypto/PrivateKeyLoader.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto;
+
+import java.security.PrivateKey;
+
+/**
+ * The {@code PrivateKeyLoader} interface provides utility methods for loading keys pairs from
+ * PEM-formatted key text. This class supports loading both private and public keys.
+ *
+ * @author zihluwang
+ * @author siujamo
+ * @version 2.0.0
+ * @since 1.6.0
+ */
+public interface PrivateKeyLoader {
+
+    /**
+     * Load private key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PrivateKey loadPrivateKey(String pemKeyText);
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/PublicKeyLoader.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto;
+
+import com.onixbyte.crypto.exception.KeyLoadingException;
+
+import java.security.PublicKey;
+import java.security.interfaces.ECPublicKey;
+import java.security.interfaces.RSAPublicKey;
+
+/**
+ *
+ * @author siujamo
+ * @version 3.0.0
+ */
+public interface PublicKeyLoader {
+
+    /**
+     * Load public key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PublicKey loadPublicKey(String pemKeyText);
+
+    /**
+     * Loads an EC public key using the provided x and y coordinates together with the curve name.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an EC public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param xHex      the hexadecimal string representing the x coordinate of the EC point
+     * @param yHex      the hexadecimal string representing the y coordinate of the EC point
+     * @param curveName the name of the elliptic curve
+     * @return the loaded {@link ECPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default ECPublicKey loadPublicKey(String xHex, String yHex, String curveName) {
+        throw new KeyLoadingException("This key loader does not support loading an EC public key.");
+    }
+
+    /**
+     * Loads an RSA public key using the provided modulus and exponent.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an RSA public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param modulus  the modulus value of the RSA public key, usually represented in hexadecimal
+     *                 or Base64 string format
+     * @param exponent the public exponent value of the RSA public key, usually represented in
+     *                 hexadecimal or Base64 string format
+     * @return the loaded {@link RSAPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default RSAPublicKey loadPublicKey(String modulus, String exponent) {
+        throw new KeyLoadingException("This key loader does not support loading an RSA public key.");
+    }
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/algorithm/ecdsa/ECPrivateKeyLoader.java

@@ -0,0 +1,102 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.algorithm.ecdsa;
+
+import com.onixbyte.crypto.PrivateKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
+
+import java.math.BigInteger;
+import java.security.AlgorithmParameters;
+import java.security.KeyFactory;
+import java.security.NoSuchAlgorithmException;
+import java.security.interfaces.ECPrivateKey;
+import java.security.interfaces.ECPublicKey;
+import java.security.spec.*;
+import java.util.Base64;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Key pair loader for loading key pairs for ECDSA-based algorithms.
+ * <p>
+ *
+ * <b>Example usage for ECDSA:</b>
+ * <pre>{@code
+ * PrivateKeyLoader keyLoader = new EcKeyLoader();
+ * String pemPrivateKey = """
+ *                        -----BEGIN EC PRIVATE KEY-----
+ *                        ...
+ *                        -----END EC PRIVATE KEY-----""";
+ * ECPrivateKey privateKey = PrivateKeyLoader.loadEcdsaPrivateKey(pemPrivateKey);
+ *
+ * String pemPublicKey = """
+ *                       -----BEGIN EC PUBLIC KEY-----
+ *                       ...
+ *                       -----END EC PUBLIC KEY-----""";
+ * ECPublicKey publicKey = PrivateKeyLoader.loadPublicKey(pemPublicKey);
+ * }</pre>
+ *
+ * @author zihluwang
+ * @version 2.0.0
+ * @since 2.0.0
+ */
+public class ECPrivateKeyLoader implements PrivateKeyLoader {
+
+    private final KeyFactory keyFactory;
+
+    private final Base64.Decoder decoder;
+
+    /**
+     * Initialise a key loader for EC-based algorithms.
+     */
+    public ECPrivateKeyLoader() {
+        try {
+            this.keyFactory = KeyFactory.getInstance("EC");
+            this.decoder = Base64.getDecoder();
+        } catch (NoSuchAlgorithmException e) {
+            throw new KeyLoadingException(e);
+        }
+    }
+
+    /**
+     * Load ECDSA private key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     * @throws KeyLoadingException if the generated key is not a {@link ECPrivateKey} instance,
+     *                             or EC Key Factory is not loaded, or key spec is invalid
+     */
+    @Override
+    public ECPrivateKey loadPrivateKey(String pemKeyText) {
+        try {
+            pemKeyText = CryptoUtil.getRawContent(pemKeyText);
+            var decodedKeyString = decoder.decode(pemKeyText);
+            var keySpec = new PKCS8EncodedKeySpec(decodedKeyString);
+
+            var _key = keyFactory.generatePrivate(keySpec);
+            if (_key instanceof ECPrivateKey privateKey) {
+                return privateKey;
+            } else {
+                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
+            }
+        } catch (InvalidKeySpecException e) {
+            throw new KeyLoadingException("Key spec is invalid.", e);
+        }
+    }
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/algorithm/ecdsa/ECPublicKeyLoader.java

@@ -15,10 +15,11 @@
  * limitations under the License.
  */
 
-package com.onixbyte.security.impl;
+package com.onixbyte.crypto.algorithm.ecdsa;
 
-import com.onixbyte.security.KeyLoader;
+import com.onixbyte.crypto.PublicKeyLoader;
-import com.onixbyte.security.exception.KeyLoadingException;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
 
 import java.math.BigInteger;
 import java.security.AlgorithmParameters;
@@ -31,35 +32,7 @@ import java.util.Base64;
 import java.util.HashSet;
 import java.util.Set;
 
-/**
+public class ECPublicKeyLoader implements PublicKeyLoader {
- * Key pair loader for loading key pairs for ECDSA-based algorithms.
- * <p>
- *
- * <b>Example usage for ECDSA:</b>
- * <pre>{@code
- * KeyLoader keyLoader = new EcKeyLoader();
- * String pemPrivateKey = """
- *                        -----BEGIN EC PRIVATE KEY-----
- *                        ...
- *                        -----END EC PRIVATE KEY-----""";
- * ECPrivateKey privateKey = KeyLoader.loadEcdsaPrivateKey(pemPrivateKey);
- *
- * String pemPublicKey = """
- *                       -----BEGIN EC PUBLIC KEY-----
- *                       ...
- *                       -----END EC PUBLIC KEY-----""";
- * ECPublicKey publicKey = KeyLoader.loadPublicKey(pemPublicKey);
- * }</pre>
- *
- * @author zihluwang
- * @version 2.0.0
- * @since 2.0.0
- */
-public class ECKeyLoader implements KeyLoader {
-
-    private final KeyFactory keyFactory;
-
-    private final Base64.Decoder decoder;
 
     /**
      * Supported curves.
@@ -68,10 +41,14 @@ public class ECKeyLoader implements KeyLoader {
         "secp256r1", "secp384r1", "secp521r1", "secp224r1"
     ));
 
+    private final KeyFactory keyFactory;
+
+    private final Base64.Decoder decoder;
+
     /**
      * Initialise a key loader for EC-based algorithms.
      */
-    public ECKeyLoader() {
+    public ECPublicKeyLoader() {
         try {
             this.keyFactory = KeyFactory.getInstance("EC");
             this.decoder = Base64.getDecoder();
@@ -80,32 +57,6 @@ public class ECKeyLoader implements KeyLoader {
         }
     }
 
-    /**
-     * Load ECDSA private key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     * @throws KeyLoadingException if the generated key is not a {@link ECPrivateKey} instance,
-     *                             or EC Key Factory is not loaded, or key spec is invalid
-     */
-    @Override
-    public ECPrivateKey loadPrivateKey(String pemKeyText) {
-        try {
-            pemKeyText = getRawContent(pemKeyText);
-            var decodedKeyString = decoder.decode(pemKeyText);
-            var keySpec = new PKCS8EncodedKeySpec(decodedKeyString);
-
-            var _key = keyFactory.generatePrivate(keySpec);
-            if (_key instanceof ECPrivateKey privateKey) {
-                return privateKey;
-            } else {
-                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
-            }
-        } catch (InvalidKeySpecException e) {
-            throw new KeyLoadingException("Key spec is invalid.", e);
-        }
-    }
-
     /**
      * Load public key from pem-formatted key text.
      *
@@ -117,7 +68,7 @@ public class ECKeyLoader implements KeyLoader {
     @Override
     public ECPublicKey loadPublicKey(String pemKeyText) {
         try {
-            pemKeyText = getRawContent(pemKeyText);
+            pemKeyText = CryptoUtil.getRawContent(pemKeyText);
             var keyBytes = decoder.decode(pemKeyText);
             var spec = new X509EncodedKeySpec(keyBytes);
             var key = keyFactory.generatePublic(spec);

crypto-toolbox/src/main/java/com/onixbyte/crypto/algorithm/rsa/RSAPrivateKeyLoader.java

@@ -0,0 +1,102 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.algorithm.rsa;
+
+import com.onixbyte.crypto.PrivateKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
+
+import java.math.BigInteger;
+import java.security.KeyFactory;
+import java.security.NoSuchAlgorithmException;
+import java.security.interfaces.RSAPrivateKey;
+import java.security.interfaces.RSAPublicKey;
+import java.security.spec.*;
+import java.util.Base64;
+
+/**
+ * A class responsible for loading RSA keys from PEM formatted text.
+ * <p>
+ * This class implements the {@link PrivateKeyLoader} interface and provides methods to load both private
+ * and public RSA keys. The keys are expected to be in the standard PEM format, which includes
+ * Base64-encoded key content surrounded by header and footer lines. The class handles the decoding
+ * of Base64 content and the generation of keys using the RSA key factory.
+ * <p>
+ * Any exceptions encountered during the loading process are encapsulated in a
+ * {@link KeyLoadingException}, allowing for flexible error handling.
+ *
+ * @author siujamo
+ * @see PrivateKeyLoader
+ * @see KeyLoadingException
+ */
+public class RSAPrivateKeyLoader implements PrivateKeyLoader {
+
+    private final Base64.Decoder decoder;
+
+    private final KeyFactory keyFactory;
+
+    /**
+     * Constructs an instance of {@code RsaKeyLoader}.
+     * <p>
+     * This constructor initialises the Base64 decoder and the RSA {@link KeyFactory}. It may throw
+     * a {@link KeyLoadingException} if the RSA algorithm is not available.
+     */
+    public RSAPrivateKeyLoader() {
+        try {
+            this.decoder = Base64.getDecoder();
+            this.keyFactory = KeyFactory.getInstance("RSA");
+        } catch (NoSuchAlgorithmException e) {
+            throw new KeyLoadingException(e);
+        }
+    }
+
+    /**
+     * Loads an RSA private key from a given PEM formatted key text.
+     * <p>
+     * This method extracts the raw key content from the provided PEM text, decodes the
+     * Base64-encoded content, and generates an instance of {@link RSAPrivateKey}. If the key cannot
+     * be loaded due to invalid specifications or types, a {@link KeyLoadingException} is thrown.
+     *
+     * @param pemKeyText the PEM formatted private key text
+     * @return an instance of {@link RSAPrivateKey}
+     * @throws KeyLoadingException if the key loading process encounters an error
+     */
+    @Override
+    public RSAPrivateKey loadPrivateKey(String pemKeyText) {
+        // Extract the raw key content
+        var rawKeyContent = CryptoUtil.getRawContent(pemKeyText);
+
+        // Decode the Base64-encoded content
+        var keyBytes = decoder.decode(rawKeyContent);
+
+        // Create a PKCS8EncodedKeySpec from the decoded bytes
+        var keySpec = new PKCS8EncodedKeySpec(keyBytes);
+
+        try {
+            // Get an RSA KeyFactory and generate the private key
+            var _key = keyFactory.generatePrivate(keySpec);
+            if (_key instanceof RSAPrivateKey key) {
+                return key;
+            } else {
+                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
+            }
+        } catch (InvalidKeySpecException e) {
+            throw new KeyLoadingException("Key spec is invalid.", e);
+        }
+    }
+}

crypto-toolbox/src/main/java/com/onixbyte/crypto/algorithm/rsa/RSAPublicKeyLoader.java

@@ -15,35 +15,23 @@
  * limitations under the License.
  */
 
-package com.onixbyte.security.impl;
+package com.onixbyte.crypto.algorithm.rsa;
 
-import com.onixbyte.security.KeyLoader;
+import com.onixbyte.crypto.PublicKeyLoader;
-import com.onixbyte.security.exception.KeyLoadingException;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
 
 import java.math.BigInteger;
 import java.security.KeyFactory;
 import java.security.NoSuchAlgorithmException;
-import java.security.interfaces.RSAPrivateKey;
 import java.security.interfaces.RSAPublicKey;
-import java.security.spec.*;
+import java.security.spec.InvalidKeySpecException;
+import java.security.spec.KeySpec;
+import java.security.spec.RSAPublicKeySpec;
+import java.security.spec.X509EncodedKeySpec;
 import java.util.Base64;
 
-/**
+public class RSAPublicKeyLoader implements PublicKeyLoader {
- * A class responsible for loading RSA keys from PEM formatted text.
- * <p>
- * This class implements the {@link KeyLoader} interface and provides methods to load both private
- * and public RSA keys. The keys are expected to be in the standard PEM format, which includes
- * Base64-encoded key content surrounded by header and footer lines. The class handles the decoding
- * of Base64 content and the generation of keys using the RSA key factory.
- * <p>
- * Any exceptions encountered during the loading process are encapsulated in a
- * {@link KeyLoadingException}, allowing for flexible error handling.
- *
- * @author siujamo
- * @see KeyLoader
- * @see KeyLoadingException
- */
-public class RSAKeyLoader implements KeyLoader {
 
     private final Base64.Decoder decoder;
 
@@ -57,7 +45,7 @@ public class RSAKeyLoader implements KeyLoader {
      * This constructor initialises the Base64 decoder and the RSA {@link KeyFactory}. It may throw
      * a {@link KeyLoadingException} if the RSA algorithm is not available.
      */
-    public RSAKeyLoader() {
+    public RSAPublicKeyLoader() {
         try {
             this.decoder = Base64.getDecoder();
             this.urlDecoder = Base64.getUrlDecoder();
@@ -67,41 +55,6 @@ public class RSAKeyLoader implements KeyLoader {
         }
     }
 
-    /**
-     * Loads an RSA private key from a given PEM formatted key text.
-     * <p>
-     * This method extracts the raw key content from the provided PEM text, decodes the
-     * Base64-encoded content, and generates an instance of {@link RSAPrivateKey}. If the key cannot
-     * be loaded due to invalid specifications or types, a {@link KeyLoadingException} is thrown.
-     *
-     * @param pemKeyText the PEM formatted private key text
-     * @return an instance of {@link RSAPrivateKey}
-     * @throws KeyLoadingException if the key loading process encounters an error
-     */
-    @Override
-    public RSAPrivateKey loadPrivateKey(String pemKeyText) {
-        // Extract the raw key content
-        var rawKeyContent = getRawContent(pemKeyText);
-
-        // Decode the Base64-encoded content
-        var keyBytes = decoder.decode(rawKeyContent);
-
-        // Create a PKCS8EncodedKeySpec from the decoded bytes
-        var keySpec = new PKCS8EncodedKeySpec(keyBytes);
-
-        try {
-            // Get an RSA KeyFactory and generate the private key
-            var _key = keyFactory.generatePrivate(keySpec);
-            if (_key instanceof RSAPrivateKey key) {
-                return key;
-            } else {
-                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
-            }
-        } catch (InvalidKeySpecException e) {
-            throw new KeyLoadingException("Key spec is invalid.", e);
-        }
-    }
-
     /**
      * Loads an RSA public key from a given PEM formatted key text.
      * <p>
@@ -116,7 +69,7 @@ public class RSAKeyLoader implements KeyLoader {
     @Override
     public RSAPublicKey loadPublicKey(String pemKeyText) {
         // Extract the raw key content
-        var rawKeyContent = getRawContent(pemKeyText);
+        var rawKeyContent = CryptoUtil.getRawContent(pemKeyText);
 
         // Decode the Base64-encoded content
         var keyBytes = decoder.decode(rawKeyContent);

crypto-toolbox/src/main/java/com/onixbyte/crypto/exception/KeyLoadingException.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.security.exception;
+package com.onixbyte.crypto.exception;
 
 /**
  * The {@code KeyLoadingException} class represents an exception that is thrown when there is an
@@ -29,7 +29,7 @@ package com.onixbyte.security.exception;
  * <p><b>Example usage:</b></p>
  * <pre>{@code
  * try {
- *     KeyLoader keyLoader = new EcKeyLoader();
+ *     PrivateKeyLoader keyLoader = new ECPrivateKeyLoader();
  *     ECPrivateKey privateKey = keyLoader.loadPrivateKey(pemPrivateKey);
  * } catch (KeyLoadingException e) {
  *     // Handle the exception
@@ -38,7 +38,7 @@ package com.onixbyte.security.exception;
  * }</pre>
  *
  * @author zihluwang
- * @version 2.0.0
+ * @version 3.0.0
  * @since 1.6.0
  */
 public class KeyLoadingException extends RuntimeException {

crypto-toolbox/src/main/java/com/onixbyte/crypto/util/CryptoUtil.java

@@ -0,0 +1,49 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.util;
+
+public final class CryptoUtil {
+
+    private CryptoUtil() {
+    }
+
+    /**
+     * Retrieves the raw content of a PEM formatted key by removing unnecessary headers, footers,
+     * and new line characters.
+     *
+     * <p>
+     * This method processes the provided PEM key text to return a cleaned string that contains
+     * only the key content. The method strips away the
+     * {@code "-----BEGIN (EC )?(PRIVATE|PUBLIC) KEY-----"} and
+     * {@code "-----END (EC )?(PRIVATE|PUBLIC) KEY-----"} lines, as well as any new line characters,
+     * resulting in a continuous string representation of the key, which can be used for further
+     * cryptographic operations.
+     *
+     * @param pemKeyText the PEM formatted key as a string, which may include headers, footers and
+     *                   line breaks
+     * @return a string containing the raw key content devoid of  any unnecessary formatting
+     * or whitespace
+     */
+    public static String getRawContent(String pemKeyText) {
+        // remove all unnecessary parts of the pem key text
+        return pemKeyText
+            .replaceAll("-----BEGIN ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
+            .replaceAll("-----END ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
+            .replaceAll("\n", "");
+    }
+}

identity-generator/README.md

@@ -4,7 +4,7 @@
 
 Module `guid` serves as a guid creator for other `JDevKit` modules. You can also use this module as a guid creator standards.
 
-We have already implemented `SnowflakeGuidCreator`, you can also implement a custom guid creations by implementing `com.onixbyte.guid.GuidCreator`.
+We have already implemented `SnowflakeGuidCreator`, you can also implement a custom guid creations by implementing `com.onixbyte.identitygenerator.IdentityGenerator`.
 
 ## Example usage
 

identity-generator/build.gradle.kts

@@ -64,9 +64,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("guid") {
+        create<MavenPublication>("identityGenerator") {
             groupId = group.toString()
-            artifactId = "guid"
+            artifactId = "identity-generator"
             version = artefactVersion
 
             pom {
@@ -82,8 +82,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -107,7 +107,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["guid"])
+                sign(publishing.publications["identityGenerator"])
             }
         }
 

identity-generator/src/main/java/com/onixbyte/identitygenerator/IdentityGenerator.java

@@ -15,10 +15,10 @@
  * limitations under the License.
  */
 
-package com.onixbyte.guid;
+package com.onixbyte.identitygenerator;
 
 /**
- * The {@code GuidCreator} is a generic interface for generating globally unique identifiers (GUIDs)
+ * The {@code IdentityGenerator} is a generic interface for generating globally unique identifiers (GUIDs)
  * of a specific type.
  * <p>
  * The type of ID is determined by the class implementing this interface.
@@ -26,7 +26,7 @@ package com.onixbyte.guid;
  *
  * <p><b>Example usage:</b></p>
  * <pre>{@code
- * public class StringGuidCreator implements GuidCreator<String> {
+ * public class StringGuidCreator implements IdentityGenerator<String> {
  *     private final AtomicLong counter = new AtomicLong();
  *
  *     @Override
@@ -37,7 +37,7 @@ package com.onixbyte.guid;
  *
  * public class Example {
  *     public static void main(String[] args) {
- *         GuidCreator<String> guidCreator = new StringGuidCreator();
+ *         IdentityGenerator<String> guidCreator = new StringGuidCreator();
  *         String guid = guidCreator.nextId();
  *         System.out.println("Generated GUID: " + guid);
  *     }
@@ -49,7 +49,7 @@ package com.onixbyte.guid;
  * @version 1.1.0
  * @since 1.0.0
  */
-public interface GuidCreator<IdType> {
+public interface IdentityGenerator<IdType> {
 
     /**
      * Generates and returns the next globally unique ID.

identity-generator/src/main/java/com/onixbyte/identitygenerator/exceptions/TimingException.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.guid.exceptions;
+package com.onixbyte.identitygenerator.exceptions;
 
 /**
  * The {@code TimingException} class represents an exception that is thrown when there is an error

identity-generator/src/main/java/com/onixbyte/identitygenerator/impl/SequentialUuidGenerator.java

@@ -15,16 +15,16 @@
  * limitations under the License.
  */
 
-package com.onixbyte.guid.impl;
+package com.onixbyte.identitygenerator.impl;
 
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
 
 import java.nio.ByteBuffer;
 import java.security.SecureRandom;
 import java.util.UUID;
 
 /**
- * A {@code SequentialUuidCreator} is responsible for generating UUIDs following the UUID version 7 specification, which
+ * A {@code SequentialUuidGenerator} is responsible for generating UUIDs following the UUID version 7 specification, which
  * combines a timestamp with random bytes to create time-ordered unique identifiers.
  * <p>
  * This implementation utilises a cryptographically strong {@link SecureRandom} instance to produce the random
@@ -34,14 +34,14 @@ import java.util.UUID;
  * The generated UUID adheres strictly to the layout and variant bits of UUID version 7 as defined in the specification.
  * </p>
  */
-public class SequentialUuidCreator implements GuidCreator<UUID> {
+public class SequentialUuidGenerator implements IdentityGenerator<UUID> {
 
     private final SecureRandom random;
 
     /**
-     * Constructs a new {@code SequentialUuidCreator} with its own {@link SecureRandom} instance.
+     * Constructs a new {@code SequentialUuidGenerator} with its own {@link SecureRandom} instance.
      */
-    public SequentialUuidCreator() {
+    public SequentialUuidGenerator() {
         this.random = new SecureRandom();
     }
 

identity-generator/src/main/java/com/onixbyte/identitygenerator/impl/SnowflakeIdentityGenerator.java

@@ -15,16 +15,16 @@
  * limitations under the License.
  */
 
-package com.onixbyte.guid.impl;
+package com.onixbyte.identitygenerator.impl;
 
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
-import com.onixbyte.guid.exceptions.TimingException;
+import com.onixbyte.identitygenerator.exceptions.TimingException;
 
 import java.time.LocalDateTime;
 import java.time.ZoneId;
 
 /**
- * The {@code SnowflakeGuidCreator} generates unique identifiers using the Snowflake algorithm,
+ * The {@code SnowflakeIdentityGenerator} generates unique identifiers using the Snowflake algorithm,
  * which combines a timestamp, worker ID, and data centre ID to create 64-bit long integers. The bit
  * distribution for the generated IDs is as follows:
  * <ul>
@@ -35,7 +35,7 @@ import java.time.ZoneId;
  *     <li>12 bits for sequence number (per millisecond)</li>
  * </ul>
  * <p>
- * When initializing a {@link SnowflakeGuidCreator}, you must provide the worker ID and data centre
+ * When initializing a {@link SnowflakeIdentityGenerator}, you must provide the worker ID and data centre
  * ID, ensuring they are within the valid range defined by the bit size. The generator maintains an
  * internal sequence number that increments for IDs generated within the same millisecond. If the
  * system clock moves backward, an exception is thrown to prevent generating IDs with
@@ -45,7 +45,7 @@ import java.time.ZoneId;
  * @version 1.1.0
  * @since 1.0.0
  */
-public final class SnowflakeGuidCreator implements GuidCreator<Long> {
+public final class SnowflakeIdentityGenerator implements IdentityGenerator<Long> {
 
     /**
      * Constructs a SnowflakeGuidGenerator with the default start epoch and custom worker ID, data
@@ -54,7 +54,7 @@ public final class SnowflakeGuidCreator implements GuidCreator<Long> {
      * @param dataCentreId the data centre ID (between 0 and 31)
      * @param workerId     the worker ID (between 0 and 31)
      */
-    public SnowflakeGuidCreator(long dataCentreId, long workerId) {
+    public SnowflakeIdentityGenerator(long dataCentreId, long workerId) {
         this(dataCentreId, workerId, DEFAULT_CUSTOM_EPOCH);
     }
 
@@ -67,7 +67,7 @@ public final class SnowflakeGuidCreator implements GuidCreator<Long> {
      * @throws IllegalArgumentException if the start epoch is greater than the current timestamp,
      *                                  or if the worker ID or data centre ID is out of range
      */
-    public SnowflakeGuidCreator(long dataCentreId, long workerId, long startEpoch) {
+    public SnowflakeIdentityGenerator(long dataCentreId, long workerId, long startEpoch) {
         if (startEpoch > currentTimestamp()) {
             throw new IllegalArgumentException("Start Epoch can not be greater than current timestamp!");
         }

jwt-toolbox-auth0/README.md

@@ -50,7 +50,7 @@ implementation 'cn.org.codecrafters:simple-jwt-authzero:${simple-jwt-authzero.ve
 
 ## Use the `AuthzeroTokenResolver`
 
-We have implemented `TokenResolver` to make sure you can add JWT to your Java application as soon as possible. All you need to do is to create an instance of `com.onixbyte.simplejwt.authzero.AuthzeroTokenResolver` and other operations to JWT could follow our instruction in [`simple-jwt-facade`](../simple-jwt-facade/README.md).
+We have implemented `TokenResolver` to make sure you can add JWT to your Java application as soon as possible. All you need to do is to create an instance of `com.onixbyte.jwt.auth0.AuthzeroTokenResolver` and other operations to JWT could follow our instruction in [`simple-jwt-facade`](../simple-jwt-facade/README.md).
 
 ## Contact
 

jwt-toolbox-auth0/build.gradle.kts

@@ -55,10 +55,10 @@ dependencies {
     compileOnly(libs.slf4j)
     implementation(libs.logback)
 
-    api(project(":devkit-utils"))
+    api(project(":common-toolbox"))
-    api(project(":guid"))
+    api(project(":identity-generator"))
-    api(project(":key-pair-loader"))
+    api(project(":crypto-toolbox"))
-    api(project(":simple-jwt-facade"))
+    api(project(":jwt-toolbox-facade"))
     api(libs.jackson.databind)
     api(libs.jwt.core)
 
@@ -72,13 +72,13 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("simpleJwtAuthzero") {
+        create<MavenPublication>("jwtToolboxAuth0") {
             groupId = group.toString()
-            artifactId = "simple-jwt-authzero"
+            artifactId = "jwt-toolbox-auth0"
             version = artefactVersion
 
             pom {
-                name = "OnixByte JWT Toolbox :: Auth0 Implementation"
+                name = "OnixByte JWT Toolbox :: Auth0"
                 description = "Simple JWT implemented with com.auth0:java-jwt."
                 url = projectUrl
 
@@ -90,8 +90,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -115,7 +115,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["simpleJwtAuthzero"])
+                sign(publishing.publications["jwtToolboxAuth0"])
             }
         }
 

jwt-toolbox-auth0/src/main/java/com/onixbyte/jwt/auth0/AuthzeroTokenResolver.java

@@ -15,17 +15,17 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.authzero;
+package com.onixbyte.jwt.auth0;
 
-import com.onixbyte.devkit.utils.Base64Util;
+import com.onixbyte.common.util.Base64Util;
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.crypto.algorithm.ecdsa.ECPrivateKeyLoader;
-import com.onixbyte.security.impl.ECKeyLoader;
+import com.onixbyte.identitygenerator.IdentityGenerator;
-import com.onixbyte.simplejwt.TokenPayload;
+import com.onixbyte.jwt.TokenPayload;
-import com.onixbyte.simplejwt.TokenResolver;
+import com.onixbyte.jwt.TokenResolver;
-import com.onixbyte.simplejwt.annotations.ExcludeFromPayload;
+import com.onixbyte.jwt.annotations.ExcludeFromPayload;
-import com.onixbyte.simplejwt.annotations.TokenEnum;
+import com.onixbyte.jwt.annotations.TokenEnum;
-import com.onixbyte.simplejwt.constants.PredefinedKeys;
+import com.onixbyte.jwt.constants.PredefinedKeys;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import com.auth0.jwt.JWT;
 import com.auth0.jwt.JWTCreator;
 import com.auth0.jwt.algorithms.Algorithm;
@@ -35,9 +35,9 @@ import com.fasterxml.jackson.core.JsonProcessingException;
 import com.fasterxml.jackson.core.type.TypeReference;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.node.ObjectNode;
-import com.onixbyte.simplejwt.exceptions.IllegalKeyPairException;
+import com.onixbyte.jwt.exceptions.IllegalKeyPairException;
-import com.onixbyte.simplejwt.exceptions.IllegalSecretException;
+import com.onixbyte.jwt.exceptions.IllegalSecretException;
-import com.onixbyte.simplejwt.exceptions.UnsupportedAlgorithmException;
+import com.onixbyte.jwt.exceptions.UnsupportedAlgorithmException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -92,7 +92,7 @@ import java.util.function.Function;
  *
  * @author Zihlu Wang
  * @version 1.1.1
- * @see GuidCreator
+ * @see IdentityGenerator
  * @see Algorithm
  * @see JWTVerifier
  * @see JWTCreator
@@ -118,9 +118,9 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
     public static class Builder {
 
         /**
-         * GuidCreator used for generating unique identifiers for "jti" claim in JWT tokens.
+         * IdentityGenerator used for generating unique identifiers for "jti" claim in JWT tokens.
          */
-        private GuidCreator<?> jtiCreator;
+        private IdentityGenerator<?> jtiCreator;
 
         /**
          * The algorithm used for signing and verifying JWT tokens.
@@ -177,8 +177,8 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
          * @return the builder instance
          */
         public Builder keyPair(String publicKey, String privateKey) {
-            var keyLoader = new ECKeyLoader();
+            var keyLoader = new ECPrivateKeyLoader();
-            this.publicKey = keyLoader.loadPublicKey(publicKey);
+            // this.publicKey = keyLoader.loadPublicKey(publicKey);
             this.privateKey = keyLoader.loadPrivateKey(privateKey);
             return this;
         }
@@ -234,7 +234,7 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
          * @param jtiCreator a creator to create JWT id
          * @return the builder instance
          */
-        public Builder jtiCreator(GuidCreator<?> jtiCreator) {
+        public Builder jtiCreator(IdentityGenerator<?> jtiCreator) {
             this.jtiCreator = jtiCreator;
             return this;
         }
@@ -597,9 +597,9 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
     }
 
     /**
-     * GuidCreator used for generating unique identifiers for "jti" claim in JWT tokens.
+     * IdentityGenerator used for generating unique identifiers for "jti" claim in JWT tokens.
      */
-    private final GuidCreator<?> jtiCreator;
+    private final IdentityGenerator<?> jtiCreator;
 
     /**
      * The algorithm used for signing and verifying JWT tokens.
@@ -647,7 +647,7 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
      * @param issuer       the person or organisation who issued this JWT
      * @param objectMapper a mapper for handling JSON serialisation and deserialization
      */
-    private AuthzeroTokenResolver(GuidCreator<?> jtiCreator, Algorithm algorithm, String issuer, ObjectMapper objectMapper) {
+    private AuthzeroTokenResolver(IdentityGenerator<?> jtiCreator, Algorithm algorithm, String issuer, ObjectMapper objectMapper) {
         this.jtiCreator = jtiCreator;
         this.algorithm = algorithm;
         this.issuer = issuer;

jwt-toolbox-auth0/src/test/java/com/onixbyte/jwt/auth0/test/TestAuthzeroTokenResolver.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.authzero.test;
+package com.onixbyte.jwt.auth0.test;
 
 /**
  * TestAuthzeroTokenResolver

jwt-toolbox-facade/build.gradle.kts

@@ -55,8 +55,8 @@ dependencies {
     compileOnly(libs.slf4j)
     implementation(libs.logback)
 
-    api(project(":devkit-utils"))
+    api(project(":common-toolbox"))
-    api(project(":guid"))
+    api(project(":identity-generator"))
 
     testImplementation(platform(libs.junit.bom))
     testImplementation(libs.junit.jupiter)
@@ -68,9 +68,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("simpleJwtFacade") {
+        create<MavenPublication>("jwtToolboxFacade") {
             groupId = group.toString()
-            artifactId = "simple-jwt-facade"
+            artifactId = "jwt-toolbox-facade"
             version = artefactVersion
 
             pom {
@@ -86,8 +86,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -111,7 +111,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["simpleJwtFacade"])
+                sign(publishing.publications["jwtToolboxFacade"])
             }
         }
 

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/SecretCreator.java

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;
 
-import com.onixbyte.simplejwt.exceptions.WeakSecretException;
+import com.onixbyte.jwt.exceptions.WeakSecretException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/TokenPayload.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;
 
 /**
  * {@code TokenPayload} interface is used to mark a data class as suitable

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/TokenResolver.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;
 
 import java.time.Duration;
 import java.util.Map;

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/annotations/ExcludeFromPayload.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.annotations;
+package com.onixbyte.jwt.annotations;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/annotations/TokenEnum.java

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.annotations;
+package com.onixbyte.jwt.annotations;
 
-import com.onixbyte.simplejwt.constants.TokenDataType;
+import com.onixbyte.jwt.constants.TokenDataType;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/constants/PredefinedKeys.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;
 
 import java.util.List;
 

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/constants/TokenAlgorithm.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;
 
 import java.util.List;
 

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/constants/TokenDataType.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;
 
 /**
  * The base data types used to process enum data.

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/exceptions/IllegalKeyPairException.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;
 
 /**
  * {@link IllegalKeyPairException} indicates an exception that the key pair is invalid.

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/exceptions/IllegalSecretException.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;
 
 /**
  * {@link IllegalKeyPairException} indicates the secret to sign a JWT is illegal.

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/exceptions/UnsupportedAlgorithmException.java

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;
 
-import com.onixbyte.simplejwt.TokenResolver;
+import com.onixbyte.jwt.TokenResolver;
 
 /**
  * This {@code UnsupportedAlgorithmException} represents the given

jwt-toolbox-facade/src/main/java/com/onixbyte/jwt/exceptions/WeakSecretException.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;
 
 /**
  * {@code WeakSecretException} represents that your secret is too weak to be

jwt-toolbox-spring-boot-starter/README.md

@@ -66,7 +66,7 @@ implementation 'com.onixbyte:simple-jwt-spring-boot-starter:${simple-jwt-spring-
 
 We need a `GuidCreator` instance to create JWT ID, though we did implemented a simple `GuidCreator`, but you can still customize it.
 
-First, please implement the `com.onixbyte.guid.GuidCreator` interface based on your own rules for generating JWT IDs.
+First, please implement the `com.onixbyte.identitygenerator.IdentityGenerator` interface based on your own rules for generating JWT IDs.
 
 Then, add the instance of your own guid creator to spring container, whose name is `jtiCreator`.
 

jwt-toolbox-spring-boot-starter/build.gradle.kts

@@ -55,9 +55,9 @@ dependencies {
     compileOnly(libs.slf4j)
     implementation(libs.logback)
 
-    api(project(":guid"))
+    api(project(":identity-generator"))
-    api(project(":simple-jwt-facade"))
+    api(project(":jwt-toolbox-facade"))
-    api(project(":simple-jwt-authzero"))
+    api(project(":jwt-toolbox-auth0"))
     implementation(libs.springBoot.autoconfigure)
     implementation(libs.springBoot.starter.logging)
     implementation(libs.springBoot.configurationProcessor)
@@ -81,9 +81,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("simpleJwtSpringBootStarter") {
+        create<MavenPublication>("jwtSpringBootStarter") {
             groupId = group.toString()
-            artifactId = "simple-jwt-spring-boot-starter"
+            artifactId = "jwt-spring-boot-starter"
             version = artefactVersion
 
             pom {
@@ -99,8 +99,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -124,7 +124,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["simpleJwtSpringBootStarter"])
+                sign(publishing.publications["jwtSpringBootStarter"])
             }
         }
 

jwt-toolbox-spring-boot-starter/src/main/java/com/onixbyte/jwt/autoconfiguration/AuthzeroTokenResolverAutoConfiguration.java

@@ -15,15 +15,15 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.autoconfiguration;
+package com.onixbyte.jwt.autoconfiguration;
 
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
-import com.onixbyte.simplejwt.TokenResolver;
+import com.onixbyte.jwt.TokenResolver;
-import com.onixbyte.simplejwt.authzero.AuthzeroTokenResolver;
+import com.onixbyte.jwt.auth0.AuthzeroTokenResolver;
-import com.onixbyte.simplejwt.autoconfiguration.properties.SimpleJwtProperties;
+import com.onixbyte.jwt.autoconfiguration.properties.SimpleJwtProperties;
 import com.auth0.jwt.interfaces.DecodedJWT;
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -60,7 +60,7 @@ import org.springframework.context.annotation.Bean;
 @EnableConfigurationProperties(value = {SimpleJwtProperties.class})
 @ConditionalOnClass({DecodedJWT.class, AuthzeroTokenResolver.class})
 @ConditionalOnMissingBean({TokenResolver.class})
-@ConditionalOnBean(value = {GuidCreator.class}, name = "jtiCreator")
+@ConditionalOnBean(value = {IdentityGenerator.class}, name = "jtiCreator")
 @AutoConfigureAfter(value = GuidAutoConfiguration.class)
 public class AuthzeroTokenResolverAutoConfiguration {
 
@@ -76,7 +76,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
      */
     @Autowired
     public AuthzeroTokenResolverAutoConfiguration(SimpleJwtProperties simpleJwtProperties,
-                                                  @Qualifier("jtiCreator") GuidCreator<?> jtiCreator,
+                                                  @Qualifier("jtiCreator") IdentityGenerator<?> jtiCreator,
                                                   ObjectMapper objectMapper) {
         this.jtiCreator = jtiCreator;
         this.simpleJwtProperties = simpleJwtProperties;
@@ -86,7 +86,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
     /**
      * Creates a new {@link TokenResolver} bean using {@link AuthzeroTokenResolver} if no existing
      * {@link TokenResolver} bean is found. The {@link AuthzeroTokenResolver} is configured with the
-     * provided {@link GuidCreator}, {@code algorithm}, {@code issuer}, and {@code secret}
+     * provided {@link IdentityGenerator}, {@code algorithm}, {@code issuer}, and {@code secret}
      * properties from {@link SimpleJwtProperties}.
      *
      * @return the {@link TokenResolver} instance
@@ -110,7 +110,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
         return builder.build();
     }
 
-    private final GuidCreator<?> jtiCreator;
+    private final IdentityGenerator<?> jtiCreator;
 
     private final SimpleJwtProperties simpleJwtProperties;
 

jwt-toolbox-spring-boot-starter/src/main/java/com/onixbyte/jwt/autoconfiguration/GuidAutoConfiguration.java

@@ -15,10 +15,10 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.autoconfiguration;
+package com.onixbyte.jwt.autoconfiguration;
 
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
-import com.onixbyte.simplejwt.autoconfiguration.conditions.GuidCreatorCondition;
+import com.onixbyte.jwt.autoconfiguration.conditions.GuidCreatorCondition;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
@@ -28,7 +28,7 @@ import org.springframework.context.annotation.Conditional;
 import java.util.UUID;
 
 /**
- * Autoconfiguration for injecting a {@link GuidCreator} for generating jwt id.
+ * Autoconfiguration for injecting a {@link IdentityGenerator} for generating jwt id.
  *
  * @author Zihlu Wang
  * @version 1.1.0
@@ -52,7 +52,7 @@ public class GuidAutoConfiguration {
      */
     @Bean(name = "jtiCreator")
     @Conditional(GuidCreatorCondition.class)
-    public GuidCreator<?> jtiCreator() {
+    public IdentityGenerator<?> jtiCreator() {
         return UUID::randomUUID;
     }
 

jwt-toolbox-spring-boot-starter/src/main/java/com/onixbyte/jwt/autoconfiguration/conditions/GuidCreatorCondition.java

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.autoconfiguration.conditions;
+package com.onixbyte.jwt.autoconfiguration.conditions;
 
-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.context.annotation.Condition;
@@ -46,7 +46,7 @@ public class GuidCreatorCondition implements Condition {
     /**
      * The condition to create bean {@code jtiCreator}.
      * <p>
-     * If Spring does not have a bean of type {@link GuidCreator} named {@code jtiCreator} in the
+     * If Spring does not have a bean of type {@link IdentityGenerator} named {@code jtiCreator} in the
      * application context, then create {@code jtiCreator}.
      *
      * @param context  the spring application context
@@ -59,7 +59,7 @@ public class GuidCreatorCondition implements Condition {
         final var beanFactory = Objects.requireNonNull(context.getBeanFactory());
         var isContainJtiCreator = beanFactory.containsBean("jtiCreator");
         if (isContainJtiCreator) {
-            return !(beanFactory.getBean("jtiCreator") instanceof GuidCreator<?>);
+            return !(beanFactory.getBean("jtiCreator") instanceof IdentityGenerator<?>);
         }
         return true;
     }

jwt-toolbox-spring-boot-starter/src/main/java/com/onixbyte/jwt/autoconfiguration/properties/SimpleJwtProperties.java

@@ -15,11 +15,11 @@
  * limitations under the License.
  */
 
-package com.onixbyte.simplejwt.autoconfiguration.properties;
+package com.onixbyte.jwt.autoconfiguration.properties;
 
-import com.onixbyte.simplejwt.SecretCreator;
+import com.onixbyte.jwt.SecretCreator;
-import com.onixbyte.simplejwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration;
+import com.onixbyte.jwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 
 /**

jwt-toolbox-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -0,0 +1,2 @@
+com.onixbyte.jwt.autoconfiguration.GuidAutoConfiguration
+com.onixbyte.jwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration

key-pair-loader/src/main/java/com/onixbyte/security/KeyLoader.java

@@ -1,116 +0,0 @@
-/*
- * Copyright (C) 2024-2025 OnixByte.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package com.onixbyte.security;
-
-import com.onixbyte.security.exception.KeyLoadingException;
-
-import java.security.PrivateKey;
-import java.security.PublicKey;
-import java.security.interfaces.ECPublicKey;
-import java.security.interfaces.RSAPublicKey;
-
-/**
- * The {@code KeyLoader} class provides utility methods for loading keys pairs from PEM-formatted
- * key text. This class supports loading both private and public keys.
- * <p>
- * The utility methods in this class are useful for scenarios where ECDSA keys need to be loaded
- * from PEM-formatted strings for cryptographic operations.
- *
- * @author zihluwang
- * @version 2.0.0
- * @since 1.6.0
- */
-public interface KeyLoader {
-
-    /**
-     * Load private key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     */
-    PrivateKey loadPrivateKey(String pemKeyText);
-
-    /**
-     * Load public key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     */
-    PublicKey loadPublicKey(String pemKeyText);
-
-    /**
-     * Loads an RSA public key using the provided modulus and exponent.
-     * <p>
-     * This default implementation throws a {@link KeyLoadingException} to signify that this key loader does not support
-     * loading an RSA public key. Implementing classes are expected to override this method to supply their own
-     * loading logic.
-     *
-     * @param modulus  the modulus value of the RSA public key, usually represented in hexadecimal or Base64
-     *                 string format
-     * @param exponent the public exponent value of the RSA public key, usually represented in hexadecimal or Base64
-     *                 string format
-     * @return the loaded {@link RSAPublicKey} instance
-     * @throws KeyLoadingException if loading is not supported or fails
-     */
-    default RSAPublicKey loadPublicKey(String modulus, String exponent) {
-        throw new KeyLoadingException("This key loader does not support loading an RSA public key.");
-    }
-
-    /**
-     * Loads an EC public key using the provided x and y coordinates together with the curve name.
-     * <p>
-     * This default implementation throws a {@link KeyLoadingException} to signify that this key loader does not support
-     * loading an EC public key. Implementing classes are expected to override this method to supply their own
-     * loading logic.
-     *
-     * @param xHex      the hexadecimal string representing the x coordinate of the EC point
-     * @param yHex      the hexadecimal string representing the y coordinate of the EC point
-     * @param curveName the name of the elliptic curve
-     * @return the loaded {@link ECPublicKey} instance
-     * @throws KeyLoadingException if loading is not supported or fails
-     */
-    default ECPublicKey loadPublicKey(String xHex, String yHex, String curveName) {
-        throw new KeyLoadingException("This key loader does not support loading an EC public key.");
-    }
-
-    /**
-     * Retrieves the raw content of a PEM formatted key by removing unnecessary headers, footers,
-     * and new line characters.
-     *
-     * <p>
-     * This method processes the provided PEM key text to return a cleaned string that contains
-     * only the key content. The method strips away the
-     * {@code "-----BEGIN (EC )?(PRIVATE|PUBLIC) KEY-----"} and
-     * {@code "-----END (EC )?(PRIVATE|PUBLIC) KEY-----"} lines, as well as any new line characters,
-     * resulting in a continuous string representation of the key, which can be used for further
-     * cryptographic operations.
-     *
-     * @param pemKeyText the PEM formatted key as a string, which may include headers, footers and
-     *                   line breaks
-     * @return a string containing the raw key content devoid of  any unnecessary formatting
-     * or whitespace
-     */
-    default String getRawContent(String pemKeyText) {
-        // remove all unnecessary parts of the pem key text
-        return pemKeyText
-                .replaceAll("-----BEGIN ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
-                .replaceAll("-----END ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
-                .replaceAll("\n", "");
-    }
-
-}

math-toolbox/build.gradle.kts

@@ -64,9 +64,9 @@ tasks.test {
 
 publishing {
     publications {
-        create<MavenPublication>("num4j") {
+        create<MavenPublication>("mathToolbox") {
             groupId = group.toString()
-            artifactId = "num4j"
+            artifactId = "math-toolbox"
             version = artefactVersion
 
             pom {
@@ -83,8 +83,8 @@ publishing {
                 }
 
                 scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                     url = projectGithubUrl
                 }
 
@@ -108,7 +108,7 @@ publishing {
             from(components["java"])
 
             signing {
-                sign(publishing.publications["num4j"])
+                sign(publishing.publications["mathToolbox"])
             }
         }
 

math-toolbox/src/main/java/com/onixbyte/math/ChainedCalcUtil.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.nums;
+package com.onixbyte.math;
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

math-toolbox/src/main/java/com/onixbyte/math/PercentileCalculator.java

@@ -15,9 +15,9 @@
  * limitations under the License.
  */
 
-package com.onixbyte.nums;
+package com.onixbyte.math;
 
-import com.onixbyte.nums.model.QuartileBounds;
+import com.onixbyte.math.model.QuartileBounds;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 

math-toolbox/src/main/java/com/onixbyte/math/model/QuartileBounds.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package com.onixbyte.nums.model;
+package com.onixbyte.math.model;
 
 /**
  * A record representing the quartile bounds of a dataset.

settings.gradle.kts

@@ -18,12 +18,12 @@
 rootProject.name = "onixbyte-toolbox"
 
 include(
-    "devkit-bom",
+    "version-catalogue",
-    "devkit-utils",
+    "common-toolbox",
-    "guid",
+    "identity-generator",
-    "key-pair-loader",
+    "crypto-toolbox",
-    "num4j",
+    "math-toolbox",
-    "simple-jwt-facade",
+    "jwt-toolbox-facade",
-    "simple-jwt-authzero",
+    "jwt-toolbox-auth0",
-    "simple-jwt-spring-boot-starter",
+    "jwt-toolbox-spring-boot-starter",
 )

simple-jwt-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -1,2 +0,0 @@
-com.onixbyte.simplejwt.autoconfiguration.GuidAutoConfiguration
-com.onixbyte.simplejwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration

version-catalogue/build.gradle.kts

@@ -49,9 +49,9 @@ dependencies {
 
 publishing {
     publications {
-        create<MavenPublication>("devkitBom") {
+        create<MavenPublication>("versionCatalogue") {
             groupId = group.toString()
-            artifactId = "devkit-bom"
+            artifactId = "version-catalogue"
             version = artefactVersion
 
             pom {
@@ -92,7 +92,7 @@ publishing {
             from(components["javaPlatform"])
 
             signing {
-                sign(publishing.publications["devkitBom"])
+                sign(publishing.publications["versionCatalogue"])
             }
         }