feat: Add tracking event handling to MultiProvider and evaluation strategy

Signed-off-by: André Silva <[email protected]>

Author: askpt

src/OpenFeature.Providers.MultiProvider/MultiProvider.cs

@@ -113,6 +113,37 @@ public override Task<ResolutionDetails<string>> ResolveStringValueAsync(string f
     public override Task<ResolutionDetails<Value>> ResolveStructureValueAsync(string flagKey, Value defaultValue, EvaluationContext? context = null, CancellationToken cancellationToken = default) =>
         this.EvaluateAsync(flagKey, defaultValue, context, cancellationToken);
 
+    /// <inheritdoc/>
+    public override void Track(string trackingEventName, EvaluationContext? evaluationContext = default, TrackingEventDetails? trackingEventDetails = default)
+    {
+        if (this._disposed == 1)
+        {
+            throw new ObjectDisposedException(nameof(MultiProvider));
+        }
+
+        foreach (var registeredProvider in this._registeredProviders)
+        {
+            var providerContext = new StrategyPerProviderContext<object>(
+                registeredProvider.Provider,
+                registeredProvider.Name,
+                registeredProvider.Status,
+                string.Empty); // Empty flag key for tracking context
+
+            if (this._evaluationStrategy.ShouldTrackWithThisProvider(providerContext, evaluationContext, trackingEventName, trackingEventDetails))
+            {
+                try
+                {
+                    registeredProvider.Provider.Track(trackingEventName, evaluationContext, trackingEventDetails);
+                }
+                catch (Exception ex)
+                {
+                    // Log tracking errors but don't throw - tracking should not disrupt application flow
+                    this.LogErrorTrackingEvent(registeredProvider.Name, trackingEventName, ex);
+                }
+            }
+        }
+    }
+
     /// <inheritdoc/>
     public override async Task InitializeAsync(EvaluationContext context, CancellationToken cancellationToken = default)
     {
@@ -638,4 +669,7 @@ internal void SetStatus(ProviderStatus providerStatus)
 
     [LoggerMessage(EventId = 1, Level = LogLevel.Debug, Message = "Provider {ProviderName} is already being listened to")]
     private partial void LogProviderAlreadyBeingListenedTo(string providerName);
+
+    [LoggerMessage(EventId = 2, Level = LogLevel.Debug, Message = "Error tracking event {TrackingEventName} with provider {ProviderName}")]
+    private partial void LogErrorTrackingEvent(string providerName, string trackingEventName, Exception exception);
 }

src/OpenFeature.Providers.MultiProvider/Strategies/BaseEvaluationStrategy.cs

@@ -58,6 +58,20 @@ public virtual bool ShouldEvaluateNextProvider<T>(StrategyPerProviderContext<T>
     /// <returns>The final evaluation result.</returns>
     public abstract FinalResult<T> DetermineFinalResult<T>(StrategyEvaluationContext<T> strategyContext, string key, T defaultValue, EvaluationContext? evaluationContext, List<ProviderResolutionResult<T>> resolutions);
 
+    /// <summary>
+    /// Determines whether a specific provider should receive tracking events.
+    /// </summary>
+    /// <param name="strategyContext">Context information about the provider.</param>
+    /// <param name="evaluationContext">The evaluation context for the tracking event.</param>
+    /// <param name="trackingEventName">The name of the tracking event.</param>
+    /// <param name="trackingEventDetails">The tracking event details.</param>
+    /// <returns>True if the provider should receive tracking events, false otherwise.</returns>
+    public virtual bool ShouldTrackWithThisProvider(StrategyPerProviderContext<object> strategyContext, EvaluationContext? evaluationContext, string trackingEventName, TrackingEventDetails? trackingEventDetails)
+    {
+        // By default, track with providers that are ready
+        return strategyContext.ProviderStatus == ProviderStatus.Ready;
+    }
+
     /// <summary>
     /// Checks if a resolution result represents an error.
     /// </summary>