bazaar

type BazaarInfo struct {
	Packages map[string]map[string]*PackageInfo `json:"packages"`
}

type Funding struct {
	OpenCollective string        `json:"openCollective"`
	Patreon        string        `json:"patreon"`
	GitHub         string        `json:"github"`
	Custom         []string      `json:"custom"`
	Links          []FundingLink `json:"links,omitempty"`
}

type FundingLink struct {
	Label string `json:"label"`
	URL   string `json:"url"`
}

type LocaleStrings map[string]string

type Package struct {
	Author            string          `json:"author"`
	URL               string          `json:"url"`
	Version           string          `json:"version"`
	MinAppVersion     string          `json:"minAppVersion"`
	DisabledInPublish bool            `json:"disabledInPublish"`
	Kernels           []string        `json:"kernels"`
	Backends          []string        `json:"backends"`
	Frontends         []string        `json:"frontends"`
	SettingsWindow    bool            `json:"settingsWindow,omitempty"` // 声明支持在独立设置窗口运行
	BootAppearances   []string        `json:"bootAppearances,omitempty"`
	DisplayName       LocaleStrings   `json:"displayName"`
	Description       LocaleStrings   `json:"description"`
	Readme            LocaleStrings   `json:"readme"`
	Icon              *string         `json:"icon,omitempty"`
	Preview           *string         `json:"preview,omitempty"`
	Funding           *Funding        `json:"funding"`
	Keywords          []string        `json:"keywords"`
	Deprecated        bool            `json:"deprecated,omitempty"`
	DeprecatedReason  LocaleStrings   `json:"deprecatedReason,omitempty"`
	Choices           []PackageChoice `json:"choices,omitempty"` // 替代包及其类型，可跨类型

	PreferredFunding          string `json:"preferredFunding"`
	PreferredName             string `json:"preferredName"`
	PreferredDesc             string `json:"preferredDesc"`
	PreferredReadme           string `json:"preferredReadme"`
	PreferredDeprecatedReason string `json:"preferredDeprecatedReason,omitempty"`

	Name       string `json:"name"`    // 包名，不一定是仓库名
	RepoURL    string `json:"repoURL"` // 形式为 https://github.com/owner/repo
	RepoHash   string `json:"repoHash"`
	RepoRef    string `json:"repoRef,omitempty"`
	PreviewURL string `json:"previewURL"`
	IconURL    string `json:"iconURL"`

	Installed                bool   `json:"installed"`
	HasStorageData           bool   `json:"hasStorageData,omitempty"`
	Outdated                 bool   `json:"outdated"`
	Current                  bool   `json:"current"`
	Created                  string `json:"created,omitempty"` // 首次上架时间，来自在线集市索引；缺失时未知
	Updated                  string `json:"updated"`
	Stars                    int    `json:"stars"`
	OpenIssues               int    `json:"openIssues"`
	Size                     int64  `json:"size"`
	HSize                    string `json:"hSize"`
	InstallSize              int64  `json:"installSize"`
	HInstallSize             string `json:"hInstallSize"`
	InstallTime              int64  `json:"installTime"`
	UpdateTime               int64  `json:"updateTime"`
	HInstallDate             string `json:"hInstallDate"`
	HUpdated                 string `json:"hUpdated"`
	Downloads                int    `json:"downloads"`
	DisallowInstall          bool   `json:"disallowInstall"`
	DisallowUpdate           bool   `json:"disallowUpdate"`
	BazaarVersionUnsupported bool   `json:"bazaarVersionUnsupported,omitempty"` // 在线版本要求的最低应用版本高于当前版本
	UpdateRequiredMinAppVer  string `json:"updateRequiredMinAppVer,omitempty"`  // 升级目标要求的最小应用版本
	InvalidReason            string `json:"invalidReason,omitempty"`            // 本地安装包异常原因

	RatingAvailable bool           `json:"ratingAvailable"`  // 在线集市公开评分是否可用
	Rating          *PackageRating `json:"rating,omitempty"` // 在线集市公开评分

	// 专用字段，nil 时不序列化
	InstalledIncompatible *bool     `json:"installedIncompatible,omitempty"` // 插件/主题：本地已安装版本是否不兼容
	BazaarIncompatible    *bool     `json:"bazaarIncompatible,omitempty"`    // 插件/主题：在线集市版本是否不兼容
	Enabled               *bool     `json:"enabled,omitempty"`               // Plugin：是否启用
	UserDisabledInPublish *bool     `json:"userDisabledInPublish,omitempty"` // Plugin：是否由用户在发布服务中禁用
	Modes                 *[]string `json:"modes,omitempty"`                 // Theme：支持的模式列表
}

type PackageChoice struct {
	PackageType string `json:"packageType"`
	Name        string `json:"name"`
}

type PackageInfo struct {
	InstallTime int64  `json:"installTime"` // 安装时间戳（毫秒）
	UpdateTime  int64  `json:"updateTime"`  // 更新时间戳（毫秒）
	RepoURL     string `json:"repoURL,omitempty"`
	RepoRef     string `json:"repoRef,omitempty"`
}

type PackageInstallOptions struct {
	ExpectedInstalledRevision string
	BeforeReplace             func() error
	Context                   context.Context
	Recheck                   func() error
}

type PackageInstallResult struct {
	InstalledRevision string
	PreviousRevision  string
}

type PackageLayout struct {
	BasePath string // 安装目录的父目录
	Manifest string // 清单文件名
	URLPath  string // 前端访问该包目录的路径前缀
}

type PackageRating struct {
	Average      float64  `json:"average"`
	Count        int64    `json:"count"`
	Distribution [5]int64 `json:"distribution"`
}

type StageBazaarResult struct {
	StageIndex      *StageIndex               // stage 索引
	BazaarStats     map[string]*bazaarStats   // 下载统计信息
	BazaarRatings   map[string]*PackageRating // 评分统计信息
	RatingAvailable bool                      // 评分统计信息是否可用
	Online          bool                      // online 状态
	StageErr        error                     // stage 错误
}

type StageIndex struct {
	Repos []*StageRepo `json:"repos"`
	// contains filtered or unexported fields
}

type StageRepo struct {
	URL         string `json:"url"` // owner/repo@hash 形式
	RepoRef     string `json:"repoRef,omitempty"`
	Created     string `json:"created,omitempty"`
	Updated     string `json:"updated"`
	Stars       int    `json:"stars"`
	OpenIssues  int    `json:"openIssues"`
	Size        int64  `json:"size"`
	InstallSize int64  `json:"installSize"`

	// Package 与 stage/*.json 内嵌的完整 package 一致，可直接用于构建列表
	Package *Package `json:"package"`
}