feat(mails): add Workspace mail CLI with pagination and parsed from fields

Manage the OnlyOffice Mail addon via oo mails using existing ONLYOFFICE_* creds,
with automatic page fetching past the 25-message API cap and fromName/fromAddress columns.

Co-authored-by: Cursor <cursoragent@cursor.com>

mails_test.go

@@ -0,0 +1,72 @@
+package onlyoffice
+
+import "testing"
+
+func TestResolveMailFolder(t *testing.T) {
+	tests := []struct {
+		in   string
+		want int
+		err  bool
+	}{
+		{"", MailFolderInbox, false},
+		{"inbox", MailFolderInbox, false},
+		{"SENT", MailFolderSent, false},
+		{"4", MailFolderTrash, false},
+		{"nope", 0, true},
+	}
+	for _, tc := range tests {
+		got, err := ResolveMailFolder(tc.in)
+		if tc.err {
+			if err == nil {
+				t.Fatalf("%q: expected error", tc.in)
+			}
+			continue
+		}
+		if err != nil || got != tc.want {
+			t.Fatalf("%q: got %d err=%v", tc.in, got, err)
+		}
+	}
+}
+
+func TestMailMessagesPath(t *testing.T) {
+	path := mailMessagesPath(MailMessagesFilter{Folder: 1}, 1, 10)
+	if path != "/api/2.0/mail/messages?count=10&folder=1" {
+		t.Fatalf("page 1: got %q", path)
+	}
+	path = mailMessagesPath(MailMessagesFilter{Folder: 1}, 3, 25)
+	if path != "/api/2.0/mail/messages?count=25&folder=1&page=3" {
+		t.Fatalf("page 3: got %q", path)
+	}
+}
+
+func TestParseMailAddress(t *testing.T) {
+	tests := []struct {
+		raw          string
+		wantName     string
+		wantAddress  string
+	}{
+		{`"LinkedIn Jobbenachrichtigungen" <jobalerts-noreply@linkedin.com>`, "LinkedIn Jobbenachrichtigungen", "jobalerts-noreply@linkedin.com"},
+		{`"Bitfinex" <no-reply@bitfinex.com>`, "Bitfinex", "no-reply@bitfinex.com"},
+		{"eslider@gmail.com", "", "eslider@gmail.com"},
+		{`"Glassdoor-Jobs" <noreply@glassdoor.com>`, "Glassdoor-Jobs", "noreply@glassdoor.com"},
+		{"", "", ""},
+	}
+	for _, tc := range tests {
+		name, addr := ParseMailAddress(tc.raw)
+		if name != tc.wantName || addr != tc.wantAddress {
+			t.Fatalf("%q: got name=%q addr=%q", tc.raw, name, addr)
+		}
+	}
+}
+
+func TestMailMessagesAsTableRows(t *testing.T) {
+	msgs := []map[string]any{{
+		"id": float64(42), "subject": "Hi",
+		"from": `"Acme" <a@b.com>`,
+		"date": "today", "folder": float64(1), "size": float64(100), "isNew": true,
+	}}
+	rows := MailMessagesAsTableRows(msgs)
+	if rows[0]["id"] != "42" || rows[0]["fromName"] != "Acme" || rows[0]["fromAddress"] != "a@b.com" {
+		t.Fatalf("got %+v", rows[0])
+	}
+}