Merge pull request #27 from qburst/abhishek/common/KDoc_release

Abhishek/common/k doc release

Author: abdulbasithqb

composeApp/build.gradle.kts

@@ -1,3 +1,4 @@
+
 import org.jetbrains.compose.desktop.application.dsl.TargetFormat
 import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi
 import org.jetbrains.kotlin.gradle.dsl.JvmTarget
@@ -14,23 +15,23 @@ plugins {
 
 kotlin {
     @OptIn(ExperimentalWasmDsl::class)
-    wasmJs {
-        moduleName = "composeApp"
-        browser {
-            val projectDirPath = project.projectDir.path
-            commonWebpackConfig {
-                outputFileName = "composeApp.js"
-                devServer = (devServer ?: KotlinWebpackConfig.DevServer()).apply {
-                    static = (static ?: mutableListOf()).apply {
-                        // Serve sources to debug inside browser
-                        add(projectDirPath)
-                    }
-                }
-            }
-        }
-        binaries.executable()
-    }
-    
+   wasmJs {
+       moduleName = "composeApp"
+       browser {
+           val projectDirPath = project.projectDir.path
+           commonWebpackConfig {
+               outputFileName = "composeApp.js"
+               devServer = (devServer ?: KotlinWebpackConfig.DevServer()).apply {
+                   static = (static ?: mutableListOf()).apply {
+                       // Serve sources to debug inside browser
+                       add(projectDirPath)
+                   }
+               }
+           }
+       }
+       binaries.executable()
+   }
+
     androidTarget {
         @OptIn(ExperimentalKotlinGradlePluginApi::class)
         compilerOptions {

composeApp/src/commonMain/kotlin/Cart.kt

@@ -115,7 +115,7 @@ fun Cart(
                             var paymentIntentParams = SetupParams(
                                 merchantDisplayName = "Qburst",
                                 amount=amount,
-                                paymentIntentClientSecret = "pi_1QXLRzKJ38Q1wp9dF6c5MrT1_secret_9EDiqf0eNa3rfEyE1U2RDMcQj"
+                                paymentIntentClientSecret = "pi_1Qh7GBKJ38Q1wp9dzgi4FRes_secret_xVx43XhW0VG6qbKpVeH46gsfY"
                             )
                             CoroutineScope(Dispatchers.Default).launch {
                                 stripe.initPaymentSheet(

gradle/libs.versions.toml

@@ -22,7 +22,6 @@ stripeAndroid = "20.48.1"
 swiftklib = "0.6.3"
 cocoapods = "2.0.0"
 
-
 [libraries]
 gson = { module = "com.google.code.gson:gson", version.ref = "gson" }
 jetbrains-kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinxCoroutinesCoreVersion" }
@@ -61,4 +60,4 @@ kotlinJvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
 ktor = { id = "io.ktor.plugin", version.ref = "ktor" }
 kotlinMultiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
 swiftklib = { id = "io.github.ttypic.swiftklib", version.ref = "swiftklib" }
-kotlinCocoapods = { id = "org.jetbrains.kotlin.native.cocoapods", version.ref = "kotlin" }
+kotlinCocoapods = { id = "org.jetbrains.kotlin.native.cocoapods", version.ref = "kotlin" }

shared/build.gradle.kts

@@ -136,4 +136,4 @@ ksp {
     arg("io.mockative:mockative:opt-in:io.github.OptInType", "kotlinx.cinterop.ExperimentalForeignApi")
     arg("io.mockative:mockative:opt-in:io.github.*", "kotlin.ExperimentalStdlibApi")
     arg("io.mockative:mockative:opt-in", "kotlin.ExperimentalUnsignedTypes")
-}
+}

shared/src/androidMain/kotlin/InitializeStripe.kt

@@ -8,25 +8,55 @@ import com.stripe.android.paymentsheet.PaymentSheet
 import com.stripe.android.paymentsheet.PaymentSheetResult
 import model.InitialiseParams
 
+/**
+ * Class responsible for initializing Stripe SDK and handling payment-related operations.
+ */
 class InitializeStripe {
 
+    // Private variables for storing activity, context, and publishable key.
     private var _activity: ComponentActivity? = null
     private var _context: Context? = null
     private var _publishableKey: String? = null
+
+    /**
+     * Instance of [Stripe] used for interacting with Stripe SDK.
+     */
     lateinit var stripe: Stripe
+
+    /**
+     * Instance of [PaymentSheet] used for managing Stripe payment sheets.
+     */
     lateinit var paymentSheet: PaymentSheet
-    var clientSecret = ""
 
-    private var paymentResultCallback:PaymentResult ? =null
+    var clientSecret = ""
 
+    /**
+     * Callback interface for payment result handling.
+     */
+    private var paymentResultCallback: PaymentResult? = null
 
+    /**
+     * Interface definition for payment result callbacks.
+     */
     interface PaymentResult {
+        /**
+         * Called when payment succeeds.
+         * @param status A map containing payment status details.
+         */
         fun onSuccess(status: Map<String, Any?>)
+
+        /**
+         * Called when payment fails.
+         * @param throwable An exception containing the error details.
+         */
         fun onFailure(throwable: Throwable)
     }
 
-
-    // Initialize Stripe only once
+    /**
+     * Initializes the Stripe SDK with the provided parameters. Ensures initialization happens only once.
+     *
+     * @param initialObject An instance of [InitialiseParams] containing initialization details.
+     */
     fun initializeStripe(initialObject: InitialiseParams) {
         if (_activity == null && _context == null && _publishableKey == null) {
             _activity = initialObject.androidActivity as ComponentActivity
@@ -40,20 +70,30 @@ class InitializeStripe {
         }
     }
 
-
+    /**
+     * Initializes the Stripe Payment Sheet with the provided parameters.
+     *
+     * @param initialiseParams An instance of [InitialiseParams] containing initialization details.
+     */
     fun initialisePaymentSheet(initialiseParams: InitialiseParams) {
-        if((initialiseParams.androidContext != null ) && (initialiseParams.androidActivity != null)) {
+        if ((initialiseParams.androidContext != null) && (initialiseParams.androidActivity != null)) {
             PaymentConfiguration.init(
                 context = initialiseParams.androidContext as Context,
                 publishableKey = initialiseParams.publishableKey
             )
 
             paymentSheet =
                 PaymentSheet(initialiseParams.androidActivity as ComponentActivity) { paymentSheet ->
-                     onPaymentSheetResult(paymentSheet)
+                    onPaymentSheetResult(paymentSheet)
                 }
         }
     }
+
+    /**
+     * Handles the result of a payment sheet operation.
+     *
+     * @param paymentSheetResult The result of the payment sheet operation.
+     */
     private fun onPaymentSheetResult(paymentSheetResult: PaymentSheetResult) {
         when (paymentSheetResult) {
             is PaymentSheetResult.Canceled -> {
@@ -67,19 +107,29 @@ class InitializeStripe {
             }
 
             is PaymentSheetResult.Completed -> {
-                //TODO: Handle paymentSheetResult
+                // TODO: Handle paymentSheetResult
                 paymentResultCallback?.onSuccess(emptyMap())
                 paymentResultCallback = null
             }
         }
     }
 
+    /**
+     * Sets the callback for handling payment results.
+     *
+     * @param callback An implementation of [PaymentResult] interface.
+     */
     fun setPaymentResultCallback(callback: InitializeStripe.PaymentResult) {
         paymentResultCallback = callback
     }
-
 }
 
+/**
+ * Singleton object for managing a single instance of [InitializeStripe].
+ */
 object SingletonStripeInitialization {
+    /**
+     * Single instance of [InitializeStripe].
+     */
     val StripeInstanse = InitializeStripe()
-}
+}