Add new methods and default implementations to Platform and TaskScheduler interfaces

Author: renvins

common/src/main/java/it/renvins/serverpulse/common/platform/Platform.java

@@ -21,6 +21,16 @@ public interface Platform {
      */
     boolean isPrimaryThread();
 
+    /**
+     * @return the number of online players
+     */
     int getOnlinePlayerCount();
-    Map<String, WorldData> getWorldsData();
+
+    /**
+     * @return a map of world names to their data
+     * @throws UnsupportedOperationException if the platform does not support this method
+     */
+    default Map<String, WorldData> getWorldsData() {
+        throw new UnsupportedOperationException("This method is not supported on this platform.");
+    }
 }

common/src/main/java/it/renvins/serverpulse/common/scheduler/Task.java

@@ -2,7 +2,6 @@
 
 public interface Task {
 
-
     /**
      * Cancels the task
      */

common/src/main/java/it/renvins/serverpulse/common/scheduler/TaskScheduler.java

@@ -2,12 +2,56 @@
 
 public interface TaskScheduler {
 
-    void runSync(Runnable task);
+    /**
+     * Runs a task synchronously on the main thread.
+     *
+     * @param task The task to run
+     * @throws UnsupportedOperationException if the implementation does not support synchronous task execution
+     */
+    default void runSync(Runnable task) {
+        throw new UnsupportedOperationException("Synchronous task execution is not supported.");
+    }
+
+    /**
+     * Runs a task timer synchronously on the main thread.
+     *
+     * @param task The task to run
+     * @throws UnsupportedOperationException if the implementation does not support synchronous task execution
+     */
+    default Task runTaskTimer(Runnable task, long delayTicks, long periodTicks) {
+        throw new UnsupportedOperationException("Synchronous task execution is not supported.");
+    }
+
+    /**
+     * Runs a task later synchronously on the main thread.
+     *
+     * @param task The task to run
+     * @throws UnsupportedOperationException if the implementation does not support synchronous task execution
+     */
+    default Task runTaskLater(Runnable task, long delayTicks) {
+        throw new UnsupportedOperationException("Synchronous task execution is not supported.");
+    }
+
+    /**
+     * Runs a task asynchronously on a separate thread.
+     *
+     * @param task The task to run
+     */
     void runAsync(Runnable task);
 
-    Task runTaskTimer(Runnable task, long delayTicks, long periodTicks);
+    /**
+     * Runs a task timer asynchronously on a separate thread.
+     *
+     * @param task The task to run
+     * @return A Task object representing the task
+     */
     Task runTaskTimerAsync(Runnable task, long delayTicks, long periodTicks);
 
-    Task runTaskLater(Runnable task, long delayTicks);
+    /**
+     * Runs a task later asynchronously on a separate thread.
+     *
+     * @param task The task to run
+     * @return A Task object representing the task
+     */
     Task runTaskLaterAsync(Runnable task, long delayTicks);
 }