memos/server/router/api/v1/memo_attachment_service.go
2026-08-20 23:37:02 +08:00

458 lines
15 KiB
Go

package v1
import (
"context"
stderrors "errors"
"net/url"
"slices"
"strings"
"time"
"google.golang.org/grpc/codes"
"google.golang.org/grpc/status"
"google.golang.org/protobuf/types/known/emptypb"
"github.com/usememos/memos/internal/markdown"
v1pb "github.com/usememos/memos/proto/gen/api/v1"
storepb "github.com/usememos/memos/proto/gen/store"
"github.com/usememos/memos/store"
)
func (s *APIV1Service) SetMemoAttachments(ctx context.Context, request *v1pb.SetMemoAttachmentsRequest) (*emptypb.Empty, error) {
user, err := s.fetchCurrentUser(ctx)
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to get current user: %v", err)
}
if user == nil {
return nil, status.Errorf(codes.Unauthenticated, "user not authenticated")
}
memoUID, err := ExtractMemoUIDFromName(request.Name)
if err != nil {
return nil, status.Errorf(codes.InvalidArgument, "invalid memo name: %v", err)
}
memo, err := s.Store.GetMemo(ctx, &store.FindMemo{UID: &memoUID})
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to get memo")
}
if memo == nil {
return nil, status.Errorf(codes.NotFound, "memo not found")
}
if !canModifyMemo(user, memo) {
return nil, status.Errorf(codes.PermissionDenied, "permission denied")
}
prepared, err := s.prepareMemoAttachments(ctx, user, memo, request.Attachments)
if err != nil {
return nil, err
}
requiredAttachmentIDs, err := s.resolveMemoAttachmentReferences(memo.Content, prepared.normalized)
if err != nil {
return nil, err
}
updatedTs := time.Now().Unix()
if err := s.applyMemoMutation(ctx, memo, prepared, &store.UpdateMemo{ID: memo.ID, UpdatedTs: &updatedTs}, requiredAttachmentIDs, nil); err != nil {
return nil, err
}
updatedMemo, parentMemo, memoMessage, err := s.buildUpdatedMemoState(ctx, memo.ID)
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to build updated memo state")
}
s.dispatchMemoUpdatedSideEffects(ctx, updatedMemo, parentMemo, memoMessage)
return &emptypb.Empty{}, nil
}
type preparedMemoAttachments struct {
current []*store.Attachment
normalized []*store.Attachment
removed []*store.Attachment
}
func (s *APIV1Service) prepareMemoAttachments(
ctx context.Context,
user *store.User,
memo *store.Memo,
requestAttachments []*v1pb.Attachment,
) (*preparedMemoAttachments, error) {
currentAttachments, err := s.Store.ListAttachments(ctx, &store.FindAttachment{
MemoID: &memo.ID,
})
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to list attachments")
}
normalizedAttachments, err := s.normalizeMemoAttachmentRequest(ctx, memo, currentAttachments, requestAttachments)
if err != nil {
return nil, err
}
requestedIDs := make(map[int32]bool, len(normalizedAttachments))
for _, attachment := range normalizedAttachments {
requestedIDs[attachment.ID] = true
}
removedAttachments := make([]*store.Attachment, 0)
for _, attachment := range currentAttachments {
if !requestedIDs[attachment.ID] {
if attachment.CreatorID != memo.CreatorID {
return nil, status.Errorf(codes.FailedPrecondition, "cannot remove another user's attachment from this memo")
}
if attachment.CreatorID != user.ID && !isSuperUser(user) {
return nil, status.Errorf(codes.PermissionDenied, "cannot remove another user's attachment")
}
removedAttachments = append(removedAttachments, attachment)
}
}
return &preparedMemoAttachments{
current: currentAttachments,
normalized: normalizedAttachments,
removed: removedAttachments,
}, nil
}
func (s *APIV1Service) applyMemoMutation(
ctx context.Context,
memo *store.Memo,
prepared *preparedMemoAttachments,
memoUpdate *store.UpdateMemo,
requiredAttachmentIDs []int32,
referenceRelations *[]*store.MemoRelation,
) error {
if prepared == nil {
prepared = &preparedMemoAttachments{}
}
currentIDs := make(map[int32]struct{}, len(prepared.current))
for _, attachment := range prepared.current {
currentIDs[attachment.ID] = struct{}{}
}
normalizedAttachments := slices.Clone(prepared.normalized)
slices.Reverse(normalizedAttachments)
bindings := make([]*store.MemoAttachmentBinding, 0, len(normalizedAttachments))
for index, attachment := range normalizedAttachments {
updatedTs := time.Now().Unix() + int64(index)
_, wasBoundToMemo := currentIDs[attachment.ID]
bindings = append(bindings, &store.MemoAttachmentBinding{
ID: attachment.ID,
UID: attachment.UID,
UpdatedTs: updatedTs,
WasBoundToMemo: wasBoundToMemo,
})
}
slices.SortFunc(bindings, func(a, b *store.MemoAttachmentBinding) int {
if a.ID < b.ID {
return -1
}
if a.ID > b.ID {
return 1
}
return 0
})
removedAttachmentIDs := make([]int32, 0, len(prepared.removed))
for _, attachment := range prepared.removed {
removedAttachmentIDs = append(removedAttachmentIDs, attachment.ID)
}
if referenceRelations != nil {
relations := make([]*store.MemoRelation, 0, len(*referenceRelations))
for _, relation := range *referenceRelations {
relations = append(relations, &store.MemoRelation{
MemoID: memo.ID,
RelatedMemoID: relation.RelatedMemoID,
Type: relation.Type,
})
}
referenceRelations = &relations
}
mutation := &store.MemoMutation{
MemoID: memo.ID,
MemoCreatorID: memo.CreatorID,
ExpectedMemoContent: memo.Content,
MemoUpdate: memoUpdate,
Bindings: bindings,
RemovedAttachmentIDs: removedAttachmentIDs,
RequiredAttachmentIDs: requiredAttachmentIDs,
ReplaceReferenceRelations: referenceRelations != nil,
}
if referenceRelations != nil {
mutation.ReferenceRelations = *referenceRelations
}
if err := s.Store.ApplyMemoMutation(ctx, mutation); err != nil {
if stderrors.Is(err, store.ErrMemoMutationConflict) {
return status.Errorf(codes.FailedPrecondition, "memo state changed: %v", err)
}
return status.Errorf(codes.Internal, "failed to apply memo mutation: %v", err)
}
// Rows are detached in the transaction above. Delete storage one at a time so
// local cleanup remains storage-first; on failure the unlinked row remains and
// the owner can safely retry deletion.
for _, attachment := range prepared.removed {
if err := s.Store.DeleteAttachment(ctx, &store.DeleteAttachment{ID: attachment.ID}); err != nil {
return status.Errorf(codes.Internal, "failed to delete attachment: %v", err)
}
}
return nil
}
func (s *APIV1Service) normalizeMemoAttachmentRequest(
ctx context.Context,
memo *store.Memo,
currentAttachments []*store.Attachment,
requestAttachments []*v1pb.Attachment,
) ([]*store.Attachment, error) {
currentByID := make(map[int32]struct{}, len(currentAttachments))
for _, attachment := range currentAttachments {
currentByID[attachment.ID] = struct{}{}
}
requestedAttachments := make([]*store.Attachment, 0, len(requestAttachments))
for _, requestAttachment := range requestAttachments {
if requestAttachment == nil {
return nil, status.Errorf(codes.InvalidArgument, "attachment is required")
}
attachmentUID, err := ExtractAttachmentUIDFromName(requestAttachment.Name)
if err != nil {
return nil, status.Errorf(codes.InvalidArgument, "invalid attachment name: %v", err)
}
attachment, err := s.Store.GetAttachment(ctx, &store.FindAttachment{UID: &attachmentUID})
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to get attachment: %v", err)
}
if attachment == nil {
return nil, status.Errorf(codes.NotFound, "attachment not found: %s", attachmentUID)
}
_, alreadyInTarget := currentByID[attachment.ID]
if attachment.CreatorID != memo.CreatorID && !alreadyInTarget {
// Hide another user's unlinked or foreign-memo attachment from the
// caller. Admin status grants memo maintenance privileges, not the
// right to transfer attachment ownership into a different account.
return nil, status.Errorf(codes.NotFound, "attachment not found: %s", attachmentUID)
}
if attachment.MemoID != nil && !alreadyInTarget {
return nil, status.Errorf(codes.FailedPrecondition, "attachment %s is already bound to another memo", attachmentUID)
}
requestedAttachments = append(requestedAttachments, attachment)
}
currentGroups := make(map[string][]*store.Attachment)
for _, attachment := range currentAttachments {
motion := getAttachmentMotionMedia(attachment)
if motion == nil || motion.GroupId == "" {
continue
}
currentGroups[motion.GroupId] = append(currentGroups[motion.GroupId], attachment)
}
requestGroups := make(map[string][]*store.Attachment)
requestNamesByGroup := make(map[string]map[string]bool)
for _, attachment := range requestedAttachments {
motion := getAttachmentMotionMedia(attachment)
if motion == nil || motion.GroupId == "" {
continue
}
requestGroups[motion.GroupId] = append(requestGroups[motion.GroupId], attachment)
if requestNamesByGroup[motion.GroupId] == nil {
requestNamesByGroup[motion.GroupId] = make(map[string]bool)
}
requestNamesByGroup[motion.GroupId][attachment.UID] = true
}
normalized := make([]*store.Attachment, 0, len(requestedAttachments))
appendedGroups := make(map[string]bool)
appendedAttachments := make(map[string]bool)
for _, attachment := range requestedAttachments {
motion := getAttachmentMotionMedia(attachment)
if motion == nil || motion.GroupId == "" {
if !appendedAttachments[attachment.UID] {
normalized = append(normalized, attachment)
appendedAttachments[attachment.UID] = true
}
continue
}
groupID := motion.GroupId
if appendedGroups[groupID] {
continue
}
currentGroup := currentGroups[groupID]
if isMultiMemberMotionGroup(currentGroup) && !allGroupMembersRequested(currentGroup, requestNamesByGroup[groupID]) {
appendedGroups[groupID] = true
continue
}
for _, groupAttachment := range requestGroups[groupID] {
if appendedAttachments[groupAttachment.UID] {
continue
}
normalized = append(normalized, groupAttachment)
appendedAttachments[groupAttachment.UID] = true
}
appendedGroups[groupID] = true
}
return normalized, nil
}
func (s *APIV1Service) resolveMemoAttachmentReferences(content string, attachments []*store.Attachment) ([]int32, error) {
references, err := s.extractManagedAttachmentReferences(content)
if err != nil {
return nil, err
}
attachmentsByUID := make(map[string]*store.Attachment, len(attachments))
for _, attachment := range attachments {
attachmentsByUID[attachment.UID] = attachment
}
requiredAttachmentIDs := make([]int32, 0, len(references))
for _, reference := range references {
attachment := attachmentsByUID[reference.UID]
if attachment == nil {
return nil, status.Errorf(codes.FailedPrecondition, "managed image attachment %s must be bound to the memo", reference.UID)
}
if !strings.HasPrefix(strings.ToLower(attachment.Type), "image/") {
return nil, status.Errorf(codes.InvalidArgument, "managed image attachment %s must have an image MIME type", reference.UID)
}
if attachment.StorageType == storepb.AttachmentStorageType_EXTERNAL {
return nil, status.Errorf(codes.InvalidArgument, "external attachment %s cannot be used as a managed memo image", reference.UID)
}
requiredAttachmentIDs = append(requiredAttachmentIDs, attachment.ID)
}
return requiredAttachmentIDs, nil
}
func (s *APIV1Service) extractManagedAttachmentReferences(content string) ([]markdown.ManagedAttachmentReference, error) {
data, err := s.MarkdownService.ExtractAll([]byte(content))
if err != nil {
return nil, status.Errorf(codes.InvalidArgument, "invalid markdown content: %v", err)
}
if len(data.InvalidManagedAttachmentReferences) > 0 {
return nil, status.Errorf(codes.InvalidArgument, "invalid managed attachment image URL: %s", data.InvalidManagedAttachmentReferences[0])
}
references := slices.Clone(data.ManagedAttachmentReferences)
instanceURLString := ""
if s.Profile != nil {
instanceURLString = strings.TrimSpace(s.Profile.InstanceURL)
}
var instanceURL *url.URL
if instanceURLString != "" {
instanceURL, err = url.Parse(instanceURLString)
if err != nil || !instanceURL.IsAbs() || instanceURL.Host == "" {
return nil, status.Errorf(codes.Internal, "invalid configured instance URL")
}
}
for _, destination := range data.ImageDestinations {
parsed, err := url.Parse(destination)
if err != nil || (!parsed.IsAbs() && parsed.Host == "") || !strings.HasPrefix(parsed.Path, "/file/attachments/") {
continue
}
if parsed.Scheme == "" && parsed.Host != "" {
if instanceURL == nil || sameURLAuthority(parsed, instanceURL) {
return nil, status.Errorf(codes.InvalidArgument, "protocol-relative managed attachment image URLs are not allowed: %s", destination)
}
continue
}
if instanceURL == nil {
return nil, status.Errorf(codes.InvalidArgument, "absolute managed attachment image URLs require a configured instance URL")
}
if !sameURLOrigin(parsed, instanceURL) {
continue
}
relative := parsed.EscapedPath()
if parsed.RawQuery != "" {
relative += "?" + parsed.RawQuery
}
if parsed.Fragment != "" {
relative += "#" + parsed.Fragment
}
uid, managed, valid := markdown.ParseManagedAttachmentImageURL(relative)
if !managed || !valid {
return nil, status.Errorf(codes.InvalidArgument, "invalid managed attachment image URL: %s", destination)
}
references = append(references, markdown.ManagedAttachmentReference{UID: uid})
}
seenReferences := make(map[string]struct{}, len(references))
uniqueReferences := make([]markdown.ManagedAttachmentReference, 0, len(references))
for _, reference := range references {
if _, ok := seenReferences[reference.UID]; ok {
continue
}
seenReferences[reference.UID] = struct{}{}
uniqueReferences = append(uniqueReferences, reference)
}
return uniqueReferences, nil
}
func sameURLAuthority(candidate, instance *url.URL) bool {
withScheme := candidate.Clone()
withScheme.Scheme = instance.Scheme
return sameURLOrigin(withScheme, instance)
}
func sameURLOrigin(a, b *url.URL) bool {
return strings.EqualFold(a.Scheme, b.Scheme) &&
strings.EqualFold(a.Hostname(), b.Hostname()) &&
effectiveURLPort(a) == effectiveURLPort(b)
}
func effectiveURLPort(u *url.URL) string {
if port := u.Port(); port != "" {
return port
}
switch strings.ToLower(u.Scheme) {
case "http":
return "80"
case "https":
return "443"
default:
return ""
}
}
func allGroupMembersRequested(group []*store.Attachment, requestedNames map[string]bool) bool {
if len(group) == 0 {
return false
}
for _, attachment := range group {
if !requestedNames[attachment.UID] {
return false
}
}
return true
}
func (s *APIV1Service) ListMemoAttachments(ctx context.Context, request *v1pb.ListMemoAttachmentsRequest) (*v1pb.ListMemoAttachmentsResponse, error) {
memoUID, err := ExtractMemoUIDFromName(request.Name)
if err != nil {
return nil, status.Errorf(codes.InvalidArgument, "invalid memo name: %v", err)
}
memo, err := s.Store.GetMemo(ctx, &store.FindMemo{UID: &memoUID})
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to get memo: %v", err)
}
if memo == nil {
return nil, status.Errorf(codes.NotFound, "memo not found")
}
if err := s.checkMemoAndParentReadAccess(ctx, memo); err != nil {
return nil, err
}
attachments, err := s.Store.ListAttachments(ctx, &store.FindAttachment{
MemoID: &memo.ID,
})
if err != nil {
return nil, status.Errorf(codes.Internal, "failed to list attachments: %v", err)
}
response := &v1pb.ListMemoAttachmentsResponse{
Attachments: []*v1pb.Attachment{},
}
for _, attachment := range attachments {
response.Attachments = append(response.Attachments, convertAttachmentFromStore(attachment))
}
return response, nil
}