sparkling-navigation 2.1.0-rc.24 → 2.1.0-rc.26

package/android/build.gradle.kts

@@ -32,6 +32,15 @@ android {
     kotlinOptions {
         jvmTarget = "11"
     }
+
+    testOptions {
+        unitTests.all {
+            it.extensions.configure(org.gradle.testing.jacoco.plugins.JacocoTaskExtension::class.java) {
+                isIncludeNoLocationClasses = true
+                excludes = listOf("jdk.internal.*")
+            }
+        }
+    }
 }
 
 dependencies {
@@ -39,13 +48,20 @@ dependencies {
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.appcompat)
     testImplementation(libs.junit)
+    testImplementation("io.mockk:mockk:1.13.8")
+    testImplementation("org.robolectric:robolectric:4.11.1")
+    testImplementation("androidx.test:core:1.5.0")
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.espresso.core)
     val sparklingVersion =
         (findProperty("SPARKLING_ANDROID_SDK_VERSION") as? String)
             ?: System.getenv("SPARKLING_ANDROID_SDK_VERSION")
-            ?: "2.1.0-rc.12"
-    api("com.tiktok.sparkling:sparkling-method:$sparklingVersion")
+            ?: "2.1.0-rc.26"
+    if (rootProject.findProject(":sparkling-method") != null) {
+        api(project(":sparkling-method"))
+    } else {
+        api("com.tiktok.sparkling:sparkling-method:$sparklingVersion")
+    }
 }
 
 tasks.register<JacocoReport>("jacocoTestReport") {

package/android/src/main/java/com/tiktok/sparkling/method/router/open/AbsRouterOpenMethodIDL.kt

@@ -2,7 +2,7 @@
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
 
-/** anycode-lint-ignore */
+// anycode-lint-ignore
 package com.tiktok.sparkling.method.router.open
 
 import com.tiktok.sparkling.method.registry.core.annotation.IDLMethodName
@@ -14,8 +14,6 @@ import com.tiktok.sparkling.method.registry.core.model.idl.IDLMethodBaseModel
 import com.tiktok.sparkling.method.registry.core.model.idl.IDLMethodBaseParamModel
 import com.tiktok.sparkling.method.registry.core.model.idl.IDLMethodBaseResultModel
 
-/** anycode-lint-ignore */
-
 /**
  * GENERATED BY ANYCODE.
  * DO NOT MODIFY!!!

package/android/src/main/java/com/tiktok/sparkling/method/router/open/RouterOpenMethod.kt

@@ -138,6 +138,7 @@ class RouterOpenMethod : AbsRouterOpenMethodIDL() {
     }
 }
 
+@Suppress("ktlint:standard:enum-entry-name-case")
 enum class ReplaceType {
     alwaysCloseAfterOpen,
     alwaysCloseBeforeOpen,

package/android/src/test/java/com/tiktok/sparkling/method/router/RouterCoverageTest.kt

@@ -0,0 +1,593 @@
+package com.tiktok.sparkling.method.router
+
+import android.content.Context
+import com.tiktok.sparkling.method.registry.core.BridgePlatformType
+import com.tiktok.sparkling.method.registry.core.IBridgeContext
+import com.tiktok.sparkling.method.registry.core.IDLBridgeMethod
+import com.tiktok.sparkling.method.registry.core.model.context.ContextProviderFactory
+import com.tiktok.sparkling.method.registry.core.model.idl.CompletionBlock
+import com.tiktok.sparkling.method.router.close.AbsRouterCloseMethodIDL
+import com.tiktok.sparkling.method.router.close.RouterCloseMethod
+import com.tiktok.sparkling.method.router.open.AbsRouterOpenMethodIDL
+import com.tiktok.sparkling.method.router.open.ReplaceType
+import com.tiktok.sparkling.method.router.open.RouterOpenMethod
+import com.tiktok.sparkling.method.router.utils.AbsRouteOpenHandler
+import com.tiktok.sparkling.method.router.utils.IHostRouterDepend
+import com.tiktok.sparkling.method.router.utils.RouterProvider
+import io.mockk.every
+import io.mockk.mockk
+import io.mockk.verify
+import io.mockk.verifyOrder
+import org.junit.After
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertSame
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+/**
+ * Extra unit tests for the sparkling-navigation module to cover edge cases not exercised
+ * by [RouterMethodUnitTest], including replace-type branches, exception handling,
+ * the default [IHostRouterDepend.openScheme] handler chain, and [AbsRouteOpenHandler] wiring.
+ */
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE, sdk = [33])
+class RouterCoverageTest {
+    private lateinit var bridgeContext: IBridgeContext
+    private lateinit var context: Context
+
+    @Before
+    fun setUp() {
+        context = mockk(relaxed = true)
+        bridgeContext = mockk(relaxed = true)
+        every { bridgeContext.context } returns context
+        RouterProvider.hostRouterDepend = null
+    }
+
+    @After
+    fun tearDown() {
+        RouterProvider.hostRouterDepend = null
+    }
+
+    // region RouterOpenMethod ------------------------------------------------------------------
+
+    @Test
+    fun openMethodFailsWhenSDKContextNull() {
+        val method = RouterOpenMethod()
+        val params = openParams(scheme = "hybrid://lynx?bundle=a")
+        val callback = OpenCallbackRecorder()
+
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Context not provided") == true)
+    }
+
+    @Test
+    fun openMethodFailsWhenInnerContextNull() {
+        val ctxLessBridge = mockk<IBridgeContext>(relaxed = true)
+        every { ctxLessBridge.context } returns null
+
+        val method = RouterOpenMethod().apply { setBridgeContext(ctxLessBridge) }
+        val params = openParams(scheme = "hybrid://lynx?bundle=a")
+        val callback = OpenCallbackRecorder()
+
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Context not provided") == true)
+    }
+
+    @Test
+    fun openMethodFailsWhenRouterDependNotRegistered() {
+        // RouterProvider.hostRouterDepend stays null
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val params = openParams(scheme = "hybrid://lynx?bundle=a")
+        val callback = OpenCallbackRecorder()
+
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Router service not available") == true)
+    }
+
+    @Test
+    fun openMethodFailsWhenOpenSchemeReturnsFalse() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.openScheme(any(), any(), any(), any(), any()) } returns false
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(openParams(scheme = "hybrid://lynx?bundle=a"), callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Failed to open scheme") == true)
+    }
+
+    @Test
+    fun openMethodSwallowsExceptionAndReportsFailure() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every {
+            hostRouter.openScheme(any(), any(), any(), any(), any())
+        } throws RuntimeException("boom")
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(openParams(scheme = "hybrid://lynx?bundle=a"), callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+    }
+
+    @Test
+    fun openMethodReplaceAlwaysCloseBeforeOpenInvokesCloseFirst() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.closeView(any(), any(), any(), any()) } returns true
+        every { hostRouter.openScheme(any(), any(), any(), any(), any()) } returns true
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(
+            openParams(
+                scheme = "hybrid://lynx?bundle=a",
+                replace = true,
+                replaceType = ReplaceType.alwaysCloseBeforeOpen.name,
+            ),
+            callback,
+            BridgePlatformType.LYNX,
+        )
+
+        assertNotNull(callback.successResult)
+        verifyOrder {
+            hostRouter.closeView(bridgeContext, BridgePlatformType.LYNX, null, false)
+            hostRouter.openScheme(any(), any(), any(), BridgePlatformType.LYNX, any())
+        }
+    }
+
+    @Test
+    fun openMethodReplaceAlwaysCloseAfterOpenAlwaysClosesEvenWhenOpenFails() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.openScheme(any(), any(), any(), any(), any()) } returns false
+        every { hostRouter.closeView(any(), any(), any(), any()) } returns true
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(
+            openParams(
+                scheme = "hybrid://lynx?bundle=a",
+                replace = true,
+                replaceType = ReplaceType.alwaysCloseAfterOpen.name,
+            ),
+            callback,
+            BridgePlatformType.LYNX,
+        )
+
+        // open returned false so overall is failure, but close must still have been invoked
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        verify(exactly = 1) {
+            hostRouter.closeView(bridgeContext, BridgePlatformType.LYNX, null, false)
+        }
+    }
+
+    @Test
+    fun openMethodReplaceOnlyCloseAfterOpenSucceedSkipsCloseOnFailure() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.openScheme(any(), any(), any(), any(), any()) } returns false
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(
+            openParams(
+                scheme = "hybrid://lynx?bundle=a",
+                replace = true,
+                // default ReplaceType.onlyCloseAfterOpenSucceed when replaceType is null
+                replaceType = null,
+            ),
+            callback,
+            BridgePlatformType.LYNX,
+        )
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        verify(exactly = 0) { hostRouter.closeView(any(), any(), any(), any()) }
+    }
+
+    @Test
+    fun openMethodReplaceOnlyCloseAfterOpenSucceedClosesOnSuccess() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.openScheme(any(), any(), any(), any(), any()) } returns true
+        every { hostRouter.closeView(any(), any(), any(), any()) } returns true
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(
+            openParams(
+                scheme = "hybrid://lynx?bundle=a",
+                replace = true,
+                replaceType = ReplaceType.onlyCloseAfterOpenSucceed.name,
+            ),
+            callback,
+            BridgePlatformType.LYNX,
+        )
+
+        assertNotNull(callback.successResult)
+        verify(exactly = 1) {
+            hostRouter.closeView(bridgeContext, BridgePlatformType.LYNX, null, false)
+        }
+    }
+
+    @Test
+    fun openMethodReplaceSwallowsExceptionAndReportsFailure() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every {
+            hostRouter.openScheme(any(), any(), any(), any(), any())
+        } throws IllegalStateException("kaboom")
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val callback = OpenCallbackRecorder()
+
+        method.handle(
+            openParams(
+                scheme = "hybrid://lynx?bundle=a",
+                replace = true,
+                replaceType = ReplaceType.alwaysCloseBeforeOpen.name,
+            ),
+            callback,
+            BridgePlatformType.LYNX,
+        )
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+    }
+
+    // endregion
+
+    // region RouterCloseMethod -----------------------------------------------------------------
+
+    @Test
+    fun closeMethodReportsCurrentContainerErrorWhenIdBlank() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.closeView(any(), any(), any(), any()) } returns false
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterCloseMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterCloseMethodIDL.IDLMethodCloseParamModel>(relaxed = true)
+        every { params.containerID } returns "  "
+        every { params.animated } returns null
+
+        val callback = CloseCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertEquals("Failed to close current container", callback.failureMsg)
+        // animated default is true when null
+        verify(exactly = 1) {
+            hostRouter.closeView(bridgeContext, BridgePlatformType.LYNX, "  ", true)
+        }
+    }
+
+    @Test
+    fun closeMethodReportsContainerSpecificErrorWhenIdProvided() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every { hostRouter.closeView(any(), any(), any(), any()) } returns false
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterCloseMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterCloseMethodIDL.IDLMethodCloseParamModel>(relaxed = true)
+        every { params.containerID } returns "container-x"
+        every { params.animated } returns true
+
+        val callback = CloseCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertEquals("Failed to close container: container-x", callback.failureMsg)
+    }
+
+    @Test
+    fun closeMethodSwallowsExceptionAndReportsFailure() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every {
+            hostRouter.closeView(any(), any(), any(), any())
+        } throws RuntimeException("close-boom")
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterCloseMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterCloseMethodIDL.IDLMethodCloseParamModel>(relaxed = true)
+        every { params.containerID } returns "container-y"
+        every { params.animated } returns true
+
+        val callback = CloseCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+    }
+
+    // endregion
+
+    // region AbsRouteOpenHandler ---------------------------------------------------------------
+
+    @Test
+    fun absRouteOpenHandlerStoresNextAndExceptionHandlers() {
+        val handler = StubRouteOpenHandler()
+        val next = StubRouteOpenHandler()
+        val errorHandler = StubRouteOpenHandler()
+
+        assertNull(handler.nextHandler)
+        assertNull(handler.exceptionHandler)
+
+        handler.setNextHandler(next)
+        handler.setExceptionHandler(errorHandler)
+
+        assertSame(next, handler.nextHandler)
+        assertSame(errorHandler, handler.exceptionHandler)
+    }
+
+    // endregion
+
+    // region IHostRouterDepend default openScheme ----------------------------------------------
+
+    @Test
+    fun defaultOpenSchemeReturnsFalseWhenHandlerListEmpty() {
+        val depend =
+            object : IHostRouterDepend {
+                override fun closeView(
+                    bridgeContext: IBridgeContext?,
+                    type: BridgePlatformType,
+                    containerID: String?,
+                    animated: Boolean?,
+                ) = true
+                // empty handler list (default impl)
+            }
+
+        val result =
+            depend.openScheme(
+                bridgeContext,
+                "hybrid://lynx?bundle=a",
+                emptyMap(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+        assertFalse(result)
+    }
+
+    @Test
+    fun defaultOpenSchemeReturnsTrueWhenFirstHandlerHandles() {
+        val handler =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.LYNX),
+                opener = { _, _, _ -> true },
+            )
+        val depend = makeDependWithHandlers(listOf(handler))
+
+        val result =
+            depend.openScheme(
+                bridgeContext,
+                "hybrid://lynx?bundle=a",
+                emptyMap(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+
+        assertTrue(result)
+        assertEquals(1, handler.callCount)
+    }
+
+    @Test
+    fun defaultOpenSchemeFallsThroughWhenHandlerReturnsFalse() {
+        val first =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.LYNX),
+                opener = { _, _, _ -> false },
+            )
+        val second =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.LYNX),
+                opener = { _, _, _ -> true },
+            )
+        val depend = makeDependWithHandlers(listOf(first, second))
+
+        val result =
+            depend.openScheme(
+                bridgeContext,
+                "hybrid://lynx?bundle=a",
+                emptyMap(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+
+        assertTrue(result)
+        assertEquals(1, first.callCount)
+        assertEquals(1, second.callCount)
+    }
+
+    @Test
+    fun defaultOpenSchemeSkipsHandlerWithUnsupportedPlatform() {
+        val webOnly =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.WEB),
+                opener = { _, _, _ -> true },
+            )
+        val lynxAll =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.ALL),
+                opener = { _, _, _ -> true },
+            )
+        val depend = makeDependWithHandlers(listOf(webOnly, lynxAll))
+
+        val result =
+            depend.openScheme(
+                bridgeContext,
+                "hybrid://lynx?bundle=a",
+                emptyMap(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+
+        assertTrue(result)
+        assertEquals(0, webOnly.callCount)
+        assertEquals(1, lynxAll.callCount)
+    }
+
+    @Test
+    fun defaultOpenSchemeRoutesToExceptionHandlerWhenHandlerThrows() {
+        val throwing =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.LYNX),
+                opener = { _, _, _ -> throw RuntimeException("failed") },
+            )
+        val errorHandler =
+            StubRouteOpenHandler(
+                supported = listOf(BridgePlatformType.LYNX),
+                opener = { _, _, _ -> true },
+            )
+        val depend =
+            object : IHostRouterDepend {
+                override fun closeView(
+                    bridgeContext: IBridgeContext?,
+                    type: BridgePlatformType,
+                    containerID: String?,
+                    animated: Boolean?,
+                ) = true
+
+                override fun provideRouteOpenHandlerList(
+                    contextProviderFactory: ContextProviderFactory?,
+                ) = listOf<AbsRouteOpenHandler>(throwing)
+
+                override fun provideRouteOpenExceptionHandler(
+                    contextProviderFactory: ContextProviderFactory?,
+                ): AbsRouteOpenHandler = errorHandler
+            }
+
+        val result =
+            depend.openScheme(
+                bridgeContext,
+                "hybrid://lynx?bundle=a",
+                emptyMap(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+
+        assertTrue(result)
+        assertEquals(1, throwing.callCount)
+        assertEquals(1, errorHandler.callCount)
+    }
+
+    // endregion
+
+    // region helpers ---------------------------------------------------------------------------
+
+    private fun openParams(
+        scheme: String,
+        replace: Boolean? = false,
+        replaceType: String? = null,
+        useSysBrowser: Boolean? = null,
+    ): AbsRouterOpenMethodIDL.IDLMethodOpenParamModel {
+        val params = mockk<AbsRouterOpenMethodIDL.IDLMethodOpenParamModel>(relaxed = true)
+        every { params.scheme } returns scheme
+        every { params.replace } returns replace
+        every { params.replaceType } returns replaceType
+        every { params.useSysBrowser } returns useSysBrowser
+        every { params.extra } returns null
+        return params
+    }
+
+    private fun makeDependWithHandlers(handlers: List<AbsRouteOpenHandler>) =
+        object : IHostRouterDepend {
+            override fun closeView(
+                bridgeContext: IBridgeContext?,
+                type: BridgePlatformType,
+                containerID: String?,
+                animated: Boolean?,
+            ) = true
+
+            override fun provideRouteOpenHandlerList(
+                contextProviderFactory: ContextProviderFactory?,
+            ) = handlers
+        }
+
+    private class StubRouteOpenHandler(
+        private val supported: List<BridgePlatformType> = listOf(BridgePlatformType.ALL),
+        private val opener: (String, Map<String, Any>, Context?) -> Boolean = { _, _, _ -> false },
+    ) : AbsRouteOpenHandler() {
+        var callCount: Int = 0
+            private set
+
+        override fun openScheme(
+            scheme: String,
+            extraInfo: Map<String, Any>,
+            context: Context?,
+        ): Boolean {
+            callCount++
+            return opener(scheme, extraInfo, context)
+        }
+
+        override fun getSupportPlatformTypeList(): List<BridgePlatformType> = supported
+    }
+
+    private class OpenCallbackRecorder : CompletionBlock<AbsRouterOpenMethodIDL.IDLMethodOpenResultModel> {
+        var successResult: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel? = null
+        var failureCode: Int? = null
+        var failureMsg: String? = null
+
+        override fun onSuccess(
+            result: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel,
+            msg: String,
+        ) {
+            successResult = result
+        }
+
+        override fun onFailure(
+            code: Int,
+            msg: String,
+            data: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel?,
+        ) {
+            failureCode = code
+            failureMsg = msg
+        }
+
+        override fun onRawSuccess(data: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel?) = Unit
+    }
+
+    private class CloseCallbackRecorder : CompletionBlock<AbsRouterCloseMethodIDL.IDLMethodCloseResultModel> {
+        var successResult: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel? = null
+        var failureCode: Int? = null
+        var failureMsg: String? = null
+
+        override fun onSuccess(
+            result: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel,
+            msg: String,
+        ) {
+            successResult = result
+        }
+
+        override fun onFailure(
+            code: Int,
+            msg: String,
+            data: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel?,
+        ) {
+            failureCode = code
+            failureMsg = msg
+        }
+
+        override fun onRawSuccess(data: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel?) = Unit
+    }
+
+    // endregion
+}

