systemprompt-analytics 0.2.1

Analytics for systemprompt.io AI governance infrastructure. Session, agent, tool, and microdollar-precision cost attribution across the MCP governance pipeline.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use serde::{Deserialize, Serialize};
use systemprompt_identifiers::ContentId;

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum AnalyticsEventType {
    PageView,
    PageExit,
    LinkClick,
    Scroll,
    Engagement,
    Conversion,
    #[serde(untagged)]
    Custom(String),
}

impl AnalyticsEventType {
    pub fn as_str(&self) -> &str {
        match self {
            Self::PageView => "page_view",
            Self::PageExit => "page_exit",
            Self::LinkClick => "link_click",
            Self::Scroll => "scroll",
            Self::Engagement => "engagement",
            Self::Conversion => "conversion",
            Self::Custom(s) => s.as_str(),
        }
    }

    pub const fn category(&self) -> &str {
        match self {
            Self::PageView | Self::PageExit => "navigation",
            Self::LinkClick => "interaction",
            Self::Scroll | Self::Engagement => "engagement",
            Self::Conversion => "conversion",
            Self::Custom(_) => "custom",
        }
    }
}

impl std::fmt::Display for AnalyticsEventType {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.as_str())
    }
}

#[derive(Debug, Clone, Deserialize)]
pub struct CreateAnalyticsEventInput {
    pub event_type: AnalyticsEventType,
    pub page_url: String,
    #[serde(default)]
    pub content_id: Option<ContentId>,
    #[serde(default)]
    pub slug: Option<String>,
    #[serde(default)]
    pub referrer: Option<String>,
    #[serde(default)]
    pub data: Option<serde_json::Value>,
}

#[derive(Debug, Clone, Deserialize)]
pub struct CreateAnalyticsEventBatchInput {
    pub events: Vec<CreateAnalyticsEventInput>,
}

#[derive(Debug, Clone, Serialize)]
pub struct AnalyticsEventCreated {
    // SQLx: analytics event primary key (text column, no typed ID defined)
    pub id: String,
    pub event_type: String,
}

#[derive(Debug, Clone, Serialize)]
pub struct AnalyticsEventBatchResponse {
    pub recorded: usize,
    pub events: Vec<AnalyticsEventCreated>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct EngagementEventData {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_scroll_depth: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub time_on_page_ms: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub time_to_first_interaction_ms: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub time_to_first_scroll_ms: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub click_count: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub scroll_velocity_avg: Option<f32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub scroll_direction_changes: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub mouse_move_distance_px: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub keyboard_events: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub copy_events: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub focus_time_ms: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub blur_count: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tab_switches: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub visible_time_ms: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub hidden_time_ms: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub is_rage_click: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub is_dead_click: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub reading_pattern: Option<String>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct LinkClickEventData {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub target_url: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub link_text: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub link_position: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub is_external: Option<bool>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ScrollEventData {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub depth: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub milestone: Option<i32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub direction: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub velocity: Option<f32>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ConversionEventData {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub goal_name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub goal_value: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub funnel_step: Option<i32>,
}