models

type ActiveMedia struct {
	Started          time.Time `json:"started"`
	RelPath          *string   `json:"relativePath,omitempty"`
	PositionMs       *int64    `json:"positionMs,omitempty"`
	DurationMs       *int64    `json:"durationMs,omitempty"`
	LauncherID       string    `json:"launcherId"`
	SystemID         string    `json:"systemId"`
	SystemName       string    `json:"systemName"`
	Path             string    `json:"mediaPath"`
	Name             string    `json:"mediaName"`
	Slot             string    `json:"slot,omitempty"`
	LauncherControls []string  `json:"launcherControls,omitempty"`
	MediaID          int64     `json:"mediaId,omitempty"`
}

type ActiveMediaQueryParams struct {
	Slot string `json:"slot,omitempty"`
}

type ActiveMediaResponse struct {
	ZapScript string `json:"zapScript"`
	ActiveMedia
}

type AddMappingParams struct {
	Label    string `json:"label" validate:"max=255"`
	Type     string `json:"type" validate:"required,oneof=id value data uid text"`
	Match    string `json:"match" validate:"required,oneof=exact partial regex"`
	Pattern  string `json:"pattern" validate:"required"`
	Override string `json:"override"`
	Enabled  bool   `json:"enabled"`
}

type AllMappingsParams struct {
	// IncludeReadOnly also returns read-only mappings loaded from the mappings
	// folder. Defaults to false so older clients keep receiving DB mappings only.
	IncludeReadOnly bool `json:"includeReadOnly,omitempty"`
}

type AllMappingsResponse struct {
	Mappings []MappingResponse `json:"mappings"`
}

type BrowseEntry struct {
	SystemID           *string            `json:"systemId,omitempty"`
	RelPath            *string            `json:"relativePath,omitempty"`
	ZapScript          *string            `json:"zapScript,omitempty"`
	FileCount          *int               `json:"fileCount,omitempty"`
	Group              *string            `json:"group,omitempty"`
	Path               string             `json:"path"`
	Type               string             `json:"type"`
	Name               string             `json:"name"`
	SystemIDs          []string           `json:"systemIds,omitempty"`
	Tags               []database.TagInfo `json:"tags,omitempty"`
	DisambiguatingTags []database.TagInfo `json:"disambiguatingTags,omitempty"`
	MediaID            int64              `json:"mediaId,omitempty"`
	HasCover           bool               `json:"hasCover"`
}

type BrowseIndexGroup struct {
	Key    string `json:"key"`
	Label  string `json:"label"`
	Cursor string `json:"cursor"`
	Count  int    `json:"count"`
	Offset int    `json:"offset"`
}

type BrowseIndexResults struct {
	Scheme     string             `json:"scheme"`
	Groups     []BrowseIndexGroup `json:"groups"`
	TotalFiles int                `json:"totalFiles"`
}

type BrowseParams struct {
	Systems     *[]string `json:"systems" validate:"omitempty,dive,min=1"`
	FuzzySystem *bool     `json:"fuzzySystem,omitempty"`
	Path        *string   `json:"path,omitempty"`
	MaxResults  *int      `json:"maxResults,omitempty" validate:"omitempty,gt=0,max=1000"`
	Cursor      *string   `json:"cursor,omitempty"`
	Letter      *string   `json:"letter,omitempty" validate:"omitempty,letter"`
	Sort        *string   `json:"sort,omitempty" validate:"omitempty,oneof=name-asc name-desc filename-asc filename-desc"`
}

type BrowseResults struct {
	Pagination *PaginationInfo `json:"pagination,omitempty"`
	Path       string          `json:"path"`
	Entries    []BrowseEntry   `json:"entries"`
	TotalFiles int             `json:"totalFiles"`
}

type ClientError struct {
	Err error
}

type ClientResponse struct {
	Name    string    `json:"name"`
	Address string    `json:"address"`
	Secret  string    `json:"secret"` //nolint:gosec // G117: pairing secret, not a credential
	ID      uuid.UUID `json:"id"`
}

type ClientsDeleteParams struct {
	ClientID string `json:"clientId"`
}

type ClientsPairStartResponse struct {
	PIN       string `json:"pin"`
	ExpiresAt int64  `json:"expiresAt"`
}

type ClientsPairedNotification struct {
	ClientID   string `json:"clientId"`
	ClientName string `json:"clientName"`
}

