setCommonProperties static method

Future<void> setCommonProperties(Map<String, dynamic> props)

Thread-safe setter for common properties (public API). Filters out reserved keys to prevent accidental overwrites.

Implementation

static Future<void> setCommonProperties(Map<String, dynamic> props) async {
  await _lock.synchronized(() {
    for (final entry in props.entries) {
      if (reservedCommonKeys.contains(entry.key)) continue;
      // Allow overwriting existing keys even at capacity
      if (_commonProperties.length >= maxCommonProperties &&
          !_commonProperties.containsKey(entry.key)) {
        continue;
      }
      _commonProperties[entry.key] = entry.value;
    }
  });
}