Flutter SDK meta properties (#135)

> [!IMPORTANT]
> **This PR cannot be merged until
[grafana/app-o11y-kwl-endpoint#987](grafana/app-o11y-kwl-endpoint#987)
is merged and deployed.**
>
> Without that backend fix, all telemetry from this SDK would be
rejected because this SDK currently has version `0.9.0`, and the old
backend requires versions of at least `1.3.5`.

## Description

This PR aligns the Faro Flutter SDK's metadata (`meta.sdk.version` and
`meta.sdk.name`) with the patterns established in the Faro Web SDK.

The changes ensure:
* Consistent SDK naming (`faro-mobile-flutter`) across Faro mobile
implementations.
* Accurate reporting of the SDK version, moving from a hardcoded value
to `FaroConstants.sdkVersion`.
* Removal of the `integrations` field from the `Sdk` model, as it
provided no actionable insights and aligns with the web SDK's simplified
model.

These updates enable better SDK version analytics, distribution
tracking, and proper version checking by the backend endpoint service.

## Related Issue(s)

Closes grafana/faro-flutter-sdk#7403

## Type of Change

- [ ] 🛠️ Bug fix (non-breaking change which fixes an issue)
- [x] 🚀 New feature (non-breaking change which adds functionality)
- [ ] 💥 Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] 📝 Documentation
- [ ] 📈 Performance improvement
- [x] 🏗️ Code refactoring
- [ ] 🧹 Chore / Housekeeping

## Checklist

- [x] I have made corresponding changes to the documentation
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] I have updated the CHANGELOG.md under the "Unreleased" section

## Screenshots (if applicable)

N/A

## Additional Notes

This PR directly addresses the discussion regarding `meta.sdk.version`
and `meta.sdk.name` alignment with the Faro Web SDK, as well as the
simplification of the `Sdk` model by removing the `integrations` field.
All tests pass with these changes.

---
[Slack
Thread](https://raintank-corp.slack.com/archives/C04LHN01GN7/p1769688028990529?thread_ts=1769688028.990529&cid=C04LHN01GN7)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Changes the shape and values of emitted metadata (`meta.sdk`, session
attributes), which can affect backend validation/analytics and
downstream dashboards even though the code changes are small.
> 
> **Overview**
> Updates telemetry `meta.sdk` to match Faro Web SDK conventions:
renames the SDK identifier to `faro-mobile-flutter` and reports the real
SDK version via `FaroConstants.sdkVersion` (removing the previous
hardcoded `1.3.5` workaround).
> 
> Simplifies SDK metadata by removing the `integrations` field (and the
`Integration` model/export), and stops emitting `faro_sdk_version` as a
session attribute; docs/changelog and affected tests are updated
accordingly.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
a223839. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: robert.magnusson <robert.magnusson@grafana.com>

Author: robert-northmind

CHANGELOG.md

