feat: Detailed flag evaluation

openfeature/BUILD

@@ -64,6 +64,7 @@ cc_library(
         ":client",
         ":evaluation_context",
         ":features",
+        ":flag_evaluation_details",
         ":flag_metadata",
         ":general_hook",
         ":global_context_manager",
@@ -121,6 +122,7 @@ cc_library(
     deps = [
         ":evaluation_context",
         ":evaluation_options",
+        ":flag_evaluation_details",
         ":value",
     ],
 )

openfeature/client_api.cpp

@@ -53,6 +53,35 @@ bool ClientAPI::GetBooleanValue(std::string_view flag_key, bool default_value,
   return EvaluateBooleanFlag(flag_key, default_value, ctx, options)->GetValue();
 }
 
+BoolFlagEvaluationDetails ClientAPI::GetBooleanDetails(
+    std::string_view flag_key, bool default_value) {
+  auto res =
+      EvaluateBooleanFlag(flag_key, default_value, std::nullopt, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+BoolFlagEvaluationDetails ClientAPI::GetBooleanDetails(
+    std::string_view flag_key, bool default_value,
+    const EvaluationContext& ctx) {
+  auto res = EvaluateBooleanFlag(flag_key, default_value, ctx, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+BoolFlagEvaluationDetails ClientAPI::GetBooleanDetails(
+    std::string_view flag_key, bool default_value,
+    const EvaluationOptions& options) {
+  auto res =
+      EvaluateBooleanFlag(flag_key, default_value, std::nullopt, options);
+  return {std::string(flag_key), *res};
+}
+
+BoolFlagEvaluationDetails ClientAPI::GetBooleanDetails(
+    std::string_view flag_key, bool default_value, const EvaluationContext& ctx,
+    const EvaluationOptions& options) {
+  auto res = EvaluateBooleanFlag(flag_key, default_value, ctx, options);
+  return {std::string(flag_key), *res};
+}
+
 std::string ClientAPI::GetStringValue(std::string_view flag_key,
                                       std::string_view default_value) {
   return EvaluateStringFlag(flag_key, default_value, std::nullopt, std::nullopt)
@@ -80,6 +109,34 @@ std::string ClientAPI::GetStringValue(std::string_view flag_key,
   return EvaluateStringFlag(flag_key, default_value, ctx, options)->GetValue();
 }
 
+StringFlagEvaluationDetails ClientAPI::GetStringDetails(
+    std::string_view flag_key, std::string_view default_value) {
+  auto res =
+      EvaluateStringFlag(flag_key, default_value, std::nullopt, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+StringFlagEvaluationDetails ClientAPI::GetStringDetails(
+    std::string_view flag_key, std::string_view default_value,
+    const EvaluationContext& ctx) {
+  auto res = EvaluateStringFlag(flag_key, default_value, ctx, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+StringFlagEvaluationDetails ClientAPI::GetStringDetails(
+    std::string_view flag_key, std::string_view default_value,
+    const EvaluationOptions& options) {
+  auto res = EvaluateStringFlag(flag_key, default_value, std::nullopt, options);
+  return {std::string(flag_key), *res};
+}
+
+StringFlagEvaluationDetails ClientAPI::GetStringDetails(
+    std::string_view flag_key, std::string_view default_value,
+    const EvaluationContext& ctx, const EvaluationOptions& options) {
+  auto res = EvaluateStringFlag(flag_key, default_value, ctx, options);
+  return {std::string(flag_key), *res};
+}
+
 int64_t ClientAPI::GetIntegerValue(std::string_view flag_key,
                                    int64_t default_value) {
   return EvaluateIntegerFlag(flag_key, default_value, std::nullopt,
@@ -108,6 +165,35 @@ int64_t ClientAPI::GetIntegerValue(std::string_view flag_key,
   return EvaluateIntegerFlag(flag_key, default_value, ctx, options)->GetValue();
 }
 
+IntFlagEvaluationDetails ClientAPI::GetIntegerDetails(std::string_view flag_key,
+                                                      int64_t default_value) {
+  auto res =
+      EvaluateIntegerFlag(flag_key, default_value, std::nullopt, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+IntFlagEvaluationDetails ClientAPI::GetIntegerDetails(
+    std::string_view flag_key, int64_t default_value,
+    const EvaluationContext& ctx) {
+  auto res = EvaluateIntegerFlag(flag_key, default_value, ctx, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+IntFlagEvaluationDetails ClientAPI::GetIntegerDetails(
+    std::string_view flag_key, int64_t default_value,
+    const EvaluationOptions& options) {
+  auto res =
+      EvaluateIntegerFlag(flag_key, default_value, std::nullopt, options);
+  return {std::string(flag_key), *res};
+}
+
+IntFlagEvaluationDetails ClientAPI::GetIntegerDetails(
+    std::string_view flag_key, int64_t default_value,
+    const EvaluationContext& ctx, const EvaluationOptions& options) {
+  auto res = EvaluateIntegerFlag(flag_key, default_value, ctx, options);
+  return {std::string(flag_key), *res};
+}
+
 double ClientAPI::GetDoubleValue(std::string_view flag_key,
                                  double default_value) {
   return EvaluateDoubleFlag(flag_key, default_value, std::nullopt, std::nullopt)
@@ -135,6 +221,34 @@ double ClientAPI::GetDoubleValue(std::string_view flag_key,
   return EvaluateDoubleFlag(flag_key, default_value, ctx, options)->GetValue();
 }
 
+DoubleFlagEvaluationDetails ClientAPI::GetDoubleDetails(
+    std::string_view flag_key, double default_value) {
+  auto res =
+      EvaluateDoubleFlag(flag_key, default_value, std::nullopt, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+DoubleFlagEvaluationDetails ClientAPI::GetDoubleDetails(
+    std::string_view flag_key, double default_value,
+    const EvaluationContext& ctx) {
+  auto res = EvaluateDoubleFlag(flag_key, default_value, ctx, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+DoubleFlagEvaluationDetails ClientAPI::GetDoubleDetails(
+    std::string_view flag_key, double default_value,
+    const EvaluationOptions& options) {
+  auto res = EvaluateDoubleFlag(flag_key, default_value, std::nullopt, options);
+  return {std::string(flag_key), *res};
+}
+
+DoubleFlagEvaluationDetails ClientAPI::GetDoubleDetails(
+    std::string_view flag_key, double default_value,
+    const EvaluationContext& ctx, const EvaluationOptions& options) {
+  auto res = EvaluateDoubleFlag(flag_key, default_value, ctx, options);
+  return {std::string(flag_key), *res};
+}
+
 Value ClientAPI::GetObjectValue(std::string_view flag_key,
                                 Value default_value) {
   return EvaluateObjectFlag(flag_key, default_value, std::nullopt, std::nullopt)
@@ -159,6 +273,34 @@ Value ClientAPI::GetObjectValue(std::string_view flag_key, Value default_value,
   return EvaluateObjectFlag(flag_key, default_value, ctx, options)->GetValue();
 }
 
+ObjectFlagEvaluationDetails ClientAPI::GetObjectDetails(
+    std::string_view flag_key, Value default_value) {
+  auto res =
+      EvaluateObjectFlag(flag_key, default_value, std::nullopt, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+ObjectFlagEvaluationDetails ClientAPI::GetObjectDetails(
+    std::string_view flag_key, Value default_value,
+    const EvaluationContext& ctx) {
+  auto res = EvaluateObjectFlag(flag_key, default_value, ctx, std::nullopt);
+  return {std::string(flag_key), *res};
+}
+
+ObjectFlagEvaluationDetails ClientAPI::GetObjectDetails(
+    std::string_view flag_key, Value default_value,
+    const EvaluationOptions& options) {
+  auto res = EvaluateObjectFlag(flag_key, default_value, std::nullopt, options);
+  return {std::string(flag_key), *res};
+}
+
+ObjectFlagEvaluationDetails ClientAPI::GetObjectDetails(
+    std::string_view flag_key, Value default_value,
+    const EvaluationContext& ctx, const EvaluationOptions& options) {
+  auto res = EvaluateObjectFlag(flag_key, default_value, ctx, options);
+  return {std::string(flag_key), *res};
+}
+
 std::unique_ptr<BoolResolutionDetails> ClientAPI::EvaluateBooleanFlag(
     std::string_view flag_key, bool default_value,
     const std::optional<EvaluationContext>& ctx,

openfeature/client_api.h

@@ -11,6 +11,7 @@
 #include "openfeature/client.h"
 #include "openfeature/evaluation_context.h"
 #include "openfeature/features.h"
+#include "openfeature/flag_evaluation_details.h"
 #include "openfeature/general_hook.h"
 #include "openfeature/global_context_manager.h"
 #include "openfeature/metadata.h"
@@ -53,6 +54,19 @@ class ClientAPI : public Client {
                        const EvaluationContext& ctx,
                        const EvaluationOptions& options) override;
 
+  // Detailed boolean flag evaluation.
+  BoolFlagEvaluationDetails GetBooleanDetails(std::string_view flag_key,
+                                              bool default_value) override;
+  BoolFlagEvaluationDetails GetBooleanDetails(
+      std::string_view flag_key, bool default_value,
+      const EvaluationContext& ctx) override;
+  BoolFlagEvaluationDetails GetBooleanDetails(
+      std::string_view flag_key, bool default_value,
+      const EvaluationOptions& options) override;
+  BoolFlagEvaluationDetails GetBooleanDetails(
+      std::string_view flag_key, bool default_value,
+      const EvaluationContext& ctx, const EvaluationOptions& options) override;
+
   // Evaluate a string flag.
   std::string GetStringValue(std::string_view flag_key,
                              std::string_view default_value) override;
@@ -67,6 +81,19 @@ class ClientAPI : public Client {
                              const EvaluationContext& ctx,
                              const EvaluationOptions& options) override;
 
+  // Detailed string flag evaluation.
+  StringFlagEvaluationDetails GetStringDetails(
+      std::string_view flag_key, std::string_view default_value) override;
+  StringFlagEvaluationDetails GetStringDetails(
+      std::string_view flag_key, std::string_view default_value,
+      const EvaluationContext& ctx) override;
+  StringFlagEvaluationDetails GetStringDetails(
+      std::string_view flag_key, std::string_view default_value,
+      const EvaluationOptions& options) override;
+  StringFlagEvaluationDetails GetStringDetails(
+      std::string_view flag_key, std::string_view default_value,
+      const EvaluationContext& ctx, const EvaluationOptions& options) override;
+
   // Evaluate an integer flag.
   int64_t GetIntegerValue(std::string_view flag_key,
                           int64_t default_value) override;
@@ -78,6 +105,19 @@ class ClientAPI : public Client {
                           const EvaluationContext& ctx,
                           const EvaluationOptions& options) override;
 
+  // Detailed integer flag evaluation.
+  IntFlagEvaluationDetails GetIntegerDetails(std::string_view flag_key,
+                                             int64_t default_value) override;
+  IntFlagEvaluationDetails GetIntegerDetails(
+      std::string_view flag_key, int64_t default_value,
+      const EvaluationContext& ctx) override;
+  IntFlagEvaluationDetails GetIntegerDetails(
+      std::string_view flag_key, int64_t default_value,
+      const EvaluationOptions& options) override;
+  IntFlagEvaluationDetails GetIntegerDetails(
+      std::string_view flag_key, int64_t default_value,
+      const EvaluationContext& ctx, const EvaluationOptions& options) override;
+
   // Evaluate a double flag.
   double GetDoubleValue(std::string_view flag_key,
                         double default_value) override;
@@ -89,6 +129,19 @@ class ClientAPI : public Client {
                         const EvaluationContext& ctx,
                         const EvaluationOptions& options) override;
 
+  // Detailed double flag evaluation.
+  DoubleFlagEvaluationDetails GetDoubleDetails(std::string_view flag_key,
+                                               double default_value) override;
+  DoubleFlagEvaluationDetails GetDoubleDetails(
+      std::string_view flag_key, double default_value,
+      const EvaluationContext& ctx) override;
+  DoubleFlagEvaluationDetails GetDoubleDetails(
+      std::string_view flag_key, double default_value,
+      const EvaluationOptions& options) override;
+  DoubleFlagEvaluationDetails GetDoubleDetails(
+      std::string_view flag_key, double default_value,
+      const EvaluationContext& ctx, const EvaluationOptions& options) override;
+
   // Evaluate an object flag.
   Value GetObjectValue(std::string_view flag_key, Value default_value) override;
   Value GetObjectValue(std::string_view flag_key, Value default_value,
@@ -99,6 +152,19 @@ class ClientAPI : public Client {
                        const EvaluationContext& ctx,
                        const EvaluationOptions& options) override;
 
+  // Detailed object flag evaluation.
+  ObjectFlagEvaluationDetails GetObjectDetails(std::string_view flag_key,
+                                               Value default_value) override;
+  ObjectFlagEvaluationDetails GetObjectDetails(
+      std::string_view flag_key, Value default_value,
+      const EvaluationContext& ctx) override;
+  ObjectFlagEvaluationDetails GetObjectDetails(
+      std::string_view flag_key, Value default_value,
+      const EvaluationOptions& options) override;
+  ObjectFlagEvaluationDetails GetObjectDetails(
+      std::string_view flag_key, Value default_value,
+      const EvaluationContext& ctx, const EvaluationOptions& options) override;
+
   // Adds one or more hooks to the client-level hook repository.
   void AddHooks(std::vector<std::shared_ptr<GeneralHook>> hooks) override;
 
@@ -108,8 +174,6 @@ class ClientAPI : public Client {
   // Retrieves all configured client-level hooks.
   std::vector<std::shared_ptr<GeneralHook>> GetHooks() const override;
 
-  // TODO: Add methods for detailed flag evaluation.
-
  private:
   template <typename ResolutionDetailsType, typename ValueType,
             typename ProviderCallable>