b2metric_sdk 1.0.0

B2Metric analytics SDK for Flutter. Collects events, manages sessions, and supports push notifications on Android and iOS.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2026-07-21

Changed

• First stable release. The public API is now considered stable under semantic versioning. No functional changes since 0.4.0.

0.4.0 - 2026-06-21

Added

• B2Metric.setUser() to identify the current user and update their profile attributes. Accepts userId (required) plus optional name, surname, email, and any custom attributes via properties.
• B2MetricUser type export.

Changed

• User attributes set via setUser are merged into the user_properties of subsequent events. The user_properties of each event is now a point-in-time snapshot, and device-collected fields always take precedence over custom attributes.

0.3.0 - 2026-06-02

Added

• iOS Swift Package Manager (SPM) support, required for Flutter 3.44+ where SPM is the default iOS/macOS dependency manager. CocoaPods support is retained, so existing apps are unaffected.

0.2.0 - 2026-05-21

Added

• appIdentifier field in B2MetricConfig to identify the app registered in B2Metric. Validated as lowercase snake_case (^[a-z][a-z0-9]*(_[a-z0-9]+)*$).
• app_identifier is now included in collected user properties.

Changed

• BREAKING: B2Metric.init() now requires appIdentifier in addition to apiKey. Calls without it will throw at initialization.

0.1.0 - 2026-05-17

Added

• Initial release of the B2Metric Flutter SDK.
• Custom event tracking with properties and item-level data.
• Automatic session management (first_open, session_start, session_end).
• Push notification token registration (FCM, HMS, APNS) and open tracking.
• Offline event queuing with persistent storage on SharedPreferences / UserDefaults.
• Automatic batching, retry with exponential backoff, and network-aware delivery.
• Automatic device and app metadata collection.
• Optional onLog callback to forward SDK logs to a custom sink.
• Example testbed app under example/.