[analytics] initial sendReport API (#8608)

A jumping off point for a `sendReport` implementation.

Next step is to add params and do some experimenting w/ DTD.

You'll note that this handles error conditions a little differently than
the other DTD interactions and I'm open to feedback. (In those cases we
return futures that will blow up if interrogated. I'm not sure we want
to do that here (or even if we'll ever ask?)) Dunno.

---

- [x] I’ve reviewed the contributor guide and applied the relevant
portions to this PR.

<details>
  <summary>Contribution guidelines:</summary><br>

- See our [contributor
guide]([https://github.com/dart-lang/sdk/blob/main/CONTRIBUTING.md](https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview)
for general expectations for PRs.
- Larger or significant changes should be discussed in an issue before
creating a PR.
- Dart contributions to our repos should follow the [Dart style
guide](https://dart.dev/guides/language/effective-dart) and use `dart
format`.
- Java and Kotlin contributions should strive to follow Java and Kotlin
best practices
([discussion](#8098)).
</details>

Author: pq

src/io/flutter/analytics/UnifiedAnalytics.java

@@ -32,10 +32,9 @@ public class UnifiedAnalytics {
   private static final @NotNull Logger LOG = PluginLogger.createLogger(UnifiedAnalytics.class);
 
   @Nullable Boolean enabled = null;
-  final Project project;
-  final DtdUtils dtdUtils;
-  @NotNull final FlutterSdkUtil flutterSdkUtil;
-
+  final @NotNull Project project;
+  final @NotNull DtdUtils dtdUtils;
+  final @NotNull FlutterSdkUtil flutterSdkUtil;
 
   public UnifiedAnalytics(@NotNull Project project) {
     this.project = project;
@@ -71,6 +70,48 @@ public void manageConsent() {
     }
   }
 
+  /**
+   * Sends analytics data to the unified analytics service.
+   *
+   * @param analyticsData The data object containing the details of the event to report.
+   * @return A {@link CompletableFuture} that completes with a {@link SendResult}.
+   * The {@code SendResult} will indicate whether the report was successfully
+   * sent and may contain a message with additional details on failure.
+   * If the analytics service is unavailable or an error occurs, the future
+   * will complete with a result where {@code success} is false.
+   */
+  public @NotNull CompletableFuture<SendResult> sendReport(AnalyticsData analyticsData) {
+    try {
+      DartToolingDaemonService service = dtdUtils.readyDtdService(project).get();
+      if (service == null) {
+        return SendResult.failed("DTD service is null");
+      }
+
+      JsonObject params = new JsonObject();
+      params.addProperty("tool", getToolName());
+
+      // TODO (pq): convert analyticsData to params.
+
+      // TODO (pq): hoist request constants into static fields
+      return makeUnifiedAnalyticsRequest("ideEvent", service, params).thenCompose(result -> {
+        if (result == null) {
+          return SendResult.failed("ideEvent result is null");
+        }
+
+        JsonPrimitive type = result.getAsJsonPrimitive("type");
+        if (type == null) {
+          return SendResult.failed("ideEvent result type is null");
+        }
+
+        return SendResult.succeeded("Success".equals(type.getAsString()));
+      });
+    }
+    catch (Exception e) {
+      LOG.info(e);
+      return SendResult.failed(e.getMessage());
+    }
+  }
+
   private @NotNull CompletableFuture<JsonObject> makeUnifiedAnalyticsRequest(String requestName,
                                                                              @NotNull DartToolingDaemonService service,
                                                                              @NotNull JsonObject params) {
@@ -168,15 +209,11 @@ public void actionPerformed(@NotNull AnActionEvent event) {
 
   private String getToolName() throws Exception {
     String ideValue = flutterSdkUtil.getFlutterHostEnvValue();
-    if ("IntelliJ-IDEA".equals(ideValue)) {
-      return "intellij-plugins";
-    }
-    else if ("Android-Studio".equals(ideValue)) {
-      return "android-studio-plugins";
-    }
-    else {
-      throw new Exception("Tool name cannot be found for IDE type: " + ideValue);
-    }
+    return switch (flutterSdkUtil.getFlutterHostEnvValue()) {
+      case "IntelliJ-IDEA" -> "intellij-plugins";
+      case "Android-Studio" -> "android-studio-plugins";
+      default -> throw new Exception("Tool name cannot be found for IDE type: " + ideValue);
+    };
   }
 
   private @NotNull CompletableFuture<Boolean> shouldShowMessage(@NotNull DartToolingDaemonService service, @NotNull JsonObject params) {
@@ -206,3 +243,38 @@ else if ("Android-Studio".equals(ideValue)) {
     });
   }
 }
+
+/**
+ * Represents the result of an analytics sending operation.
+ * <p>
+ * This class encapsulates whether the operation was successful and includes an
+ * optional message, typically used for logging errors.
+ */
+class SendResult {
+  /**
+   * True if the analytics report was sent successfully, false otherwise.
+   */
+  public final boolean success;
+
+  /**
+   * An optional message providing more details about the result, particularly on failure.
+   */
+  public final @Nullable String message;
+
+  SendResult(boolean success, @Nullable String message) {
+    this.success = success;
+    this.message = message;
+  }
+
+  CompletableFuture<SendResult> toCompletedFuture() {
+    return CompletableFuture.completedFuture(this);
+  }
+
+  static CompletableFuture<SendResult> failed(@Nullable String message) {
+    return new SendResult(false, message).toCompletedFuture();
+  }
+
+  static CompletableFuture<SendResult> succeeded(boolean success) {
+    return new SendResult(success, null).toCompletedFuture();
+  }
+}