etherplugin

type ActionProposal struct {
	Category    string         `json:"category"`
	Description string         `json:"description"`
	Input       map[string]any `json:"input,omitempty"`
}

type ActionRequest struct {
	Action string         `json:"action"`
	Input  map[string]any `json:"input"`
}

type ActionResponse struct {
	Toast    string          `json:"toast,omitempty"`
	Refresh  bool            `json:"refresh,omitempty"`
	Open     string          `json:"open,omitempty"`
	Proposal *ActionProposal `json:"proposal,omitempty"`
}

type BehaviorHints struct {
	Adult                 bool `json:"adult,omitempty"`
	P2P                   bool `json:"p2p,omitempty"`
	Configurable          bool `json:"configurable,omitempty"`
	ConfigurationRequired bool `json:"configurationRequired,omitempty"`
}

type CandidateFacts struct {
	ReleaseID     string      `json:"releaseId"`
	Name          string      `json:"name"`
	Size          int64       `json:"size,omitempty"`
	Protocol      string      `json:"protocol,omitempty"`
	SourceClass   string      `json:"sourceClass,omitempty"`
	Indexer       string      `json:"indexer,omitempty"`
	Resolution    any         `json:"resolution,omitempty"`
	HDR           []string    `json:"hdr,omitempty"`
	VideoCodec    string      `json:"videoCodec,omitempty"`
	AudioCodecs   []string    `json:"audioCodecs,omitempty"`
	AudioChannels string      `json:"audioChannels,omitempty"`
	Languages     []string    `json:"languages,omitempty"`
	Subtitles     []string    `json:"subtitles,omitempty"`
	ReleaseType   string      `json:"releaseType,omitempty"`
	Group         string      `json:"group,omitempty"`
	Cached        bool        `json:"cached,omitempty"`
	Verified      bool        `json:"verified,omitempty"`
	ClientCaps    *ClientCaps `json:"clientCaps,omitempty"`
}

type Capability string

type CatalogItem struct {
	ID          string   `json:"id"`
	Type        string   `json:"type"`
	Name        string   `json:"name"`
	Poster      string   `json:"poster,omitempty"`
	PosterShape string   `json:"posterShape,omitempty"`
	Background  string   `json:"background,omitempty"`
	Logo        string   `json:"logo,omitempty"`
	Description string   `json:"description,omitempty"`
	ReleaseInfo string   `json:"releaseInfo,omitempty"`
	IMDBRating  string   `json:"imdbRating,omitempty"`
	Genres      []string `json:"genres,omitempty"`
}

type CatalogProvider interface {
	Browse(ctx *Context, req KindBrowseRequest) (KindPage, error)
	Detail(ctx *Context, kind, id string) (KindItem, error)
}

type CatalogRequest struct {
	Type   string            `json:"type"`
	ID     string            `json:"id"`
	Extra  map[string]string `json:"extra"`
	Skip   int               `json:"skip"`
	Search string            `json:"search,omitempty"`
	Genre  string            `json:"genre,omitempty"`
}

type CatalogResponse struct {
	Metas []CatalogItem `json:"metas"`
}

type CatalogTitleSummary struct {
	ID     any    `json:"id"`
	Title  string `json:"title"`
	Type   string `json:"type"`
	Year   int    `json:"year,omitempty"`
	IMDBID string `json:"imdbId,omitempty"`
	TMDBID int    `json:"tmdbId,omitempty"`
}

type ChangesProvider interface {
	Changes(ctx *Context, req KindChangesRequest) (KindChangePage, error)
}

type ChannelInput struct {
	URL      string            `json:"url"`
	Name     string            `json:"name,omitempty"`
	Headers  map[string]string `json:"headers,omitempty"`
	Priority int               `json:"priority,omitempty"`
}

type ChannelItem struct {
	ID      string         `json:"id"`
	Name    string         `json:"name"`
	Number  int            `json:"number,omitempty"`
	Group   string         `json:"group,omitempty"`
	Logo    string         `json:"logo,omitempty"`
	GuideID string         `json:"guideId,omitempty"`
	Inputs  []ChannelInput `json:"inputs"`
}

type ChannelsMeta struct {
	Refresh string `json:"refresh,omitempty"`
	Test    bool   `json:"test"`
}

type ChannelsResponse struct {
	Channels []ChannelItem `json:"channels"`
}

type ClientCaps struct {
	MaxHeight int      `json:"maxHeight,omitempty"`
	HDR       []string `json:"hdr,omitempty"`
	Codecs    []string `json:"codecs,omitempty"`
}

type CommandMeta struct {
	Key    string `json:"key"`
	Label  string `json:"label"`
	Action string `json:"action"`
}

type ConfigureResponse struct {
	Errors map[string]string `json:"errors"`
}

type ContainerRef struct {
	Format         string      `json:"format,omitempty"` // "" (sniff)|rar|7z|zip
	Volumes        []VolumeRef `json:"volumes"`
	Member         string      `json:"member,omitempty"`
	MemberIndex    *int        `json:"memberIndex,omitempty"`
	PasswordSecret string      `json:"passwordSecret,omitempty"`
}

