feat: add countryCode option to VersionCheck for region-specific updates

- Introduced a new `countryCode` parameter in the `needsUpdate`.
- Updated documentation to reflect the new option and its usage.

Author: AlshehriAli0

docs/docs/api-reference.md

@@ -85,13 +85,19 @@ if (await VersionCheck.needsUpdate()) {
 if (await VersionCheck.needsUpdate({ level: 'major' })) {
   // ...
 }
+
+// Check against a specific App Store region
+if (await VersionCheck.needsUpdate({ countryCode: 'US' })) {
+  // ...
+}
 ```
 
 #### Options
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `level` | `"major" \| "minor" \| "patch"` | `"patch"` | Minimum version bump to trigger `true` |
+| `countryCode` | `string` | device country | 2-letter ISO country code (iOS only, ignored on Android) |
 
 - `"major"` — only returns `true` for major bumps (1.x → 2.x)
 - `"minor"` — returns `true` for major or minor bumps

docs/docs/compatibility.md

@@ -0,0 +1,43 @@
+---
+sidebar_position: 3
+title: Compatibility
+---
+
+# Compatibility
+
+This page documents the compatibility between different versions of `react-native-nitro-version-check` and the Nitro ecosystem.
+
+## Version Matrix
+
+| `react-native-nitro-version-check` Version | `react-native-nitro-modules` | Status |
+|---|---|---|
+| v1.x | 0.32.0 - 0.34.x | Stable |
+| v2.0.0+ | 0.35.0+ | Current |
+
+## Nitro 0.35.0 and Later
+
+**Version 2.x and newer is fully built around Nitro 0.35+ support.** All v1.x versions work with Nitro 0.32.0 - 0.34.x.
+
+
+### Upgrading from v1.x to v2.0.0+
+
+When you're ready to upgrade to v2.0.0, ensure you have `react-native-nitro-modules` 0.35.0+:
+
+```sh
+bun add react-native-nitro-modules@0.35.0
+bun add react-native-nitro-version-check@2.0.0
+```
+
+Then rebuild your app:
+
+```sh
+# For Expo
+bunx expo prebuild --clean
+
+# For bare React Native
+cd ios && pod install
+```
+
+### Staying on v1.x
+
+All v1.x versions work with Nitro 0.32.0 - 0.34.x. When you upgrade to Nitro 0.35.0+, you'll need to upgrade to v2.0.0+.

docs/docs/usage-examples.md

@@ -67,6 +67,9 @@ const hasMinorUpdate = await VersionCheck.needsUpdate({ level: 'minor' })
 
 // Returns true for any version increase (default)
 const hasAnyUpdate = await VersionCheck.needsUpdate({ level: 'patch' })
+
+// Check against a specific App Store region (iOS only)
+const needsUpdateUS = await VersionCheck.needsUpdate({ countryCode: 'US' })
 ```
 
 ## Detect Install Source

package/package.json

@@ -89,9 +89,7 @@
     "npm": {
       "publish": true,
       "skipChecks": true,
-      "publishArgs": [
-        "--provenance --access public"
-      ]
+      "publishArgs": ["--provenance --access public"]
     },
     "github": {
       "release": true

package/src/__tests__/index.test.ts

@@ -105,6 +105,20 @@ describe("VersionCheck API", () => {
       }
     });
 
+    it("should accept options with countryCode parameter", async () => {
+      const result = VersionCheck.needsUpdate({ countryCode: "US" });
+      expect(result).toBeInstanceOf(Promise);
+      const resolved = await result;
+      expect(typeof resolved).toBe("boolean");
+    });
+
+    it("should accept both level and countryCode options together", async () => {
+      const result = VersionCheck.needsUpdate({ level: "major", countryCode: "GB" });
+      expect(result).toBeInstanceOf(Promise);
+      const resolved = await result;
+      expect(typeof resolved).toBe("boolean");
+    });
+
     it("should default to patch level when no options provided", async () => {
       const result = await VersionCheck.needsUpdate();
       expect(typeof result).toBe("boolean");

package/src/index.ts

@@ -143,6 +143,12 @@ export const VersionCheck = {
    * - `"minor"` — returns `true` for major or minor bumps
    * - `"patch"` — returns `true` for any version increase (default)
    *
+   * @param options - Optional configuration
+   * @param options.level - Update granularity to check for. Defaults to `"patch"`.
+   * @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
    * if (await VersionCheck.needsUpdate()) {
@@ -152,10 +158,13 @@ export const VersionCheck = {
    *
    * // Only prompt for major updates
    * const majorUpdate = await VersionCheck.needsUpdate({ level: "major" });
+   *
+   * // Check against a specific App Store region
+   * const needsUpdateUS = await VersionCheck.needsUpdate({ countryCode: "US" });
    * ```
    */
-  needsUpdate: async (options?: { level?: UpdateLevel }): Promise<boolean> => {
-    const latest = await HybridVersionCheck.getLatestVersion();
+  needsUpdate: async (options?: { level?: UpdateLevel; countryCode?: string }): Promise<boolean> => {
+    const latest = await HybridVersionCheck.getLatestVersion(options?.countryCode);
     return isNewerVersion(version, latest, options?.level ?? "patch");
   },
   /**