refactor: tighten Rokt accessor API and restore legacy docs

Keep only the no-arg public Rokt accessor with explicit start precondition, restore original public method documentation text, and make prepareAttributesAsync internal per review feedback.

Author: denischilik

…particle/kits/MParticleRoktExtensions.kt …tlin/com/mparticle/kits/MParticleRokt.ktkits/rokt/rokt/src/main/kotlin/com/mparticle/kits/MParticleRoktExtensions.kt renamed to kits/rokt/rokt/src/main/kotlin/com/mparticle/kits/MParticleRokt.kt kits/rokt/rokt/src/main/kotlin/com/mparticle/kits/MParticleRoktExtensions.kt renamed to kits/rokt/rokt/src/main/kotlin/com/mparticle/kits/MParticleRokt.kt

@@ -3,22 +3,18 @@ package com.mparticle.rokt
 import com.mparticle.MParticle
 import com.mparticle.kits.Rokt
 
-/**
- * Kotlin-friendly accessor for the legacy Rokt API object.
- */
-fun MParticle.Rokt(): Rokt = createRokt(this)
-
 /**
  * Java-friendly accessors for the legacy Rokt API object.
  */
 object MParticleRokt {
     @Suppress("FunctionName")
     @JvmStatic
-    fun Rokt(mParticle: MParticle?): Rokt? = mParticle?.let { createRokt(it) }
-
-    @Suppress("FunctionName")
-    @JvmStatic
-    fun Rokt(): Rokt? = MParticle.getInstance()?.let { createRokt(it) }
+    fun Rokt(): Rokt {
+        val mParticle = requireNotNull(MParticle.getInstance()) {
+            "MParticle must be started before calling MParticleRokt.Rokt()"
+        }
+        return createRokt(mParticle)
+    }
 }
 
 private fun createRokt(mParticle: MParticle): Rokt {

kits/rokt/rokt/src/main/kotlin/com/mparticle/kits/Rokt.kt

@@ -12,7 +12,20 @@ import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.flowOf
 import java.lang.ref.WeakReference
 
+/**
+ * Public facade for interacting with the Rokt Kit through mParticle.
+ */
 class Rokt internal constructor(private val mKitManager: KitManager) {
+    /**
+     * Display a Rokt placement with the specified parameters.
+     *
+     * @param identifier The placement identifier
+     * @param attributes User attributes to pass to Rokt
+     * @param callbacks Optional callback for Rokt events
+     * @param embeddedViews Optional map of embedded view placeholders
+     * @param fontTypefaces Optional map of font typefaces
+     * @param config Optional Rokt configuration
+     */
     @JvmOverloads
     fun selectPlacements(
         identifier: String,
@@ -43,37 +56,73 @@ class Rokt internal constructor(private val mKitManager: KitManager) {
         }
     }
 
+    /**
+     * Get a Flow of Rokt events for the specified identifier.
+     *
+     * @param identifier The placement identifier to listen for events
+     * @return A Flow emitting RoktEvent objects
+     */
     fun events(identifier: String): Flow<RoktEvent> = if (isEnabled()) {
         resolveRoktKit()?.second?.events(identifier) ?: flowOf()
     } else {
         flowOf()
     }
 
+    /**
+     * Notify Rokt that a purchase has been finalized.
+     *
+     * @param placementId The placement identifier
+     * @param catalogItemId The catalog item identifier
+     * @param status Whether the purchase was successful
+     */
     fun purchaseFinalized(placementId: String, catalogItemId: String, status: Boolean) {
         if (isEnabled()) {
             resolveRoktKit()?.second?.purchaseFinalized(placementId, catalogItemId, status)
         }
     }
 
+    /**
+     * Close any active Rokt placements.
+     */
     fun close() {
         if (isEnabled()) {
             resolveRoktKit()?.second?.close()
         }
     }
 
+    /**
+     * Set the session id to use for the next execute call.
+     *
+     * This is useful for cases where you have a session id from a non-native integration,
+     * e.g. WebView, and you want the session to be consistent across integrations.
+     *
+     * **Note:** Empty strings are ignored and will not update the session.
+     *
+     * @param sessionId The session id to be set. Must be a non-empty string.
+     */
     fun setSessionId(sessionId: String) {
         if (isEnabled()) {
             resolveRoktKit()?.second?.setSessionId(sessionId)
         }
     }
 
+    /**
+     * Get the session id to use within a non-native integration e.g. WebView.
+     *
+     * @return The session id or null if no session is present or SDK is not initialized.
+     */
     fun getSessionId(): String? = if (isEnabled()) {
         resolveRoktKit()?.second?.getSessionId()
     } else {
         null
     }
 
-    fun prepareAttributesAsync(attributes: Map<String, String>) {
+    /**
+     * Prepare attributes asynchronously before executing a placement.
+     *
+     * @param attributes The attributes to prepare
+     */
+    internal fun prepareAttributesAsync(attributes: Map<String, String>) {
         if (isEnabled()) {
             val resolved = resolveRoktKit()
             if (resolved != null) {