type Context struct {
	context.Context
	Manifest  Manifest
	Settings  map[string]any
	Locale    string
	PickToken string
	RequestID string
	Headers   map[string]string
	Query     map[string]string
	Ether     Host
	I18n      *I18n
}

type Contributes struct {
	Source           *SourceMeta           `json:"source,omitempty"`
	Channels         *ChannelsMeta         `json:"channels,omitempty"`
	Subtitles        *SubtitlesMeta        `json:"subtitles,omitempty"`
	Markers          *MarkersMeta          `json:"markers,omitempty"`
	Notification     *NotificationMeta     `json:"notification,omitempty"`
	Events           *EventsMeta           `json:"events,omitempty"`
	Integration      *IntegrationMeta      `json:"integration,omitempty"`
	ListSources      []ListSourceMeta      `json:"listSources,omitempty"`
	RankingSteps     []RankingStepMeta     `json:"rankingSteps,omitempty"`
	RuleConditions   []RuleConditionMeta   `json:"ruleConditions,omitempty"`
	Tools            []ToolMeta            `json:"tools,omitempty"`
	Pages            []PageMeta            `json:"pages,omitempty"`
	Slots            []SlotMeta            `json:"slots,omitempty"`
	Commands         []CommandMeta         `json:"commands,omitempty"`
	MediaKinds       []MediaKindMeta       `json:"mediaKinds,omitempty"`
	FrontendAdapters []FrontendAdapterMeta `json:"frontendAdapters,omitempty"`
	Setup            *SetupMeta            `json:"setup,omitempty"`
}

type Definition struct {
	Manifest          Manifest
	Routes            Routes
	DefaultSettings   map[string]any
	Strings           StringsCatalog
	DefaultLocale     string
	Host              Host
	RemoteHostOptions RemoteHostOptions
}

type EtherEvent struct {
	ID       string         `json:"id"`
	Name     string         `json:"name"`
	At       string         `json:"at"`
	ViewerID int64          `json:"viewerId,omitempty"`
	Payload  map[string]any `json:"payload,omitempty"`
}

type EtherManifestBlock struct {
	Protocol     int             `json:"protocol"`
	Kind         PluginKind      `json:"kind"`
	Capabilities []Capability    `json:"capabilities,omitempty"`
	Summary      string          `json:"summary"`
	Author       *PluginAuthor   `json:"author,omitempty"`
	License      string          `json:"license,omitempty"`
	Repo         string          `json:"repo,omitempty"`
	Icon         string          `json:"icon,omitempty"`
	Runtime      RuntimeDecl     `json:"runtime"`
	Cluster      string          `json:"cluster,omitempty"`
	Health       *HealthDecl     `json:"health,omitempty"`
	Permissions  *Permissions    `json:"permissions,omitempty"`
	Settings     *SettingsSchema `json:"settings,omitempty"`
	Strings      map[string]any  `json:"strings,omitempty"`
	Schedule     []ScheduleEntry `json:"schedule,omitempty"`
	Contributes  *Contributes    `json:"contributes,omitempty"`
}

type EventResponse struct {
	Ack []string `json:"ack"`
}

type EventsMeta struct {
	Subscribe []string `json:"subscribe"`
}

type FieldOption struct {
	Value string `json:"value"`
	Label string `json:"label"`
	Hint  string `json:"hint,omitempty"`
}

type FieldProblem struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type FileRangeResponse struct {
	Status       int               `json:"status,omitempty"`
	ContentType  string            `json:"contentType,omitempty"`
	ContentRange string            `json:"contentRange,omitempty"`
	TotalSize    *int64            `json:"totalSize,omitempty"`
	Headers      map[string]string `json:"headers,omitempty"`
	Body         []byte            `json:"-"`
}

type FileRequest struct {
	Path     string `json:"path"`
	Range    string `json:"range,omitempty"`
	HeadOnly bool   `json:"headOnly,omitempty"`
}

type FolderEntry struct {
	Name  string `json:"name"`
	Path  string `json:"path"`
	Dir   bool   `json:"dir"`
	Size  int64  `json:"size,omitempty"`
	Mtime int64  `json:"mtime,omitempty"`
}

type FolderHash struct {
	Size    int64  `json:"size"`
	ModTime int64  `json:"modTime"`
	CRC32   string `json:"crc32"`
	MD5     string `json:"md5"`
	SHA1    string `json:"sha1"`
}

type FolderHashJob struct {
	ID     string      `json:"id"`
	State  string      `json:"state"`
	Bytes  int64       `json:"bytes"`
	Result *FolderHash `json:"result,omitempty"`
	Error  string      `json:"error,omitempty"`
}

type FrontendAdapter interface {
	Handler() http.Handler
}

type FrontendAdapterMeta struct {
	Key          string   `json:"key"`
	Label        string   `json:"label"`
	ProtocolHint string   `json:"protocolHint"` // opds|subsonic|custom
	PathPrefix   string   `json:"pathPrefix"`
	DefaultPort  int      `json:"defaultPort,omitempty"`
	Clients      []string `json:"clients,omitempty"`
	Auth         string   `json:"auth,omitempty"` // ether_token (default)|basic|none_lan
}

