b2metric_sdk

Changed

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

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.

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.

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.

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/.