Guard Nitro init; add Expo Folly opt-in (#3003)

## Summary
- Guard Nitro initialization by side‑effect import and try/catch; remove
direct runtime probe dependency
- Add optional Expo config plugin to disable Folly coroutines via
Podfile macros (default off)

## Notes
- Keeps CI/Jest stable by avoiding unavailable named imports
- Idempotent Podfile edit; applies only when opt‑in flag is set

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Bug Fixes**
* iOS: Fixed startup crash related to in‑app purchases and sanitized
error payloads to avoid leaking product IDs; listeners warn/inert until
runtime initializes.

* **New Features**
* Plugin supports an optional Expo config flag to disable Folly
coroutines in iOS builds.

* **Documentation**
* Clarified event‑driven purchase flow, FAQ on transient success→error
timing, and guidance to prefer purchase.id; added installation
workaround steps.

* **Examples**
* Added subscription demos, item‑detail modal, and redacted sensitive
fields.

* **Chores**
* Dev tooling updates and prerelease version bump; added Node type
definitions.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

.vscode/settings.json

@@ -24,5 +24,5 @@
   "[javascriptreact]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
-  "cSpell.words": ["hyochan", "skus"]
+  "cSpell.words": ["couroutines", "hyochan", "Podfile", "skus"]
 }

CHANGELOG.md

@@ -21,6 +21,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 - iOS: Sanitize purchase error payload so `purchaseToken` does not carry product identifiers in error events; keep internal deduplication based on SKU
 - Examples/Tests: Align transaction row with `purchase.id`; update tests accordingly
+- iOS: Fix crash on startup by lazily initializing the IAP module (Nitro HybridObject created on demand)
 
 - Remove any references to `purchase.transactionReceipt`, `purchase.transactionReceiptIOS`, and `purchase.purchaseTokenAndroid`
 

docs/blog/2025-09-14-release-14.3.1.md

@@ -4,7 +4,7 @@ authors: [hyochan]
 tags: [release, docs, examples, ios]
 ---
 
-Small polish release focusing on examples, documentation, and a minor iOS error‑payload fix.
+Small polish release focusing on examples, documentation, and a critical fix for an iOS crash on startup.
 
 ## Added
 

docs/docs/installation.md

@@ -78,6 +78,39 @@ After installing the package, you need to:
 
 3. **Create a development build** (see the Platform Configuration section below for details)
 
+4. Optional: Fix iOS Folly coroutine include error
+
+   If your iOS build fails with errors such as `'folly/coro/Coroutine.h' file not found` from `RCT-Folly/folly/Expected.h`, you can opt‑in to a workaround that disables Folly coroutine support during CocoaPods install.
+
+   Add this flag to the `react-native-iap` plugin options in your Expo config:
+
+   ```json
+   {
+     "expo": {
+       "plugins": [
+         [
+           "react-native-iap",
+           {
+             "ios": {
+               "with-folly-no-couroutines": true
+             }
+           }
+         ]
+       ]
+     }
+   }
+   ```
+
+   What this does:
+   - Injects `FOLLY_NO_CONFIG=1`, `FOLLY_CFG_NO_COROUTINES=1`, and `FOLLY_HAS_COROUTINES=0` into the Podfile `post_install` block for all Pods targets, preventing `RCT-Folly` from including non‑vendored `<folly/coro/*>` headers.
+   - Idempotent: skips if you already set these defines yourself.
+
+   After enabling the flag, re-run prebuild and install pods:
+   - `rm -rf ios`
+   - `npx expo prebuild -p ios`
+   - `cd ios && LANG=en_US.UTF-8 pod install --repo-update`
+   - `npx expo run:ios`
+
 ## Platform Configuration
 
 ### For Expo Managed Workflow

example-expo/bun.lock

@@ -37,7 +37,7 @@
     "react-dom": "19.0.0",
     "react-native": "0.79.6",
     "react-native-gesture-handler": "~2.24.0",
-    "react-native-nitro-modules": "^0.29.2",
+    "react-native-nitro-modules": "^0.29.4",
     "react-native-reanimated": "~3.17.4",
     "react-native-safe-area-context": "5.4.0",
     "react-native-screens": "~4.11.1",

example-expo/package.json

@@ -17,7 +17,7 @@
     "@react-navigation/native-stack": "^7.3.25",
     "react": "19.1.0",
     "react-native": "0.81.1",
-    "react-native-nitro-modules": "^0.29.2",
+    "react-native-nitro-modules": "^0.29.4",
     "react-native-safe-area-context": "^5.6.1",
     "react-native-screens": "^4.15.4"
   },

example/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.3.1",
+  "version": "14.3.2-rc.9",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -55,8 +55,8 @@
     "lint:tsc": "tsc -p tsconfig.json --noEmit --skipLibCheck",
     "lint:ci": "yarn lint:tsc && yarn lint:eslint && yarn lint:prettier",
     "prepare": "npx tsx scripts/check-nitro-versions.ts && bob build && yarn nitrogen && yarn build:plugin",
-    "nitrogen": "nitro-codegen",
-    "specs": "nitro-codegen --logLevel=\"debug\"",
+    "nitrogen": "nitrogen",
+    "specs": "nitrogen --logLevel=\"debug\"",
     "test": "jest --coverage",
     "test:library": "jest --coverage",
     "test:example": "yarn workspace rn-iap-example test --coverage",
