feat: add GenerateExposedMigrationScript task and enhance cloud module support

- Introduced the `generateExposedMigrationScript` Gradle task for creating migration scripts with Exposed ORM.
- Added `migrationMainClass` property to Surf extensions for script configuration.
- Updated `SurfCloudModules` enum to include the `STANDALONE` module.
- Bumped plugin version to 1.3.0.

Author: twisti-dev

surf-api-gradle-plugin/build.gradle.kts

@@ -20,7 +20,7 @@ plugins {
 group = groupId
 version = buildString {
     append(mcVersion)
-    append("-1.2.0")
+    append("-1.3.0")
     if (snapshot) append("-SNAPSHOT")
 }
 

surf-api-gradle-plugin/src/main/kotlin/dev/slne/surf/surfapi/gradle/SurfCloudModules.kt

@@ -1,9 +1,10 @@
 package dev.slne.surf.surfapi.gradle
 
-enum class SurfCloudModules(val module: String) {
+internal enum class SurfCloudModules(val module: String) {
     COMMON("surf-cloud-api-common"),
     CLIENT_COMMON("surf-cloud-api-client-common"),
     CLIENT_PAPER("surf-cloud-api-client-paper"),
     CLIENT_VELOCITY("surf-cloud-api-client-velocity"),
     SERVER("surf-cloud-api-server"),
+    STANDALONE("surf-cloud-standalone"),
 }

surf-api-gradle-plugin/src/main/kotlin/dev/slne/surf/surfapi/gradle/platform/common/CommonSurfExtension.kt

@@ -11,6 +11,7 @@ abstract class CommonSurfExtension(protected val objects: ObjectFactory) {
     internal val publishingUrl = objects.property<String>().convention("https://repo.slne.dev/repository/maven-releases")
     internal val publishingRepoName = objects.property<String>().convention("maven-releases")
     internal val cloudModule = objects.property<SurfCloudModules>()
+    internal val migrationMainClass = objects.property<String>()
 
     fun addSurfApiToClasspath(value: Boolean) {
         addSurfApiToClasspath.set(value)

surf-api-gradle-plugin/src/main/kotlin/dev/slne/surf/surfapi/gradle/platform/common/CommonSurfPlugin.kt

@@ -1,8 +1,10 @@
 package dev.slne.surf.surfapi.gradle.platform.common
 
 import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
+import dev.slne.surf.surfapi.gradle.SurfCloudModules
 import dev.slne.surf.surfapi.gradle.generated.Constants
 import dev.slne.surf.surfapi.gradle.platform.SurfApiPlatform
+import dev.slne.surf.surfapi.gradle.platform.core.tasks.generateExposedMigrationScript
 import dev.slne.surf.surfapi.gradle.util.slnePublic
 import org.gradle.api.Plugin
 import org.gradle.api.Project
@@ -201,6 +203,14 @@ abstract class CommonSurfPlugin<E : CommonSurfExtension>(
                     "dev.slne.surf.cloud:${cloudModule.module}:${Constants.SURF_API_VERSION}"
                 )
             }
+
+            val mainClass = extension.migrationMainClass.orNull
+            if (cloudModule == SurfCloudModules.SERVER && mainClass != null) {
+                generateExposedMigrationScript(
+                    mainClass = mainClass,
+                    cloudRuntimeDependency = "dev.slne.surf.cloud:${SurfCloudModules.STANDALONE.module}:${Constants.SURF_API_VERSION}"
+                )
+            }
         }
 
         afterEvaluated0(extension)

surf-api-gradle-plugin/src/main/kotlin/dev/slne/surf/surfapi/gradle/platform/core/CoreSurfExtension.kt

@@ -21,4 +21,9 @@ open class CoreSurfExtension @Inject constructor(objects: ObjectFactory) :
     fun withCloudServer() {
         cloudModule.set(SurfCloudModules.SERVER)
     }
+
+    fun migrationMainClass(value: String) {
+        migrationMainClass.set(value)
+        migrationMainClass.finalizeValue()
+    }
 }

surf-api-gradle-plugin/src/main/kotlin/dev/slne/surf/surfapi/gradle/platform/core/tasks/GenerateExposedMigrationScript.kt

@@ -0,0 +1,60 @@
+package dev.slne.surf.surfapi.gradle.platform.core.tasks
+
+import org.gradle.api.GradleException
+import org.gradle.api.NamedDomainObjectProvider
+import org.gradle.api.Project
+import org.gradle.api.tasks.JavaExec
+import org.gradle.api.tasks.SourceSet
+import org.gradle.api.tasks.SourceSetContainer
+import org.gradle.kotlin.dsl.named
+import org.gradle.kotlin.dsl.register
+import java.util.*
+
+
+val Project.sourceSets: SourceSetContainer get() = this.extensions.getByName("sourceSets") as SourceSetContainer
+val SourceSetContainer.main: NamedDomainObjectProvider<SourceSet> get() = named<SourceSet>("main")
+
+fun Project.generateExposedMigrationScript(cloudRuntimeDependency: String, mainClass: String) {
+    val additionalDependencies = configurations.detachedConfiguration(
+        dependencies.create(cloudRuntimeDependency)
+    )
+
+    tasks.register<JavaExec>("generateExposedMigrationScript") {
+        group = "migration"
+        description = "Generate Exposed migration script"
+        classpath = sourceSets.main.get().runtimeClasspath + additionalDependencies
+        this.mainClass.set(mainClass)
+
+        val properties = project.file("migration.properties")
+
+        doFirst {
+            if (!properties.exists()) {
+                properties.parentFile.mkdirs()
+                properties.writeText(
+                    """
+                    # Migration database config
+                    migration.dbUrl=jdbc:mysql://localhost:3306/database
+                    migration.dbUser=
+                    migration.dbPassword=
+                    """.trimIndent()
+                )
+                throw GradleException("Created 'migration.properties' file. Please enter your credentials and run the task again.")
+            }
+
+            val migrationProperties = Properties().apply {
+                load(properties.inputStream())
+            }
+
+            val requiredKeys = listOf("migration.dbUrl", "migration.dbUser", "migration.dbPassword")
+            val missing =
+                requiredKeys.filter { migrationProperties.getProperty(it).isNullOrBlank() }
+            if (missing.isNotEmpty()) {
+                throw GradleException("'migration.properties' is incomplete. Missing keys: ${missing.joinToString()}")
+            }
+
+            systemProperties(
+                requiredKeys.associateWith { migrationProperties.getProperty(it) }
+            )
+        }
+    }
+}