type ClientsResponse struct {
	Clients []PairedClient `json:"clients"`
}

type DeleteClientParams struct {
	ID string `json:"id" validate:"required,min=1"`
}

type DeleteInboxParams struct {
	ID int64 `json:"id" validate:"gt=0"`
}

type DeleteMappingParams struct {
	ID int `json:"id" validate:"gt=0"`
}

type ErrorObject struct {
	// Data is optional structured detail about the error. Per JSON-RPC 2.0
	// §5.1 it MUST be a member of the error object, not a sibling.
	Data    any    `json:"data,omitempty"`
	Message string `json:"message"`
	Code    int    `json:"code"`
}

type HealthCheckResponse struct {
	Status string `json:"status"`
}

type HistoryResponse struct {
	Entries []HistoryResponseEntry `json:"entries"`
}

type HistoryResponseEntry struct {
	Time    time.Time `json:"time"`
	Type    string    `json:"type"`
	UID     string    `json:"uid"`
	Text    string    `json:"text"`
	Data    string    `json:"data"`
	Success bool      `json:"success"`
}

type InboxMessage struct {
	CreatedAt time.Time `json:"createdAt"`
	Title     string    `json:"title"`
	Body      string    `json:"body,omitempty"`
	Category  string    `json:"category,omitempty"`
	ID        int64     `json:"id"`
	Severity  int       `json:"severity"`
	ProfileID int64     `json:"profileId,omitempty"`
}

type InboxResponse struct {
	Messages []InboxMessage `json:"messages"`
}

type IndexingStatusResponse struct {
	TotalSteps         *int    `json:"totalSteps,omitempty"`
	CurrentStep        *int    `json:"currentStep,omitempty"`
	CurrentStepDisplay *string `json:"currentStepDisplay,omitempty"`
	TotalFiles         *int    `json:"totalFiles,omitempty"`
	TotalMedia         *int    `json:"totalMedia,omitempty"`
	Exists             bool    `json:"exists"`
	Indexing           bool    `json:"indexing"`
	Optimizing         bool    `json:"optimizing"`
	Paused             bool    `json:"paused"`
}

type InputGamepadParams struct {
	Buttons string `json:"buttons" validate:"required,min=1"`
}

type InputKeyboardParams struct {
	Keys string `json:"keys" validate:"required,min=1"`
}

type Launcher struct {
	ID         string   `json:"id"`
	SystemID   string   `json:"systemId,omitempty"`
	SystemName string   `json:"systemName,omitempty"`
	Groups     []string `json:"groups,omitempty"`
}

type LaunchersResponse struct {
	Launchers []Launcher `json:"launchers"`
}

type LogDownloadResponse struct {
	Filename string `json:"filename"`
	Content  string `json:"content"`
	Size     int    `json:"size"`
}

type MappingResponse struct {
	ID       string `json:"id"`
	Added    string `json:"added"`
	Label    string `json:"label"`
	Type     string `json:"type"`
	Match    string `json:"match"`
	Pattern  string `json:"pattern"`
	Override string `json:"override"`
	// Source identifies where the mapping came from: "database" or "file".
	Source string `json:"source"`
	// ReadOnly is true for mappings that can't be edited via the API (file mappings).
	ReadOnly bool `json:"readOnly"`
	Enabled  bool `json:"enabled"`
}

type MediaCleanOrphansResponse struct {
	Deleted int64 `json:"deleted"`
}

type MediaControlParams struct {
	Args   map[string]string `json:"args,omitempty"`
	Action string            `json:"action" validate:"required,min=1"`
	Slot   string            `json:"slot,omitempty"`
}

type MediaHistoryLatestEntry struct {
	SystemID   string `json:"systemId"`
	SystemName string `json:"systemName"`
	MediaName  string `json:"mediaName"`
	MediaPath  string `json:"mediaPath"`
	LauncherID string `json:"launcherId"`
	StartedAt  string `json:"startedAt"`
}

type MediaHistoryLatestResponse struct {
	Entry *MediaHistoryLatestEntry `json:"entry"`
}

type MediaHistoryParams struct {
	Systems     *[]string `json:"systems,omitempty" validate:"omitempty,dive,min=1"`
	FuzzySystem *bool     `json:"fuzzySystem,omitempty"`
	Limit       *int      `json:"limit,omitempty" validate:"omitempty,gt=0,max=100"`
	Cursor      *string   `json:"cursor,omitempty"`
}

