@haykmkrtich/react-native-patriot-native 1.0.6 → 1.1.1

package/README.md

@@ -1,204 +1,217 @@
-# React Native Patriot Native
-
-[![npm version](https://badge.fury.io/js/%40haykmkrtich%2Freact-native-patriot-native.svg)](https://badge.fury.io/js/%40haykmkrtich%2Freact-native-patriot-native)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Platform](https://img.shields.io/badge/platform-react--native-lightgrey)](https://reactnative.dev/)
-
-> 🚀 Seamlessly install WearOS watch faces and retrieve device information directly from your React Native mobile application.
-
-## ✨ What's New in v1.0.5
-
-- 🔍 **Device Detection**: New `getConnectedWatchProperties()` function
-- 📱 **Multi-Platform Support**: Detect WearOS, Fitbit, and other wearable devices  
-- 🏷️ **Device Information**: Get name, platform, type, and unique ID
-- 🛡️ **Enhanced Error Handling**: Improved disconnection detection
-
-## 🚀 Quick Start
-
-```bash
-npm install @haykmkrtich/react-native-patriot-native
-```
-
-```typescript
-import { installWatchface, getConnectedWatchProperties } from '@haykmkrtich/react-native-patriot-native';
-
-// Install watchface
-await installWatchface('com.example.watchface.package');
-
-// Get device info
-const watch = await getConnectedWatchProperties();
-console.log(`Connected: ${watch.displayName} (${watch.platform})`);
-```
-
-## 📋 Requirements
-
-- ⚛️ React Native ≥ 0.60.0
-- 🤖 Android API level 21+ (Android 5.0+)
-- ⌚ Paired WearOS device
-
-## 🎯 Features
-
-| Feature | Description |
-|---------|-------------|
-| 📦 **Watch Face Installation** | Install watch faces directly on paired WearOS devices |
-| 🔍 **Device Detection** | Retrieve detailed information about connected devices |
-| 🏷️ **Platform Detection** | Identify WearOS, Fitbit, and other wearable platforms |
-| 📡 **Connection Status** | Monitor device connectivity and proximity |
-| 🔄 **Promise-based API** | Modern async/await support |
-| 💬 **Native Feedback** | Toast notifications for user feedback |
-
-## 📖 API Reference
-
-### `installWatchface(packageName: string)`
-
-Initiates watch face installation on connected WearOS device.
-
-```typescript
-try {
-  await installWatchface('com.example.watchface.package');
-  // ✅ Installation initiated successfully
-} catch (error) {
-  // ❌ Handle installation errors
-}
-```
-
-**Errors:**
-- `NO_NODES` - No connected WearOS device
-- `INSTALL_FAILED` - Installation process failed
-
-### `getConnectedWatchProperties()`
-
-Retrieves detailed information about connected wearable devices.
-
-```typescript
-interface WatchProperties {
-  id: string;                    // Unique device identifier
-  displayName: string;           // Human-readable device name  
-  isNearby: boolean;            // Device proximity status
-  type: string;                 // Device type (e.g., "watch")
-  platform: string;            // Platform ("wearOS" | "fitbit")
-  isDisconnected?: boolean;     // No device connected
-}
-```
-
-**Example Response:**
-```typescript
-// ✅ Connected Device
-{
-  id: "node_12345_abcdef",
-  displayName: "Galaxy Watch 4", 
-  isNearby: true,
-  type: "watch",
-  platform: "wearOS"
-}
-
-// ❌ No Device
-{ isDisconnected: true }
-```
-
-## 🔧 Setup Requirements
-
-### Android Dependencies
-
-Add to your `android/app/build.gradle`:
-
-```gradle
-dependencies {
-    implementation 'com.google.android.gms:play-services-wearable:18.1.0'
-    implementation 'androidx.wear:wear-remote-interactions:1.0.0'
-}
-```
-
-### WearOS Development Best Practices
-
-> ⚠️ **Important**: For Google Play Console compliance, create **two applications** with identical package names:
-> - 📱 Mobile companion app (React Native)  
-> - ⌚ WearOS watch face app
-
-This ensures proper functionality and distribution through Google Play Store.
-
-## 🛠️ How It Works
-
-```mermaid
-graph LR
-    A[Mobile App] --> B[WearOS Remote API]
-    B --> C[Connected Watch]
-    C --> D[Google Play Store]
-    D --> E[Watch Face Installation]
-```
-
-1. **Device Discovery** - Scan for connected WearOS devices
-2. **Remote Installation** - Send installation request to watch
-3. **Play Store Integration** - Open watch face listing on device
-4. **User Confirmation** - User confirms installation on watch
-
-## 💡 Usage Examples
-
-### Basic Installation
-```typescript
-import { installWatchface } from '@haykmkrtich/react-native-patriot-native';
-
-const handleInstall = async (packageName: string) => {
-  try {
-    await installWatchface(packageName);
-    console.log('✅ Check your watch for installation prompt');
-  } catch (error) {
-    console.error('❌ Installation failed:', error.message);
-  }
-};
-```
-
-### Device Information
-```typescript
-import { getConnectedWatchProperties } from '@haykmkrtich/react-native-patriot-native';
-
-const checkWatchStatus = async () => {
-  try {
-    const watch = await getConnectedWatchProperties();
-    
-    if (watch.isDisconnected) {
-      return '❌ No watch connected';
-    }
-    
-    return `✅ ${watch.displayName} (${watch.platform}) - ${watch.isNearby ? 'Nearby' : 'Away'}`;
-  } catch (error) {
-    return `❌ Detection failed: ${error.message}`;
-  }
-};
-```
-
-## 🤝 Contributing
-
-Contributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md) before submitting PRs.
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 👨‍💻 Author
-
-**Hayk Mkrtich**
-- GitHub: [@HaykMkrtich](https://github.com/HaykMkrtich)
-- NPM: [@haykmkrtich](https://www.npmjs.com/~haykmkrtich)
-
-## 🆘 Support
-
-- 🐛 **Bug Reports**: [Create an issue](https://github.com/HaykMkrtich/react-native-patriot-native/issues/new?template=bug_report.md)
-- 💡 **Feature Requests**: [Request a feature](https://github.com/HaykMkrtich/react-native-patriot-native/issues/new?template=feature_request.md)
-- 📖 **Documentation**: [View full docs](https://github.com/HaykMkrtich/react-native-patriot-native/wiki)
-
----
-
-<div align="center">
-
-**⭐ Star this repository if it helped you!**
-
-Made with ❤️ for the React Native community
-
-</div>
+# React Native Patriot Native
+
+[![npm version](https://badge.fury.io/js/%40haykmkrtich%2Freact-native-patriot-native.svg)](https://badge.fury.io/js/%40haykmkrtich%2Freact-native-patriot-native)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-react--native-lightgrey)](https://reactnative.dev/)
+
+A React Native module that enables seamless interaction with WearOS devices — install watch faces, detect connected devices, check app installations, and send messages directly from your mobile app.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Watch Face Installation** | Install watch faces directly on paired WearOS devices |
+| **Device Detection** | Get detailed info on all connected WearOS devices |
+| **Platform Detection** | Identify WearOS vs other wearable platforms |
+| **App Install Check** | Verify if a specific app is installed on the watch |
+| **Custom Messaging** | Send arbitrary messages to specific watch nodes |
+| **New Architecture** | TurboModule support for React Native 0.77+ |
+| **16KB Page Size** | Compliant with Google Play's 16KB page size requirements |
+
+## Installation
+
+```bash
+npm install @haykmkrtich/react-native-patriot-native
+# or
+yarn add @haykmkrtich/react-native-patriot-native
+```
+
+## Requirements
+
+- React Native >= 0.60.0
+- Android API level 24+ (Android 7.0+)
+- Java 17+
+- Paired WearOS device
+
+## Quick Start
+
+```typescript
+import {
+  installWatchface,
+  getConnectedDevices,
+  isAppInstalledOnWatch,
+  sendMessageToWatch,
+} from '@haykmkrtich/react-native-patriot-native';
+
+// Get all connected devices
+const devices = await getConnectedDevices();
+console.log(devices);
+// [{ id: "node_123", displayName: "Galaxy Watch 4", isNearby: true, type: "watch", platform: "wearOS" }]
+
+// Install a watch face
+await installWatchface('com.example.watchface.package');
+
+// Check if an app is installed on the watch
+const status = await isAppInstalledOnWatch('com.example.watchface');
+// { isInstalled: true, installedOnNodes: ["node_123"] }
+
+// Send a custom message to a specific watch
+await sendMessageToWatch(devices[0].id, '/my-path', 'hello');
+```
+
+## API Reference
+
+### `getConnectedDevices(): Promise<ConnectedDevice[]>`
+
+Returns all connected WearOS devices with full details. Returns an empty array if no devices are connected.
+
+```typescript
+interface ConnectedDevice {
+  id: string;           // Unique device identifier
+  displayName: string;  // Human-readable device name
+  isNearby: boolean;    // Device proximity status
+  type: string;         // Device type (e.g., "watch")
+  platform: string;     // Platform ("wearOS" | "unknown")
+}
+```
+
+**Example:**
+```typescript
+const devices = await getConnectedDevices();
+
+if (devices.length === 0) {
+  console.log('No watches connected');
+} else {
+  devices.forEach(device => {
+    console.log(`${device.displayName} (${device.platform}) - ${device.isNearby ? 'Nearby' : 'Away'}`);
+  });
+}
+```
+
+**Error Codes:**
+- `DETECTION_FAILED` — Failed to communicate with WearOS API
+
+---
+
+### `installWatchface(packageName: string): Promise<void>`
+
+Initiates watch face installation on all connected WearOS devices.
+
+**Parameters:**
+- `packageName` — The Google Play package name of the watch face to install
+
+**Example:**
+```typescript
+try {
+  await installWatchface('com.awesome.watchface');
+  // User will see a toast and installation prompt on their watch
+} catch (error) {
+  if (error.code === 'NO_NODES') {
+    console.log('No watch connected');
+  }
+}
+```
+
+**Error Codes:**
+- `NO_NODES` — No connected WearOS device found
+- `INSTALL_FAILED` — Installation request failed
+
+---
+
+### `isAppInstalledOnWatch(packageName: string): Promise<AppInstallStatus>`
+
+Checks if a specific app or capability is available on connected watches.
+
+```typescript
+interface AppInstallStatus {
+  isInstalled: boolean;     // Whether the app is found on any watch
+  installedOnNodes: string[]; // IDs of watches that have the app
+}
+```
+
+**Example:**
+```typescript
+const status = await isAppInstalledOnWatch('com.example.watchface');
+if (status.isInstalled) {
+  console.log(`Installed on ${status.installedOnNodes.length} device(s)`);
+}
+```
+
+**Error Codes:**
+- `CHECK_FAILED` — Failed to query capabilities
+
+---
+
+### `sendMessageToWatch(nodeId: string, path: string, data?: string): Promise<void>`
+
+Sends a custom message to a specific watch node. Use `getConnectedDevices()` first to get the node ID.
+
+**Parameters:**
+- `nodeId` — Target device ID (from `getConnectedDevices()`)
+- `path` — Message path (e.g., `/my-action`)
+- `data` — Optional string payload (defaults to empty string)
+
+**Example:**
+```typescript
+const devices = await getConnectedDevices();
+if (devices.length > 0) {
+  await sendMessageToWatch(devices[0].id, '/sync-settings', JSON.stringify({ theme: 'dark' }));
+}
+```
+
+**Error Codes:**
+- `MESSAGE_FAILED` — Failed to send message
+
+---
+
+### `getConnectedWatchProperties(): Promise<ConnectedDevice>` *(deprecated)*
+
+Returns the first connected device. Use `getConnectedDevices()` instead.
+
+## WearOS Development Best Practices
+
+This module is designed for WearOS watch face companion apps. For Google Play Console compliance:
+
+1. Create **two applications** with identical package names:
+   - Mobile companion app (React Native, using this module)
+   - WearOS watch face app
+2. This package name consistency is required for proper functionality and distribution through Google Play Store.
+
+## How It Works
+
+1. **Device Discovery** — Scan for connected WearOS devices via NodeClient
+2. **Remote Installation** — Send installation request to connected watches
+3. **Play Store Integration** — Opens the watch face listing on the watch's Play Store
+4. **User Confirmation** — User confirms installation on their watch
+
+## Changelog
+
+### 1.1.0
+- **New:** `getConnectedDevices()` — returns all connected devices with full details (replaces `getConnectedWatchProperties`)
+- **New:** `isAppInstalledOnWatch(packageName)` — check if an app is installed on connected watches
+- **New:** `sendMessageToWatch(nodeId, path, data)` — send custom messages to specific watch nodes
+- **Deprecated:** `getConnectedWatchProperties()` — use `getConnectedDevices()` instead
+- **Fixed:** "No matching variant" build error on React Native 0.78+ / AGP 8.11+
+  - Added `publishing` block for AGP 8.11+ compatibility
+  - Updated `compileSdk`/`targetSdk` to 35
+  - Java 17 compatibility
+- **Fixed:** Duplicate class errors from broken newarch/oldarch stubs — both now have full implementations
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Author
+
+**Hayk Mkrtich**
+- GitHub: [@HaykMkrtich](https://github.com/HaykMkrtich)
+- NPM: [@haykmkrtich](https://www.npmjs.com/~haykmkrtich)
+
+## Support
+
+- [Report Issues](https://github.com/HaykMkrtich/react-native-patriot-native/issues)
+- [Feature Requests](https://github.com/HaykMkrtich/react-native-patriot-native/issues)

package/android/build.gradle

@@ -1,50 +1,39 @@
 apply plugin: 'com.android.library'
 apply plugin: 'com.facebook.react'
 
-// Поддержка новой архитектуры React Native
-def isNewArchitectureEnabled() {
-    return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
-}
-
 android {
-    compileSdkVersion 34
+    compileSdk 35
     namespace "com.patriotnative"
 
     defaultConfig {
-        minSdkVersion 24 // Повышаем минимальную версию для поддержки новых возможностей
-        targetSdkVersion 34
+        minSdk 24
+        targetSdk 35
 
-        // Добавляем поддержка 16KB страниц
         ndk {
             abiFilters "arm64-v8a", "x86_64"
         }
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_17 // Обновляем до Java 17 для RN 0.77
+        sourceCompatibility JavaVersion.VERSION_17
         targetCompatibility JavaVersion.VERSION_17
     }
 
-    // Исправляем packagingOptions на packaging
     packaging {
         pickFirst "**/libc++_shared.so"
         pickFirst "**/libjsc.so"
     }
 
-    // Оптимизация для 16KB страниц
-    buildFeatures {
-        prefab true
-        buildConfig false
+    publishing {
+        singleVariant("release") {
+            withSourcesJar()
+        }
     }
 
-    // Поддержка новой архитектуры
     sourceSets {
         main {
-            if (isNewArchitectureEnabled()) {
-                java.srcDirs += [
-                    "src/newarch/java",
-                    "${project.buildDir}/generated/source/codegen/java"
-                ]
+            if (project.hasProperty("newArchEnabled") && project.property("newArchEnabled") == "true") {
+                java.srcDirs += ["src/newarch/java"]
             } else {
                 java.srcDirs += ["src/oldarch/java"]
             }
@@ -52,7 +41,6 @@ android {
     }
 }
 
-// Поддержка React Native Codegen
 react {
     libraryName = "PatriotNative"
     codegenJavaPackageName = "com.patriotnative"
@@ -63,9 +51,4 @@ dependencies {
     implementation 'androidx.annotation:annotation:1.7.0'
     implementation 'com.google.android.gms:play-services-wearable:18.2.0'
     implementation 'androidx.wear:wear-remote-interactions:1.0.0'
-
-    // Исправляем условие для новой архитектуры
-    if (isNewArchitectureEnabled()) {
-        implementation project(":ReactAndroid")  // Правильная зависимость для новой архитектуры
-    }
 }

package/android/src/main/AndroidManifest.xml

@@ -1,25 +1,9 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-
-    <!-- Разрешения для работы с WearOS устройствами -->
-    <uses-permission android:name="android.permission.WAKE_LOCK" />
-    <uses-permission android:name="com.google.android.permission.PROVIDE_BACKGROUND" />
-
-    <!-- Поддержка 16KB страниц -->
-    <application
-        android:supportsRtl="true"
-        android:extractNativeLibs="false">
-
-        <!-- Метаданные для WearOS -->
-        <meta-data
-            android:name="com.google.android.gms.version"
-            android:value="@integer/google_play_services_version" />
-
-        <!-- Поддержка нового архитектуры React Native -->
-        <meta-data
-            android:name="com.facebook.react.modules.core.DefaultHardwareBackBtnHandler"
-            android:value="true" />
-    </application>
-
-</manifest>
-
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+    <uses-permission android:name="com.google.android.permission.PROVIDE_BACKGROUND" />
+
+    <application android:extractNativeLibs="false" />
+
+</manifest>

package/android/src/main/java/com/patriotnative/NativePatriotNativeSpec.java

@@ -1,39 +1,47 @@
-/**
- * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
- *
- * Do not edit this file as changes may cause incorrect behavior and will be lost
- * once the code is regenerated.
- *
- * @generated by codegen project: GenerateModuleJavaSpec.js
- */
-
-package com.patriotnative;
-
-import com.facebook.proguard.annotations.DoNotStrip;
-import com.facebook.react.bridge.Promise;
-import com.facebook.react.bridge.ReactApplicationContext;
-import com.facebook.react.bridge.ReactContextBaseJavaModule;
-import com.facebook.react.bridge.ReactMethod;
-import com.facebook.react.turbomodule.core.interfaces.TurboModule;
-
-public abstract class NativePatriotNativeSpec extends ReactContextBaseJavaModule implements TurboModule {
-
-  public static final String NAME = "PatriotNative";
-
-  public NativePatriotNativeSpec(ReactApplicationContext reactContext) {
-    super(reactContext);
-  }
-
-  @Override
-  public String getName() {
-    return NAME;
-  }
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void installWatchface(String packageName, Promise promise);
-
-  @ReactMethod
-  @DoNotStrip
-  public abstract void getConnectedWatchProperties(Promise promise);
-}
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJavaSpec.js
+ */
+
+package com.patriotnative;
+
+import com.facebook.proguard.annotations.DoNotStrip;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.turbomodule.core.interfaces.TurboModule;
+
+public abstract class NativePatriotNativeSpec extends ReactContextBaseJavaModule implements TurboModule {
+
+  public static final String NAME = "PatriotNative";
+
+  public NativePatriotNativeSpec(ReactApplicationContext reactContext) {
+    super(reactContext);
+  }
+
+  @Override
+  public String getName() {
+    return NAME;
+  }
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void installWatchface(String packageName, Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void getConnectedDevices(Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void isAppInstalledOnWatch(String packageName, Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void sendMessageToWatch(String nodeId, String path, String data, Promise promise);
+}