@@ -129,6 +129,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Span.noParent sentinel**: New `Span.noParent` static constant allows explicitly starting a span with no parent, ignoring the active span in zone context. Useful for timer callbacks or event-driven scenarios where you want to start a fresh, independent trace. (Resolves #105)
 
+### Changed
+
+- **SDK metadata improvements**: Updated SDK identification to align with Faro Web SDK patterns and improve backend analytics
+  - Changed SDK name from `'faro-flutter-sdk'` to `'faro-mobile-flutter'` to match naming convention discussed with Faro team
+  - Removed hardcoded version `'1.3.5'` workaround and now sends actual SDK version (`0.9.0`) in `meta.sdk.version`
+  - Removed `integrations` field from SDK metadata (following Faro Web SDK pattern - this field provided no actionable insights)
+  - Removed unused `Integration` model class and its export from models barrel file
+  - Backend endpoint service now properly handles Flutter SDK payloads with correct version checking
+  - Enables better SDK version analytics and distribution tracking across different Faro implementations
+
 ### Fixed
 
 - **SDK-internal span attributes now use typed values**: HTTP span attributes (`http.status_code`, `http.request_size`, `http.response_size`) are now sent as integers instead of strings, enabling proper numeric queries in Tempo (e.g., `status_code > 400`)

doc/Reference.md

@@ -123,7 +123,6 @@ Every telemetry event automatically includes these session attributes:
 
 | Attribute             | Description                 | iOS Example          | Android Example       |
 | --------------------- | --------------------------- | -------------------- | --------------------- |
-| `faro_sdk_version`    | SDK version                 | `0.10.0`             | `0.10.0`              |
 | `dart_version`        | Dart runtime version        | `3.10.1 (stable)...` | `3.10.1 (stable)...`  |
 | `device_os`           | Operating system            | `iOS`                | `Android`             |
 | `device_os_version`   | OS version                  | `17.0`               | `15`                  |
@@ -137,6 +136,17 @@ Every telemetry event automatically includes these session attributes:
 
 > \*Android does not provide a mapping from model codes to marketing names, so `device_model_name` equals `device_model`.
 
+### SDK Metadata
+
+In addition to session attributes, every telemetry payload includes SDK identification via the `meta.sdk` object. These values are set automatically and cannot be changed by the user.
+
+| Field              | Description       | Example              |
+| ------------------ | ----------------- | -------------------- |
+| `meta.sdk.name`    | SDK identifier    | `faro-mobile-flutter`|
+| `meta.sdk.version` | SDK version       | `0.12.0`             |
+
+In Grafana Cloud Frontend Observability, these appear as `sdk_name` and `sdk_version` in the structured metadata of each telemetry event.
+
 ---
 
 ## Performance Monitoring
@@ -948,7 +958,7 @@ Faro().runApp(
 
 **Notes:**
 
-- Custom attributes are merged with default attributes (like `faro_sdk_version`, `device_os`, `device_model`, etc.)
+- Custom attributes are merged with default attributes (like `device_os`, `device_model`, etc.)
 - Default attributes take precedence if there are naming conflicts
 - Session attributes are included in all telemetry data (logs, events, exceptions, traces)
 - **Type handling**: Session attributes support typed values (String, int, double, bool):

lib/src/device_info/session_attributes_provider.dart

@@ -1,6 +1,5 @@
 import 'package:faro/src/device_info/device_id_provider.dart';
 import 'package:faro/src/device_info/device_info_provider.dart';
-import 'package:faro/src/util/constants.dart';
 
 class SessionAttributesProvider {
   SessionAttributesProvider({
@@ -17,7 +16,6 @@ class SessionAttributesProvider {
     final deviceInfo = await _deviceInfoProvider.getDeviceInfo();
 
     final attributes = <String, Object>{
-      'faro_sdk_version': FaroConstants.sdkVersion,
       'dart_version': deviceInfo.dartVersion,
       'device_os': deviceInfo.deviceOs,
       'device_os_version': deviceInfo.deviceOsVersion,

lib/src/faro.dart

@@ -93,7 +93,7 @@ class Faro {
       SessionIdProviderFactory().create().sessionId,
       attributes: {},
     ),
-    sdk: Sdk(FaroConstants.sdkName, '1.3.5', []),
+    sdk: Sdk(FaroConstants.sdkName, FaroConstants.sdkVersion),
     app: App(name: '', environment: '', version: ''),
     view: ViewMeta('default'),
   );

lib/src/models/integrations.dart

@@ -5,7 +5,6 @@ export './device_info.dart';
 export './event.dart';
 export './exception.dart';
 export './faro_user.dart';
-export './integrations.dart';
 export './log.dart';
 export './log_level.dart';
 export './measurement.dart';

lib/src/models/models.dart

@@ -1,27 +1,17 @@
-import 'package:faro/src/models/integrations.dart';
-
 class Sdk {
-  Sdk(this.name, this.version, this.integrations);
+  Sdk(this.name, this.version);
 
   Sdk.fromJson(dynamic json) {
     name = json['name'];
     version = json['version'];
-    if (json['integrations'] != null) {
-      integrations = [];
-      json['integrations'].forEach((dynamic v) {
-        integrations.add(Integration.fromJson(v));
-      });
-    }
   }
   String name = '';
   String version = '';
-  List<Integration> integrations = [];
 
   Map<String, dynamic> toJson() {
     final map = <String, dynamic>{};
     map['name'] = name;
     map['version'] = version;
-    map['integrations'] = integrations.map((v) => v.toJson()).toList();
     return map;
   }
 }

lib/src/models/sdk.dart

@@ -4,5 +4,5 @@ class FaroConstants {
   static const String sdkVersion = '0.13.0';
 
   /// The name of the Faro Flutter SDK
-  static const String sdkName = 'faro-flutter-sdk';
+  static const String sdkName = 'faro-mobile-flutter';
 }

lib/src/util/constants.dart

@@ -2,7 +2,6 @@ import 'package:faro/src/device_info/device_id_provider.dart';
 import 'package:faro/src/device_info/device_info_provider.dart';
 import 'package:faro/src/device_info/session_attributes_provider.dart';
 import 'package:faro/src/models/models.dart';
-import 'package:faro/src/util/constants.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:mocktail/mocktail.dart';
 
@@ -46,7 +45,6 @@ void main() {
       final attributes = await sut.getAttributes();
 
       expect(attributes, {
-        'faro_sdk_version': FaroConstants.sdkVersion,
         'dart_version': 'Some-dart-version',
         'device_os': 'Some-OS',
         'device_os_version': 'Some-OS-version',

test/src/device_info/session_attributes_provider_test.dart

@@ -129,7 +129,6 @@ void main() {
         expect(sessionAttributes?['custom_label'], 'test_value');
 
         // Default attributes should also be present
-        expect(sessionAttributes?['faro_sdk_version'], isNotNull);
         expect(sessionAttributes?['device_os'], isNotNull);
         expect(sessionAttributes?['device_model'], isNotNull);
       },
@@ -152,7 +151,6 @@ void main() {
       expect(sessionAttributes, isNotNull);
 
       // Only default attributes should be present
-      expect(sessionAttributes?['faro_sdk_version'], isNotNull);
       expect(sessionAttributes?['device_os'], isNotNull);
       expect(sessionAttributes?['device_model'], isNotNull);
     });
@@ -174,7 +172,6 @@ void main() {
       expect(sessionAttributes, isNotNull);
 
       // Only default attributes should be present
-      expect(sessionAttributes?['faro_sdk_version'], isNotNull);
       expect(sessionAttributes?['device_os'], isNotNull);
       expect(sessionAttributes?['device_model'], isNotNull);
     });
@@ -286,7 +283,6 @@ void main() {
       }
 
       // Default attributes should still be present
-      expect(sessionAttributes?['faro_sdk_version'], isNotNull);
       expect(sessionAttributes?['device_os'], isNotNull);
     });
   });