Add docs

Author: CrisBarreiro

content-scope-scripts/content-scope-scripts-api/src/main/java/com/duckduckgo/contentscopescripts/api/GlobalContentScopeJsMessageHandlersPlugin.kt

@@ -38,7 +38,13 @@ interface GlobalContentScopeJsMessageHandlersPlugin {
 interface GlobalJsMessageHandler {
 
     /**
-     * Processes a global message.
+     * Processes a global message received by the WebView.
+     *
+     * This method is responsible for handling a [JsMessage] and optionally
+     * invoking a callback so consumers can also process the message if needed.
+     *
+     * @param jsMessage The JavaScript message to be processed.
+     * @param jsMessageCallback An optional callback to handle the result of the message processing.
      */
     fun process(
         jsMessage: JsMessage,

js-messaging/js-messaging-api/src/main/java/com/duckduckgo/js/messaging/api/AdsjsMessaging.kt

@@ -21,9 +21,18 @@ import android.webkit.WebView
 interface AdsjsMessaging {
 
     /**
-     * Method to register the JS interface to the webView instance
+     * Register the JS interface to the webView instance
+     *
+     * @param webView WebView instance where the interface will be added
+     * @param jsMessageCallback Optional callback to handle messages
      */
     suspend fun register(webView: WebView, jsMessageCallback: JsMessageCallback?)
+
+    /**
+     * Unregister the JS interface from the webView instance
+     *
+     * @param webView WebView instance where the interface will be removed
+     */
     suspend fun unregister(webView: WebView)
 
     /**
@@ -39,7 +48,13 @@ interface AdsjsMessaging {
 
 interface AdsjsMessageHandler {
     /**
-     * This method processes a [JsMessage]
+     * Processes a JavaScript message received by the WebView.
+     *
+     * This method is responsible for handling a [JsMessage] and optionally
+     * invoking a callback so consumers can also process the message if needed.
+     *
+     * @param jsMessage The JavaScript message to be processed.
+     * @param jsMessageCallback An optional callback to handle the result of the message processing.
      */
     fun process(
         jsMessage: JsMessage,