Lucas RayanandClaude Opus 5
0fcdd15b58
The autosave I had just added appended a new message on every debounce, so a few minutes of typing would have left the Drafts folder holding a dozen copies of the same unfinished mail. Caught before deploying. The composer now returns the stored UID and sends it back as replace_uid on the next save; the use case expunges the superseded draft, but only after the replacement has committed, so a failure leaves the older draft in place rather than losing both. Expunge is a soft delete matching the expunged_at column the schema already uses, and it locates the message by mailbox as well as UID so a caller cannot delete someone else's mail by guessing a number. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
67 lines
2.6 KiB
Go
67 lines
2.6 KiB
Go
package port
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/google/uuid"
|
|
)
|
|
|
|
// WebmailFolder is a folder as the message list shows it.
|
|
type WebmailFolder struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
SpecialUse string `json:"special_use"`
|
|
UnreadCount int `json:"unread_count"`
|
|
TotalCount int `json:"total_count"`
|
|
}
|
|
|
|
// WebmailMessage is one row of the message list.
|
|
//
|
|
// This is a read model projected straight from SQL rather than a hydrated
|
|
// aggregate, which is the CQRS exception PLAN.md section 2 carves out for
|
|
// webmail reads.
|
|
type WebmailMessage struct {
|
|
UID uint32 `json:"uid"`
|
|
Subject string `json:"subject"`
|
|
SenderAddress string `json:"sender_address"`
|
|
FromName string `json:"from_display_name"`
|
|
Snippet string `json:"snippet"`
|
|
SizeBytes int64 `json:"size_bytes"`
|
|
ReceivedAt time.Time `json:"received_at"`
|
|
HasAttachments bool `json:"has_attachments"`
|
|
Seen bool `json:"seen"`
|
|
Flagged bool `json:"flagged"`
|
|
Answered bool `json:"answered"`
|
|
SpamVerdict string `json:"spam_verdict"`
|
|
DmarcResult string `json:"dmarc_result"`
|
|
}
|
|
|
|
// WebmailMessageBody carries what is needed to render one message.
|
|
type WebmailMessageBody struct {
|
|
UID uint32 `json:"uid"`
|
|
BlobID uuid.UUID `json:"-"`
|
|
Raw []byte `json:"-"`
|
|
}
|
|
|
|
// WebmailRepository serves the webmail's read side.
|
|
//
|
|
// Every method takes the authenticated mailbox ID and scopes its query to it.
|
|
// Taking only a folder or a UID would let one account read another's mail by
|
|
// guessing an identifier, so the ownership check lives in the SQL rather than
|
|
// in the caller.
|
|
type WebmailRepository interface {
|
|
FindMailboxIDByAddress(ctx context.Context, address string) (string, error)
|
|
ListFolders(ctx context.Context, mailboxID string) ([]WebmailFolder, error)
|
|
// ListMessages returns the folder's messages newest first. search, when
|
|
// non-empty, filters on subject, sender and snippet.
|
|
ListMessages(ctx context.Context, mailboxID, folderName, search string, limit, offset int) ([]WebmailMessage, error)
|
|
// GetMessageBlob resolves one message to its stored blob, or returns
|
|
// ErrMessageNotFound when it does not belong to this mailbox.
|
|
GetMessageBlob(ctx context.Context, mailboxID, folderName string, uid uint32) (uuid.UUID, error)
|
|
// MarkSeen records that the user opened the message.
|
|
MarkSeen(ctx context.Context, mailboxID, folderName string, uid uint32, seen bool) error
|
|
// Expunge soft-deletes one message, keeping the folder counters in step.
|
|
Expunge(ctx context.Context, mailboxID, folderName string, uid uint32) error
|
|
}
|