feat: add analytics metric granularity query

server-rs/crates/shared-contracts/src/runtime.rs

@@ -25,6 +25,11 @@ pub const TRACKING_SCOPE_KIND_SITE: &str = "site";
 pub const TRACKING_SCOPE_KIND_WORK: &str = "work";
 pub const TRACKING_SCOPE_KIND_MODULE: &str = "module";
 pub const TRACKING_SCOPE_KIND_USER: &str = "user";
+pub const ANALYTICS_GRANULARITY_DAY: &str = "day";
+pub const ANALYTICS_GRANULARITY_WEEK: &str = "week";
+pub const ANALYTICS_GRANULARITY_MONTH: &str = "month";
+pub const ANALYTICS_GRANULARITY_QUARTER: &str = "quarter";
+pub const ANALYTICS_GRANULARITY_YEAR: &str = "year";
 pub const BROWSE_HISTORY_THEME_MODE_MARTIAL: &str = "martial";
 pub const BROWSE_HISTORY_THEME_MODE_ARCANE: &str = "arcane";
 pub const BROWSE_HISTORY_THEME_MODE_MACHINA: &str = "machina";
@@ -367,6 +372,30 @@ pub struct ProfileTaskConfigAdminListResponse {
     pub entries: Vec<ProfileTaskConfigAdminResponse>,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct AnalyticsMetricQueryRequest {
+    pub event_key: String,
+    pub scope_kind: String,
+    pub scope_id: String,
+    pub granularity: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct AnalyticsBucketMetricResponse {
+    pub bucket_key: String,
+    pub bucket_start_date_key: i64,
+    pub bucket_end_date_key: i64,
+    pub value: u64,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct AnalyticsMetricQueryResponse {
+    pub buckets: Vec<AnalyticsBucketMetricResponse>,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct AdminUpsertProfileTaskConfigRequest {