@haykmkrtich/react-native-patriot-native 1.0.4 → 1.0.5

package/README.md

@@ -1,87 +1,106 @@
 # React Native Patriot Native
 
-A React Native module that enables seamless installation of WearOS watch faces directly from your React Native mobile application.
+[![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/)
 
-## Important Note for WearOS Development
+> 🚀 Seamlessly install WearOS watch faces and retrieve device information directly from your React Native mobile application.
 
-This module is specifically designed for WearOS watch face companion apps. When developing a complete wearable product, it's crucial to follow the Google Play Console best practices:
+## ✨ What's New in v1.0.5
 
-1. Create two applications with **identical package names**:
-   - One for the mobile companion app (using this React Native module)
-   - One for the WearOS watch face itself
+- 🔍 **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
 
-This package name consistency is required for proper functionality and distribution through the Google Play Store.
+## 🚀 Quick Start
 
-## Features
+```bash
+npm install @haykmkrtich/react-native-patriot-native
+```
 
-- Install watch faces on paired WearOS devices
-- Handle connection status with WearOS devices
-- Promise-based API for easy integration
-- Native Toast notifications for user feedback
+```typescript
+import { installWatchface, getConnectedWatchProperties } from '@haykmkrtich/react-native-patriot-native';
 
-## Installation
+// Install watchface
+await installWatchface('com.example.watchface.package');
 
-```bash
-npm install @haykmkrtich/react-native-patriot-native
-# or
-yarn add @haykmkrtich/react-native-patriot-native
+// Get device info
+const watch = await getConnectedWatchProperties();
+console.log(`Connected: ${watch.displayName} (${watch.platform})`);
 ```
 
-## Requirements
+## 📋 Requirements
 
-- React Native >= 0.60.0
-- Android API level 21+ (Android 5.0 or later)
-- Paired WearOS device
+- ⚛️ React Native ≥ 0.60.0
+- 🤖 Android API level 21+ (Android 5.0+)
+- ⌚ Paired WearOS device
 
-## Usage
+## 🎯 Features
 
-```typescript
-import { installWatchface } from '@haykmkrtich/react-native-patriot-native';
+| 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
 
-// Example: Installing a watch face
+### `installWatchface(packageName: string)`
+
+Initiates watch face installation on connected WearOS device.
+
+```typescript
 try {
   await installWatchface('com.example.watchface.package');
-  // Watch face installation initiated on the connected WearOS device
+  // ✅ Installation initiated successfully
 } catch (error) {
-  // Handle errors (e.g., no connected device, installation failed)
-  console.error(error);
+  // ❌ Handle installation errors
 }
 ```
 
-## API Reference
+**Errors:**
+- `NO_NODES` - No connected WearOS device
+- `INSTALL_FAILED` - Installation process failed
 
-### `installWatchface(packageName: string): Promise<void>`
+### `getConnectedWatchProperties()`
 
-Initiates the installation of a watch face on the connected WearOS device.
+Retrieves detailed information about connected wearable devices.
 
-#### Parameters
-
-- `packageName` (string): The package name of the watch face to install from the Google Play Store.
-
-#### Returns
-
-- Promise that resolves when the installation request is successfully sent to the watch.
-- Promise rejection if:
-  - No WearOS device is connected
-  - Installation process fails
-
-#### Error Codes
-
-- `NO_NODES`: No connected WearOS device found
-- `INSTALL_FAILED`: Installation process failed
+```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
+}
+```
 
-## How It Works
+**Example Response:**
+```typescript
+// ✅ Connected Device
+{
+  id: "node_12345_abcdef",
+  displayName: "Galaxy Watch 4", 
+  isNearby: true,
+  type: "watch",
+  platform: "wearOS"
+}
 
-The module uses the WearOS Remote API to:
-1. Check for connected WearOS devices
-2. Send an installation request to the connected watch
-3. Open the Google Play Store page for the specified watch face package
+// ❌ No Device
+{ isDisconnected: true }
+```
 
-The user will receive a prompt on their WearOS device to install the watch face.
+## 🔧 Setup Requirements
 
-## Requirements for Android
+### Android Dependencies
 
-Add the following to your app's `build.gradle`:
+Add to your `android/app/build.gradle`:
 
 ```gradle
 dependencies {
@@ -90,18 +109,96 @@ dependencies {
 }
 ```
 
-## Contributing
+### 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)
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+## 🆘 Support
 
-## License
+- 🐛 **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)
 