type MediaHistoryResponse struct {
	Pagination *PaginationInfo             `json:"pagination,omitempty"`
	Entries    []MediaHistoryResponseEntry `json:"entries"`
}

type MediaHistoryResponseEntry struct {
	RelPath    *string `json:"relativePath,omitempty"`
	EndedAt    *string `json:"endedAt,omitempty"`
	SystemID   string  `json:"systemId"`
	SystemName string  `json:"systemName"`
	MediaName  string  `json:"mediaName"`
	MediaPath  string  `json:"mediaPath"`
	LauncherID string  `json:"launcherId"`
	StartedAt  string  `json:"startedAt"`
	PlayTime   int     `json:"playTime"`
	MediaID    int64   `json:"mediaId,omitempty"`
}

type MediaHistoryTopEntry struct {
	RelPath       *string `json:"relativePath,omitempty"`
	SystemID      string  `json:"systemId"`
	SystemName    string  `json:"systemName"`
	MediaName     string  `json:"mediaName"`
	MediaPath     string  `json:"mediaPath"`
	LastPlayedAt  string  `json:"lastPlayedAt"`
	TotalPlayTime int     `json:"totalPlayTime"`
	SessionCount  int     `json:"sessionCount"`
	MediaID       int64   `json:"mediaId,omitempty"`
}

type MediaHistoryTopParams struct {
	Systems     *[]string `json:"systems,omitempty" validate:"omitempty,dive,min=1"`
	FuzzySystem *bool     `json:"fuzzySystem,omitempty"`
	Since       *string   `json:"since,omitempty"`
	Limit       *int      `json:"limit,omitempty" validate:"omitempty,gt=0,max=100"`
}

type MediaHistoryTopResponse struct {
	Entries []MediaHistoryTopEntry `json:"entries"`
}

type MediaImageParams struct {
	MediaID    *int64   `json:"mediaId,omitempty"`
	System     string   `json:"system"            validate:"omitempty,min=1"`
	Path       string   `json:"path"              validate:"omitempty,min=1"`
	ImageTypes []string `json:"imageTypes"        validate:"omitempty,dive,min=1"`
}

type MediaImageResponse struct {
	Extension   *string `json:"extension,omitempty"`
	ContentType string  `json:"contentType"`
	Data        string  `json:"data"`    // base64-encoded blob
	TypeTag     string  `json:"typeTag"` // e.g. "property:image-boxart"
}

type MediaIndexParams struct {
	Systems     *[]string `json:"systems" validate:"omitempty,dive,min=1"`
	FuzzySystem *bool     `json:"fuzzySystem,omitempty"`
}

type MediaLookupMatch struct {
	RelPath            *string            `json:"relativePath,omitempty"`
	System             System             `json:"system"`
	Name               string             `json:"name"`
	Path               string             `json:"path"`
	ZapScript          string             `json:"zapScript"`
	Tags               []database.TagInfo `json:"tags"`
	DisambiguatingTags []database.TagInfo `json:"disambiguatingTags,omitempty"`
	MediaID            int64              `json:"mediaId,omitempty"`
	Confidence         float64            `json:"confidence"`
}

type MediaLookupParams struct {
	FuzzySystem *bool  `json:"fuzzySystem,omitempty"`
	Name        string `json:"name" validate:"required,min=1"`
	System      string `json:"system" validate:"required,min=1"`
}

type MediaLookupResponse struct {
	Match *MediaLookupMatch `json:"match"`
}

type MediaMetaBatchItemResponse struct {
	Media *MediaMetaMediaResponse `json:"media,omitempty"`
	Error *string                 `json:"error,omitempty"`
}

type MediaMetaBatchResponse struct {
	Items []MediaMetaBatchItemResponse `json:"items"`
}

type MediaMetaMediaResponse struct {
	Properties          map[string]MediaMetaPropertyItem `json:"properties"`
	LauncherOverride    *string                          `json:"launcherOverride,omitempty"`
	Path                string                           `json:"path"`
	ParentDir           string                           `json:"parentDir"`
	Tags                []database.TagInfo               `json:"tags"`
	AvailableImageTypes []string                         `json:"availableImageTypes,omitempty"`
	Title               MediaMetaTitleResponse           `json:"title"`
	IsMissing           bool                             `json:"isMissing"`
}

