feat: add helper utilities and lib module with tests

Author: manu4543

.gitignore

@@ -6,3 +6,8 @@
 build/
 codegen.log
 kls_database.db
+
+
+image-kit-java-example/resources
+image-kit-java-example/src/main/resources/
+temp

README.md

@@ -10,7 +10,7 @@ repositories {
 
 java {
     toolchain {
-        languageVersion.set(JavaLanguageVersion.of(21))
+        languageVersion.set(JavaLanguageVersion.of(17))
     }
 
     sourceCompatibility = JavaVersion.VERSION_1_8

buildSrc/src/main/kotlin/image-kit.java.gradle.kts

@@ -12,7 +12,7 @@ repositories {
 
 kotlin {
     jvmToolchain {
-        languageVersion.set(JavaLanguageVersion.of(21))
+        languageVersion.set(JavaLanguageVersion.of(17))
     }
 
     compilerOptions {

buildSrc/src/main/kotlin/image-kit.kotlin.gradle.kts

@@ -3,6 +3,7 @@
 package io.imagekit.client
 
 import io.imagekit.core.ClientOptions
+import io.imagekit.lib.HelperService
 import io.imagekit.services.blocking.AccountService
 import io.imagekit.services.blocking.AssetService
 import io.imagekit.services.blocking.BetaService
@@ -68,6 +69,8 @@ interface ImageKitClient {
 
     fun webhooks(): WebhookService
 
+    fun helper(): HelperService
+
     /**
      * Closes this client, relinquishing any underlying resources.
      *

image-kit-java-core/src/main/kotlin/io/imagekit/client/ImageKitClient.kt

@@ -3,6 +3,7 @@
 package io.imagekit.client
 
 import io.imagekit.core.ClientOptions
+import io.imagekit.lib.HelperService
 import io.imagekit.services.async.AccountServiceAsync
 import io.imagekit.services.async.AssetServiceAsync
 import io.imagekit.services.async.BetaServiceAsync
@@ -68,6 +69,8 @@ interface ImageKitClientAsync {
 
     fun webhooks(): WebhookServiceAsync
 
+    fun helper(): HelperService
+
     /**
      * Closes this client, relinquishing any underlying resources.
      *

image-kit-java-core/src/main/kotlin/io/imagekit/client/ImageKitClientAsync.kt

@@ -4,6 +4,8 @@ package io.imagekit.client
 
 import io.imagekit.core.ClientOptions
 import io.imagekit.core.getPackageVersion
+import io.imagekit.lib.Helper
+import io.imagekit.lib.HelperService
 import io.imagekit.services.async.AccountServiceAsync
 import io.imagekit.services.async.AccountServiceAsyncImpl
 import io.imagekit.services.async.AssetServiceAsync
@@ -73,6 +75,8 @@ class ImageKitClientAsyncImpl(private val clientOptions: ClientOptions) : ImageK
         WebhookServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
+    private val helper: Helper by lazy { Helper.create(clientOptions) }
+
     override fun sync(): ImageKitClient = sync
 
     override fun withRawResponse(): ImageKitClientAsync.WithRawResponse = withRawResponse
@@ -98,6 +102,8 @@ class ImageKitClientAsyncImpl(private val clientOptions: ClientOptions) : ImageK
 
     override fun webhooks(): WebhookServiceAsync = webhooks
 
+    override fun helper(): HelperService = helper
+
     override fun close() = clientOptions.close()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :

image-kit-java-core/src/main/kotlin/io/imagekit/client/ImageKitClientAsyncImpl.kt

@@ -4,6 +4,8 @@ package io.imagekit.client
 
 import io.imagekit.core.ClientOptions
 import io.imagekit.core.getPackageVersion
+import io.imagekit.lib.Helper
+import io.imagekit.lib.HelperService
 import io.imagekit.services.blocking.AccountService
 import io.imagekit.services.blocking.AccountServiceImpl
 import io.imagekit.services.blocking.AssetService
@@ -63,6 +65,8 @@ class ImageKitClientImpl(private val clientOptions: ClientOptions) : ImageKitCli
 
     private val webhooks: WebhookService by lazy { WebhookServiceImpl(clientOptionsWithUserAgent) }
 
+    private val helper: Helper by lazy { Helper.create(clientOptions) }
+
     override fun async(): ImageKitClientAsync = async
 
     override fun withRawResponse(): ImageKitClient.WithRawResponse = withRawResponse
@@ -88,6 +92,8 @@ class ImageKitClientImpl(private val clientOptions: ClientOptions) : ImageKitCli
 
     override fun webhooks(): WebhookService = webhooks
 
+    override fun helper(): HelperService = helper
+
     override fun close() = clientOptions.close()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :