MOEN-45999: Add Flutter Android bridge and Dart interface for jwt

[kkgowtham-engg-sdk]

Summary

• Android: JWT Authentication Support added to the existing moengage_flutter_android package (core) — authenticationDetails (fire-and-forget) + onAuthenticationError event via EventEmitterImpl
• Dart: platform interface (moengage_flutter_platform_interface) + public API (moengage_flutter) for JWT authentication
  • MoEngageFlutter.passAuthenticationDetails(token, userIdentifier)
  • MoEngageFlutter.setAuthenticationErrorCallbackHandler(handler) → AuthenticationErrorData with JwtErrorCode
• Sample app (example/lib/main.dart): registers setAuthenticationErrorCallbackHandler in initState, plus a "Pass JWT Authentication Details" demo tile
• No iOS changes in this PR (Android + Dart only, per request)
• Android BOM: unchanged, inherited from feature/MOEN-45889_major_version_update (already on android-bom 4.0.0 / plugin-base-bom 4.0.0-SNAPSHOT, which includes JWT support merged in plugin-base 6.1.0)

Related PRs

• android-plugin-base: https://github.com/moengage/android-plugin-base/pull/104

Contract

Branch: master in mobile-sdk-contracts (contract dir: authentication, top-level core contract)

Changelogs updated

• packages/moengage_flutter/moengage_flutter_android/CHANGELOG.md
• packages/moengage_flutter/moengage_flutter_platform_interface/CHANGELOG.md
• packages/moengage_flutter/moengage_flutter/CHANGELOG.md

Methods

Method	Type	Android handler	Dart
authenticationDetails	fire-and-forget	PluginHelper.passAuthenticationDetails(context, payload)	passAuthenticationDetails(token, userIdentifier)
onAuthenticationError (event)	event	EventEmitterImpl.emitAuthenticationErrorEvent → authenticationErrorToJson	setAuthenticationErrorCallbackHandler(handler)

Sample App

• example/lib/main.dart updated to demonstrate the new JWT authentication APIs (listener registration + demo tile)

🤖 Generated with Claude Code

[moe-hodor]

🚪 Hodor is reviewing this PR... 👀

[moe-hodor]

Review: MOEN-45999 — Add Flutter Android bridge for JWT

Branching & CFR: feature/MOEN-45999-jwt_authentication — category: feature, impact: Neutral CFR ✅

---

Summary

This PR adds the Android Kotlin bridge for JWT authentication support to the Flutter SDK. It implements:

• Fire-and-forget authenticationDetails method to pass JWT auth details from Dart → Android → native SDK
• Event emitter integration for onAuthenticationError events flowing back from native → Android → Dart
• Correct event mapping in EventEmitterImpl for authentication error events

This is Phase 1 (Android bridge only) — Dart platform interface and iOS implementation are explicitly mentioned as following in subsequent commits on this branch.

---

Quality Gates

✅ PR Size: 38 lines across 4 files — well-scoped
ℹ️ Tests: No test files modified — existing tests should still pass
✅ Commits: 1 commit
✅ No migrations or config drift detected

---

Jira Alignment: MOEN-45999

✅ Ticket scope: "JWT support for Flutter"
✅ PR addresses: Android bridge layer (as stated in DoD — "Implementation complete")
ℹ️ Remaining work: Dart interface + iOS bridge (explicitly noted in PR description)

---

Issues Found

🟢 0 Critical | 🟡 0 Warnings | 💡 2 Suggestions

---

Key Observations

What's Good:

• ✅ Correct use of PluginHelper.passAuthenticationDetails() from plugin-base-bom:4.0.0-SNAPSHOT (which includes JWT support)
• ✅ Event emitter correctly handles AuthenticationErrorEvent and maps it to onAuthenticationError callback
• ✅ Proper imports from plugin-base (authenticationErrorToJson, AuthenticationErrorEvent)
• ✅ Method handler wired correctly in MoEngageFlutterPlugin.onMethodCall()
• ✅ Error handling with try-catch and logging in all new methods
• ✅ Consistent with existing code patterns (matches logout, identifyUser, etc.)
• ✅ CHANGELOG updated with correct [minor] change

Architectural Verification:

• ✅ Dependencies verified via cross-org search: passAuthenticationDetails and authenticationErrorToJson exist in android-plugin-base:4.0.0-SNAPSHOT
• ✅ BOM version plugin-base-bom:4.0.0-SNAPSHOT already correct in base branch (feature/MOEN-45889_major_version_update)
• ✅ Event flow matches existing patterns: AuthenticationErrorEvent → EventEmitterImpl.emitAuthenticationErrorEvent() → MethodChannel → Dart (once Dart layer is added)

No Blocking Issues Found
The Android bridge implementation is complete and correct. The missing Dart layer (platform interface + public API + callback handlers) is intentional per the PR description ("Dart platform interface + public API to follow in a subsequent commit on this branch").

---

Suggestions for Follow-Up Work

💡 When implementing the Dart layer in subsequent commits, ensure:

1. Add AuthenticationErrorCallbackHandler typedef in callback/callbacks.dart (similar to LogoutCompleteCallbackHandler)
2. Add callback field in CallbackCache class
3. Add callback listener registration method in MoEngageFlutter class
4. Add event handler in MoECoreController to deserialize and route onAuthenticationError events
5. Add passAuthenticationDetails(authData, appId) method to MoEngageFlutterPlatform abstract class and MethodChannelMoEngageFlutter implementation
6. Define const String methodAuthenticationDetails = 'authenticationDetails'; in constants.dart
7. Add const String callbackOnAuthenticationError = 'onAuthenticationError'; in constants.dart

💡 Consider adding integration tests for the full JWT flow once iOS + Dart layers are complete (can be deferred to a separate PR).

---

Regression Risk

🟢 Low — This PR is purely additive. No existing code paths modified, only new method + event handler added.

---

Verdict

✅ Android bridge implementation is complete and correct. No blocking issues. The PR is scoped correctly as Phase 1 (Android-only), with Dart + iOS explicitly noted as follow-up work on this branch.

Once the Dart platform interface and iOS bridge are added in subsequent commits, the full JWT feature will be complete.

---

Hodor says: The Android gate is solid. The bridge holds. 🛡️