platforms

type AssetInfo struct {
	ID   int64  // 附件的唯一 ID（由平台生成），用于删除或引用
	Name string // 附件的名称（如文件名），如 "app-v1.0.0-linux-amd64.tar.gz"
	URL  string // 附件的下载 URL（通常是公开链接或 API 地址）
}

type IPlatform interface {
	credential.ICredential
	IPlatformRepo
	IPlatformReleases
}

type IPlatformReleases interface {
	// ListTags 列出指定仓库的所有标签
	ListTags(ctx context.Context, fullName string) ([]*TagInfo, error)

	// GetTagReleaseInfo 获取指定仓库下的某个标签信息
	GetTagReleaseInfo(ctx context.Context, fullName, tagName string) (*ReleaseInfo, error)

	// CreateRelease 在指定仓库下创建一个新的发布版本
	CreateRelease(ctx context.Context, fullName string, releaseInfo *ReleaseInfo) (newTagInfo *ReleaseInfo, er error)

	// DeleteReleaseAssets 删除指定发布版本下的一个或多个资源文件
	DeleteReleaseAssets(ctx context.Context, releaseInfo *ReleaseInfo, filenames []string) error

	// UploadReleaseAsset 上传一个或多个资源文件到指定的发布版本
	UploadReleaseAsset(ctx context.Context, releaseInfo *ReleaseInfo, filenames []string) error
}

type IPlatformRepo interface {
	// ListOrgRepo 列出指定组织下的所有仓库。
	ListOrgRepo(ctx context.Context, orgName string) ([]*RepoInfo, error)

	// ListUserRepo 列出当前用户自己创建或拥有的仓库。
	ListUserRepo(ctx context.Context) ([]*RepoInfo, error)

	// GetRepoDetail 获取单个仓库的详细信息。
	GetRepoDetail(ctx context.Context, fullName string) (*RepoInfo, error)

	// CreateRepo 创建一个新的仓库。
	CreateRepo(ctx context.Context, repoInfo *RepoInfo) error

	// DeleteRepo 删除指定的仓库。
	DeleteRepo(ctx context.Context, repoInfo *RepoInfo) error
}

type ReleaseInfo struct {
	ID          int64  // Release 的唯一 ID（由平台生成），用于获取或删除
	TagName     string // 关联的标签名，例如 "v1.0.0"
	Title       string // Release 的标题名称，例如 "Initial Release"
	Description string // Release 的详细描述内容（通常用于更新日志等），例如 "Added login feature, fixed bugs"

	FullName string // 仓库全名，通常是 "组织名/仓库名"，例如: "my-org/my-repo"

	Assets []*AssetInfo // 附件列表，表示该 Release 中包含的所有资源文件（如安装包、构建产物等）
}

type RepoInfo struct {
	ID          int64  // 仓库唯一 ID，例如: 123456
	Name        string // 仓库名称（短名），例如: "my-repo"
	FullName    string // 仓库全名，通常是 "组织名/仓库名"，例如: "my-org/my-repo"
	Description string // 仓库描述信息，例如: "这是一个示例仓库"
	Homepage    string // 仓库主页链接，例如: "https://example.com"
	IsPrivate   bool   // 是否为私有仓库，例如: true
	CloneURL    string // 克隆仓库的 URL（HTTPS 或 SSH），例如: "https://github.com/my-org/my-repo.git"
}

type TagInfo struct {
	TagName string // 标签名称，例如 "v1.0.0"
	SHA     string // 标签对应的提交对象的 SHA 值
}