@@ -95,6 +95,7 @@
     "@testing-library/react": "^16.3.0",
     "@testing-library/react-hooks": "^8.0.1",
     "@types/jest": "^29.5.12",
+    "@types/node": "^24.4.0",
     "@types/react": "^19.1.12",
     "babel-jest": "^30.1.1",
     "eslint": "^8.57.0",
@@ -105,12 +106,12 @@
     "husky": "^8.0.3",
     "jest": "^30.1.1",
     "lint-staged": "^15.2.0",
-    "nitro-codegen": "^0.29.2",
+    "nitrogen": "^0.29.4",
     "prettier": "^3.3.3",
     "react": "19.1.0",
     "react-native": "0.81.1",
     "react-native-builder-bob": "^0.38.4",
-    "react-native-nitro-modules": "^0.29.2",
+    "react-native-nitro-modules": "^0.29.4",
     "react-test-renderer": "^19.1.1",
     "typescript": "^5.9.2"
   },

package.json

@@ -3,8 +3,10 @@ import {
   WarningAggregator,
   withAndroidManifest,
   withAppBuildGradle,
+  withPodfile,
 } from 'expo/config-plugins';
 import type {ConfigPlugin} from 'expo/config-plugins';
+import type {ExpoConfig} from '@expo/config-types';
 
 const pkg = require('../../package.json');
 
@@ -122,9 +124,67 @@ const withIapAndroid: ConfigPlugin = (config) => {
   return config;
 };
 
-const withIAP: ConfigPlugin = (config, _props) => {
+type IapPluginProps = {
+  ios?: {
+    // Intentionally following user-provided key spelling
+    // Enable to inject Folly coroutine-disabling macros into Podfile during prebuild
+    'with-folly-no-couroutines'?: boolean;
+  };
+};
+
+const withIapIosFollyWorkaround: ConfigPlugin<IapPluginProps | undefined> = (
+  config,
+  props,
+) => {
+  const enabled = !!props?.ios?.['with-folly-no-couroutines'];
+  if (!enabled) return config;
+
+  return withPodfile(config, (config) => {
+    let contents = config.modResults.contents;
+
+    // Idempotency: if any of the defines already exists, assume it's applied
+    if (
+      contents.includes('FOLLY_CFG_NO_COROUTINES') ||
+      contents.includes('FOLLY_HAS_COROUTINES=0')
+    ) {
+      return config;
+    }
+
+    const anchor = 'post_install do |installer|';
+    const snippet = `
+  # react-native-iap (expo): Disable Folly coroutines to avoid including non-vendored <folly/coro/*> headers
+  installer.pods_project.targets.each do |target|
+    target.build_configurations.each do |config|
+      defs = (config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] || ['$(inherited)'])
+      defs << 'FOLLY_NO_CONFIG=1' unless defs.any? { |d| d.to_s.include?('FOLLY_NO_CONFIG') }
+      # Portability.h respects FOLLY_CFG_NO_COROUTINES to fully disable coroutine support
+      defs << 'FOLLY_CFG_NO_COROUTINES=1' unless defs.any? { |d| d.to_s.include?('FOLLY_CFG_NO_COROUTINES') }
+      defs << 'FOLLY_HAS_COROUTINES=0' unless defs.any? { |d| d.to_s.include?('FOLLY_HAS_COROUTINES') }
+      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] = defs
+    end
+  end`;
+
+    if (contents.includes(anchor)) {
+      contents = contents.replace(anchor, `${anchor}\n${snippet}`);
+    } else {
+      // As a fallback, append a new post_install block
+      contents += `
+
+${anchor}
+${snippet}
+end
+`;
+    }
+
+    config.modResults.contents = contents;
+    return config;
+  });
+};
+
+const withIAP: ConfigPlugin<IapPluginProps | undefined> = (config, props) => {
   try {
-    const result = withIapAndroid(config);
+    let result = withIapAndroid(config);
+    result = withIapIosFollyWorkaround(result, props);
     // Set flag after first execution to prevent duplicate logs
     hasLoggedPluginExecution = true;
     return result;
@@ -138,4 +198,25 @@ const withIAP: ConfigPlugin = (config, _props) => {
   }
 };
 
-export default createRunOncePlugin(withIAP, pkg.name, pkg.version);
+// Standard Expo config plugin export
+// Export a test-friendly wrapper that accepts 1 or 2 args
+type IapPluginCallable = {
+  (config: ExpoConfig): ExpoConfig;
+  (config: ExpoConfig, props?: IapPluginProps): ExpoConfig;
+};
+
+const _wrapped = createRunOncePlugin(
+  withIAP,
+  pkg.name,
+  pkg.version,
+) as unknown as (
+  config: ExpoConfig,
+  props: IapPluginProps | undefined,
+) => ExpoConfig;
+
+const pluginExport: IapPluginCallable = ((
+  config: ExpoConfig,
+  props?: IapPluginProps,
+) => _wrapped(config, props)) as unknown as IapPluginCallable;
+
+export {pluginExport as default};