chore: bump version to v0.10.0 (#143)

## Summary
- Bump version from 0.9.0 to 0.10.0
- Update version in pubspec.yaml, android/build.gradle,
ios/faro.podspec, lib/src/util/constants.dart
- Update CHANGELOG.md with release date

## What's in this release

### Added
- **Session sampling support**: New `sampling` configuration option
allows controlling what percentage of sessions send telemetry data. This
enables cost management and traffic reduction for high-volume
applications. (Resolves #89)
  - Use `SamplingRate(0.5)` for fixed 50% sampling
- Use `SamplingFunction((context) => ...)` for dynamic sampling based on
session context
- Sampling decision is made once per session and applies to all
telemetry types

- **ContextScope for span context lifetime control**: New `contextScope`
parameter on `startSpan()` controls how long a span remains active in
zone context. (Resolves #105)

- **Span.noParent sentinel**: New `Span.noParent` static constant allows
explicitly starting a span with no parent. (Resolves #105)

### Fixed
- **SDK-internal span attributes now use typed values**: HTTP span
attributes are now sent as integers instead of strings, enabling proper
numeric queries in Tempo
- **Session attributes support typed values**: `sessionAttributes`
config now accepts `Map<String, Object>` allowing typed custom
attributes (Resolves #133)

### Checklist
- [x] Pre-release checks passed
- [x] Version bumped in all files
- [x] CHANGELOG updated with release date
- [x] Post-release checks passed (dry-run publish)

Made with [Cursor](https://cursor.com)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Mostly release/versioning changes, but it adds an automated script
that creates tags and GitHub releases (and can call an external OpenAI
API), so incorrect usage/config could affect release integrity.
> 
> **Overview**
> Bumps the package version to `0.10.0` across Dart (`pubspec.yaml`,
`FaroConstants`), Android (`build.gradle`), iOS (`faro.podspec`), and
the example lockfile, and adds a dated `0.10.0` entry to `CHANGELOG.md`.
> 
> Updates the release process docs to use a new `dart
tool/create_release.dart` script, which extracts the current version’s
changelog section, previews release notes, creates/pushes a git tag, and
creates a GitHub release via `gh` (optionally AI-enriching notes via
`OPENAI_API_KEY`), with new unit tests covering changelog extraction
edge cases.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
117d3f0. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: robert-northmind

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-02-09
+
 ### Added
 
 - **Session sampling support**: New `sampling` configuration option allows controlling what percentage of sessions send telemetry data. This enables cost management and traffic reduction for high-volume applications. (Resolves #89)

RELEASING.md

@@ -85,22 +85,32 @@ As you develop new features or fix bugs, add entries to the `CHANGELOG.md` under
    - Title: `chore: bump version to v0.3.4`
    - Description: Review changelog and version updates
 
-7. **Merge and Tag**
+7. **Create Release**
 
-   After PR review and merge:
+   After PR review and merge, use the release script:
 
    ```bash
    git checkout main
    git pull origin main
-   git tag v0.3.4
-   git push origin v0.3.4
+   dart tool/create_release.dart
    ```
 
+   > **Tip:** Use `dart tool/create_release.dart --dry-run` to preview without creating anything.
+
+   > **Tip:** Use `dart tool/create_release.dart --enrich` to use AI to generate polished release notes from the changelog (requires `OPENAI_API_KEY` environment variable).
+
+   This will:
+
+   - Read the version from `pubspec.yaml`
+   - Extract release notes from `CHANGELOG.md`
+   - Show a preview and ask for confirmation
+   - Create and push the git tag
+   - Create a GitHub release with changelog content and compare link
+
 8. **Automated Publishing**
 
    - GitHub Actions automatically publishes to pub.dev when you push a version tag
    - Uses the `pub.dev` GitHub environment for security
-   - Creates a GitHub release automatically
    - No manual `flutter pub publish` needed!
 
 9. **Post-Release**

android/build.gradle

@@ -1,5 +1,5 @@
 group 'com.grafana.faro'
-version '0.9.0'
+version '0.10.0'
 
 buildscript {
     repositories {

example/pubspec.lock

@@ -167,7 +167,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "0.9.0"
+    version: "0.10.0"
   ffi:
     dependency: transitive
     description:

ios/faro.podspec

@@ -4,7 +4,7 @@
 #
 Pod::Spec.new do |s|
   s.name             = 'faro'
-  s.version          = '0.9.0'
+  s.version          = '0.10.0'
   s.summary          = 'A new Flutter plugin project.'
   s.description      = <<-DESC
 A new Flutter plugin project.

lib/src/util/constants.dart

@@ -1,7 +1,7 @@
 /// Constants for the Faro Flutter SDK
 class FaroConstants {
   /// The version of the Faro Flutter SDK
-  static const String sdkVersion = '0.9.0';
+  static const String sdkVersion = '0.10.0';
 
   /// The name of the Faro Flutter SDK
   static const String sdkName = 'faro-flutter-sdk';

pubspec.yaml

@@ -1,6 +1,6 @@
 name: faro
 description: Grafana Faro SDK for Flutter applications - Monitor your Flutter app with ease.
-version: 0.9.0
+version: 0.10.0
 homepage: https://grafana.com/oss/faro/
 repository: https://github.com/grafana/faro-flutter-sdk
 

test/tool/create_release_test.dart

@@ -0,0 +1,96 @@
+import 'package:flutter_test/flutter_test.dart';
+
+import '../../tool/create_release.dart';
+
+typedef Lines = List<String>;
+
+void main() {
+  group('extractChangelogForVersion:', () {
+    test('extracts content for a specific version', () {
+      final content = _joinLines([
+        '# Changelog',
+        '',
+        '## [Unreleased]',
+        '',
+        '## [0.10.0] - 2026-02-09',
+        '',
+        '### Added',
+        '- New feature A',
+        '- New feature B',
+        '',
+        '## [0.9.0] - 2026-01-28',
+        '',
+        '### Fixed',
+        '- Bug fix C',
+      ]);
+
+      final extracted = extractChangelogForVersion(content, '0.10.0');
+
+      expect(extracted, contains('### Added'));
+      expect(extracted, contains('- New feature A'));
+      expect(extracted, contains('- New feature B'));
+      expect(extracted, isNot(contains('### Fixed')));
+      expect(extracted, isNot(contains('- Bug fix C')));
+    });
+
+    test('stops at next header even if version is prefix', () {
+      final content = _joinLines([
+        '# Changelog',
+        '',
+        '## [Unreleased]',
+        '',
+        '## [0.1.1] - 2026-02-01',
+        '- Fix alpha issue',
+        '',
+        '## [0.1.10] - 2026-02-03',
+        '- Add beta feature',
+        '',
+        '## [0.1.2] - 2026-02-04',
+        '- Another fix',
+      ]);
+
+      final extracted = extractChangelogForVersion(content, '0.1.1');
+
+      expect(extracted, contains('- Fix alpha issue'));
+      expect(extracted, isNot(contains('- Add beta feature')));
+      expect(extracted, isNot(contains('- Another fix')));
+    });
+
+    test('throws when version is not found', () {
+      final content = _joinLines([
+        '# Changelog',
+        '',
+        '## [Unreleased]',
+        '',
+        '## [0.1.0] - 2026-01-01',
+        '- Initial release',
+      ]);
+
+      expect(
+        () => extractChangelogForVersion(content, '0.2.0'),
+        throwsA(isA<Exception>()),
+      );
+    });
+
+    test('removes leading and trailing empty lines', () {
+      final content = _joinLines([
+        '## [0.5.0] - 2026-01-01',
+        '',
+        '',
+        '### Added',
+        '- Feature X',
+        '',
+        '',
+        '## [0.4.0] - 2025-12-01',
+        '- Old stuff',
+      ]);
+
+      final extracted = extractChangelogForVersion(content, '0.5.0');
+
+      expect(extracted, startsWith('### Added'));
+      expect(extracted, endsWith('- Feature X'));
+    });
+  });
+}
+
+String _joinLines(Lines lines) => lines.join('\n');