react-native-nitro-version-check 1.0.2 → 2.0.0

package/README.md

@@ -15,7 +15,7 @@
 ## Example
 
 ```ts
-import { VersionCheck, needsUpdate, getStoreUrl } from 'react-native-nitro-version-check'
+import { VersionCheck } from 'react-native-nitro-version-check'
 
 // Sync — no bridge, no async
 VersionCheck.version       // "1.2.0"
@@ -23,9 +23,12 @@ VersionCheck.buildNumber   // "42"
 VersionCheck.packageName   // "com.example.app"
 VersionCheck.installSource // "appstore" | "testflight" | "playstore" | undefined
 
+// Or destructure properties
+const { version, buildNumber, packageName, installSource } = VersionCheck
+
 // Check for updates
-if (await needsUpdate()) {
-  Linking.openURL(await getStoreUrl())
+if (await VersionCheck.needsUpdate()) {
+  Linking.openURL(await VersionCheck.getStoreUrl())
 }
 ```
 
@@ -35,11 +38,16 @@ if (await needsUpdate()) {
 bun add react-native-nitro-version-check
 ```
 
+> **Version 2.x and newer requires Nitro 0.35+** — for earlier versions, use version 1.x
+>
+> Check the [full installation guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/installation) for platform setup and additional dependencies.
+
 ## Documentation
 
 - [**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)
+- [**Compatibility** guide](https://alshehriali0.github.io/react-native-nitro-version-check/docs/compatibility)
 - [**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)
 

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/NitroVersionCheckOnLoad.cpp

@@ -26,20 +26,27 @@ int initialize(JavaVM* vm) {
   });
 }
 
+struct JHybridVersionCheckSpecImpl: public jni::JavaClass<JHybridVersionCheckSpecImpl, JHybridVersionCheckSpec::JavaPart> {
+  static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitroversioncheck/HybridVersionCheck;";
+  static std::shared_ptr<JHybridVersionCheckSpec> create() {
+    static auto constructorFn = javaClassStatic()->getConstructor<JHybridVersionCheckSpecImpl::javaobject()>();
+    jni::local_ref<JHybridVersionCheckSpec::JavaPart> javaPart = javaClassStatic()->newObject(constructorFn);
+    return javaPart->getJHybridVersionCheckSpec();
+  }
+};
+
 void registerAllNatives() {
   using namespace margelo::nitro;
   using namespace margelo::nitro::nitroversioncheck;
 
   // Register native JNI methods
-  margelo::nitro::nitroversioncheck::JHybridVersionCheckSpec::registerNatives();
+  margelo::nitro::nitroversioncheck::JHybridVersionCheckSpec::CxxPart::registerNatives();
 
   // Register Nitro Hybrid Objects
   HybridObjectRegistry::registerHybridObjectConstructor(
     "VersionCheck",
     []() -> std::shared_ptr<HybridObject> {
-      static DefaultConstructableObject<JHybridVersionCheckSpec::javaobject> object("com/margelo/nitro/nitroversioncheck/HybridVersionCheck");
-      auto instance = object.create();
-      return instance->cthis()->shared();
+      return JHybridVersionCheckSpecImpl::create();
     }
   );
 }

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

@@ -16,70 +16,64 @@
 
 namespace margelo::nitro::nitroversioncheck {
 
-  jni::local_ref<JHybridVersionCheckSpec::jhybriddata> JHybridVersionCheckSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
-    return makeCxxInstance(jThis);
-  }
-
-  void JHybridVersionCheckSpec::registerNatives() {
-    registerHybrid({
-      makeNativeMethod("initHybrid", JHybridVersionCheckSpec::initHybrid),
-    });
+  std::shared_ptr<JHybridVersionCheckSpec> JHybridVersionCheckSpec::JavaPart::getJHybridVersionCheckSpec() {
+    auto hybridObject = JHybridObject::JavaPart::getJHybridObject();
+    auto castHybridObject = std::dynamic_pointer_cast<JHybridVersionCheckSpec>(hybridObject);
+    if (castHybridObject == nullptr) [[unlikely]] {
+      throw std::runtime_error("Failed to downcast JHybridObject to JHybridVersionCheckSpec!");
+    }
+    return castHybridObject;
   }
 
-  size_t JHybridVersionCheckSpec::getExternalMemorySize() noexcept {
-    static const auto method = javaClassStatic()->getMethod<jlong()>("getMemorySize");
-    return method(_javaPart);
+  jni::local_ref<JHybridVersionCheckSpec::CxxPart::jhybriddata> JHybridVersionCheckSpec::CxxPart::initHybrid(jni::alias_ref<jhybridobject> jThis) {
+    return makeCxxInstance(jThis);
   }
 
-  bool JHybridVersionCheckSpec::equals(const std::shared_ptr<HybridObject>& other) {
-    if (auto otherCast = std::dynamic_pointer_cast<JHybridVersionCheckSpec>(other)) {
-      return _javaPart == otherCast->_javaPart;
+  std::shared_ptr<JHybridObject> JHybridVersionCheckSpec::CxxPart::createHybridObject(const jni::local_ref<JHybridObject::JavaPart>& javaPart) {
+    auto castJavaPart = jni::dynamic_ref_cast<JHybridVersionCheckSpec::JavaPart>(javaPart);
+    if (castJavaPart == nullptr) [[unlikely]] {
+      throw std::runtime_error("Failed to cast JHybridObject::JavaPart to JHybridVersionCheckSpec::JavaPart!");
     }
-    return false;
+    return std::make_shared<JHybridVersionCheckSpec>(castJavaPart);
   }
 
-  void JHybridVersionCheckSpec::dispose() noexcept {
-    static const auto method = javaClassStatic()->getMethod<void()>("dispose");
-    method(_javaPart);
-  }
-
-  std::string JHybridVersionCheckSpec::toString() {
-    static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
-    auto javaString = method(_javaPart);
-    return javaString->toStdString();
+  void JHybridVersionCheckSpec::CxxPart::registerNatives() {
+    registerHybrid({
+      makeNativeMethod("initHybrid", JHybridVersionCheckSpec::CxxPart::initHybrid),
+    });
   }
 
   // Properties
   std::string JHybridVersionCheckSpec::getVersion() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getVersion");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getVersion");
     auto __result = method(_javaPart);
     return __result->toStdString();
   }
   std::string JHybridVersionCheckSpec::getBuildNumber() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getBuildNumber");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getBuildNumber");
     auto __result = method(_javaPart);
     return __result->toStdString();
   }
   std::string JHybridVersionCheckSpec::getPackageName() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getPackageName");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getPackageName");
     auto __result = method(_javaPart);
     return __result->toStdString();
   }
   std::optional<std::string> JHybridVersionCheckSpec::getInstallSource() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getInstallSource");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getInstallSource");
     auto __result = method(_javaPart);
     return __result != nullptr ? std::make_optional(__result->toStdString()) : std::nullopt;
   }
 
   // Methods
   std::string JHybridVersionCheckSpec::getCountry() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getCountry");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getCountry");
     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 = _javaPart->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 +87,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 = _javaPart->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) {
@@ -110,7 +104,7 @@ namespace margelo::nitro::nitroversioncheck {
     }();
   }
   std::shared_ptr<Promise<bool>> JHybridVersionCheckSpec::needsUpdate() {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("needsUpdate");
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("needsUpdate");
     auto __result = method(_javaPart);
     return [&]() {
       auto __promise = Promise<bool>::create();

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

@@ -18,34 +18,33 @@ namespace margelo::nitro::nitroversioncheck {
 
   using namespace facebook;
 
-  class JHybridVersionCheckSpec: public jni::HybridClass<JHybridVersionCheckSpec, JHybridObject>,
-                                 public virtual HybridVersionCheckSpec {
+  class JHybridVersionCheckSpec: public virtual HybridVersionCheckSpec, public virtual JHybridObject {
   public:
-    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitroversioncheck/HybridVersionCheckSpec;";
-    static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
-    static void registerNatives();
-
-  protected:
-    // C++ constructor (called from Java via `initHybrid()`)
-    explicit JHybridVersionCheckSpec(jni::alias_ref<jhybridobject> jThis) :
-      HybridObject(HybridVersionCheckSpec::TAG),
-      HybridBase(jThis),
-      _javaPart(jni::make_global(jThis)) {}
+    struct JavaPart: public jni::JavaClass<JavaPart, JHybridObject::JavaPart> {
+      static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitroversioncheck/HybridVersionCheckSpec;";
+      std::shared_ptr<JHybridVersionCheckSpec> getJHybridVersionCheckSpec();
+    };
+    struct CxxPart: public jni::HybridClass<CxxPart, JHybridObject::CxxPart> {
+      static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitroversioncheck/HybridVersionCheckSpec$CxxPart;";
+      static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
+      static void registerNatives();
+      using HybridBase::HybridBase;
+    protected:
+      std::shared_ptr<JHybridObject> createHybridObject(const jni::local_ref<JHybridObject::JavaPart>& javaPart) override;
+    };
 
   public:
+    explicit JHybridVersionCheckSpec(const jni::local_ref<JHybridVersionCheckSpec::JavaPart>& javaPart):
+      HybridObject(HybridVersionCheckSpec::TAG),
+      JHybridObject(javaPart),
+      _javaPart(jni::make_global(javaPart)) {}
     ~JHybridVersionCheckSpec() override {
       // Hermes GC can destroy JS objects on a non-JNI Thread.
       jni::ThreadScope::WithClassLoader([&] { _javaPart.reset(); });
     }
 
   public:
-    size_t getExternalMemorySize() noexcept override;
-    bool equals(const std::shared_ptr<HybridObject>& other) override;
-    void dispose() noexcept override;
-    std::string toString() override;
-
-  public:
-    inline const jni::global_ref<JHybridVersionCheckSpec::javaobject>& getJavaPart() const noexcept {
+    inline const jni::global_ref<JHybridVersionCheckSpec::JavaPart>& getJavaPart() const noexcept {
       return _javaPart;
     }
 
@@ -59,14 +58,12 @@ 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:
-    friend HybridBase;
-    using HybridBase::HybridBase;
-    jni::global_ref<JHybridVersionCheckSpec::javaobject> _javaPart;
+    jni::global_ref<JHybridVersionCheckSpec::JavaPart> _javaPart;
   };
 
 } // namespace margelo::nitro::nitroversioncheck

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

@@ -25,23 +25,6 @@ import com.margelo.nitro.core.HybridObject
   "LocalVariableName", "PropertyName", "PrivatePropertyName", "FunctionName"
 )
 abstract class HybridVersionCheckSpec: HybridObject() {
-  @DoNotStrip
-  private var mHybridData: HybridData = initHybrid()
-
-  init {
-    super.updateNative(mHybridData)
-  }
-
-  override fun updateNative(hybridData: HybridData) {
-    mHybridData = hybridData
-    super.updateNative(hybridData)
-  }
-
-  // Default implementation of `HybridObject.toString()`
-  override fun toString(): String {
-    return "[HybridObject VersionCheck]"
-  }
-
   // Properties
   @get:DoNotStrip
   @get:Keep
@@ -66,17 +49,31 @@ 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
   abstract fun needsUpdate(): Promise<Boolean>
 
-  private external fun initHybrid(): HybridData
+  // Default implementation of `HybridObject.toString()`
+  override fun toString(): String {
+    return "[HybridObject VersionCheck]"
+  }
+
+  // C++ backing class
+  @DoNotStrip
+  @Keep
+  protected open class CxxPart(javaPart: HybridVersionCheckSpec): HybridObject.CxxPart(javaPart) {
+    // C++ JHybridVersionCheckSpec::CxxPart::initHybrid(...)
+    external override fun initHybrid(): HybridData
+  }
+  override fun createCxxPart(): CxxPart {
+    return CxxPart(this)
+  }
 
   companion object {
     protected const val TAG = "HybridVersionCheckSpec"

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,6 +1,6 @@
 {
   "name": "react-native-nitro-version-check",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "A lightweight, fast version-checking library for React Native, powered by Nitro Modules",
   "main": "lib/index",
   "module": "lib/index",
@@ -8,9 +8,8 @@
   "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 .",
@@ -149,17 +151,20 @@
   },
   "devDependencies": {
     "@release-it/conventional-changelog": "^10.0.5",
+    "@types/jest": "^29.5.12",
     "@types/react": "^19.1.03",
-    "nitrogen": "*",
+    "jest": "^29.7.0",
+    "nitrogen": "^0.35.0",
     "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": {
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": ">=32.0"
+    "react-native-nitro-modules": ">=35.0"
   }
 }

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>;
-}