@capawesome/capacitor-square-mobile-payments 0.1.4 → 0.1.6

package/Package.swift

@@ -22,10 +22,6 @@ let package = Package(
                 .product(name: "SquareMobilePaymentsSDK", package: "mobile-payments-sdk-ios"),
                 .product(name: "MockReaderUI", package: "mobile-payments-sdk-ios")
             ],
-            path: "ios/Plugin"),
-        .testTarget(
-            name: "SquareMobilePaymentsPluginTests",
-            dependencies: ["SquareMobilePaymentsPlugin"],
-            path: "ios/PluginTests")
+            path: "ios/Plugin")
     ]
 )

package/README.md

@@ -1,4 +1,4 @@
-# @capawesome/capacitor-square-mobile-payments
+# Capacitor Square Mobile Payments Plugin
 
 Unofficial Capacitor plugin for [Square Mobile Payments SDK](https://developer.squareup.com/docs/mobile-payments-sdk).[^1]
 
@@ -25,6 +25,16 @@ This plugin provides a comprehensive integration with Square's Mobile Payments S
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
+## Use Cases
+
+The Square Mobile Payments plugin is typically used to accept in-person payments in a Capacitor app, for example:
+
+- **Point of sale**: Turn your app into a POS system that accepts tap, dip, swipe, and manually entered card payments with Square card readers.
+- **Tap to Pay on iPhone**: Accept contactless payments directly on an iPhone without additional hardware by linking a Square seller account with an Apple ID.
+- **Mobile and pop-up sales**: Pair, monitor, and manage Square readers for markets, food trucks, or events, and process payments offline with automatic sync when connectivity is limited.
+- **Compliant receipts**: Access card details, authorization codes, and EMV data of completed payments to generate compliant receipts.
+- **Testing without hardware**: Use the mock reader in debug builds to test the whole payment flow without a physical reader.
+
 ## Compatibility
 
 | Plugin Version | Capacitor Version | Status         |
@@ -33,6 +43,21 @@ Missing a feature? Just [open an issue](https://github.com/capawesome-team/capac
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-square-mobile-payments` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome/capacitor-square-mobile-payments
 npx cap sync
@@ -40,6 +65,38 @@ npx cap sync
 
 ### Android
 
+#### SDK Initialization
+
+The Square Mobile Payments SDK must be initialized in your `Application` class before using the plugin. Create a custom `Application` class (if you don't already have one) and add the following code:
+
+1. Create a file `MainApplication.java` in your app's `android/app/src/main/java/<your-package>/` directory:
+
+```java
+package com.example.app;
+
+import android.app.Application;
+import com.squareup.sdk.mobilepayments.MobilePaymentsSdk;
+
+public class MainApplication extends Application {
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        MobilePaymentsSdk.initialize("YOUR_SQUARE_APPLICATION_ID", this);
+    }
+}
+```
+
+**Note**: Replace `YOUR_SQUARE_APPLICATION_ID` with your actual Square Application ID.
+
+2. Register the custom `Application` class in your `AndroidManifest.xml`:
+
+```xml
+<application
+    android:name=".MainApplication"
+    ...>
+```
+
 #### Variables
 
 If needed, you can define the following project variable in your app's `variables.gradle` file to change the default version of the dependency:
@@ -122,8 +179,14 @@ No configuration required for this plugin.
 
 ## Usage
 
+The following examples show how to initialize and authorize the SDK, pair and list readers, start a payment, read the available card input methods, and listen for payment and reader events.
+
+### Initialize and authorize the SDK
+
+Initialize the SDK with your Square location ID and authorize it with a Square access token. The `initialize(...)` method must be called before any other method:
+
 ```typescript
-import { SquareMobilePayments, CardInputMethod } from '@capawesome/capacitor-square-mobile-payments';
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const initializeSDK = async () => {
   await SquareMobilePayments.initialize({
@@ -134,15 +197,39 @@ const initializeSDK = async () => {
     accessToken: 'YOUR_ACCESS_TOKEN',
   });
 };
+```
+
+### Check the authorization state
+
+Check whether the SDK is currently authorized, for example on app start:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const checkAuthorization = async () => {
   const { authorized } = await SquareMobilePayments.isAuthorized();
   console.log('Authorized:', authorized);
 };
+```
+
+### Pair a Square reader
+
+Start the pairing process. The SDK searches for nearby readers and pairs with the first one found:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const pairReader = async () => {
   await SquareMobilePayments.startPairing();
 };
+```
+
+### List the paired readers
+
+Get all paired readers with their serial number, model, and status:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const getReaders = async () => {
   const { readers } = await SquareMobilePayments.getReaders();
@@ -150,6 +237,14 @@ const getReaders = async () => {
     console.log('Reader:', reader.serialNumber, reader.model, reader.status);
   }
 };
+```
+
+### Start a payment
+
+Present the payment UI and process a payment with the specified parameters. Only one payment can be active at a time:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const processPayment = async () => {
   await SquareMobilePayments.startPayment({
@@ -166,6 +261,14 @@ const processPayment = async () => {
     },
   });
 };
+```
+
+### Listen for payment events
+
+Listen for successful, failed, and cancelled payments to react to the result of a payment flow:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const listenToPaymentEvents = () => {
   SquareMobilePayments.addListener('paymentDidFinish', (event) => {
@@ -182,6 +285,14 @@ const listenToPaymentEvents = () => {
     console.log('Payment cancelled');
   });
 };
+```
+
+### Listen for reader events
+
+Listen for reader status changes and changes to the available card input methods:
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const listenToReaderEvents = () => {
   SquareMobilePayments.addListener('readerWasAdded', (event) => {
@@ -196,6 +307,14 @@ const listenToReaderEvents = () => {
     console.log('Available methods:', event.cardInputMethods);
   });
 };
+```
+
+### Get the available card input methods
+
+Read the card entry methods that are currently available based on the connected readers (e.g. tap, dip, swipe, or keyed entry):
+
+```typescript
+import { SquareMobilePayments } from '@capawesome/capacitor-square-mobile-payments';
 
 const getAvailableMethods = async () => {
   const { cardInputMethods } = await SquareMobilePayments.getAvailableCardInputMethods();
@@ -1376,6 +1495,46 @@ Callback to receive payment cancellation notifications.
 
 </docgen-api>
 
+## FAQ
+
+### Which platforms are supported by this plugin?
+
+The plugin supports Android and iOS. There is no Web implementation, since the Square Mobile Payments SDK requires native hardware access to card readers.
+
+### How can I test payments without a physical card reader?
+
+Use the `showMockReader()` method to display a mock reader interface for testing payment flows without physical hardware. It is only intended for development and testing purposes and is therefore only available in debug builds. You can hide it again with `hideMockReader()`.
+
+### What permissions does the plugin require?
+
+The plugin requires location access to confirm that payments are occurring in a supported Square location, Bluetooth access to connect to Square card readers, and, on iOS, microphone access to receive data from magstripe readers. You can check and request the required permissions with `checkPermissions()` and `requestPermissions()`, and the corresponding privacy descriptions must be added to your `Info.plist` on iOS (see [Installation](#installation)).
+
+### Does the plugin support Tap to Pay on iPhone?
+
+Yes, on iOS you can link a Square seller account with an Apple ID using `linkAppleAccount()`, which presents an Apple sheet with the Tap to Pay on iPhone terms and conditions. Use `isDeviceCapable()` to check whether the device supports Tap to Pay on iPhone, and `relinkAppleAccount()` to switch to a different Apple ID.
+
+### Why do the plugin methods fail before I call any of them?
+
+The Square Mobile Payments SDK must be initialized natively with your Square Application ID before the plugin can be used: in a custom `Application` class on Android and in the `AppDelegate` on iOS (see [Installation](#installation)). Additionally, `initialize(...)` must be called before any other plugin method, followed by `authorize(...)` with a Square access token.
+
+### Can I process payments without an internet connection?
+
+Yes, the plugin supports processing payments online or offline with automatic sync. Note that for offline payments, the payment `id` may be `null` until the payment has been synced.
+
+### Can I use this plugin with Ionic, React, Vue or Angular?
+
+Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects.
+
+## Related Plugins
+
+- [Purchases](https://capawesome.io/docs/sdks/capacitor/purchases/): Support in-app purchases in your Capacitor app.
+- [Superwall](https://capawesome.io/docs/sdks/capacitor/superwall/): Present remotely-configured paywalls to drive subscriptions.
+- [Wallet](https://capawesome.io/docs/sdks/capacitor/wallet/): Add passes to Apple Wallet and Google Wallet.
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
 ## Changelog
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/square-mobile-payments/CHANGELOG.md).

package/android/src/main/java/io/capawesome/capacitorjs/plugins/squaremobilepayments/SquareMobilePayments.java

@@ -1,6 +1,7 @@
 package io.capawesome.capacitorjs.plugins.squaremobilepayments;
 
-import android.app.Application;
+import android.os.Handler;
+import android.os.Looper;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import com.getcapacitor.JSObject;
@@ -43,9 +44,15 @@ public class SquareMobilePayments {
     @NonNull
     private final SquareMobilePaymentsPlugin plugin;
 
+    @NonNull
+    private final Handler mainHandler = new Handler(Looper.getMainLooper());
+
     private boolean isInitialized = false;
     private boolean isAuthorized = false;
 
+    @Nullable
+    private String locationId;
+
     @Nullable
     private Object pairingHandle;
 
@@ -58,18 +65,30 @@ public class SquareMobilePayments {
     @Nullable
     private CallbackReference availableCardInputMethodsCallbackReference;
 
+    @Nullable
+    private CallbackReference authorizationCallbackReference;
+
     public SquareMobilePayments(@NonNull SquareMobilePaymentsPlugin plugin) {
         this.plugin = plugin;
     }
 
-    private String locationId;
-
     public void initialize(@NonNull InitializeOptions options, @NonNull EmptyCallback callback) {
         try {
             this.locationId = options.getLocationId();
-            Application application = (Application) plugin.getContext().getApplicationContext();
 
-            MobilePaymentsSdk.initialize(locationId, application);
+            // SDK must already be initialized in Application.onCreate() with the Square Application ID.
+            // Verify the SDK is ready by attempting to access the settings manager.
+            try {
+                MobilePaymentsSdk.settingsManager();
+            } catch (Exception e) {
+                callback.error(
+                    new Exception(
+                        "Square SDK not initialized. Make sure to call MobilePaymentsSdk.initialize() in your Application.onCreate().",
+                        e
+                    )
+                );
+                return;
+            }
 
             isInitialized = true;
             callback.success();
@@ -86,13 +105,33 @@ public class SquareMobilePayments {
 
             String accessToken = options.getAccessToken();
 
-            AuthorizationManager authManager = MobilePaymentsSdk.authorizationManager();
-            authManager.authorize(accessToken, locationId, result -> {
-                if (result.isSuccess()) {
-                    isAuthorized = true;
-                    callback.success();
-                } else {
-                    callback.error(new Exception(result.errorMessage()));
+            mainHandler.post(() -> {
+                try {
+                    AuthorizationManager authManager = MobilePaymentsSdk.authorizationManager();
+
+                    authorizationCallbackReference = authManager.authorize(accessToken, locationId, result -> {
+                        if (result.isSuccess()) {
+                            isAuthorized = true;
+                            callback.success();
+                        } else {
+                            isAuthorized = false;
+                            String errorMsg = result.errorMessage();
+                            if (errorMsg == null || errorMsg.isEmpty()) {
+                                errorMsg = "Authorization failed";
+                            }
+                            if (result.errorCode() != null) {
+                                errorMsg = errorMsg + " (Error code: " + result.errorCode().toString() + ")";
+                            }
+                            callback.error(new Exception(errorMsg));
+                        }
+                        if (authorizationCallbackReference != null) {
+                            authorizationCallbackReference.clear();
+                            authorizationCallbackReference = null;
+                        }
+                    });
+                } catch (Exception exception) {
+                    isAuthorized = false;
+                    callback.error(exception);
                 }
             });
         } catch (Exception exception) {
@@ -107,9 +146,11 @@ public class SquareMobilePayments {
             }
 
             AuthorizationManager authManager = MobilePaymentsSdk.authorizationManager();
-            boolean authorized = authManager.getAuthorizationState().isAuthorized();
+            boolean sdkAuthorized = authManager.getAuthorizationState().isAuthorized();
 
-            IsAuthorizedResult result = new IsAuthorizedResult(authorized);
+            isAuthorized = sdkAuthorized;
+
+            IsAuthorizedResult result = new IsAuthorizedResult(sdkAuthorized);
             callback.success(result);
         } catch (Exception exception) {
             callback.error(exception);
@@ -122,10 +163,16 @@ public class SquareMobilePayments {
                 throw CustomExceptions.NOT_INITIALIZED;
             }
 
-            AuthorizationManager authManager = MobilePaymentsSdk.authorizationManager();
-            authManager.deauthorize();
-            isAuthorized = false;
-            callback.success();
+            mainHandler.post(() -> {
+                try {
+                    AuthorizationManager authManager = MobilePaymentsSdk.authorizationManager();
+                    authManager.deauthorize();
+                    isAuthorized = false;
+                    callback.success();
+                } catch (Exception exception) {
+                    callback.error(exception);
+                }
+            });
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -140,14 +187,20 @@ public class SquareMobilePayments {
                 throw CustomExceptions.NOT_AUTHORIZED;
             }
 
-            SettingsManager settingsManager = MobilePaymentsSdk.settingsManager();
-            settingsManager.showSettings(result -> {
-                if (result.isSuccess()) {
-                    callback.success();
-                } else {
-                    callback.error(new Exception(result.errorMessage()));
+            mainHandler.post(() -> {
+                try {
+                    SettingsManager settingsManager = MobilePaymentsSdk.settingsManager();
+                    settingsManager.showSettings(result -> {
+                        if (result.isSuccess()) {
+                            callback.success();
+                        } else {
+                            callback.error(new Exception(result.errorMessage()));
+                        }
+                        return null;
+                    });
+                } catch (Exception exception) {
+                    callback.error(exception);
                 }
-                return null;
             });
         } catch (Exception exception) {
             callback.error(exception);
@@ -182,31 +235,34 @@ public class SquareMobilePayments {
                 throw CustomExceptions.NOT_AUTHORIZED;
             }
 
-            ReaderManager readerManager = MobilePaymentsSdk.readerManager();
-
-            if (readerManager.isPairingInProgress()) {
-                throw CustomExceptions.PAIRING_ALREADY_IN_PROGRESS;
-            }
-
-            // Notify that pairing has begun
-            plugin.notifyReaderPairingDidBeginListeners();
+            mainHandler.post(() -> {
+                try {
+                    ReaderManager readerManager = MobilePaymentsSdk.readerManager();
+
+                    if (readerManager.isPairingInProgress()) {
+                        throw CustomExceptions.PAIRING_ALREADY_IN_PROGRESS;
+                    }
+
+                    plugin.notifyReaderPairingDidBeginListeners();
+
+                    pairingHandle = readerManager.pairReader(result -> {
+                        if (result.isSuccess()) {
+                            plugin.notifyReaderPairingDidSucceedListeners();
+                        } else {
+                            ReaderPairingDidFailEvent event = new ReaderPairingDidFailEvent(
+                                result.errorCode() != null ? result.errorCode().toString() : null,
+                                result.errorMessage()
+                            );
+                            plugin.notifyReaderPairingDidFailListeners(event);
+                        }
+                        pairingHandle = null;
+                    });
 
-            pairingHandle = readerManager.pairReader(result -> {
-                if (result.isSuccess()) {
-                    // Notify that pairing succeeded
-                    plugin.notifyReaderPairingDidSucceedListeners();
-                } else {
-                    // Notify that pairing failed
-                    ReaderPairingDidFailEvent event = new ReaderPairingDidFailEvent(
-                        result.errorCode() != null ? result.errorCode().toString() : null,
-                        result.errorMessage()
-                    );
-                    plugin.notifyReaderPairingDidFailListeners(event);
+                    callback.success();
+                } catch (Exception exception) {
+                    callback.error(exception);
                 }
-                pairingHandle = null;
             });
-
-            callback.success();
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -335,24 +391,20 @@ public class SquareMobilePayments {
 
             PaymentManager paymentManager = MobilePaymentsSdk.paymentManager();
 
-            // Build Money object
             Money amountMoney = new Money(params.getAmountMoney().getAmount(), CurrencyCode.valueOf(params.getAmountMoney().getCurrency()));
 
-            // Determine processing mode
             ProcessingMode processingMode = ProcessingMode.AUTO_DETECT;
             if (params.getProcessingMode() != null) {
                 processingMode = ProcessingMode.valueOf(params.getProcessingMode());
             }
 
-            // Determine autocomplete
             boolean autocomplete = params.getAutocomplete() != null ? params.getAutocomplete() : true;
 
-            // Build PaymentParameters
             PaymentParameters.Builder paramsBuilder = new PaymentParameters.Builder(
                 amountMoney,
                 params.getPaymentAttemptId(),
                 processingMode,
-                false // allowCardSurcharge - not supported yet
+                false
             );
 
             paramsBuilder.autocomplete(autocomplete);
@@ -393,7 +445,6 @@ public class SquareMobilePayments {
 
             PaymentParameters sdkPaymentParams = paramsBuilder.build();
 
-            // Build PromptParameters
             PromptMode promptMode = PromptMode.DEFAULT;
             if (promptParams.getMode() != null) {
                 promptMode = PromptMode.valueOf(promptParams.getMode());
@@ -406,28 +457,32 @@ public class SquareMobilePayments {
 
             PromptParameters sdkPromptParams = new PromptParameters(promptMode, additionalMethods);
 
-            // Start payment
-            paymentHandle = paymentManager.startPaymentActivity(sdkPaymentParams, sdkPromptParams, result -> {
-                if (result.isSuccess()) {
-                    Payment sdkPayment = result.value();
-                    io.capawesome.capacitorjs.plugins.squaremobilepayments.classes.results.Payment payment = convertSdkPaymentToPayment(
-                        sdkPayment
-                    );
+            mainHandler.post(() -> {
+                try {
+                    paymentHandle = paymentManager.startPaymentActivity(sdkPaymentParams, sdkPromptParams, result -> {
+                        if (result.isSuccess()) {
+                            Payment sdkPayment = result.value();
+                            io.capawesome.capacitorjs.plugins.squaremobilepayments.classes.results.Payment payment =
+                                convertSdkPaymentToPayment(sdkPayment);
+
+                            PaymentDidFinishEvent event = new PaymentDidFinishEvent(payment);
+                            plugin.notifyPaymentDidFinishListeners(event);
+                        } else {
+                            PaymentDidFailEvent event = new PaymentDidFailEvent(
+                                null,
+                                result.errorCode() != null ? result.errorCode().toString() : null,
+                                result.errorMessage()
+                            );
+                            plugin.notifyPaymentDidFailListeners(event);
+                        }
+                        paymentHandle = null;
+                    });
 
-                    PaymentDidFinishEvent event = new PaymentDidFinishEvent(payment);
-                    plugin.notifyPaymentDidFinishListeners(event);
-                } else {
-                    PaymentDidFailEvent event = new PaymentDidFailEvent(
-                        null,
-                        result.errorCode() != null ? result.errorCode().toString() : null,
-                        result.errorMessage()
-                    );
-                    plugin.notifyPaymentDidFailListeners(event);
+                    callback.success();
+                } catch (Exception exception) {
+                    callback.error(exception);
                 }
-                paymentHandle = null;
             });
-
-            callback.success();
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -439,17 +494,23 @@ public class SquareMobilePayments {
                 throw CustomExceptions.NOT_INITIALIZED;
             }
 
-            if (paymentHandle != null) {
-                paymentHandle.cancel();
-                paymentHandle = null;
+            mainHandler.post(() -> {
+                try {
+                    if (paymentHandle != null) {
+                        paymentHandle.cancel();
+                        paymentHandle = null;
 
-                PaymentDidCancelEvent event = new PaymentDidCancelEvent(null);
-                plugin.notifyPaymentDidCancelListeners(event);
-            } else {
-                throw CustomExceptions.NO_PAYMENT_IN_PROGRESS;
-            }
+                        PaymentDidCancelEvent event = new PaymentDidCancelEvent(null);
+                        plugin.notifyPaymentDidCancelListeners(event);
+                    } else {
+                        throw CustomExceptions.NO_PAYMENT_IN_PROGRESS;
+                    }
 
-            callback.success();
+                    callback.success();
+                } catch (Exception exception) {
+                    callback.error(exception);
+                }
+            });
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -483,15 +544,21 @@ public class SquareMobilePayments {
                 throw CustomExceptions.NOT_AUTHORIZED;
             }
 
-            // Show MockReader UI - only available in Debug builds with mockreader-ui dependency
-            // Use reflection to avoid compile-time dependency
-            Class<?> mockReaderUIClass = Class.forName("com.squareup.sdk.mockreader.ui.MockReaderUI");
-            mockReaderUIClass.getMethod("show").invoke(null);
-            callback.success();
-        } catch (ClassNotFoundException e) {
-            callback.error(
-                new Exception("MockReaderUI is only available in Debug builds. Please ensure you're using a Debug build configuration.")
-            );
+            mainHandler.post(() -> {
+                try {
+                    Class<?> mockReaderUIClass = Class.forName("com.squareup.sdk.mockreader.ui.MockReaderUI");
+                    mockReaderUIClass.getMethod("show").invoke(null);
+                    callback.success();
+                } catch (ClassNotFoundException e) {
+                    callback.error(
+                        new Exception(
+                            "MockReaderUI is only available in Debug builds. Please ensure you're using a Debug build configuration."
+                        )
+                    );
+                } catch (Exception exception) {
+                    callback.error(exception);
+                }
+            });
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -499,15 +566,21 @@ public class SquareMobilePayments {
 
     public void hideMockReader(@NonNull EmptyCallback callback) {
         try {
-            // Hide MockReader UI
-            // Use reflection to avoid compile-time dependency
-            Class<?> mockReaderUIClass = Class.forName("com.squareup.sdk.mockreader.ui.MockReaderUI");
-            mockReaderUIClass.getMethod("hide").invoke(null);
-            callback.success();
-        } catch (ClassNotFoundException e) {
-            callback.error(
-                new Exception("MockReaderUI is only available in Debug builds. Please ensure you're using a Debug build configuration.")
-            );
+            mainHandler.post(() -> {
+                try {
+                    Class<?> mockReaderUIClass = Class.forName("com.squareup.sdk.mockreader.ui.MockReaderUI");
+                    mockReaderUIClass.getMethod("hide").invoke(null);
+                    callback.success();
+                } catch (ClassNotFoundException e) {
+                    callback.error(
+                        new Exception(
+                            "MockReaderUI is only available in Debug builds. Please ensure you're using a Debug build configuration."
+                        )
+                    );
+                } catch (Exception exception) {
+                    callback.error(exception);
+                }
+            });
         } catch (Exception exception) {
             callback.error(exception);
         }
@@ -528,7 +601,6 @@ public class SquareMobilePayments {
                 sdkReader
             );
 
-            // Notify based on change type
             if (change == ReaderChangedEvent.Change.ADDED) {
                 ReaderWasAddedEvent addedEvent = new ReaderWasAddedEvent(reader);
                 plugin.notifyReaderWasAddedListeners(addedEvent);
@@ -537,7 +609,6 @@ public class SquareMobilePayments {
                 plugin.notifyReaderWasRemovedListeners(removedEvent);
             }
 
-            // Also notify general reader changed event
             ReaderDidChangeEvent didChangeEvent = new ReaderDidChangeEvent(reader, convertReaderChangeToString(change));
             plugin.notifyReaderDidChangeListeners(didChangeEvent);
         });
@@ -572,8 +643,6 @@ public class SquareMobilePayments {
         }
     }
 
-    // Helper methods for converting SDK types to plugin types
-
     @Nullable
     private com.squareup.sdk.mobilepayments.cardreader.ReaderInfo findReaderBySerialNumber(@NonNull String serialNumber) {
         ReaderManager readerManager = MobilePaymentsSdk.readerManager();
@@ -596,8 +665,14 @@ public class SquareMobilePayments {
         String model = convertReaderModelToString(sdkReader.getModel());
         String status = convertReaderStatusToString(sdkReader.getStatus());
         String firmwareVersion = sdkReader.getFirmwareVersion();
-        Integer batteryLevel = sdkReader.getBatteryStatus().getPercent();
-        Boolean isCharging = sdkReader.getBatteryStatus().isCharging();
+
+        Integer batteryLevel = null;
+        Boolean isCharging = null;
+        com.squareup.sdk.mobilepayments.cardreader.ReaderInfo.BatteryStatus batteryStatus = sdkReader.getBatteryStatus();
+        if (batteryStatus != null) {
+            batteryLevel = batteryStatus.getPercent();
+            isCharging = batteryStatus.isCharging();
+        }
 
         List<String> supportedCardInputMethods = sdkReader
             .getSupportedCardEntryMethods()
@@ -638,7 +713,6 @@ public class SquareMobilePayments {
             type = "ONLINE";
             status = convertPaymentStatusToString(onlinePayment.getStatus());
 
-            // Extract card details
             com.squareup.sdk.mobilepayments.payment.CardPaymentDetails sdkCardDetails = onlinePayment.getCardDetails();
             if (sdkCardDetails != null) {
                 cardDetails = convertSdkCardDetailsToCardPaymentDetails(sdkCardDetails);
@@ -649,7 +723,6 @@ public class SquareMobilePayments {
             type = "OFFLINE";
             status = "PENDING";
 
-            // Extract card details
             com.squareup.sdk.mobilepayments.payment.CardPaymentDetails sdkCardDetails = offlinePayment.getCardDetails();
             if (sdkCardDetails != null) {
                 cardDetails = convertSdkCardDetailsToCardPaymentDetails(sdkCardDetails);
@@ -664,13 +737,15 @@ public class SquareMobilePayments {
             sdkPayment.getTotalMoney().getCurrencyCode().toString()
         );
 
-        MoneyResult tipMoney = sdkPayment.getTipMoney() != null
-            ? new MoneyResult((int) sdkPayment.getTipMoney().getAmount(), sdkPayment.getTipMoney().getCurrencyCode().toString())
-            : null;
+        MoneyResult tipMoney =
+            sdkPayment.getTipMoney() != null
+                ? new MoneyResult((int) sdkPayment.getTipMoney().getAmount(), sdkPayment.getTipMoney().getCurrencyCode().toString())
+                : null;
 
-        MoneyResult applicationFee = sdkPayment.getAppFeeMoney() != null
-            ? new MoneyResult((int) sdkPayment.getAppFeeMoney().getAmount(), sdkPayment.getAppFeeMoney().getCurrencyCode().toString())
-            : null;
+        MoneyResult applicationFee =
+            sdkPayment.getAppFeeMoney() != null
+                ? new MoneyResult((int) sdkPayment.getAppFeeMoney().getAmount(), sdkPayment.getAppFeeMoney().getCurrencyCode().toString())
+                : null;
 
         return new io.capawesome.capacitorjs.plugins.squaremobilepayments.classes.results.Payment(
             id,
@@ -770,7 +845,6 @@ public class SquareMobilePayments {
         } else if (change == ReaderChangedEvent.Change.REMOVED) {
             return "REMOVED";
         }
-        // Default for any other status changes
         return "STATUS_DID_CHANGE";
     }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capawesome/capacitor-square-mobile-payments",
-  "version": "0.1.4",
-  "description": "Unofficial Capacitor plugin for Square Mobile Payments SDK.",
+  "version": "0.1.6",
+  "description": "Unofficial Capacitor plugin for Square Mobile Payments SDK to accept in-person payments on Android and iOS.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",
@@ -36,7 +36,16 @@
   "keywords": [
     "capacitor",
     "plugin",
-    "native"
+    "native",
+    "capacitor-plugin",
+    "square",
+    "mobile payments",
+    "in-person payments",
+    "card reader",
+    "point of sale",
+    "pos",
+    "tap to pay",
+    "payment processing"
   ],
   "scripts": {
     "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
@@ -58,24 +67,21 @@
   },
   "devDependencies": {
     "@capacitor/android": "8.0.0",
-    "@capacitor/cli": "8.0.0",
+    "@capacitor/cli": "8.4.2",
     "@capacitor/core": "8.0.0",
     "@capacitor/docgen": "0.3.1",
     "@capacitor/ios": "8.0.0",
     "@ionic/eslint-config": "0.4.0",
-    "@ionic/swiftlint-config": "2.0.0",
     "eslint": "8.57.0",
-    "prettier": "3.4.2",
-    "prettier-plugin-java": "2.6.7",
+    "prettier-plugin-java": "2.9.7",
     "rimraf": "6.1.2",
-    "rollup": "4.53.3",
+    "rollup": "4.62.3",
     "swiftlint": "2.0.0",
     "typescript": "5.9.3"
   },
   "peerDependencies": {
     "@capacitor/core": ">=8.0.0"
   },
-  "swiftlint": "@ionic/swiftlint-config",
   "eslintConfig": {
     "extends": "@ionic/eslint-config/recommended"
   },