@capgo/capacitor-watch 8.0.25 → 8.1.1

package/README.md

@@ -509,8 +509,12 @@ struct StatusView: View {
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-Apple Watch communication plugin for Capacitor.
-Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.
+Watch / Wear OS communication plugin for Capacitor.
+Provides bidirectional messaging between the phone and a paired watch.
+
+- **iOS**: uses Apple WatchConnectivity framework to communicate with Apple Watch.
+- **Android**: uses Google Wear OS Data Layer API (play-services-wearable) to communicate with a Wear OS watch.
+- **Web**: not supported; all methods throw or return safe defaults.
 
 ### sendMessage(...)
 
@@ -792,15 +796,15 @@ Options for replying to a message from the watch.
 
 #### WatchInfo
 
-Information about Watch connectivity status.
+Information about Watch / Wear OS connectivity status.
 
-| Prop                      | Type                 | Description                                                                                    |
-| ------------------------- | -------------------- | ---------------------------------------------------------------------------------------------- |
-| **`isSupported`**         | <code>boolean</code> | Whether WatchConnectivity is supported on this device. Always false on iPad, web, and Android. |
-| **`isPaired`**            | <code>boolean</code> | Whether an Apple Watch is paired with this iPhone.                                             |
-| **`isWatchAppInstalled`** | <code>boolean</code> | Whether the paired watch has the companion app installed.                                      |
-| **`isReachable`**         | <code>boolean</code> | Whether the watch is currently reachable for immediate messaging.                              |
-| **`activationState`**     | <code>number</code>  | The current activation state of the WCSession. 0 = notActivated, 1 = inactive, 2 = activated   |
+| Prop                      | Type                 | Description                                                                                                                                                                                                                                                   |
+| ------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`isSupported`**         | <code>boolean</code> | Whether the watch communication API is supported on this device. - iOS: false on iPad; true on iPhone when WatchConnectivity is available. - Android: true when Google Play Services with Wear OS support is available; false otherwise. - Web: always false. |
+| **`isPaired`**            | <code>boolean</code> | Whether a watch is currently paired/connected. - iOS: whether an Apple Watch is paired with this iPhone. - Android: whether at least one Wear OS node is currently connected.                                                                                 |
+| **`isWatchAppInstalled`** | <code>boolean</code> | Whether the watch companion app is installed. - iOS: whether the paired Apple Watch has the companion app installed. - Android: whether at least one connected Wear OS node is reachable (used as a proxy).                                                   |
+| **`isReachable`**         | <code>boolean</code> | Whether the watch is currently reachable for immediate messaging.                                                                                                                                                                                             |
+| **`activationState`**     | <code>number</code>  | The current session activation state. - iOS: 0 = notActivated, 1 = inactive, 2 = activated (WCSessionActivationState). - Android: 2 when a Wear OS node is connected, 0 otherwise.                                                                            |
 
 
 #### PluginListenerHandle

package/android/build.gradle

@@ -52,6 +52,7 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "com.google.android.gms:play-services-wearable:18.1.0"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/java/app/capgo/capacitor/watch/CapgoWatchPlugin.java

@@ -1,61 +1,357 @@
 package app.capgo.capacitor.watch;
 
+import android.net.Uri;
+import android.util.Log;
 import com.getcapacitor.JSObject;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.google.android.gms.tasks.Tasks;
+import com.google.android.gms.wearable.CapabilityClient;
+import com.google.android.gms.wearable.CapabilityInfo;
+import com.google.android.gms.wearable.DataClient;
+import com.google.android.gms.wearable.DataEvent;
+import com.google.android.gms.wearable.DataEventBuffer;
+import com.google.android.gms.wearable.DataItem;
+import com.google.android.gms.wearable.DataMap;
+import com.google.android.gms.wearable.DataMapItem;
+import com.google.android.gms.wearable.MessageClient;
+import com.google.android.gms.wearable.MessageEvent;
+import com.google.android.gms.wearable.Node;
+import com.google.android.gms.wearable.PutDataMapRequest;
+import com.google.android.gms.wearable.Wearable;
+import java.nio.charset.StandardCharsets;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import org.json.JSONException;
+import org.json.JSONObject;
 
 /**
- * Apple Watch communication plugin for Capacitor.
- * This plugin only works on iOS - Android implementation provides stub methods
- * that return appropriate error messages.
+ * Wear OS communication plugin for Capacitor.
+ * Provides bidirectional messaging between Android phone and Wear OS watch
+ * using the Wear OS Data Layer API (play-services-wearable).
+ *
+ * <p>Message paths used over the Data Layer:</p>
+ * <ul>
+ *   <li>{@code /capgo/message} — regular one-way messages</li>
+ *   <li>{@code /capgo/message/withreply} — messages that expect a reply</li>
+ *   <li>{@code /capgo/reply/{callbackId}} — reply to a watch-initiated message</li>
+ *   <li>{@code /capgo/context} — application context sync via DataItem</li>
+ *   <li>{@code /capgo/userinfo/{uuid}} — queued user-info transfer via DataItem</li>
+ * </ul>
  */
 @CapacitorPlugin(name = "CapgoWatch")
 public class CapgoWatchPlugin extends Plugin {
 
-    private final String pluginVersion = "8.0.25";
-    private static final String NOT_SUPPORTED_MSG = "Apple Watch is only supported on iOS";
+    private static final String TAG = "CapgoWatchPlugin";
+    private static final String PLUGIN_VERSION = "8.0.25";
+
+    /** Capability advertised by the companion Wear OS app. */
+    static final String WATCH_APP_CAPABILITY = "capgo_watch";
+
+    /** Path for regular messages sent/received via MessageClient. */
+    static final String PATH_MESSAGE = "/capgo/message";
+    /** Path prefix for messages that require a reply. */
+    static final String PATH_MESSAGE_WITH_REPLY = "/capgo/message/withreply";
+    /** Path prefix for reply messages sent back to the watch. */
+    static final String PATH_REPLY = "/capgo/reply/";
+    /** DataItem path for application context sync. */
+    static final String PATH_CONTEXT = "/capgo/context";
+    /** DataItem path prefix for user info transfers. */
+    static final String PATH_USER_INFO = "/capgo/userinfo/";
+
+    /** Pending reply callbacks expire after 5 minutes. */
+    private static final long PENDING_REPLY_TTL_MS = 5 * 60 * 1000L;
+
+    /** Maps callbackId to pending reply metadata. */
+    private final Map<String, PendingReply> pendingReplies = new ConcurrentHashMap<>();
+
+    /** Shared thread pool for all background Wear OS operations. */
+    private final ExecutorService executor = Executors.newCachedThreadPool();
+
+    private MessageClient messageClient;
+    private DataClient dataClient;
+
+    private final MessageClient.OnMessageReceivedListener messageListener = this::handleMessageReceived;
+    private final DataClient.OnDataChangedListener dataListener = this::handleDataChanged;
+
+    private static final class PendingReply {
+
+        final String nodeId;
+        final long createdAt;
+
+        PendingReply(final String nodeId, final long createdAt) {
+            this.nodeId = nodeId;
+            this.createdAt = createdAt;
+        }
+    }
+
+    @Override
+    public void load() {
+        messageClient = Wearable.getMessageClient(getContext());
+        dataClient = Wearable.getDataClient(getContext());
+        messageClient.addListener(messageListener).addOnFailureListener((e) -> Log.e(TAG, "Failed to register message listener", e));
+        dataClient.addListener(dataListener).addOnFailureListener((e) -> Log.e(TAG, "Failed to register data listener", e));
+    }
+
+    @Override
+    protected void handleOnDestroy() {
+        if (messageClient != null) {
+            messageClient.removeListener(messageListener);
+        }
+        if (dataClient != null) {
+            dataClient.removeListener(dataListener);
+        }
+        executor.shutdown();
+    }
+
+    private void expirePendingReplies() {
+        final long now = System.currentTimeMillis();
+        final Iterator<Map.Entry<String, PendingReply>> iterator = pendingReplies.entrySet().iterator();
+        while (iterator.hasNext()) {
+            final Map.Entry<String, PendingReply> entry = iterator.next();
+            if (now - entry.getValue().createdAt > PENDING_REPLY_TTL_MS) {
+                iterator.remove();
+            }
+        }
+    }
+
+    // ── Incoming message / data handlers ─────────────────────────────────────
+
+    private void handleMessageReceived(MessageEvent event) {
+        final String path = event.getPath();
+        if (!PATH_MESSAGE.equals(path) && !PATH_MESSAGE_WITH_REPLY.equals(path)) {
+            return;
+        }
+
+        expirePendingReplies();
+
+        final String nodeId = event.getSourceNodeId();
+        final String payload = new String(event.getData(), StandardCharsets.UTF_8);
+
+        try {
+            final JSONObject json = new JSONObject(payload);
+            final JSObject messageData = new JSObject(json.toString());
+
+            if (PATH_MESSAGE_WITH_REPLY.equals(path)) {
+                final String callbackId = UUID.randomUUID().toString();
+                pendingReplies.put(callbackId, new PendingReply(nodeId, System.currentTimeMillis()));
+
+                final JSObject evt = new JSObject();
+                evt.put("message", messageData);
+                evt.put("callbackId", callbackId);
+                notifyListeners("messageReceivedWithReply", evt);
+            } else {
+                final JSObject evt = new JSObject();
+                evt.put("message", messageData);
+                notifyListeners("messageReceived", evt);
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, "Error parsing received message", e);
+        }
+    }
+
+    private void handleDataChanged(DataEventBuffer dataEvents) {
+        for (DataEvent event : dataEvents) {
+            if (event.getType() != DataEvent.TYPE_CHANGED) {
+                continue;
+            }
+
+            final DataItem item = event.getDataItem();
+            final String path = item.getUri().getPath();
+            if (path == null) {
+                continue;
+            }
+
+            final boolean isContext = PATH_CONTEXT.equals(path);
+            final boolean isUserInfo = path.startsWith(PATH_USER_INFO);
+            if (!isContext && !isUserInfo) {
+                continue;
+            }
+
+            try {
+                final DataMap dataMap = DataMapItem.fromDataItem(item).getDataMap();
+                final String payload = dataMap.getString("payload", "{}");
+                final JSONObject json = new JSONObject(payload);
+                final JSObject data = new JSObject(json.toString());
+
+                if (isContext) {
+                    final JSObject evt = new JSObject();
+                    evt.put("context", data);
+                    notifyListeners("applicationContextReceived", evt);
+                } else {
+                    final JSObject evt = new JSObject();
+                    evt.put("userInfo", data);
+                    notifyListeners("userInfoReceived", evt);
+                    deleteDataItem(item.getUri());
+                }
+            } catch (Exception e) {
+                Log.e(TAG, "Error processing data change", e);
+            }
+        }
+    }
+
+    private void deleteDataItem(final Uri uri) {
+        if (dataClient == null) {
+            return;
+        }
+        dataClient.deleteDataItems(uri).addOnFailureListener((e) -> Log.w(TAG, "Failed to delete delivered user info DataItem", e));
+    }
+
+    // ── Plugin methods ────────────────────────────────────────────────────────
 
     @PluginMethod
     public void sendMessage(final PluginCall call) {
-        call.reject(NOT_SUPPORTED_MSG);
+        final JSObject data = call.getObject("data");
+        if (data == null) {
+            call.reject("Missing required parameter: 'data'");
+            return;
+        }
+
+        final byte[] payload = data.toString().getBytes(StandardCharsets.UTF_8);
+        executor.execute(() -> {
+            try {
+                final List<Node> nodes = Tasks.await(Wearable.getNodeClient(getContext()).getConnectedNodes());
+                if (nodes.isEmpty()) {
+                    call.reject("No connected Wear OS devices found");
+                    return;
+                }
+                for (final Node node : nodes) {
+                    Tasks.await(messageClient.sendMessage(node.getId(), PATH_MESSAGE, payload));
+                }
+                call.resolve();
+            } catch (ExecutionException | InterruptedException e) {
+                call.reject("Failed to send message: " + e.getMessage(), e);
+            }
+        });
     }
 
     @PluginMethod
     public void updateApplicationContext(final PluginCall call) {
-        call.reject(NOT_SUPPORTED_MSG);
+        final JSObject context = call.getObject("context");
+        if (context == null) {
+            call.reject("Missing required parameter: 'context'");
+            return;
+        }
+
+        executor.execute(() -> {
+            try {
+                final PutDataMapRequest request = PutDataMapRequest.create(PATH_CONTEXT);
+                request.getDataMap().putString("payload", context.toString());
+                request.setUrgent();
+                Tasks.await(dataClient.putDataItem(request.asPutDataRequest()));
+                call.resolve();
+            } catch (ExecutionException | InterruptedException e) {
+                call.reject("Failed to update application context: " + e.getMessage(), e);
+            }
+        });
     }
 
     @PluginMethod
     public void transferUserInfo(final PluginCall call) {
-        call.reject(NOT_SUPPORTED_MSG);
+        final JSObject userInfo = call.getObject("userInfo");
+        if (userInfo == null) {
+            call.reject("Missing required parameter: 'userInfo'");
+            return;
+        }
+
+        final String path = PATH_USER_INFO + UUID.randomUUID();
+        executor.execute(() -> {
+            try {
+                final PutDataMapRequest request = PutDataMapRequest.create(path);
+                request.getDataMap().putString("payload", userInfo.toString());
+                request.setUrgent();
+                Tasks.await(dataClient.putDataItem(request.asPutDataRequest()));
+                call.resolve();
+            } catch (ExecutionException | InterruptedException e) {
+                call.reject("Failed to transfer user info: " + e.getMessage(), e);
+            }
+        });
     }
 
     @PluginMethod
     public void replyToMessage(final PluginCall call) {
-        call.reject(NOT_SUPPORTED_MSG);
+        final String callbackId = call.getString("callbackId");
+        final JSObject data = call.getObject("data");
+
+        if (callbackId == null || callbackId.isEmpty()) {
+            call.reject("Missing required parameter: 'callbackId'");
+            return;
+        }
+        if (data == null) {
+            call.reject("Missing required parameter: 'data'");
+            return;
+        }
+
+        expirePendingReplies();
+
+        final PendingReply pendingReply = pendingReplies.get(callbackId);
+        if (pendingReply == null) {
+            call.reject("No pending reply found for callbackId: " + callbackId);
+            return;
+        }
+        if (System.currentTimeMillis() - pendingReply.createdAt > PENDING_REPLY_TTL_MS) {
+            pendingReplies.remove(callbackId);
+            call.reject("Pending reply expired for callbackId: " + callbackId);
+            return;
+        }
+
+        final String nodeId = pendingReply.nodeId;
+        final byte[] payload = data.toString().getBytes(StandardCharsets.UTF_8);
+        final String replyPath = PATH_REPLY + callbackId;
+        executor.execute(() -> {
+            try {
+                Tasks.await(messageClient.sendMessage(nodeId, replyPath, payload));
+                pendingReplies.remove(callbackId);
+                call.resolve();
+            } catch (ExecutionException | InterruptedException e) {
+                call.reject("Failed to send reply: " + e.getMessage(), e);
+            }
+        });
     }
 
     @PluginMethod
     public void getInfo(final PluginCall call) {
-        final JSObject ret = new JSObject();
-        ret.put("isSupported", false);
-        ret.put("isPaired", false);
-        ret.put("isWatchAppInstalled", false);
-        ret.put("isReachable", false);
-        ret.put("activationState", 0);
-        call.resolve(ret);
+        executor.execute(() -> {
+            try {
+                final List<Node> nodes = Tasks.await(Wearable.getNodeClient(getContext()).getConnectedNodes());
+                final boolean isReachable = !nodes.isEmpty();
+                final CapabilityClient capabilityClient = Wearable.getCapabilityClient(getContext());
+                final CapabilityInfo capabilityInfo = Tasks.await(
+                    capabilityClient.getCapability(WATCH_APP_CAPABILITY, CapabilityClient.FILTER_ALL)
+                );
+                final boolean isWatchAppInstalled = !capabilityInfo.getNodes().isEmpty();
+                final JSObject ret = new JSObject();
+                ret.put("isSupported", true);
+                ret.put("isPaired", isReachable);
+                ret.put("isWatchAppInstalled", isWatchAppInstalled);
+                ret.put("isReachable", isReachable);
+                ret.put("activationState", isReachable ? 2 : 0);
+                call.resolve(ret);
+            } catch (ExecutionException | InterruptedException e) {
+                // Wear OS API unavailable (e.g. Google Play Services missing)
+                final JSObject ret = new JSObject();
+                ret.put("isSupported", false);
+                ret.put("isPaired", false);
+                ret.put("isWatchAppInstalled", false);
+                ret.put("isReachable", false);
+                ret.put("activationState", 0);
+                call.resolve(ret);
+            }
+        });
     }
 
     @PluginMethod
     public void getPluginVersion(final PluginCall call) {
-        try {
-            final JSObject ret = new JSObject();
-            ret.put("version", this.pluginVersion);
-            call.resolve(ret);
-        } catch (final Exception e) {
-            call.reject("Could not get plugin version", e);
-        }
+        final JSObject ret = new JSObject();
+        ret.put("version", PLUGIN_VERSION);
+        call.resolve(ret);
     }
 }

package/dist/docs.json

@@ -2,7 +2,7 @@
   "api": {
     "name": "CapgoWatchPlugin",
     "slug": "capgowatchplugin",
-    "docs": "Apple Watch communication plugin for Capacitor.\nProvides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.",
+    "docs": "Watch / Wear OS communication plugin for Capacitor.\nProvides bidirectional messaging between the phone and a paired watch.\n\n- **iOS**: uses Apple WatchConnectivity framework to communicate with Apple Watch.\n- **Android**: uses Google Wear OS Data Layer API (play-services-wearable) to communicate with a Wear OS watch.\n- **Web**: not supported; all methods throw or return safe defaults.",
     "tags": [
       {
         "text": "8.0.0",
@@ -609,7 +609,7 @@
     {
       "name": "WatchInfo",
       "slug": "watchinfo",
-      "docs": "Information about Watch connectivity status.",
+      "docs": "Information about Watch / Wear OS connectivity status.",
       "tags": [
         {
           "text": "8.0.0",
@@ -621,21 +621,21 @@
         {
           "name": "isSupported",
           "tags": [],
-          "docs": "Whether WatchConnectivity is supported on this device.\nAlways false on iPad, web, and Android.",
+          "docs": "Whether the watch communication API is supported on this device.\n- iOS: false on iPad; true on iPhone when WatchConnectivity is available.\n- Android: true when Google Play Services with Wear OS support is available; false otherwise.\n- Web: always false.",
           "complexTypes": [],
           "type": "boolean"
         },
         {
           "name": "isPaired",
           "tags": [],
-          "docs": "Whether an Apple Watch is paired with this iPhone.",
+          "docs": "Whether a watch is currently paired/connected.\n- iOS: whether an Apple Watch is paired with this iPhone.\n- Android: whether at least one Wear OS node is currently connected.",
           "complexTypes": [],
           "type": "boolean"
         },
         {
           "name": "isWatchAppInstalled",
           "tags": [],
-          "docs": "Whether the paired watch has the companion app installed.",
+          "docs": "Whether the watch companion app is installed.\n- iOS: whether the paired Apple Watch has the companion app installed.\n- Android: whether at least one connected Wear OS node is reachable (used as a proxy).",
           "complexTypes": [],
           "type": "boolean"
         },
@@ -649,7 +649,7 @@
         {
           "name": "activationState",
           "tags": [],
-          "docs": "The current activation state of the WCSession.\n0 = notActivated, 1 = inactive, 2 = activated",
+          "docs": "The current session activation state.\n- iOS: 0 = notActivated, 1 = inactive, 2 = activated (WCSessionActivationState).\n- Android: 2 when a Wear OS node is connected, 0 otherwise.",
           "complexTypes": [],
           "type": "number"
         }

package/dist/esm/definitions.d.ts

@@ -58,22 +58,28 @@ export interface ReplyMessageOptions {
     data: WatchMessageData;
 }
 /**
- * Information about Watch connectivity status.
+ * Information about Watch / Wear OS connectivity status.
  *
  * @since 8.0.0
  */
 export interface WatchInfo {
     /**
-     * Whether WatchConnectivity is supported on this device.
-     * Always false on iPad, web, and Android.
+     * Whether the watch communication API is supported on this device.
+     * - iOS: false on iPad; true on iPhone when WatchConnectivity is available.
+     * - Android: true when Google Play Services with Wear OS support is available; false otherwise.
+     * - Web: always false.
      */
     isSupported: boolean;
     /**
-     * Whether an Apple Watch is paired with this iPhone.
+     * Whether a watch is currently paired/connected.
+     * - iOS: whether an Apple Watch is paired with this iPhone.
+     * - Android: whether at least one Wear OS node is currently connected.
      */
     isPaired: boolean;
     /**
-     * Whether the paired watch has the companion app installed.
+     * Whether the watch companion app is installed.
+     * - iOS: whether the paired Apple Watch has the companion app installed.
+     * - Android: whether at least one connected Wear OS node is reachable (used as a proxy).
      */
     isWatchAppInstalled: boolean;
     /**
@@ -81,8 +87,9 @@ export interface WatchInfo {
      */
     isReachable: boolean;
     /**
-     * The current activation state of the WCSession.
-     * 0 = notActivated, 1 = inactive, 2 = activated
+     * The current session activation state.
+     * - iOS: 0 = notActivated, 1 = inactive, 2 = activated (WCSessionActivationState).
+     * - Android: 2 when a Wear OS node is connected, 0 otherwise.
      */
     activationState: number;
 }
@@ -158,8 +165,12 @@ export interface ActivationStateChangedEvent {
     state: number;
 }
 /**
- * Apple Watch communication plugin for Capacitor.
- * Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.
+ * Watch / Wear OS communication plugin for Capacitor.
+ * Provides bidirectional messaging between the phone and a paired watch.
+ *
+ * - **iOS**: uses Apple WatchConnectivity framework to communicate with Apple Watch.
+ * - **Android**: uses Google Wear OS Data Layer API (play-services-wearable) to communicate with a Wear OS watch.
+ * - **Web**: not supported; all methods throw or return safe defaults.
  *
  * @since 8.0.0
  */

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Data that can be sent between iPhone and Apple Watch.\n * Values must be serializable (string, number, boolean, arrays, or nested objects).\n *\n * @since 8.0.0\n */\nexport type WatchMessageData = Record<string, unknown>;\n\n/**\n * Options for sending a message to the watch.\n *\n * @since 8.0.0\n */\nexport interface SendMessageOptions {\n  /**\n   * The data to send to the watch.\n   * Must be serializable (string, number, boolean, arrays, or nested objects).\n   */\n  data: WatchMessageData;\n}\n\n/**\n * Options for updating the application context.\n *\n * @since 8.0.0\n */\nexport interface UpdateContextOptions {\n  /**\n   * The context data to sync with the watch.\n   * Only the latest context is kept - previous values are overwritten.\n   */\n  context: WatchMessageData;\n}\n\n/**\n * Options for transferring user info.\n *\n * @since 8.0.0\n */\nexport interface TransferUserInfoOptions {\n  /**\n   * The user info data to transfer.\n   * Transfers are queued and delivered in order.\n   */\n  userInfo: WatchMessageData;\n}\n\n/**\n * Options for replying to a message from the watch.\n *\n * @since 8.0.0\n */\nexport interface ReplyMessageOptions {\n  /**\n   * The callback ID received in the messageReceivedWithReply event.\n   */\n  callbackId: string;\n  /**\n   * The reply data to send back to the watch.\n   */\n  data: WatchMessageData;\n}\n\n/**\n * Information about Watch connectivity status.\n *\n * @since 8.0.0\n */\nexport interface WatchInfo {\n  /**\n   * Whether WatchConnectivity is supported on this device.\n   * Always false on iPad, web, and Android.\n   */\n  isSupported: boolean;\n  /**\n   * Whether an Apple Watch is paired with this iPhone.\n   */\n  isPaired: boolean;\n  /**\n   * Whether the paired watch has the companion app installed.\n   */\n  isWatchAppInstalled: boolean;\n  /**\n   * Whether the watch is currently reachable for immediate messaging.\n   */\n  isReachable: boolean;\n  /**\n   * The current activation state of the WCSession.\n   * 0 = notActivated, 1 = inactive, 2 = activated\n   */\n  activationState: number;\n}\n\n/**\n * Event data for received messages.\n *\n * @since 8.0.0\n */\nexport interface MessageReceivedEvent {\n  /**\n   * The message data received from the watch.\n   */\n  message: WatchMessageData;\n}\n\n/**\n * Event data for messages that require a reply.\n *\n * @since 8.0.0\n */\nexport interface MessageReceivedWithReplyEvent {\n  /**\n   * The message data received from the watch.\n   */\n  message: WatchMessageData;\n  /**\n   * The callback ID to use when replying with replyToMessage().\n   */\n  callbackId: string;\n}\n\n/**\n * Event data for application context updates.\n *\n * @since 8.0.0\n */\nexport interface ContextReceivedEvent {\n  /**\n   * The context data received from the watch.\n   */\n  context: WatchMessageData;\n}\n\n/**\n * Event data for user info transfers.\n *\n * @since 8.0.0\n */\nexport interface UserInfoReceivedEvent {\n  /**\n   * The user info data received from the watch.\n   */\n  userInfo: WatchMessageData;\n}\n\n/**\n * Event data for reachability changes.\n *\n * @since 8.0.0\n */\nexport interface ReachabilityChangedEvent {\n  /**\n   * Whether the watch is now reachable.\n   */\n  isReachable: boolean;\n}\n\n/**\n * Event data for activation state changes.\n *\n * @since 8.0.0\n */\nexport interface ActivationStateChangedEvent {\n  /**\n   * The new activation state.\n   * 0 = notActivated, 1 = inactive, 2 = activated\n   */\n  state: number;\n}\n\n/**\n * Apple Watch communication plugin for Capacitor.\n * Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.\n *\n * @since 8.0.0\n */\nexport interface CapgoWatchPlugin {\n  /**\n   * Send an interactive message to the watch.\n   * The watch must be reachable for this to succeed.\n   * Use this for time-sensitive, interactive communication.\n   *\n   * @param options - The message options\n   * @returns Promise that resolves when the message is sent\n   * @throws Error if the watch is not reachable or session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.sendMessage({\n   *   data: { action: 'refresh', timestamp: Date.now() }\n   * });\n   * ```\n   */\n  sendMessage(options: SendMessageOptions): Promise<void>;\n\n  /**\n   * Update the application context shared with the watch.\n   * Only the latest context is kept - this overwrites any previous context.\n   * Use this for syncing app state that the watch needs to display.\n   *\n   * @param options - The context options\n   * @returns Promise that resolves when the context is updated\n   * @throws Error if session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.updateApplicationContext({\n   *   context: { theme: 'dark', lastSync: Date.now() }\n   * });\n   * ```\n   */\n  updateApplicationContext(options: UpdateContextOptions): Promise<void>;\n\n  /**\n   * Transfer user info to the watch.\n   * Transfers are queued and delivered in order, even if the watch is not currently reachable.\n   * Use this for important data that must be delivered reliably.\n   *\n   * @param options - The user info options\n   * @returns Promise that resolves when the transfer is queued\n   * @throws Error if session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.transferUserInfo({\n   *   userInfo: { recordId: '123', action: 'created' }\n   * });\n   * ```\n   */\n  transferUserInfo(options: TransferUserInfoOptions): Promise<void>;\n\n  /**\n   * Reply to a message from the watch that requested a reply.\n   * Use this in response to the messageReceivedWithReply event.\n   *\n   * @param options - The reply options including the callbackId\n   * @returns Promise that resolves when the reply is sent\n   * @throws Error if the callback ID is invalid or session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * CapgoWatch.addListener('messageReceivedWithReply', async (event) => {\n   *   const result = await processRequest(event.message);\n   *   await CapgoWatch.replyToMessage({\n   *     callbackId: event.callbackId,\n   *     data: { result }\n   *   });\n   * });\n   * ```\n   */\n  replyToMessage(options: ReplyMessageOptions): Promise<void>;\n\n  /**\n   * Get information about the watch connectivity status.\n   *\n   * @returns Promise that resolves with watch connectivity info\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const info = await CapgoWatch.getInfo();\n   * if (info.isReachable) {\n   *   await CapgoWatch.sendMessage({ data: { ping: true } });\n   * }\n   * ```\n   */\n  getInfo(): Promise<WatchInfo>;\n\n  /**\n   * Get the native Capacitor plugin version.\n   *\n   * @returns Promise that resolves with the plugin version\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const { version } = await CapgoWatch.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Listen for messages received from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const handle = await CapgoWatch.addListener('messageReceived', (event) => {\n   *   console.log('Message from watch:', event.message);\n   * });\n   * // Later: handle.remove();\n   * ```\n   */\n  addListener(\n    eventName: 'messageReceived',\n    listenerFunc: (event: MessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for messages from the watch that require a reply.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('messageReceivedWithReply', async (event) => {\n   *   const response = await handleRequest(event.message);\n   *   await CapgoWatch.replyToMessage({\n   *     callbackId: event.callbackId,\n   *     data: response\n   *   });\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'messageReceivedWithReply',\n    listenerFunc: (event: MessageReceivedWithReplyEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for application context updates from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('applicationContextReceived', (event) => {\n   *   console.log('Context from watch:', event.context);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'applicationContextReceived',\n    listenerFunc: (event: ContextReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for user info transfers from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('userInfoReceived', (event) => {\n   *   console.log('User info from watch:', event.userInfo);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'userInfoReceived',\n    listenerFunc: (event: UserInfoReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for watch reachability changes.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('reachabilityChanged', (event) => {\n   *   console.log('Watch reachable:', event.isReachable);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'reachabilityChanged',\n    listenerFunc: (event: ReachabilityChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for session activation state changes.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('activationStateChanged', (event) => {\n   *   console.log('Activation state:', event.state);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'activationStateChanged',\n    listenerFunc: (event: ActivationStateChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.removeAllListeners();\n   * ```\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Data that can be sent between iPhone and Apple Watch.\n * Values must be serializable (string, number, boolean, arrays, or nested objects).\n *\n * @since 8.0.0\n */\nexport type WatchMessageData = Record<string, unknown>;\n\n/**\n * Options for sending a message to the watch.\n *\n * @since 8.0.0\n */\nexport interface SendMessageOptions {\n  /**\n   * The data to send to the watch.\n   * Must be serializable (string, number, boolean, arrays, or nested objects).\n   */\n  data: WatchMessageData;\n}\n\n/**\n * Options for updating the application context.\n *\n * @since 8.0.0\n */\nexport interface UpdateContextOptions {\n  /**\n   * The context data to sync with the watch.\n   * Only the latest context is kept - previous values are overwritten.\n   */\n  context: WatchMessageData;\n}\n\n/**\n * Options for transferring user info.\n *\n * @since 8.0.0\n */\nexport interface TransferUserInfoOptions {\n  /**\n   * The user info data to transfer.\n   * Transfers are queued and delivered in order.\n   */\n  userInfo: WatchMessageData;\n}\n\n/**\n * Options for replying to a message from the watch.\n *\n * @since 8.0.0\n */\nexport interface ReplyMessageOptions {\n  /**\n   * The callback ID received in the messageReceivedWithReply event.\n   */\n  callbackId: string;\n  /**\n   * The reply data to send back to the watch.\n   */\n  data: WatchMessageData;\n}\n\n/**\n * Information about Watch / Wear OS connectivity status.\n *\n * @since 8.0.0\n */\nexport interface WatchInfo {\n  /**\n   * Whether the watch communication API is supported on this device.\n   * - iOS: false on iPad; true on iPhone when WatchConnectivity is available.\n   * - Android: true when Google Play Services with Wear OS support is available; false otherwise.\n   * - Web: always false.\n   */\n  isSupported: boolean;\n  /**\n   * Whether a watch is currently paired/connected.\n   * - iOS: whether an Apple Watch is paired with this iPhone.\n   * - Android: whether at least one Wear OS node is currently connected.\n   */\n  isPaired: boolean;\n  /**\n   * Whether the watch companion app is installed.\n   * - iOS: whether the paired Apple Watch has the companion app installed.\n   * - Android: whether at least one connected Wear OS node is reachable (used as a proxy).\n   */\n  isWatchAppInstalled: boolean;\n  /**\n   * Whether the watch is currently reachable for immediate messaging.\n   */\n  isReachable: boolean;\n  /**\n   * The current session activation state.\n   * - iOS: 0 = notActivated, 1 = inactive, 2 = activated (WCSessionActivationState).\n   * - Android: 2 when a Wear OS node is connected, 0 otherwise.\n   */\n  activationState: number;\n}\n\n/**\n * Event data for received messages.\n *\n * @since 8.0.0\n */\nexport interface MessageReceivedEvent {\n  /**\n   * The message data received from the watch.\n   */\n  message: WatchMessageData;\n}\n\n/**\n * Event data for messages that require a reply.\n *\n * @since 8.0.0\n */\nexport interface MessageReceivedWithReplyEvent {\n  /**\n   * The message data received from the watch.\n   */\n  message: WatchMessageData;\n  /**\n   * The callback ID to use when replying with replyToMessage().\n   */\n  callbackId: string;\n}\n\n/**\n * Event data for application context updates.\n *\n * @since 8.0.0\n */\nexport interface ContextReceivedEvent {\n  /**\n   * The context data received from the watch.\n   */\n  context: WatchMessageData;\n}\n\n/**\n * Event data for user info transfers.\n *\n * @since 8.0.0\n */\nexport interface UserInfoReceivedEvent {\n  /**\n   * The user info data received from the watch.\n   */\n  userInfo: WatchMessageData;\n}\n\n/**\n * Event data for reachability changes.\n *\n * @since 8.0.0\n */\nexport interface ReachabilityChangedEvent {\n  /**\n   * Whether the watch is now reachable.\n   */\n  isReachable: boolean;\n}\n\n/**\n * Event data for activation state changes.\n *\n * @since 8.0.0\n */\nexport interface ActivationStateChangedEvent {\n  /**\n   * The new activation state.\n   * 0 = notActivated, 1 = inactive, 2 = activated\n   */\n  state: number;\n}\n\n/**\n * Watch / Wear OS communication plugin for Capacitor.\n * Provides bidirectional messaging between the phone and a paired watch.\n *\n * - **iOS**: uses Apple WatchConnectivity framework to communicate with Apple Watch.\n * - **Android**: uses Google Wear OS Data Layer API (play-services-wearable) to communicate with a Wear OS watch.\n * - **Web**: not supported; all methods throw or return safe defaults.\n *\n * @since 8.0.0\n */\nexport interface CapgoWatchPlugin {\n  /**\n   * Send an interactive message to the watch.\n   * The watch must be reachable for this to succeed.\n   * Use this for time-sensitive, interactive communication.\n   *\n   * @param options - The message options\n   * @returns Promise that resolves when the message is sent\n   * @throws Error if the watch is not reachable or session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.sendMessage({\n   *   data: { action: 'refresh', timestamp: Date.now() }\n   * });\n   * ```\n   */\n  sendMessage(options: SendMessageOptions): Promise<void>;\n\n  /**\n   * Update the application context shared with the watch.\n   * Only the latest context is kept - this overwrites any previous context.\n   * Use this for syncing app state that the watch needs to display.\n   *\n   * @param options - The context options\n   * @returns Promise that resolves when the context is updated\n   * @throws Error if session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.updateApplicationContext({\n   *   context: { theme: 'dark', lastSync: Date.now() }\n   * });\n   * ```\n   */\n  updateApplicationContext(options: UpdateContextOptions): Promise<void>;\n\n  /**\n   * Transfer user info to the watch.\n   * Transfers are queued and delivered in order, even if the watch is not currently reachable.\n   * Use this for important data that must be delivered reliably.\n   *\n   * @param options - The user info options\n   * @returns Promise that resolves when the transfer is queued\n   * @throws Error if session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.transferUserInfo({\n   *   userInfo: { recordId: '123', action: 'created' }\n   * });\n   * ```\n   */\n  transferUserInfo(options: TransferUserInfoOptions): Promise<void>;\n\n  /**\n   * Reply to a message from the watch that requested a reply.\n   * Use this in response to the messageReceivedWithReply event.\n   *\n   * @param options - The reply options including the callbackId\n   * @returns Promise that resolves when the reply is sent\n   * @throws Error if the callback ID is invalid or session is not active\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * CapgoWatch.addListener('messageReceivedWithReply', async (event) => {\n   *   const result = await processRequest(event.message);\n   *   await CapgoWatch.replyToMessage({\n   *     callbackId: event.callbackId,\n   *     data: { result }\n   *   });\n   * });\n   * ```\n   */\n  replyToMessage(options: ReplyMessageOptions): Promise<void>;\n\n  /**\n   * Get information about the watch connectivity status.\n   *\n   * @returns Promise that resolves with watch connectivity info\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const info = await CapgoWatch.getInfo();\n   * if (info.isReachable) {\n   *   await CapgoWatch.sendMessage({ data: { ping: true } });\n   * }\n   * ```\n   */\n  getInfo(): Promise<WatchInfo>;\n\n  /**\n   * Get the native Capacitor plugin version.\n   *\n   * @returns Promise that resolves with the plugin version\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const { version } = await CapgoWatch.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Listen for messages received from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const handle = await CapgoWatch.addListener('messageReceived', (event) => {\n   *   console.log('Message from watch:', event.message);\n   * });\n   * // Later: handle.remove();\n   * ```\n   */\n  addListener(\n    eventName: 'messageReceived',\n    listenerFunc: (event: MessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for messages from the watch that require a reply.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('messageReceivedWithReply', async (event) => {\n   *   const response = await handleRequest(event.message);\n   *   await CapgoWatch.replyToMessage({\n   *     callbackId: event.callbackId,\n   *     data: response\n   *   });\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'messageReceivedWithReply',\n    listenerFunc: (event: MessageReceivedWithReplyEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for application context updates from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('applicationContextReceived', (event) => {\n   *   console.log('Context from watch:', event.context);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'applicationContextReceived',\n    listenerFunc: (event: ContextReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for user info transfers from the watch.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('userInfoReceived', (event) => {\n   *   console.log('User info from watch:', event.userInfo);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'userInfoReceived',\n    listenerFunc: (event: UserInfoReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for watch reachability changes.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('reachabilityChanged', (event) => {\n   *   console.log('Watch reachable:', event.isReachable);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'reachabilityChanged',\n    listenerFunc: (event: ReachabilityChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for session activation state changes.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - Callback function\n   * @returns Handle to remove the listener\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.addListener('activationStateChanged', (event) => {\n   *   console.log('Activation state:', event.state);\n   * });\n   * ```\n   */\n  addListener(\n    eventName: 'activationStateChanged',\n    listenerFunc: (event: ActivationStateChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoWatch.removeAllListeners();\n   * ```\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/ios/Sources/CapgoWatchPlugin/CapgoWatchPlugin.swift

@@ -6,7 +6,7 @@ import WatchConnectivity
 /// here: https://capacitorjs.com/docs/plugins/ios
 @objc(CapgoWatchPlugin)
 public class CapgoWatchPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.0.25"
+    private let pluginVersion: String = "8.1.1"
     public let identifier = "CapgoWatchPlugin"
     public let jsName = "CapgoWatch"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-watch",
-  "version": "8.0.25",
+  "version": "8.1.1",
   "description": "Capacitor plugin for Apple Watch communication with bidirectional messaging support",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -52,7 +52,8 @@
     "prepublishOnly": "bun run build",
     "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs",
     "example:install": "cd example-app && bun install --frozen-lockfile",
-    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build"
+    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build",
+    "changelog:ai": "node scripts/generate-ai-changelog.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",