Add GetNativeSettingsHandler to process getNativeSettings messages from SERP

Placeholder for now, adding persistence and the rest in another PR

Author: mikescamell

settings/settings-impl/src/main/java/com/duckduckgo/settings/impl/serpsettings/messaging/GetNativeSettingsHandler.kt

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2025 DuckDuckGo
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.duckduckgo.settings.impl.serpsettings.messaging
+
+import com.duckduckgo.app.di.AppCoroutineScope
+import com.duckduckgo.common.utils.AppUrl
+import com.duckduckgo.common.utils.DispatcherProvider
+import com.duckduckgo.contentscopescripts.api.ContentScopeJsMessageHandlersPlugin
+import com.duckduckgo.di.scopes.AppScope
+import com.duckduckgo.js.messaging.api.JsMessage
+import com.duckduckgo.js.messaging.api.JsMessageCallback
+import com.duckduckgo.js.messaging.api.JsMessageHandler
+import com.duckduckgo.js.messaging.api.JsMessaging
+import com.duckduckgo.settings.api.SettingsPageFeature
+import com.squareup.anvil.annotations.ContributesMultibinding
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.launch
+import logcat.logcat
+import javax.inject.Inject
+
+/**
+ * Handles the getNativeSettings message from SERP to retrieve stored settings.
+ *
+ * If there are no stored settings, it returns an empty JSON object.
+ */
+@ContributesMultibinding(AppScope::class)
+class GetNativeSettingsHandler @Inject constructor(
+ private val dispatcherProvider: DispatcherProvider,
+ @AppCoroutineScope private val appScope: CoroutineScope,
+ private val settingsPageFeature: SettingsPageFeature,
+ // TODO: Inject data store when implemented
+) : ContentScopeJsMessageHandlersPlugin {
+
+ override fun getJsMessageHandler(): JsMessageHandler =
+ object : JsMessageHandler {
+ override fun process(
+ jsMessage: JsMessage,
+ jsMessaging: JsMessaging,
+ jsMessageCallback: JsMessageCallback?,
+ ) {
+ appScope.launch(dispatcherProvider.io()) {
+ if (settingsPageFeature.serpSettingsSync().isEnabled()) {
+ logcat { "SERP-SETTINGS: GetNativeSettingsHandler processing message" }
+
+ // TODO return settings from datastore or empty object
+ }
+ }
+ }
+
+ override val allowedDomains: List<String> = listOf(AppUrl.Url.HOST)
+ override val featureName: String = "serpSettings"
+ override val methods: List<String> = listOf(GET_NATIVE_SETTINGS_METHOD_NAME)
+ }
+
+ companion object {
+ private const val GET_NATIVE_SETTINGS_METHOD_NAME = "getNativeSettings"
+ }
+}

settings/settings-impl/src/test/java/com/duckduckgo/settings/impl/serpsettings/messaging/GetNativeSettingsHandlerTest.kt

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2025 DuckDuckGo
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.duckduckgo.settings.impl.serpsettings.messaging
+
+import com.duckduckgo.common.test.CoroutineTestRule
+import com.duckduckgo.settings.api.SettingsPageFeature
+import org.junit.Assert.*
+import org.junit.Rule
+import org.junit.Test
+import org.mockito.kotlin.mock
+
+class GetNativeSettingsHandlerTest {
+
+ @get:Rule
+ val coroutineTestRule: CoroutineTestRule = CoroutineTestRule()
+
+ private val handler = GetNativeSettingsHandler(
+ dispatcherProvider = coroutineTestRule.testDispatcherProvider,
+ appScope = coroutineTestRule.testScope,
+ settingsPageFeature = mock<SettingsPageFeature>(),
+ ).getJsMessageHandler()
+
+ @Test
+ fun `only allow duckduckgo dot com domains`() {
+ val domains = handler.allowedDomains
+ assertEquals(1, domains.size)
+ assertEquals("duckduckgo.com", domains.first())
+ }
+
+ @Test
+ fun `feature name is serpSettings`() {
+ assertEquals("serpSettings", handler.featureName)
+ }
+
+ @Test
+ fun `only contains getNativeSettings method`() {
+ val methods = handler.methods
+ assertEquals(1, methods.size)
+ assertEquals("getNativeSettings", methods[0])
+ }
+}