media

type Asset struct {
	ID         string `db:"id"`
	StorageKey string `db:"storage_key"`
	Filename   string `db:"filename"`
	MIMEType   string `db:"mime_type"`
	SizeBytes  int64  `db:"size_bytes"`
	// Width and Height are the size of an image as shown: upright, following
	// its EXIF orientation.
	Width  int `db:"width"`
	Height int `db:"height"`
	// FocalX and FocalY are the image's focal point (see FocalPoint and
	// SetFocalPoint).
	FocalX    float64   `db:"focal_x"`
	FocalY    float64   `db:"focal_y"`
	Checksum  string    `db:"checksum"`
	CreatedAt time.Time `db:"created_at"`
	CreatedBy db.Ref    `db:"created_by"`
	UpdatedAt time.Time `db:"updated_at"`
	UpdatedBy db.Ref    `db:"updated_by"`
	// DeletedAt is when the asset went to the trash, by DeletedBy; nil for
	// assets in the library. Only Trashed returns deleted assets.
	DeletedAt    *time.Time    `db:"deleted_at"`
	DeletedBy    db.Ref        `db:"deleted_by"`
	Translations []Translation `db:"-"`
}

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

type FocalPoint struct {
	X float64
	Y float64
}

type Image struct {
	// URL is a copy at most the asked width wide, in DefaultVariantFormat
	// unless ImageAs asked for another, keeping the image's proportions and
	// never larger than the original. Images a variant would change, such
	// as a GIF that may be animated, and files outside the library keep
	// their own address, as does a PNG asked for as PNG that needs no
	// resizing: a copy would only be larger.
	URL string
	// Srcset lists copies of the image up to the width of URL, for a srcset
	// attribute; empty when URL is the original.
	Srcset string
	// OriginalURL is the uploaded file, for downloads.
	OriginalURL string
	// Width and Height are the size of URL in pixels, for an img's width and
	// height attributes; 0 when unknown.
	Width  int
	Height int
}

type Pinger interface {
	Ping(ctx context.Context) error
}

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

type Storage interface {
	// Put stores size bytes from reader under key, a name the Service
	// chose. It fails rather than overwrite a file.
	Put(ctx context.Context, key string, reader io.Reader, size int64) error
	// Open returns the file stored under key.
	Open(ctx context.Context, key string) (io.ReadCloser, error)
	// Delete removes the file under key; a file that is gone already is no
	// error.
	Delete(ctx context.Context, key string) error
	// URL is the address the file is served at, or "" when the site serves
	// it with the library's routes (see Service.RegisterRoutes), as it does
	// with Filesystem.
	URL(key string) string
}

type Translation struct {
	Locale  string `db:"locale"`
	Title   string `db:"title"`
	AltText string `db:"alt_text"`
}

type Variant struct {
	// Width and Height bound the size in pixels; 0 leaves that side free.
	Width  int
	Height int
	// Crop cuts the image to exactly Width × Height instead of fitting it
	// inside. It needs both sides.
	Crop bool
	// Focus is the point a crop keeps as near its centre as it can; nil is
	// the centre. VariantURL sets the asset's focal point when it is nil.
	Focus *FocalPoint
	// Format is webp (the default), jpg or png.
	Format string
}