From 1c03ea14a3b0fb6b49be1e8affc3a8aab4327710 Mon Sep 17 00:00:00 2001
From: Virgil <virgil@lethean.io>
Date: Thu, 2 Apr 2026 00:25:15 +0000
Subject: [PATCH] feat(users): add user settings endpoints

Co-Authored-By: Virgil <virgil@lethean.io>
---
 users.go      | 18 +++++++++++++
 users_test.go | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 92 insertions(+)

diff --git a/users.go b/users.go
index d77d81d..8aa9ac0 100644
--- a/users.go
+++ b/users.go
@@ -34,6 +34,24 @@ func (s *UserService) GetCurrent(ctx context.Context) (*types.User, error) {
 	return &out, nil
 }
 
+// GetSettings returns the authenticated user's settings.
+func (s *UserService) GetSettings(ctx context.Context) (*types.UserSettings, error) {
+	var out types.UserSettings
+	if err := s.client.Get(ctx, "/api/v1/user/settings", &out); err != nil {
+		return nil, err
+	}
+	return &out, nil
+}
+
+// UpdateSettings updates the authenticated user's settings.
+func (s *UserService) UpdateSettings(ctx context.Context, opts *types.UserSettingsOptions) (*types.UserSettings, error) {
+	var out types.UserSettings
+	if err := s.client.Patch(ctx, "/api/v1/user/settings", opts, &out); err != nil {
+		return nil, err
+	}
+	return &out, nil
+}
+
 // ListEmails returns all email addresses for the authenticated user.
 func (s *UserService) ListEmails(ctx context.Context) ([]types.Email, error) {
 	return ListAll[types.Email](ctx, s.client, "/api/v1/user/emails", nil)
diff --git a/users_test.go b/users_test.go
index 9ea1dc1..7b2116b 100644
--- a/users_test.go
+++ b/users_test.go
@@ -54,6 +54,80 @@ func TestUserService_GetCurrent_Good(t *testing.T) {
 	}
 }
 
+func TestUserService_GetSettings_Good(t *testing.T) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodGet {
+			t.Errorf("expected GET, got %s", r.Method)
+		}
+		if r.URL.Path != "/api/v1/user/settings" {
+			t.Errorf("wrong path: %s", r.URL.Path)
+		}
+		json.NewEncoder(w).Encode(types.UserSettings{
+			FullName:    "Alice",
+			Language:    "en-US",
+			Theme:       "forgejo-auto",
+			HideEmail:   true,
+			Pronouns:    "she/her",
+			Website:     "https://example.com",
+			Location:    "Earth",
+			Description: "maintainer",
+		})
+	}))
+	defer srv.Close()
+
+	f := NewForge(srv.URL, "tok")
+	settings, err := f.Users.GetSettings(context.Background())
+	if err != nil {
+		t.Fatal(err)
+	}
+	if settings.FullName != "Alice" {
+		t.Errorf("got full name=%q, want %q", settings.FullName, "Alice")
+	}
+	if !settings.HideEmail {
+		t.Errorf("got hide_email=%v, want true", settings.HideEmail)
+	}
+}
+
+func TestUserService_UpdateSettings_Good(t *testing.T) {
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodPatch {
+			t.Errorf("expected PATCH, got %s", r.Method)
+		}
+		if r.URL.Path != "/api/v1/user/settings" {
+			t.Errorf("wrong path: %s", r.URL.Path)
+		}
+		var body types.UserSettingsOptions
+		if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
+			t.Fatal(err)
+		}
+		if body.FullName != "Alice" || !body.HideEmail || body.Theme != "forgejo-auto" {
+			t.Fatalf("unexpected body: %+v", body)
+		}
+		json.NewEncoder(w).Encode(types.UserSettings{
+			FullName:  body.FullName,
+			HideEmail: body.HideEmail,
+			Theme:     body.Theme,
+		})
+	}))
+	defer srv.Close()
+
+	f := NewForge(srv.URL, "tok")
+	settings, err := f.Users.UpdateSettings(context.Background(), &types.UserSettingsOptions{
+		FullName:  "Alice",
+		HideEmail: true,
+		Theme:     "forgejo-auto",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if settings.FullName != "Alice" {
+		t.Errorf("got full name=%q, want %q", settings.FullName, "Alice")
+	}
+	if !settings.HideEmail {
+		t.Errorf("got hide_email=%v, want true", settings.HideEmail)
+	}
+}
+
 func TestUserService_ListEmails_Good(t *testing.T) {
 	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		if r.Method != http.MethodGet {