search

type Empty struct {
	base.Empty
}

type EntityResult struct {
	LinkResult
	Type     string
	Category string
	Image    *Image
}

type Image struct {
	URL    url.URL
	Width  int
	Height int
}

type ImageResult struct {
	Image
	Title     string
	Desc      string
	PageURL   *url.URL
	Thumbnail *Image
}

type LangCode = language.Tag

type Language struct {
	Code LangCode
	Name string
}

type LinkResult struct {
	URL   url.URL
	Title string
	Desc  string
}

type Region struct {
	Code RegionCode
	Name string
}

type RegionCode = language.Region

type Request struct {
	Query  string
	Lang   LangCode
	Region RegionCode
	Safe   bool
}

type Result interface {
	GetURL() *url.URL
	GetTitle() string
	GetDesc() string
}

type ResultIterator interface {
	base.PagedIterator
	Result() Result
	Token() Token
}

type Searcher interface {
	Search(ctx context.Context, req Request) ResultIterator
	ContinueSearch(ctx context.Context, tok Token) ResultIterator
}

type Service interface {
	base.Provider
	Languages(ctx context.Context) ([]Language, error)
	Regions(ctx context.Context) ([]Region, error)

	Searcher
}

type ThumbnailResult interface {
	Result
	GetThumbnail() *Image
}

type Token []byte

type VideoResult struct {
	LinkResult
	Thumbnail *Image
}