-MIT License - see the [LICENSE](LICENSE) file for details.
+---
 
-## Author
+<div align="center">
 
-Hayk Mkrtich
+**⭐ Star this repository if it helped you!**
 
-## Support
+Made with ❤️ for the React Native community
 
-For issues and feature requests, please [create an issue](https://github.com/HaykMkrtich/react-native-patriot-native/issues) on GitHub.
+</div>

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

@@ -22,6 +22,8 @@ import com.google.android.gms.wearable.Wearable;
 
 import java.util.List;
 import java.util.concurrent.Executors;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.bridge.Arguments;
 
 public class PatriotNativeModule extends ReactContextBaseJavaModule {
     private final ReactApplicationContext reactContext;
@@ -67,6 +69,46 @@ public class PatriotNativeModule extends ReactContextBaseJavaModule {
         }).start();
     }
 
+    @ReactMethod
+    public void getConnectedWatchProperties(Promise promise) {
+        Executors.newSingleThreadExecutor().execute(() -> {
+            try {
+                List<Node> nodes = Tasks.await(Wearable.getNodeClient(reactContext).getConnectedNodes());
+                if (nodes == null || nodes.isEmpty()) {
+                    WritableMap result = Arguments.createMap();
+                    result.putBoolean("isDisconnected", true);
+                    promise.resolve(result);
+                    return;
+                }
+
+                for (Node node : nodes) {
+                    String displayName = node.getDisplayName().toLowerCase();
+
+                    // Простой фильтр: часы по ключевым словам
+                    if (displayName.contains("watch") || displayName.contains("fitbit") || displayName.contains("wear")) {
+                        WritableMap map = Arguments.createMap();
+                        map.putString("id", node.getId());
+                        map.putString("displayName", node.getDisplayName());
+                        map.putBoolean("isNearby", node.isNearby());
+                        map.putString("type", "watch");
+                        map.putString("platform", displayName.contains("fitbit") ? "fitbit" : "wearOS");
+
+                        promise.resolve(map);
+                        return;
+                    }
+                }
+
+                // Если ни одно устройство не подошло
+                WritableMap result = Arguments.createMap();
+                result.putBoolean("isDisconnected", true);
+                promise.resolve(result);
+            } catch (Exception e) {
+                promise.reject("WATCH_DETECTION_FAILED", e.getMessage());
+            }
+        });
+    }
+
+
     private void showToast(String msg) {
         new Handler(Looper.getMainLooper()).post(() ->
                 Toast.makeText(reactContext, msg, Toast.LENGTH_SHORT).show());

package/index.ts

@@ -3,10 +3,14 @@ import { NativeModules } from 'react-native';
 
 type PatriotNativeType = {
   installWatchface(packageName: string): Promise<void>;
+  getConnectedWatchProperties(): Promise<{ id: string; displayName: string; isNearby: boolean; type: string; platform: string }>;
 };
 
 const { PatriotNative } = NativeModules as { PatriotNative: PatriotNativeType };
 
-export function installWatchface(packageName: string): Promise<void> {
-  return PatriotNative.installWatchface(packageName);
+if (!PatriotNative) {
+  throw new Error('PatriotNative module is not linked properly.');
 }
+
+export const installWatchface = PatriotNative.installWatchface;
+export const getConnectedWatchProperties = PatriotNative.getConnectedWatchProperties;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haykmkrtich/react-native-patriot-native",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "main": "index.ts",
   "files": [
     "index.ts",