port docs to sveltekit (very broken)

also, initial support for patch models in rust!

Cargo.lock

@@ -92,6 +92,8 @@ dependencies = [
  "pluralkit_models",
  "reqwest 0.12.15",
  "reverse-proxy-service",
+ "sea-query",
+ "sea-query-sqlx",
  "serde",
  "serde_json",
  "serde_urlencoded",
@@ -3372,19 +3374,20 @@ dependencies = [
 
 [[package]]
 name = "sea-query"
-version = "0.32.3"
+version = "1.0.0-rc.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f5a24d8b9fcd2674a6c878a3d871f4f1380c6c43cc3718728ac96864d888458e"
+checksum = "ab621a8d8b03a3e513ea075f71aa26830a55c977d7b40f09e825bb91910db823"
 dependencies = [
+ "chrono",
  "inherent",
  "sea-query-derive",
 ]
 
 [[package]]
 name = "sea-query-derive"
-version = "0.4.3"
+version = "1.0.0-rc.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bae0cbad6ab996955664982739354128c58d16e126114fe88c2a493642502aab"
+checksum = "217e9422de35f26c16c5f671fce3c075a65e10322068dbc66078428634af6195"
 dependencies = [
  "darling",
  "heck 0.4.1",
@@ -3394,6 +3397,17 @@ dependencies = [
  "thiserror 2.0.12",
 ]
 
+[[package]]
+name = "sea-query-sqlx"
+version = "0.8.0-rc.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed5eb19495858d8ae3663387a4f5298516c6f0171a7ca5681055450f190236b8"
+dependencies = [
+ "chrono",
+ "sea-query",
+ "sqlx",
+]
+
 [[package]]
 name = "security-framework"
 version = "3.2.0"

Cargo.toml

@@ -14,6 +14,7 @@ futures = "0.3.30"
 lazy_static = "1.4.0"
 metrics = "0.23.0"
 reqwest = { version = "0.12.7" , default-features = false, features = ["rustls-tls", "trust-dns"]}
+sea-query = { version = "1.0.0-rc.10", features = ["with-chrono"] }
 sentry = { version = "0.36.0", default-features = false, features =  ["backtrace", "contexts", "panic", "debug-images", "reqwest", "rustls"] } # replace native-tls with rustls
 serde = { version = "1.0.196", features = ["derive"] }
 serde_json = "1.0.117"

PluralKit.Bot/Errors.cs

@@ -183,4 +183,6 @@ public static class Errors
 
     public static PKError ChannelNotFound(string channelString) =>
         new($"Channel \"{channelString}\" not found or is not in this server.");
+
+    public static PKError InteractionWrongAccount(ulong user) => new($"This prompt is only available for <@{user}>");
 }

PluralKit.Bot/Interactive/BaseInteractive.cs

@@ -5,6 +5,7 @@ using Myriad.Rest.Types.Requests;
 using Myriad.Types;
 
 using NodaTime;
+using PluralKit.Core;
 
 namespace PluralKit.Bot.Interactive;
 
@@ -47,6 +48,11 @@ public abstract class BaseInteractive
             new InteractionApplicationCommandCallbackData { Components = GetComponents() });
     }
 
+    protected async Task Error(InteractionContext ctx, PKError error)
+    {
+        await ctx.Reply(content: $"{Emojis.Error} {error.Message}");
+    }
+
     protected async Task Finish(InteractionContext? ctx = null)
     {
         foreach (var button in _buttons)

PluralKit.Bot/Interactive/YesNoPrompt.cs

@@ -43,7 +43,7 @@ public class YesNoPrompt: BaseInteractive
     {
         if (ctx.User.Id != User)
         {
-            await Update(ctx);
+            await Error(ctx, Errors.InteractionWrongAccount(User ?? 0));
             return;
         }
 

crates/api/Cargo.toml

@@ -14,6 +14,7 @@ fred = { workspace = true }
 lazy_static = { workspace = true }
 metrics = { workspace = true }
 reqwest = { workspace = true }
+sea-query = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
 sqlx = { workspace = true }
@@ -28,3 +29,4 @@ serde_urlencoded = "0.7.1"
 tower = "0.4.13"
 tower-http = { version = "0.5.2", features = ["catch-panic"] }
 subtle = "2.6.1"
+sea-query-sqlx = { version = "0.8.0-rc.8", features = ["sqlx-postgres", "with-chrono"] }

crates/api/src/endpoints/bulk.rs

@@ -0,0 +1,211 @@
+use axum::{
+    Extension, Json,
+    extract::{Json as ExtractJson, State},
+    response::IntoResponse,
+};
+use pk_macros::api_endpoint;
+use sea_query::{Expr, ExprTrait, PostgresQueryBuilder};
+use sea_query_sqlx::SqlxBinder;
+use serde_json::{Value, json};
+
+use pluralkit_models::{PKGroup, PKGroupPatch, PKMember, PKMemberPatch, PKSystem};
+
+use crate::{
+    ApiContext,
+    auth::AuthState,
+    error::{
+        GENERIC_AUTH_ERROR, NOT_OWN_GROUP, NOT_OWN_MEMBER, PKError, TARGET_GROUP_NOT_FOUND,
+        TARGET_MEMBER_NOT_FOUND,
+    },
+};
+
+#[derive(serde::Deserialize, Debug)]
+#[serde(tag = "type", rename_all = "snake_case")]
+pub enum BulkActionRequestFilter {
+    All,
+    Ids { ids: Vec<String> },
+    Connection { id: String },
+}
+
+#[derive(serde::Deserialize, Debug)]
+#[serde(tag = "type", rename_all = "snake_case")]
+pub enum BulkActionRequest {
+    Member {
+        filter: BulkActionRequestFilter,
+        patch: PKMemberPatch,
+    },
+    Group {
+        filter: BulkActionRequestFilter,
+        patch: PKGroupPatch,
+    },
+}
+
+#[api_endpoint]
+pub async fn bulk(
+    Extension(auth): Extension<AuthState>,
+    State(ctx): State<ApiContext>,
+    ExtractJson(req): ExtractJson<BulkActionRequest>,
+) -> Json<Value> {
+    let Some(system_id) = auth.system_id() else {
+        return Err(GENERIC_AUTH_ERROR);
+    };
+
+    #[derive(sqlx::FromRow)]
+    struct Ider {
+        id: i32,
+        hid: String,
+        uuid: String,
+    }
+
+    #[derive(sqlx::FromRow)]
+    struct GroupMemberEntry {
+        member_id: i32,
+        group_id: i32,
+    }
+
+    #[allow(dead_code)]
+    #[derive(sqlx::FromRow)]
+    struct OnlyIder {
+        id: i32,
+    }
+
+    println!("BulkActionRequest::{req:#?}");
+    match req {
+        BulkActionRequest::Member { filter, mut patch } => {
+            patch.validate_bulk();
+            if patch.errors().len() > 0 {
+                return Err(PKError::from_validation_errors(patch.errors()));
+            }
+
+            let ids: Vec<i32> = match filter {
+                BulkActionRequestFilter::All => {
+                    let ids: Vec<Ider> = sqlx::query_as("select id from members where system = $1")
+                        .bind(system_id as i64)
+                        .fetch_all(&ctx.db)
+                        .await?;
+                    ids.iter().map(|v| v.id).collect()
+                }
+                BulkActionRequestFilter::Ids { ids } => {
+                    let members: Vec<PKMember> = sqlx::query_as(
+                        "select * from members where hid = any($1::array) or uuid::text = any($1::array)",
+                    )
+                    .bind(&ids)
+                    .fetch_all(&ctx.db)
+                    .await?;
+
+                    // todo: better errors
+                    if members.len() != ids.len() {
+                        return Err(TARGET_MEMBER_NOT_FOUND);
+                    }
+
+                    if members.iter().any(|m| m.system != system_id) {
+                        return Err(NOT_OWN_MEMBER);
+                    }
+
+                    members.iter().map(|m| m.id).collect()
+                }
+                BulkActionRequestFilter::Connection { id } => {
+                    let Some(group): Option<PKGroup> =
+                        sqlx::query_as("select * from groups where hid = $1 or uuid::text = $1")
+                            .bind(id)
+                            .fetch_optional(&ctx.db)
+                            .await?
+                    else {
+                        return Err(TARGET_GROUP_NOT_FOUND);
+                    };
+
+                    if group.system != system_id {
+                        return Err(NOT_OWN_GROUP);
+                    }
+
+                    let entries: Vec<GroupMemberEntry> =
+                        sqlx::query_as("select * from group_members where group_id = $1")
+                            .bind(group.id)
+                            .fetch_all(&ctx.db)
+                            .await?;
+
+                    entries.iter().map(|v| v.member_id).collect()
+                }
+            };
+
+            let (q, pms) = patch
+                .to_sql()
+                .table("members") // todo: this should be in the model definition
+                .and_where(Expr::col("id").is_in(ids))
+                .returning_col("id")
+                .build_sqlx(PostgresQueryBuilder);
+
+            let res: Vec<OnlyIder> = sqlx::query_as_with(&q, pms).fetch_all(&ctx.db).await?;
+            Ok(Json(json! {{ "updated": res.len() }}))
+        }
+        BulkActionRequest::Group { filter, mut patch } => {
+            patch.validate_bulk();
+            if patch.errors().len() > 0 {
+                return Err(PKError::from_validation_errors(patch.errors()));
+            }
+
+            let ids: Vec<i32> = match filter {
+                BulkActionRequestFilter::All => {
+                    let ids: Vec<Ider> = sqlx::query_as("select id from groups where system = $1")
+                        .bind(system_id as i64)
+                        .fetch_all(&ctx.db)
+                        .await?;
+                    ids.iter().map(|v| v.id).collect()
+                }
+                BulkActionRequestFilter::Ids { ids } => {
+                    let groups: Vec<PKGroup> = sqlx::query_as(
+                        "select * from groups where hid = any($1) or uuid::text = any($1)",
+                    )
+                    .bind(&ids)
+                    .fetch_all(&ctx.db)
+                    .await?;
+
+                    // todo: better errors
+                    if groups.len() != ids.len() {
+                        return Err(TARGET_GROUP_NOT_FOUND);
+                    }
+
+                    if groups.iter().any(|m| m.system != system_id) {
+                        return Err(NOT_OWN_GROUP);
+                    }
+
+                    groups.iter().map(|m| m.id).collect()
+                }
+                BulkActionRequestFilter::Connection { id } => {
+                    let Some(member): Option<PKMember> =
+                        sqlx::query_as("select * from members where hid = $1 or uuid::text = $1")
+                            .bind(id)
+                            .fetch_optional(&ctx.db)
+                            .await?
+                    else {
+                        return Err(TARGET_MEMBER_NOT_FOUND);
+                    };
+
+                    if member.system != system_id {
+                        return Err(NOT_OWN_MEMBER);
+                    }
+
+                    let entries: Vec<GroupMemberEntry> =
+                        sqlx::query_as("select * from group_members where member_id = $1")
+                            .bind(member.id)
+                            .fetch_all(&ctx.db)
+                            .await?;
+
+                    entries.iter().map(|v| v.group_id).collect()
+                }
+            };
+
+            let (q, pms) = patch
+                .to_sql()
+                .table("groups") // todo: this should be in the model definition
+                .and_where(Expr::col("id").is_in(ids))
+                .returning_col("id")
+                .build_sqlx(PostgresQueryBuilder);
+
+            println!("{q:#?} {pms:#?}");
+
+            let res: Vec<OnlyIder> = sqlx::query_as_with(&q, pms).fetch_all(&ctx.db).await?;
+            Ok(Json(json! {{ "updated": res.len() }}))
+        }
+    }
+}

crates/api/src/endpoints/mod.rs

@@ -1,2 +1,3 @@
+pub mod bulk;
 pub mod private;
 pub mod system;

crates/api/src/error.rs

@@ -2,6 +2,7 @@ use axum::{
     http::StatusCode,
     response::{IntoResponse, Response},
 };
+use pluralkit_models::ValidationError;
 use std::fmt;
 
 // todo: model parse errors
@@ -11,6 +12,8 @@ pub struct PKError {
     pub json_code: i32,
     pub message: &'static str,
 
+    pub errors: Vec<ValidationError>,
+
     pub inner: Option<anyhow::Error>,
 }
 
@@ -30,6 +33,21 @@ impl Clone for PKError {
             json_code: self.json_code,
             message: self.message,
             inner: None,
+            errors: self.errors.clone(),
+        }
+    }
+}
+
+// can't `impl From<Vec<ValidationError>>`
+// because "upstream crate may add a new impl" >:(
+impl PKError {
+    pub fn from_validation_errors(errs: Vec<ValidationError>) -> Self {
+        Self {
+            message: "Error parsing JSON model",
+            json_code: 40001,
+            errors: errs,
+            response_code: StatusCode::BAD_REQUEST,
+            inner: None,
         }
     }
 }