package/android/src/test/java/com/tiktok/sparkling/method/router/RouterMethodUnitTest.kt

@@ -1,20 +1,196 @@
-// Copyright (c) 2022 TikTok Pte. Ltd.
-// Licensed under the Apache License Version 2.0 that can be found in the
-// LICENSE file in the root directory of this source tree.
 package com.tiktok.sparkling.method.router
 
+import android.content.Context
+import com.tiktok.sparkling.method.registry.core.BridgePlatformType
+import com.tiktok.sparkling.method.registry.core.IBridgeContext
+import com.tiktok.sparkling.method.registry.core.IDLBridgeMethod
+import com.tiktok.sparkling.method.registry.core.model.idl.CompletionBlock
+import com.tiktok.sparkling.method.router.close.AbsRouterCloseMethodIDL
+import com.tiktok.sparkling.method.router.close.RouterCloseMethod
+import com.tiktok.sparkling.method.router.open.AbsRouterOpenMethodIDL
+import com.tiktok.sparkling.method.router.open.RouterOpenMethod
+import com.tiktok.sparkling.method.router.utils.IHostRouterDepend
+import com.tiktok.sparkling.method.router.utils.RouterProvider
+import io.mockk.every
+import io.mockk.mockk
+import io.mockk.verify
+import org.junit.After
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertTrue
+import org.junit.Before
 import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
 