type GuideRequest struct {
	ChannelID string `json:"channelId"`
	From      string `json:"from,omitempty"`
	To        string `json:"to,omitempty"`
}

type GuideResponse struct {
	Programmes []ProgrammeItem `json:"programmes"`
}

type HealthDecl struct {
	Interval string `json:"interval,omitempty"`
}

type HealthResponse struct {
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
}

type Host interface {
	KVGet(ctx context.Context, key string) (string, bool, error)
	KVPut(ctx context.Context, key, value string) error
	KVDelete(ctx context.Context, key string) error
	KVList(ctx context.Context, prefix string) ([]string, error)
	SecretGet(ctx context.Context, name string) (string, error)
	Fetch(ctx context.Context, req HostFetchRequest) (HostFetchResponse, error)
	CatalogSearch(ctx context.Context, query string, limit, offset int) ([]CatalogTitleSummary, error)
	CatalogGet(ctx context.Context, id string) (*CatalogTitleSummary, error)
	ViewerHistory(ctx context.Context, viewerID int64, limit, offset int) ([]ViewerWatchEntry, error)
	SetWatchState(ctx context.Context, viewerID int64, titleID string, watched bool) error
	UpsertCollection(ctx context.Context, collection map[string]any) error
	FoldersList(ctx context.Context, root, path string) ([]FolderEntry, error)
	FoldersStat(ctx context.Context, root, path string) (FolderEntry, error)
	FoldersHash(ctx context.Context, root, path string) (FolderHash, error)
	FoldersHashStart(ctx context.Context, root, path string) (FolderHashJob, error)
	FoldersHashPoll(ctx context.Context, id string) (FolderHashJob, error)
	FoldersHashCancel(ctx context.Context, id string) (FolderHashJob, error)
	NotifyOwner(ctx context.Context, text string) error
	Log(ctx context.Context, level, message string, attrs map[string]any) error
	// Content-kind host services. KindUpsert/KindDelete need a push-mode
	// kind; ResolveSources needs permissions.sources.
	KindUpsert(ctx context.Context, kindKey string, items []KindItem) (accepted int, err error)
	KindDelete(ctx context.Context, kindKey string, externalIDs []string) error
	KindItems(ctx context.Context, kindKey, cursor string, limit int) (KindPage, error)
	ResolveSources(ctx context.Context, q SourceQuery) ([]SourceCandidate, error)
	CachePut(ctx context.Context, libraryKey, name string, data []byte) (blobRef string, err error)
	CacheOpen(ctx context.Context, blobRef string) ([]byte, error)
	// StreamURL mints a short-lived, scoped ticket for one of this plugin's
	// own kind items and returns the Ether stream URL to embed in a
	// frontend adapter response (spec §6.5). viewerID is the viewer the
	// adapter authenticated.
	StreamURL(ctx context.Context, viewerID int64, itemRef string) (string, error)
}