type MediaMetaParams struct {
	MediaID *int64 `json:"mediaId,omitempty"`
	System  string `json:"system" validate:"omitempty,min=1"`
	Path    string `json:"path"   validate:"omitempty,min=1"`
}

type MediaMetaPropertyItem struct {
	Extension   *string `json:"extension,omitempty"`
	Text        string  `json:"text"`
	ContentType string  `json:"contentType"`
	BlobSize    int64   `json:"blobSize,omitempty"`
}

type MediaMetaResponse struct {
	Media MediaMetaMediaResponse `json:"media"`
}

type MediaMetaSystemResponse struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type MediaMetaTitleResponse struct {
	SecondarySlug       *string                          `json:"secondarySlug,omitempty"`
	Properties          map[string]MediaMetaPropertyItem `json:"properties"`
	System              MediaMetaSystemResponse          `json:"system"`
	Slug                string                           `json:"slug"`
	Name                string                           `json:"name"`
	Tags                []database.TagInfo               `json:"tags"`
	AvailableImageTypes []string                         `json:"availableImageTypes,omitempty"`
	SlugLength          int                              `json:"slugLength"`
	SlugWordCount       int                              `json:"slugWordCount"`
}

type MediaMetaUpdateParams struct {
	MediaID *int64          `json:"mediaId,omitempty"`
	System  string          `json:"system" validate:"omitempty,min=1"`
	Path    string          `json:"path"   validate:"omitempty,min=1"`
	Media   json.RawMessage `json:"media,omitempty"`
}

type MediaResponse struct {
	Database  IndexingStatusResponse `json:"database"`
	Active    []ActiveMediaResponse  `json:"active"`
	Playlists []PlaylistState        `json:"playlists,omitempty"`
}

type MediaScrapeParams struct {
	ScraperID string   `json:"scraperId" validate:"required,min=1"`
	Systems   []string `json:"systems"   validate:"omitempty,dive,min=1"`
	Force     bool     `json:"force"`
}

type MediaStartedParams struct {
	SystemID   string `json:"systemId" validate:"required"`
	SystemName string `json:"systemName" validate:"required"`
	MediaPath  string `json:"mediaPath" validate:"required"`
	MediaName  string `json:"mediaName" validate:"required"`
	Slot       string `json:"slot,omitempty"`
}

type MediaStoppedParams struct {
	SystemID   string `json:"systemId"`
	SystemName string `json:"systemName"`
	MediaName  string `json:"mediaName"`
	MediaPath  string `json:"mediaPath"`
	LauncherID string `json:"launcherId"`
	Slot       string `json:"slot,omitempty"`
	Elapsed    int    `json:"elapsed"`
}

type MediaTagsUpdateParams struct {
	MediaID *int64   `json:"mediaId,omitempty"`
	System  string   `json:"system" validate:"omitempty,min=1"`
	Path    string   `json:"path"   validate:"omitempty,min=1"`
	Add     []string `json:"add,omitempty" validate:"omitempty,dive,min=1"`
	Remove  []string `json:"remove,omitempty" validate:"omitempty,dive,min=1"`
}

type MediaTitleParseParams struct {
	SystemID string `json:"systemId" validate:"required,min=1"`
	Path     string `json:"path" validate:"required,min=1"`
}

type MediaTitleParseResponse struct {
	SecondarySlug *string `json:"secondarySlug,omitempty"`
	Slug          string  `json:"slug"`
	Name          string  `json:"name"`
	SlugLength    int     `json:"slugLength"`
	SlugWordCount int     `json:"slugWordCount"`
}

type NewClientParams struct {
	Name string `json:"name" validate:"required,min=1,max=255"`
}

type Notification struct {
	Method string          `json:"method"`
	Params json.RawMessage `json:"params"`
}

type NotificationObject struct {
	JSONRPC string          `json:"jsonrpc"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params,omitempty"`
}

type PaginationInfo struct {
	NextCursor  *string `json:"nextCursor,omitempty"`
	HasNextPage bool    `json:"hasNextPage"`
	PageSize    int     `json:"pageSize"`
}

type PairedClient struct {
	ClientID   string `json:"clientId"`
	ClientName string `json:"clientName"`
	CreatedAt  int64  `json:"createdAt"`
	LastSeenAt int64  `json:"lastSeenAt"`
}

