feat(analytics): analytics APIs (#2676)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

crates/common_utils/src/custom_serde.rs

@@ -170,3 +170,51 @@ pub mod json_string {
         serde_json::from_str(&j).map_err(de::Error::custom)
     }
 }
+
+/// Use a custom ISO 8601 format when serializing and deserializing
+/// [`PrimitiveDateTime`][PrimitiveDateTime].
+///
+/// [PrimitiveDateTime]: ::time::PrimitiveDateTime
+pub mod iso8601custom {
+
+    use serde::{ser::Error as _, Deserializer, Serialize, Serializer};
+    use time::{
+        format_description::well_known::{
+            iso8601::{Config, EncodedConfig, TimePrecision},
+            Iso8601,
+        },
+        serde::iso8601,
+        PrimitiveDateTime, UtcOffset,
+    };
+
+    const FORMAT_CONFIG: EncodedConfig = Config::DEFAULT
+        .set_time_precision(TimePrecision::Second {
+            decimal_digits: None,
+        })
+        .encode();
+
+    /// Serialize a [`PrimitiveDateTime`] using the well-known ISO 8601 format.
+    pub fn serialize<S>(date_time: &PrimitiveDateTime, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        date_time
+            .assume_utc()
+            .format(&Iso8601::<FORMAT_CONFIG>)
+            .map_err(S::Error::custom)?
+            .replace('T', " ")
+            .replace('Z', "")
+            .serialize(serializer)
+    }
+
+    /// Deserialize an [`PrimitiveDateTime`] from its ISO 8601 representation.
+    pub fn deserialize<'a, D>(deserializer: D) -> Result<PrimitiveDateTime, D::Error>
+    where
+        D: Deserializer<'a>,
+    {
+        iso8601::deserialize(deserializer).map(|offset_date_time| {
+            let utc_date_time = offset_date_time.to_offset(UtcOffset::UTC);
+            PrimitiveDateTime::new(utc_date_time.date(), utc_date_time.time())
+        })
+    }
+}