media

type BlobStore interface {
	// Put streams r into key and returns the bytes written. A failed Put
	// leaves no partial blob behind.
	Put(ctx context.Context, key string, r io.Reader) (int64, error)
	// Get opens key for streaming; close the returned reader.
	Get(ctx context.Context, key string) (io.ReadCloser, error)
	// Delete removes key. A missing key returns an error satisfying
	// errors.Is(err, fs.ErrNotExist).
	Delete(ctx context.Context, key string) error
	// URL is the public URL of key.
	URL(key string) string
}

type Config struct {
	UploadDir string // Directory for storing uploaded files
	BaseURL   string // Base URL for serving files (e.g., "/media")
	MaxSizeMB int    // Maximum file size in MB
	MaxPixels int    // Maximum decoded pixel count (width*height); 0 = default
	// MaxTotalBytes caps everything under UploadDir (originals and variants);
	// 0 = no cap. Set by the public demo so visitors cannot fill the disk.
	MaxTotalBytes int64
}

type CreateMediaInput struct {
	Filename         string
	OriginalFilename string
	MimeType         string
	FileSize         int64
	StoragePath      string
	Width            *int
	Height           *int
	Folder           string
}

type ImageVariant struct {
	Size   string `json:"size"`
	Path   string `json:"path"`
	URL    string `json:"url"`
	Width  int    `json:"width"`
	Height int    `json:"height"`
}

type ListMediaFilter struct {
	Folder   string
	MimeType string
	Search   string
}

type Media struct {
	ID               uuid.UUID      `json:"id"`
	Filename         string         `json:"filename"`
	OriginalFilename string         `json:"original_filename"`
	MimeType         string         `json:"mime_type"`
	FileSize         int64          `json:"file_size"`
	StorageProvider  string         `json:"storage_provider"`
	StoragePath      string         `json:"storage_path"`
	PublicURL        *string        `json:"public_url,omitempty"`
	Width            *int           `json:"width,omitempty"`
	Height           *int           `json:"height,omitempty"`
	Variants         []ImageVariant `json:"variants,omitempty"`
	AltText          *string        `json:"alt_text,omitempty"`
	Caption          *string        `json:"caption,omitempty"`
	Folder           string         `json:"folder"`
	UploadedBy       *uuid.UUID     `json:"uploaded_by,omitempty"`
	CreatedAt        time.Time      `json:"created_at"`
	UpdatedAt        time.Time      `json:"updated_at"`
}

type PagedResult struct {
	Items []*Media `json:"items"`
	Total int      `json:"total"`
}

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

type Repository interface {
	Create(ctx context.Context, m *Media) error
	GetByID(ctx context.Context, id uuid.UUID) (*Media, error)
	List(ctx context.Context, filter *ListMediaFilter, limit, offset int) (*PagedResult, error)
	Update(ctx context.Context, m *Media) error
	Delete(ctx context.Context, id uuid.UUID) error
}

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

type UpdateMediaInput struct {
	AltText *string `json:"alt_text,omitempty"`
	Caption *string `json:"caption,omitempty"`
	Folder  *string `json:"folder,omitempty"`
}

type Usage struct {
	Kind       string // entity | site | menu | plugin
	ID         uuid.UUID
	Name       string
	SchemaSlug string // entities only
}