Refactor version parsing and retrieval APIs.

Removed nullability annotations and simplified parse method in SemanticVersion. Updated VersionChecker interface to use CompletableFuture for async methods and added support for retrieving all versions.

Author: david

version-checker/src/main/java/core/version/SemanticVersion.java

@@ -26,18 +26,13 @@ public record SemanticVersion(int major, int minor, int patch, @Nullable String
      * @param string the version string to parse
      * @return the parsed SemanticVersion object, or null if it is not a valid SemVer
      */
-    public static @Nullable SemanticVersion parse(String string) {
-        try {
-            if (!string.matches(PATTERN)) return null;
-            var parts = string.split("-", 2);
-            var split = parts[0].split("\\.", 3);
-            var major = Integer.parseInt(split[0]);
-            var minor = Integer.parseInt(split[1]);
-            var patch = Integer.parseInt(split[2]);
-            return new SemanticVersion(major, minor, patch, parts.length == 2 ? parts[1] : null);
-        } catch (Exception ignored) {
-            return null;
-        }
+    public static SemanticVersion parse(String string) {
+        var parts = string.split("-", 2);
+        var split = parts[0].split("\\.", 3);
+        var major = Integer.parseInt(split[0]);
+        var minor = Integer.parseInt(split[1]);
+        var patch = Integer.parseInt(split[2]);
+        return new SemanticVersion(major, minor, patch, parts.length == 2 ? parts[1] : null);
     }
 
     /**

version-checker/src/main/java/core/version/VersionChecker.java

@@ -1,9 +1,9 @@
 package core.version;
 
-import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
 
-import java.util.Optional;
-import java.util.function.Consumer;
+import java.util.Set;
+import java.util.concurrent.CompletableFuture;
 
 public interface VersionChecker<N, V extends Version> {
     /**
@@ -17,18 +17,16 @@ public interface VersionChecker<N, V extends Version> {
      * Parses a version of type N into a version of type V.
      *
      * @param version the version to parse
-     * @return the parsed version of type V, or null if parsing fails
+     * @return the parsed version of type V
      */
-    @Nullable
     V parseVersion(N version);
 
     /**
      * Parses a version of type String into a version of type V.
      *
      * @param version the version to parse
-     * @return the parsed version of type V, or null if parsing fails
+     * @return the parsed version of type V
      */
-    @Nullable
     V parseVersion(String version);
 
     /**
@@ -40,9 +38,23 @@ public interface VersionChecker<N, V extends Version> {
     boolean isSupported(N version);
 
     /**
-     * Retrieves the latest supported version of the software and passes it to the provided success {@link Consumer}.
+     * Asynchronously retrieves the latest available version.
      *
-     * @param success the consumer that will receive the latest supported version wrapped in an {@link Optional}.
+     * @return a CompletableFuture containing the latest version
      */
-    void retrieveLatestSupportedVersion(Consumer<Optional<V>> success);
+    CompletableFuture<V> retrieveLatestVersion();
+
+    /**
+     * Retrieves all available versions asynchronously.
+     *
+     * @return a CompletableFuture containing a Set of all versions
+     */
+    CompletableFuture<@Unmodifiable Set<V>> retrieveVersions();
+
+    /**
+     * Retrieves the latest supported version of the software asynchronously.
+     *
+     * @return a CompletableFuture containing the latest supported version
+     */
+    CompletableFuture<V> retrieveLatestSupportedVersion();
 }