@@ -50,14 +68,19 @@ impl IntoResponse for PKError {
         if let Some(inner) = self.inner {
             tracing::error!(?inner, "error returned from handler");
         }
-        crate::util::json_err(
-            self.response_code,
-            serde_json::to_string(&serde_json::json!({
+        let json = if self.errors.len() > 0 {
+            serde_json::json!({
                 "message": self.message,
                 "code": self.json_code,
-            }))
-            .unwrap(),
-        )
+                "errors": self.errors,
+            })
+        } else {
+            serde_json::json!({
+                "message": self.message,
+                "code": self.json_code,
+            })
+        };
+        crate::util::json_err(self.response_code, serde_json::to_string(&json).unwrap())
     }
 }
 
@@ -78,9 +101,17 @@ macro_rules! define_error {
             json_code: $json_code,
             message: $message,
             inner: None,
+            errors: vec![],
         };
     };
 }
 
+define_error! { GENERIC_AUTH_ERROR, StatusCode::UNAUTHORIZED, 0, "401: Missing or invalid Authorization header" }
 define_error! { GENERIC_BAD_REQUEST, StatusCode::BAD_REQUEST, 0, "400: Bad Request" }
 define_error! { GENERIC_SERVER_ERROR, StatusCode::INTERNAL_SERVER_ERROR, 0, "500: Internal Server Error" }
+
+define_error! { NOT_OWN_MEMBER, StatusCode::FORBIDDEN, 30006, "Target member is not part of your system." }
+define_error! { NOT_OWN_GROUP, StatusCode::FORBIDDEN, 30007, "Target group is not part of your system." }
+
+define_error! { TARGET_MEMBER_NOT_FOUND, StatusCode::BAD_REQUEST, 40010, "Target member not found." }
+define_error! { TARGET_GROUP_NOT_FOUND, StatusCode::BAD_REQUEST, 40011, "Target group not found." }

crates/api/src/main.rs

