Merge branch 'main' into rlamb/o11y-add-environment-id-support

Author: kinyoklion

.github/workflows/release-please.yml

@@ -16,7 +16,8 @@ jobs:
     # Needed to get tokens during publishing.
     permissions:
       id-token: write
-      contents: read
+      contents: write
+      pull-requests: write
     runs-on: ubuntu-latest
     steps:
       # Normally a workflow cannot trigger another workflow. For this workflow we need to create a

.release-please-manifest.json

@@ -1 +1 @@
-{"packages/common":"1.6.0","packages/common_client":"1.6.1","packages/event_source_client":"1.2.0","packages/flutter_client_sdk":"4.11.1"}
+{"packages/common":"1.6.1","packages/common_client":"1.6.2","packages/event_source_client":"1.2.1","packages/flutter_client_sdk":"4.11.2"}

apps/sse_contract_test_service/pubspec.lock

@@ -311,7 +311,7 @@ packages:
       path: "../../packages/event_source_client"
       relative: true
     source: path
-    version: "1.2.0"
+    version: "1.2.1"
   lints:
     dependency: "direct dev"
     description:

packages/common/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to the LaunchDarkly Dart Common will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org).
 
+## [1.6.1](https://github.com/launchdarkly/flutter-client-sdk/compare/launchdarkly_dart_common-v1.6.0...launchdarkly_dart_common-v1.6.1) (2025-09-03)
+
+
+### Bug Fixes
+
+* improves handling of invalid contexts and adds SSE Client logging. ([#207](https://github.com/launchdarkly/flutter-client-sdk/issues/207)) ([fcab81f](https://github.com/launchdarkly/flutter-client-sdk/commit/fcab81f006f6efd78206756447d2587f87b8c43c))
+
 ## [1.6.0](https://github.com/launchdarkly/flutter-client-sdk/compare/launchdarkly_dart_common-v1.5.0...launchdarkly_dart_common-v1.6.0) (2025-05-09)
 
 

packages/common/lib/src/async/async_single_queue.dart

@@ -31,15 +31,14 @@ final class _Pending<TTaskReturn> {
   _Pending(this._fn, this._completer);
 
   Future<TaskResult<TTaskReturn>> execute() {
-    this
-        ._fn()
+    _fn()
         .then((value) => _completer.complete(TaskComplete(value)))
         .catchError((err) => _completer.complete(TaskError(err)));
-    return this._completer.future;
+    return _completer.future;
   }
 
   void shed() {
-    this._completer.complete(TaskShed());
+    _completer.complete(TaskShed());
   }
 }
 

packages/common/pubspec.yaml

@@ -1,6 +1,6 @@
 name: launchdarkly_dart_common
 description: Common dart libraries used by LaunchDarkly SDKs. This is an internal package not designed for general use.
-version: 1.6.0
+version: 1.6.1
 homepage: https://github.com/launchdarkly/flutter-client-sdk
 repository: https://github.com/launchdarkly/flutter-client-sdk/tree/main/packages/common
 

packages/common/test/ld_context_test.dart

@@ -63,6 +63,22 @@ void main() {
     expect(LDContextBuilder().build().canonicalKey, '');
   });
 
+  test('can modify an invalid context to become valid', () {
+    // Start with an invalid context (no kind specified)
+    final invalidContext = LDContextBuilder().build();
+    expect(invalidContext.valid, false);
+    expect(invalidContext.canonicalKey, '');
+
+    // Modify it to become valid by adding a valid kind
+    final validContext = LDContextBuilder.fromContext(invalidContext)
+        .kind('user', 'user-key')
+        .build();
+
+    expect(validContext.valid, true);
+    expect(validContext.canonicalKey, 'user-key');
+    expect(validContext.keys, <String, String>{'user': 'user-key'});
+  });
+
   test('can change the key of a context during build', () {
     final context = LDContextBuilder()
         .kind('user', 'user-key')

packages/common_client/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to the LaunchDarkly Common Client will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org).
 
+## [1.6.2](https://github.com/launchdarkly/flutter-client-sdk/compare/launchdarkly_common_client-v1.6.1...launchdarkly_common_client-v1.6.2) (2025-09-03)
+
+
+### Bug Fixes
+
+* improves handling of invalid contexts and adds SSE Client logging. ([#207](https://github.com/launchdarkly/flutter-client-sdk/issues/207)) ([fcab81f](https://github.com/launchdarkly/flutter-client-sdk/commit/fcab81f006f6efd78206756447d2587f87b8c43c))
+
 ## [1.6.1](https://github.com/launchdarkly/flutter-client-sdk/compare/launchdarkly_common_client-v1.6.0...launchdarkly_common_client-v1.6.1) (2025-05-09)
 
 

packages/common_client/lib/src/context_modifiers/anonymous_context_modifier.dart

@@ -8,17 +8,20 @@ const _anonContextKeyNamespace = 'LaunchDarkly_AnonContextKey';
 
 final class AnonymousContextModifier implements ContextModifier {
   final Persistence _persistence;
+  final LDLogger _logger;
 
-  AnonymousContextModifier(Persistence persistence)
-      : _persistence = persistence;
+  AnonymousContextModifier(Persistence persistence, LDLogger logger)
+      : _persistence = persistence,
+        _logger = logger;
 
   /// For any anonymous contexts, which do not have keys specified, generate
   /// or read a persisted key for the anonymous kinds present. If persistence
   /// is available, then the key will be stable.
   @override
   Future<LDContext> decorate(LDContext context) async {
     if (!context.valid) {
-      return context;
+      _logger.warn(
+          'AnonymousContextModifier was asked to modify an invalid context and will attempt to do so. This is expected if starting with an empty context.');
     }
     // Before we make a builder we should check if any anonymous contexts
     // without keys exist.

packages/common_client/lib/src/context_modifiers/env_context_modifier.dart

@@ -42,6 +42,11 @@ final class AutoEnvContextModifier implements ContextModifier {
 
   @override
   Future<LDContext> decorate(LDContext context) async {
+    if (!context.valid) {
+      _logger.warn(
+          'AutoEnvContextModifier was asked to modify an invalid context and will attempt to do so. This is expected if starting with an empty context.');
+    }
+
     final builder = LDContextBuilder.fromContext(context);
 
     for (final recipe in _recipes) {