Add isInitialized method to configuration classes and update version (#368)

Author: twisti-dev

gradle.properties

@@ -7,6 +7,6 @@ org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
 javaVersion=25
 mcVersion=26.1.2
 group=dev.slne.surf.api
-version=3.18.0
+version=3.19.0
 relocationPrefix=dev.slne.surf.api.libs
 snapshot=false

surf-api-core/surf-api-core/api/surf-api-core.api

@@ -150,6 +150,7 @@ public abstract class dev/slne/surf/api/core/config/SpongeConfigClass {
 	public abstract fun getManager ()Ldev/slne/surf/api/core/config/manager/SpongeConfigManager;
 	protected final fun getMigrationBuilder ()Ldev/slne/surf/api/core/config/migration/ConfigMigrationBuilder;
 	public final fun init ()V
+	public abstract fun isInitialized ()Z
 	protected final fun migration (ILdev/slne/surf/api/core/config/migration/ConfigMigration;)V
 	protected final fun migration (ILkotlin/jvm/functions/Function1;)V
 	public final fun reloadFromFile ()Ljava/lang/Object;
@@ -159,12 +160,14 @@ public abstract class dev/slne/surf/api/core/config/SpongeConfigClass {
 
 public abstract class dev/slne/surf/api/core/config/SpongeJsonConfigClass : dev/slne/surf/api/core/config/SpongeConfigClass {
 	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
-	public fun getManager ()Ldev/slne/surf/api/core/config/manager/SpongeConfigManager;
+	public final fun getManager ()Ldev/slne/surf/api/core/config/manager/SpongeConfigManager;
+	public final fun isInitialized ()Z
 }
 
 public abstract class dev/slne/surf/api/core/config/SpongeYmlConfigClass : dev/slne/surf/api/core/config/SpongeConfigClass {
 	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
-	public fun getManager ()Ldev/slne/surf/api/core/config/manager/SpongeConfigManager;
+	public final fun getManager ()Ldev/slne/surf/api/core/config/manager/SpongeConfigManager;
+	public final fun isInitialized ()Z
 }
 
 public abstract interface class dev/slne/surf/api/core/config/SurfConfigApi {

surf-api-core/surf-api-core/src/main/kotlin/dev/slne/surf/api/core/config/SpongeConfigClass.kt

@@ -78,6 +78,11 @@ sealed class SpongeConfigClass<C>(
      */
     abstract val manager: SpongeConfigManager<C>
 
+    /**
+     * Whether the config has been initialized and loaded from disk.
+     */
+    abstract fun isInitialized(): Boolean
+
     /**
      * Registers a migration for the given target [version].
      *

surf-api-core/surf-api-core/src/main/kotlin/dev/slne/surf/api/core/config/SpongeJsonConfigClass.kt

@@ -33,18 +33,24 @@ abstract class SpongeJsonConfigClass<C>(
     configClass: Class<C>, configFolder: Path, fileName: String
 ) : SpongeConfigClass<C>(configClass, configFolder, fileName) {
 
-    /**
-     * JSON-backed configuration manager for this config type.
-     *
-     * The manager is created using [SurfConfigApi.createSpongeJsonConfigManager]
-     * with [configClass], [configFolder], [fileName] and [migrationBuilder].
-     */
-    override val manager by lazy {
+    private val managerLazy = lazy {
         surfConfigApi.createSpongeJsonConfigManager(
             configClass,
             configFolder,
             fileName,
             migrationBuilder
         )
     }
+
+    /**
+     * JSON-backed configuration manager for this config type.
+     *
+     * The manager is created using [SurfConfigApi.createSpongeJsonConfigManager]
+     * with [configClass], [configFolder], [fileName] and [migrationBuilder].
+     */
+    final override val manager by managerLazy
+
+    final override fun isInitialized(): Boolean {
+        return managerLazy.isInitialized()
+    }
 }

surf-api-core/surf-api-core/src/main/kotlin/dev/slne/surf/api/core/config/SpongeYmlConfigClass.kt

@@ -33,18 +33,24 @@ abstract class SpongeYmlConfigClass<C>(
     configClass: Class<C>, configFolder: Path, fileName: String
 ) : SpongeConfigClass<C>(configClass, configFolder, fileName) {
 
-    /**
-     * YAML-backed configuration manager for this config type.
-     *
-     * The manager is created using [SurfConfigApi.createSpongeYmlConfigManager]
-     * with [configClass], [configFolder], [fileName] and [migrationBuilder].
-     */
-    override val manager by lazy {
+    private val managerLazy = lazy {
         surfConfigApi.createSpongeYmlConfigManager(
             configClass,
             configFolder,
             fileName,
             migrationBuilder
         )
     }
+
+    /**
+     * YAML-backed configuration manager for this config type.
+     *
+     * The manager is created using [SurfConfigApi.createSpongeYmlConfigManager]
+     * with [configClass], [configFolder], [fileName] and [migrationBuilder].
+     */
+    final override val manager by managerLazy
+
+    final override fun isInitialized(): Boolean {
+        return managerLazy.isInitialized()
+    }
 }