-import org.junit.Assert.*
-
-/**
- * Example local unit test, which will execute on the development machine (host).
- *
- * See [testing documentation](http://d.android.com/tools/testing).
- */
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE, sdk = [33])
 class RouterMethodUnitTest {
+    private lateinit var bridgeContext: IBridgeContext
+    private lateinit var context: Context
+
+    @Before
+    fun setUp() {
+        context = mockk(relaxed = true)
+        bridgeContext = mockk(relaxed = true)
+        every { bridgeContext.context } returns context
+        RouterProvider.hostRouterDepend = null
+    }
+
+    @After
+    fun tearDown() {
+        RouterProvider.hostRouterDepend = null
+    }
+
+    @Test
+    fun openMethodFailsWhenSchemeBlank() {
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterOpenMethodIDL.IDLMethodOpenParamModel>(relaxed = true)
+        every { params.scheme } returns "   "
+        every { params.replace } returns false
+
+        val callback = OpenCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertTrue(callback.successResult == null)
+        assertEquals(IDLBridgeMethod.INVALID_PARAM, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("scheme") == true)
+    }
+
     @Test
-    fun addition_isCorrect() {
-        assertEquals(4, 2 + 2)
+    fun openMethodSucceedsWithValidScheme() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every {
+            hostRouter.openScheme(any(), any(), any(), any(), any())
+        } returns true
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterOpenMethodIDL.IDLMethodOpenParamModel>(relaxed = true)
+        every { params.scheme } returns "hybrid://lynxview?bundle=main.lynx.bundle"
+        every { params.replace } returns false
+        every { params.useSysBrowser } returns true
+        every { params.replaceType } returns null
+        every { params.extra } returns null
+
+        val callback = OpenCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertNotNull(callback.successResult)
+        assertNull(callback.failureCode)
+        verify(exactly = 1) {
+            hostRouter.openScheme(
+                bridgeContext,
+                "hybrid://lynxview?bundle=main.lynx.bundle",
+                any(),
+                BridgePlatformType.LYNX,
+                context,
+            )
+        }
+    }
+
+    @Test
+    fun openMethodFailsWhenReplaceTypeInvalid() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterOpenMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterOpenMethodIDL.IDLMethodOpenParamModel>(relaxed = true)
+        every { params.scheme } returns "hybrid://lynxview?bundle=main.lynx.bundle"
+        every { params.replace } returns true
+        every { params.replaceType } returns "not-a-valid-type"
+
+        val callback = OpenCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.INVALID_PARAM, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Invalid replaceType") == true)
+    }
+
+    @Test
+    fun closeMethodFailsWhenRouterNotRegistered() {
+        val method = RouterCloseMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterCloseMethodIDL.IDLMethodCloseParamModel>(relaxed = true)
+        every { params.containerID } returns "container-1"
+        every { params.animated } returns true
+
+        val callback = CloseCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertEquals(IDLBridgeMethod.FAIL, callback.failureCode)
+        assertTrue(callback.failureMsg?.contains("Router service not available") == true)
+    }
+
+    @Test
+    fun closeMethodSucceedsWhenRouterClosesView() {
+        val hostRouter = mockk<IHostRouterDepend>(relaxed = true)
+        every {
+            hostRouter.closeView(any(), any(), any(), any())
+        } returns true
+        RouterProvider.hostRouterDepend = hostRouter
+
+        val method = RouterCloseMethod().apply { setBridgeContext(bridgeContext) }
+        val params = mockk<AbsRouterCloseMethodIDL.IDLMethodCloseParamModel>(relaxed = true)
+        every { params.containerID } returns "container-2"
+        every { params.animated } returns false
+
+        val callback = CloseCallbackRecorder()
+        method.handle(params, callback, BridgePlatformType.LYNX)
+
+        assertNotNull(callback.successResult)
+        assertNull(callback.failureCode)
+        verify(exactly = 1) {
+            hostRouter.closeView(bridgeContext, BridgePlatformType.LYNX, "container-2", false)
+        }
+    }
+
+    private class OpenCallbackRecorder : CompletionBlock<AbsRouterOpenMethodIDL.IDLMethodOpenResultModel> {
+        var successResult: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel? = null
+        var failureCode: Int? = null
+        var failureMsg: String? = null
+
+        override fun onSuccess(
+            result: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel,
+            msg: String,
+        ) {
+            successResult = result
+        }
+
+        override fun onFailure(
+            code: Int,
+            msg: String,
+            data: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel?,
+        ) {
+            failureCode = code
+            failureMsg = msg
+        }
+
+        override fun onRawSuccess(data: AbsRouterOpenMethodIDL.IDLMethodOpenResultModel?) = Unit
+    }
+
+    private class CloseCallbackRecorder : CompletionBlock<AbsRouterCloseMethodIDL.IDLMethodCloseResultModel> {
+        var successResult: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel? = null
+        var failureCode: Int? = null
+        var failureMsg: String? = null
+
+        override fun onSuccess(
+            result: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel,
+            msg: String,
+        ) {
+            successResult = result
+        }
+
+        override fun onFailure(
+            code: Int,
+            msg: String,
+            data: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel?,
+        ) {
+            failureCode = code
+            failureMsg = msg
+        }
+
+        override fun onRawSuccess(data: AbsRouterCloseMethodIDL.IDLMethodCloseResultModel?) = Unit
     }
 }