@@ -115,6 +115,8 @@ fn router(ctx: ApiContext) -> Router {
 
         .route("/v2/messages/{message_id}", get(rproxy))
 
+        .route("/v2/bulk", post(endpoints::bulk::bulk))
+
         .route("/private/bulk_privacy/member", post(rproxy))
         .route("/private/bulk_privacy/group", post(rproxy))
         .route("/private/discord/callback", post(rproxy))

crates/macros/src/model.rs

@@ -85,8 +85,14 @@ fn parse_field(field: syn::Field) -> ModelField {
         panic!("must have json name to be publicly patchable");
     }
 
-    if f.json.is_some() && f.is_privacy {
-        panic!("cannot set custom json name for privacy field");
+    if f.is_privacy && f.json.is_none() {
+        f.json = Some(syn::Expr::Lit(syn::ExprLit {
+            attrs: vec![],
+            lit: syn::Lit::Str(syn::LitStr::new(
+                f.name.clone().to_string().as_str(),
+                proc_macro2::Span::call_site(),
+            )),
+        }))
     }
 
     f
@@ -122,17 +128,17 @@ pub fn macro_impl(
 
     let fields: Vec<ModelField> = fields
         .iter()
-        .filter(|f| !matches!(f.patch, ElemPatchability::None))
+        .filter(|f| f.is_privacy || !matches!(f.patch, ElemPatchability::None))
         .cloned()
         .collect();
 
     let patch_fields = mk_patch_fields(fields.clone());
-    let patch_from_json = mk_patch_from_json(fields.clone());
     let patch_validate = mk_patch_validate(fields.clone());
+    let patch_validate_bulk = mk_patch_validate_bulk(fields.clone());
     let patch_to_json = mk_patch_to_json(fields.clone());
     let patch_to_sql = mk_patch_to_sql(fields.clone());
 
-    return quote! {
+    let code = quote! {
         #[derive(sqlx::FromRow, Debug, Clone)]
         pub struct #tname {
             #tfields
@@ -146,31 +152,42 @@ pub fn macro_impl(
             #to_json
         }
 
-        #[derive(Debug, Clone)]
+        #[derive(Debug, Clone, Default)]
         pub struct #patchable_name {
             #patch_fields
+
+            errors: Vec<crate::ValidationError>,
         }
 
         impl #patchable_name {
-            pub fn from_json(input: String) -> Self {
-                #patch_from_json
-            }
-
-            pub fn validate(self) -> bool {
+            pub fn validate(&mut self) {
                 #patch_validate
             }
 
+            pub fn errors(&self) -> Vec<crate::ValidationError> {
+                self.errors.clone()
+            }
+
+            pub fn validate_bulk(&mut self) {
+                #patch_validate_bulk
+            }
+
             pub fn to_sql(self) -> sea_query::UpdateStatement {
-                // sea_query::Query::update()
-                    #patch_to_sql
+                use sea_query::types::*;
+                let mut patch = &mut sea_query::Query::update();
+                #patch_to_sql
+                patch.clone()
             }
 
             pub fn to_json(self) -> serde_json::Value {
                 #patch_to_json
             }
         }
-    }
-    .into();
+    };
+
+    // panic!("{:#?}", code.to_string());
+
+    return code.into();
 }
 
 fn mk_tfields(fields: Vec<ModelField>) -> TokenStream {
@@ -225,7 +242,7 @@ fn mk_tto_json(fields: Vec<ModelField>) -> TokenStream {
         .filter_map(|f| {
             if f.is_privacy {
                 let tname = f.name.clone();
-                let tnamestr = f.name.clone().to_string();
+                let tnamestr = f.json.clone();
                 Some(quote! {
                     #tnamestr: self.#tname,
                 })
@@ -280,13 +297,48 @@ fn mk_patch_fields(fields: Vec<ModelField>) -> TokenStream {
         .collect()
 }
 fn mk_patch_validate(_fields: Vec<ModelField>) -> TokenStream {
-    quote! { true }
-}
-fn mk_patch_from_json(_fields: Vec<ModelField>) -> TokenStream {
     quote! { unimplemented!(); }
 }
-fn mk_patch_to_sql(_fields: Vec<ModelField>) -> TokenStream {
-    quote! { unimplemented!(); }
+fn mk_patch_validate_bulk(fields: Vec<ModelField>) -> TokenStream {
+    // iterate over all nullable patchable fields other than privacy
+    // add an error if any field is set to a value other than null
+    fields
+        .iter()
+        .map(|f| {
+            if let syn::Type::Path(path) = &f.ty && let Some(inner) = path.path.segments.last() && inner.ident != "Option" {
+                return quote! {};
+            }
+            let name = f.name.clone();
+            if matches!(f.patch, ElemPatchability::Public) {
+                let json = f.json.clone().unwrap();
+                quote! {
+                    if let Some(val) = self.#name.clone() && val.is_some() {
+                        self.errors.push(ValidationError::simple(#json, "Only null values are supported in bulk endpoint"));
+                    }
+                }
+            } else {
+                quote! {}
+            }
+        })
+        .collect()
+}
+fn mk_patch_to_sql(fields: Vec<ModelField>) -> TokenStream {
+    fields
+        .iter()
+        .filter_map(|f| {
+            if !matches!(f.patch, ElemPatchability::None) || f.is_privacy {
+                let name = f.name.clone();
+                let column = f.name.to_string();
+                Some(quote! {
+                    if let Some(value) = self.#name {
+                        patch = patch.value(#column, value);
+                    }
+                })
+            } else {
+                None
+            }
+        })
+        .collect()
 }
 fn mk_patch_to_json(_fields: Vec<ModelField>) -> TokenStream {
     quote! { unimplemented!(); }

crates/models/Cargo.toml

@@ -6,7 +6,7 @@ edition = "2024"
 [dependencies]
 chrono = { workspace = true, features = ["serde"] }
 pk_macros = { path = "../macros" }
-sea-query = "0.32.1"
+sea-query = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true, features = ["preserve_order"] }
 # in theory we want to default-features = false for sqlx

crates/models/src/group.rs

@@ -0,0 +1,132 @@
+use pk_macros::pk_model;
+
+use chrono::{DateTime, Utc};
+use serde::Deserialize;
+use serde_json::Value;
+use uuid::Uuid;
+
+use crate::{PrivacyLevel, SystemId, ValidationError};
+
+// todo: fix
+pub type GroupId = i32;
+
+#[pk_model]
+struct Group {
+    id: GroupId,
+    #[json = "hid"]
+    #[private_patchable]
+    hid: String,
+    #[json = "uuid"]
+    uuid: Uuid,
+    // TODO fix
+    #[json = "system"]
+    system: SystemId,
+
+    #[json = "name"]
+    #[privacy = name_privacy]
+    #[patchable]
+    name: String,
+    #[json = "display_name"]
+    #[patchable]
+    display_name: Option<String>,
+    #[json = "color"]
+    #[patchable]
+    color: Option<String>,
+    #[json = "icon"]
+    #[patchable]
+    icon: Option<String>,
+    #[json = "banner_image"]
+    #[patchable]
+    banner_image: Option<String>,
+    #[json = "description"]
+    #[privacy = description_privacy]
+    #[patchable]
+    description: Option<String>,
+    #[json = "created"]
+    created: DateTime<Utc>,
+
+    #[privacy]
+    name_privacy: PrivacyLevel,
+    #[privacy]
+    description_privacy: PrivacyLevel,
+    #[privacy]
+    banner_privacy: PrivacyLevel,
+    #[privacy]
+    icon_privacy: PrivacyLevel,
+    #[privacy]
+    list_privacy: PrivacyLevel,
+    #[privacy]
+    metadata_privacy: PrivacyLevel,
+    #[privacy]
+    visibility: PrivacyLevel,
+}
+
+impl<'de> Deserialize<'de> for PKGroupPatch {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        let mut patch: PKGroupPatch = Default::default();
+        let value: Value = Value::deserialize(deserializer)?;
+
+        if let Some(v) = value.get("name") {
+            if let Some(name) = v.as_str() {
+                patch.name = Some(name.to_string());
+            } else if v.is_null() {
+                patch.errors.push(ValidationError::simple(
+                    "name",
+                    "Group name cannot be set to null.",
+                ));
+            }
+        }
+
+        macro_rules! parse_string_simple {
+            ($k:expr) => {
+                match value.get($k) {
+                    None => None,
+                    Some(Value::Null) => Some(None),
+                    Some(Value::String(s)) => Some(Some(s.clone())),
+                    _ => {
+                        patch.errors.push(ValidationError::new($k));
+                        None
+                    }
+                }
+            };
+        }
+
+        patch.display_name = parse_string_simple!("display_name");
+        patch.description = parse_string_simple!("description");
+        patch.icon = parse_string_simple!("icon");
+        patch.banner_image = parse_string_simple!("banner");
+        patch.color = parse_string_simple!("color").map(|v| v.map(|t| t.to_lowercase()));
+
+        if let Some(privacy) = value.get("privacy").and_then(Value::as_object) {
+            macro_rules! parse_privacy {
+                ($v:expr) => {
+                    match privacy.get($v) {
+                        None => None,
+                        Some(Value::Null) => Some(PrivacyLevel::Private),
+                        Some(Value::String(s)) if s == "" || s == "private" => {
+                            Some(PrivacyLevel::Private)
+                        }
+                        Some(Value::String(s)) if s == "public" => Some(PrivacyLevel::Public),
+                        _ => {
+                            patch.errors.push(ValidationError::new($v));
+                            None
+                        }
+                    }
+                };
+            }
+
+            patch.name_privacy = parse_privacy!("name_privacy");
+            patch.description_privacy = parse_privacy!("description_privacy");
+            patch.banner_privacy = parse_privacy!("banner_privacy");
+            patch.icon_privacy = parse_privacy!("icon_privacy");
+            patch.list_privacy = parse_privacy!("list_privacy");
+            patch.metadata_privacy = parse_privacy!("metadata_privacy");
+            patch.visibility = parse_privacy!("visibility");
+        }
+
+        Ok(patch)
+    }
+}

crates/models/src/lib.rs

@@ -9,6 +9,8 @@ macro_rules! model {
 
 model!(system);
 model!(system_config);
+model!(member);
+model!(group);
 
 #[derive(serde::Serialize, Debug, Clone)]
 #[serde(rename_all = "snake_case")]
@@ -31,3 +33,30 @@ impl From<i32> for PrivacyLevel {
         }
     }
 }
+
+impl From<PrivacyLevel> for sea_query::Value {
+    fn from(level: PrivacyLevel) -> sea_query::Value {
+        match level {
+            PrivacyLevel::Public => sea_query::Value::Int(Some(1)),
+            PrivacyLevel::Private => sea_query::Value::Int(Some(2)),
+        }
+    }
+}
+
+#[derive(serde::Serialize, Debug, Clone)]
+pub enum ValidationError {
+    Simple { key: String, value: String },
+}
+
+impl ValidationError {
+    fn new(key: &str) -> Self {
+        Self::simple(key, "is invalid")
+    }
+
+    fn simple(key: &str, value: &str) -> Self {
+        Self::Simple {
+            key: key.to_string(),
+            value: value.to_string(),
+        }
+    }
+}

crates/models/src/member.rs

@@ -0,0 +1,208 @@
+use pk_macros::pk_model;
+
+use chrono::NaiveDateTime;
+use serde::{Deserialize, Serialize};
+use serde_json::Value;
+use uuid::Uuid;
+
+use crate::{PrivacyLevel, SystemId, ValidationError};
+
+// todo: fix
+pub type MemberId = i32;
+
+#[derive(Clone, Debug, Serialize, Deserialize, sqlx::Type)]
+#[sqlx(type_name = "proxy_tag")]
+pub struct ProxyTag {
+    pub prefix: Option<String>,
+    pub suffix: Option<String>,
+}
+
+#[pk_model]
+struct Member {
+    id: MemberId,
+    #[json = "hid"]
+    #[private_patchable]
+    hid: String,
+    #[json = "uuid"]
+    uuid: Uuid,
+    // TODO fix
+    #[json = "system"]
+    system: SystemId,
+
+    #[json = "color"]
+    #[patchable]
+    color: Option<String>,
+    #[json = "webhook_avatar_url"]
+    #[patchable]
+    webhook_avatar_url: Option<String>,
+    #[json = "avatar_url"]
+    #[patchable]
+    avatar_url: Option<String>,
+    #[json = "banner_image"]
+    #[patchable]
+    banner_image: Option<String>,
+    #[json = "name"]
+    #[privacy = name_privacy]
+    #[patchable]
+    name: String,
+    #[json = "display_name"]
+    #[patchable]
+    display_name: Option<String>,
+    #[json = "birthday"]
+    #[patchable]
+    birthday: Option<String>,
+    #[json = "pronouns"]
+    #[privacy = pronoun_privacy]
+    #[patchable]
+    pronouns: Option<String>,
+    #[json = "description"]
+    #[privacy = description_privacy]
+    #[patchable]
+    description: Option<String>,
+    #[json = "proxy_tags"]
+    // #[patchable]
+    proxy_tags: Vec<ProxyTag>,
+    #[json = "keep_proxy"]
+    #[patchable]
+    keep_proxy: bool,
+    #[json = "tts"]
+    #[patchable]
+    tts: bool,
+    #[json = "created"]
+    created: NaiveDateTime,
+    #[json = "message_count"]
+    #[private_patchable]
+    message_count: i32,
+    #[json = "last_message_timestamp"]
+    #[private_patchable]
+    last_message_timestamp: Option<NaiveDateTime>,
+    #[json = "allow_autoproxy"]
+    #[patchable]
+    allow_autoproxy: bool,
+
+    #[privacy]
+    #[json = "visibility"]
+    member_visibility: PrivacyLevel,
+    #[privacy]
+    description_privacy: PrivacyLevel,
+    #[privacy]
+    banner_privacy: PrivacyLevel,
+    #[privacy]
+    avatar_privacy: PrivacyLevel,
+    #[privacy]
+    name_privacy: PrivacyLevel,
+    #[privacy]
+    birthday_privacy: PrivacyLevel,
+    #[privacy]
+    pronoun_privacy: PrivacyLevel,
+    #[privacy]
+    metadata_privacy: PrivacyLevel,
+    #[privacy]
+    proxy_privacy: PrivacyLevel,
+}
+
+impl<'de> Deserialize<'de> for PKMemberPatch {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        let mut patch: PKMemberPatch = Default::default();
+        let value: Value = Value::deserialize(deserializer)?;
+
+        if let Some(v) = value.get("name") {
+            if let Some(name) = v.as_str() {
+                patch.name = Some(name.to_string());
+            } else if v.is_null() {
+                patch.errors.push(ValidationError::simple(
+                    "name",
+                    "Member name cannot be set to null.",
+                ));
+            }
+        }
+
+        macro_rules! parse_string_simple {
+            ($k:expr) => {
+                match value.get($k) {
+                    None => None,
+                    Some(Value::Null) => Some(None),
+                    Some(Value::String(s)) => Some(Some(s.clone())),
+                    _ => {
+                        patch.errors.push(ValidationError::new($k));
+                        None
+                    }
+                }
+            };
+        }
+
+        patch.color = parse_string_simple!("color").map(|v| v.map(|t| t.to_lowercase()));
+        patch.display_name = parse_string_simple!("display_name");
+        patch.avatar_url = parse_string_simple!("avatar_url");
+        patch.banner_image = parse_string_simple!("banner");
+        patch.birthday = parse_string_simple!("birthday"); // fix
+        patch.pronouns = parse_string_simple!("pronouns");
+        patch.description = parse_string_simple!("description");
+
+        if let Some(keep_proxy) = value.get("keep_proxy").and_then(Value::as_bool) {
+            patch.keep_proxy = Some(keep_proxy);
+        }
+        if let Some(tts) = value.get("tts").and_then(Value::as_bool) {
+            patch.tts = Some(tts);
+        }
+
+        // todo: legacy import handling
+
+        // todo: fix proxy_tag type in sea_query
+
+        // if let Some(proxy_tags) = value.get("proxy_tags").and_then(Value::as_array) {
+        //     patch.proxy_tags = Some(
+        //         proxy_tags
+        //             .iter()
+        //             .filter_map(|tag| {
+        //                 tag.as_object().map(|tag_obj| {
+        //                     let prefix = tag_obj
+        //                         .get("prefix")
+        //                         .and_then(Value::as_str)
+        //                         .map(|s| s.to_string());
+        //                     let suffix = tag_obj
+        //                         .get("suffix")
+        //                         .and_then(Value::as_str)
+        //                         .map(|s| s.to_string());
+        //                     ProxyTag { prefix, suffix }
+        //                 })
+        //             })
+        //             .collect(),
+        //     )
+        // }
+
+        if let Some(privacy) = value.get("privacy").and_then(Value::as_object) {
+            macro_rules! parse_privacy {
+                ($v:expr) => {
+                    match privacy.get($v) {
+                        None => None,
+                        Some(Value::Null) => Some(PrivacyLevel::Private),
+                        Some(Value::String(s)) if s == "" || s == "private" => {
+                            Some(PrivacyLevel::Private)
+                        }
+                        Some(Value::String(s)) if s == "public" => Some(PrivacyLevel::Public),
+                        _ => {
+                            patch.errors.push(ValidationError::new($v));
+                            None
+                        }
+                    }
+                };
+            }
+
+            patch.member_visibility = parse_privacy!("visibility");
+            patch.name_privacy = parse_privacy!("name_privacy");
+            patch.description_privacy = parse_privacy!("description_privacy");
+            patch.banner_privacy = parse_privacy!("banner_privacy");
+            patch.avatar_privacy = parse_privacy!("avatar_privacy");
+            patch.birthday_privacy = parse_privacy!("birthday_privacy");
+            patch.pronoun_privacy = parse_privacy!("pronoun_privacy");
+            patch.proxy_privacy = parse_privacy!("proxy_privacy");
+            patch.metadata_privacy = parse_privacy!("metadata_privacy");
+        }
+
+        Ok(patch)
+    }
+}

docs/.gitignore

@@ -1,12 +1,23 @@
-pids
-logs
 node_modules
-npm-debug.log
-coverage/
-run
-dist
+
+# Output
+.output
+.vercel
+.netlify
+.wrangler
+/.svelte-kit
+/build
+
+# OS
 .DS_Store
-.nyc_output
-.basement
-config.local.js
-basement_dist
+Thumbs.db
+
+# Env
+.env
+.env.*
+!.env.example
+!.env.test
+
+# Vite
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*

docs/.npmrc

@@ -0,0 +1 @@
+engine-strict=true

docs/README.md

@@ -1,19 +0,0 @@
-# PluralKit docs
-The documentation is built using [Vuepress](https://vuepress.vuejs.org/). All website content is located in the `content/` subdirectory.
-
-Most site parameters, including the sidebar layout, are defined in `content/.vuepress/config.js`. Some additional CSS is defined in `content/.vuepress/styles`.
-
-## Building
-First, install [Node.js](https://nodejs.org/en/download/) and [Yarn](https://classic.yarnpkg.com/en/). Then, run the `dev` command:
-
-```sh
-$ yarn
-$ yarn dev
-```
-
-This will start a development server on http://localhost:8080/. Note that changes to the sidebar or similar generally need a full restart (Ctrl-C) to take effect, while content-only changes will hot-reload.
-
-For a full HTML build, run `yarn build`. Files will be output in `content/.vuepress/dist` by default.
-
-## Deployment
-The docs are deployed using [Netlify](https://www.netlify.com/) with CI.

docs/content/changelog.md

@@ -467,7 +467,7 @@ Features:
 
 Bugfixes:
 - fixed importing pronouns and message count
-- fixed looking up messages with a discord canary link (and then fixed looking up normal links >.<)
+- fixed looking up messages with a discord canary link (and then fixed looking up normal links >.\<)
 - fixed a few "internal error" messages and other miscellaneous bugs
 (also, `pk;member <name> soulscream` is a semi-secret command for the time being, if you know what this means, have fun :3 🍬)
 

docs/content/faq.md

@@ -55,8 +55,8 @@ This includes:
 For more information about why certain information must be public, see [this github issue](https://github.com/PluralKit/PluralKit/issues/238).
 
 ### Is there a way to restrict PluralKit usage to a certain role? / Can I remove PluralKit access for specific users in my server?
-This is not a feature currently available in PluralKit. It may be added in the future.
-In the meantime, this feature is supported in Tupperbox (an alternative proxying bot) - ask about it in their support server: <https://discord.gg/Z4BHccHhy3>
+PluralKit does not, and *will not*, support restricting usage of the bot by role.
+This feature is supported in Tupperbox (an alternative proxying bot) - ask about it in their support server: <https://discord.gg/Z4BHccHhy3>
 
 ### Is it possible to block proxied messages (like blocking a user)?
 No. Since proxied messages are posted through webhooks, and those technically aren't real users on Discord's end, it's not possible to block them. Blocking PluralKit itself will also not block the webhook messages. Discord also does not allow you to control who can receive a specific message, so it's not possible to integrate a blocking system in the bot, either. Sorry :/

docs/content/index.md

@@ -11,4 +11,14 @@ This bot detects messages with certain tags associated with a profile, then repl
 #### for example...
 ![demonstration of PluralKit](./assets/demo.gif)
 
-For more information, see the links to the left, or click [here](https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904) to invite the bot to your server!
+For more information, see the links to the left, or click [here](https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904) to invite the bot to your server!
+
+## Sponsors
+
+<div style="text-align:center;">
+
+![Prodigi logo](./assets/prodigi.png)
+
+</div>
+
+PluralKit's infrastructure is generously sponsored by [Prodigi](https://prodigi.nz), a New Zealand based technology services provider.

docs/fly.toml

@@ -1,3 +1,3 @@
 app = "pluralkit-docs"
-primary_region = "arn"
+primary_region = "sjc"
 http_service.internal_port = 8000

docs/package.json

@@ -1,20 +1,38 @@
 {
-  "name": "pluralkit-docs",
-  "private": true,
-  "description": "Documentation for PluralKit",
-  "scripts": {
-    "dev": "vuepress dev content",
-    "build": "vuepress build content"
-  },
-  "license": "AGPL-3.0-or-later",
-  "devDependencies": {
-    "@vuepress/plugin-back-to-top": "1.8.2",
-    "markdown-it-custom-header-link": "^1.0.5",
-    "vuepress": "1.8.2",
-    "vuepress-plugin-clean-urls": "1.1.2",
-    "vuepress-plugin-dehydrate": "1.1.5"
-  },
-  "dependencies": {
-    "vuepress-theme-default-prefers-color-scheme": "2.0.0"
-  }
+	"name": "docs",
+	"private": true,
+	"version": "0.0.1",
+	"type": "module",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch"
+	},
+	"devDependencies": {
+		"@sveltejs/adapter-node": "^5.4.0",
+		"@sveltejs/kit": "^2.49.1",
+		"@sveltejs/vite-plugin-svelte": "^6.2.1",
+		"@tabler/icons-svelte": "^3.36.0",
+		"@tailwindcss/postcss": "^4.1.18",
+		"@tailwindcss/typography": "^0.5.13",
+		"@tailwindcss/vite": "^4.1.17",
+		"@types/node": "^25.0.3",
+		"@types/nprogress": "^0.2.3",
+		"autoprefixer": "^10.4.23",
+		"daisyui": "^4.12.24",
+		"nprogress": "^0.2.0",
+		"postcss": "^8.5.3",
+		"sass": "^1.77.8",
+		"svelte": "^5.45.6",
+		"svelte-check": "^4.3.4",
+		"tailwindcss": "^3.4.17",
+		"typescript": "^5.9.3",
+		"vite": "^7.2.6"
+	},
+	"dependencies": {
+		"mdsvex": "^0.12.6"
+	}
 }

docs/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

docs/src/app.d.ts

@@ -0,0 +1,13 @@
+// See https://svelte.dev/docs/kit/types#app.d.ts
+// for information about these interfaces
+declare global {
+	namespace App {
+		// interface Error {}
+		// interface Locals {}
+		// interface PageData {}
+		// interface PageState {}
+		// interface Platform {}
+	}
+}
+
+export {};

docs/src/app.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover">
+		<div style="display: contents">%sveltekit.body%</div>
+	</body>
+</html>

docs/src/components/Footer.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+  import { env } from "$env/dynamic/public"
+
+  // @ts-ignore
+  const version = __COMMIT_HASH__.slice(1, __COMMIT_HASH__.length - 1)
+</script>
+
+<footer class="footer items-center p-4">
+  <nav class="grid-flow-col gap-4">
+    <span
+      >Commit: <a
+        aria-label="View commit on github"
+        class="underline"
+        href={`${
+          env.PUBLIC_REPOSITORY_URL
+            ? env.PUBLIC_REPOSITORY_URL
+            : "https://github.com/Draconizations/pk-dashboard-sveltekit"
+        }/commit/${version}`}>{version}</a
+      >
+    </span>
+  </nav>
+  <nav class="grid-flow-col gap-4 md:place-self-center md:justify-self-end">
+    <a class="link-hover" href="/about">About</a>
+    <a class="link-hover" href="/privacy">Privacy</a>
+    <a class="link-hover" href="/changelog">Changelog</a>
+  </nav>
+</footer>

docs/src/components/NavBar.svelte

@@ -0,0 +1,139 @@
+<script lang="ts">
+  import {
+    IconMenu2,
+    IconBook,
+    IconBrandDiscord,
+    IconShare3,
+    IconUsers,
+    IconBoxMultiple,
+    IconAdjustments,
+    IconPaint,
+    IconLogout,
+    IconAddressBook,
+    IconHome,
+    IconSettings,
+    IconStatusChange,
+    IconInfoCircle,
+    IconDashboard,
+    IconLayoutDashboard,
+  } from "@tabler/icons-svelte"
+
+  let userMenu: HTMLDetailsElement
+  let navbarMenu: HTMLDetailsElement
+</script>
+
+<div class="navbar bg-base-100">
+  <div class="navbar-start flex-1">
+    <details class="dropdown" bind:this={navbarMenu}>
+      <summary class="btn btn-ghost md:hidden">
+        <IconMenu2 />
+      </summary>
+      <ul class="menu menu-sm dropdown-content mt-3 z-[1] p-2 shadow bg-base-100 rounded-box w-52">
+        <li>
+          <a href="/" onclick={() => (navbarMenu.open = false)}>
+            <IconHome /> Homepage
+          </a>
+        </li>
+        <li>
+          <a
+            href="https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904"
+            onclick={() => (navbarMenu.open = false)}
+          >
+            <IconShare3 /> Invite bot
+          </a>
+        </li>
+        <li>
+          <a href="https://pluralkit.me/" onclick={() => (navbarMenu.open = false)}
+            ><IconBook /> Documentation</a
+          >
+        </li>
+        <li>
+          <a href="https://discord.gg/PczBt78" onclick={() => (navbarMenu.open = false)}
+            ><IconBrandDiscord /> Support server</a
+          >
+        </li>
+      </ul>
+    </details>
+    <a href="/" class="hidden text-xl btn btn-ghost md:inline-flex">PluralKit</a>
+  </div>
+  <div class="hidden navbar-center md:flex">
+    <ul class="px-1 menu menu-horizontal">
+        <li><a href="https://dash.pluralkit.me/"><IconLayoutDashboard /> Web dashboard</a></li>
+        <li><a href="https://discord.gg/PczBt78"><IconBrandDiscord /> Support server</a></li>
+        <li>
+            <a
+            href="https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904"
+            >
+            <IconShare3 /> Invite bot
+            </a>
+        </li>
+        <li><a href="https://status.pluralkit.me"><IconInfoCircle /> Status</a></li>
+    </ul>
+  </div>
+  <div class="navbar-end w-auto">
+    <a href="/settings#theme" class="mr-4 tooltip tooltip-bottom" data-tip="Change theme"
+      ><IconPaint /></a
+    >
+    {#if false /*dash.user*/}
+      <details class="dropdown dropdown-left" bind:this={userMenu}>
+        <summary class="mr-2 list-none">
+          {#if false /*dash.user.avatar_url*/}
+            <div class="avatar">
+              <div class="w-12 rounded-full">
+                <!-- <img alt="your system avatar" src={dash.user.avatar_url} /> -->
+              </div>
+            </div>
+          {:else}
+            <div class="avatar">
+              <div class="w-12 rounded-full">
+                <img alt="An icon of myriad" src="/myriad_write.png" />
+              </div>
+            </div>
+          {/if}
+        </summary>
+        <ul
+          data-sveltekit-preload-data="tap"
+          class="menu menu-sm menu-dropdown dropdown-content mt-3 z-[1] p-2 shadow bg-base-100 rounded-box w-36"
+        >
+          <!-- <li>
+            <a href={`/dash/${dash.user?.id}?tab=overview`} onclick={() => (userMenu.open = false)}
+              ><IconAdjustments /> Overview</a
+            >
+          </li>
+          <li>
+            <a href={`/dash/${dash.user?.id}?tab=system`} onclick={() => (userMenu.open = false)}
+              ><IconAddressBook /> System</a
+            >
+          </li>
+          <li>
+            <a href={`/dash/${dash.user?.id}?tab=members`} onclick={() => (userMenu.open = false)}
+              ><IconUsers /> Members</a
+            >
+          </li>
+          <li>
+            <a href={`/dash/${dash.user?.id}?tab=groups`} onclick={() => (userMenu.open = false)}
+              ><IconBoxMultiple /> Groups</a
+            >
+          </li> -->
+          <hr class="my-2" />
+          <li>
+            <a href="/settings/general" onclick={() => (userMenu.open = false)}
+              ><IconSettings /> Settings</a
+            >
+          </li>
+          <li>
+            <form method="post" action="/?/logout">
+              <IconLogout />
+              <input
+                onclick={() => (userMenu.open = false)}
+                class="text-error w-min"
+                type="submit"
+                value="Logout"
+              />
+            </form>
+          </li>
+        </ul>
+      </details>
+    {/if}
+  </div>
+</div>

docs/src/components/Sidebar.svelte

@@ -0,0 +1,107 @@
+<script lang="ts">
+	import { page } from "$app/stores";
+
+	const mdModules = import.meta.glob('/content/**/*.md', { eager: true }) as Record<string, { metadata?: { title?: string; permalink?: string } }>;
+
+	const pathToTitle: Record<string, string> = {};
+	for (const [filePath, mod] of Object.entries(mdModules)) {
+		const urlPath = filePath
+			.replace('/content', '')
+			.replace(/\/index\.md$/, '')
+			.replace(/\.md$/, '');
+
+		if (mod.metadata?.title) {
+			pathToTitle[urlPath || '/'] = mod.metadata.title;
+		}
+	}
+
+	function getTitle(path: string): string {
+		return pathToTitle[path] || path.split('/').pop() || path;
+	}
+
+	const sidebar = [
+		{
+			title: "Home",
+			href: "/",
+		},
+		{
+			title: "Add to your server",
+			href: "https://discord.com/oauth2/authorize?client_id=466378653216014359&scope=bot%20applications.commands&permissions=536995904",
+		},
+		{
+			title: "Updates",
+			sidebarDepth: 1,
+			children: [
+				"/posts",
+				"/changelog",
+			]
+		},
+		{
+			title: "Documentation",
+			sidebarDepth: 2,
+			children: [
+				"/getting-started",
+				"/user-guide",
+				"/command-list",
+				"/privacy-policy",
+				"/terms-of-service",
+				"/faq",
+				"/tips-and-tricks"
+			]
+		},
+		{
+			title: "For server staff",
+			children: [
+				"/staff/permissions",
+				"/staff/moderation",
+				"/staff/disabling",
+				"/staff/logging",
+				"/staff/compatibility",
+			]
+		},
+		{
+			title: "API Documentation",
+			children: [
+				"/api/changelog",
+				"/api/reference",
+				"/api/endpoints",
+				"/api/models",
+				"/api/errors",
+				"/api/dispatch"
+			]
+		},
+		{
+			title: "Join the support server",
+			href: "https://discord.gg/PczBt78",
+		},
+		];
+
+	function isActive(href: string): boolean {
+		return $page.url.pathname === href;
+	}
+	</script>
+
+<aside class="w-80 bg-base-200 p-4 overflow-y-auto shrink-0 min-h-0">
+	<ul class="menu w-full">
+		{#each sidebar as item}
+			{#if item.children}
+				<li class="menu-title flex flex-row items-center gap-2 mt-4">
+					{item.title}
+				</li>
+				{#each item.children as child}
+					<li>
+						<a href={child} class:active={isActive(child)}>
+						{getTitle(child)}
+						</a>
+					</li>
+				{/each}
+			{:else}
+				<li>
+					<a href={item.href} class:active={isActive(item.href)}>
+						{item.title}
+					</a>
+				</li>
+			{/if}
+		{/each}
+	</ul>
+</aside>

docs/src/lib/app.scss

@@ -0,0 +1,212 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+html {
+  height: 100%;
+}
+
+@layer components {
+  hr {
+    @apply border-muted/50;
+  }
+
+  .btn-menu {
+    @apply px-4 py-2 h-auto min-h-0 justify-start;
+  }
+
+  .box {
+    @apply rounded-xl bg-base-200 p-4;
+  }
+
+  .menu :where(li:not(.menu-title) > :not(ul):not(details):not(.menu-title)),
+  .menu :where(li:not(.menu-title) > details > summary:not(.menu-title)) {
+    @apply select-text;
+  }
+
+  .tabs-lifted.tabs-box > .tab.tab-active:not(.tab-disabled):not([disabled]) {
+    @apply bg-base-200;
+  }
+
+  .tabs-lifted.tabs-box .tab.tab-active:not(.tab-disabled):not([disabled])::before,
+  .tabs-lifted.tabs-box .tab.tab-active:not(.tab-disabled):not([disabled]):first-child::before,
+  .tabs-lifted.tabs-box .tab.tab-active:not(.tab-disabled):not([disabled]):last-child::before {
+    background-image: none;
+  }
+
+  /* start of discord markdown styling */
+  .discord-markdown {
+    blockquote {
+      @apply pl-3 border-l-4 border-muted/50;
+    }
+
+    ul {
+      @apply list-disc pl-4;
+    }
+
+    ol {
+      @apply list-decimal pl-4;
+    }
+
+    .d-emoji {
+      @apply h-4 w-auto inline;
+    }
+
+    .d-spoiler {
+      @apply bg-base-content text-base-content;
+      border-radius: 4px;
+      transition-delay: 6000s;
+
+      &::selection {
+        @apply text-base-content;
+        background-color: transparent;
+      }
+
+      &:active {
+        @apply bg-base-300;
+        transition-delay: 0s;
+      }
+    }
+
+    code {
+      @apply px-1 text-sm rounded-sm bg-base-200;
+    }
+
+    pre > code {
+      @apply py-1 px-2 md:px-3 md:py-2 rounded-xl;
+    }
+
+    a {
+      @apply link-primary;
+    }
+
+    small {
+      @apply block text-muted;
+    }
+  }
+
+  /* end of discord markdown styling */
+
+  /* button styling! */
+  .btn {
+    @apply font-normal;
+  }
+
+  /* daisyUI applies some styling to lists in .menu that we don't want */
+  /* so we reset them here */
+  :where(.menu li),
+  :where(.menu ul) {
+    position: static;
+  }
+
+  .discord-markdown ul {
+    position: static;
+    white-space: normal;
+    margin-inline-start: 0;
+    margin-inline-end: 0;
+  }
+
+  .discord-markdown li {
+    position: static;
+    display: list-item;
+  }
+
+  .menu .discord-markdown :where(li:not(.menu-title) > :not(ul, details, .menu-title, .btn)),
+  .menu .discord-markdown :where(li:not(.menu-title) > details > summary:not(.menu-title)) {
+    display: unset;
+    padding: unset;
+  }
+
+  /* end of the .menu reset */
+}
+
+[data-theme="dark"],
+[data-theme="light"],
+[data-theme="acid"],
+[data-theme="cotton"],
+[data-theme="autumn"],
+[data-theme="coffee"] {
+  --sv-min-height: 40px;
+  --sv-bg: var(--fallback-b1, oklch(var(--b1) / var(--tw-bg-opacity)));
+  --sv-disabled-bg: var(--fallback-b3, oklch(var(--b3) / var(--tw-bg-opacity)));
+  --sv-border: 1px solid oklch(var(--muted) / 0.5);
+  --sv-border-radius: 6px;
+  --sv-general-padding: 0.25rem;
+  --sv-control-bg: var(--sv-bg);
+  --sv-item-wrap-padding: 3px 3px 3px 6px;
+  --sv-item-selected-bg: var(--fallback-b3, oklch(var(--b3) / var(--tw-bg-opacity)));
+  --sv-item-btn-color: var(--fallback-bc, oklch(var(--bc) / 1));
+  --sv-item-btn-color-hover: var(
+    --fallback-bc,
+    oklch(var(--bc) / 0.6)
+  ); /* same as icon-color-hover in default theme */
+  --sv-item-btn-bg: transparent;
+  --sv-item-btn-bg-hover: transparent;
+  --sv-icon-color: var(--sv-item-btn-color);
+  --sv-icon-color-hover: var(--sv-item-btn-color-hover);
+  --sv-icon-bg: transparent;
+  --sv-icon-size: 20px;
+  --sv-separator-bg: transparent;
+  --sv-btn-border: 0;
+  --sv-placeholder-color: transparent;
+  --sv-dropdown-bg: var(--sv-bg);
+  --sv-dropdown-offset: 1px;
+  --sv-dropdown-border: 1px solid oklch(var(--muted) / 0.5);
+  --sv-dropdown-width: auto;
+  --sv-dropdown-shadow: none;
+  --sv-dropdown-height: 320px;
+  --sv-dropdown-active-bg: var(--fallback-b3, oklch(var(--b3) / var(--tw-bg-opacity)));
+  --sv-dropdown-selected-bg: oklch(var(--p) / 0.2);
+  --sv-create-kbd-border: none;
+  --sv-create-kbd-bg: transparent;
+  --sv-create-disabled-bg: transparent;
+  --sv-loader-border: none;
+  --sv-item-wrap-padding: 0.375rem 0.25rem;
+}
+
+.join-item.svelecte-control-pk {
+  --sv-min-height: 2rem;
+
+  .sv-control {
+    border-top-left-radius: 0;
+    border-bottom-left-radius: 0;
+  }
+}
+
+.group-control {
+  --sv-dropdown-active-bg: transparent;
+  --sv-item-wrap-padding: 0.25rem 0;
+}
+
+.group-control .option {
+  width: calc(100% + 0.5rem);
+}
+
+.sv-item--wrap {
+  border-radius: 4px;
+  padding: 0.25rem;
+  font-size: 14px;
+}
+
+.sv-item--wrap.in-dropdown {
+  padding: 0;
+  position: relative;
+}
+
+.sv-item--wrap.in-dropdown:not(:last-child)::after {
+  content: "";
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 0;
+  border-bottom: 1px solid oklch(var(--muted) / 0.5);
+}
+
+.sv-dropdown-scroll {
+  padding: 0 0.75rem !important;
+}
+
+.svelecte {
+  flex: auto !important;
+}

docs/src/lib/assets/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="107" height="128" viewBox="0 0 107 128"><title>svelte-logo</title><path d="M94.157 22.819c-10.4-14.885-30.94-19.297-45.792-9.835L22.282 29.608A29.92 29.92 0 0 0 8.764 49.65a31.5 31.5 0 0 0 3.108 20.231 30 30 0 0 0-4.477 11.183 31.9 31.9 0 0 0 5.448 24.116c10.402 14.887 30.942 19.297 45.791 9.835l26.083-16.624A29.92 29.92 0 0 0 98.235 78.35a31.53 31.53 0 0 0-3.105-20.232 30 30 0 0 0 4.474-11.182 31.88 31.88 0 0 0-5.447-24.116" style="fill:#ff3e00"/><path d="M45.817 106.582a20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.503 18 18 0 0 1 .624-2.435l.49-1.498 1.337.981a33.6 33.6 0 0 0 10.203 5.098l.97.294-.09.968a5.85 5.85 0 0 0 1.052 3.878 6.24 6.24 0 0 0 6.695 2.485 5.8 5.8 0 0 0 1.603-.704L69.27 76.28a5.43 5.43 0 0 0 2.45-3.631 5.8 5.8 0 0 0-.987-4.371 6.24 6.24 0 0 0-6.698-2.487 5.7 5.7 0 0 0-1.6.704l-9.953 6.345a19 19 0 0 1-5.296 2.326 20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.502 17.99 17.99 0 0 1 8.13-12.052l26.081-16.623a19 19 0 0 1 5.3-2.329 20.72 20.72 0 0 1 22.237 8.243 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-.624 2.435l-.49 1.498-1.337-.98a33.6 33.6 0 0 0-10.203-5.1l-.97-.294.09-.968a5.86 5.86 0 0 0-1.052-3.878 6.24 6.24 0 0 0-6.696-2.485 5.8 5.8 0 0 0-1.602.704L37.73 51.72a5.42 5.42 0 0 0-2.449 3.63 5.79 5.79 0 0 0 .986 4.372 6.24 6.24 0 0 0 6.698 2.486 5.8 5.8 0 0 0 1.602-.704l9.952-6.342a19 19 0 0 1 5.295-2.328 20.72 20.72 0 0 1 22.237 8.242 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-8.13 12.053l-26.081 16.622a19 19 0 0 1-5.3 2.328" style="fill:#fff"/></svg>

docs/src/lib/index.ts

@@ -0,0 +1 @@
+// place files you want to import through the `$lib` alias in this folder.

docs/src/lib/nprogress.scss

@@ -0,0 +1,77 @@
+#themed-container {
+  --nprogress-color: var(--fallback-p, oklch(var(--p) / 1));
+}
+
+/* Make clicks pass-through */
+#nprogress {
+  pointer-events: none;
+
+  .bar {
+    background: var(--nprogress-color);
+
+    position: fixed;
+    z-index: 1031;
+    top: 0;
+    left: 0;
+
+    width: 100%;
+    height: 4px;
+  }
+}
+
+/* Fancy blur effect */
+/* #nprogress .peg {
+  display: block;
+  position: absolute;
+  right: 0px;
+  width: 100px;
+  height: 100%;
+  box-shadow: 0 0 10px var(--nprogress-color), 0 0 5px var(--nprogress-color);
+  opacity: 1.0;
+
+  -webkit-transform: rotate(3deg) translate(0px, -4px);
+      -ms-transform: rotate(3deg) translate(0px, -4px);
+          transform: rotate(3deg) translate(0px, -4px);
+} */
+
+/* Remove these to get rid of the spinner */
+/* #nprogress .spinner {
+  display: block;
+  position: fixed;
+  z-index: 1031;
+  top: 15px;
+  right: 15px;
+}
+
+#nprogress .spinner-icon {
+  width: 18px;
+  height: 18px;
+  box-sizing: border-box;
+
+  border: solid 2px transparent;
+  border-top-color: var(--nprogress-color);
+  border-left-color: var(--nprogress-color);
+  border-radius: 50%;
+
+  -webkit-animation: nprogress-spinner 400ms linear infinite;
+          animation: nprogress-spinner 400ms linear infinite;
+}
+
+.nprogress-custom-parent {
+  overflow: hidden;
+  position: relative;
+}
+
+.nprogress-custom-parent #nprogress .spinner,
+.nprogress-custom-parent #nprogress .bar {
+  position: absolute;
+}
+
+@-webkit-keyframes nprogress-spinner {
+  0%   { -webkit-transform: rotate(0deg); }
+  100% { -webkit-transform: rotate(360deg); }
+}
+@keyframes nprogress-spinner {
+  0%   { transform: rotate(0deg); }
+  100% { transform: rotate(360deg); }
+} */

docs/src/routes/+layout.svelte

@@ -0,0 +1,64 @@
+<script lang="ts">
+  import { browser } from "$app/environment"
+  import NavBar from "$components/NavBar.svelte"
+  import Sidebar from "$components/Sidebar.svelte"
+  import "$lib/app.scss"
+  import "$lib/nprogress.scss"
+  import type { LayoutData } from "./$types"
+  import Footer from "$components/Footer.svelte"
+  import { page } from "$app/stores"
+  import { navigating } from "$app/stores"
+  import nprogress from "nprogress"
+//   import apiClient from "$api"
+
+  export let data: LayoutData
+
+//   if (browser) {
+//     window.api = apiClient(fetch, data.apiBaseUrl)
+//   }
+
+  if (data.token && browser) {
+    localStorage.setItem("pk-token", data.token)
+  } else if (browser) {
+    localStorage.removeItem("pk-token")
+  }
+
+  nprogress.configure({
+    parent: "#themed-container",
+  })
+
+  $: {
+    if ($navigating) nprogress.start()
+    else if (!$navigating) nprogress.done()
+  }
+
+//   dash.initUser(data.system)
+</script>
+
+<div
+  id="themed-container"
+  class="max-w-screen h-screen bg-base-100 flex flex-col"
+  data-theme="coffee"
+>
+  <NavBar />
+  <div class="flex flex-row flex-1 min-h-0">
+    <Sidebar />
+    <main class="flex-1 overflow-y-auto min-h-0">
+      <slot />
+    </main>
+  </div>
+  <Footer />
+</div>
+
+<svelte:head>
+  <title>PluralKit | {$page.data?.meta?.title ?? "Home"}</title>
+  <meta
+    property="og:title"
+    content={`PluralKit | ${$page.data?.meta?.ogTitle ?? "Web Dashboard"}`}
+  />
+  <meta property="theme-color" content={`#${$page.data?.meta?.color ?? "da9317"}`} />
+  <meta
+    property="og:description"
+    content={$page.data?.meta?.ogDescription ?? "PluralKit's official dashboard."}
+  />
+</svelte:head>

docs/src/routes/[...slug]/+page.svelte

@@ -0,0 +1,7 @@
+<script>
+    let { data } = $props();
+</script>
+
+<div class="max-w-full bg-base-200 prose">
+    <div class="m-5" style="max-width: 900px"><data.PageContent /></div>
+</div>

docs/src/routes/[...slug]/+page.ts

@@ -0,0 +1,16 @@
+import { error } from '@sveltejs/kit';
+
+const pages = import.meta.glob('/content/**/*.md', { eager: true }) as Record<string, { default: unknown }>;
+
+export async function load({ params }) {
+    const slug = params.slug || 'index';
+
+    const page = pages[`/content/${slug}.md`] || pages[`/content/${slug}/index.md`];
+    if (!page) {
+        throw error(404, `Page not found: ${slug}`);
+    }
+
+    return {
+        PageContent: page.default
+    };
+}

docs/src/routes/layout.css

@@ -0,0 +1 @@
+@import 'tailwindcss';

docs/svelte.config.js

@@ -0,0 +1,26 @@
+import adapter from '@sveltejs/adapter-node';
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+import { mdsvex } from 'mdsvex';
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+	// Consult https://svelte.dev/docs/kit/integrations
+	// for more information about preprocessors
+	preprocess: [
+		mdsvex({
+			extensions: [".md"]
+		}),
+		vitePreprocess(),
+	],
+	extensions: [".svelte", ".md"],
+
+	kit: {
+		adapter: adapter(),
+		alias: {
+			$components: "src/components",
+			$lib: "src/lib",
+		}
+	}
+};
+
+export default config;

docs/tailwind.config.js

@@ -0,0 +1,113 @@
+import daisyui from "daisyui"
+import typography from "@tailwindcss/typography"
+import { light, dark, night, autumn, coffee, halloween, pastel } from "daisyui/src/theming/themes"
+
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: ["./src/**/*.{html,js,svelte,ts}"],
+  plugins: [typography, daisyui],
+  theme: {
+    extend: {
+      colors: {
+        muted: "oklch(var(--muted) / <alpha-value>)",
+      },
+    },
+  },
+  daisyui: {
+    themes: [
+      {
+        // cool light
+        light: {
+          ...light,
+          primary: "#da9317",
+          secondary: "#9e66ff",
+          accent: "#22ded8",
+          // DARK BUTTONS
+          /* 
+          "--muted": "69.38% 0.01 252.85",
+          "base-200": "#ededed",
+          "base-300": "#e1e3e3",
+          "primary-content": "#090101",
+          "neutral-content": "#f9fcff",
+          "base-content": "10161e",
+          "secondary-content": "fafafa"
+          */
+          // LIGHT BUTTONS
+          "--muted": "59.37% 0.01 252.85",
+          "base-200": "#ededed",
+          "base-300": "#e5e7e7",
+          "primary-content": "#090101",
+          neutral: "#f8f8f8",
+          "neutral-content": "#040507",
+          "base-content": "10161e",
+          "secondary-content": "#090101",
+        },
+        // cool dark
+        dark: {
+          ...dark,
+          primary: "#da9317",
+          secondary: "#ae81fc",
+          accent: "#6df1fc",
+          "--muted": "59.37% 0.0117 254.07",
+          "base-100": "#22262b",
+          "base-200": "#191c1f",
+          "base-300": "#17191b",
+          "base-content": "#ced3dc",
+          neutral: "#33383e",
+          "neutral-content": "#e1e2e3",
+        },
+        // bright dark
+        acid: {
+          ...night,
+          primary: "#49c701",
+          secondary: "#00c6cf",
+          accent: "#f29838",
+          "base-100": "#1a2433",
+          "base-200": "#101a27",
+          "base-300": "#111724",
+          neutral: "#242e41",
+          "--muted": "60.8% 0.05 272",
+        },
+        // bright light (trans rights!)
+        cotton: {
+          ...pastel,
+          primary: "#ff69a8",
+          secondary: "#63a7f9",
+          accent: "#f8b939",
+          neutral: "#f8f8f8",
+          "base-200": "#eeecf1",
+          "base-300": "#e2e1e7",
+          "--muted": "59% 0.01 252.85",
+          "--rounded-btn": "0.5rem",
+        },
+        // warm light
+        autumn: {
+          ...autumn,
+          primary: "#e38010",
+          success: "#2c7866",
+          "success-content": "#eeeeee",
+          error: "#97071a",
+          "error-content": "#eeeeee",
+          neutral: "#ebebeb",
+          "neutral-content": "#141414",
+          "base-100": "#fcfcfc",
+          "--muted": "67.94% 0.01 39.18",
+        },
+        // warm dark
+        coffee: {
+          ...halloween,
+          secondary: "#bc4b2b",
+          accent: coffee.accent,
+          primary: coffee.primary,
+          info: "#3499c0",
+          neutral: "#120f12",
+          "neutral-content": "#dfe0de",
+          "base-200": "#1a1a1a",
+          "base-300": "#181818",
+          "base-content": "#d9dbd8",
+          "--muted": "57.65% 0 54",
+        },
+      },
+    ],
+  },
+}

docs/tsconfig.json

@@ -0,0 +1,20 @@
+{
+	"extends": "./.svelte-kit/tsconfig.json",
+	"compilerOptions": {
+		"rewriteRelativeImportExtensions": true,
+		"allowJs": true,
+		"checkJs": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"sourceMap": true,
+		"strict": true,
+		"moduleResolution": "bundler"
+	}
+	// Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
+	// except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
+	//
+	// To make changes to top-level options such as include and exclude, we recommend extending
+	// the generated config; see https://svelte.dev/docs/kit/configuration#typescript
+}

docs/vite.config.ts

@@ -0,0 +1,18 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { mdsvex } from 'mdsvex';
+import { defineConfig } from 'vite';
+
+import { execSync } from "node:child_process"
+const hash = execSync("git rev-parse --short HEAD").toString().trim()
+
+export default defineConfig({
+  plugins: [sveltekit(), mdsvex({ extension: ".md" })],
+  server: {
+    fs: {
+        allow: ["."]
+    }
+  },
+  define: {
+    __COMMIT_HASH__: JSON.stringify("_" + hash),
+  },
+})