gogcli/internal/cmd/gmail_thread.go
2025-12-31 13:08:27 +01:00

349 lines
9.2 KiB
Go

package cmd
import (
"encoding/base64"
"errors"
"fmt"
"net/url"
"os"
"path/filepath"
"strings"
"github.com/spf13/cobra"
"github.com/steipete/gogcli/internal/outfmt"
"github.com/steipete/gogcli/internal/ui"
"google.golang.org/api/gmail/v1"
)
func newGmailThreadCmd(flags *rootFlags) *cobra.Command {
cmd := &cobra.Command{
Use: "thread",
Short: "Thread operations (get, modify)",
}
cmd.AddCommand(newGmailThreadGetCmd(flags))
cmd.AddCommand(newGmailThreadModifyCmd(flags))
return cmd
}
func newGmailThreadGetCmd(flags *rootFlags) *cobra.Command {
var download bool
var outDir string
cmd := &cobra.Command{
Use: "get <threadId>",
Short: "Get a thread with all messages (optionally download attachments)",
Args: cobra.ExactArgs(1),
RunE: func(cmd *cobra.Command, args []string) error {
u := ui.FromContext(cmd.Context())
account, err := requireAccount(flags)
if err != nil {
return err
}
threadID := args[0]
svc, err := newGmailService(cmd.Context(), account)
if err != nil {
return err
}
thread, err := svc.Users.Threads.Get("me", threadID).Format("full").Context(cmd.Context()).Do()
if err != nil {
return err
}
var attachDir string
if download {
if strings.TrimSpace(outDir) == "" {
// Default: current directory, not gogcli config dir.
attachDir = "."
} else {
attachDir = filepath.Clean(outDir)
}
}
if outfmt.IsJSON(cmd.Context()) {
type downloaded struct {
MessageID string `json:"messageId"`
AttachmentID string `json:"attachmentId"`
Filename string `json:"filename"`
MimeType string `json:"mimeType,omitempty"`
Size int64 `json:"size,omitempty"`
Path string `json:"path"`
Cached bool `json:"cached"`
DownloadError string `json:"error,omitempty"`
}
downloadedFiles := make([]downloaded, 0)
if download && thread != nil {
for _, msg := range thread.Messages {
if msg == nil || msg.Id == "" {
continue
}
for _, a := range collectAttachments(msg.Payload) {
outPath, cached, err := downloadAttachment(cmd, svc, msg.Id, a, attachDir)
if err != nil {
return err
}
df := downloaded{
MessageID: msg.Id,
AttachmentID: a.AttachmentID,
Filename: a.Filename,
MimeType: a.MimeType,
Size: a.Size,
Path: outPath,
Cached: cached,
}
downloadedFiles = append(downloadedFiles, df)
}
}
}
return outfmt.WriteJSON(os.Stdout, map[string]any{
"thread": thread,
"downloaded": downloadedFiles,
})
}
if thread == nil || len(thread.Messages) == 0 {
u.Err().Println("Empty thread")
return nil
}
for _, msg := range thread.Messages {
if msg == nil {
continue
}
u.Out().Printf("Message: %s", msg.Id)
u.Out().Printf("From: %s", headerValue(msg.Payload, "From"))
u.Out().Printf("To: %s", headerValue(msg.Payload, "To"))
u.Out().Printf("Subject: %s", headerValue(msg.Payload, "Subject"))
u.Out().Printf("Date: %s", headerValue(msg.Payload, "Date"))
u.Out().Println("")
body := bestBodyText(msg.Payload)
if body != "" {
u.Out().Println(body)
u.Out().Println("")
}
attachments := collectAttachments(msg.Payload)
if len(attachments) > 0 {
u.Out().Println("Attachments:")
for _, a := range attachments {
u.Out().Printf(" - %s (%d bytes)", a.Filename, a.Size)
}
u.Out().Println("")
}
if download && len(attachments) > 0 {
for _, a := range attachments {
outPath, cached, err := downloadAttachment(cmd, svc, msg.Id, a, attachDir)
if err != nil {
return err
}
if cached {
u.Out().Printf("Cached: %s", outPath)
} else {
u.Out().Successf("Saved: %s", outPath)
}
}
u.Out().Println("")
}
}
return nil
},
}
cmd.Flags().BoolVar(&download, "download", false, "Download attachments")
cmd.Flags().StringVar(&outDir, "out-dir", "", "Directory to write attachments to (default: current directory)")
return cmd
}
func newGmailThreadModifyCmd(flags *rootFlags) *cobra.Command {
var add string
var remove string
cmd := &cobra.Command{
Use: "modify <threadId>",
Short: "Modify labels on all messages in a thread",
Long: `Modify labels on all messages within a thread. This applies the label changes
to every message in the conversation, which is useful for archiving or categorizing
entire email threads at once.
Examples:
gog gmail thread modify abc123 --add "Work,Important"
gog gmail thread modify abc123 --remove INBOX --add "Archive"
gog gmail thread modify abc123 --add STARRED`,
Args: cobra.ExactArgs(1),
RunE: func(cmd *cobra.Command, args []string) error {
u := ui.FromContext(cmd.Context())
account, err := requireAccount(flags)
if err != nil {
return err
}
threadID := args[0]
addLabels := splitCSV(add)
removeLabels := splitCSV(remove)
if len(addLabels) == 0 && len(removeLabels) == 0 {
return usage("must specify --add and/or --remove")
}
svc, err := newGmailService(cmd.Context(), account)
if err != nil {
return err
}
// Resolve label names to IDs
idMap, err := fetchLabelNameToID(svc)
if err != nil {
return err
}
addIDs := resolveLabelIDs(addLabels, idMap)
removeIDs := resolveLabelIDs(removeLabels, idMap)
// Use Gmail's Threads.Modify API
_, err = svc.Users.Threads.Modify("me", threadID, &gmail.ModifyThreadRequest{
AddLabelIds: addIDs,
RemoveLabelIds: removeIDs,
}).Context(cmd.Context()).Do()
if err != nil {
return err
}
if outfmt.IsJSON(cmd.Context()) {
return outfmt.WriteJSON(os.Stdout, map[string]any{
"modified": threadID,
"addedLabels": addIDs,
"removedLabels": removeIDs,
})
}
u.Out().Printf("Modified thread %s", threadID)
return nil
},
}
cmd.Flags().StringVar(&add, "add", "", "Labels to add (comma-separated, name or ID)")
cmd.Flags().StringVar(&remove, "remove", "", "Labels to remove (comma-separated, name or ID)")
return cmd
}
func newGmailURLCmd(flags *rootFlags) *cobra.Command {
return &cobra.Command{
Use: "url <threadIds...>",
Short: "Print Gmail web URLs for threads",
Args: cobra.MinimumNArgs(1),
RunE: func(cmd *cobra.Command, args []string) error {
u := ui.FromContext(cmd.Context())
account, err := requireAccount(flags)
if err != nil {
return err
}
if outfmt.IsJSON(cmd.Context()) {
urls := make([]map[string]string, 0, len(args))
for _, id := range args {
urls = append(urls, map[string]string{
"id": id,
"url": fmt.Sprintf("https://mail.google.com/mail/?authuser=%s#all/%s", url.QueryEscape(account), id),
})
}
return outfmt.WriteJSON(os.Stdout, map[string]any{"urls": urls})
}
for _, id := range args {
url := fmt.Sprintf("https://mail.google.com/mail/?authuser=%s#all/%s", url.QueryEscape(account), id)
u.Out().Printf("%s\t%s", id, url)
}
return nil
},
}
}
type attachmentInfo struct {
Filename string
Size int64
MimeType string
AttachmentID string
}
func collectAttachments(p *gmail.MessagePart) []attachmentInfo {
if p == nil {
return nil
}
var out []attachmentInfo
if p.Filename != "" && p.Body != nil && p.Body.AttachmentId != "" {
out = append(out, attachmentInfo{
Filename: p.Filename,
Size: p.Body.Size,
MimeType: p.MimeType,
AttachmentID: p.Body.AttachmentId,
})
}
for _, part := range p.Parts {
out = append(out, collectAttachments(part)...)
}
return out
}
func bestBodyText(p *gmail.MessagePart) string {
if p == nil {
return ""
}
plain := findPartBody(p, "text/plain")
if plain != "" {
return plain
}
html := findPartBody(p, "text/html")
return html
}
func findPartBody(p *gmail.MessagePart, mimeType string) string {
if p == nil {
return ""
}
if p.MimeType == mimeType && p.Body != nil && p.Body.Data != "" {
s, err := decodeBase64URL(p.Body.Data)
if err == nil {
return s
}
}
for _, part := range p.Parts {
if s := findPartBody(part, mimeType); s != "" {
return s
}
}
return ""
}
func decodeBase64URL(s string) (string, error) {
b, err := base64.RawURLEncoding.DecodeString(s)
if err != nil {
return "", err
}
return string(b), nil
}
func downloadAttachment(cmd *cobra.Command, svc *gmail.Service, messageID string, a attachmentInfo, dir string) (string, bool, error) {
if strings.TrimSpace(messageID) == "" || strings.TrimSpace(a.AttachmentID) == "" {
return "", false, errors.New("missing messageID/attachmentID")
}
if strings.TrimSpace(dir) == "" {
dir = "."
}
shortID := a.AttachmentID
if len(shortID) > 8 {
shortID = shortID[:8]
}
// Sanitize filename to prevent path traversal attacks
safeFilename := filepath.Base(a.Filename)
if safeFilename == "" || safeFilename == "." || safeFilename == ".." {
safeFilename = "attachment"
}
filename := fmt.Sprintf("%s_%s_%s", messageID, shortID, safeFilename)
outPath := filepath.Join(dir, filename)
path, cached, _, err := downloadAttachmentToPath(cmd, svc, messageID, a.AttachmentID, outPath, a.Size)
if err != nil {
return "", false, err
}
return path, cached, nil
}