package/dist/src/devServer.js

@@ -17,7 +17,7 @@ export function getDevServerBaseURL() {
         }
         // Prefer the actual URL the native side used to load this bundle.
         // lynx.__globalProps.queryItems.url is set by the SDK from the scheme's
-        // url= parameter (e.g. "http://192.168.1.100:5969/main.lynx.bundle").
+        // url= parameter (e.g. "http://127.0.0.1:5969/main.lynx.bundle").
         if (typeof lynx !== 'undefined' && ((_b = (_a = lynx === null || lynx === void 0 ? void 0 : lynx.__globalProps) === null || _a === void 0 ? void 0 : _a.queryItems) === null || _b === void 0 ? void 0 : _b.url)) {
             const pageUrl = lynx.__globalProps.queryItems.url;
             if (pageUrl.startsWith('http://') || pageUrl.startsWith('https://')) {

package/dist/src/devServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../src/devServer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,yEAAyE;AACzE,0DAA0D;AAM1D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;;IAC/B,IAAI,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,kEAAkE;QAClE,wEAAwE;QACxE,sEAAsE;QACtE,IAAI,OAAO,IAAI,KAAK,WAAW,KAAI,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,aAAa,0CAAE,UAAU,0CAAE,GAAG,CAAA,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC;YAClD,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxC,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACL,CAAC;QACL,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,uBAAuB,KAAK,QAAQ,IAAI,uBAAuB,EAAE,CAAC;YACzE,OAAO,uBAAuB,CAAC;QACnC,CAAC;IACL,CAAC;IAAC,WAAM,CAAC;QACL,wBAAwB;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}
+{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../src/devServer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,yEAAyE;AACzE,0DAA0D;AAM1D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;;IAC/B,IAAI,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,kEAAkE;QAClE,wEAAwE;QACxE,kEAAkE;QAClE,IAAI,OAAO,IAAI,KAAK,WAAW,KAAI,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,aAAa,0CAAE,UAAU,0CAAE,GAAG,CAAA,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC;YAClD,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxC,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACL,CAAC;QACL,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,uBAAuB,KAAK,QAAQ,IAAI,uBAAuB,EAAE,CAAC;YACzE,OAAO,uBAAuB,CAAC;QACnC,CAAC;IACL,CAAC;IAAC,WAAM,CAAC;QACL,wBAAwB;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"fileNames":["../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.dom.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../src/devServer.ts","../../../sparkling-method/dist/types.d.ts","../../../sparkling-method/dist/index.d.ts","../src/close/close.d.ts","../src/close/close.ts","../src/open/open.d.ts","../src/open/open.ts","../src/navigate/navigate.d.ts","../src/navigate/navigate.ts","../index.ts","../../../../node_modules/.pnpm/@jest+expect-utils@29.7.0/node_modules/@jest/expect-utils/build/index.d.ts","../../../../node_modules/.pnpm/chalk@4.1.2/node_modules/chalk/index.d.ts","../../../../node_modules/.pnpm/@sinclair+typebox@0.27.10/node_modules/@sinclair/typebox/typebox.d.ts","../../../../node_modules/.pnpm/@jest+schemas@29.6.3/node_modules/@jest/schemas/build/index.d.ts","../../../../node_modules/.pnpm/pretty-format@29.7.0/node_modules/pretty-format/build/index.d.ts","../../../../node_modules/.pnpm/jest-diff@29.7.0/node_modules/jest-diff/build/index.d.ts","../../../../node_modules/.pnpm/jest-matcher-utils@29.7.0/node_modules/jest-matcher-utils/build/index.d.ts","../../../../node_modules/.pnpm/expect@29.7.0/node_modules/expect/build/index.d.ts","../../../../node_modules/.pnpm/@types+jest@29.5.14/node_modules/@types/jest/index.d.ts"],"fileIdsList":[[27],[29,32],[25,31],[29],[26,30],[28],[18,19,20,21,22,23],[17,18],[20],[15,21,22],[15,17,20],[16]],"fileInfos":[{"version":"c430d44666289dae81f30fa7b2edebf186ecc91a2d4c71266ea6ae76388792e1","affectsGlobalScope":true,"impliedFormat":1},{"version":"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","impliedFormat":1},{"version":"080941d9f9ff9307f7e27a83bcd888b7c8270716c39af943532438932ec1d0b9","affectsGlobalScope":true,"impliedFormat":1},{"version":"c57796738e7f83dbc4b8e65132f11a377649c00dd3eee333f672b8f0a6bea671","affectsGlobalScope":true,"impliedFormat":1},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true,"impliedFormat":1},{"version":"515d0b7b9bea2e31ea4ec968e9edd2c39d3eebf4a2d5cbd04e88639819ae3b71","affectsGlobalScope":true,"impliedFormat":1},{"version":"0559b1f683ac7505ae451f9a96ce4c3c92bdc71411651ca6ddb0e88baaaad6a3","affectsGlobalScope":true,"impliedFormat":1},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true,"impliedFormat":1},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true,"impliedFormat":1},{"version":"fb0f136d372979348d59b3f5020b4cdb81b5504192b1cacff5d1fbba29378aa1","affectsGlobalScope":true,"impliedFormat":1},{"version":"8e7f8264d0fb4c5339605a15daadb037bf238c10b654bb3eee14208f860a32ea","affectsGlobalScope":true,"impliedFormat":1},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true,"impliedFormat":1},{"version":"4fc8c80e3f83b51aa0be32aca09faa0a00968109a8b2f9a1172999ae422f6a58","signature":"51d6a96a88f06928d2bf9400f47a225ab2ca51b0c290f5c5aeb232b04f0aca9d"},"f7633d7fe074d6a4f1d215bbc7a3b27fc0419a5a3bfbbe054ac07f3dbbc68487","bdddec6a06096ab2fc1460e59d0e8c1c954ffe72290bee32bc1ecce28ebe9393","582fe2e974682a46dcee0b08fac869d96c56ec3421ad48633f6289f497acc3fd",{"version":"437d1d1bf67ea36dbf6f48e75dc75f7385e58e91d5a0acc493cbc1cec23c59fa","signature":"f421088758adc5b04e44c1548f2d7ac1cebbdda08458c8e493a490002c8e6f7c"},"a078d8603e9ef86dbed7ba0ff50276734c4cefbc5e64a6ab07144911ff701e3b",{"version":"ad4667e00d7fce51bded3e210d1f271e651ea5516cea8ba121201bc1614e022f","signature":"dd1d64b74f46208aecdee3727641eff5c0262826752e37a19ca6b2eb474d45af"},"e3963382b8a425258f14e665e7a0d39b024f1e71b7c9200096cdc9604ddf5f94",{"version":"712aba6de5cf5a6724f0ecdc5ec1176d35e7ed1071e36fb69d696dabfb1e7088","signature":"e902e6d4f2877e301fa4cf11b50a18c6a1c078bd34edecb15ae62459310004d0"},{"version":"f4ef2dc4d2182f03365773c1c488eb01ebd07186a7d7e3c51eea5eed6c0d5252","signature":"4acdb0a03d91ac0b94410f47337f1dba8f947a74300a305e1e6a14fef3933d07"},{"version":"cdcc132f207d097d7d3aa75615ab9a2e71d6a478162dde8b67f88ea19f3e54de","impliedFormat":1},{"version":"0d14fa22c41fdc7277e6f71473b20ebc07f40f00e38875142335d5b63cdfc9d2","impliedFormat":1},{"version":"e1028394c1cf96d5d057ecc647e31e457b919092f882ed0c7092152b077fed9d","impliedFormat":1},{"version":"f315e1e65a1f80992f0509e84e4ae2df15ecd9ef73df975f7c98813b71e4c8da","impliedFormat":1},{"version":"5b9586e9b0b6322e5bfbd2c29bd3b8e21ab9d871f82346cb71020e3d84bae73e","impliedFormat":1},{"version":"3e70a7e67c2cb16f8cd49097360c0309fe9d1e3210ff9222e9dac1f8df9d4fb6","impliedFormat":1},{"version":"ab68d2a3e3e8767c3fba8f80de099a1cfc18c0de79e42cb02ae66e22dfe14a66","impliedFormat":1},{"version":"d96cc6598148bf1a98fb2e8dcf01c63a4b3558bdaec6ef35e087fd0562eb40ec","impliedFormat":1},{"version":"f8db4fea512ab759b2223b90ecbbe7dae919c02f8ce95ec03f7fb1cf757cfbeb","affectsGlobalScope":true,"impliedFormat":1}],"root":[15,19,21,23,24],"options":{"composite":true,"declaration":true,"declarationMap":true,"emitDeclarationOnly":false,"esModuleInterop":true,"module":5,"outDir":"./","skipLibCheck":true,"sourceMap":true,"strict":true,"target":2},"referencedMap":[[28,1],[33,2],[32,3],[30,4],[31,5],[29,6],[24,7],[19,8],[22,9],[23,10],[21,11],[17,12]],"latestChangedDtsFile":"./index.d.ts","version":"5.9.3"}
+{"fileNames":["../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.dom.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.d.ts","../../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../src/devServer.ts","../../../sparkling-method/dist/types.d.ts","../../../sparkling-method/dist/index.d.ts","../src/close/close.d.ts","../src/close/close.ts","../src/open/open.d.ts","../src/open/open.ts","../src/navigate/navigate.d.ts","../src/navigate/navigate.ts","../index.ts","../../../../node_modules/.pnpm/@jest+expect-utils@29.7.0/node_modules/@jest/expect-utils/build/index.d.ts","../../../../node_modules/.pnpm/chalk@4.1.2/node_modules/chalk/index.d.ts","../../../../node_modules/.pnpm/@sinclair+typebox@0.27.10/node_modules/@sinclair/typebox/typebox.d.ts","../../../../node_modules/.pnpm/@jest+schemas@29.6.3/node_modules/@jest/schemas/build/index.d.ts","../../../../node_modules/.pnpm/pretty-format@29.7.0/node_modules/pretty-format/build/index.d.ts","../../../../node_modules/.pnpm/jest-diff@29.7.0/node_modules/jest-diff/build/index.d.ts","../../../../node_modules/.pnpm/jest-matcher-utils@29.7.0/node_modules/jest-matcher-utils/build/index.d.ts","../../../../node_modules/.pnpm/expect@29.7.0/node_modules/expect/build/index.d.ts","../../../../node_modules/.pnpm/@types+jest@29.5.14/node_modules/@types/jest/index.d.ts"],"fileIdsList":[[27],[29,32],[25,31],[29],[26,30],[28],[18,19,20,21,22,23],[17,18],[20],[15,21,22],[15,17,20],[16]],"fileInfos":[{"version":"c430d44666289dae81f30fa7b2edebf186ecc91a2d4c71266ea6ae76388792e1","affectsGlobalScope":true,"impliedFormat":1},{"version":"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","impliedFormat":1},{"version":"080941d9f9ff9307f7e27a83bcd888b7c8270716c39af943532438932ec1d0b9","affectsGlobalScope":true,"impliedFormat":1},{"version":"c57796738e7f83dbc4b8e65132f11a377649c00dd3eee333f672b8f0a6bea671","affectsGlobalScope":true,"impliedFormat":1},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true,"impliedFormat":1},{"version":"515d0b7b9bea2e31ea4ec968e9edd2c39d3eebf4a2d5cbd04e88639819ae3b71","affectsGlobalScope":true,"impliedFormat":1},{"version":"0559b1f683ac7505ae451f9a96ce4c3c92bdc71411651ca6ddb0e88baaaad6a3","affectsGlobalScope":true,"impliedFormat":1},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true,"impliedFormat":1},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true,"impliedFormat":1},{"version":"fb0f136d372979348d59b3f5020b4cdb81b5504192b1cacff5d1fbba29378aa1","affectsGlobalScope":true,"impliedFormat":1},{"version":"8e7f8264d0fb4c5339605a15daadb037bf238c10b654bb3eee14208f860a32ea","affectsGlobalScope":true,"impliedFormat":1},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true,"impliedFormat":1},{"version":"a4a7d5010a7e00e0249b9862f3ca68e90f7b5b7d2fb713f5d995ffc9b157e0e7","signature":"51d6a96a88f06928d2bf9400f47a225ab2ca51b0c290f5c5aeb232b04f0aca9d"},"f7633d7fe074d6a4f1d215bbc7a3b27fc0419a5a3bfbbe054ac07f3dbbc68487","bdddec6a06096ab2fc1460e59d0e8c1c954ffe72290bee32bc1ecce28ebe9393","582fe2e974682a46dcee0b08fac869d96c56ec3421ad48633f6289f497acc3fd",{"version":"437d1d1bf67ea36dbf6f48e75dc75f7385e58e91d5a0acc493cbc1cec23c59fa","signature":"f421088758adc5b04e44c1548f2d7ac1cebbdda08458c8e493a490002c8e6f7c"},"a078d8603e9ef86dbed7ba0ff50276734c4cefbc5e64a6ab07144911ff701e3b",{"version":"ad4667e00d7fce51bded3e210d1f271e651ea5516cea8ba121201bc1614e022f","signature":"dd1d64b74f46208aecdee3727641eff5c0262826752e37a19ca6b2eb474d45af"},"e3963382b8a425258f14e665e7a0d39b024f1e71b7c9200096cdc9604ddf5f94",{"version":"712aba6de5cf5a6724f0ecdc5ec1176d35e7ed1071e36fb69d696dabfb1e7088","signature":"e902e6d4f2877e301fa4cf11b50a18c6a1c078bd34edecb15ae62459310004d0"},{"version":"f4ef2dc4d2182f03365773c1c488eb01ebd07186a7d7e3c51eea5eed6c0d5252","signature":"4acdb0a03d91ac0b94410f47337f1dba8f947a74300a305e1e6a14fef3933d07"},{"version":"cdcc132f207d097d7d3aa75615ab9a2e71d6a478162dde8b67f88ea19f3e54de","impliedFormat":1},{"version":"0d14fa22c41fdc7277e6f71473b20ebc07f40f00e38875142335d5b63cdfc9d2","impliedFormat":1},{"version":"e1028394c1cf96d5d057ecc647e31e457b919092f882ed0c7092152b077fed9d","impliedFormat":1},{"version":"f315e1e65a1f80992f0509e84e4ae2df15ecd9ef73df975f7c98813b71e4c8da","impliedFormat":1},{"version":"5b9586e9b0b6322e5bfbd2c29bd3b8e21ab9d871f82346cb71020e3d84bae73e","impliedFormat":1},{"version":"3e70a7e67c2cb16f8cd49097360c0309fe9d1e3210ff9222e9dac1f8df9d4fb6","impliedFormat":1},{"version":"ab68d2a3e3e8767c3fba8f80de099a1cfc18c0de79e42cb02ae66e22dfe14a66","impliedFormat":1},{"version":"d96cc6598148bf1a98fb2e8dcf01c63a4b3558bdaec6ef35e087fd0562eb40ec","impliedFormat":1},{"version":"f8db4fea512ab759b2223b90ecbbe7dae919c02f8ce95ec03f7fb1cf757cfbeb","affectsGlobalScope":true,"impliedFormat":1}],"root":[15,19,21,23,24],"options":{"composite":true,"declaration":true,"declarationMap":true,"emitDeclarationOnly":false,"esModuleInterop":true,"module":5,"outDir":"./","skipLibCheck":true,"sourceMap":true,"strict":true,"target":2},"referencedMap":[[28,1],[33,2],[32,3],[30,4],[31,5],[29,6],[24,7],[19,8],[22,9],[23,10],[21,11],[17,12]],"latestChangedDtsFile":"./index.d.ts","version":"5.9.3"}

