react-native-nitro-version-check 1.0.1 → 1.1.0

package/README.md

@@ -3,7 +3,7 @@
 </h1>
 
 <p align="center">
-  <b>A fast, modern version-checking library for React Native, powered by <a href="https://github.com/mrousavy/nitro">Nitro Modules</a>.</b>
+  <b>A lightweight, fast version-checking library for React Native, powered by <a href="https://github.com/mrousavy/nitro">Nitro Modules</a>.</b>
 </p>
 
 <p align="center">
@@ -12,105 +12,45 @@
 
 <br />
 
-## Features
-
-- ⚡ **Synchronous access** to version, build number, package name, and country
-- 🏪 **Store version lookup** from the App Store or Play Store
-- 🔍 **Granular update checks** — major, minor, or patch
-- 📦 **Install source detection** — TestFlight, App Store, Play Store, or sideloaded
-- 🪶 **Tiny footprint** — pure Swift on iOS, Kotlin on Android
-
-## Performance
-
-Benchmarked against [`react-native-version-check`](https://github.com/kimxogus/react-native-version-check). 100,000 iterations averaged over 5 runs on an iPhone 12:
-
-| Method | Speedup |
-|--------|---------|
-| `getAllInfo` | **~3.1x faster** |
-| `packageName` | **~1.6x faster** |
-| `version` | **~1.6x faster** |
-| `buildNumber` | **~1.6x faster** |
-| `getCountry` | **~3.1x faster** |
-
-## Installation
-
-```sh
-bun add react-native-nitro-version-check react-native-nitro-modules
-```
-
-For Expo projects, run prebuild:
-```sh
-npx expo prebuild
-```
-
-For bare React Native projects:
-```sh
-cd ios && pod install
-```
-
-## Usage
+## Example
 
 ```ts
-import { VersionCheck, getCountry, getStoreUrl, getLatestVersion, needsUpdate } from 'react-native-nitro-version-check'
+import { VersionCheck } from 'react-native-nitro-version-check'
 
-// Sync properties
+// Sync — no bridge, no async
 VersionCheck.version       // "1.2.0"
 VersionCheck.buildNumber   // "42"
 VersionCheck.packageName   // "com.example.app"
 VersionCheck.installSource // "appstore" | "testflight" | "playstore" | undefined
-getCountry()               // "US"
-
-// Async
-const url    = await getStoreUrl()       // App Store / Play Store URL
-const latest = await getLatestVersion()  // "1.3.0"
 
-if (await needsUpdate()) {
-  Linking.openURL(await getStoreUrl())
-}
+// Or destructure properties
+const { version, buildNumber, packageName, installSource } = VersionCheck
 
-// Only prompt for major updates
-if (await needsUpdate({ level: 'major' })) {
-  // 1.x → 2.x
+// Check for updates
+if (await VersionCheck.needsUpdate()) {
+  Linking.openURL(await VersionCheck.getStoreUrl())
 }
 ```
 
-## API
-
-### `VersionCheck`
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `version` | `string` | App version |
-| `buildNumber` | `string` | Build number |
-| `packageName` | `string` | Bundle ID / Application ID |
-| `installSource` | `string \| undefined` | `"appstore"` `"testflight"` `"playstore"` or `undefined` |
-| `getCountry()` | `string` | Device's 2-letter ISO country code |
-| `getStoreUrl()` | `Promise<string>` | App Store / Play Store URL |
-| `getLatestVersion()` | `Promise<string>` | Latest version in the store |
-| `needsUpdate()` | `Promise<boolean>` | Whether an update is available |
-
-### Standalone exports
+## Installation
 
-Also available as individual named exports:
+```sh
+bun add react-native-nitro-version-check
+```
 
-| Export | Returns | Description |
-|--------|---------|-------------|
-| `getCountry()` | `string` | Device's 2-letter ISO country code |
-| `getStoreUrl()` | `Promise<string>` | App Store / Play Store URL |
-| `getLatestVersion()` | `Promise<string>` | Latest version in the store |
-| `needsUpdate(options?)` | `Promise<boolean>` | Whether an update is available |
+> Check the [full installation guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/installation) for platform setup and additional dependencies.
 
-#### `needsUpdate` options
+## Documentation
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `level` | `"major" \| "minor" \| "patch"` | `"patch"` | Minimum version bump to trigger `true` |
+- [**Nitro Version Check** docs 📚](https://alshehriali0.github.io/react-native-nitro-version-check/)
+- [**Getting Started** guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/getting-started)
+- [**Installation** guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/installation)
+- [**API Reference**](https://alshehriali0.github.io/react-native-nitro-version-check/docs/api-reference)
+- [**Migration Guide** from react-native-version-check](https://alshehriali0.github.io/react-native-nitro-version-check/docs/migration-guide)
 
-### Utilities
+## Contributing
 
-| Function | Returns | Description |
-|----------|---------|-------------|
-| `compareVersions(v1, v2)` | `-1 \| 0 \| 1` | Compare two semver strings |
+See the [contributing guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/contributing) to learn how to contribute to the repository and the development workflow.
 
 ## License
 

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

@@ -36,15 +36,17 @@ class HybridVersionCheck : HybridVersionCheckSpec() {
         return java.util.Locale.getDefault().country ?: "unknown"
     }
 
-    override fun getStoreUrl(): Promise<String> {
+    override fun getStoreUrl(countryCode: String?): Promise<String> {
         return Promise.async {
+            // Country code is not used on Android Play Store, but parameter is kept for API consistency
             "https://play.google.com/store/apps/details?id=$packageName"
         }
     }
 
-    override fun getLatestVersion(): Promise<String> {
+    override fun getLatestVersion(countryCode: String?): Promise<String> {
         return Promise.async {
             try {
+                // Country code is not used on Android Play Store, but parameter is kept for API consistency
                 val url = URL("https://play.google.com/store/apps/details?id=$packageName&hl=en")
                 val connection = url.openConnection() as HttpURLConnection
                 connection.connectTimeout = TIMEOUT_MS

package/ios/HybridVersionCheck.swift

@@ -30,10 +30,12 @@ class HybridVersionCheck: HybridVersionCheckSpec {
         return Locale.current.regionCode ?? "unknown"
     }
 
-    func getStoreUrl() throws -> Promise<String> {
-        return Promise.async {
+    func getStoreUrl(countryCode: String? = nil) throws -> Promise<String> {
+        return Promise.async { [self] in
             let bundleId = Bundle.main.bundleIdentifier ?? ""
-            let url = URL(string: "https://itunes.apple.com/lookup?bundleId=\(bundleId)")!
+            let country = countryCode ?? (try? self.getCountry()) ?? "US"
+            let urlString = "https://itunes.apple.com/\(country.lowercased())/lookup?bundleId=\(bundleId)"
+            let url = URL(string: urlString)!
             let (data, _) = try await HybridVersionCheck.session.data(from: url)
             guard let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],
                   let results = json["results"] as? [[String: Any]],
@@ -44,10 +46,12 @@ class HybridVersionCheck: HybridVersionCheckSpec {
         }
     }
 
-    func getLatestVersion() throws -> Promise<String> {
-        return Promise.async {
+    func getLatestVersion(countryCode: String? = nil) throws -> Promise<String> {
+        return Promise.async { [self] in
             let bundleId = Bundle.main.bundleIdentifier ?? ""
-            let url = URL(string: "https://itunes.apple.com/lookup?bundleId=\(bundleId)")!
+            let country = countryCode ?? (try? self.getCountry()) ?? "US"
+            let urlString = "https://itunes.apple.com/\(country.lowercased())/lookup?bundleId=\(bundleId)"
+            let url = URL(string: urlString)!
             let (data, _) = try await HybridVersionCheck.session.data(from: url)
             guard let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],
                   let results = json["results"] as? [[String: Any]],

package/lib/index.d.ts

@@ -1,62 +1,11 @@
 import type { UpdateLevel } from "./semver";
 import { compareVersions } from "./semver";
-/**
- * Returns the device's current 2-letter ISO country code.
- *
- * @example
- * ```ts
- * getCountry() // "US"
- * ```
- */
-export declare const getCountry: () => string;
-/**
- * Returns the store URL for this app.
- *
- * Automatically resolves to the App Store on iOS and Play Store on Android.
- *
- * @example
- * ```ts
- * const url = await getStoreUrl();
- * Linking.openURL(url);
- * ```
- */
-export declare const getStoreUrl: () => Promise<string>;
-/**
- * Fetches the latest version of this app available in the store.
- *
- * @example
- * ```ts
- * const latest = await getLatestVersion(); // "1.3.0"
- * ```
- */
-export declare const getLatestVersion: () => Promise<string>;
-/**
- * Checks whether an app update is available.
- *
- * Uses semantic version comparison. By default checks for any version
- * increase, but you can filter by granularity:
- *
- * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
- * - `"minor"` — returns `true` for major or minor bumps
- * - `"patch"` — returns `true` for any version increase (default)
- *
- * @example
- * ```ts
- * if (await needsUpdate()) {
- *   const url = await getStoreUrl();
- *   Linking.openURL(url);
- * }
- *
- * // Only prompt for major updates
- * const majorUpdate = await needsUpdate({ level: "major" });
- * ```
- */
-export declare const needsUpdate: (options?: {
-    level?: UpdateLevel;
-}) => Promise<boolean>;
 /**
  * All version-check APIs in one object.
  *
+ * Provides access to app version information, store URLs, and update checking.
+ * Sync properties are cached at module init for zero native overhead.
+ *
  * @example
  * ```ts
  * VersionCheck.version      // "1.2.0"
@@ -65,6 +14,9 @@ export declare const needsUpdate: (options?: {
  * VersionCheck.getCountry() // "US"
  *
  * const url = await VersionCheck.getStoreUrl();
+ * if (await VersionCheck.needsUpdate()) {
+ *   Linking.openURL(url);
+ * }
  * ```
  */
 export declare const VersionCheck: {
@@ -132,37 +84,84 @@ export declare const VersionCheck: {
     /**
      * Returns the App Store (iOS) or Play Store (Android) URL for this app.
      *
+     * @param options - Optional configuration
+     * @param options.countryCode - 2-letter ISO country code (e.g., "US", "GB")
+     *   Defaults to the device's current country from `getCountry()`.
+     *   Only used on iOS; ignored on Android.
+     *
      * @example
      * ```ts
      * const url = await VersionCheck.getStoreUrl();
+     * const urlUS = await VersionCheck.getStoreUrl({ countryCode: "US" });
      * Linking.openURL(url);
      * ```
      */
-    readonly getStoreUrl: () => Promise<string>;
+    readonly getStoreUrl: (options?: {
+        countryCode?: string;
+    }) => Promise<string>;
     /**
      * Fetches the latest version of this app available in the store.
      *
      * Queries the iTunes API on iOS and the Play Store on Android.
+     * On iOS, uses the device's current country code by default but can be overridden.
+     *
+     * @param options - Optional configuration
+     * @param options.countryCode - 2-letter ISO country code (e.g., "US", "GB")
+     *   Defaults to the device's current country from `getCountry()`.
+     *   If the device region changes, the next call will use the new country.
+     *   Only used on iOS; ignored on Android.
      *
      * @example
      * ```ts
-     * const latest = await VersionCheck.getLatestVersion(); // "1.3.0"
+     * const latest = await VersionCheck.getLatestVersion(); // Uses current device country
+     * const latestUS = await VersionCheck.getLatestVersion({ countryCode: "US" });
+     * const latestGB = await VersionCheck.getLatestVersion({ countryCode: "GB" });
      * ```
      */
-    readonly getLatestVersion: () => Promise<string>;
+    readonly getLatestVersion: (options?: {
+        countryCode?: string;
+    }) => Promise<string>;
     /**
      * Checks whether an app update is available by comparing the current
      * version against the latest store version.
      *
+     * Uses semantic version comparison. By default checks for any version
+     * increase, but you can filter by granularity:
+     *
+     * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
+     * - `"minor"` — returns `true` for major or minor bumps
+     * - `"patch"` — returns `true` for any version increase (default)
+     *
      * @example
      * ```ts
      * if (await VersionCheck.needsUpdate()) {
      *   const url = await VersionCheck.getStoreUrl();
      *   Linking.openURL(url);
      * }
+     *
+     * // Only prompt for major updates
+     * const majorUpdate = await VersionCheck.needsUpdate({ level: "major" });
+     * ```
+     */
+    readonly needsUpdate: (options?: {
+        level?: UpdateLevel;
+    }) => Promise<boolean>;
+    /**
+     * Compares two semantic version strings.
+     *
+     * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+     *
+     * @example
+     * ```ts
+     * VersionCheck.compareVersions('1.0.0', '1.0.1') // -1
+     * VersionCheck.compareVersions('2.0.0', '2.0.0') //  0
+     * VersionCheck.compareVersions('3.0.0', '2.9.9') //  1
+     *
+     * if (VersionCheck.compareVersions(currentVersion, minimumVersion) < 0) {
+     *   // Current version is below minimum — force update
+     * }
      * ```
      */
-    readonly needsUpdate: () => Promise<boolean>;
+    readonly compareVersions: typeof compareVersions;
 };
-export { compareVersions };
 export type { UpdateLevel };

package/lib/index.js

@@ -6,64 +6,12 @@ const version = HybridVersionCheck.version;
 const buildNumber = HybridVersionCheck.buildNumber;
 const packageName = HybridVersionCheck.packageName;
 const installSource = HybridVersionCheck.installSource;
-/**
- * Returns the device's current 2-letter ISO country code.
- *
- * @example
- * ```ts
- * getCountry() // "US"
- * ```
- */
-export const getCountry = () => HybridVersionCheck.getCountry();
-/**
- * Returns the store URL for this app.
- *
- * Automatically resolves to the App Store on iOS and Play Store on Android.
- *
- * @example
- * ```ts
- * const url = await getStoreUrl();
- * Linking.openURL(url);
- * ```
- */
-export const getStoreUrl = () => HybridVersionCheck.getStoreUrl();
-/**
- * Fetches the latest version of this app available in the store.
- *
- * @example
- * ```ts
- * const latest = await getLatestVersion(); // "1.3.0"
- * ```
- */
-export const getLatestVersion = () => HybridVersionCheck.getLatestVersion();
-/**
- * Checks whether an app update is available.
- *
- * Uses semantic version comparison. By default checks for any version
- * increase, but you can filter by granularity:
- *
- * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
- * - `"minor"` — returns `true` for major or minor bumps
- * - `"patch"` — returns `true` for any version increase (default)
- *
- * @example
- * ```ts
- * if (await needsUpdate()) {
- *   const url = await getStoreUrl();
- *   Linking.openURL(url);
- * }
- *
- * // Only prompt for major updates
- * const majorUpdate = await needsUpdate({ level: "major" });
- * ```
- */
-export const needsUpdate = async (options) => {
-    const latest = await HybridVersionCheck.getLatestVersion();
-    return isNewerVersion(version, latest, options?.level ?? "patch");
-};
 /**
  * All version-check APIs in one object.
  *
+ * Provides access to app version information, store URLs, and update checking.
+ * Sync properties are cached at module init for zero native overhead.
+ *
  * @example
  * ```ts
  * VersionCheck.version      // "1.2.0"
@@ -72,6 +20,9 @@ export const needsUpdate = async (options) => {
  * VersionCheck.getCountry() // "US"
  *
  * const url = await VersionCheck.getStoreUrl();
+ * if (await VersionCheck.needsUpdate()) {
+ *   Linking.openURL(url);
+ * }
  * ```
  */
 export const VersionCheck = {
@@ -135,40 +86,88 @@ export const VersionCheck = {
      * VersionCheck.getCountry() // "US"
      * ```
      */
-    getCountry,
+    getCountry: () => HybridVersionCheck.getCountry(),
     /**
      * Returns the App Store (iOS) or Play Store (Android) URL for this app.
      *
+     * @param options - Optional configuration
+     * @param options.countryCode - 2-letter ISO country code (e.g., "US", "GB")
+     *   Defaults to the device's current country from `getCountry()`.
+     *   Only used on iOS; ignored on Android.
+     *
      * @example
      * ```ts
      * const url = await VersionCheck.getStoreUrl();
+     * const urlUS = await VersionCheck.getStoreUrl({ countryCode: "US" });
      * Linking.openURL(url);
      * ```
      */
-    getStoreUrl,
+    getStoreUrl: async (options) => {
+        return HybridVersionCheck.getStoreUrl(options?.countryCode);
+    },
     /**
      * Fetches the latest version of this app available in the store.
      *
      * Queries the iTunes API on iOS and the Play Store on Android.
+     * On iOS, uses the device's current country code by default but can be overridden.
+     *
+     * @param options - Optional configuration
+     * @param options.countryCode - 2-letter ISO country code (e.g., "US", "GB")
+     *   Defaults to the device's current country from `getCountry()`.
+     *   If the device region changes, the next call will use the new country.
+     *   Only used on iOS; ignored on Android.
      *
      * @example
      * ```ts
-     * const latest = await VersionCheck.getLatestVersion(); // "1.3.0"
+     * const latest = await VersionCheck.getLatestVersion(); // Uses current device country
+     * const latestUS = await VersionCheck.getLatestVersion({ countryCode: "US" });
+     * const latestGB = await VersionCheck.getLatestVersion({ countryCode: "GB" });
      * ```
      */
-    getLatestVersion,
+    getLatestVersion: async (options) => {
+        return HybridVersionCheck.getLatestVersion(options?.countryCode);
+    },
     /**
      * Checks whether an app update is available by comparing the current
      * version against the latest store version.
      *
+     * Uses semantic version comparison. By default checks for any version
+     * increase, but you can filter by granularity:
+     *
+     * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
+     * - `"minor"` — returns `true` for major or minor bumps
+     * - `"patch"` — returns `true` for any version increase (default)
+     *
      * @example
      * ```ts
      * if (await VersionCheck.needsUpdate()) {
      *   const url = await VersionCheck.getStoreUrl();
      *   Linking.openURL(url);
      * }
+     *
+     * // Only prompt for major updates
+     * const majorUpdate = await VersionCheck.needsUpdate({ level: "major" });
+     * ```
+     */
+    needsUpdate: async (options) => {
+        const latest = await HybridVersionCheck.getLatestVersion();
+        return isNewerVersion(version, latest, options?.level ?? "patch");
+    },
+    /**
+     * Compares two semantic version strings.
+     *
+     * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+     *
+     * @example
+     * ```ts
+     * VersionCheck.compareVersions('1.0.0', '1.0.1') // -1
+     * VersionCheck.compareVersions('2.0.0', '2.0.0') //  0
+     * VersionCheck.compareVersions('3.0.0', '2.9.9') //  1
+     *
+     * if (VersionCheck.compareVersions(currentVersion, minimumVersion) < 0) {
+     *   // Current version is below minimum — force update
+     * }
      * ```
      */
-    needsUpdate: () => HybridVersionCheck.needsUpdate(),
+    compareVersions,
 };
-export { compareVersions };

package/lib/specs/Version.nitro.d.ts

@@ -8,7 +8,7 @@ export interface VersionCheck extends HybridObject<{
     readonly packageName: string;
     readonly installSource: string | undefined;
     getCountry(): string;
-    getStoreUrl(): Promise<string>;
-    getLatestVersion(): Promise<string>;
+    getStoreUrl(countryCode?: string): Promise<string>;
+    getLatestVersion(countryCode?: string): Promise<string>;
     needsUpdate(): Promise<boolean>;
 }

package/nitrogen/generated/android/c++/JHybridVersionCheckSpec.cpp

@@ -77,9 +77,9 @@ namespace margelo::nitro::nitroversioncheck {
     auto __result = method(_javaPart);
     return __result->toStdString();
   }
-  std::shared_ptr<Promise<std::string>> JHybridVersionCheckSpec::getStoreUrl() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("getStoreUrl");
-    auto __result = method(_javaPart);
+  std::shared_ptr<Promise<std::string>> JHybridVersionCheckSpec::getStoreUrl(const std::optional<std::string>& countryCode) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* countryCode */)>("getStoreUrl");
+    auto __result = method(_javaPart, countryCode.has_value() ? jni::make_jstring(countryCode.value()) : nullptr);
     return [&]() {
       auto __promise = Promise<std::string>::create();
       __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
@@ -93,9 +93,9 @@ namespace margelo::nitro::nitroversioncheck {
       return __promise;
     }();
   }
-  std::shared_ptr<Promise<std::string>> JHybridVersionCheckSpec::getLatestVersion() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("getLatestVersion");
-    auto __result = method(_javaPart);
+  std::shared_ptr<Promise<std::string>> JHybridVersionCheckSpec::getLatestVersion(const std::optional<std::string>& countryCode) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>(jni::alias_ref<jni::JString> /* countryCode */)>("getLatestVersion");
+    auto __result = method(_javaPart, countryCode.has_value() ? jni::make_jstring(countryCode.value()) : nullptr);
     return [&]() {
       auto __promise = Promise<std::string>::create();
       __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {

package/nitrogen/generated/android/c++/JHybridVersionCheckSpec.hpp

@@ -59,8 +59,8 @@ namespace margelo::nitro::nitroversioncheck {
   public:
     // Methods
     std::string getCountry() override;
-    std::shared_ptr<Promise<std::string>> getStoreUrl() override;
-    std::shared_ptr<Promise<std::string>> getLatestVersion() override;
+    std::shared_ptr<Promise<std::string>> getStoreUrl(const std::optional<std::string>& countryCode) override;
+    std::shared_ptr<Promise<std::string>> getLatestVersion(const std::optional<std::string>& countryCode) override;
     std::shared_ptr<Promise<bool>> needsUpdate() override;
 
   private:

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroversioncheck/HybridVersionCheckSpec.kt

@@ -66,11 +66,11 @@ abstract class HybridVersionCheckSpec: HybridObject() {
   
   @DoNotStrip
   @Keep
-  abstract fun getStoreUrl(): Promise<String>
+  abstract fun getStoreUrl(countryCode: String?): Promise<String>
   
   @DoNotStrip
   @Keep
-  abstract fun getLatestVersion(): Promise<String>
+  abstract fun getLatestVersion(countryCode: String?): Promise<String>
   
   @DoNotStrip
   @Keep

package/nitrogen/generated/ios/c++/HybridVersionCheckSpecSwift.hpp

@@ -91,16 +91,16 @@ namespace margelo::nitro::nitroversioncheck {
       auto __value = std::move(__result.value());
       return __value;
     }
-    inline std::shared_ptr<Promise<std::string>> getStoreUrl() override {
-      auto __result = _swiftPart.getStoreUrl();
+    inline std::shared_ptr<Promise<std::string>> getStoreUrl(const std::optional<std::string>& countryCode) override {
+      auto __result = _swiftPart.getStoreUrl(countryCode);
       if (__result.hasError()) [[unlikely]] {
         std::rethrow_exception(__result.error());
       }
       auto __value = std::move(__result.value());
       return __value;
     }
-    inline std::shared_ptr<Promise<std::string>> getLatestVersion() override {
-      auto __result = _swiftPart.getLatestVersion();
+    inline std::shared_ptr<Promise<std::string>> getLatestVersion(const std::optional<std::string>& countryCode) override {
+      auto __result = _swiftPart.getLatestVersion(countryCode);
       if (__result.hasError()) [[unlikely]] {
         std::rethrow_exception(__result.error());
       }

package/nitrogen/generated/ios/swift/HybridVersionCheckSpec.swift

@@ -17,8 +17,8 @@ public protocol HybridVersionCheckSpec_protocol: HybridObject {
 
   // Methods
   func getCountry() throws -> String
-  func getStoreUrl() throws -> Promise<String>
-  func getLatestVersion() throws -> Promise<String>
+  func getStoreUrl(countryCode: String?) throws -> Promise<String>
+  func getLatestVersion(countryCode: String?) throws -> Promise<String>
   func needsUpdate() throws -> Promise<Bool>
 }
 

package/nitrogen/generated/ios/swift/HybridVersionCheckSpec_cxx.swift

@@ -169,9 +169,16 @@ open class HybridVersionCheckSpec_cxx {
   }
   
   @inline(__always)
-  public final func getStoreUrl() -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+  public final func getStoreUrl(countryCode: bridge.std__optional_std__string_) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
     do {
-      let __result = try self.__implementation.getStoreUrl()
+      let __result = try self.__implementation.getStoreUrl(countryCode: { () -> String? in
+        if bridge.has_value_std__optional_std__string_(countryCode) {
+          let __unwrapped = bridge.get_std__optional_std__string_(countryCode)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }())
       let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
         let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
         let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)
@@ -188,9 +195,16 @@ open class HybridVersionCheckSpec_cxx {
   }
   
   @inline(__always)
-  public final func getLatestVersion() -> bridge.Result_std__shared_ptr_Promise_std__string___ {
+  public final func getLatestVersion(countryCode: bridge.std__optional_std__string_) -> bridge.Result_std__shared_ptr_Promise_std__string___ {
     do {
-      let __result = try self.__implementation.getLatestVersion()
+      let __result = try self.__implementation.getLatestVersion(countryCode: { () -> String? in
+        if bridge.has_value_std__optional_std__string_(countryCode) {
+          let __unwrapped = bridge.get_std__optional_std__string_(countryCode)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }())
       let __resultCpp = { () -> bridge.std__shared_ptr_Promise_std__string__ in
         let __promise = bridge.create_std__shared_ptr_Promise_std__string__()
         let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_std__string__(__promise)

package/nitrogen/generated/shared/c++/HybridVersionCheckSpec.hpp

@@ -54,8 +54,8 @@ namespace margelo::nitro::nitroversioncheck {
     public:
       // Methods
       virtual std::string getCountry() = 0;
-      virtual std::shared_ptr<Promise<std::string>> getStoreUrl() = 0;
-      virtual std::shared_ptr<Promise<std::string>> getLatestVersion() = 0;
+      virtual std::shared_ptr<Promise<std::string>> getStoreUrl(const std::optional<std::string>& countryCode) = 0;
+      virtual std::shared_ptr<Promise<std::string>> getLatestVersion(const std::optional<std::string>& countryCode) = 0;
       virtual std::shared_ptr<Promise<bool>> needsUpdate() = 0;
 
     protected:

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "react-native-nitro-version-check",
-  "version": "1.0.1",
-  "description": "react-native-nitro-version-check",
+  "version": "1.1.0",
+  "description": "A lightweight, fast version-checking library for React Native, powered by Nitro Modules",
   "main": "lib/index",
   "module": "lib/index",
   "types": "lib/index.d.ts",
   "react-native": "src/index",
   "source": "src/index",
   "files": [
-    "src",
-    "react-native.config.js",
     "lib",
+    "react-native.config.js",
     "nitrogen",
     "android/build.gradle",
     "android/gradle.properties",
@@ -34,6 +33,9 @@
     "release": "release-it",
     "build": "tsc",
     "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
@@ -62,7 +64,8 @@
     "nitro-modules-version",
     "app store version",
     "play store version",
-    "market version"
+    "market version",
+    "lightweight"
   ],
   "repository": {
     "type": "git",
@@ -73,7 +76,7 @@
   "bugs": {
     "url": "https://github.com/AlshehriAli0/react-native-nitro-version-check/issues"
   },
-  "homepage": "https://github.com/AlshehriAli0/react-native-nitro-version-check#readme",
+  "homepage": "https://alshehriali0.github.io/react-native-nitro-version-check/",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -148,12 +151,15 @@
   },
   "devDependencies": {
     "@release-it/conventional-changelog": "^10.0.5",
+    "@types/jest": "^29.5.12",
     "@types/react": "^19.1.03",
+    "jest": "^29.7.0",
     "nitrogen": "*",
     "react": "19.2.0",
     "react-native": "0.83.0",
     "react-native-nitro-modules": "*",
     "release-it": "^19.2.4",
+    "ts-jest": "^29.1.2",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {

package/src/index.ts

@@ -1,185 +0,0 @@
-import { NitroModules } from "react-native-nitro-modules";
-import type { UpdateLevel } from "./semver";
-import { compareVersions, isNewerVersion } from "./semver";
-import type { VersionCheck as VersionCheckType } from "./specs/Version.nitro";
-
-const HybridVersionCheck = NitroModules.createHybridObject<VersionCheckType>("VersionCheck");
-
-// Cached at module init — plain JS values, no JSI overhead on repeated access.
-const version = HybridVersionCheck.version;
-const buildNumber = HybridVersionCheck.buildNumber;
-const packageName = HybridVersionCheck.packageName;
-const installSource = HybridVersionCheck.installSource;
-
-/**
- * Returns the device's current 2-letter ISO country code.
- *
- * @example
- * ```ts
- * getCountry() // "US"
- * ```
- */
-export const getCountry = () => HybridVersionCheck.getCountry();
-
-/**
- * Returns the store URL for this app.
- *
- * Automatically resolves to the App Store on iOS and Play Store on Android.
- *
- * @example
- * ```ts
- * const url = await getStoreUrl();
- * Linking.openURL(url);
- * ```
- */
-export const getStoreUrl = () => HybridVersionCheck.getStoreUrl();
-
-/**
- * Fetches the latest version of this app available in the store.
- *
- * @example
- * ```ts
- * const latest = await getLatestVersion(); // "1.3.0"
- * ```
- */
-export const getLatestVersion = () => HybridVersionCheck.getLatestVersion();
-
-/**
- * Checks whether an app update is available.
- *
- * Uses semantic version comparison. By default checks for any version
- * increase, but you can filter by granularity:
- *
- * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
- * - `"minor"` — returns `true` for major or minor bumps
- * - `"patch"` — returns `true` for any version increase (default)
- *
- * @example
- * ```ts
- * if (await needsUpdate()) {
- *   const url = await getStoreUrl();
- *   Linking.openURL(url);
- * }
- *
- * // Only prompt for major updates
- * const majorUpdate = await needsUpdate({ level: "major" });
- * ```
- */
-export const needsUpdate = async (options?: { level?: UpdateLevel }): Promise<boolean> => {
-  const latest = await HybridVersionCheck.getLatestVersion();
-  return isNewerVersion(version, latest, options?.level ?? "patch");
-};
-
-/**
- * All version-check APIs in one object.
- *
- * @example
- * ```ts
- * VersionCheck.version      // "1.2.0"
- * VersionCheck.buildNumber  // "42"
- * VersionCheck.packageName  // "com.example.app"
- * VersionCheck.getCountry() // "US"
- *
- * const url = await VersionCheck.getStoreUrl();
- * ```
- */
-export const VersionCheck = {
-  /**
-   * The current app version string.
-   *
-   * Read from `CFBundleShortVersionString` on iOS and `versionName` on Android.
-   * Cached at module init, so repeated reads have zero native overhead.
-   *
-   * @example
-   * ```ts
-   * VersionCheck.version // "1.2.0"
-   * ```
-   */
-  version,
-  /**
-   * The current build number.
-   *
-   * Read from `CFBundleVersion` on iOS and `versionCode` on Android.
-   * Cached at module init.
-   *
-   * @example
-   * ```ts
-   * VersionCheck.buildNumber // "42"
-   * ```
-   */
-  buildNumber,
-  /**
-   * The app's unique identifier.
-   *
-   * This is the Bundle ID on iOS and the Application ID on Android.
-   * Cached at module init.
-   *
-   * @example
-   * ```ts
-   * VersionCheck.packageName // "com.example.app"
-   * ```
-   */
-  packageName,
-  /**
-   * Where the app was installed from, or `undefined` for dev/sideloaded builds.
-   *
-   * - iOS: `"appstore"` | `"testflight"` | `undefined`
-   * - Android: `"playstore"` | `undefined`
-   *
-   * @example
-   * ```ts
-   * if (VersionCheck.installSource === "testflight") {
-   *   // running a TestFlight build
-   * }
-   * ```
-   */
-  installSource,
-  /**
-   * Returns the device's current 2-letter ISO country code.
-   *
-   * This is a synchronous Nitro call, no `await` needed.
-   *
-   * @example
-   * ```ts
-   * VersionCheck.getCountry() // "US"
-   * ```
-   */
-  getCountry,
-  /**
-   * Returns the App Store (iOS) or Play Store (Android) URL for this app.
-   *
-   * @example
-   * ```ts
-   * const url = await VersionCheck.getStoreUrl();
-   * Linking.openURL(url);
-   * ```
-   */
-  getStoreUrl,
-  /**
-   * Fetches the latest version of this app available in the store.
-   *
-   * Queries the iTunes API on iOS and the Play Store on Android.
-   *
-   * @example
-   * ```ts
-   * const latest = await VersionCheck.getLatestVersion(); // "1.3.0"
-   * ```
-   */
-  getLatestVersion,
-  /**
-   * Checks whether an app update is available by comparing the current
-   * version against the latest store version.
-   *
-   * @example
-   * ```ts
-   * if (await VersionCheck.needsUpdate()) {
-   *   const url = await VersionCheck.getStoreUrl();
-   *   Linking.openURL(url);
-   * }
-   * ```
-   */
-  needsUpdate: () => HybridVersionCheck.needsUpdate(),
-} as const;
-
-export { compareVersions };
-export type { UpdateLevel };

package/src/semver.ts

@@ -1,54 +0,0 @@
-export type UpdateLevel = "major" | "minor" | "patch";
-
-type SemVer = [major: number, minor: number, patch: number];
-
-function parseVersion(version: string): SemVer {
-  const parts = version.split(".");
-  return [Number(parts[0]) || 0, Number(parts[1]) || 0, Number(parts[2]) || 0];
-}
-
-/**
- * Compares two version strings.
- *
- * @returns `-1` if `v1 < v2`, `0` if equal, `1` if `v1 > v2`
- *
- * @example
- * ```ts
- * compareVersions("1.2.0", "1.3.0") // -1
- * compareVersions("2.0.0", "1.9.9") //  1
- * compareVersions("1.0.0", "1.0.0") //  0
- * ```
- */
-export function compareVersions(v1: string, v2: string): -1 | 0 | 1 {
-  const a = parseVersion(v1);
-  const b = parseVersion(v2);
-
-  for (let i = 0; i < 3; i++) {
-    if (a[i]! > b[i]!) return 1;
-    if (a[i]! < b[i]!) return -1;
-  }
-
-  return 0;
-}
-
-/**
- * Checks whether `latest` is newer than `current` at the given granularity.
- *
- * - `"major"` — only returns `true` for major bumps (1.x → 2.x)
- * - `"minor"` — returns `true` for major or minor bumps
- * - `"patch"` — returns `true` for any version increase (default)
- */
-export function isNewerVersion(current: string, latest: string, level: UpdateLevel = "patch"): boolean {
-  const [curMajor, curMinor, curPatch] = parseVersion(current);
-  const [latMajor, latMinor, latPatch] = parseVersion(latest);
-
-  if (latMajor > curMajor) return true;
-  if (latMajor < curMajor) return false;
-  if (level === "major") return false;
-
-  if (latMinor > curMinor) return true;
-  if (latMinor < curMinor) return false;
-  if (level === "minor") return false;
-
-  return latPatch > curPatch;
-}

package/src/specs/Version.nitro.ts

@@ -1,16 +0,0 @@
-import type { HybridObject } from "react-native-nitro-modules";
-
-export interface VersionCheck
-  extends HybridObject<{
-    ios: "swift";
-    android: "kotlin";
-  }> {
-  readonly version: string;
-  readonly buildNumber: string;
-  readonly packageName: string;
-  readonly installSource: string | undefined;
-  getCountry(): string;
-  getStoreUrl(): Promise<string>;
-  getLatestVersion(): Promise<string>;
-  needsUpdate(): Promise<boolean>;
-}