attach

type AtomicAttachmentReplacer interface {
	// Replace writes data to an existing storage key and returns the new logical
	// file metadata. Implementations must fail if storageKey does not already
	// exist.
	Replace(ctx context.Context, storageKey string, data io.Reader, contentType string) (*FileStoreResult, error)
}

type AttachmentStore interface {
	// Store writes file data and returns storage key, size, and SHA256.
	Store(ctx context.Context, data io.Reader, maxSize int64, contentType string) (*FileStoreResult, error)
	// Retrieve returns a reader for the stored file.
	Retrieve(ctx context.Context, storageKey string) (io.ReadCloser, error)
	// Delete removes the stored file.
	Delete(ctx context.Context, storageKey string) error
	// GetSignedURL returns a time-limited signed download URL, if supported.
	GetSignedURL(ctx context.Context, storageKey string, expiry time.Duration, opts *SignedURLOptions) (*url.URL, error)
}

type FileStoreResult struct {
	StorageKey string
	Size       int64
	SHA256     string
}

type Loader func(ctx context.Context) (AttachmentStore, error)

type Plugin struct {
	Name   string
	Loader Loader
	Flags  func(cfg *config.Config) []cli.Flag
	Apply  func(cfg *config.Config, cmd *cli.Command)
}

type SignedURLOptions struct {
	Disposition string
	Filename    string
}