package/ios/Sparkling-Router.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name           = 'Sparkling-Router'
-  s.version        = "2.1.0-rc.24"
+  s.version        = "2.1.0-rc.26"
   s.summary        = "iOS navigation router SDK for Sparkling"
   s.description    = "iOS navigation router SDK for Sparkling"
   s.license        = "Apache-2.0"
@@ -26,6 +26,13 @@ Pod::Spec.new do |s|
     ]
   end
 
+  s.test_spec 'Tests' do |tests|
+    tests.requires_app_host = false
+    tests.source_files = [
+      'SparklingMethodTests/**/*.{h,m,swift}',
+    ]
+  end
+
   s.dependency 'SparklingMethod/Core'
   s.dependency 'SparklingMethod/DIProvider'
   s.dependency 'Mantle', '~> 2.2.0'

package/ios/SparklingMethodTests/SPKRouterTest.swift

@@ -0,0 +1,119 @@
+// Copyright 2025 The Sparkling Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+
+import XCTest
+import SparklingMethod
+@testable import Sparkling_Router
+
+class SPKRouterTest: XCTestCase {
+
+    // MARK: - CloseMethod Tests
+
+    func testCloseMethodName() {
+        let method = CloseMethod()
+        XCTAssertEqual(method.methodName, "router.close")
+        XCTAssertEqual(CloseMethod.methodName(), "router.close")
+    }
+
+    func testCloseMethodModels() {
+        let method = CloseMethod()
+        XCTAssertTrue(method.paramsModelClass is CloseMethodParamModel.Type)
+        XCTAssertTrue(method.resultModelClass is EmptyMethodModelClass.Type)
+    }
+
+    func testCloseMethodParamModelValidation() {
+        let paramModel = CloseMethodParamModel()
+
+        XCTAssertTrue(type(of: paramModel).requiredKeyPaths()?.isEmpty ?? false)
+
+        paramModel.containerID = "test-container"
+        XCTAssertNoThrow(try paramModel.validate())
+    }
+
+    func testCloseMethodParamModelJSONMapping() {
+        let paramModel = CloseMethodParamModel()
+        paramModel.containerID = "test-container"
+        paramModel.animated = true
+
+        XCTAssertEqual(type(of: paramModel).jsonKeyPathsByPropertyKey() as? [String: String], [
+            "containerID": "containerID",
+            "animated": "animated"
+        ])
+    }
+
+    // MARK: - OpenMethod Tests
+
+    func testOpenMethodName() {
+        let method = OpenMethod()
+        XCTAssertEqual(method.methodName, "router.open")
+        XCTAssertEqual(OpenMethod.methodName(), "router.open")
+    }
+
+    func testOpenMethodModels() {
+        let method = OpenMethod()
+        XCTAssertTrue(method.paramsModelClass is OpenMethodParamModel.Type)
+        XCTAssertTrue(method.resultModelClass is EmptyMethodModelClass.Type)
+    }
+
+    func testOpenMethodParamModelValidation() throws {
+        XCTAssertThrowsError(try OpenMethodParamModel(dictionary: [:]))
+
+        let paramModel = try XCTUnwrap(try OpenMethodParamModel.from(dict: ["scheme": "https://example.com"]))
+        paramModel.scheme = "https://example.com"
+        XCTAssertNoThrow(try paramModel.validate())
+    }
+
+    func testOpenMethodParamModelJSONMapping() {
+        let paramModel = OpenMethodParamModel()
+
+        XCTAssertEqual(type(of: paramModel).jsonKeyPathsByPropertyKey() as? [String: String], [
+            "scheme": "scheme",
+            "replace": "replace",
+            "replaceType": "replaceType",
+            "useSysBrowser": "useSysBrowser",
+            "animated": "animated",
+            "interceptor": "interceptor",
+            "extra": "extra"
+        ])
+    }
+
+    func testOpenMethodParamModelDefaultValues() {
+        let paramModel = OpenMethodParamModel()
+        paramModel.scheme = "test-scheme"
+
+        XCTAssertFalse(paramModel.replace)
+        XCTAssertFalse(paramModel.useSysBrowser)
+        XCTAssertFalse(paramModel.animated)
+    }
+
+    func testOpenMethodParamModelAllFields() {
+        let paramModel = OpenMethodParamModel()
+        paramModel.scheme = "test-scheme"
+        paramModel.replace = true
+        paramModel.replaceType = "all"
+        paramModel.useSysBrowser = true
+        paramModel.animated = true
+        paramModel.interceptor = "test-interceptor"
+        let extraDict = NSDictionary(dictionary: ["key": "value"])
+        paramModel.extra = extraDict
+
+        XCTAssertEqual(paramModel.scheme, "test-scheme")
+        XCTAssertTrue(paramModel.replace)
+        XCTAssertEqual(paramModel.replaceType, "all")
+        XCTAssertTrue(paramModel.useSysBrowser)
+        XCTAssertTrue(paramModel.animated)
+        XCTAssertEqual(paramModel.interceptor, "test-interceptor")
+        XCTAssertEqual(paramModel.extra, extraDict)
+    }
+
+    func testOpenMethodParamModelFromDictParsesExtraObject() throws {
+        let dict: [String: Any] = [
+            "scheme": "hybrid://lynxview_page?bundle=a.lynx.bundle",
+            "extra": ["foo": "bar"],
+        ]
+        let model = try XCTUnwrap(try OpenMethodParamModel.from(dict: dict))
+        XCTAssertNotNil(model.extra)
+        XCTAssertEqual(model.extra?["foo"] as? String, "bar")
+    }
+}

