Merge branch 'master' into feature/SDK-548-feature-parity

Author: jferrao-itrbl

.github/workflows/codeql.yml

@@ -175,7 +175,29 @@ jobs:
       - name: Setup
         uses: ./.github/actions/setup
 
-        # Initializes the CodeQL tools for scanning.
+      - uses: maxim-lobanov/setup-xcode@60606e260d2fc5762a71e64e74b2174e8ea3c8bd # v1.6.0
+        with:
+          xcode-version: '16.4'
+
+      - name: Print available simulators
+        run: xcrun simctl list devices | cat
+
+      - name: Get latest stable iOS version
+        id: ios-version
+        run: |
+          # First try to find iOS 18.x that's available
+          LATEST_IOS=$(xcrun simctl list runtimes | grep "iOS 18" | grep -v "watchOS" | grep -v "beta" | grep -v "Beta" | grep -v "unavailable" | tail -1 | sed 's/.*iOS \([0-9]*\.[0-9]*\).*/\1/')
+
+          # If no iOS 18.x available, fall back to any available iOS version
+          if [ -z "$LATEST_IOS" ]; then
+            echo "No iOS 18.x available, falling back to latest available iOS version..."
+            LATEST_IOS=$(xcrun simctl list runtimes | grep "iOS" | grep -v "watchOS" | grep -v "beta" | grep -v "Beta" | grep -v "unavailable" | tail -1 | sed 's/.*iOS \([0-9]*\.[0-9]*\).*/\1/')
+          fi
+
+          echo "version=$LATEST_IOS" >> $GITHUB_OUTPUT
+          echo "Latest stable iOS version: $LATEST_IOS"
+
+      # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v4
         with:
@@ -188,15 +210,16 @@ jobs:
           # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
           queries: ${{ matrix.language && 'security-extended, security-and-quality' }}
 
-      - if: matrix.build-mode == 'manual'
+      - name: Build example for CodeQL
+        if: matrix.build-mode == 'manual'
         shell: bash
         run: |
           cd example
           yarn install
           cd ios
           bundle install
           bundle exec pod install
-          xcodebuild -workspace ReactNativeSdkExample.xcworkspace -scheme ReactNativeSdkExample -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 16' build
+          xcodebuild -workspace ReactNativeSdkExample.xcworkspace -scheme ReactNativeSdkExample -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 16 Pro,OS=${{ steps.ios-version.outputs.version }}' build
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v4

CHANGELOG.md

@@ -6,6 +6,14 @@
   - iOS: forwards to native `IterableAPI.disableDeviceForAllUsers()`.
   - Android: graceful no-op that logs a warning; use `disableDeviceForCurrentUser()` to disable push for the current user. There is no public native "all users" equivalent.
 
