@momo-kits/native-kits 0.155.1-tracking.13 → 0.155.1-tracking.14-debug

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/tracking/ScreenTracker.kt

@@ -0,0 +1,218 @@
+package vn.momo.kits.navigation.tracking
+
+import vn.momo.kits.application.MiniAppContext
+import vn.momo.maxapi.IMaxApi
+import kotlin.time.Clock
+import kotlin.time.ExperimentalTime
+
+/**
+ * Screen tracking state holder
+ */
+class ScreenTrackingState {
+    @OptIn(ExperimentalTime::class)
+    var startTime: Long = Clock.System.now().toEpochMilliseconds()
+    var endTime: Long = startTime
+    var releaseNavigated: Boolean = false
+    var releaseLoad: Boolean = false
+    var releaseInteraction: Boolean = false
+    var previousScreenName: String? = null
+    var action: String = "push"
+}
+
+/**
+ * Screen tracker for auto tracking events
+ *
+ * Tracks 3 main events:
+ * - auto_screen_navigated: When screen is focused
+ * - auto_screen_displayed: When screen finished loading
+ * - auto_screen_interacted: When screen is ready for interaction
+ */
+object ScreenTracker {
+
+    private var lastScreenName: String? = null
+
+    /**
+     * Track screen navigation event
+     * Called when screen is focused
+     */
+    fun trackScreenNavigated(
+        maxApi: IMaxApi?,
+        context: MiniAppContext?,
+        screenName: String,
+        action: String,
+        state: ScreenTrackingState
+    ) {
+        if (state.releaseNavigated) return
+
+        val previousScreen = lastScreenName
+        lastScreenName = screenName
+
+        maxApi?.track(
+            eventName = "auto_screen_navigated",
+            params = buildBaseParams(context, screenName).apply {
+                put("pre_screen_name", previousScreen)
+                put("state", "navigated")
+                put("action", action)
+            }
+        )
+
+        state.releaseNavigated = true
+        state.previousScreenName = previousScreen
+    }
+
+    /**
+     * Track screen displayed event
+     * Called when screen finished loading all elements
+     */
+    fun trackScreenDisplayed(
+        maxApi: IMaxApi?,
+        context: MiniAppContext?,
+        screenName: String,
+        duration: Long,
+        state: ScreenTrackingState
+    ) {
+        if (state.releaseLoad) return
+
+        maxApi?.track(
+            eventName = "auto_screen_displayed",
+            params = buildBaseParams(context, screenName).apply {
+                put("state", "load")
+                put("duration", duration)
+            }
+        )
+
+        state.releaseLoad = true
+    }
+
+    /**
+     * Track screen interacted event
+     * Called when screen is ready for user interaction
+     */
+    fun trackScreenInteracted(
+        maxApi: IMaxApi?,
+        context: MiniAppContext?,
+        screenName: String,
+        duration: Long,
+        totalDuration: Long,
+        state: ScreenTrackingState
+    ) {
+        if (state.releaseInteraction) return
+
+        maxApi?.track(
+            eventName = "auto_screen_interacted",
+            params = buildBaseParams(context, screenName).apply {
+                put("state", "interaction")
+                put("duration", duration)
+                put("total_duration", totalDuration)
+            }
+        )
+
+        state.releaseInteraction = true
+    }
+
+    /**
+     * Build base tracking params from MiniAppContext
+     */
+    private fun buildBaseParams(
+        context: MiniAppContext?,
+        screenName: String,
+        componentName: String = "Screen"
+    ): MutableMap<String, Any?> {
+        return mutableMapOf(
+            "app_id" to context?.appId,
+            "feature_code" to context?.appCode,
+//            "miniapp_version" to context?.,
+            "screen_name" to screenName,
+            "component_name" to componentName,
+            "tracking_source" to 1
+        )
+    }
+
+    /**
+     * Track popup/modal displayed event
+     * Called when popup is opened or closed
+     *
+     * @param action "open" or "close"
+     * @param popupName name of the popup/modal
+     * @param parentScreenName the screen that shows the popup
+     * @param title popup title for tracking
+     * @param desc popup description for tracking
+     */
+    fun trackPopupDisplayed(
+        maxApi: IMaxApi?,
+        context: MiniAppContext?,
+        action: String,
+        popupName: String?,
+        parentScreenName: String?,
+        title: String? = null,
+        desc: String? = null
+    ) {
+        // When opening: screen_name = parent screen, component_name = popup name
+        // When closing: screen_name = popup name, component_name = parent screen
+        val screenName = if (action == "open") parentScreenName else popupName
+        val componentName = if (action == "open") popupName else parentScreenName
+
+        maxApi?.track(
+            eventName = "auto_popup_displayed",
+            params = mutableMapOf(
+                "app_id" to context?.appId,
+                "feature_code" to context?.appCode,
+                "screen_name" to screenName,
+                "component_name" to componentName,
+                "action" to action,
+                "title" to title,
+                "desc" to desc,
+                "tracking_source" to 1
+            )
+        )
+    }
+
+    /**
+     * Track bottom sheet displayed event
+     * Called when bottom sheet is opened or closed
+     *
+     * @param action "open" or "close"
+     * @param sheetName name of the bottom sheet
+     * @param parentScreenName the screen that shows the bottom sheet
+     * @param title sheet title for tracking
+     * @param desc sheet description for tracking
+     */
+    fun trackBottomSheetDisplayed(
+        maxApi: IMaxApi?,
+        context: MiniAppContext?,
+        action: String,
+        sheetName: String?,
+        parentScreenName: String?,
+        title: String? = null,
+        desc: String? = null
+    ) {
+        val screenName = if (action == "open") parentScreenName else sheetName
+        val componentName = if (action == "open") sheetName else parentScreenName
+
+        maxApi?.track(
+            eventName = "auto_bottomsheet_displayed",
+            params = mutableMapOf(
+                "app_id" to context?.appId,
+                "feature_code" to context?.appCode,
+                "screen_name" to screenName,
+                "component_name" to componentName,
+                "action" to action,
+                "title" to title,
+                "desc" to desc,
+                "tracking_source" to 1
+            )
+        )
+    }
+
+    /**
+     * Get previous screen name for back navigation detection
+     */
+    fun getLastScreenName(): String? = lastScreenName
+
+    /**
+     * Reset tracker (for testing or cleanup)
+     */
+    fun reset() {
+        lastScreenName = null
+    }
+}

package/compose/src/commonMain/kotlin/vn/momo/kits/platform/Platform.kt

@@ -0,0 +1,42 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.NativePaint
+import androidx.compose.ui.unit.Dp
+
+data class ScreenDimension(
+    val width: Int,
+    val height: Int,
+)
+
+expect fun getPlatformName(): String
+
+@Composable
+expect fun getScreenDimensions(): ScreenDimension
+
+expect fun NativePaint.setMaskFilter(blurRadius: Float)
+
+@Composable
+expect fun getStatusBarHeight(): Dp
+
+@Composable
+expect fun BackHandler(enabled: Boolean, onBack: () -> Unit)
+
+@Composable
+expect fun getScreenHeight(): Dp
+
+expect fun getAndroidBuildVersion(): Int
+
+@Composable
+expect fun LottieAnimation(
+    path: String,
+    tintColor: Color? = null,
+    bgColor: Color? = null,
+    modifier: Modifier = Modifier
+)
+
+expect fun NativePaint.setColor(
+    color: Color = Color.Black
+)