package/module.config.json

@@ -29,7 +29,7 @@
     }
   },
   "android": {
-    "packageName": "com.tiktok.sparkling.methods.router",
+    "packageName": "com.tiktok.sparkling.method.router",
     "className": "RouterMethod",
     "buildGradle": "android/build.gradle.kts"
   },
@@ -43,4 +43,4 @@
     "entryPoint": "index.ts",
     "bundleName": "router.bundle"
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparkling-navigation",
-  "version": "2.1.0-rc.24",
+  "version": "2.1.0-rc.26",
   "homepage": "https://tiktok.github.io/sparkling/",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
   "license": "Apache-2.0",
   "description": "none",
   "dependencies": {
-    "sparkling-method": "2.1.0-rc.24"
+    "sparkling-method": "2.1.0-rc.26"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",

package/src/devServer.ts

@@ -22,7 +22,7 @@ export function getDevServerBaseURL(): string | undefined {
 
         // Prefer the actual URL the native side used to load this bundle.
         // lynx.__globalProps.queryItems.url is set by the SDK from the scheme's
-        // url= parameter (e.g. "http://192.168.1.100:5969/main.lynx.bundle").
+        // url= parameter (e.g. "http://127.0.0.1:5969/main.lynx.bundle").
         if (typeof lynx !== 'undefined' && lynx?.__globalProps?.queryItems?.url) {
             const pageUrl = lynx.__globalProps.queryItems.url;
             if (pageUrl.startsWith('http://') || pageUrl.startsWith('https://')) {