+## 3.2.0
+
+### Updates
+
+- Bumped native SDK pins to Android [3.10.1](https://github.com/Iterable/iterable-android-sdk/releases/tag/3.10.1) and iOS [6.7.5](https://github.com/Iterable/swift-sdk/releases/tag/6.7.5). This is a native SDK bump, not new JS APIs.
+  - Android now pulls `androidx.work:work-runtime:2.9.0` as a transitive dependency (WorkManager replaced AsyncTask-based push handling in native 3.7.0). No app code change is required.
+  - On iOS, `enableUnknownUserActivation` now defaults to `false` (fixed in native 6.7.1). RN 3.1.0 pinned iOS 6.6.7, where this flag defaulted to `true`, so iOS apps were accidentally running unknown-user activation. This release does not expose that config; unknown-user activation stays off on iOS unless a later RN release adds the API. Android's default was already `false`.
+
 ## 3.1.0
 
 ### Fixes

Iterable-React-Native-SDK.podspec

@@ -17,7 +17,7 @@ Pod::Spec.new do |s|
   s.private_header_files = "ios/**/*.h"
 
   # Load Iterables iOS SDK as a dependency
-  s.dependency "Iterable-iOS-SDK", "6.6.7"
+  s.dependency "Iterable-iOS-SDK", "6.7.5"
 
   # Basic Swift support
   s.pod_target_xcconfig = {

README.md

@@ -24,6 +24,7 @@ Iterable. It supports JavaScript and TypeScript.
   - [Beta Versions](#beta-versions)
   - [Features](#features)
   - [Example project](#example-project)
+  - [Building a local npm package](#building-a-local-npm-package)
   - [Version mapping](#version-mapping)
   - [Release notes, support and troubleshooting](#release-notes-support-and-troubleshooting)
   - [License](#license)
@@ -38,8 +39,8 @@ Iterable. It supports JavaScript and TypeScript.
 Iterable's React Native SDK relies on:
 
 - **React Native**
-    - [React Native 0.75+](https://github.com/facebook/react-native)
-    - [React 18.1+](https://github.com/facebook/react)
+    - [React Native 0.77+](https://github.com/facebook/react-native)
+    - [React 18.3.1+](https://github.com/facebook/react)
 
     _UI Components require additional peer dependencies_
     - [React Navigation 6+](https://github.com/react-navigation/react-navigation)
@@ -54,6 +55,7 @@ Iterable's React Native SDK relies on:
       ```ruby
       use_frameworks! :linkage => :dynamic
       ```
+    - **Xcode 27:** `run-ios` needs `@react-native-community/cli` **20.2.0+** so it opens Device Hub (`DeviceHub.app`) instead of `Simulator.app`. `xcode-select` must point at the Xcode you are using when more than one version is installed. Xcode 27 also refuses CocoaPods resource-bundle targets below iOS **15.0** (this SDK's `IterableSDKResources` bundle still inherits **12.0** from Iterable-iOS-SDK, including **6.7.5** pinned by RN **3.2.0**). Lift generated Pods targets to **15.1** in the app `Podfile` `post_install` — see this repo's `example/ios/Podfile`. That is a **host** workaround until Iterable's iOS SDK publishes a ≥ 15.1 minimum and this SDK depends on it. It does not change the published Iterable iOS support range.
 
 - **Android**
     - [`minSdkVersion` 21+, `compileSdkVersion` 31+](https://medium.com/androiddevelopers/picking-your-compilesdkversion-minsdkversion-targetsdkversion-a098a0341ebd)
@@ -118,12 +120,28 @@ For sample code, take a look at the following project:
 
 - [Example App](https://github.com/Iterable/react-native-sdk/tree/master/example)
 
+## Building a local npm package
+
+Generate a `.tgz` from **this** React Native SDK checkout. Do not run `npm pack` from a consuming app; that will not produce `@iterable/react-native-sdk`.
+
+From the root of this repository:
+
+```bash
+yarn install
+npm pack
+```
+
+`yarn install` runs `prepare` / `yarn build`. `npm pack` writes
+`iterable-react-native-sdk-<version>.tgz` in the repo root, using the version
+in `package.json` (for example `iterable-react-native-sdk-3.2.0.tgz`).
+
 ## Version mapping
 
 For quick reference, the following table lists the versions of the [Android SDK](https://github.com/Iterable/iterable-android-sdk) and the [iOS SDK](https://github.com/Iterable/swift-sdk) the React Native SDK points to for version 1.2.0 and above.
 
 | RN SDK Version                                                              | Android SDK Version                                                          | iOS SDK Version |
 | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------- |
+| [3.2.0](https://www.npmjs.com/package/@iterable/react-native-sdk/v/3.2.0) | [3.10.1](https://github.com/Iterable/iterable-android-sdk/releases/tag/3.10.1) | [6.7.5](https://github.com/Iterable/swift-sdk/releases/tag/6.7.5)
 | [3.1.0](https://www.npmjs.com/package/@iterable/react-native-sdk/v/3.1.0) | [3.6.2](https://github.com/Iterable/iterable-android-sdk/releases/tag/3.6.2) | [6.6.7](https://github.com/Iterable/swift-sdk/releases/tag/6.6.7)
 | [3.0.1](https://www.npmjs.com/package/@iterable/react-native-sdk/v/3.0.1) | [3.6.2](https://github.com/Iterable/iterable-android-sdk/releases/tag/3.6.2) | [6.6.3](https://github.com/Iterable/swift-sdk/releases/tag/6.6.3)
 | [3.0.0](https://www.npmjs.com/package/@iterable/react-native-sdk/v/3.0.0) | [3.6.2](https://github.com/Iterable/iterable-android-sdk/releases/tag/3.6.2) | [6.6.3](https://github.com/Iterable/swift-sdk/releases/tag/6.6.3)

android/build.gradle

@@ -105,7 +105,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  api "com.iterable:iterableapi:3.6.2"
+  api "com.iterable:iterableapi:3.10.1"
     // api project(":iterableapi") // links to local android SDK repo rather than by release
 }
 

example/README.md

@@ -11,27 +11,15 @@ React Native application.
 >"Creating a new application" step, before proceeding.
 
 ## Step 1: Install dependencies
-To install the app dependencies, run the following command from the
-_example app directory_ (the directory in which this document resides):
 
-```bash
-yarn install
-```
-
-Once this is done, you will need to install the pods in the _ios_ folder in the
-_example app directory_.  To do so, run the following:
+From the **SDK repo root** (the parent of this `example/` directory):
 
 ```bash
-cd ios
-bundle install
-bundle exec pod install
+yarn install
+(cd example/ios && bundle install && bundle exec pod install)
 ```
 
-Once this is done, `cd` back into the _example app directory_:
-
-```bash
-cd ..
-```
+`yarn install` at the root installs the Yarn workspace (SDK + example). The `example/ios` step is **iOS only** — skip it if you are only running Android.
 
 ## Step 2: Add your environment variables
 In the _example app directory_, there is a file called **.env.example**.  Make a
@@ -69,36 +57,26 @@ To add an API key, do the following:
  6. Copy the generated API key and JWT secret into your _.env_ file
 
 
-## Step 3: Start the Metro Server
+## Step 3: Start your Application
 
-First, you will need to start **Metro**, the JavaScript _bundler_ that ships _with_ React Native.
-
-To start Metro, run the following command from the _example app directory_:
+From the **SDK repo root**, run one of:
 
 ```bash
-yarn start
+yarn example android
 ```
 
-## Step 4: Start your Application
-
-Let Metro Bundler run in its _own_ terminal. Open a _new_ terminal from the _example app directory_. Run the following command to start your _Android_ or _iOS_ app:
-
-### For Android
-
 ```bash
-yarn android
+yarn example ios
 ```
 
-### For iOS
+`run-android` / `run-ios` start **Metro** in a separate terminal by default. You do not need to run `yarn start` first. Pass `--no-packager` if you already have Metro running and do not want a second window.
 
-```bash
-yarn ios
-```
+On **Xcode 27**, the CLI opens **Device Hub** (`DeviceHub.app`) instead of Simulator. This example pins `@react-native-community/cli` **20.2.0+** for that path. If several Xcode versions are installed, `xcode-select -p` must point at the one you intend to use.
 
 **NOTE**: If you are getting an error when running ios, make sure that *Xcode > Project Navigator > ReactNativeSdkExample > Build Settings > User
    Script Sandboxing* is set to **No**
 
-If everything is set up _correctly_, you should see your new app running in your _Android Emulator_ or _iOS Simulator_ shortly provided you have set up your emulator/simulator correctly.
+If everything is set up _correctly_, you should see your new app running in your _Android Emulator_ or on iOS (Simulator on Xcode 26 and earlier, Device Hub on Xcode 27) shortly provided you have set up your emulator/simulator correctly.
 
 This is one way to run your app — you can also run it directly from within Android Studio and Xcode respectively.
 
@@ -218,6 +196,12 @@ gem install xcodeproj -v '< 1.26.0'
 gem install concurrent-ruby -v '< 1.3.4'
 ```
 
+## Xcode 27
+
+Xcode 27 replaces `Simulator.app` with Device Hub. `yarn ios` / `yarn example ios` require `@react-native-community/cli` **20.2.0+** (this example already pins it). A `Simulator.app does not exist` error means an older CLI is still on the path, or `xcode-select` points at a different Xcode.
+
+Xcode 27's iOS SDK also rejects any target with `IPHONEOS_DEPLOYMENT_TARGET` below **15.0**, including CocoaPods resource bundles such as `Iterable-iOS-SDK-IterableSDKResources` (12.0 from Iterable-iOS-SDK, including **6.7.5** pinned by RN **3.2.0**). This example's `ios/Podfile` `post_install` lifts generated Pods targets to **15.1**. Copy that lift into a host app Podfile if you hit the same `xcodebuild` 65 error. It does not change Iterable-iOS-SDK's published minimum; that wait is a later iOS SDK release that raises the platform to ≥ 15.1.
+
 ## Xcode 16.3 Issue
 
 There is a [known issue](https://github.com/facebook/react-native/issues/50411)

example/ios/Podfile

@@ -34,17 +34,22 @@ target 'ReactNativeSdkExample' do
     )
 
 
-    ## Temporary workaround for Xcode 26.4
+    # Temporary workaround for Xcode 26.x / 27.
+    # fmt 11.0.2 fails consteval checks under Apple Clang 21; compile fmt as C++17 only.
+    # All other pods stay in C++20 (React-perflogger needs std::unordered_map::contains).
+    # Xcode 27 rejects Pods resource-bundle targets below iOS 15.0 (e.g.
+    # Iterable-iOS-SDK-IterableSDKResources at 12.0). Lift those generated targets
+    # to RN's min; do not change published podspec support ranges.
     installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
-        # fmt/base.h unconditionally redefines FMT_USE_CONSTEVAL based on __cplusplus,
-        # so preprocessor defines are overwritten. The reliable fix is to compile fmt
-        # in C++17 mode: FMT_CPLUSPLUS (201703L) < 201709L → FMT_USE_CONSTEVAL = 0.
-        # All other pods stay in C++20 (React-perflogger needs std::unordered_map::contains).
         if target.name == 'fmt'
           config.build_settings['CLANG_CXX_LANGUAGE_STANDARD'] = 'c++17'
         end
 
+        current = config.build_settings['IPHONEOS_DEPLOYMENT_TARGET']
+        if current.nil? || current.to_f < 15.1
+          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.1'
+        end
       end
     end
   end

example/package.json

@@ -25,9 +25,9 @@
     "@babel/core": "^7.25.2",
     "@babel/preset-env": "^7.25.3",
     "@babel/runtime": "^7.25.0",
-    "@react-native-community/cli": "20.1.0",
-    "@react-native-community/cli-platform-android": "20.1.0",
-    "@react-native-community/cli-platform-ios": "20.1.0",
+    "@react-native-community/cli": "20.2.0",
+    "@react-native-community/cli-platform-android": "20.2.0",
+    "@react-native-community/cli-platform-ios": "20.2.0",
     "@react-native/babel-preset": "0.85.3",
     "@react-native/eslint-config": "0.85.3",
     "@react-native/jest-preset": "0.85.3",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iterable/react-native-sdk",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Iterable SDK for React Native.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -71,7 +71,7 @@
   "devDependencies": {
     "@commitlint/config-conventional": "^19.6.0",
     "@evilmartians/lefthook": "^1.5.0",
-    "@react-native-community/cli": "20.1.0",
+    "@react-native-community/cli": "20.2.0",
     "@react-native/babel-preset": "0.85.3",
     "@react-native/eslint-config": "0.85.3",
     "@react-native/jest-preset": "0.85.3",

src/itblBuildInfo.ts

@@ -3,5 +3,5 @@
  * It contains the version of the package
  */
 export const buildInfo = {
-  version: '3.1.0',
+  version: '3.2.0',
 };