react-native-timezone 3.1.0 → 3.2.0

package/README.md

@@ -1,28 +1,91 @@
 # React Native Timezone and Region
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/3713253a365fe6a55615/maintainability)](https://codeclimate.com/github/samitha9125/react-native-timezone/maintainability)
-
 A Simple react native module to get the Timezone and the Region of the Android/iOS devices.
 
-# Motivation
+# Why Choose This Library?
+
+## 🔒 Privacy-First
+Unlike other timezone/region libraries, `react-native-timezone` **does NOT require**:
+- ❌ Location permissions (`ACCESS_FINE_LOCATION`, `ACCESS_COARSE_LOCATION`)
+- ❌ `READ_PHONE_STATE` permission (Android)
+- ❌ Additional native dependencies
+
+**This is critical for:**
+- Privacy-conscious apps
+- App Store/Play Store approval (permission justifications)
+- GDPR/CCPA compliance
+
+## 📱 Expo Compatible
+Works seamlessly with **Expo Development Builds** (CNG - Continuous Native Generation):
+```bash
+npx expo install react-native-timezone
+npx expo prebuild
+npx expo run:ios
+```
 
-For a project of mine, I had to acquire the currently selected timezone of the user. Unfortunately, I could not find any react native package or react native in-build function that facilitates this. Thus I created a small library.
+No need for bare React Native workflow—just prebuild and run.
 
-v3.0.0 and above, you can access the Region details. More details can be found below.
+## ⚡ Super Lightweight
+- Zero JavaScript dependencies
+- Native TurboModule (synchronous, no bridge overhead)
+- Minimal footprint (~2KB gzipped)
+
+## 🆕 Modern Architecture
+Fully compatible with React Native's New Architecture (Fabric + TurboModules).
+
+---
 
 # Compatibility
 
-Timezone version 3.0.0 only supports React Native version 0.62.3 and above due to the React Native Regular Expression Denial of Service (ReDoS) vulnerability.
+| React Native | New Architecture | Tested | Notes |
+|--------------|------------------|--------|-------|
+| 0.71.x       | ✅ Stable         | ✅      | First stable TurboModule support |
+| 0.72.x       | ✅                | ✅      | |
+| 0.73.x       | ✅                | ✅      | |
+| 0.74.x       | ✅ Default        | ✅      | New Arch enabled by default |
+| 0.76.x       | ✅                | ✅      | |
+| 0.83.x       | ✅                | ✅      | Latest (Feb 2026) |
+
+**Breaking Changes in React Native:**
+- **0.71**: New Architecture stabilized (TurboModules + Fabric)
+- **0.74**: New Architecture enabled by default
+- **0.76**: Minimum iOS deployment target raised to iOS 15.1
+
+---
+
+# ⚠️ Important: iOS Carrier API Deprecation
+
+Apple has deprecated the entire `CTCarrier` class with **no replacement API**:
+
+| API | Deprecated Since | Status |
+|-----|-----------------|--------|
+| `subscriberCellularProvider` | iOS 12 | ⚠️ Deprecated |
+| `serviceSubscriberCellularProviders` | iOS 16 | ⚠️ Deprecated |
+| `CTCarrier` class | iOS 16 | ❌ No replacement |
 
-| React native version | Tested | Result |
-| -------------------- | ------ | ------ |
-| 0.70.0 +             | ✅     | ✅     |
-| 0.73.0 +             | ✅     | ✅     |
-| 0.76.5 +             | ✅     | ✅     |
+**What this means for `getRegionByTelephony()`:**
+- **iOS < 18**: Works, but triggers deprecation warnings (suppressed in this library)
+- **iOS 18+**: Returns `null` due to Apple's privacy restrictions
+
+**Recommended Pattern:**
+```javascript
+// Use telephony-based region with locale fallback
+const region = Timezone.getRegionByTelephony() ?? Timezone.getRegionByLocale();
+```
+
+This is an Apple platform limitation, not a bug in this library.
+
+---
+
+# Motivation
+
+For a project of mine, I had to acquire the currently selected timezone of the user. Unfortunately, I could not find any react native package or react native in-build function that facilitates this. Thus I created a small library.
+
+v3.0.0 and above, you can access the Region details. More details can be found below.
 
 # Installation
 
-`npm i react-native-timezone`
+`yarn add react-native-timezone`
 
 ## iOS
 
@@ -54,5 +117,5 @@ Check out the [example](https://github.com/samitha9125/react-native-timezone/tre
 | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
 | getTimeZone           | Android: Returns timezone ID using `java.util.TimeZone.getID()`<br>iOS: Reflects the current system time zone using `localTimeZone` of `NSTimeZone` |
 | isAutoTimeZoneEnabled | Returns a boolean indicating if auto timezone is enabled on the device **(Android Only)**                                                           |
-| getRegionByTelephony  | Retrieves the region information based on the telephony (SIM card) of the device. Returns `undefined` if the device has no SIM card.                |
+| getRegionByTelephony  | Retrieves the region information based on the telephony (SIM card) of the device. Returns `null` if the device has no SIM card.                     |
 | getRegionByLocale     | Retrieves the region information based on the device's locale settings                                                                              |

package/android/src/main/java/com/samitha/timezone/TimezoneModule.kt

@@ -1,6 +1,7 @@
 package com.samitha.timezone
 
 import android.content.ContentResolver
+import android.content.Context
 import android.os.Build
 import android.provider.Settings
 import android.telephony.TelephonyManager
@@ -54,7 +55,7 @@ class TimezoneModule(reactContext: ReactApplicationContext) :
   @ReactMethod(isBlockingSynchronousMethod = true)
   override fun getRegionByTelephony(): String? {
     return try {
-      val telephonyService = reactApplicationContext.getSystemService(ReactApplicationContext.TELEPHONY_SERVICE) as? TelephonyManager
+      val telephonyService = reactApplicationContext.getSystemService(Context.TELEPHONY_SERVICE) as? TelephonyManager
       telephonyService?.networkCountryIso
     } catch (e: Exception) {
       null

package/ios/Timezone.mm

@@ -3,7 +3,7 @@
 #import "Timezone.h"
 
 @implementation Timezone
-    RCT_EXPORT_MODULE('Timezone');
+    RCT_EXPORT_MODULE(Timezone);
     /**
     * This is a Synchronous method.
     * Retrieves the current time zone name.
@@ -17,15 +17,48 @@
     /**
     * Synchronous method.
     * Gets the region based on the telephony manager's network country ISO.
+    *
+    * ⚠️ DEPRECATION NOTICE:
+    * - subscriberCellularProvider: Deprecated iOS 12+
+    * - serviceSubscriberCellularProviders: Deprecated iOS 16+
+    * - CTCarrier class: Deprecated iOS 16+ with NO REPLACEMENT
+    *
+    * Starting iOS 18, these APIs return nil due to privacy restrictions.
+    * Apple has intentionally removed carrier info access with no alternative.
+    * Consider using getRegionByLocale() as a fallback.
     */
     RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getRegionByTelephony)
     {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
+        
         CTTelephonyNetworkInfo *networkInfo = [[CTTelephonyNetworkInfo alloc] init];
-        CTCarrier *carrier = [networkInfo subscriberCellularProvider];
-        NSString *isoCountryCode = [carrier isoCountryCode];
+        NSString *isoCountryCode = nil;
+        
+        // iOS 12+: Check all cellular providers (multi-SIM support)
+        if (@available(iOS 12.0, *)) {
+            NSDictionary *carriers = [networkInfo serviceSubscriberCellularProviders];
+            
+            if (carriers && carriers.count > 0) {
+                // Get the first available carrier's country code
+                CTCarrier *carrier = [carriers.allValues firstObject];
+                isoCountryCode = [carrier isoCountryCode];
+            }
+        }
+        
+        // Fallback for iOS < 12 OR if iOS 12+ returns nothing
+        if (isoCountryCode == nil || [isoCountryCode isEqualToString:@""]) {
+            CTCarrier *carrier = [networkInfo subscriberCellularProvider];
+            isoCountryCode = [carrier isoCountryCode];
+        }
+        
+#pragma clang diagnostic pop
+        
+        // iOS 18+: Will likely return nil due to privacy restrictions
         if (isoCountryCode == nil || [isoCountryCode isEqualToString:@""]) {
             return nil;
         }
+        
         return isoCountryCode;
     }
 

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "react-native-timezone",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "A Simple react native module to get Timezone and Region of the Android/iOS devices.",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
+  "scripts": {
+    "example": "pnpm --filter react-native-timezone-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "release-it"
+  },
   "exports": {
     ".": {
       "import": {
@@ -22,7 +31,6 @@
     "lib",
     "android",
     "ios",
-    "cpp",
     "*.podspec",
     "react-native.config.js",
     "!ios/build",
@@ -36,20 +44,6 @@
     "!**/__mocks__",
     "!**/.*"
   ],
-  "scripts": {
-    "example": "yarn workspace react-native-timezone-example",
-    "test": "jest",
-    "typecheck": "tsc",
-    "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
-    "prepare": "bob build",
-    "release": "release-it"
-  },
-  "keywords": [
-    "react-native",
-    "ios",
-    "android"
-  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/samitha9125/react-native-timezone.git"
@@ -89,69 +83,10 @@
     "@types/react": "^18.2.44"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
-  },
-  "workspaces": [
-    "example"
-  ],
-  "packageManager": "yarn@3.6.1",
-  "jest": {
-    "preset": "react-native",
-    "modulePathIgnorePatterns": [
-      "<rootDir>/example/node_modules",
-      "<rootDir>/lib/"
-    ]
-  },
-  "commitlint": {
-    "extends": [
-      "@commitlint/config-conventional"
-    ]
-  },
-  "release-it": {
-    "git": {
-      "commitMessage": "chore: release ${version}",
-      "tagName": "v${version}",
-      "requireBranch": "main"
-    },
-    "npm": {
-      "publish": true
-    },
-    "github": {
-      "release": true
-    }
-  },
-  "eslintConfig": {
-    "root": true,
-    "extends": [
-      "@react-native",
-      "prettier"
-    ],
-    "rules": {
-      "react/react-in-jsx-scope": "off",
-      "prettier/prettier": [
-        "error",
-        {
-          "quoteProps": "consistent",
-          "singleQuote": true,
-          "tabWidth": 2,
-          "trailingComma": "es5",
-          "useTabs": false
-        }
-      ]
-    }
-  },
-  "eslintIgnore": [
-    "node_modules/",
-    "lib/"
-  ],
-  "prettier": {
-    "quoteProps": "consistent",
-    "singleQuote": true,
-    "tabWidth": 2,
-    "trailingComma": "es5",
-    "useTabs": false
+    "react": ">=18.0.0",
+    "react-native": ">=0.71.0"
   },
+  "packageManager": "pnpm@9.15.4",
   "react-native-builder-bob": {
     "source": "src",
     "output": "lib",