SDK-290 Add Expo Config Plugin and Fix Static Linkage Swift Header Import

[joaodordio]

🔹 JIRA Ticket(s) if any

• SDK-290

✏️ Description

• Add Expo config plugin for automated iOS build configuration
• Fix Swift header import for static framework builds
• Update iOS SDK dependency to 6.6.5
• Add comprehensive plugin tests

Problem

Integrating the Iterable React Native SDK in Expo managed workflows requires complex manual configuration:

1. React Native + Expo must remain statically linked
2. Iterable pods must be dynamically linked due to Swift bridging
3. Autolinking must be disabled to avoid duplicate Podfile entries
4. Push notification extensions need separate target configuration

This leads to recurring build failures:

• 'Iterable_React_Native_SDK-Swift.h' file not found
• "transitive dependencies include statically linked binaries" errors
• Duplicate pod declaration errors

Solution

1. Expo Config Plugin

New plugin at plugin/src/ that automates iOS build configuration during expo prebuild:

Autolinking Exclusion (withIterableAutolinking.ts):

• Excludes @iterable/react-native-sdk from iOS autolinking to prevent duplicate entries

Podfile Transformation (withIterablePodfile.ts):

• Ensures use_frameworks! :linkage => :static is set (Expo requirement)
• Injects Iterable pods with :linkage => :dynamic override
• Optionally adds IterableNotifications target for push extensions
• Idempotent - safe to run multiple times

Usage:

{
  "expo": {
    "plugins": [
      ["@iterable/react-native-sdk", { "enableNotificationExtension": true }]
    ]
  }
}

2. Swift Header Import Fix

Updated RNIterableAPI.mm to use conditional import for static framework builds:

#if __has_include(<Iterable_React_Native_SDK/Iterable_React_Native_SDK-Swift.h>)
#import <Iterable_React_Native_SDK/Iterable_React_Native_SDK-Swift.h>
#else
#import "Iterable_React_Native_SDK-Swift.h"
#endif

3. Podspec Updates

Added to Iterable-React-Native-SDK.podspec:

• SWIFT_OBJC_INTERFACE_HEADER_NAME setting
• HEADER_SEARCH_PATHS for generated Swift header location

Files Changed

File	Change
plugin/src/index.ts	Main plugin entry with config options
plugin/src/withIterableAutolinking.ts	Autolinking exclusion logic
plugin/src/withIterablePodfile.ts	Podfile transformation
plugin/__tests__/plugin.test.ts	Jest tests for all transformations
ios/RNIterableAPI/RNIterableAPI.mm	Conditional Swift header import
Iterable-React-Native-SDK.podspec	Header search paths
package.json	Plugin build scripts, expo config

Testing

1. Run yarn build - SDK and plugin compile successfully
2. Run yarn test:plugin - All plugin tests pass
3. Build example app with yarn ios - No Swift header errors
4. Test Expo integration with npx expo prebuild - Correct Podfile output

Dependencies

• Requires iterable-swift-sdk version 6.6.5+ with C linkage header fixes

[github-actions]

Lines	Statements	Branches	Functions
	63.07% (398/631)	40.07% (103/257)	61.5% (139/226)

[qltysh]

Coverage Impact

This PR will not change total coverage.

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

[qltysh]

All good ✅