feat(api): add analytics and project report forwarding

src/main/java/co/lettermint/api/ApiClient.java

@@ -38,6 +38,10 @@ public BlockedFileTypesResponse blockedFileTypes() {
         return client.get("/blocked-file-types", BlockedFileTypesResponse.class);
     }
 
+    public AnalyticsResponse analytics(AnalyticsRequest payload) {
+        return client.post("/analytics", payload, AnalyticsResponse.class);
+    }
+
     public DomainsEndpoint domains() {
         return domains;
     }
@@ -171,6 +175,25 @@ public String text(String messageId) {
     }
 
     public static class ProjectsEndpoint {
+        public GetReportForwardingResponse retrieveReportForwarding(String projectId) {
+            return client.get("/projects/" + segment(projectId) + "/report-forwarding", GetReportForwardingResponse.class);
+        }
+
+        public UpdateReportForwardingResponse updateReportForwarding(String projectId, ReportForwardingRequest payload) {
+            return client.put("/projects/" + segment(projectId) + "/report-forwarding", payload, UpdateReportForwardingResponse.class);
+        }
+
+        public void deleteReportForwarding(String projectId) {
+            client.delete("/projects/" + segment(projectId) + "/report-forwarding", Void.class);
+        }
+
+        public VerifyReportForwardingResponse verifyReportForwarding(String projectId, VerifyReportForwardingRequest payload) {
+            return client.post("/projects/" + segment(projectId) + "/report-forwarding/verify", payload, VerifyReportForwardingResponse.class);
+        }
+
+        public ResendReportForwardingCodeResponse resendReportForwardingCode(String projectId) {
+            return client.post("/projects/" + segment(projectId) + "/report-forwarding/resend-code", null, ResendReportForwardingCodeResponse.class);
+        }
         private final LettermintClient client;
 
         ProjectsEndpoint(LettermintClient client) {

src/main/java/co/lettermint/client/LettermintClient.java

@@ -176,6 +176,9 @@ private <T> T request(String method, String requestUrl, Object payload, Class<T>
             }
 
             if (responseClass != null) {
+                if (response.code() == 204 && responseClass == Void.class) {
+                    return null;
+                }
                 return objectMapper.readValue(responseBody, responseClass);
             }
             return objectMapper.readValue(responseBody, responseType);

src/main/java/co/lettermint/models/api/AnalyticsRequest.java

@@ -0,0 +1,47 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsRequest {
+    @JsonProperty("metrics")
+    public List<String> metrics;
+
+    @JsonProperty("from")
+    public String fromValue;
+
+    @JsonProperty("to")
+    public String to;
+
+    @JsonProperty("timezone")
+    public String timezone;
+
+    @JsonProperty("include")
+    public List<String> include;
+
+    @JsonProperty("group_by")
+    public List<String> groupBy;
+
+    @JsonProperty("filters")
+    public List<AnalyticsRequestFiltersItem> filters;
+
+    @JsonProperty("interval")
+    public String interval;
+
+    @JsonProperty("compare")
+    public String compare;
+
+    @JsonProperty("include_trend")
+    public Boolean includeTrend;
+
+    @JsonProperty("sort")
+    public AnalyticsRequestSort sort;
+
+    @JsonProperty("limit")
+    public Integer limit;
+
+    @JsonProperty("cursor")
+    public String cursor;
+}

src/main/java/co/lettermint/models/api/AnalyticsRequestFiltersItem.java

@@ -0,0 +1,17 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsRequestFiltersItem {
+    @JsonProperty("dimension")
+    public String dimension;
+
+    @JsonProperty("operator")
+    public String operator;
+
+    @JsonProperty("values")
+    public List<String> values;
+}

src/main/java/co/lettermint/models/api/AnalyticsRequestSort.java

@@ -0,0 +1,13 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsRequestSort {
+    @JsonProperty("metric")
+    public String metric;
+
+    @JsonProperty("direction")
+    public String direction;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponse.java

@@ -0,0 +1,16 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponse {
+    @JsonProperty("data")
+    public AnalyticsResponsePayload data;
+
+    @JsonProperty("meta")
+    public AnalyticsResponseMeta meta;
+
+    @JsonProperty("pagination")
+    public AnalyticsResponsePagination pagination;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponseData.java

@@ -0,0 +1,18 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import java.util.Map;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponseData {
+    @JsonProperty("data")
+    public Map<String, Object> data;
+
+    @JsonProperty("meta")
+    public Map<String, Object> meta;
+
+    @JsonProperty("pagination")
+    public List<String> pagination;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponseMeta.java

@@ -0,0 +1,55 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponseMeta {
+    @JsonProperty("time_basis")
+    public String timeBasis;
+
+    @JsonProperty("timezone")
+    public String timezone;
+
+    @JsonProperty("interval")
+    public String interval;
+
+    @JsonProperty("from")
+    public String fromValue;
+
+    @JsonProperty("to")
+    public String to;
+
+    @JsonProperty("effective_to")
+    public String effectiveTo;
+
+    @JsonProperty("alignment")
+    public String alignment;
+
+    @JsonProperty("generated_at")
+    public String generatedAt;
+
+    @JsonProperty("available_since")
+    public String availableSince;
+
+    @JsonProperty("partial")
+    public Boolean partial;
+
+    @JsonProperty("ongoing")
+    public Boolean ongoing;
+
+    @JsonProperty("collection_completeness")
+    public String collectionCompleteness;
+
+    @JsonProperty("last_ingested_at")
+    public String lastIngestedAt;
+
+    @JsonProperty("metric_definition_version")
+    public String metricDefinitionVersion;
+
+    @JsonProperty("ranked_group_limit")
+    public Integer rankedGroupLimit;
+
+    @JsonProperty("comparison")
+    public AnalyticsResponseMetaComparison comparison;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponseMetaComparison.java

@@ -0,0 +1,16 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponseMetaComparison {
+    @JsonProperty("from")
+    public String fromValue;
+
+    @JsonProperty("to")
+    public String to;
+
+    @JsonProperty("partial")
+    public Boolean partial;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponsePagination.java

@@ -0,0 +1,19 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponsePagination {
+    @JsonProperty("total_groups")
+    public Integer totalGroups;
+
+    @JsonProperty("returned_groups")
+    public Integer returnedGroups;
+
+    @JsonProperty("next_cursor")
+    public String nextCursor;
+
+    @JsonProperty("truncated")
+    public Boolean truncated;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponsePayload.java

@@ -0,0 +1,17 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponsePayload {
+    @JsonProperty("summary")
+    public AnalyticsResponsePayloadSummary summary;
+
+    @JsonProperty("time_series")
+    public List<AnalyticsResponsePayloadTimeSeriesItem> timeSeries;
+
+    @JsonProperty("breakdown")
+    public List<AnalyticsResponsePayloadBreakdownItem> breakdown;
+}

src/main/java/co/lettermint/models/api/AnalyticsResponsePayloadBreakdownItem.java

@@ -0,0 +1,27 @@
+package co.lettermint.models.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+import java.util.Map;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class AnalyticsResponsePayloadBreakdownItem {
+    @JsonProperty("metrics")
+    public AnalyticsResponsePayloadBreakdownItemMetrics metrics;
+
+    @JsonProperty("rate_bases")
+    public AnalyticsResponsePayloadBreakdownItemRateBases rateBases;
+
+    @JsonProperty("previous")
+    public AnalyticsResponsePayloadBreakdownItemPrevious previous;
+
+    @JsonProperty("change")
+    public Map<String, Map<String, Object>> change;
+
+    @JsonProperty("dimensions")
+    public Map<String, String> dimensions;
+
+    @JsonProperty("trend")
+    public List<AnalyticsResponsePayloadBreakdownItemTrendItem> trend;
+}