type PlaylistItemInfo struct {
	Name      string `json:"name"`
	ZapScript string `json:"zapScript"`
}

type PlaylistState struct {
	ID      string             `json:"id"`
	Name    string             `json:"name"`
	Slot    string             `json:"slot"`
	Repeat  string             `json:"repeat"`
	Items   []PlaylistItemInfo `json:"items"`
	Index   int                `json:"index"`
	Total   int                `json:"total"`
	Playing bool               `json:"playing"`
}

type PlaytimeLimitReachedParams struct {
	Reason string `json:"reason"`
}

type PlaytimeLimitWarningParams struct {
	Interval  string `json:"interval"`
	Remaining string `json:"remaining"`
}

type PlaytimeLimitsResponse struct {
	Daily        *string  `json:"daily,omitempty"`
	Session      *string  `json:"session,omitempty"`
	SessionReset *string  `json:"sessionReset,omitempty"`
	Retention    *int     `json:"retention,omitempty"`
	Warnings     []string `json:"warnings,omitempty"`
	Enabled      bool     `json:"enabled"`
}

type PlaytimeStatusResponse struct {
	SessionStarted        *string `json:"sessionStarted,omitempty"`
	SessionDuration       *string `json:"sessionDuration,omitempty"`
	SessionCumulativeTime *string `json:"sessionCumulativeTime,omitempty"`
	SessionRemaining      *string `json:"sessionRemaining,omitempty"`
	CooldownRemaining     *string `json:"cooldownRemaining,omitempty"`
	DailyUsageToday       *string `json:"dailyUsageToday,omitempty"`
	DailyRemaining        *string `json:"dailyRemaining,omitempty"`
	State                 string  `json:"state"`
	SessionActive         bool    `json:"sessionActive"`
	LimitsEnabled         bool    `json:"limitsEnabled"`
}

type QuietClientError struct {
	Err error
}

type RPCID struct {
	json.RawMessage
}

type ReaderConnection struct {
	Enabled  *bool  `json:"enabled,omitempty"`
	Driver   string `json:"driver" validate:"required,min=1"`
	Path     string `json:"path"`
	IDSource string `json:"idSource,omitempty"`
}

type ReaderInfo struct {
	ID           string   `json:"id"`
	ReaderID     string   `json:"readerId"`
	Driver       string   `json:"driver"`
	Info         string   `json:"info"`
	Capabilities []string `json:"capabilities"`
	Connected    bool     `json:"connected"`
}

type ReaderResponse struct {
	Driver    string `json:"driver"`
	Path      string `json:"path"`
	Connected bool   `json:"connected"`
}

type ReaderWriteCancelParams struct {
	ReaderID *string `json:"readerId,omitempty"`
}

type ReaderWriteParams struct {
	ReaderID *string `json:"readerId,omitempty"`
	Text     string  `json:"text" validate:"required"`
}

type ReadersResponse struct {
	Readers []ReaderInfo `json:"readers"`
}

type RequestObject struct {
	JSONRPC string          `json:"jsonrpc"`
	ID      RPCID           `json:"id,omitempty"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params,omitempty"`
}

type ResponseErrorObject struct {
	Error   *ErrorObject `json:"error"`
	JSONRPC string       `json:"jsonrpc"`
	ID      RPCID        `json:"id"`
}

type ResponseObject struct {
	Result  any          `json:"result"`
	Error   *ErrorObject `json:"error,omitempty"`
	JSONRPC string       `json:"jsonrpc"`
	ID      RPCID        `json:"id"`
}

type ResponseWithCallback struct {
	Result     any
	AfterWrite func()
}

type RunParams struct {
	Type   *string `json:"type"`
	UID    *string `json:"uid"`
	Text   *string `json:"text"`
	Data   *string `json:"data" validate:"omitempty,hexdata"`
	Unsafe bool    `json:"unsafe"`
}

type RunScriptParams struct {
	Name      *string                  `json:"name"`
	Cmds      []zapscript.ZapScriptCmd `json:"cmds"`
	ZapScript int                      `json:"zapscript"`
	Unsafe    bool                     `json:"unsafe"`
}

type ScrapeSystemProgressResponse struct {
	SystemID   string `json:"systemId"`
	SystemName string `json:"systemName,omitempty"`
	Processed  int    `json:"processed"`
	Total      int    `json:"total"`
	Matched    int    `json:"matched"`
	Skipped    int    `json:"skipped"`
}

