feat: add shared E2E test library for cross-version testing

- Created examples/shared-e2e with reusable E2E tests
- Configured E2E-compat (RN 0.72.9 + React 18.3.1) to use shared tests
- Configured E2E-latest (RN 0.84.1 + React 19.2.3) to use shared tests
- Removed duplicate test code from both apps
- Added Detox configuration for E2E-latest
- Updated package.json files with shared-e2e dependency

Benefits:
- Write tests once, run on all RN versions
- Ensures consistent testing across versions
- Easy maintenance (update in one place)
- Validates SDK works on multiple RN versions

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: abueide

MVP_SUPPORT_PLAN.md

@@ -0,0 +1,182 @@
+# MVP Task List: React Native 0.84 Support
+
+## Phase 1: Testing
+
+### 1. Test E2E-compat (RN 0.72.9 + React 18.3.1)
+- [ ] Install dependencies and build
+- [ ] Run unit tests
+- [ ] Run E2E tests
+- [ ] Test on iOS simulator
+- [ ] Test on Android emulator
+
+### 2. Test E2E-latest (RN 0.84.1 + React 19.2.3)
+- [ ] Install dependencies and build
+- [ ] Run unit tests
+- [ ] Run E2E tests
+- [ ] Test on iOS simulator
+- [ ] Test on Android emulator
+
+### 3. Core Functionality Tests (Both Apps)
+- [ ] SDK initialization
+- [ ] Track events
+- [ ] Screen events
+- [ ] Identify calls
+- [ ] Group calls
+- [ ] Alias calls
+- [ ] Reset functionality
+- [ ] Plugin system (add/remove)
+- [ ] Flush functionality
+- [ ] Deep linking
+- [ ] Background/foreground transitions
+- [ ] Storage persistence
+- [ ] Network retry logic
+
+### 4. Plugin Compatibility Tests
+- [ ] Test @segment/analytics-react-native-plugin-braze
+- [ ] Test @segment/analytics-react-native-plugin-facebook-app-events
+- [ ] Test @segment/analytics-react-native-plugin-firebase
+- [ ] Test @segment/analytics-react-native-plugin-idfa
+- [ ] Document any plugin issues found
+
+---
+
+## Phase 2: Code Changes
+
+### 5. Update Core Package
+- [ ] Update `packages/core/package.json` peerDependencies:
+  - `"react": "^18.2.0 || ^19.0.0"`
+  - `"react-native": ">=0.72.0"`
+- [ ] Update `packages/core/package.json` engines:
+  - `"node": ">=18"`
+- [ ] Run `yarn typecheck` in core package
+
+### 6. Update Sovran Package
+- [ ] Update `packages/sovran/package.json` peerDependencies:
+  - `"react": "^18.2.0 || ^19.0.0"`
+  - `"react-native": ">=0.72.0"`
+- [ ] Update `packages/sovran/package.json` engines:
+  - `"node": ">=18"`
+- [ ] Run `yarn typecheck` in sovran package
+
+### 7. Update All Plugin Packages
+- [ ] Update each plugin's package.json peerDependencies:
+  - `"react": "^18.2.0 || ^19.0.0"`
+  - `"react-native": ">=0.72.0"`
+  - `"@segment/analytics-react-native": "^2.22.0"`
+- [ ] Run `yarn typecheck` in each plugin
+
+### 8. Update Root Package.json
+- [ ] Update devDependencies if needed
+- [ ] Update engines to `"node": ">=18"`
+- [ ] Run `yarn install` to verify
+
+### 9. Update CI/CD
+- [ ] Add matrix testing to `.github/workflows/ci.yml`:
+  - Test E2E-compat example
+  - Test E2E-latest example
+- [ ] Verify CI passes locally using act or similar
+
+---
+
+## Phase 3: Documentation
+
+### 10. Update Main README.md
+- [ ] Add compatibility matrix table
+- [ ] Add "Tested Configurations" section
+- [ ] Add "React Native 0.84 / React 19 Support" section
+- [ ] Update installation instructions if needed
+- [ ] Add link to UPGRADING.md
+
+### 11. Create UPGRADING.md
+- [ ] Add prerequisites section
+- [ ] Add step-by-step upgrade instructions
+- [ ] Add "Known Issues" section with solutions
+- [ ] Add "Breaking Changes" reference
+- [ ] Add link to RN_UPGRADE_BREAKING_CHANGES.md
+
+### 12. Update CHANGELOG.md
+- [ ] Add [2.22.0] section
+- [ ] List added features
+- [ ] List changed items
+- [ ] List testing improvements
+- [ ] Add migration notes
+
+### 13. Create/Update Additional Docs
+- [ ] Review and update any other markdown files
+- [ ] Update examples README files if needed
+- [ ] Add FAQ section if applicable
+
+---
+
+## Phase 4: Release
+
+### 14. Pre-Release Validation
+- [ ] All tests passing on E2E-compat
+- [ ] All tests passing on E2E-latest
+- [ ] TypeScript compilation successful everywhere
+- [ ] All documentation updated
+- [ ] Version numbers ready to bump
+
+### 15. Beta Release
+- [ ] Bump versions to 2.22.0-beta.1
+- [ ] Build all packages (`yarn build`)
+- [ ] Test local publishing (`yarn pack`)
+- [ ] Publish beta to npm
+- [ ] Create GitHub pre-release tag
+- [ ] Announce in community forum/Slack
+
+### 16. Beta Testing Period
+- [ ] Monitor GitHub issues
+- [ ] Monitor community feedback
+- [ ] Fix any critical issues found
+- [ ] Document any workarounds needed
+
+### 17. Stable Release
+- [ ] Bump versions to 2.22.0
+- [ ] Build all packages
+- [ ] Publish to npm
+- [ ] Create GitHub release tag
+- [ ] Push all changes to repository
+
+---
+
+## Phase 5: Communication
+
+### 18. Release Announcement
+- [ ] Write blog post
+- [ ] Publish blog post
+- [ ] Share on social media
+- [ ] Post in community forums
+
+### 19. Customer Communication
+- [ ] Send email to customers
+- [ ] Update main docs site
+- [ ] Update npm package description
+- [ ] Respond to any questions in issues/forums
+
+---
+
+## Phase 6: Monitoring
+
+### 20. Post-Release Monitoring
+- [ ] Monitor GitHub issues for RN 0.84/React 19 mentions
+- [ ] Monitor npm download stats
+- [ ] Monitor support ticket queue
+- [ ] Track community adoption
+
+### 21. Issue Response
+- [ ] Triage new issues within 24h
+- [ ] Fix critical (P0) issues immediately
+- [ ] Plan hotfix releases if needed
+- [ ] Update documentation based on feedback
+
+---
+
+## Rollback Plan (If Needed)
+
+### 22. Emergency Rollback
+- [ ] Post warning on GitHub README
+- [ ] Deprecate problematic version on npm
+- [ ] Publish hotfix or recommend downgrade
+- [ ] Communicate to affected users
+- [ ] Update documentation with workarounds