[tompsota]

What's new

Unifies the Flutter public API with the native SDKs and the other freeRASP plugins (React Native, Capacitor, Cordova) for the 9.0.0 major release. All changes are breaking and listed in the 9.0.0 changelog.

Config fields follow the native SDKs

Before	After
AndroidConfig.signingCertHashes	certificateHashes
AndroidConfig.supportedStores	supportedAlternativeStores
IOSConfig.bundleIds	appBundleIds (still List<String>)
IOSConfig.teamId	appTeamId

The JSON keys from toJson/fromJson change with them. The Kotlin parser and the Swift Codable model read the new keys.

Threat names match the other plugins

ThreatCallback.onADBEnabled → onAdbEnabled, onUnsecureWiFi → onUnsecureWifi; Threat.deviceId → deviceID, Threat.unsecureWiFi → unsecureWifi.

One error type

Every Talsec method throws only TalsecException or a subclass:

• new UnsupportedPlatformException (unsupported-platform) replaces UnimplementedError for Android-only methods and unsupported platforms
• blockScreenCapture and isScreenCaptureBlocked no longer throw a generic Exception
• start wraps platform errors in TalsecException
• addToWhitelist and getAppIcon throw MalwareFailureException
• ExternalIdFailureException and MalwareFailureException are now exported

The JS plugins use the same code values for their new TalsecError.

Methods already returned void or a meaningful bool, so return types are unchanged.

Notes

• Stacked on release: freeRASP 9.0.0 (Android SDK 20.0.1) #241 (chore/android-sdk-20.0.1).
• The *.g.dart serializers were edited only to rename the JSON keys. The current json_serializable emits Dart 3.8 syntax (null-aware elements), which the package's sdk: >=3.5.0 constraint doesn't allow, so regenerating with it would raise the minimum Dart version.

Testing

• flutter analyze is clean; flutter test passes 87 tests (Android-only guards now expect UnsupportedPlatformException, including addToWhitelist/getAppIcon)
• Example builds for Android (debug APK) and the iOS simulator
• Example launched on the Android emulator (Pixel 4, API 33): Talsec starts with the renamed config, fast checks finish and malware detection reports suspicious apps
• Not run on an iOS device or simulator

🤖 Generated with Claude Code

[tompsota]

Added in f61a674 (all breaking, listed in the changelog):

• Talsec.private and the methodChannel / eventChannel / executionStateChannel fields are now private. Tests build an instance through an internal createTalsecForTesting factory, which package:freerasp/freerasp.dart hides.
• MalwareCallback receives List<SuspiciousAppInfo> suspiciousApps (no nullable items). The Pigeon parameter is renamed the same way and the Dart/Kotlin bindings are regenerated.
• ThreatX.fromInt throws ArgumentError like RaspExecutionStateX.fromInt, and its doc comment lists the current codes. Talsec terminates the app on an unknown code from either stream, as the JS plugins do; before, only unknown threat codes did.

Checked: flutter analyze clean, 88 tests pass, example debug APK builds. Not run on an emulator.