type ScraperInfo struct {
	ID               string   `json:"id"`
	Name             string   `json:"name"`
	SupportedSystems []string `json:"supportedSystems"`
}

type ScrapersResponse struct {
	Scrapers []ScraperInfo `json:"scrapers"`
}

type ScrapingStatusResponse struct {
	CurrentStep        *int                          `json:"currentStep,omitempty"`
	CurrentStepDisplay *string                       `json:"currentStepDisplay,omitempty"`
	TotalSteps         *int                          `json:"totalSteps,omitempty"`
	CurrentSystem      *ScrapeSystemProgressResponse `json:"currentSystem,omitempty"`
	ScraperID          string                        `json:"scraperId,omitempty"`
	SystemID           string                        `json:"systemId,omitempty"`
	State              string                        `json:"state,omitempty"`
	Error              string                        `json:"error,omitempty"`
	Processed          int                           `json:"processed"`
	Total              int                           `json:"total"`
	Matched            int                           `json:"matched"`
	Skipped            int                           `json:"skipped"`
	TotalScraped       int                           `json:"totalScraped"`
	Scraping           bool                          `json:"scraping"`
	Done               bool                          `json:"done"`
	Paused             bool                          `json:"paused"`
	Force              bool                          `json:"force"`
}

type ScreenshotResponse struct {
	Path string `json:"path"`
	Data string `json:"data"` // base64 encoded
	Size int    `json:"size"` // original byte count
}

type SearchParams struct {
	Systems     *[]string `json:"systems" validate:"omitempty,dive,min=1"`
	FuzzySystem *bool     `json:"fuzzySystem,omitempty"`
	MaxResults  *int      `json:"maxResults" validate:"omitempty,gt=0,max=1000"`
	Cursor      *string   `json:"cursor,omitempty"`
	Tags        *[]string `json:"tags,omitempty" validate:"omitempty,dive,min=1"`
	Letter      *string   `json:"letter,omitempty" validate:"omitempty,letter"`
	Query       *string   `json:"query"`
}

type SearchResultMedia struct {
	RelPath            *string            `json:"relativePath,omitempty"`
	System             System             `json:"system"`
	Name               string             `json:"name"`
	Path               string             `json:"path"`
	ZapScript          string             `json:"zapScript"`
	Tags               []database.TagInfo `json:"tags"`
	DisambiguatingTags []database.TagInfo `json:"disambiguatingTags,omitempty"`
	MediaID            int64              `json:"mediaId,omitempty"`
}

type SearchResults struct {
	Pagination *PaginationInfo     `json:"pagination,omitempty"`
	Results    []SearchResultMedia `json:"results"`
	Total      int                 `json:"total"`
}

type SettingsAuthClaimParams struct {
	ClaimURL string `json:"claimUrl" validate:"required,url"`
	Token    string `json:"token" validate:"required"`
}

type SettingsAuthClaimResponse struct {
	Domains []string `json:"domains"`
}

type SettingsResponse struct {
	UpdateChannel             string             `json:"updateChannel"`
	ReadersScanMode           string             `json:"readersScanMode"`
	ReadersScanIgnoreSystem   []string           `json:"readersScanIgnoreSystems"`
	ReadersConnect            []ReaderConnection `json:"readersConnect"`
	SystemDefaults            []SystemDefault    `json:"systemDefaults"`
	ReadersScanExitDelay      float32            `json:"readersScanExitDelay"`
	LaunchGuardTimeout        float32            `json:"launchGuardTimeout"`
	LaunchGuardDelay          float32            `json:"launchGuardDelay"`
	AudioVolume               int                `json:"audioVolume"`
	RunZapScript              bool               `json:"runZapScript"`
	DebugLogging              bool               `json:"debugLogging"`
	AudioScanFeedback         bool               `json:"audioScanFeedback"`
	ReadersAutoDetect         bool               `json:"readersAutoDetect"`
	ErrorReporting            bool               `json:"errorReporting"`
	LaunchGuardEnabled        bool               `json:"launchGuardEnabled"`
	LaunchGuardRequireConfirm bool               `json:"launchGuardRequireConfirm"`
}

