@capawesome/capacitor-in-app-browser 0.0.1

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/WebViewDialog.java

@@ -0,0 +1,343 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes;
+
+import android.Manifest;
+import android.annotation.SuppressLint;
+import android.app.Dialog;
+import android.content.Context;
+import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.graphics.Color;
+import android.graphics.Typeface;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.util.TypedValue;
+import android.view.Gravity;
+import android.view.ViewGroup;
+import android.webkit.JavascriptInterface;
+import android.webkit.PermissionRequest;
+import android.webkit.ValueCallback;
+import android.webkit.WebChromeClient;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+import android.webkit.WebViewClient;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.content.ContextCompat;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.OpenInWebViewOptions;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.WebViewToolbarOptions;
+import java.util.ArrayList;
+import java.util.List;
+
+public class WebViewDialog extends Dialog {
+
+    public interface Listener {
+        void onClosed(@NonNull WebViewDialog dialog);
+        void onMessageReceived(@NonNull String data);
+        void onPageLoaded();
+        void onPageNavigationCompleted(@NonNull String url);
+    }
+
+    private static final String BRIDGE_JAVASCRIPT =
+        "window.CapacitorInAppBrowser = window.CapacitorInAppBrowser || { postMessage: function (data) { CapacitorInAppBrowserAndroid.postMessage(JSON.stringify(data)); } };";
+    private static final String BRIDGE_NAME = "CapacitorInAppBrowserAndroid";
+    private static final int TOOLBAR_HEIGHT_IN_DP = 56;
+
+    @Nullable
+    private TextView backButton;
+
+    @Nullable
+    private TextView forwardButton;
+
+    private boolean initialLoadNotified = false;
+
+    @NonNull
+    private final Listener listener;
+
+    @NonNull
+    private final OpenInWebViewOptions options;
+
+    @Nullable
+    private TextView titleView;
+
+    @Nullable
+    private WebView webView;
+
+    public WebViewDialog(@NonNull Context context, @NonNull OpenInWebViewOptions options, @NonNull Listener listener) {
+        super(context, android.R.style.Theme_Material_Light_NoActionBar);
+        this.options = options;
+        this.listener = listener;
+    }
+
+    public void executeScript(@NonNull String script, @NonNull ValueCallback<String> resultCallback) {
+        WebView webView = this.webView;
+        if (webView != null) {
+            webView.evaluateJavascript(script, resultCallback);
+        }
+    }
+
+    public void handleOnPause() {
+        WebView webView = this.webView;
+        if (options.getPauseMediaWhenHidden() && webView != null) {
+            webView.onPause();
+        }
+    }
+
+    public void handleOnResume() {
+        WebView webView = this.webView;
+        if (options.getPauseMediaWhenHidden() && webView != null) {
+            webView.onResume();
+        }
+    }
+
+    @Override
+    public void onBackPressed() {
+        WebView webView = this.webView;
+        if (options.getHardwareBackButton() && webView != null && webView.canGoBack()) {
+            webView.goBack();
+        } else {
+            dismiss();
+        }
+    }
+
+    public void postMessage(@NonNull String data) {
+        WebView webView = this.webView;
+        if (webView != null) {
+            webView.evaluateJavascript(
+                "window.dispatchEvent(new CustomEvent('capacitorInAppBrowserMessage', { detail: " + data + " }));",
+                null
+            );
+        }
+    }
+
+    @Override
+    protected void onCreate(@Nullable Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        WebView webView = createWebView();
+        this.webView = webView;
+        setContentView(createContentView(webView));
+        setOnDismissListener(dialog -> handleDismiss());
+        webView.loadUrl(options.getUri().toString(), options.getHeaders());
+    }
+
+    @NonNull
+    private LinearLayout createContentView(@NonNull WebView webView) {
+        LinearLayout contentView = new LinearLayout(getContext());
+        contentView.setOrientation(LinearLayout.VERTICAL);
+        contentView.setFitsSystemWindows(true);
+        contentView.setBackgroundColor(Color.WHITE);
+        if (options.getToolbar().getVisible()) {
+            contentView.addView(
+                createToolbar(),
+                new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, dpToPx(TOOLBAR_HEIGHT_IN_DP))
+            );
+        }
+        contentView.addView(webView, new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 0, 1));
+        return contentView;
+    }
+
+    @NonNull
+    private LinearLayout createToolbar() {
+        WebViewToolbarOptions toolbarOptions = options.getToolbar();
+        int textColor = toolbarOptions.getColor() == null ? Color.BLACK : toolbarOptions.getColor();
+
+        LinearLayout toolbar = new LinearLayout(getContext());
+        toolbar.setOrientation(LinearLayout.HORIZONTAL);
+        toolbar.setGravity(Gravity.CENTER_VERTICAL);
+        toolbar.setBackgroundColor(toolbarOptions.getBackgroundColor() == null ? Color.WHITE : toolbarOptions.getBackgroundColor());
+        toolbar.setPadding(dpToPx(8), 0, dpToPx(8), 0);
+
+        TextView closeButton = createToolbarButton(toolbarOptions.getCloseButtonText(), textColor);
+        closeButton.setOnClickListener(view -> dismiss());
+        toolbar.addView(closeButton);
+
+        TextView titleView = new TextView(getContext());
+        titleView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
+        titleView.setTypeface(null, Typeface.BOLD);
+        titleView.setTextColor(textColor);
+        titleView.setMaxLines(1);
+        titleView.setEllipsize(TextUtils.TruncateAt.MIDDLE);
+        titleView.setPadding(dpToPx(8), 0, dpToPx(8), 0);
+        toolbar.addView(titleView, new LinearLayout.LayoutParams(0, ViewGroup.LayoutParams.WRAP_CONTENT, 1));
+        this.titleView = titleView;
+
+        if (toolbarOptions.getShowNavigationButtons()) {
+            TextView backButton = createToolbarButton("‹", textColor);
+            backButton.setTextSize(TypedValue.COMPLEX_UNIT_SP, 24);
+            backButton.setOnClickListener(view -> {
+                WebView webView = this.webView;
+                if (webView != null && webView.canGoBack()) {
+                    webView.goBack();
+                }
+            });
+            toolbar.addView(backButton);
+            this.backButton = backButton;
+
+            TextView forwardButton = createToolbarButton("›", textColor);
+            forwardButton.setTextSize(TypedValue.COMPLEX_UNIT_SP, 24);
+            forwardButton.setOnClickListener(view -> {
+                WebView webView = this.webView;
+                if (webView != null && webView.canGoForward()) {
+                    webView.goForward();
+                }
+            });
+            toolbar.addView(forwardButton);
+            this.forwardButton = forwardButton;
+
+            updateNavigationButtons();
+        }
+
+        return toolbar;
+    }
+
+    @NonNull
+    private TextView createToolbarButton(@NonNull String text, int textColor) {
+        TextView button = new TextView(getContext());
+        button.setText(text);
+        button.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
+        button.setTextColor(textColor);
+        button.setPadding(dpToPx(8), dpToPx(8), dpToPx(8), dpToPx(8));
+        button.setClickable(true);
+        return button;
+    }
+
+    @NonNull
+    @SuppressLint("SetJavaScriptEnabled")
+    private WebView createWebView() {
+        WebView webView = new WebView(getContext());
+        WebSettings settings = webView.getSettings();
+        settings.setJavaScriptEnabled(true);
+        settings.setDomStorageEnabled(true);
+        settings.setMediaPlaybackRequiresUserGesture(options.getMediaPlaybackRequiresUserAction());
+        settings.setSupportZoom(options.getAllowZoom());
+        settings.setBuiltInZoomControls(options.getAllowZoom());
+        settings.setDisplayZoomControls(false);
+        String userAgent = options.getUserAgent();
+        if (userAgent != null) {
+            settings.setUserAgentString(userAgent);
+        }
+        webView.addJavascriptInterface(new Bridge(), BRIDGE_NAME);
+        webView.setWebViewClient(
+            new WebViewClient() {
+                @Override
+                public void onPageStarted(WebView view, String url, Bitmap favicon) {
+                    injectBridgeJavaScript();
+                }
+
+                @Override
+                public void onPageFinished(WebView view, String url) {
+                    injectBridgeJavaScript();
+                    updateNavigationButtons();
+                    updateTitle();
+                    if (!initialLoadNotified) {
+                        initialLoadNotified = true;
+                        listener.onPageLoaded();
+                    }
+                    if (url != null) {
+                        listener.onPageNavigationCompleted(url);
+                    }
+                }
+
+                @Override
+                public void doUpdateVisitedHistory(WebView view, String url, boolean isReload) {
+                    updateNavigationButtons();
+                    updateTitle();
+                }
+            }
+        );
+        webView.setWebChromeClient(
+            new WebChromeClient() {
+                @Override
+                public void onPermissionRequest(PermissionRequest request) {
+                    handlePermissionRequest(request);
+                }
+
+                @Override
+                public void onReceivedTitle(WebView view, String title) {
+                    updateTitle();
+                }
+            }
+        );
+        return webView;
+    }
+
+    private int dpToPx(int dp) {
+        return Math.round(dp * getContext().getResources().getDisplayMetrics().density);
+    }
+
+    private void handleDismiss() {
+        WebView webView = this.webView;
+        if (webView != null) {
+            webView.destroy();
+            this.webView = null;
+        }
+        listener.onClosed(this);
+    }
+
+    private void handlePermissionRequest(@NonNull PermissionRequest request) {
+        List<String> grantedResources = new ArrayList<>();
+        for (String resource : request.getResources()) {
+            if (PermissionRequest.RESOURCE_VIDEO_CAPTURE.equals(resource) && hasPermission(Manifest.permission.CAMERA)) {
+                grantedResources.add(resource);
+            } else if (PermissionRequest.RESOURCE_AUDIO_CAPTURE.equals(resource) && hasPermission(Manifest.permission.RECORD_AUDIO)) {
+                grantedResources.add(resource);
+            } else if (PermissionRequest.RESOURCE_PROTECTED_MEDIA_ID.equals(resource)) {
+                grantedResources.add(resource);
+            }
+        }
+        if (grantedResources.isEmpty()) {
+            request.deny();
+        } else {
+            request.grant(grantedResources.toArray(new String[0]));
+        }
+    }
+
+    private boolean hasPermission(@NonNull String permission) {
+        return ContextCompat.checkSelfPermission(getContext(), permission) == PackageManager.PERMISSION_GRANTED;
+    }
+
+    private void injectBridgeJavaScript() {
+        WebView webView = this.webView;
+        if (webView != null) {
+            webView.evaluateJavascript(BRIDGE_JAVASCRIPT, null);
+        }
+    }
+
+    private void updateNavigationButtons() {
+        WebView webView = this.webView;
+        TextView backButton = this.backButton;
+        TextView forwardButton = this.forwardButton;
+        if (webView == null || backButton == null || forwardButton == null) {
+            return;
+        }
+        backButton.setAlpha(webView.canGoBack() ? 1.0f : 0.3f);
+        forwardButton.setAlpha(webView.canGoForward() ? 1.0f : 0.3f);
+    }
+
+    private void updateTitle() {
+        TextView titleView = this.titleView;
+        WebView webView = this.webView;
+        if (titleView == null || webView == null) {
+            return;
+        }
+        WebViewToolbarOptions toolbarOptions = options.getToolbar();
+        if (toolbarOptions.getTitle() != null) {
+            titleView.setText(toolbarOptions.getTitle());
+        } else if (toolbarOptions.getShowUrl()) {
+            titleView.setText(webView.getUrl());
+        } else {
+            titleView.setText(webView.getTitle());
+        }
+    }
+
+    private class Bridge {
+
+        @JavascriptInterface
+        public void postMessage(@Nullable String data) {
+            if (data != null) {
+                listener.onMessageReceived(data);
+            }
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/events/BrowserPageNavigationCompletedEvent.java

@@ -0,0 +1,23 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.events;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
+
+public class BrowserPageNavigationCompletedEvent implements Result {
+
+    @NonNull
+    private final String url;
+
+    public BrowserPageNavigationCompletedEvent(@NonNull String url) {
+        this.url = url;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("url", url);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/events/MessageReceivedEvent.java

@@ -0,0 +1,23 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.events;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
+
+public class MessageReceivedEvent implements Result {
+
+    @NonNull
+    private final Object data;
+
+    public MessageReceivedEvent(@NonNull Object data) {
+        this.data = data;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("data", data);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/ExecuteScriptOptions.java

@@ -0,0 +1,29 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+
+public class ExecuteScriptOptions {
+
+    @NonNull
+    private final String script;
+
+    public ExecuteScriptOptions(@NonNull PluginCall call) throws Exception {
+        this.script = ExecuteScriptOptions.getScriptFromCall(call);
+    }
+
+    @NonNull
+    public String getScript() {
+        return script;
+    }
+
+    @NonNull
+    private static String getScriptFromCall(@NonNull PluginCall call) throws Exception {
+        String script = call.getString("script");
+        if (script == null || script.isEmpty()) {
+            throw CustomExceptions.SCRIPT_MISSING;
+        }
+        return script;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/GetCookiesOptions.java

@@ -0,0 +1,29 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+
+public class GetCookiesOptions {
+
+    @NonNull
+    private final String url;
+
+    public GetCookiesOptions(@NonNull PluginCall call) throws Exception {
+        this.url = GetCookiesOptions.getUrlFromCall(call);
+    }
+
+    @NonNull
+    public String getUrl() {
+        return url;
+    }
+
+    @NonNull
+    private static String getUrlFromCall(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null || url.isEmpty()) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        return url;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/OpenInExternalBrowserOptions.java

@@ -0,0 +1,30 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import android.net.Uri;
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+
+public class OpenInExternalBrowserOptions {
+
+    @NonNull
+    private final Uri uri;
+
+    public OpenInExternalBrowserOptions(@NonNull PluginCall call) throws Exception {
+        this.uri = OpenInExternalBrowserOptions.getUriFromCall(call);
+    }
+
+    @NonNull
+    public Uri getUri() {
+        return uri;
+    }
+
+    @NonNull
+    private static Uri getUriFromCall(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null || url.isEmpty()) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        return Uri.parse(url);
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/OpenInSystemBrowserOptions.java

@@ -0,0 +1,74 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import android.graphics.Color;
+import android.net.Uri;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+
+public class OpenInSystemBrowserOptions {
+
+    private final boolean hideToolbarOnScroll;
+    private final boolean showTitle;
+
+    @Nullable
+    private final Integer toolbarColor;
+
+    @NonNull
+    private final Uri uri;
+
+    public OpenInSystemBrowserOptions(@NonNull PluginCall call) throws Exception {
+        JSObject androidOptions = call.getObject("android");
+        this.hideToolbarOnScroll = androidOptions != null && androidOptions.optBoolean("hideToolbarOnScroll", false);
+        this.showTitle = androidOptions != null && androidOptions.optBoolean("showTitle", false);
+        this.toolbarColor = OpenInSystemBrowserOptions.getToolbarColorFromObject(androidOptions);
+        this.uri = OpenInSystemBrowserOptions.getUriFromCall(call);
+    }
+
+    public boolean getHideToolbarOnScroll() {
+        return hideToolbarOnScroll;
+    }
+
+    public boolean getShowTitle() {
+        return showTitle;
+    }
+
+    @Nullable
+    public Integer getToolbarColor() {
+        return toolbarColor;
+    }
+
+    @NonNull
+    public Uri getUri() {
+        return uri;
+    }
+
+    @Nullable
+    private static Integer getToolbarColorFromObject(@Nullable JSObject object) throws Exception {
+        String toolbarColor = object == null ? null : object.getString("toolbarColor");
+        if (toolbarColor == null) {
+            return null;
+        }
+        try {
+            return Color.parseColor(toolbarColor);
+        } catch (IllegalArgumentException exception) {
+            throw CustomExceptions.TOOLBAR_COLOR_INVALID;
+        }
+    }
+
+    @NonNull
+    private static Uri getUriFromCall(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null || url.isEmpty()) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        Uri uri = Uri.parse(url);
+        String scheme = uri.getScheme();
+        if (scheme == null || !(scheme.equalsIgnoreCase("http") || scheme.equalsIgnoreCase("https"))) {
+            throw CustomExceptions.URL_INVALID;
+        }
+        return uri;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/OpenInWebViewOptions.java

@@ -0,0 +1,112 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import android.net.Uri;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+
+public class OpenInWebViewOptions {
+
+    private final boolean allowZoom;
+    private final boolean hardwareBackButton;
+
+    @NonNull
+    private final Map<String, String> headers;
+
+    private final boolean mediaPlaybackRequiresUserAction;
+    private final boolean pauseMediaWhenHidden;
+
+    @NonNull
+    private final WebViewToolbarOptions toolbar;
+
+    @NonNull
+    private final Uri uri;
+
+    @Nullable
+    private final String userAgent;
+
+    public OpenInWebViewOptions(@NonNull PluginCall call) throws Exception {
+        JSObject androidOptions = call.getObject("android");
+        this.allowZoom = androidOptions != null && androidOptions.optBoolean("allowZoom", false);
+        this.hardwareBackButton = androidOptions == null || androidOptions.optBoolean("hardwareBackButton", true);
+        this.headers = OpenInWebViewOptions.getHeadersFromCall(call);
+        this.mediaPlaybackRequiresUserAction = call.getBoolean("mediaPlaybackRequiresUserAction", false);
+        this.pauseMediaWhenHidden = androidOptions == null || androidOptions.optBoolean("pauseMediaWhenHidden", true);
+        this.toolbar = new WebViewToolbarOptions(call.getObject("toolbar"));
+        this.uri = OpenInWebViewOptions.getUriFromCall(call);
+        this.userAgent = call.getString("userAgent");
+    }
+
+    public boolean getAllowZoom() {
+        return allowZoom;
+    }
+
+    public boolean getHardwareBackButton() {
+        return hardwareBackButton;
+    }
+
+    @NonNull
+    public Map<String, String> getHeaders() {
+        return headers;
+    }
+
+    public boolean getMediaPlaybackRequiresUserAction() {
+        return mediaPlaybackRequiresUserAction;
+    }
+
+    public boolean getPauseMediaWhenHidden() {
+        return pauseMediaWhenHidden;
+    }
+
+    @NonNull
+    public WebViewToolbarOptions getToolbar() {
+        return toolbar;
+    }
+
+    @NonNull
+    public Uri getUri() {
+        return uri;
+    }
+
+    @Nullable
+    public String getUserAgent() {
+        return userAgent;
+    }
+
+    @NonNull
+    private static Map<String, String> getHeadersFromCall(@NonNull PluginCall call) {
+        Map<String, String> headers = new HashMap<>();
+        JSObject headersObject = call.getObject("headers");
+        if (headersObject == null) {
+            return headers;
+        }
+        Iterator<String> keys = headersObject.keys();
+        while (keys.hasNext()) {
+            String key = keys.next();
+            String value = headersObject.getString(key);
+            if (value != null) {
+                headers.put(key, value);
+            }
+        }
+        return headers;
+    }
+
+    @NonNull
+    private static Uri getUriFromCall(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null || url.isEmpty()) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        Uri uri = Uri.parse(url);
+        String scheme = uri.getScheme();
+        if (scheme == null || !(scheme.equalsIgnoreCase("http") || scheme.equalsIgnoreCase("https"))) {
+            throw CustomExceptions.URL_INVALID;
+        }
+        return uri;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/PostMessageOptions.java

@@ -0,0 +1,30 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
+
+public class PostMessageOptions {
+
+    @NonNull
+    private final JSObject data;
+
+    public PostMessageOptions(@NonNull PluginCall call) throws Exception {
+        this.data = PostMessageOptions.getDataFromCall(call);
+    }
+
+    @NonNull
+    public JSObject getData() {
+        return data;
+    }
+
+    @NonNull
+    private static JSObject getDataFromCall(@NonNull PluginCall call) throws Exception {
+        JSObject data = call.getObject("data");
+        if (data == null) {
+            throw CustomExceptions.DATA_MISSING;
+        }
+        return data;
+    }
+}