feat: ship 6.2.0 with emit, token promo offer signing and refundHandling

[kherembourg]

What

• Bump the plugin to 6.2.0 (purchasely, purchasely_google, purchasely_android_player) and pin native iOS Purchasely 6.2.0 (CocoaPods and SwiftPM) and Android io.purchasely:* 6.2.0.
• Follow the Android 6.2.0 rename StoreType.WEB_CHECKOUT_STRIPE -> STRIPE (same ordinal, so the wire value does not change).
• Absorb feat(privacy): add the refundHandling data processing purpose #162: add the REFUND_HANDLING data processing purpose (iOS only; Android ignores it). The cherry-picked commits keep their author. The Dart doc now states the platform difference: on iOS allNonEssentials excludes identifiedAnalytics and refundHandling; on Android it includes identifiedAnalytics.
• Add Purchasely.emit(String name, [Map<String, dynamic> properties = const {}]). It awaits the platform channel, so a codec or platform error reaches the caller.
• iOS only: add Purchasely.signPromotionalOfferWithToken(storeProductId, storeOfferId, {String? purchaseContextToken}). It signs over a purchase context token (native PR Purchasely-iOS-Sources#826, MOB-593) and returns the signature map plus purchaseContextToken, in lowercase. A null token makes the SDK generate one. An empty or malformed token gives a PlatformException and no native call. On Android it answers an empty map, like the existing method.
• Mark signPromotionalOffer @Deprecated. Its behavior does not change: it still signs over the anonymous user id.
• The example app uses the new sign method. Docs: sdk_public_doc.md (including where the purchase must carry purchaseContextToken: StoreKit 1 applicationUsername, StoreKit 2 appAccountToken), the three CHANGELOGs, VERSIONS.md.
• Merged into this branch: Dependabot deps(android): bump org.robolectric:robolectric from 4.11.1 to 4.17 in /purchasely/android #160 (robolectric 4.17), deps(android): bump com.android.application from 9.4.0 to 9.4.1 in /purchasely/example/android #163 (AGP 9.4.1, example), deps(android): bump gradle-wrapper from 9.7.1 to 9.8.0 in /purchasely/android #165 and deps(android): bump gradle-wrapper from 9.6.1 to 9.8.0 in /purchasely/example/android #167 (Gradle wrapper 9.8.0), deps(android): bump org.mockito:mockito-core from 5.21.0 to 5.24.0 in /purchasely/android #166 (mockito 5.24.0), all test or build tooling, and docs(agents): merge CLAUDE.md into AGENTS.md as single source #168 (CLAUDE.md merged into AGENTS.md).
• README: the Purchasely logo is now the current one from purchasely.com (purchasely/images/icon.png, also the pub.dev screenshot), and the root README points to that file (its old path did not exist).

Why

Release 6.2.0 of the bridge, on top of the published native iOS and Android 6.2.0. #162 failed iOS CI because the bridge pinned iOS 6.1.2, which has no refundHandling; the 6.2.0 pin fixes it. Linear: MOB-581 (refundHandling), MOB-593 (token signing).

How to verify

Run locally on the branch by the builder (full suites):

• dart format --set-exit-if-changed . with Dart 3.5.4 in the three packages: 0 files changed (HEAD 6dc288b).
• flutter analyze --no-fatal-infos --no-fatal-warnings in the three packages: no issues (HEAD 6dc288b).
• cd purchasely && flutter test --coverage: 368 passed (HEAD 6dc288b). purchasely_google, purchasely_android_player: 2 passed each.
• cd purchasely/example/android && ./gradlew :purchasely_flutter:testDebugUnitTest --rerun-tasks: 33 tests, 0 failed.
• cd purchasely/example/ios && xcodebuild test -workspace Runner.xcworkspace -scheme Runner -only-testing:RunnerTests: 46 tests, 0 failures (HEAD cbda9c5).
• Example flutter build apk --debug|--release, flutter build appbundle --release, extension apps ./gradlew assembleRelease, xcodebuild build -scheme Runner: all succeed.
• Version Consistency and minSdk = 23 guards: pass.

The native Android and iOS suites ran on 2cf57f1. The only change after it is three doc/comment lines.

Notes

• Pre-PR review: a Herdr reviewer (Claude Opus, high) reviewed head 2cf57f1 against the plan and the native 6.2.0 sources. No blocker, no major finding. Three doc fixes (native pin line, consent doc, podspec comment) are folded in at 6dc288b. The plan had a cross-CLI review (Codex) before implementation.
• Dismissed: the copied "only available for iOS 15.0" message in the new iOS method. The #available guard says 12.2, the same as the existing method. The message stays identical to the existing one.
• Three small iOS seams: SwiftPurchaselyFlutterPlugin.purchaseContextToken(from:), SwiftPurchaselyFlutterPlugin.dataProcessingPurposes(from:) (both internal and pure) and PLYOfferSignature.toMap(purchaseContextToken:). Production code uses all three.
• Greptile (first pass): the consent mapping had no native test. Fixed in cbda9c5 with XCTests for both input orders, [] and an unknown value. The second pass gives 5/5 with no finding.
• CI E2E iOS: ci_run_e2e_ios.sh now runs the StoreKit suite last (66e71c9). Since feat: prepare the bridge for native 6.1.0 (anonymous user id, proxy, Web2App redemption) #153 two suites ran after it, and on the next launch StoreKit returned no usable product, so redemption_identity (R2 allProducts) failed on attempt 1 in every run and passed only on the retry. The script header already said StoreKit runs last. No Dart test or production code changes.
• Not covered by unit tests: the native success callback and error forwarding of the iOS token sign, and iOS emit (native class methods cannot be stubbed). The Android emit test uses mockkStatic, because emit is @JvmStatic.
• Local limits: flutter build ios and pod lib lint fail on this Xcode 27 host; a direct xcodebuild build succeeds. E2E runs on CI only.
• Supersedes feat(privacy): add the refundHandling data processing purpose #162 (closed).

Greptile

Requested: public SDK API (emit, signPromotionalOfferWithToken) and promotional offer signing (payments) in purchasely/lib/purchasely_flutter.dart and the iOS/Android plugins

🤖 Generated with Claude Code

[kherembourg]

@greptile review

[greptile-apps]

Confidence Score: 5/5

[High impact] The PR appears safe to merge, with the previous consent-test finding addressed and no new blocking issue found.

Summary

Releases the three Flutter packages at 6.2.0 with matching native SDK versions, custom events, token-based promotional offer signing, and iOS refund consent support.

• Adds native consent tests that address the previous review finding.
• Updates Android build and test dependencies, contributor guidance, and Observer-mode purchase instructions.
• No new actionable issue was found in the changes since the previous review.
• kherembourg explicitly retained the copied availability error message because it matches the existing method; the actual guard remains iOS 12.2.

_{Reviews (2) · Last reviewed commit: "docs: say where the purchase context tok..." · Reviewed by Greptile}

[Copilot]

🔵 Needs a closer look

The purchase-signing success and failure callbacks lack automated coverage and need final human validation.

1 open finding

• Add bridge-level tests for signing success and failure callbacks · New

What changed in this PR

Releases Purchasely Flutter SDK 6.2.0 with custom events, token-based promotional offer signing, and the refund-handling consent support from #162.

Changes:

• Aligns all packages and native SDK dependencies to 6.2.0.
• Adds emit, iOS token signing, and refund-handling consent; preserves combined iOS consent purposes.
• Updates documentation, examples, tests, and Android tooling.

File	Description
VERSIONS.md	Records native SDK compatibility.
sdk_public_doc.md	Documents new APIs and release dependencies.
README.md	Updates installation version.
purchasely/​test/​purchasely_flutter_test.dart	Tests refund-handling consent mapping.
purchasely/​test/​platform_channel_test.dart	Tests new channel methods.
purchasely/​pubspec.yaml	Sets version 6.2.0.
purchasely/​lib/​purchasely_flutter.dart	Exposes new APIs and consent purpose.
purchasely/​ios/​purchasely_flutter/​Package.swift	Pins iOS SDK 6.2.0.
purchasely/​ios/​purchasely_flutter/​Classes/​SwiftPurchaselyFlutterPlugin.swift	Implements iOS APIs and consent mapping.
purchasely/​ios/​purchasely_flutter/​Classes/​PLYOfferSignature+ToMap.swift	Serializes lowercase purchase tokens.
purchasely/​ios/​purchasely_flutter.podspec	Updates plugin and native versions.
purchasely/​example/​pubspec.lock	Locks example to plugin 6.2.0.
purchasely/​example/​lib/​main.dart	Demonstrates token-based signing.
purchasely/​example/​ios/​RunnerTests/​SwiftPurchaselyFlutterPluginTests.swift	Tests token validation and serialization.
purchasely/​example/​ios/​Podfile.lock	Locks updated iOS dependencies.
purchasely/​example/​ios/​Podfile	Updates dependency comments only.
purchasely/​example/​android/​settings.gradle	Updates Android application plugin.
purchasely/​example/​android/​gradle/​wrapper/​gradle-wrapper.properties	Updates example Gradle version.
purchasely/​example/​android/​app/​build.gradle	Aligns native extension dependencies.
purchasely/​CHANGELOG.md	Documents features, deprecation, and consent fix.
purchasely/​android/​src/​test/​kotlin/​io/​purchasely/​purchasely_flutter/​PurchaselyFlutterPluginTest.kt	Tests events, signing fallback, and store ordinal.
purchasely/​android/​src/​main/​kotlin/​io/​purchasely/​purchasely_flutter/​PurchaselyFlutterPlugin.kt	Adds event forwarding and signing fallback; adopts STRIPE.
purchasely/​android/​gradle/​wrapper/​gradle-wrapper.properties	Updates plugin Gradle version.
purchasely/​android/​build.gradle	Updates native SDK and test dependencies.
purchasely_google/​pubspec.yaml	Sets version 6.2.0.
purchasely_google/​CHANGELOG.md	Records extension release.
purchasely_google/​android/​build.gradle	Pins Google Play SDK 6.2.0.
purchasely_android_player/​pubspec.yaml	Sets version 6.2.0.
purchasely_android_player/​CHANGELOG.md	Records extension release.
purchasely_android_player/​android/​build.gradle	Pins Player SDK 6.2.0.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[kherembourg]

@greptile review

[greptile-apps]

Automatic reviews are disabled for this repository.