type System struct {
	ReleaseDate  *string `json:"releaseDate,omitempty"`
	Manufacturer *string `json:"manufacturer,omitempty"`
	ID           string  `json:"id,omitempty"`
	Name         string  `json:"name,omitempty"`
	Category     string  `json:"category,omitempty"`
	ZapScript    string  `json:"zapScript,omitempty"`
}

type SystemDefault struct {
	System     string `json:"system" validate:"required,system"`
	Launcher   string `json:"launcher,omitempty"`
	BeforeExit string `json:"beforeExit,omitempty"`
}

type SystemsResponse struct {
	Systems []System `json:"systems"`
}

type TagsResponse struct {
	Tags []database.TagInfo `json:"tags"`
}

type TokenResponse struct {
	ScanTime time.Time `json:"scanTime"`
	Type     string    `json:"type"`
	UID      string    `json:"uid"`
	Text     string    `json:"text"`
	Data     string    `json:"data"`
	ReaderID string    `json:"readerId,omitempty"`
}

type TokensResponse struct {
	Last   *TokenResponse  `json:"last,omitempty"`
	Active []TokenResponse `json:"active"`
}

type UpdateActiveMediaParams struct {
	SystemID  string `json:"systemId" validate:"required"`
	MediaPath string `json:"mediaPath" validate:"required"`
	MediaName string `json:"mediaName" validate:"required"`
}

type UpdateApplyResponse struct {
	PreviousVersion string `json:"previousVersion"`
	NewVersion      string `json:"newVersion"`
}

type UpdateCheckResponse struct {
	CurrentVersion  string `json:"currentVersion"`
	LatestVersion   string `json:"latestVersion,omitempty"`
	ReleaseNotes    string `json:"releaseNotes,omitempty"`
	UpdateAvailable bool   `json:"updateAvailable"`
}

type UpdateMappingParams struct {
	Label    *string `json:"label" validate:"omitempty,max=255"`
	Enabled  *bool   `json:"enabled"`
	Type     *string `json:"type" validate:"omitempty,oneof=id value data uid text"`
	Match    *string `json:"match" validate:"omitempty,oneof=exact partial regex"`
	Pattern  *string `json:"pattern" validate:"omitempty,min=1"`
	Override *string `json:"override"`
	ID       int     `json:"id" validate:"gt=0"`
}

type UpdatePlaytimeLimitsParams struct {
	Enabled      *bool     `json:"enabled"`
	Daily        *string   `json:"daily" validate:"omitempty,duration"`
	Session      *string   `json:"session" validate:"omitempty,duration"`
	SessionReset *string   `json:"sessionReset" validate:"omitempty,duration"`
	Warnings     *[]string `json:"warnings" validate:"omitempty,dive,duration"`
	Retention    *int      `json:"retention" validate:"omitempty,gte=0"`
}

type UpdateSettingsParams struct {
	RunZapScript              *bool               `json:"runZapScript"`
	DebugLogging              *bool               `json:"debugLogging"`
	AudioScanFeedback         *bool               `json:"audioScanFeedback"`
	ReadersAutoDetect         *bool               `json:"readersAutoDetect"`
	ErrorReporting            *bool               `json:"errorReporting"`
	UpdateChannel             *string             `json:"updateChannel" validate:"omitempty,oneof=stable beta"`
	ReadersScanMode           *string             `json:"readersScanMode" validate:"omitempty,oneof=tap hold"`
	ReadersScanExitDelay      *float32            `json:"readersScanExitDelay" validate:"omitempty,gte=0"`
	ReadersScanIgnoreSystem   *[]string           `json:"readersScanIgnoreSystems" validate:"omitempty,dive,system"`
	ReadersConnect            *[]ReaderConnection `json:"readersConnect,omitempty"`
	SystemDefaults            *[]SystemDefault    `json:"systemDefaults,omitempty" validate:"omitempty,dive"`
	AudioVolume               *int                `json:"audioVolume" validate:"omitempty,gte=0,lte=200"`
	LaunchGuardEnabled        *bool               `json:"launchGuardEnabled"`
	LaunchGuardTimeout        *float32            `json:"launchGuardTimeout" validate:"omitempty,gte=-1"`
	LaunchGuardDelay          *float32            `json:"launchGuardDelay" validate:"omitempty,gte=0"`
	LaunchGuardRequireConfirm *bool               `json:"launchGuardRequireConfirm"`
}

type VersionResponse struct {
	Version  string `json:"version"`
	Platform string `json:"platform"`
}