Files
memos/store/attachment_delete.go
boojack 4f46523758 chore: unify user permissions
An active application ADMIN now passes every memo-local authorization
check on named operations: authorship, audience, Space membership and
participation, attachment and reaction ownership. Structural validity
still applies, an archived admin holds no privilege, and collection
listings keep the audience predicate so feeds never surface other users'
private memos.

- core/access: admin bypass in the read policy; CanManageMemo and
  CanManageAttachment as the shared author-level predicates.
- store: drivers read the actor's role alongside its lifecycle state in
  the mutation transaction; validators accept an admin where they
  required the author or a member; shared attachment binding and
  removal predicates.
- api: handlers use the shared predicates; admins may place memos in
  any existing Space and see a memo's Space by name.
- web: one canManageMemo helper replaces the ad hoc creator checks.
- docs: multi-spaces design revised in place; share RPC comments
  updated.
2026-09-17 23:28:19 +08:00

115 lines
3.9 KiB
Go

package store
import (
"context"
"maps"
"slices"
"github.com/pkg/errors"
)
// AttachmentDeletionPolicy captures the caller and the memo content observed
// while validating a transport-facing attachment deletion. Drivers compare the
// snapshots with current memo state in the deletion transaction.
type AttachmentDeletionPolicy struct {
ActorUserID int32
ExpectedMemoContents map[int32]string
}
// DeleteAttachmentsWithPolicy atomically authorizes and removes the selected
// attachment rows. External object cleanup remains the caller's responsibility
// after the transaction commits.
func (s *Store) DeleteAttachmentsWithPolicy(ctx context.Context, policy *AttachmentDeletionPolicy, attachmentIDs []int32) error {
normalizedPolicy, normalizedIDs, err := normalizeAttachmentDelete(policy, attachmentIDs)
if err != nil {
return err
}
return s.driver.DeleteAttachmentsWithPolicy(ctx, normalizedPolicy, normalizedIDs)
}
func normalizeAttachmentDelete(policy *AttachmentDeletionPolicy, attachmentIDs []int32) (*AttachmentDeletionPolicy, []int32, error) {
if policy == nil || policy.ActorUserID <= 0 || len(attachmentIDs) == 0 {
return nil, nil, errors.New("attachment deletion requires policy and attachment IDs")
}
ids := slices.Clone(attachmentIDs)
slices.Sort(ids)
for index, id := range ids {
if id <= 0 {
return nil, nil, errors.New("attachment deletion IDs must be positive")
}
if index > 0 && ids[index-1] == id {
return nil, nil, errors.New("duplicate attachment deletion ID")
}
}
expectedMemoContents := maps.Clone(policy.ExpectedMemoContents)
for memoID := range expectedMemoContents {
if memoID <= 0 {
return nil, nil, errors.New("attachment deletion memo IDs must be positive")
}
}
return &AttachmentDeletionPolicy{
ActorUserID: policy.ActorUserID,
ExpectedMemoContents: expectedMemoContents,
}, ids, nil
}
// ValidateAttachmentDeletionMemoSnapshots requires exactly one expected
// content snapshot for every memo currently bound to the selected attachments.
func ValidateAttachmentDeletionMemoSnapshots(memoIDs []int32, expectedMemoContents map[int32]string) error {
if len(memoIDs) != len(expectedMemoContents) {
return ErrMemoMutationConflict
}
for _, memoID := range memoIDs {
if _, ok := expectedMemoContents[memoID]; !ok {
return ErrMemoMutationConflict
}
}
return nil
}
// ValidateAttachmentMutationTargets verifies attachment rows used by a
// transport-facing mutation and returns their distinct memo bindings in
// ascending order. Every attachment must be owned by the actor unless the
// actor is an instance administrator.
func ValidateAttachmentMutationTargets(actorUserID int32, actorIsAdmin bool, attachmentIDs []int32, attachments []*Attachment) ([]int32, error) {
if actorUserID <= 0 || len(attachmentIDs) == 0 || len(attachments) != len(attachmentIDs) {
return nil, ErrMemoMutationConflict
}
expectedIDs := make(map[int32]struct{}, len(attachmentIDs))
for _, id := range attachmentIDs {
if id <= 0 {
return nil, ErrMemoMutationConflict
}
expectedIDs[id] = struct{}{}
}
memoIDs := make(map[int32]struct{})
seen := make(map[int32]struct{}, len(attachments))
for _, attachment := range attachments {
if attachment == nil || attachment.ID <= 0 {
return nil, ErrMemoMutationConflict
}
if _, expected := expectedIDs[attachment.ID]; !expected {
return nil, ErrMemoMutationConflict
}
if _, duplicate := seen[attachment.ID]; duplicate {
return nil, ErrMemoMutationConflict
}
seen[attachment.ID] = struct{}{}
if !actorIsAdmin && attachment.CreatorID != actorUserID {
return nil, ErrMemoPermissionDenied
}
if attachment.MemoID != nil {
if *attachment.MemoID <= 0 {
return nil, ErrMemoMutationConflict
}
memoIDs[*attachment.MemoID] = struct{}{}
}
}
result := make([]int32, 0, len(memoIDs))
for memoID := range memoIDs {
result = append(result, memoID)
}
slices.Sort(result)
return result, nil
}