@momo-kits/native-kits 0.156.1-test.9-debug → 0.156.1-tracking.2-debug

package/compose/build.gradle.kts

@@ -40,7 +40,7 @@ kotlin {
     }
 
     cocoapods {
-        version = "0.156.1-test.9-debug"
+        version = "0.156.1-tracking.2-debug"
         summary = "IOS Shared module"
         homepage = "https://momo.vn"
         ios.deploymentTarget = "15.0"

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

@@ -72,6 +72,7 @@ val LocalNavigation = staticCompositionLocalOf<Navigation> {
 
 @Stable
 data class NavigationOptions(
+    val screenName: String? = null,
     val onBackHandler: (() -> Unit)? = null,
     val hiddenBack: Boolean = false,
     val headerBackProps: HeaderBackProps = HeaderBackProps(),

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

@@ -87,6 +87,7 @@ fun NavigationContainer(
         AppConfig provides config,
         AppLanguage provides language,
     ) {
+        println(mergedContext)
         LaunchedEffect(Unit) {
             setNavigator?.invoke(navigator)
         }
@@ -157,7 +158,5 @@ fun NavigationContainer(
     }
 }
 
-val LocalMaxApi = staticCompositionLocalOf<IMaxApi?> {
-    error("No MaxApi provided")
-}
+val LocalMaxApi = staticCompositionLocalOf<IMaxApi?> { null }
 

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

@@ -120,10 +120,23 @@ class Navigator(
     fun showModal(
         content: @Composable () -> Unit,
         barrierDismissible: Boolean = true,
-        onDismiss: (() -> Unit)? = null
+        onDismiss: (() -> Unit)? = null,
+        popupName: String? = null,
+        title: String? = null,
+        desc: String? = null
     ){
         val id = DynamicScreenRegistry.getLatestScreen()?.id ?: -1
-        OverplayComponentRegistry.registerOverplay(id, content, OverplayComponentType.MODAL, false, barrierDismissible, onDismiss)
+        OverplayComponentRegistry.registerOverplay(
+            id = id,
+            content = content,
+            type = OverplayComponentType.MODAL,
+            isSurface = false,
+            barrierDismissible = barrierDismissible,
+            onDismiss = onDismiss,
+            popupName = popupName,
+            popupTitle = title,
+            popupDesc = desc
+        )
     }
 
     fun showBottomSheet(
@@ -131,10 +144,24 @@ class Navigator(
         isSurface: Boolean = false,
         barrierDismissible: Boolean = true,
         onDismiss: (() -> Unit)? = null,
-        bottomSheetHeader: BottomHeader? = null
+        bottomSheetHeader: BottomHeader? = null,
+        sheetName: String? = null,
+        title: String? = null,
+        desc: String? = null
     ){
         val id = DynamicScreenRegistry.getLatestScreen()?.id ?: -1
-        OverplayComponentRegistry.registerOverplay(id, content, OverplayComponentType.BOTTOM_SHEET, isSurface, barrierDismissible, onDismiss, bottomSheetHeader)
+        OverplayComponentRegistry.registerOverplay(
+            id = id,
+            content = content,
+            type = OverplayComponentType.BOTTOM_SHEET,
+            isSurface = isSurface,
+            barrierDismissible = barrierDismissible,
+            onDismiss = onDismiss,
+            bottomSheetHeader = bottomSheetHeader,
+            sheetName = sheetName,
+            sheetTitle = title,
+            sheetDesc = desc
+        )
     }
 
     fun showSnackBar(snackBar: SnackBar, onDismiss: (() -> Unit)? = null) {
@@ -220,7 +247,10 @@ object DynamicScreenRegistry {
 sealed class OverplayComponentParams {
     class Modal(
         val onDismiss: (() -> Unit)? = null,
-        val barrierDismissible: Boolean = true
+        val barrierDismissible: Boolean = true,
+        val popupName: String? = null,
+        val title: String? = null,
+        val desc: String? = null
     ) : OverplayComponentParams()
 
     class BottomSheet(
@@ -228,6 +258,9 @@ sealed class OverplayComponentParams {
         val onDismiss: (() -> Unit)? = null,
         val barrierDismissible: Boolean = true,
         val bottomSheetHeader: BottomHeader? = null,
+        val sheetName: String? = null,
+        val title: String? = null,
+        val desc: String? = null
     ) : OverplayComponentParams()
 
     class SnackBar() : OverplayComponentParams()
@@ -259,10 +292,16 @@ object OverplayComponentRegistry {
         barrierDismissible: Boolean = true,
         onDismiss: (() -> Unit)?,
         bottomSheetHeader: BottomHeader? = null,
+        popupName: String? = null,
+        sheetName: String? = null,
+        popupTitle: String? = null,
+        popupDesc: String? = null,
+        sheetTitle: String? = null,
+        sheetDesc: String? = null
     ){
         val params = when(type){
-            OverplayComponentType.MODAL -> OverplayComponentParams.Modal(onDismiss, barrierDismissible)
-            OverplayComponentType.BOTTOM_SHEET -> OverplayComponentParams.BottomSheet(isSurface, onDismiss, barrierDismissible, bottomSheetHeader)
+            OverplayComponentType.MODAL -> OverplayComponentParams.Modal(onDismiss, barrierDismissible, popupName, popupTitle, popupDesc)
+            OverplayComponentType.BOTTOM_SHEET -> OverplayComponentParams.BottomSheet(isSurface, onDismiss, barrierDismissible, bottomSheetHeader, sheetName, sheetTitle, sheetDesc)
             OverplayComponentType.SNACK_BAR -> OverplayComponentParams.SnackBar()
         }
 

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

@@ -63,11 +63,16 @@ import vn.momo.kits.navigation.component.HeaderType
 import vn.momo.kits.navigation.component.InputSearchType
 import vn.momo.kits.platform.BackHandler
 import vn.momo.kits.platform.getAndroidBuildVersion
+import vn.momo.kits.navigation.tracking.ScreenTracker
+import vn.momo.kits.navigation.tracking.ScreenTrackingState
+import kotlinx.coroutines.delay
+import kotlin.time.Clock
+import kotlin.time.ExperimentalTime
 
 internal val LocalFooterHeightPx = staticCompositionLocalOf { mutableIntStateOf(0) }
 internal val LocalHeaderRightWidthPx = staticCompositionLocalOf { mutableIntStateOf(0) }
 
-@OptIn(ExperimentalMaterialApi::class)
+@OptIn(ExperimentalMaterialApi::class, ExperimentalTime::class)
 @Composable
 internal fun StackScreen(
     content: @Composable () -> Unit,
@@ -77,12 +82,63 @@ internal fun StackScreen(
     onBackHandler: (() -> Unit)? = null,
 ) {
     val navigator = LocalNavigator.current
+    val maxApi = LocalMaxApi.current
+    val context = ApplicationContext.current
     val statusBar = AppStatusBar.current
     val density = LocalDensity.current
     val navigation = remember { Navigation(id = id, bottomTabIndex = bottomTabIndex, initOptions = navigationOptions) }
 
     val options by navigation.currentOptions
 
+    // Auto tracking state
+    val trackingState = remember {
+        ScreenTrackingState().apply {
+            startTime = Clock.System.now().toEpochMilliseconds()
+        }
+    }
+    val screenName = remember(options.screenName) {
+        options.screenName ?: "Screen_$id"
+    }
+
+    // Determine action: push or back
+    val action = remember {
+        if (ScreenTracker.getLastScreenName() != null) "push" else "push"
+    }
+
+    // Auto tracking effects
+    LaunchedEffect(screenName) {
+        // Track screen navigated immediately
+        ScreenTracker.trackScreenNavigated(
+            maxApi = maxApi,
+            context = context,
+            screenName = screenName,
+            action = action,
+            state = trackingState
+        )
+
+        // Track screen displayed after 2 seconds (debounce)
+        delay(2000)
+        val loadTime = Clock.System.now().toEpochMilliseconds() - trackingState.startTime
+        ScreenTracker.trackScreenDisplayed(
+            maxApi = maxApi,
+            context = context,
+            screenName = screenName,
+            duration = loadTime,
+            state = trackingState
+        )
+
+        // Track screen interacted after displayed
+        val interactionTime = Clock.System.now().toEpochMilliseconds() - trackingState.startTime
+        ScreenTracker.trackScreenInteracted(
+            maxApi = maxApi,
+            context = context,
+            screenName = screenName,
+            duration = interactionTime - loadTime,
+            totalDuration = interactionTime,
+            state = trackingState
+        )
+    }
+
     val limit = with(density) {
         (statusBar).toPx() + HEADER_HEIGHT
     }.toInt()

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/example/ios/Example.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/Example.xcscheme

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   version = "1.3">
+   <BuildAction>
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForRunning = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "A6A920D22B2ADD1E00C1A11F"
+               BuildableName = "Example"
+               BlueprintName = "Example"
+               ReferencedContainer = "container:Example.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <LaunchAction
+      useCustomWorkingDirectory = "NO"
+      buildConfiguration = "Debug"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "A6A920D22B2ADD1E00C1A11F"
+            BuildableName = "Example"
+            BlueprintName = "Example"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+</Scheme>

package/example/ios/Example.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>Example.xcscheme</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>7</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/example/ios/Example.xcworkspace/xcuserdata/sonnguyen.xcuserdatad/WorkspaceSettings.xcsettings

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>BuildLocationStyle</key>
+	<string>UseAppPreferences</string>
+	<key>CustomBuildLocationType</key>
+	<string>RelativeToDerivedData</string>
+	<key>DerivedDataCustomLocation</key>
+	<string>DerivedData</string>
+	<key>DerivedDataLocationStyle</key>
+	<string>WorkspaceRelativePath</string>
+	<key>ShowSharedSchemesAutomaticallyEnabled</key>
+	<true/>
+</dict>
+</plist>

package/example/ios/Example.xcworkspace/xcuserdata/sonnguyen.xcuserdatad/xcdebugger/Breakpoints_v2.xcbkptlist

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Bucket
+   uuid = "6B3C387A-E951-41D1-A42C-FB6E447A46BA"
+   type = "0"
+   version = "2.0">
+</Bucket>

package/example/ios/Example.xcworkspace/xcuserdata/sonnguyen.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict />
+</plist>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/MoMoUIKits.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "3B6FB503A75BF5BC1FA6F30BC06B9D28"
+               BuildableName = "MoMoUIKits.framework"
+               BlueprintName = "MoMoUIKits"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/Pods-Example.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "0AEE99A309977BD12A049FF48AF9BA4B"
+               BuildableName = "Pods_Example.framework"
+               BlueprintName = "Pods-Example"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>