Implement async methods for version checking; add getStoreUrl, getLatestVersion, and needsUpdate to both Android and iOS native implementations. Update README and example usage in App.tsx to reflect new functionality.

Author: AlshehriAli0

README.md

@@ -11,29 +11,48 @@ bun add react-native-nitro-version-check react-native-nitro-modules
 ## Usage
 
 ```tsx
-import VersionCheck from "react-native-nitro-version-check";
+import { VersionCheck } from "react-native-nitro-version-check";
 
+// Static properties
 VersionCheck.version;       // "1.0.0"
 VersionCheck.buildNumber;   // "42"
 VersionCheck.packageName;   // "com.example.app"
 VersionCheck.getCountry();  // "US"
+
+// Async methods
+const storeUrl = await VersionCheck.getStoreUrl();
+const latest = await VersionCheck.getLatestVersion();
+
+if (await VersionCheck.needsUpdate()) {
+  Linking.openURL(await VersionCheck.getStoreUrl());
+}
 ```
 
 Or import individually:
 
 ```tsx
-import { version, buildNumber, packageName, getCountry } from "react-native-nitro-version-check";
+import { version, buildNumber, getCountry, needsUpdate } from "react-native-nitro-version-check";
 ```
 
 ## API
 
+### Properties
+
 | API | Type | Description |
 |-----|------|-------------|
 | `version` | `string` | App version |
 | `buildNumber` | `string` | Build number |
 | `packageName` | `string` | Bundle ID / package name |
-| `getCountry()` | `string` | Current device country |
+
+### Methods
+
+| API | Returns | Description |
+|-----|---------|-------------|
+| `getCountry()` | `string` | Current device country code |
+| `getStoreUrl()` | `Promise<string>` | App Store / Play Store URL |
+| `getLatestVersion()` | `Promise<string>` | Latest version from the store |
+| `needsUpdate()` | `Promise<boolean>` | Whether an update is available |
 
 ## License
 
-MIT
+MIT

example/App.tsx

@@ -1,14 +1,61 @@
 import { StatusBar } from "expo-status-bar";
-import { StyleSheet, Text, View } from "react-native";
-import VersionCheck from "react-native-nitro-version-check";
+import { useEffect, useState } from "react";
+import { ActivityIndicator, Linking, StyleSheet, Text, TouchableOpacity, View } from "react-native";
+import { getLatestVersion, getStoreUrl, needsUpdate, VersionCheck } from "react-native-nitro-version-check";
 
 export default function App() {
+  const [loading, setLoading] = useState(true);
+  const [updateAvailable, setUpdateAvailable] = useState(false);
+  const [storeUrl, setStoreUrl] = useState<string | null>(null);
+  const [latestVersion, setLatestVersion] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  // Fetch all async data on mount
+  useEffect(() => {
+    const fetchAll = async () => {
+      try {
+        const [update, url, latest] = await Promise.all([needsUpdate(), getStoreUrl(), getLatestVersion()]);
+        setUpdateAvailable(update);
+        setStoreUrl(url);
+        setLatestVersion(latest);
+      } catch {
+        setError("App not found in store");
+      }
+      setLoading(false);
+    };
+    fetchAll();
+  }, []);
+
   return (
     <View style={styles.container}>
-      <Text>Version: {VersionCheck.version}</Text>
-      <Text>Build: {VersionCheck.buildNumber}</Text>
-      <Text>Package: {VersionCheck.packageName}</Text>
-      <Text>Country: {VersionCheck.getCountry()}</Text>
+      {/* Sync properties — available immediately */}
+      <Text style={styles.label}>Version: {VersionCheck.version}</Text>
+      <Text style={styles.label}>Build: {VersionCheck.buildNumber}</Text>
+      <Text style={styles.label}>Package: {VersionCheck.packageName}</Text>
+      <Text style={styles.label}>Country: {VersionCheck.getCountry()}</Text>
+
+      <View style={styles.divider} />
+
+      {/* Async data — shows loading spinner while fetching */}
+      {loading ? (
+        <ActivityIndicator style={styles.loader} />
+      ) : error ? (
+        <Text style={styles.errorText}>{error}</Text>
+      ) : (
+        <>
+          <Text style={styles.label}>Latest: {latestVersion}</Text>
+          <Text style={styles.label}>Store URL: {storeUrl}</Text>
+
+          {updateAvailable && storeUrl && (
+            <TouchableOpacity onPress={() => Linking.openURL(storeUrl)}>
+              <Text style={styles.updateText}>Update available — tap to open store</Text>
+            </TouchableOpacity>
+          )}
+
+          {!updateAvailable && <Text style={styles.upToDate}>App is up to date</Text>}
+        </>
+      )}
+
       <StatusBar style="auto" />
     </View>
   );
@@ -20,5 +67,35 @@ const styles = StyleSheet.create({
     backgroundColor: "#fff",
     alignItems: "center",
     justifyContent: "center",
+    padding: 24,
+  },
+  label: {
+    fontSize: 15,
+    marginVertical: 2,
+    color: "#333",
+  },
+  divider: {
+    height: 1,
+    backgroundColor: "#eee",
+    alignSelf: "stretch",
+    marginVertical: 16,
+  },
+  loader: {
+    marginTop: 8,
+  },
+  updateText: {
+    color: "#007AFF",
+    marginTop: 12,
+    fontSize: 16,
+    fontWeight: "600",
+  },
+  upToDate: {
+    color: "#34C759",
+    marginTop: 12,
+    fontSize: 15,
+  },
+  errorText: {
+    color: "#999",
+    fontSize: 14,
   },
-});
+});

