@capawesome/capacitor-apple-sign-in 0.0.1

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/AppleSignInActivity.java

@@ -0,0 +1,366 @@
+package io.capawesome.capacitorjs.plugins.applesignin;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.graphics.Bitmap;
+import android.graphics.PorterDuff;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.util.Log;
+import android.util.TypedValue;
+import android.view.Gravity;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.webkit.CookieManager;
+import android.webkit.JavascriptInterface;
+import android.webkit.WebChromeClient;
+import android.webkit.WebResourceRequest;
+import android.webkit.WebResourceResponse;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+import android.webkit.WebViewClient;
+import android.widget.ImageButton;
+import android.widget.LinearLayout;
+import android.widget.ProgressBar;
+import android.widget.RelativeLayout;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import org.json.JSONObject;
+
+public class AppleSignInActivity extends Activity {
+
+    public static final String EXTRA_URL = "url";
+    public static final String EXTRA_REDIRECT_URL = "redirectUrl";
+    public static final String EXTRA_AUTHORIZATION_CODE = "authorizationCode";
+    public static final String EXTRA_ID_TOKEN = "idToken";
+    public static final String EXTRA_USER = "user";
+    public static final String EXTRA_EMAIL = "email";
+    public static final String EXTRA_GIVEN_NAME = "givenName";
+    public static final String EXTRA_FAMILY_NAME = "familyName";
+    public static final String EXTRA_STATE = "state";
+
+    private String redirectUrl;
+    private TextView domainTextView;
+    private ProgressBar progressBar;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        String url = getIntent().getStringExtra(EXTRA_URL);
+        redirectUrl = getIntent().getStringExtra(EXTRA_REDIRECT_URL);
+
+        LinearLayout rootLayout = new LinearLayout(this);
+        rootLayout.setOrientation(LinearLayout.VERTICAL);
+        rootLayout.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
+
+        // Toolbar
+        RelativeLayout toolbar = new RelativeLayout(this);
+        toolbar.setBackgroundColor(0xFFF8F8F8);
+        LinearLayout.LayoutParams toolbarParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, dpToPx(56));
+        toolbar.setLayoutParams(toolbarParams);
+
+        ImageButton closeButton = new ImageButton(this);
+        closeButton.setImageResource(R.drawable.ic_close);
+        closeButton.setBackgroundColor(0x00000000);
+        int closePadding = dpToPx(12);
+        closeButton.setPadding(closePadding, closePadding, closePadding, closePadding);
+        closeButton.setContentDescription("Close");
+        closeButton.setOnClickListener(v -> {
+            setResult(RESULT_CANCELED);
+            finish();
+        });
+        RelativeLayout.LayoutParams closeParams = new RelativeLayout.LayoutParams(dpToPx(48), dpToPx(48));
+        closeParams.addRule(RelativeLayout.ALIGN_PARENT_START);
+        closeParams.addRule(RelativeLayout.CENTER_VERTICAL);
+        closeParams.setMarginStart(dpToPx(4));
+
+        domainTextView = new TextView(this);
+        domainTextView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 14);
+        domainTextView.setTextColor(0xFF5F6368);
+        domainTextView.setSingleLine(true);
+        domainTextView.setEllipsize(TextUtils.TruncateAt.END);
+        domainTextView.setGravity(Gravity.CENTER);
+        RelativeLayout.LayoutParams domainParams = new RelativeLayout.LayoutParams(
+            ViewGroup.LayoutParams.MATCH_PARENT,
+            ViewGroup.LayoutParams.WRAP_CONTENT
+        );
+        domainParams.addRule(RelativeLayout.CENTER_IN_PARENT);
+        int domainHorizontalMargin = dpToPx(56);
+        domainParams.setMarginStart(domainHorizontalMargin);
+        domainParams.setMarginEnd(domainHorizontalMargin);
+
+        toolbar.addView(closeButton, closeParams);
+        toolbar.addView(domainTextView, domainParams);
+
+        // Progress bar
+        progressBar = new ProgressBar(this, null, android.R.attr.progressBarStyleHorizontal);
+        progressBar.setIndeterminate(false);
+        progressBar.setMax(100);
+        progressBar.setProgress(0);
+        progressBar.getProgressDrawable().setColorFilter(0xFF007AFF, PorterDuff.Mode.SRC_IN);
+        progressBar.setVisibility(View.GONE);
+        LinearLayout.LayoutParams progressParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, dpToPx(3));
+
+        // WebView
+        WebView webView = new WebView(this);
+        LinearLayout.LayoutParams webViewParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 0, 1f);
+
+        WebSettings webSettings = webView.getSettings();
+        webSettings.setJavaScriptEnabled(true);
+        webSettings.setDomStorageEnabled(true);
+        String userAgent = webSettings.getUserAgentString().replaceAll("; wv\\b", "").replaceAll("\\s*Version/\\S+", "");
+        webSettings.setUserAgentString(userAgent);
+        Log.d("AppleSignIn", "User-Agent: " + userAgent);
+        Log.d("AppleSignIn", "Loading URL: " + url);
+
+        CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
+
+        webView.addJavascriptInterface(new AppleSignInBridge(), "AppleSignInBridge");
+
+        webView.setWebChromeClient(
+            new WebChromeClient() {
+                @Override
+                public void onProgressChanged(WebView view, int newProgress) {
+                    progressBar.setProgress(newProgress);
+                    progressBar.setVisibility(newProgress < 100 ? View.VISIBLE : View.GONE);
+                }
+            }
+        );
+        webView.setWebViewClient(
+            new WebViewClient() {
+                @Override
+                public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) {
+                    String requestUrl = request.getUrl().toString();
+                    if (!requestUrl.startsWith("https://appleid.apple.com")) {
+                        return super.shouldInterceptRequest(view, request);
+                    }
+                    try {
+                        HttpURLConnection conn = (HttpURLConnection) new URL(requestUrl).openConnection();
+                        conn.setRequestMethod(request.getMethod());
+                        for (java.util.Map.Entry<String, String> entry : request.getRequestHeaders().entrySet()) {
+                            if (!entry.getKey().equalsIgnoreCase("X-Requested-With")) {
+                                conn.setRequestProperty(entry.getKey(), entry.getValue());
+                            }
+                        }
+                        conn.setInstanceFollowRedirects(false);
+                        int statusCode = conn.getResponseCode();
+                        String reasonPhrase = conn.getResponseMessage();
+                        InputStream inputStream = (statusCode >= 400) ? conn.getErrorStream() : conn.getInputStream();
+                        String contentType = conn.getContentType();
+                        String mimeType = "text/html";
+                        String encoding = "utf-8";
+                        if (contentType != null) {
+                            String[] parts = contentType.split(";");
+                            mimeType = parts[0].trim();
+                            for (String part : parts) {
+                                String trimmed = part.trim();
+                                if (trimmed.startsWith("charset=")) {
+                                    encoding = trimmed.substring(8).trim();
+                                }
+                            }
+                        }
+                        java.util.Map<String, String> responseHeaders = new java.util.HashMap<>();
+                        for (java.util.Map.Entry<String, java.util.List<String>> header : conn.getHeaderFields().entrySet()) {
+                            if (header.getKey() != null && !header.getValue().isEmpty()) {
+                                responseHeaders.put(header.getKey(), header.getValue().get(0));
+                            }
+                        }
+                        return new WebResourceResponse(
+                            mimeType,
+                            encoding,
+                            statusCode,
+                            reasonPhrase != null ? reasonPhrase : "OK",
+                            responseHeaders,
+                            inputStream
+                        );
+                    } catch (Exception e) {
+                        Log.e("AppleSignIn", "Intercept failed: " + e.getMessage());
+                        return super.shouldInterceptRequest(view, request);
+                    }
+                }
+
+                @Override
+                public void onReceivedHttpError(WebView view, WebResourceRequest request, WebResourceResponse errorResponse) {
+                    super.onReceivedHttpError(view, request, errorResponse);
+                    Log.e(
+                        "AppleSignIn",
+                        "HTTP error " +
+                        errorResponse.getStatusCode() +
+                        " for URL: " +
+                        request.getUrl() +
+                        " | Reason: " +
+                        errorResponse.getReasonPhrase()
+                    );
+                    java.util.Map<String, String> headers = errorResponse.getResponseHeaders();
+                    if (headers != null) {
+                        for (java.util.Map.Entry<String, String> entry : headers.entrySet()) {
+                            Log.d("AppleSignIn", "Response header: " + entry.getKey() + " = " + entry.getValue());
+                        }
+                    }
+                }
+
+                @Override
+                public void onPageStarted(WebView view, String url, Bitmap favicon) {
+                    super.onPageStarted(view, url, favicon);
+                    updateDomainText(url);
+                    String js =
+                        "(function() {" +
+                        "  var origSubmit = HTMLFormElement.prototype.submit;" +
+                        "  HTMLFormElement.prototype.submit = function() {" +
+                        "    if (this.action && this.action.indexOf('" +
+                        escapeJsString(redirectUrl) +
+                        "') !== -1) {" +
+                        "      var data = {};" +
+                        "      for (var i = 0; i < this.elements.length; i++) {" +
+                        "        if (this.elements[i].name) {" +
+                        "          data[this.elements[i].name] = this.elements[i].value;" +
+                        "        }" +
+                        "      }" +
+                        "      window.AppleSignInBridge.onFormData(JSON.stringify(data));" +
+                        "      return;" +
+                        "    }" +
+                        "    origSubmit.call(this);" +
+                        "  };" +
+                        "})();";
+                    view.evaluateJavascript(js, null);
+                }
+
+                @Override
+                public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
+                    String requestUrl = request.getUrl().toString();
+                    if (requestUrl.startsWith(redirectUrl)) {
+                        handleRedirectUrl(requestUrl);
+                        return true;
+                    }
+                    return super.shouldOverrideUrlLoading(view, request);
+                }
+            }
+        );
+
+        rootLayout.addView(toolbar);
+        rootLayout.addView(progressBar, progressParams);
+        rootLayout.addView(webView, webViewParams);
+        setContentView(rootLayout);
+        setupStatusBar();
+
+        ViewCompat.setOnApplyWindowInsetsListener(rootLayout, (v, windowInsets) -> {
+            Insets insets = windowInsets.getInsets(WindowInsetsCompat.Type.statusBars());
+            v.setPadding(0, insets.top, 0, 0);
+            return WindowInsetsCompat.CONSUMED;
+        });
+
+        webView.loadUrl(url);
+    }
+
+    private void handleRedirectUrl(@NonNull String url) {
+        Uri uri = Uri.parse(url);
+        String code = uri.getQueryParameter("code");
+        String idToken = uri.getQueryParameter("id_token");
+        String state = uri.getQueryParameter("state");
+
+        if (code != null && idToken != null) {
+            Intent resultIntent = new Intent();
+            resultIntent.putExtra(EXTRA_AUTHORIZATION_CODE, code);
+            resultIntent.putExtra(EXTRA_ID_TOKEN, idToken);
+            resultIntent.putExtra(EXTRA_STATE, state);
+            setResult(RESULT_OK, resultIntent);
+        } else {
+            setResult(RESULT_CANCELED);
+        }
+        finish();
+    }
+
+    private int dpToPx(int dp) {
+        return (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, dp, getResources().getDisplayMetrics());
+    }
+
+    @NonNull
+    private static String escapeJsString(@NonNull String input) {
+        return input.replace("\\", "\\\\").replace("'", "\\'").replace("\"", "\\\"");
+    }
+
+    @SuppressWarnings("deprecation")
+    private void setupStatusBar() {
+        Window window = getWindow();
+        window.setStatusBarColor(0xFFF8F8F8);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            android.view.WindowInsetsController controller = window.getInsetsController();
+            if (controller != null) {
+                controller.setSystemBarsAppearance(
+                    android.view.WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS,
+                    android.view.WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
+                );
+            }
+        } else {
+            window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
+        }
+    }
+
+    private void updateDomainText(@NonNull String url) {
+        try {
+            String host = Uri.parse(url).getHost();
+            if (host != null) {
+                domainTextView.setText(host);
+            }
+        } catch (Exception e) {
+            // ignore
+        }
+    }
+
+    private class AppleSignInBridge {
+
+        @JavascriptInterface
+        public void onFormData(String jsonString) {
+            try {
+                JSONObject data = new JSONObject(jsonString);
+
+                String code = data.optString("code", null);
+                String idToken = data.optString("id_token", null);
+                String state = data.optString("state", null);
+                String userJson = data.optString("user", null);
+
+                String email = null;
+                String givenName = null;
+                String familyName = null;
+
+                if (userJson != null && !userJson.isEmpty()) {
+                    try {
+                        JSONObject userObj = new JSONObject(userJson);
+                        email = userObj.optString("email", null);
+                        JSONObject nameObj = userObj.optJSONObject("name");
+                        if (nameObj != null) {
+                            givenName = nameObj.optString("firstName", null);
+                            familyName = nameObj.optString("lastName", null);
+                        }
+                    } catch (Exception e) {
+                        // ignore
+                    }
+                }
+
+                Intent resultIntent = new Intent();
+                resultIntent.putExtra(EXTRA_AUTHORIZATION_CODE, code);
+                resultIntent.putExtra(EXTRA_ID_TOKEN, idToken);
+                resultIntent.putExtra(EXTRA_STATE, state);
+                resultIntent.putExtra(EXTRA_EMAIL, email);
+                resultIntent.putExtra(EXTRA_GIVEN_NAME, givenName);
+                resultIntent.putExtra(EXTRA_FAMILY_NAME, familyName);
+
+                setResult(RESULT_OK, resultIntent);
+                finish();
+            } catch (Exception e) {
+                setResult(RESULT_CANCELED);
+                finish();
+            }
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/AppleSignInPlugin.java

@@ -0,0 +1,106 @@
+package io.capawesome.capacitorjs.plugins.applesignin;
+
+import android.content.Intent;
+import androidx.activity.result.ActivityResult;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.Logger;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.ActivityCallback;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import io.capawesome.capacitorjs.plugins.applesignin.classes.CustomException;
+import io.capawesome.capacitorjs.plugins.applesignin.classes.options.SignInOptions;
+import io.capawesome.capacitorjs.plugins.applesignin.classes.results.SignInResult;
+import io.capawesome.capacitorjs.plugins.applesignin.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.applesignin.interfaces.Result;
+
+@CapacitorPlugin(name = "AppleSignIn")
+public class AppleSignInPlugin extends Plugin {
+
+    public static final String TAG = "AppleSignIn";
+    public static final String ERROR_UNKNOWN_ERROR = "An unknown error has occurred.";
+
+    private AppleSignIn implementation;
+
+    @Override
+    public void load() {
+        this.implementation = new AppleSignIn();
+    }
+
+    @PluginMethod
+    public void initialize(PluginCall call) {
+        try {
+            String clientId = call.getString("clientId");
+            if (clientId == null) {
+                call.reject("clientId must be provided.");
+                return;
+            }
+            implementation.initialize(clientId);
+            call.resolve();
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @PluginMethod
+    public void signIn(PluginCall call) {
+        try {
+            SignInOptions options = new SignInOptions(call);
+            String url = implementation.buildAuthUrl(options);
+
+            Intent intent = new Intent(getContext(), AppleSignInActivity.class);
+            intent.putExtra(AppleSignInActivity.EXTRA_URL, url);
+            intent.putExtra(AppleSignInActivity.EXTRA_REDIRECT_URL, options.getRedirectUrl());
+
+            startActivityForResult(call, intent, "handleSignInResult");
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @ActivityCallback
+    private void handleSignInResult(PluginCall call, ActivityResult activityResult) {
+        if (call == null) {
+            return;
+        }
+        NonEmptyResultCallback<SignInResult> callback = new NonEmptyResultCallback<>() {
+            @Override
+            public void success(@NonNull SignInResult result) {
+                resolveCall(call, result);
+            }
+
+            @Override
+            public void error(Exception exception) {
+                rejectCall(call, exception);
+            }
+        };
+        implementation.handleActivityResult(activityResult.getResultCode(), activityResult.getData(), callback);
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        String code = null;
+        if (exception instanceof CustomException) {
+            code = ((CustomException) exception).getCode();
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message, code);
+    }
+
+    private void resolveCall(@NonNull PluginCall call) {
+        call.resolve();
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @Nullable Result result) {
+        if (result == null) {
+            call.resolve();
+        } else {
+            call.resolve(result.toJSObject());
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/classes/CustomException.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.applesignin.classes;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+public class CustomException extends Exception {
+
+    @Nullable
+    private final String code;
+
+    public CustomException(@Nullable String code, @NonNull String message) {
+        super(message);
+        this.code = code;
+    }
+
+    @Nullable
+    public String getCode() {
+        return code;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/classes/CustomExceptions.java

@@ -0,0 +1,12 @@
+package io.capawesome.capacitorjs.plugins.applesignin.classes;
+
+public class CustomExceptions {
+
+    public static final CustomException CLIENT_ID_MISSING = new CustomException(
+        null,
+        "clientId must be provided. Call initialize() first."
+    );
+    public static final CustomException REDIRECT_URL_MISSING = new CustomException(null, "redirectUrl must be provided.");
+    public static final CustomException SIGN_IN_CANCELED = new CustomException("SIGN_IN_CANCELED", "Sign in was canceled.");
+    public static final CustomException SIGN_IN_FAILED = new CustomException(null, "Sign in failed.");
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/classes/options/SignInOptions.java

@@ -0,0 +1,84 @@
+package io.capawesome.capacitorjs.plugins.applesignin.classes.options;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSArray;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.applesignin.classes.CustomExceptions;
+import java.util.ArrayList;
+import java.util.List;
+import org.json.JSONArray;
+
+public class SignInOptions {
+
+    @NonNull
+    private final String redirectUrl;
+
+    @NonNull
+    private final List<String> scopes;
+
+    @Nullable
+    private final String nonce;
+
+    @Nullable
+    private final String state;
+
+    public SignInOptions(@NonNull PluginCall call) throws Exception {
+        this.redirectUrl = getRedirectUrlFromCall(call);
+        this.scopes = getScopesFromCall(call);
+        this.nonce = call.getString("nonce");
+        this.state = call.getString("state");
+    }
+
+    @NonNull
+    public String getRedirectUrl() {
+        return redirectUrl;
+    }
+
+    @NonNull
+    public List<String> getScopes() {
+        return scopes;
+    }
+
+    @Nullable
+    public String getNonce() {
+        return nonce;
+    }
+
+    @Nullable
+    public String getState() {
+        return state;
+    }
+
+    @NonNull
+    private static String getRedirectUrlFromCall(@NonNull PluginCall call) throws Exception {
+        String redirectUrl = call.getString("redirectUrl");
+        if (redirectUrl == null) {
+            throw CustomExceptions.REDIRECT_URL_MISSING;
+        }
+        return redirectUrl;
+    }
+
+    @NonNull
+    private static List<String> getScopesFromCall(@NonNull PluginCall call) {
+        List<String> scopes = new ArrayList<>();
+        JSArray scopesArray = call.getArray("scopes");
+        if (scopesArray == null) {
+            return scopes;
+        }
+        try {
+            JSONArray jsonArray = scopesArray;
+            for (int i = 0; i < jsonArray.length(); i++) {
+                String scope = jsonArray.getString(i);
+                if ("EMAIL".equals(scope)) {
+                    scopes.add("email");
+                } else if ("FULL_NAME".equals(scope)) {
+                    scopes.add("name");
+                }
+            }
+        } catch (Exception e) {
+            // ignore
+        }
+        return scopes;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/classes/results/SignInResult.java

@@ -0,0 +1,65 @@
+package io.capawesome.capacitorjs.plugins.applesignin.classes.results;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.applesignin.interfaces.Result;
+import org.json.JSONObject;
+
+public class SignInResult implements Result {
+
+    @NonNull
+    private final String authorizationCode;
+
+    @NonNull
+    private final String idToken;
+
+    @NonNull
+    private final String user;
+
+    @Nullable
+    private final String email;
+
+    @Nullable
+    private final String givenName;
+
+    @Nullable
+    private final String familyName;
+
+    @Nullable
+    private final String state;
+
+    public SignInResult(
+        @NonNull String authorizationCode,
+        @NonNull String idToken,
+        @NonNull String user,
+        @Nullable String email,
+        @Nullable String givenName,
+        @Nullable String familyName,
+        @Nullable String state
+    ) {
+        this.authorizationCode = authorizationCode;
+        this.idToken = idToken;
+        this.user = user;
+        this.email = email;
+        this.givenName = givenName;
+        this.familyName = familyName;
+        this.state = state;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("authorizationCode", authorizationCode);
+        result.put("idToken", idToken);
+        result.put("user", user);
+        result.put("email", email == null ? JSONObject.NULL : email);
+        result.put("givenName", givenName == null ? JSONObject.NULL : givenName);
+        result.put("familyName", familyName == null ? JSONObject.NULL : familyName);
+        if (state != null) {
+            result.put("state", state);
+        }
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.applesignin.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/interfaces/NonEmptyResultCallback.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.applesignin.interfaces;
+
+import androidx.annotation.NonNull;
+
+public interface NonEmptyResultCallback<T extends Result> extends Callback {
+    void success(@NonNull T result);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applesignin/interfaces/Result.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.applesignin.interfaces;
+
+import com.getcapacitor.JSObject;
+
+public interface Result {
+    JSObject toJSObject();
+}