type HostFetchRequest struct {
	Method  string            `json:"method,omitempty"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    string            `json:"body,omitempty"`
}

type HostFetchResponse struct {
	Status  int               `json:"status"`
	Headers map[string]string `json:"headers"`
	Body    string            `json:"body"`
}

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

type IntegrationMeta struct {
	Category string   `json:"category"`
	Logo     string   `json:"logo,omitempty"`
	Adds     []string `json:"adds"`
	Connect  string   `json:"connect"`
	Test     bool     `json:"test,omitempty"`
}

type ItemUnavailable struct {
	Code   string `json:"code"`
	Detail string `json:"detail,omitempty"`
}

type JobRequest struct {
	Name string `json:"name"`
}

type JobResponse map[string]any

type KindArt struct {
	Role  string `json:"role"`
	Label string `json:"label"`
}

type KindArtRef struct {
	Role   string `json:"role"`
	URL    string `json:"url"`
	Width  int    `json:"width,omitempty"`
	Height int    `json:"height,omitempty"`
}

type KindBrowseDecl struct {
	Sorts        []string `json:"sorts,omitempty"`
	Facets       []string `json:"facets,omitempty"`
	Search       bool     `json:"search"`
	SearchFields []string `json:"searchFields,omitempty"`
	// LiveSearch: client searches also call the plugin's /search route
	// with a short budget; results are upserted and merged (§15.4).
	LiveSearch bool `json:"liveSearch,omitempty"`
}

type KindBrowseRequest struct {
	Kind     string              `json:"-"` // filled from the route, never on the wire
	ParentID string              `json:"parentId,omitempty"`
	Level    string              `json:"level,omitempty"`
	Cursor   string              `json:"cursor,omitempty"`
	Limit    int                 `json:"limit,omitempty"`
	Sort     string              `json:"sort,omitempty"`
	Facets   map[string][]string `json:"facets,omitempty"`
	Query    string              `json:"query,omitempty"`
}

type KindCacheDecl struct {
	MaxBytes int64  `json:"maxBytes,omitempty"`
	TTL      string `json:"ttl,omitempty"`
}

type KindChangePage struct {
	Upserts    []KindItem `json:"upserts,omitempty"`
	Deletes    []string   `json:"deletes,omitempty"`
	NextCursor string     `json:"nextCursor,omitempty"`
	Complete   bool       `json:"complete"`
}

type KindChangesRequest struct {
	Kind   string `json:"-"`
	Cursor string `json:"cursor,omitempty"`
	Limit  int    `json:"limit,omitempty"`
}

type KindField struct {
	Key     string   `json:"key"`
	Type    string   `json:"type"` // string|int|float|bool|date|duration|enum|strings|people
	Label   string   `json:"label"`
	Indexed bool     `json:"indexed,omitempty"`
	Enum    []string `json:"enum,omitempty"`
}

type KindItem struct {
	Unavailable *ItemUnavailable           `json:"unavailable,omitempty"`
	ID          string                     `json:"id"`
	Level       string                     `json:"level"`
	ParentID    string                     `json:"parentId,omitempty"`
	Index       int                        `json:"index,omitempty"`
	Title       string                     `json:"title"`
	SortTitle   string                     `json:"sortTitle,omitempty"`
	Summary     string                     `json:"summary,omitempty"`
	Year        int                        `json:"year,omitempty"`
	Released    int64                      `json:"released,omitempty"` // unix seconds
	Rating      float64                    `json:"rating,omitempty"`
	Playable    bool                       `json:"playable,omitempty"`
	ChildCount  int                        `json:"childCount,omitempty"`
	LeafCount   int                        `json:"leafCount,omitempty"`
	Art         []KindArtRef               `json:"art,omitempty"`
	Fields      map[string]json.RawMessage `json:"fields,omitempty"`
	Hints       json.RawMessage            `json:"hints,omitempty"` // opaque JSON object, echoed to the resolver
	ETag        string                     `json:"etag,omitempty"`
}

type KindLevel struct {
	Key       string `json:"key"`
	Label     string `json:"label"`
	Playable  bool   `json:"playable,omitempty"`
	Container bool   `json:"container,omitempty"`
}

type KindLibraryDecl struct {
	Name string `json:"name"`
	Icon string `json:"icon,omitempty"`
}

type KindMatchDecl struct {
	ThresholdDefault float64 `json:"thresholdDefault,omitempty"`
}

type KindMatchRequest struct {
	Kind       string            `json:"-"`
	Item       KindItem          `json:"item"`
	Candidates []SourceCandidate `json:"candidates"`
	Settings   map[string]any    `json:"settings,omitempty"`
}

type KindMatchResponse struct {
	Matches []KindMatchScore `json:"matches"`
}

type KindMatchScore struct {
	CandidateRef string   `json:"candidateRef"`
	Score        float64  `json:"score"`
	Reasons      []string `json:"reasons,omitempty"`
}

type KindMatcher interface {
	Match(ctx *Context, req KindMatchRequest) (KindMatchResponse, error)
}

type KindPage struct {
	Items      []KindItem `json:"items"`
	NextCursor string     `json:"nextCursor,omitempty"`
	Total      *int       `json:"total,omitempty"`
}

type KindResolveRequest struct {
	Kind       string         `json:"-"`
	LibraryKey string         `json:"libraryKey"`
	Item       KindItem       `json:"item"`
	PartIndex  *int           `json:"partIndex,omitempty"`
	Client     map[string]any `json:"client,omitempty"`
}

type KindResolveResponse struct {
	Sources []PlayableSource `json:"sources"`
	TTLSec  int              `json:"ttlSec,omitempty"`
}

type KindResolver interface {
	Resolve(ctx *Context, req KindResolveRequest) (KindResolveResponse, error)
}

type KindSyncDecl struct {
	Mode    string `json:"mode"` // pull|push
	Refresh string `json:"refresh,omitempty"`
}

type ListSourceMeta struct {
	Key      string `json:"key"`
	Label    string `json:"label"`
	Hint     string `json:"hint,omitempty"`
	Catalog  string `json:"catalog"`
	Params   any    `json:"params,omitempty"`
	MaxItems int    `json:"maxItems,omitempty"`
	Refresh  string `json:"refresh,omitempty"`
}

type Manifest struct {
	ID            string               `json:"id"`
	Version       string               `json:"version"`
	Name          string               `json:"name"`
	Description   string               `json:"description,omitempty"`
	Logo          string               `json:"logo,omitempty"`
	Background    string               `json:"background,omitempty"`
	Types         []string             `json:"types,omitempty"`
	Catalogs      []StremioCatalogDecl `json:"catalogs,omitempty"`
	Resources     []any                `json:"resources,omitempty"`
	IDPrefixes    []string             `json:"idPrefixes,omitempty"`
	BehaviorHints *BehaviorHints       `json:"behaviorHints,omitempty"`
	Ether         *EtherManifestBlock  `json:"ether,omitempty"`
}

type MarkerItem struct {
	Kind  string  `json:"kind"`
	Start float64 `json:"start"`
	End   float64 `json:"end"`
	Label string  `json:"label,omitempty"`
}

type MarkersMeta struct {
	Kinds []string `json:"kinds"`
}

type MarkersRequest struct {
	Type string `json:"type"`
	ID   string `json:"id"`
}

type MarkersResponse struct {
	Markers []MarkerItem `json:"markers"`
}

type MediaKindMeta struct {
	Key     string          `json:"key"`
	Label   string          `json:"label"`
	Library KindLibraryDecl `json:"library"`
	Levels  []KindLevel     `json:"levels"`
	Fields  []KindField     `json:"fields,omitempty"`
	Art     []KindArt       `json:"art,omitempty"`
	Present Presentations   `json:"present"`
	Browse  KindBrowseDecl  `json:"browse"`
	Sync    KindSyncDecl    `json:"sync"`
	Cache   *KindCacheDecl  `json:"cache,omitempty"`
	Match   *KindMatchDecl  `json:"match,omitempty"`
}

type MetaItem struct {
	CatalogItem
	Runtime  string      `json:"runtime,omitempty"`
	Cast     []string    `json:"cast,omitempty"`
	Director []string    `json:"director,omitempty"`
	Videos   []MetaVideo `json:"videos,omitempty"`
}

type MetaRequest struct {
	Type string `json:"type"`
	ID   string `json:"id"`
}

type MetaResponse struct {
	Meta MetaItem `json:"meta"`
}

type MetaVideo struct {
	ID        string `json:"id"`
	Title     string `json:"title"`
	Released  string `json:"released,omitempty"`
	Season    int    `json:"season,omitempty"`
	Episode   int    `json:"episode,omitempty"`
	Overview  string `json:"overview,omitempty"`
	Thumbnail string `json:"thumbnail,omitempty"`
}

type MockHost struct {
	KV            map[string]string
	Secrets       map[string]string
	Catalog       map[string]CatalogTitleSummary
	History       map[int64][]ViewerWatchEntry
	WatchState    map[string]bool
	Collections   []map[string]any
	Kinds         map[string][]KindItem // kindKey -> pushed items, in upsert order
	Sources       []SourceCandidate     // returned by ResolveSources
	Blobs         map[string][]byte     // cache blob ref -> bytes
	Folders       map[string][]FolderEntry
	Notifications []string
	Logs          []RecordedLog
	FetchHandler  func(ctx context.Context, req HostFetchRequest) (HostFetchResponse, error)
	// LastStreamURLViewer/Item record the most recent StreamURL call.
	LastStreamURLViewer int64
	LastStreamURLItem   string
	// contains filtered or unexported fields
}

type NotificationMeta struct {
	Fields    any      `json:"fields,omitempty"`
	SendTest  bool     `json:"sendTest"`
	Formats   []string `json:"formats,omitempty"`
	MaxLength int      `json:"maxLength,omitempty"`
}

type NotifyRequest struct {
	Title    string         `json:"title,omitempty"`
	Message  string         `json:"message"`
	Event    string         `json:"event,omitempty"`
	Settings map[string]any `json:"settings,omitempty"`
}

type NotifyResponse struct {
	OK      bool   `json:"ok"`
	Message string `json:"message,omitempty"`
}

type OpenStreamRequest struct {
	StreamID string `json:"streamId"`
}

type OpenStreamResponse struct {
	URL       string            `json:"url,omitempty"`
	Headers   map[string]string `json:"headers,omitempty"`
	ExpiresAt string            `json:"expiresAt,omitempty"`
	File      string            `json:"file,omitempty"`
}

type PageMeta struct {
	Key   string `json:"key"`
	Label string `json:"label"`
	Route string `json:"route"`
	Group string `json:"group,omitempty"`
	Icon  string `json:"icon,omitempty"`
}

type PairingInputs struct {
	// URL is the server's http(s) base (from ETHER_URL).
	URL string
	// Code is a one-time pairing code (from ETHER_PAIRING_CODE).
	Code string
	// Credential is an explicit credential; it always wins.
	Credential string
	// StateDir overrides where the credential file is kept.
	StateDir string
}

type Permissions struct {
	Network     []string           `json:"network,omitempty"`
	Catalog     string             `json:"catalog,omitempty"`
	Viewers     *ViewerPermissions `json:"viewers,omitempty"`
	Collections string             `json:"collections,omitempty"`
	Folders     string             `json:"folders,omitempty"`
	Secrets     []string           `json:"secrets,omitempty"`
	// Sources lets a kind resolver ask Ether to find bytes: ""|none|search|acquire.
	Sources string `json:"sources,omitempty"`
}

type PlayableSource struct {
	Path        string            `json:"path,omitempty"`
	ID          string            `json:"id"`
	Label       string            `json:"label,omitempty"`
	Pattern     string            `json:"pattern"` // range|download|direct|container|release|file
	MIME        string            `json:"mime"`
	Size        int64             `json:"size,omitempty"`
	DurationSec float64           `json:"durationSec,omitempty"`
	URL         string            `json:"url,omitempty"`
	Headers     map[string]string `json:"headers,omitempty"`
	BlobRef     string            `json:"blobRef,omitempty"`
	SHA256      string            `json:"sha256,omitempty"`
	MaxBytes    int64             `json:"maxBytes,omitempty"`
	ExpiresAt   int64             `json:"expiresAt,omitempty"`
	Container   *ContainerRef     `json:"container,omitempty"`
	Release     *ReleaseHint      `json:"release,omitempty"`
}

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

type PluginAuthor struct {
	Name string `json:"name,omitempty"`
	URL  string `json:"url,omitempty"`
}

type PluginKind string

type Presentations struct {
	AdapterOnly bool `json:"adapterOnly,omitempty"`
	Plex        *struct {
		Base string `json:"base"` // movie|show|artist|photo
	} `json:"plex,omitempty"`
	MediaBrowser *struct {
		CollectionType string            `json:"collectionType"`
		ItemTypes      map[string]string `json:"itemTypes,omitempty"`
	} `json:"mediaBrowser,omitempty"`
	Stremio *struct {
		Type string `json:"type"`
	} `json:"stremio,omitempty"`
	Xtream *struct {
		Category string `json:"category"`
	} `json:"xtream,omitempty"`
	Silo *struct {
		Type string `json:"type"`
	} `json:"silo,omitempty"`
}

type ProgrammeItem struct {
	ID          string   `json:"id,omitempty"`
	ChannelID   string   `json:"channelId,omitempty"`
	Title       string   `json:"title"`
	Subtitle    string   `json:"subtitle,omitempty"`
	Description string   `json:"description,omitempty"`
	Start       string   `json:"start"`
	Stop        string   `json:"stop"`
	Icon        string   `json:"icon,omitempty"`
	Categories  []string `json:"categories,omitempty"`
}

type RankingStepMeta struct {
	Key    string `json:"key"`
	Label  string `json:"label"`
	Hint   string `json:"hint,omitempty"`
	Editor any    `json:"editor,omitempty"`
	Budget any    `json:"budget,omitempty"`
}

type RawRequest struct {
	PluginID string            `json:"pluginId,omitempty"`
	Method   string            `json:"method,omitempty"`
	Path     string            `json:"path"`
	Query    map[string]string `json:"query,omitempty"`
	Headers  map[string]string `json:"headers,omitempty"`
	Body     json.RawMessage   `json:"body,omitempty"`
	Locale   string            `json:"locale,omitempty"`
}

type RawResponse struct {
	Status     int               `json:"status"`
	Headers    map[string]string `json:"headers,omitempty"`
	Body       json.RawMessage   `json:"body,omitempty"`
	BinaryBody []byte            `json:"-"`
}

type RecordedLog struct {
	Level   string
	Message string
	Attrs   map[string]any
}

type ReleaseHint struct {
	NZBURL         string           `json:"nzbUrl,omitempty"`
	Magnet         string           `json:"magnet,omitempty"`
	InfoHash       string           `json:"infoHash,omitempty"`
	Candidate      *SourceCandidate `json:"candidate,omitempty"`
	FileHint       string           `json:"fileHint,omitempty"`
	PasswordSecret string           `json:"passwordSecret,omitempty"`
}

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

type RemoteHostOptions struct {
	BaseURL    string
	Credential string
	HTTPClient *http.Client
}

type RouteError struct {
	Status  int
	Code    string
	Message string
}

type Routes struct {
	Catalog          func(ctx *Context, req CatalogRequest) (CatalogResponse, error)
	Meta             func(ctx *Context, req MetaRequest) (MetaResponse, error)
	Stream           func(ctx *Context, req StreamRequest) (StreamResponse, error)
	OpenStream       func(ctx *Context, req OpenStreamRequest) (OpenStreamResponse, error)
	Subtitles        func(ctx *Context, req SubtitlesRequest) (SubtitlesResponse, error)
	SubtitleDownload func(ctx *Context, req SubtitleDownloadRequest) (SubtitleDownloadResponse, error)
	Markers          func(ctx *Context, req MarkersRequest) (MarkersResponse, error)
	Channels         func(ctx *Context) (ChannelsResponse, error)
	Guide            func(ctx *Context, req GuideRequest) (GuideResponse, error)
	Configure        func(ctx *Context, settings map[string]any) (ConfigureResponse, error)
	Test             func(ctx *Context) (TestResponse, error)
	Options          func(ctx *Context, field string) ([]FieldOption, error)
	Health           func(ctx *Context) (HealthResponse, error)
	Notify           func(ctx *Context, req NotifyRequest) (NotifyResponse, error)
	Event            func(ctx *Context, events []EtherEvent) (EventResponse, error)
	View             func(ctx *Context, req ViewRequest) (ViewResponse, error)
	Action           func(ctx *Context, req ActionRequest) (ActionResponse, error)
	Tool             func(ctx *Context, req ToolRequest) (ToolResponse, error)
	Job              func(ctx *Context, req JobRequest) (JobResponse, error)
	File             func(ctx *Context, req FileRequest) (FileRangeResponse, error)
	RankKey          func(candidate CandidateFacts, config map[string]any) int64
	CondMatch        func(candidate CandidateFacts, operator string, value any) bool
}

type RuleConditionMeta struct {
	Key       string   `json:"key"`
	Label     string   `json:"label"`
	Operators []string `json:"operators,omitempty"`
	Editor    any      `json:"editor,omitempty"`
}

type RuntimeDecl struct {
	Kind   string `json:"kind"`
	Entry  string `json:"entry,omitempty"`
	Module string `json:"module,omitempty"`
}

type ScheduleEntry struct {
	Every string `json:"every"`
	Call  string `json:"call"`
}

type SearchProvider interface {
	Search(ctx *Context, req KindBrowseRequest) (KindPage, error)
}

type ServeHandle struct {
	// Done closes when the tunnel supervisor stops (ctx cancellation or Close).
	// Transient disconnects reconnect automatically. It is nil for HTTP servers.
	Done  <-chan struct{}
	Mode  string
	URL   string
	Port  int
	Close func() error
}

type ServeOptions struct {
	Mode       string
	Host       string
	Port       int
	TunnelURL  string
	Credential string
	// URL is the server's http(s) base (ETHER_URL). When set, the tunnel URL
	// and pair URL are derived from it and the SDK pairs with a code.
	URL string
	// StateDir overrides where the pairing credential is saved
	// (ETHER_PLUGIN_STATE_DIR).
	StateDir string
}

type SettingField struct {
	Key         string         `json:"key"`
	Kind        string         `json:"kind"`
	Label       string         `json:"label,omitempty"`
	Hint        string         `json:"hint,omitempty"`
	Required    bool           `json:"required,omitempty"`
	Default     any            `json:"default,omitempty"`
	Options     []FieldOption  `json:"options,omitempty"`
	Fields      []SettingField `json:"fields,omitempty"`
	Min         *float64       `json:"min,omitempty"`
	Max         *float64       `json:"max,omitempty"`
	Placeholder string         `json:"placeholder,omitempty"`
}

type SettingsGroup struct {
	Key      string         `json:"key,omitempty"`
	Label    string         `json:"label,omitempty"`
	Hint     string         `json:"hint,omitempty"`
	Advanced bool           `json:"advanced,omitempty"`
	Fields   []SettingField `json:"fields"`
}

type SettingsSchema struct {
	Ref    string          `json:"$ref,omitempty"`
	Fields []SettingField  `json:"fields,omitempty"`
	Groups []SettingsGroup `json:"groups,omitempty"`
}

type SetupMeta struct {
	Steps []SetupStep `json:"steps"`
}

type SetupStep struct {
	Key      string   `json:"key"`
	Label    string   `json:"label"`
	Hint     string   `json:"hint,omitempty"`
	Fields   []string `json:"fields"`
	Test     string   `json:"test"`
	Required bool     `json:"required"`
}

type SetupTestRequest struct {
	Step   string         `json:"step"`
	Fields map[string]any `json:"fields,omitempty"`
}

type SetupTestResult struct {
	OK     bool              `json:"ok"`
	Detail string            `json:"detail,omitempty"`
	Fields map[string]string `json:"fields,omitempty"`
}

type SetupTester interface {
	TestSetup(ctx *Context, req SetupTestRequest) (SetupTestResult, error)
}

type SlotMeta struct {
	Slot  string `json:"slot"`
	Key   string `json:"key"`
	Label string `json:"label"`
	Route string `json:"route"`
}

type SourceCandidate struct {
	InfoHash  string `json:"infoHash,omitempty"`
	Magnet    string `json:"magnet,omitempty"`
	NZBURL    string `json:"nzbUrl,omitempty"`
	FileIndex int    `json:"fileIndex,omitempty"`
	Title     string `json:"title,omitempty"`
	Size      int64  `json:"size,omitempty"`
	Seeders   int    `json:"seeders,omitempty"`
	Cached    bool   `json:"cached,omitempty"`

	// Ref names this candidate in match scores. Ether derives it from the
	// infohash/NZB when empty; matchers echo it verbatim.
	Ref string `json:"-"`
}

type SourceMeta struct {
	Class     string         `json:"class"`
	Abilities []string       `json:"abilities,omitempty"`
	Limits    map[string]any `json:"limits,omitempty"`
}

type SourceQuery struct {
	Kind       string   `json:"kind"` // indexer_search|debrid_check|debrid_acquire
	Query      string   `json:"query,omitempty"`
	Category   string   `json:"category,omitempty"`
	InfoHashes []string `json:"infoHashes,omitempty"`
	InfoHash   string   `json:"infoHash,omitempty"`
	Magnet     string   `json:"magnet,omitempty"`
}

type StreamEtherExt struct {
	ID          string   `json:"id,omitempty"`
	ReleaseName string   `json:"releaseName,omitempty"`
	Size        int64    `json:"size,omitempty"`
	Languages   []string `json:"languages,omitempty"`
	Lazy        bool     `json:"lazy,omitempty"`
	File        string   `json:"file,omitempty"`
}

type StreamItem struct {
	Name        string          `json:"name,omitempty"`
	Title       string          `json:"title,omitempty"`
	Description string          `json:"description,omitempty"`
	URL         string          `json:"url,omitempty"`
	InfoHash    string          `json:"infoHash,omitempty"`
	FileIdx     *int            `json:"fileIdx,omitempty"`
	YtID        string          `json:"ytId,omitempty"`
	ExternalURL string          `json:"externalUrl,omitempty"`
	Ether       *StreamEtherExt `json:"ether,omitempty"`
}

type StreamRequest struct {
	Type  string            `json:"type"`
	ID    string            `json:"id"`
	Extra map[string]string `json:"extra"`
}

type StreamResponse struct {
	Streams []StreamItem `json:"streams"`
}

type StremioCatalogDecl struct {
	Type  string              `json:"type"`
	ID    string              `json:"id"`
	Name  string              `json:"name,omitempty"`
	Extra []StremioExtraField `json:"extra,omitempty"`
}

type StremioExtraField struct {
	Name         string   `json:"name"`
	IsRequired   bool     `json:"isRequired,omitempty"`
	Options      []string `json:"options,omitempty"`
	OptionsLimit int      `json:"optionsLimit,omitempty"`
}

type StringsCatalog map[string]map[string]string

type SubtitleDownloadRequest struct {
	ID     string `json:"id"`
	Lang   string `json:"lang"`
	Format string `json:"format"`
}

type SubtitleDownloadResponse struct {
	Format   string `json:"format"`
	Encoding string `json:"encoding"`
	Data     string `json:"data"`
}

type SubtitleItem struct {
	ID              string `json:"id"`
	URL             string `json:"url,omitempty"`
	Name            string `json:"name,omitempty"`
	Lang            string `json:"lang"`
	Label           string `json:"label,omitempty"`
	Format          string `json:"format,omitempty"`
	HearingImpaired bool   `json:"hearingImpaired,omitempty"`
}

type SubtitlesMeta struct {
	Languages any      `json:"languages,omitempty"`
	Formats   []string `json:"formats,omitempty"`
}

type SubtitlesRequest struct {
	Type      string            `json:"type"`
	ID        string            `json:"id"`
	Extra     map[string]string `json:"extra"`
	PickToken string            `json:"pickToken"`
	VideoHash string            `json:"videoHash,omitempty"`
	VideoSize int64             `json:"videoSize,omitempty"`
	Filename  string            `json:"filename,omitempty"`
}

type SubtitlesResponse struct {
	Subtitles []SubtitleItem `json:"subtitles"`
}

type TemplateOptions struct {
	ID          string
	Name        string
	Version     string
	Summary     string
	Description string
}

type TestHarness struct {
	Plugin *Plugin
	Host   *MockHost
}

type TestResponse struct {
	OK      bool     `json:"ok"`
	Message string   `json:"message,omitempty"`
	Details []string `json:"details,omitempty"`
}

type ToolMeta struct {
	Name        string         `json:"name"`
	Title       string         `json:"title"`
	Description string         `json:"description"`
	InputSchema map[string]any `json:"inputSchema"`
	ReadOnly    bool           `json:"readOnly,omitempty"`
	Destructive bool           `json:"destructive,omitempty"`
	OpenWorld   bool           `json:"openWorld,omitempty"`
}

type ToolRequest struct {
	Name  string         `json:"name"`
	Input map[string]any `json:"input"`
}

type ToolResponse map[string]any

type TunnelError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

type TunnelFrame struct {
	Type          string              `json:"type"`
	ID            string              `json:"id,omitempty"`
	RequestID     string              `json:"requestId,omitempty"`
	Protocol      string              `json:"protocol,omitempty"`
	Plugin        string              `json:"plugin,omitempty"`
	PluginID      string              `json:"pluginId,omitempty"`
	ConnectionID  string              `json:"connectionId,omitempty"`
	Features      []string            `json:"features,omitempty"`
	MaxChunkBytes int                 `json:"maxChunkBytes,omitempty"`
	Method        string              `json:"method,omitempty"`
	Path          string              `json:"path,omitempty"`
	Query         map[string][]string `json:"query,omitempty"`
	Headers       map[string][]string `json:"headers,omitempty"`
	Body          string              `json:"body,omitempty"`
	Data          string              `json:"data,omitempty"`
	Status        int                 `json:"status,omitempty"`
	Deadline      string              `json:"deadline,omitempty"`
	Error         *TunnelError        `json:"error,omitempty"`
}

type ViewRequest struct {
	Page  string            `json:"page"`
	Query map[string]string `json:"query"`
}

type ViewResponse struct {
	Spec ViewSpecDocument `json:"spec"`
	Data map[string]any   `json:"data"`
}

type ViewSpecDocument struct {
	SpecVersion int              `json:"specVersion"`
	Layout      string           `json:"layout"`
	Route       string           `json:"route,omitempty"`
	Header      []map[string]any `json:"header"`
	Body        []map[string]any `json:"body"`
}

type ViewerPermissions struct {
	Identity        string `json:"identity,omitempty"`
	WatchHistory    string `json:"watch_history,omitempty"`
	WriteWatchState string `json:"write_watch_state,omitempty"`
}

type ViewerWatchEntry struct {
	TitleID   string `json:"titleId"`
	Title     string `json:"title,omitempty"`
	WatchedAt string `json:"watchedAt,omitempty"`
	Completed bool   `json:"completed,omitempty"`
}

type VolumeRef struct {
	URL     string            `json:"url,omitempty"`
	Headers map[string]string `json:"headers,omitempty"`
	BlobRef string            `json:"blobRef,omitempty"`
	Size    int64             `json:"size"`
}