package/android/src/main/java/com/margelo/nitro/nitroversioncheck/HybridVersionCheck.kt

@@ -1,6 +1,8 @@
 package com.margelo.nitro.nitroversioncheck
 
 import com.margelo.nitro.NitroModules
+import com.margelo.nitro.core.Promise
+import java.net.URL
 
 
 class HybridVersionCheck: HybridVersionCheckSpec(){
@@ -24,4 +26,36 @@ class HybridVersionCheck: HybridVersionCheckSpec(){
     }
 
     public override val packageName= packageInfo?.packageName ?: "unknown"
+
+    override fun getStoreUrl(): Promise<String> {
+        return Promise.async {
+            "https://play.google.com/store/apps/details?id=$packageName"
+        }
+    }
+
+    override fun getLatestVersion(): Promise<String> {
+        return Promise.async {
+            try {
+                val url = URL("https://play.google.com/store/apps/details?id=$packageName&hl=en")
+                val html = url.readText()
+                val regex = Regex("""\[\[\["(\d+\.\d+[\.\d+]*)"\]\]""")
+                val match = regex.find(html)
+                match?.groupValues?.get(1)
+                    ?: throw Exception("Could not parse latest version from Play Store page")
+            } catch (e: Exception) {
+                throw Exception("Failed to fetch latest version: ${e.message}", e)
+            }
+        }
+    }
+
+    override fun needsUpdate(): Promise<Boolean> {
+        return Promise.async {
+            try {
+                val latest = getLatestVersion().await()
+                version != latest
+            } catch (e: Exception) {
+                throw Exception("Failed to check for updates: ${e.message}", e)
+            }
+        }
+    }
 }

package/ios/HybridVersionCheck.swift

@@ -10,4 +10,44 @@ class HybridVersionCheck: HybridVersionCheckSpec {
     func getCountry() throws -> String {
         Locale.current.regionCode ?? "unknown"
     }
+
+    func getStoreUrl() throws -> Promise<String> {
+        return Promise.async {
+            let bundleId = Bundle.main.bundleIdentifier ?? ""
+            let url = URL(string: "https://itunes.apple.com/lookup?bundleId=\(bundleId)")!
+            let (data, _) = try await URLSession.shared.data(from: url)
+            let json = try JSONSerialization.jsonObject(with: data) as? [String: Any]
+            let results = json?["results"] as? [[String: Any]]
+            guard let trackViewUrl = results?.first?["trackViewUrl"] as? String else {
+                throw NSError(domain: "VersionCheck", code: 1, userInfo: [NSLocalizedDescriptionKey: "App not found on App Store"])
+            }
+            return trackViewUrl
+        }
+    }
+
+    func getLatestVersion() throws -> Promise<String> {
+        return Promise.async {
+            let bundleId = Bundle.main.bundleIdentifier ?? ""
+            let url = URL(string: "https://itunes.apple.com/lookup?bundleId=\(bundleId)")!
+            let (data, _) = try await URLSession.shared.data(from: url)
+            let json = try JSONSerialization.jsonObject(with: data) as? [String: Any]
+            let results = json?["results"] as? [[String: Any]]
+            
+            guard let latestVersion = results?.first?["version"] as? String else {
+                throw NSError(domain: "VersionCheck", code: 2, userInfo: [NSLocalizedDescriptionKey: "App not found on App Store"])
+            }
+            return latestVersion
+        }
+    }
+
+    func needsUpdate() throws -> Promise<Bool> {
+        return Promise.async { [self] in
+            do {
+                let latest = try await self.getLatestVersion().await()
+                return self.version != latest
+            } catch {
+                throw NSError(domain: "VersionCheck", code: 3, userInfo: [NSLocalizedDescriptionKey: "Failed to check for updates: \(error.localizedDescription)"])
+            }
+        }
+    }
 }