[DELIVERY-125863] Migrate Flutter plugin to AppsFlyer SDK 7 RPC architecture.

.claude/skills/alice-pm/SKILL.md

@@ -322,7 +322,7 @@ Automated via GitHub Actions: `.github/workflows/rc-release.yml`, `rc-smoke.yml`
 
 ## Domain-Specific Notes
 
-- Cross-platform parity: any new public Dart API must map to matching method names/behavior in both `AppsflyerSdkPlugin.java` (Android) and `AppsflyerSdkPlugin.m` (iOS) — flag any PRD that only specifies one platform.
+- Cross-platform parity: any new public Dart API must map to matching method names/behavior in both `AppsflyerSdkPlugin.kt` (Android) and `AppsflyerSdkPlugin.swift` (iOS) — flag any PRD that only specifies one platform.
 - This is a published pub.dev package (`appsflyer_sdk`) consumed by third-party apps — breaking changes to the public Dart API require a major version bump and migration notes in `CHANGELOG.md`.
 - Purchase Connector is optional/self-contained (`lib/src/purchase_connector/`, `ios/PurchaseConnector/`, Android Kotlin) — changes there should not affect core SDK consumers who don't opt in.
 - Release goes through the RC pipeline (see Release Process above) — any feature landing near a release cut should account for RC-SMOKE validation.

.claude/skills/dave-flutter-engineer/SKILL.md

@@ -7,7 +7,7 @@ description: Use when working on AppsFlyer Flutter Plugin code — writing, revi
 
 ## Persona
 
-Senior engineer with deep knowledge of AppsFlyer Flutter Plugin. Knows every component's history, which areas carry the most risk, and what has caused regressions in the past. Tech stack: Dart/Flutter plugin (SDK >=2.17.0 <4.0.0, Flutter >=1.10.0) bridging native AppsFlyer SDKs via MethodChannel/EventChannel — Objective-C on iOS (`ios/Classes/`), Java/Kotlin on Android (`android/src/main/java` + `android/src/main/kotlin` for the Purchase Connector). JSON models via `json_annotation`/`json_serializable` + `build_runner`. Testing via `mockito` + `flutter_lints`..
+Senior engineer with deep knowledge of AppsFlyer Flutter Plugin. Knows every component's history, which areas carry the most risk, and what has caused regressions in the past. Tech stack: Dart/Flutter plugin (SDK >=2.17.0 <4.0.0, Flutter >=1.10.0) bridging native AppsFlyer SDKs via MethodChannel/EventChannel — Swift on iOS (`ios/appsflyer_sdk/Sources/appsflyer_sdk/`, plus a minimal Objective-C shim target `ios/appsflyer_sdk/Sources/appsflyer_sdk_objc/`), Kotlin on Android (`android/src/main/kotlin` + `android/src/main/include-connector` for the Purchase Connector). JSON models via `json_annotation`/`json_serializable` + `build_runner`. Testing via `mockito` + `flutter_lints`..
 
 ## PRD Gate — BLOCKING REQUIREMENT
 
@@ -165,7 +165,7 @@ BLOCKING REQUIREMENT: Include a `Skill('dave-flutter-engineer')` tool call in th
 ## Domain-Specific Notes
 
 - Keep `AppsflyerSdk` as a singleton — do not change the instantiation pattern.
-- New SDK method: add Dart method in `lib/src/appsflyer_sdk.dart` (invoke via `_channel.invokeMethod`), implement in `AppsflyerSdkPlugin.java` (Android) and `AppsflyerSdkPlugin.m` (iOS). Keep the method name string identical across all three files.
+- New SDK method: add Dart method in `lib/src/appsflyer_sdk.dart` (invoke via `_channel.invokeMethod`), implement in `AppsflyerSdkPlugin.kt` (Android) and `AppsflyerSdkPlugin.swift` (iOS). Keep the method name string identical across all three files.
 - Callbacks from native → Dart flow through EventChannels defined in `lib/src/callbacks.dart`.
 - Deep linking (UDL) logic is isolated in `lib/src/udl/` — do not mix with core SDK channel calls.
 - Purchase Connector is self-contained in `lib/src/purchase_connector/` (Dart models) and `ios/PurchaseConnector/` / `android/.../kotlin/` (native) — keep it that way.

.claude/skills/erin-flutter-analyst/SKILL.md

