hyperinfer-core 0.1.1

Core types and traits for HyperInfer LLM Gateway
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

use async_trait::async_trait;
use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

use crate::error::DbError;
use crate::types::{
    CreateDeploymentRequest, Deployment, RoutingConfig, UpdateRoutingConfigRequest,
};

#[async_trait]
pub trait Database: Clone + Send + Sync + 'static {
    async fn get_team(&self, id: &str) -> Result<Option<Team>, DbError>;
    async fn create_team(&self, name: &str, budget_cents: i64) -> Result<Team, DbError>;
    async fn get_user(&self, id: &str) -> Result<Option<User>, DbError>;
    async fn get_user_by_email(&self, email: &str) -> Result<Option<User>, DbError>;
    async fn create_user(
        &self,
        team_id: &str,
        email: &str,
        role: &str,
        password_hash: Option<String>,
    ) -> Result<User, DbError>;
    async fn update_password_hash(&self, user_id: &str, password_hash: &str)
        -> Result<(), DbError>;
    async fn count_users_by_role(&self, role: &str) -> Result<i64, DbError>;
    async fn get_api_key(&self, id: &str) -> Result<Option<ApiKey>, DbError>;
    async fn get_api_key_by_hash(&self, key_hash: &str) -> Result<Option<ApiKey>, DbError>;
    async fn create_api_key(
        &self,
        key_hash: &str,
        user_id: &str,
        team_id: &str,
        name: Option<String>,
    ) -> Result<ApiKey, DbError>;
    async fn deactivate_api_key(&self, id: &str) -> Result<ApiKey, DbError>;
    async fn get_model_alias(&self, id: &str) -> Result<Option<ModelAlias>, DbError>;
    async fn create_model_alias(
        &self,
        team_id: &str,
        alias: &str,
        target_model: &str,
        provider: &str,
    ) -> Result<ModelAlias, DbError>;
    async fn get_quota(&self, team_id: &str) -> Result<Option<Quota>, DbError>;
    async fn create_quota(
        &self,
        team_id: &str,
        rpm_limit: i32,
        tpm_limit: i32,
    ) -> Result<Quota, DbError>;
    async fn record_usage(
        &self,
        team_id: &str,
        api_key_id: &str,
        model: &str,
        input_tokens: i32,
        output_tokens: i32,
        response_time_ms: i64,
    ) -> Result<UsageLog, DbError>;

    // --- Deployment CRUD ---
    async fn list_deployments(
        &self,
        model: &str,
        is_active: Option<bool>,
    ) -> Result<Vec<Deployment>, DbError>;
    async fn get_deployment(&self, id: &str) -> Result<Option<Deployment>, DbError>;
    async fn create_deployment(&self, req: CreateDeploymentRequest) -> Result<Deployment, DbError>;
    async fn update_deployment(
        &self,
        id: &str,
        req: CreateDeploymentRequest,
    ) -> Result<Deployment, DbError>;
    async fn delete_deployment(&self, id: &str) -> Result<(), DbError>;

    // --- Routing Config ---
    async fn get_routing_config(&self) -> Result<Option<RoutingConfig>, DbError>;
    async fn update_routing_config(
        &self,
        req: UpdateRoutingConfigRequest,
    ) -> Result<RoutingConfig, DbError>;

    async fn ping(&self) -> Result<(), DbError>;
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Team {
    pub id: String,
    pub name: String,
    pub budget_cents: i64,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: String,
    pub team_id: String,
    pub email: String,
    pub role: String,
    #[serde(skip_serializing)]
    pub password_hash: Option<String>,
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ApiKey {
    pub id: String,
    pub key_hash: String,
    pub user_id: String,
    pub team_id: String,
    pub name: Option<String>,
    pub is_active: bool,
    pub created_at: DateTime<Utc>,
    pub expires_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ModelAlias {
    pub id: String,
    pub team_id: String,
    pub alias: String,
    pub target_model: String,
    pub provider: String,
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Quota {
    pub id: String,
    pub team_id: String,
    pub rpm_limit: i32,
    pub tpm_limit: i32,
    pub updated_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UsageLog {
    pub id: String,
    pub team_id: String,
    pub api_key_id: String,
    pub model: String,
    pub input_tokens: i32,
    pub output_tokens: i32,
    pub response_time_ms: i64,
    pub recorded_at: DateTime<Utc>,
}