media

type ActiveStorage interface {
	Storage
	UploadKey(ctx context.Context, key string) (string, error)
	Describe(ctx context.Context) StorageInfo
}

type DeleteResponse struct {
	ID      string `json:"id"`
	Deleted bool   `json:"deleted"`
}

type Destination struct {
	ID        string `json:"id"`
	Name      string `json:"name"`
	Purpose   string `json:"purpose"`
	Secret    string `json:"secret"`
	UpdatedAt string `json:"updated_at"`
}

type FetchJob struct {
	URL  string     `json:"url"`
	Meta UploadMeta `json:"meta"`
}

type Focal struct {
	X float64 `json:"x" minimum:"0" maximum:"1"`
	Y float64 `json:"y" minimum:"0" maximum:"1"`
}

type ListQuery struct {
	MimePrefix       string `json:"-"`
	MinSize, MaxSize int64  `json:"-"`
	Search           string `json:"search"`
	Page             int    `json:"page"`
	PerPage          int    `json:"per_page"`
	Sort             string `json:"sort"`
	Order            string `json:"order"`
}

type LocalStorage struct {
	// contains filtered or unexported fields
}

type ManagedStorage struct {
	// contains filtered or unexported fields
}

type Media struct {
	ID         string             `json:"id"`
	Filename   string             `json:"filename"`
	StorageKey string             `json:"storage_key"`
	URL        string             `json:"url"`
	Mime       string             `json:"mime"`
	Size       int64              `json:"size"`
	Width      int                `json:"width"`
	Height     int                `json:"height"`
	Alt        string             `json:"alt"`
	Caption    string             `json:"caption"`
	Title      string             `json:"title"`
	AuthorID   string             `json:"author_id"`
	Variants   map[string]Variant `json:"variants"`
	SourceURL  string             `json:"source_url"`
	Checksum   string             `json:"checksum"`
	CreatedAt  string             `json:"created_at"`
	// Focal is the part of the image to keep in view when a theme crops it
	// to a frame; nil when none is set.
	Focal *Focal `json:"focal,omitempty"`
}

type Module struct{}

type Patch struct {
	Alt     *string `json:"alt,omitempty"`
	Caption *string `json:"caption,omitempty"`
	Title   *string `json:"title,omitempty"`
	// Focal sets the focal point; ClearFocal removes it.
	Focal      *Focal `json:"focal,omitempty"`
	ClearFocal bool   `json:"clear_focal,omitempty"`
}

type S3Config struct {
	Endpoint  string // https://<account>.r2.cloudflarestorage.com, https://s3.<region>.amazonaws.com
	Region    string // "auto" when empty (R2)
	Bucket    string
	AccessKey string
	SecretKey string
	PublicURL string // optional public base of the bucket (a CDN or R2 custom domain); else files are served from /media/
}

type S3Storage struct {
	// contains filtered or unexported fields
}

type Service interface {
	Upload(ctx context.Context, filename string, r io.Reader, meta UploadMeta) (*Media, error)
	FromURL(ctx context.Context, url string, meta UploadMeta) (*Media, error) // SSRF-safe, dedupes by source_url
	Get(ctx context.Context, id string) (*Media, error)
	List(ctx context.Context, q ListQuery) ([]Media, int, error)
	Update(ctx context.Context, id string, patch Patch) (*Media, error)
	Delete(ctx context.Context, id string) error
	URL(m *Media, variant string) string
	FindBySourceURL(ctx context.Context, url string) (*Media, error)
}

type Storage interface {
	Put(ctx context.Context, key string, r io.Reader, mime string) error
	Open(ctx context.Context, key string) (io.ReadCloser, error)
	Delete(ctx context.Context, key string) error
	URL(key string) string
}

type StorageInfo struct {
	Kind        string `json:"kind" enum:"local,s3"`
	Source      string `json:"source" doc:"settings:storage.active.media, config:s3 or local"`
	Configured  bool   `json:"configured"`
	Reason      string `json:"reason"`
	Remediation string `json:"remediation"`
}

type UploadMeta struct {
	GeneratedContentID string `json:"generated_content_id,omitempty"`
	GeneratedKind      string `json:"generated_kind,omitempty"`
	Alt                string `json:"alt"`
	Caption            string `json:"caption"`
	Title              string `json:"title"`
	AuthorID           string `json:"author_id"`
	SourceURL          string `json:"source_url"`
}

type UploadRequest struct {
	File    string `json:"file" format:"binary" doc:"the file part (multipart/form-data)"`
	Alt     string `json:"alt,omitempty"`
	Caption string `json:"caption,omitempty"`
	Title   string `json:"title,omitempty"`
}

type Variant struct {
	URL    string `json:"url"`
	Width  int    `json:"width"`
	Height int    `json:"height"`
}