@@ -95,5 +95,5 @@ After Erin presents any analysis findings, `alice-pm` is invoked automatically.
 
 - Field maps live at the MethodChannel/EventChannel boundary — arguments passed as `Map<String, dynamic>` between Dart and native.
 - JSON-serializable Dart models: `lib/src/purchase_connector/` (in-app purchase validation payloads) — regenerate `.g.dart` via `build_runner` after any field change.
-- Attribution/conversion data payloads flow through `lib/src/callbacks.dart` — check both the Dart model and the native (Java/ObjC) side that populates the EventChannel data.
+- Attribution/conversion data payloads flow through `lib/src/callbacks.dart` — check both the Dart model and the native (Kotlin/Swift) side that populates the EventChannel data.
 - When mapping fields, verify parity between what Android and iOS native code send — historically a source of drift.

.github/workflows/production-release.yml

@@ -405,9 +405,11 @@ jobs:
 
           ## 📚 Documentation
 
-          - [Installation Guide](https://github.com/${{ github.repository }}/blob/master/doc/Installation.md)
-          - [Basic Integration](https://github.com/${{ github.repository }}/blob/master/doc/BasicIntegration.md)
-          - [API Documentation](https://github.com/${{ github.repository }}/blob/master/doc/API.md)
+          - [Documentation index](https://github.com/${{ github.repository }}/blob/master/doc/README.md)
+          - [Installation](https://github.com/${{ github.repository }}/blob/master/doc/installation-guide.md)
+          - [Getting started](https://github.com/${{ github.repository }}/blob/master/doc/getting-started.md)
+          - [API reference](https://github.com/${{ github.repository }}/blob/master/doc/api-reference.md)
+          - [Migrating v6 → v7](https://github.com/${{ github.repository }}/blob/master/doc/migration-guide.md)
           - [Sample App](https://github.com/${{ github.repository }}/tree/master/example)
 
           ## 🔗 Links

.github/workflows/promote-release.yml

@@ -134,8 +134,8 @@ jobs:
           VERSION='${{ steps.compute-version.outputs.version }}'
           echo "Updating PLUGIN_VERSION constants to: $VERSION"
 
-          # Android - AppsFlyerConstants.java
-          ANDROID_FILE="android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java"
+          # Android - AppsFlyerConstants.kt
+          ANDROID_FILE="android/src/main/kotlin/com/appsflyer/appsflyersdk/AppsFlyerConstants.kt"
           if [ -f "$ANDROID_FILE" ]; then
             sed -i "s/PLUGIN_VERSION = \".*\"/PLUGIN_VERSION = \"$VERSION\"/" "$ANDROID_FILE"
             echo "✅ Android:" && grep "PLUGIN_VERSION" "$ANDROID_FILE"

.github/workflows/rc-release.yml

@@ -318,8 +318,8 @@ jobs:
           VERSION='${{ needs.validate-release.outputs.version }}'
           echo "Updating PLUGIN_VERSION constants to: $VERSION"
 
-          # Android - AppsFlyerConstants.java
-          ANDROID_FILE="android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java"
+          # Android - AppsFlyerConstants.kt
+          ANDROID_FILE="android/src/main/kotlin/com/appsflyer/appsflyersdk/AppsFlyerConstants.kt"
           if [ -f "$ANDROID_FILE" ]; then
             sed -i.bak "s/PLUGIN_VERSION = \".*\"/PLUGIN_VERSION = \"$VERSION\"/" "$ANDROID_FILE"
             rm "$ANDROID_FILE.bak"

.pubignore

@@ -7,7 +7,15 @@ package.json
 package-lock.json
 node_modules/
 local.properties
+build/
+coverage/
+.githooks/
 .cursor/
+.claude/
+CLAUDE.md
+ai-delivery-workflow-templat/
+internal-docs/
+output.af-quiz-me/
 
 # Example app files that shouldn't be in package
 example/.env

CHANGELOG.md

@@ -1,5 +1,125 @@
 # Versions
 
+## 7.0.1
+
+Migration to **AppsFlyer SDK 7**. This is a major release with intentional
+breaking changes. See [doc/migration-guide.md](doc/migration-guide.md) for
+removed APIs, renames, lifecycle changes, and upgrade instructions.
+
+- Flutter plugin version **7.0.1**
+- Minimum Flutter version **3.24.0**
+- Minimum Dart version **3.5.0** (and earlier than Dart **4.0.0**)
+- Android AppsFlyer SDK **7.0.1**
+- iOS AppsFlyer SDK **7.0.1**
+- Android Purchase Connector **2.2.0**
+- iOS Purchase Connector **7.0.1**
+- iOS minimum deployment target **13.0**
+- Android minimum API level **21**
+- Documentation remains organized under [`doc/`](doc/README.md), with the
+  complete upgrade catalog in [doc/migration-guide.md](doc/migration-guide.md).
+
+**BREAKING**
+
+- Replaced `AppsflyerSdk(options)` and `AppsFlyerOptions` with the shared
+  `AppsFlyerSdk.instance` singleton and explicit configuration methods.
+- Replaced `initSdk(...)` with `init(devKey:, appId:)`. `appId` is required on
+  iOS, optional on Android, and is not sent to the Android SDK.
+- Replaced `startSDK(...)` with `await start()`. Initialization no longer sends
+  a session. Subscribe to `onSessionReady`, call
+  `registerSessionReadyListener()`, and call `start()` once for each readiness
+  event.
+- Replaced callback registration flags and callback slots with typed event
+  streams and explicit listener registration. Conversion data uses
+  `onConversionDataSuccess` / `onConversionDataFailure`; Unified Deep Linking
+  uses `onDeepLinkReceived`.
+- Native and plugin failures from operations that await a result are surfaced as
+  `AppsFlyerException` (`int? code`, `String message`). Non-numeric platform
+  codes leave `code` as `null`. `MissingPluginException` is not converted.
+  Failures from fire-and-forget calls are not reported.
+- `start`, `logEvent`, `generateInviteLink`, and
+  `validateAndLogInAppPurchase` expose `awaitResponse` where the native SDK
+  supports waiting for a completion callback. It defaults to `false` for `start`
+  and `logEvent`, and to `true` for the two result-producing APIs.
+- Removed OAOA callbacks and registration. Use Unified Deep Linking.
+- Replaced `performOnDeepLinking()` with
+  `performDeepLinking(url, {shouldTriggerSession})`.
+- Replaced legacy V1 Android/iOS purchase validation and
+  `validateAndLogInAppPurchaseV2(...)` with
+  `validateAndLogInAppPurchase(AFPurchaseDetails, ...)`. Use
+  `AFAndroidPurchaseDetails` with a Play purchase token or
+  `AFIOSPurchaseDetails` with an App Store transaction ID.
+- Replaced the cross-platform `sendPushNotificationData(Map)` shape with
+  platform-specific Android `sendPushNotificationData(...)` and iOS
+  `handlePushNotification(pushPayload)` APIs.
+- Replaced `setConsentDataV2(...)` and the `AppsFlyerConsent` wrapper with the
+  flat `setConsentData(...)` API and its four SDK 7 consent fields.
+- Renamed platform APIs to match the final SDK 7 surface, including
+  `enableDebug`, `setDisableSKAdNetwork`,
+  `setDisableAppleAdsAttribution`, `setDisableIDFVCollection`,
+  `setUseReceiptValidationSandbox`, and `setUseUninstallSandbox`.
+- `setUserFbLoginId` now accepts an `int`; mediation values use
+  `AFMediationNetwork`; invite-link fields use `referrerCustomerId` and
+  `userParams`.
+- Removed SDK 6 APIs that no longer exist in SDK 7 or are not exposed by the
+  plugin, including `onAppOpenAttribution`, `setUserEmails`, `EmailCryptType`,
+  raw IMEI and Android ID setters, V1 purchase validation, `setPushNotification`,
+  `enableUninstallTracking`, `waitForCustomerUserId`, and
+  `setCustomerIdAndLogSession`.
+- Runtime configuration setters must be re-applied on every cold start before
+  `start()`.
+- Guarded platform-only methods log and return a safe default when called
+  outside their supported platform.
+- `setInstallId()` requires `AppsFlyerAllowCustomInstallId=YES` in iOS
+  `Info.plist` and must be called before `init()` on iOS. Android requires
+  `APPSFLYER_ALLOW_CUSTOM_INSTALL_ID=true` in `AndroidManifest.xml` and the call
+  must follow `init()`.
+- Android Purchase Connector `2.2.0` requires Google Play Billing Library `8.x`.
+  The Flutter plugin does not add Billing Library; the app or its IAP plugin
+  must provide it. iOS Purchase Connector requires CocoaPods, while Core-only
+  apps can use Swift Package Manager.
+- Remove legacy `SingleInstallBroadcastReceiver` and
+  `MultipleInstallBroadcastReceiver` manifest entries. The plugin already
+  includes Google Play Install Referrer `2.2`.
+
+See the [v6 → v7 migration guide](doc/migration-guide.md) for the complete
+replacement table.
+
+**Added**
+
+- Added `AppsFlyerSdk.instance`, `init(...)`, `onSessionReady`,
+  `registerSessionReadyListener()`, `unregisterSessionReadyListener()`,
+  `isSessionReady()`, and `start()` for the SDK 7 lifecycle.
+- Added the cross-platform `enableDebug(bool)` toggle and Android-only
+  `setLogLevel(AFLogLevel)`.
+- Added typed event streams and `AppsFlyerException`.
+- Added hashed-PII setters `setUserEmail`, `setUserPhone`,
+  `setUserFirstName`, and `setUserLastName`, plus integer
+  `setUserFbLoginId` and `clearUserPii`.
+- Added `performDeepLinking`, `setDeepLinkTimeout`,
+  `appendParametersToDeepLinkingURL`, and iOS-only
+  `setFacebookDeferredAppLink`.
+- Added the `AFPurchaseDetails` interface with dedicated
+  `AFAndroidPurchaseDetails` and `AFIOSPurchaseDetails` implementations.
+- Added Android-only `logSession`, `setPreinstallAttribution`, `setAppId`,
+  `isStopped`, `isPreInstalledApp`, `getAttributionId`,
+  `unregisterDeeplinkListener`, and `unregisterConversionListener` APIs.
+  On Android, `unregisterDeeplinkListener` does not reliably stop subsequent
+  deep-link events; do not depend on it as an effective unsubscribe.
+- Added iOS-only `setDisableAppleAdsAttribution`,
+  `setDisableIDFVCollection`, `setShouldCollectDeviceName`, and
+  `setUseUninstallSandbox` APIs.
+- Added `logInvite`, `logLocation`, `setInstallId`, and awaitable
+  `generateInviteLink` support.
+
+**Fixed**
+
+- Purchase Connector: removed stray `[AppsFlyer_PC_Debug]` `print` logging that shipped in release builds; the callback handler now accepts both JSON-string and already-decoded `Map` payloads and logs (instead of throwing) on an unrecognized callback name.
+- Purchase Connector (**Android**): subscription and in-app validation-result listeners (`setSubscriptionValidationResultListener` / `setInAppValidationResultListener`) never fired — the Dart callback-name constants used a `#` separator while the native side invokes the channel with `:`, so the handler's `switch` never matched. Aligned the Dart constants to `:`, so these result listeners now deliver.
+- Optional Android Purchase Connector state is cleared when the Flutter engine
+  detaches.
+- Corrected iOS ad-mediation identifiers for custom and direct monetization.
+- Updated documentation and examples for the final SDK 7 API.
+
 ## 6.18.0
 
 - Updated Android SDK from 6.17.6 to 6.18.0

CLAUDE.md

@@ -1,7 +1,9 @@
 # AppsFlyer Flutter Plugin
 
 ## Overview
-Flutter plugin providing mobile attribution and analytics for iOS and Android. Bridges native AppsFlyer SDKs (iOS v6.17.9, Android v6.17.6) via Dart MethodChannel/EventChannel. Supports Flutter 2+ with null safety.
+Flutter plugin providing mobile attribution and analytics for iOS and Android.
+The core bridge uses native AppsFlyer SDK 7.0.1, Android RPC 7.0.1, and iOS
+AppsFlyerRPC 7.0.12. It requires Flutter 3.24+ and Dart 3.5+.
 
 ## Starting a feature
 
@@ -29,12 +31,13 @@ For everything outside of feature delivery, invoke skills directly:
 
 ## Architecture
 - `lib/src/appsflyer_sdk.dart` — Main SDK class (singleton, MethodChannel/EventChannel bridge)
-- `lib/src/callbacks.dart` — Attribution and event callback handlers
+- `lib/src/appsflyer_event.dart` — Native RPC event envelope
 - `lib/src/udl/deeplink.dart` — Unified Deep Linking (UDL) implementation
 - `lib/src/purchase_connector/` — In-app purchase validation models
-- `android/src/main/java/com/appsflyer/appsflyersdk/AppsflyerSdkPlugin.java` — Android entry point
-- `android/src/main/kotlin/` — Kotlin Purchase Connector for Android
-- `ios/Classes/AppsflyerSdkPlugin.m` — iOS entry point (Objective-C)
+- `android/src/main/kotlin/com/appsflyer/appsflyersdk/AppsflyerSdkPlugin.kt` — Android entry point
+- `android/src/main/include-connector/` — Optional Kotlin Purchase Connector bridge
+- `ios/appsflyer_sdk/Sources/appsflyer_sdk/` — iOS RPC entry point (Swift)
+- `ios/appsflyer_sdk/Sources/appsflyer_sdk_objc/` — minimal Objective-C shim (`NSException` boundary + RPC bridge pass-through)
 - `ios/PurchaseConnector/` — iOS purchase validation module
 - `test/` — Dart unit tests (mockito)
 - `example/` — Full Flutter example app (iOS + Android)
@@ -55,11 +58,14 @@ flutter pub run build_runner build   # Regenerate JSON serialization code
 - **JSON serialization**: Uses `json_annotation` + `json_serializable`. After changing annotated model classes, run `build_runner` to regenerate `.g.dart` files. Commit the generated files.
 - **Testing**: `mockito` for mocking. Add tests in `test/` for new public API.
 - Dart null safety is required — all new code must be null-safe.
-- Keep `AppsflyerSdk` as a singleton; do not change the instantiation pattern.
+- Keep `AppsFlyerSdk.instance` as the production singleton.
 
 ## Key Patterns
-- New SDK method: add Dart method in `appsflyer_sdk.dart` (invoke via `_channel.invokeMethod`), implement in `AppsflyerSdkPlugin.java` (Android) and `AppsflyerSdkPlugin.m` (iOS). Keep method name strings consistent across all three files.
-- Callbacks from native → Dart flow through EventChannels defined in `callbacks.dart`.
+- New core SDK methods must map to existing native RPC capabilities. Add the
+  Dart RPC call and only platform adaptation required by the RPC contracts;
+  keep business behavior in the native SDK/RPC modules.
+- Native RPC callbacks flow through the `af-events` EventChannel as
+  `_AppsFlyerEvent` envelopes parsed on the Dart side.
 - Deep linking (UDL) logic is isolated in `lib/src/udl/` — do not mix with core SDK channel calls.
 - Purchase Connector is self-contained in `lib/src/purchase_connector/` (Dart models) and `ios/PurchaseConnector/` / `android/.../kotlin/` (native).
 
@@ -71,8 +77,46 @@ flutter pub run build_runner build   # Regenerate JSON serialization code
 ## Notes
 - SDK version is set in `pubspec.yaml` and native dependency specs (podspec / `build.gradle`).
 - Generated files (`*.g.dart`) must be committed — run `build_runner` after model changes.
-- `doc/` and `example/` should be kept in sync with API changes.
-- iOS native layer is Objective-C; Kotlin is used only for the Android Purchase Connector.
+- `doc/` and `example/` must be kept in sync with API changes — see Documentation review.
+- The iOS core bridge is Swift, with a minimal Objective-C shim target
+  (`appsflyer_sdk_objc`) for the `NSException` boundary that Swift cannot express;
+  Swift and Kotlin implement the optional Purchase Connector bridges.
+
+## Documentation review
+
+Applies to every code change, including pure refactors.
+
+After every code change, identify and review all related documentation. Update
+documentation whenever the change affects documented behavior, public APIs,
+parameters, configuration, architecture, workflows, examples, compatibility, or
+user-visible output. If no documentation update is needed, explicitly state which
+documentation was reviewed and why it remains accurate.
+
+Where to look, by what changed:
+
+| Changed | Review |
+|---------|--------|
+| Public Dart API surface | dartdoc on the member, `doc/api-reference.md`, `README.md`, `CHANGELOG.md` |
+| Platform-specific behavior or availability | `doc/api-reference.md`, the affected `internal-docs/features/F-NNN-*.md` |
+| Breaking change or removed API | `doc/migration-guide.md`, `CHANGELOG.md` — see also the API Removal Rule |
+| Behavior of a catalogued feature | matching `internal-docs/features/F-NNN-*.md` plus `internal-docs/features/INDEX.md` |
+| Architecture, channels, or RPC transport | `internal-docs/ARCHITECTURE.md` and the Architecture section above |
+| Setup, configuration, or native dependencies | `doc/installation-guide.md`, `doc/getting-started.md` |
+| Anything the sample app demonstrates | `example/` and `example/README.md` |
+
+Rules:
+
+- Correct outdated references and examples in the files you review, including stale
+  method names, signatures, return types, and snippets that no longer compile.
+- Never hand-edit generated output. Regenerate it — `*.g.dart` via
+  `flutter pub run build_runner build`.
+- Leave accurate documentation alone. An unnecessary documentation edit is a defect.
+
+Every task summary must state:
+
+- which documentation files were reviewed;
+- which documentation files were updated;
+- if none were updated, why the existing documentation remains accurate.
 
 ## Maintenance bypass