statsig_rust/event_logging_adapter/
event_logging_adapter_trait.rs1use 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}