dendrite/setup/config/config_mediaapi.go

package config

import (
	"fmt"
	"math"
)

type MediaAPI struct {
	Matrix *Global `yaml:"-"`

	InternalAPI InternalAPIOptions `yaml:"internal_api"`
	ExternalAPI ExternalAPIOptions `yaml:"external_api"`

	// The MediaAPI database stores information about files uploaded and downloaded
	// by local users. It is only accessed by the MediaAPI.
	Database DatabaseOptions `yaml:"database"`

	// The base path to where the media files will be stored. May be relative or absolute.
	BasePath Path `yaml:"base_path"`

	// The absolute base path to where media files will be stored.
	AbsBasePath Path `yaml:"-"`

	// The maximum file size in bytes that is allowed to be stored on this server.
	// Note: if max_file_size_bytes is set to 0, the size is unlimited.
	// Note: if max_file_size_bytes is not set, it will default to 10485760 (10MB)
	MaxFileSizeBytes *FileSizeBytes `yaml:"max_file_size_bytes,omitempty"`

	// Whether to dynamically generate thumbnails on-the-fly if the requested resolution is not already generated
	DynamicThumbnails bool `yaml:"dynamic_thumbnails"`

	// The maximum number of simultaneous thumbnail generators. default: 10
	MaxThumbnailGenerators int `yaml:"max_thumbnail_generators"`

	// A list of thumbnail sizes to be pre-generated for downloaded remote / uploaded content
	ThumbnailSizes []ThumbnailSize `yaml:"thumbnail_sizes"`
}

func (c *MediaAPI) Defaults() {
	c.InternalAPI.Listen = "http://localhost:7774"
	c.InternalAPI.Connect = "http://localhost:7774"
	c.ExternalAPI.Listen = "http://[::]:8074"
	c.Database.Defaults(5)
	c.Database.ConnectionString = "file:mediaapi.db"

	defaultMaxFileSizeBytes := FileSizeBytes(10485760)
	c.MaxFileSizeBytes = &defaultMaxFileSizeBytes
	c.MaxThumbnailGenerators = 10
	c.BasePath = "./media_store"
}

func (c *MediaAPI) Verify(configErrs *ConfigErrors, isMonolith bool) {
	checkURL(configErrs, "media_api.internal_api.listen", string(c.InternalAPI.Listen))
	checkURL(configErrs, "media_api.internal_api.connect", string(c.InternalAPI.Connect))
	if !isMonolith {
		checkURL(configErrs, "media_api.external_api.listen", string(c.ExternalAPI.Listen))
	}
	checkNotEmpty(configErrs, "media_api.database.connection_string", string(c.Database.ConnectionString))

	checkNotEmpty(configErrs, "media_api.base_path", string(c.BasePath))
	// allow "unlimited" file size
	if c.MaxFileSizeBytes != nil && *c.MaxFileSizeBytes <= 0 {
		unlimitedSize := FileSizeBytes(math.MaxInt64 - 1)
		c.MaxFileSizeBytes = &unlimitedSize
	}
	checkPositive(configErrs, "media_api.max_file_size_bytes", int64(*c.MaxFileSizeBytes))
	checkPositive(configErrs, "media_api.max_thumbnail_generators", int64(c.MaxThumbnailGenerators))

	for i, size := range c.ThumbnailSizes {
		checkPositive(configErrs, fmt.Sprintf("media_api.thumbnail_sizes[%d].width", i), int64(size.Width))
		checkPositive(configErrs, fmt.Sprintf("media_api.thumbnail_sizes[%d].height", i), int64(size.Height))
	}
}