statsig_rust/event_logging_adapter/
event_logging_adapter_trait.rs

1use std::sync::Arc;
2
3use crate::log_event_payload::LogEventRequest;
4use crate::{StatsigErr, StatsigRuntime};
5use async_trait::async_trait;
6
7#[async_trait]
8pub trait EventLoggingAdapter: Send + Sync {
9    async fn start(&self, statsig_runtime: &Arc<StatsigRuntime>) -> Result<(), StatsigErr>;
10    async fn log_events(&self, request: LogEventRequest) -> Result<bool, StatsigErr>;
11    async fn shutdown(&self) -> Result<(), StatsigErr>;
12    fn should_schedule_background_flush(&self) -> bool;
13}
14
15#[cfg(test)]
16mod tests {
17    use serde_json::{json, Value};
18
19    use crate::event_logging::statsig_event::StatsigEvent;
20    use crate::event_logging::statsig_event_internal::StatsigEventInternal;
21    use crate::log_event_payload::{LogEventPayload, LogEventRequest};
22    use crate::statsig_metadata::StatsigMetadata;
23    use crate::user::StatsigUserInternal;
24    use crate::StatsigUser;
25
26    #[test]
27    fn test_request_jsonify() {
28        let user = StatsigUser::with_user_id("a-user".to_string());
29        let user_internal = StatsigUserInternal::new(&user, None);
30        let event = StatsigEvent {
31            event_name: "my_custom_event".to_string(),
32            value: None,
33            metadata: None,
34            statsig_metadata: None,
35        };
36
37        let event = StatsigEventInternal::new(123, user_internal.to_loggable(), event, None);
38
39        let payload = LogEventPayload {
40            events: json!([event]),
41            statsig_metadata: StatsigMetadata::get_as_json(),
42        };
43
44        let request = LogEventRequest {
45            payload,
46            event_count: 1,
47            retries: 0,
48        };
49
50        let serialized = serde_json::to_string(&request).unwrap();
51        let deserialized: Value = serde_json::from_str(&serialized).unwrap();
52
53        let event_count = deserialized.get("eventCount").unwrap().as_u64().unwrap();
54        assert_eq!(event_count, 1);
55
56        let payload_json = deserialized.get("payload").unwrap();
57
58        let statsig_metadata_json = payload_json
59            .get("statsigMetadata")
60            .unwrap()
61            .as_object()
62            .unwrap();
63
64        assert!(statsig_metadata_json.contains_key("sdkType"));
65        assert!(statsig_metadata_json.contains_key("sdkVersion"));
66        assert!(statsig_metadata_json.contains_key("sessionID"));
67
68        let events_json = payload_json.get("events").unwrap();
69        assert_eq!(events_json.as_array().unwrap().len(), 1);
70    }
71
72    #[test]
73    fn test_json_deserialization() {
74        let request_json = r#"{"payload":{"events":[{"eventName":"my_custom_event","metadata":null,"secondaryExposures":null,"time":1730831508904,"user":{"statsigEnvironment":null,"userID":"a-user"},"value":null}],"statsigMetadata":{"sdkType":"statsig-server-core","sdkVersion":"0.0.1","sessionId":"1ff863ed-a9ab-4785-bb0e-1a7b0140c040"}},"eventCount":1,"retries":0}"#;
75        let request: LogEventRequest = serde_json::from_str(request_json).unwrap();
76        assert_eq!(request.event_count, 1);
77    }
78}