imgproxy/imagetype/imagetype.go

package imagetype

import (
	"fmt"
	"net/url"
	"path/filepath"
	"strings"
)

type Type int

const (
	Unknown Type = iota
	JPEG
	JXL
	PNG
	WEBP
	GIF
	ICO
	SVG
	HEIC
	AVIF
	BMP
	TIFF
)

const (
	contentDispositionFilenameFallback = "image"
	contentDispositionsFmt             = "%s; filename=\"%s%s\""
)

var (
	Types = map[string]Type{
		"jpeg": JPEG,
		"jpg":  JPEG,
		"jxl":  JXL,
		"png":  PNG,
		"webp": WEBP,
		"gif":  GIF,
		"ico":  ICO,
		"svg":  SVG,
		"heic": HEIC,
		"avif": AVIF,
		"bmp":  BMP,
		"tiff": TIFF,
	}

	mimes = map[Type]string{
		JPEG: "image/jpeg",
		JXL:  "image/jxl",
		PNG:  "image/png",
		WEBP: "image/webp",
		GIF:  "image/gif",
		ICO:  "image/x-icon",
		SVG:  "image/svg+xml",
		HEIC: "image/heif",
		AVIF: "image/avif",
		BMP:  "image/bmp",
		TIFF: "image/tiff",
	}

	extensions = map[Type]string{
		JPEG: ".jpg",
		JXL:  ".jxl",
		PNG:  ".png",
		WEBP: ".webp",
		GIF:  ".gif",
		ICO:  ".ico",
		SVG:  ".svg",
		HEIC: ".heic",
		AVIF: ".avif",
		BMP:  ".bmp",
		TIFF: ".tiff",
	}
)

func ByMime(mime string) Type {
	for k, v := range mimes {
		if v == mime {
			return k
		}
	}
	return Unknown
}

func (it Type) String() string {
	// JPEG has two names, we should use only the full one
	if it == JPEG {
		return "jpeg"
	}

	for k, v := range Types {
		if v == it {
			return k
		}
	}
	return ""
}

func (it Type) Ext() string {
	if ext, ok := extensions[it]; ok {
		return ext
	}
	return ""
}

func (it Type) MarshalJSON() ([]byte, error) {
	for k, v := range Types {
		if v == it {
			return []byte(fmt.Sprintf("%q", k)), nil
		}
	}
	return []byte("null"), nil
}

func (it Type) Mime() string {
	if mime, ok := mimes[it]; ok {
		return mime
	}

	return "application/octet-stream"
}

func (it Type) ContentDisposition(filename string, returnAttachment bool) string {
	return ContentDisposition(filename, it.Ext(), returnAttachment)
}

func (it Type) ContentDispositionFromURL(imageURL string, returnAttachment bool) string {
	url, err := url.Parse(imageURL)
	if err != nil {
		return it.ContentDisposition(contentDispositionFilenameFallback, returnAttachment)
	}

	_, filename := filepath.Split(url.Path)
	if len(filename) == 0 {
		return it.ContentDisposition(contentDispositionFilenameFallback, returnAttachment)
	}

	return it.ContentDisposition(strings.TrimSuffix(filename, filepath.Ext(filename)), returnAttachment)
}

func (it Type) IsVector() bool {
	return it == SVG
}

func (it Type) SupportsAlpha() bool {
	return it != JPEG && it != BMP
}

func (it Type) SupportsAnimationLoad() bool {
	return it == GIF || it == WEBP || it == JXL
}

func (it Type) SupportsAnimationSave() bool {
	return it == GIF || it == WEBP
}

func (it Type) SupportsColourProfile() bool {
	return it == JPEG ||
		it == JXL ||
		it == PNG ||
		it == WEBP ||
		it == HEIC ||
		it == AVIF
}

func (it Type) SupportsQuality() bool {
	return it == JPEG ||
		it == WEBP ||
		it == HEIC ||
		it == AVIF ||
		it == TIFF
}

func (it Type) SupportsThumbnail() bool {
	return it == HEIC || it == AVIF
}

func ContentDisposition(filename, ext string, returnAttachment bool) string {
	disposition := "inline"

	if returnAttachment {
		disposition = "attachment"
	}

	return fmt.Sprintf(contentDispositionsFmt, disposition, strings.ReplaceAll(filename, `"`, "%22"), ext)
}