feat: add dashboard analytics to sdk and public api (#353)

apps/docs/api-reference/analytics/email-time-series.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /v1/analytics/email-time-series
+---

apps/docs/api-reference/analytics/reputation-metrics.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /v1/analytics/reputation-metrics
+---

apps/docs/api-reference/openapi.json

@@ -2430,6 +2430,127 @@
 					}
 				}
 			}
+		},
+		"/v1/analytics/email-time-series": {
+			"get": {
+				"parameters": [
+					{
+						"schema": {
+							"type": "string",
+							"enum": ["7", "30"],
+							"example": "30"
+						},
+						"required": false,
+						"name": "days",
+						"in": "query",
+						"description": "Number of days to retrieve data for (default: 30)"
+					},
+					{
+						"schema": { "type": "string" },
+						"required": false,
+						"name": "domainId",
+						"in": "query",
+						"description": "Filter by domain ID"
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Retrieve email time series data",
+						"content": {
+							"application/json": {
+								"schema": {
+									"type": "object",
+									"properties": {
+										"result": {
+											"type": "array",
+											"items": {
+												"type": "object",
+												"properties": {
+													"date": { "type": "string" },
+													"sent": { "type": "integer" },
+													"delivered": { "type": "integer" },
+													"opened": { "type": "integer" },
+													"clicked": { "type": "integer" },
+													"bounced": { "type": "integer" },
+													"complained": { "type": "integer" }
+												},
+												"required": [
+													"date",
+													"sent",
+													"delivered",
+													"opened",
+													"clicked",
+													"bounced",
+													"complained"
+												]
+											}
+										},
+										"totalCounts": {
+											"type": "object",
+											"properties": {
+												"sent": { "type": "integer" },
+												"delivered": { "type": "integer" },
+												"opened": { "type": "integer" },
+												"clicked": { "type": "integer" },
+												"bounced": { "type": "integer" },
+												"complained": { "type": "integer" }
+											},
+											"required": [
+												"sent",
+												"delivered",
+												"opened",
+												"clicked",
+												"bounced",
+												"complained"
+											]
+										}
+									},
+									"required": ["result", "totalCounts"]
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/v1/analytics/reputation-metrics": {
+			"get": {
+				"parameters": [
+					{
+						"schema": { "type": "string" },
+						"required": false,
+						"name": "domainId",
+						"in": "query",
+						"description": "Filter by domain ID"
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Retrieve reputation metrics data",
+						"content": {
+							"application/json": {
+								"schema": {
+									"type": "object",
+									"properties": {
+										"delivered": { "type": "integer" },
+										"hardBounced": { "type": "integer" },
+										"complained": { "type": "integer" },
+										"bounceRate": { "type": "number" },
+										"complaintRate": { "type": "number" }
+									},
+									"required": [
+										"delivered",
+										"hardBounced",
+										"complained",
+										"bounceRate",
+										"complaintRate"
+									]
+								}
+							}
+						}
+					}
+				}
+			}
 		}
 	}
 }

apps/docs/docs.json

@@ -105,6 +105,13 @@
               "api-reference/campaigns/resume-campaign",
               "api-reference/campaigns/delete-campaign"
             ]
+          },
+          {
+            "group": "Analytics",
+            "pages": [
+              "api-reference/analytics/email-time-series",
+              "api-reference/analytics/reputation-metrics"
+            ]
           }
         ]
       },