layer

type BoundsWrapper interface {
	WrapBounds(inner Provider, bounds pkg.Bounds, deps ProviderDeps) (Provider, error)
}

type Description struct {
	DataType config.DataType
	MinZoom  *int
	MaxZoom  *int
	Bounds   config.BoundsConfig
	config.TileJSONMetadata
}

type LayerGroup interface {
	// Includes the layer's cache and permission checks
	RenderTile(ctx context.Context, tileRequest pkg.TileRequest) (*pkg.Image, error)
	// Skips the layer's cache
	RenderTileNoCache(ctx context.Context, tileRequest pkg.TileRequest) (*pkg.Image, error)
	// Includes names matching a layer pattern
	HasLayer(ctx context.Context, layerName string) bool
	ListLayerIDs() []string
}

type MetadataProvider interface {
	Metadata() Description
}

type Parent interface {
	Children() []Provider
}

type Provider interface {
	// Runs before tiles are generated. Called one at a time, when ProviderContext expires or GenerateTile returns an AuthError
	PreAuth(ctx context.Context, providerContext ProviderContext) (ProviderContext, error)
	GenerateTile(ctx context.Context, providerContext ProviderContext, tileRequest pkg.TileRequest) (*pkg.Image, error)
}

type ProviderContext struct {
	AuthBypass     bool                   // If true, avoids ever calling preauth again
	AuthExpiration time.Time              // When next to trigger preauth
	AuthToken      string                 // The main auth token that comes back from the preauth and is used by the generate method. Details are up to the provider
	Other          map[string]interface{} // A generic holder in cases where a provider needs extra storage - for instance Blend which needs Context for child providers
}

type ProviderDeps struct {
	ClientConfig  config.ClientConfig
	ErrorMessages config.ErrorMessages
	// Lets nesting providers reach sibling layers
	LayerGroup LayerGroup
	Datastores datastore.DatastoreRegistry
}

type ProviderRegistration interface {
	Name() string
	Initialize(config any, deps ProviderDeps) (Provider, error)
	InitializeConfig() any
	// Raster or vector. Nesting providers return config.DataTypeUnknown
	DataType(config any) config.DataType
}