feat(router): implement API endpoints for managing API keys (#511)

crates/storage_models/src/api_keys.rs

@@ -0,0 +1,133 @@
+use diesel::{AsChangeset, AsExpression, Identifiable, Insertable, Queryable};
+use masking::Secret;
+use time::PrimitiveDateTime;
+
+use crate::schema::api_keys;
+
+#[derive(Debug, Identifiable, Queryable)]
+#[diesel(table_name = api_keys, primary_key(key_id))]
+pub struct ApiKey {
+    pub key_id: String,
+    pub merchant_id: String,
+    pub name: String,
+    pub description: Option<String>,
+    pub hash_key: Secret<String>,
+    pub hashed_api_key: HashedApiKey,
+    pub prefix: String,
+    pub created_at: PrimitiveDateTime,
+    pub expires_at: Option<PrimitiveDateTime>,
+    pub last_used: Option<PrimitiveDateTime>,
+}
+
+#[derive(Debug, Insertable)]
+#[diesel(table_name = api_keys)]
+pub struct ApiKeyNew {
+    pub key_id: String,
+    pub merchant_id: String,
+    pub name: String,
+    pub description: Option<String>,
+    pub hash_key: Secret<String>,
+    pub hashed_api_key: HashedApiKey,
+    pub prefix: String,
+    pub created_at: PrimitiveDateTime,
+    pub expires_at: Option<PrimitiveDateTime>,
+    pub last_used: Option<PrimitiveDateTime>,
+}
+
+#[derive(Debug)]
+pub enum ApiKeyUpdate {
+    Update {
+        name: Option<String>,
+        description: Option<String>,
+        expires_at: Option<Option<PrimitiveDateTime>>,
+        last_used: Option<PrimitiveDateTime>,
+    },
+    LastUsedUpdate {
+        last_used: PrimitiveDateTime,
+    },
+}
+
+#[derive(Debug, AsChangeset)]
+#[diesel(table_name = api_keys)]
+pub(crate) struct ApiKeyUpdateInternal {
+    pub name: Option<String>,
+    pub description: Option<String>,
+    pub expires_at: Option<Option<PrimitiveDateTime>>,
+    pub last_used: Option<PrimitiveDateTime>,
+}
+
+impl From<ApiKeyUpdate> for ApiKeyUpdateInternal {
+    fn from(api_key_update: ApiKeyUpdate) -> Self {
+        match api_key_update {
+            ApiKeyUpdate::Update {
+                name,
+                description,
+                expires_at,
+                last_used,
+            } => Self {
+                name,
+                description,
+                expires_at,
+                last_used,
+            },
+            ApiKeyUpdate::LastUsedUpdate { last_used } => Self {
+                last_used: Some(last_used),
+                name: None,
+                description: None,
+                expires_at: None,
+            },
+        }
+    }
+}
+
+#[derive(Debug, AsExpression)]
+#[diesel(sql_type = diesel::sql_types::Text)]
+pub struct HashedApiKey(String);
+
+impl From<String> for HashedApiKey {
+    fn from(hashed_api_key: String) -> Self {
+        Self(hashed_api_key)
+    }
+}
+
+mod diesel_impl {
+    use diesel::{
+        backend::Backend,
+        deserialize::FromSql,
+        serialize::{Output, ToSql},
+        sql_types::Text,
+        Queryable,
+    };
+
+    impl<DB> ToSql<Text, DB> for super::HashedApiKey
+    where
+        DB: Backend,
+        String: ToSql<Text, DB>,
+    {
+        fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, DB>) -> diesel::serialize::Result {
+            self.0.to_sql(out)
+        }
+    }
+
+    impl<DB> FromSql<Text, DB> for super::HashedApiKey
+    where
+        DB: Backend,
+        String: FromSql<Text, DB>,
+    {
+        fn from_sql(bytes: diesel::backend::RawValue<'_, DB>) -> diesel::deserialize::Result<Self> {
+            Ok(Self(String::from_sql(bytes)?))
+        }
+    }
+
+    impl<DB> Queryable<Text, DB> for super::HashedApiKey
+    where
+        DB: Backend,
+        Self: FromSql<Text, DB>,
+    {
+        type Row = Self;
+
+        fn build(row: Self::Row) -> diesel::deserialize::Result<Self> {
+            Ok(row)
+        }
+    }
+}