models

type AppBriefInfo struct {
	ID               int64  `json:"id"`                // 应用ID
	Name             string `json:"name"`              // 应用名称
	Icon             string `json:"icon"`              // 图标地址
	Type             int    `json:"type"`              // 应用类型(游戏/软件) game=1 software=2
	CommunityVisible bool   `json:"community_visible"` // 社区可见性
	Propagation      string `json:"propagation"`       // 传播范围
}

type CartItem struct {
	LineItemID     string `json:"line_item_id"`    // 行内ID
	PackageID      int    `json:"package_id"`      // 包裹ID
	Price          string `json:"price"`           // 价格
	FormattedPrice string `json:"formatted_price"` // 格式化的价格
	AddTime        string `json:"add_time"`        // 加入购物车的时间
	IsGift         bool   `json:"is_gift"`         // 是否为礼物
	IsPrivate      bool   `json:"is_private"`      // 是否私有
}

type CommunityItemData struct {
	ItemName        string `json:"item_name"`        // 道具名称
	ItemTitle       string `json:"item_title"`       // 道具标题
	ItemDescription string `json:"item_description"` // 道具描述
	ItemImageSmall  string `json:"item_image_small"` // 小尺寸图片哈希
	ItemImageLarge  string `json:"item_image_large"` // 大尺寸图片哈希
	ItemMovieWebm   string `json:"item_movie_webm"`  // WebM 动画哈希
	ItemMovieMp4    string `json:"item_movie_mp4"`   // MP4 动画哈希
	Animated        bool   `json:"animated"`         // 是否动画效果
	Tiled           bool   `json:"tiled"`            // 是否平铺
}

type FamilyGroup struct {
	Name                         string              `json:"name"`                            // 家庭组名称
	Members                      []FamilyGroupMember `json:"members"`                         // 家庭组成员列表
	FreeSpots                    int                 `json:"free_spots"`                      // 家庭组剩余可用名额
	Country                      string              `json:"country"`                         // 家庭组所属地区
	SlotCooldownRemainingSeconds int64               `json:"slot_cooldown_remaining_seconds"` // 名额冷却剩余秒数
	SlotCooldownOverrides        int                 `json:"slot_cooldown_overrides"`         // 名额冷却覆盖次数
}

type FamilyGroupChange struct {
	Timestamp    string `json:"timestamp"`     // 变更时间戳
	ActorSteamID string `json:"actor_steamid"` // 操作人SteamID
	Type         int    `json:"type"`          // 变更类型标识
	Body         string `json:"body"`          // 变更详情JSON字符串
	BySupport    bool   `json:"by_support"`    // 是否由Steam客服执行的操作
}

type FamilyGroupChangeLogResponse struct {
	Response struct {
		Changes []FamilyGroupChange `json:"changes"` // 家庭组变更记录列表
	} `json:"response"` // 接口响应主体
}

type FamilyGroupForUserResponse struct {
	Response struct {
		FamilyGroupID             string `json:"family_groupid"`               // 当前所属家庭组ID
		IsNotMemberOfAnyGroup     bool   `json:"is_not_member_of_any_group"`   // 是否不属于任何家庭组
		LatestTimeJoined          int64  `json:"latest_time_joined"`           // 最近一次加入家庭组的时间戳
		LatestJoinedFamilyGroupID string `json:"latest_joined_family_groupid"` // 最近加入的家庭组ID
		Role                      int    `json:"role"`                         // 当前用户在家庭组中的角色
		CooldownSecondsRemaining  int64  `json:"cooldown_seconds_remaining"`   // 当前用户剩余冷却秒数
		FamilyGroup               struct {
			Name                         string              `json:"name"`                            // 家庭组名称
			Members                      []FamilyGroupMember `json:"members"`                         // 家庭组成员列表
			FreeSpots                    int                 `json:"free_spots"`                      // 家庭组剩余可用名额
			Country                      string              `json:"country"`                         // 家庭组所属地区
			SlotCooldownRemainingSeconds int64               `json:"slot_cooldown_remaining_seconds"` // 名额冷却剩余秒数
			SlotCooldownOverrides        int                 `json:"slot_cooldown_overrides"`         // 名额冷却覆盖次数
		} `json:"family_group"` // 家庭组详情
		CanUndeleteLastJoinedFamily bool                           `json:"can_undelete_last_joined_family"` // 是否可恢复最近退出的家庭组
		MembershipHistory           []FamilyGroupMembershipHistory `json:"membership_history"`              // 家庭组成员身份历史记录
	} `json:"response"` // 接口响应主体
}

type FamilyGroupMember struct {
	SteamID                  string `json:"steamid"`                    // 成员ID
	Role                     int    `json:"role"`                       // 成员角色标识
	TimeJoined               int64  `json:"time_joined"`                // 加入家庭组的时间戳
	CooldownSecondsRemaining int64  `json:"cooldown_seconds_remaining"` // 成员剩余冷却秒数
}

type FamilyGroupMembershipHistory struct {
	FamilyGroupID string `json:"family_groupid"` // 家庭组ID
	RTimeJoined   int64  `json:"rtime_joined"`   // 加入该家庭组的时间戳
	RTimeLeft     int64  `json:"rtime_left"`     // 离开该家庭组的时间戳
	Role          int    `json:"role"`           // 该历史阶段的成员角色
	Participated  bool   `json:"participated"`   // 是否实际参与该家庭组
}

type FamilyGroupPlaytimeBrief struct {
	SteamID       string `json:"steamid"`        // 游玩用户的ID
	AppID         uint64 `json:"appid"`          // 游戏/应用的Steam AppID
	FirstPlayed   string `json:"first_played"`   // 首次游玩该应用的时间戳
	LatestPlayed  string `json:"latest_played"`  // 最近一次游玩该应用的时间戳
	SecondsPlayed int64  `json:"seconds_played"` // 累计游玩时长(秒)
}

type FamilyGroupPlaytimeEntry struct {
	SteamID       string `json:"steamid"`        // 游玩用户的ID
	AppID         uint64 `json:"appid"`          // 游戏/应用的Steam AppID
	FirstPlayed   int64  `json:"first_played"`   // 首次游玩该应用的时间戳
	LatestPlayed  int64  `json:"latest_played"`  // 最近一次游玩该应用的时间戳
	SecondsPlayed int64  `json:"seconds_played"` // 累计游玩时长(秒)
}

type FamilyGroupPlaytimeSummaryResponse struct {
	Response struct {
		Entries []FamilyGroupPlaytimeEntry `json:"entries"` // 家庭组成员游玩时长记录列表
	} `json:"response"` // 接口响应主体
}

type FamilyGroupResponse struct {
	Response FamilyGroup `json:"response"`
}

type FamilySharedLibraryApp struct {
	AppID           uint64   `json:"appid"`            // 共享应用的Steam AppID
	OwnerSteamIDs   []string `json:"owner_steamids"`   // 该应用的拥有者ID
	Name            string   `json:"name"`             // 应用名称
	CapsuleFilename string   `json:"capsule_filename"` // 应用封面图文件名
	ImgIconHash     string   `json:"img_icon_hash"`    // 应用图标哈希值
	ExcludeReason   int      `json:"exclude_reason"`   // 排除共享的原因标识(0=可正常共享)
	RtTimeAcquired  int64    `json:"rt_time_acquired"` // 应用获取时间戳
	RtLastPlayed    int64    `json:"rt_last_played"`   // 最近一次游玩时间戳
	RtPlaytime      int64    `json:"rt_playtime"`      // 累计游玩时长(分钟)
	AppType         int      `json:"app_type"`         // 应用类型标识 1=游戏 2=软件
}

type FamilySharedLibraryAppBrief struct {
	OwnerSteamID string           `json:"owner_steamid"` // 共享库主拥有者的ID
	Apps         []SharedAppBrief `json:"apps"`          // 家庭组共享库应用列表
}

type FamilySharedLibraryResponse struct {
	Response struct {
		OwnerSteamID string                   `json:"owner_steamid"` // 共享库主拥有者的ID
		Apps         []FamilySharedLibraryApp `json:"apps"`          // 家庭组共享库应用列表
	} `json:"response"`
}

type GetAppsResponse struct {
	Response struct {
		Apps []struct {
			AppID                            int64  `json:"appid"`                             // 应用唯一标识
			Name                             string `json:"name"`                              // 应用名称
			Icon                             string `json:"icon"`                              // 应用图标哈希值
			CommunityVisibleStats            bool   `json:"community_visible_stats,omitempty"` // 是否显示社区统计
			Propagation                      string `json:"propagation"`                       // 传播范围
			AppType                          int    `json:"app_type"`                          // 应用类型标识
			ContentDescriptorIDs             []int  `json:"content_descriptorids"`
			ContentDescriptorIDsIncludingDLC []int  `json:"content_descriptorids_including_dlc"`
		} `json:"apps"` // 应用列表
	} `json:"response"` // 接口响应主体
}

type GetEquippedProfileItemsResponse struct {
	Response struct {
		ActiveDefinitions   []ProfileItemDefinition `json:"active_definitions"`   // 已装备的道具定义列表
		InactiveDefinitions []ProfileItemDefinition `json:"inactive_definitions"` // 未装备的道具定义列表
	} `json:"response"` // 接口响应主体
}

type GetLoyaltyRewardsSummaryResponse struct {
	Response struct {
		Summary struct {
			Points       string `json:"points"`        // 当前剩余点数
			PointsEarned string `json:"points_earned"` // 累计获得点数
			PointsSpent  string `json:"points_spent"`  // 累计消耗点数
		} `json:"summary"` // 点数汇总信息
		TimestampUpdated int64  `json:"timestamp_updated"` // 最后更新时间戳
		AuditIDHighwater string `json:"auditid_highwater"` // 审计ID高水位值
	} `json:"response"` // 接口响应主体
}

type GetReactionsSummaryForUserResponse struct {
	Response struct {
		Total               []ReactionSummaryItem `json:"total"`                 // 所有互动类型汇总
		UserReviews         []ReactionSummaryItem `json:"user_reviews"`          // 用户评论互动汇总
		UGC                 []ReactionSummaryItem `json:"ugc"`                   // UGC内容互动汇总
		Profile             []ReactionSummaryItem `json:"profile"`               // 个人资料互动汇总
		TotalGiven          int64                 `json:"total_given"`           // 总发出互动数
		TotalReceived       int64                 `json:"total_received"`        // 总收到互动数
		TotalPointsGiven    string                `json:"total_points_given"`    // 发出互动总积分
		TotalPointsReceived string                `json:"total_points_received"` // 收到互动总积分
	} `json:"response"` // 接口响应主体
}

type LoyaltyRewardsSummaryBriefInfo struct {
	CurrentPoints string `json:"current_points"` // 当前剩余点数
	EarnedPoints  string `json:"earned_points"`  // 累计获得点数
	SpentPoints   string `json:"spent_points"`   // 累计消耗点数
	UpdatedAt     int64  `json:"updated_at"`     // 最后更新时间戳（秒级）
}

type OwnedGame struct {
	AppID                  uint64 `json:"app_id"`               // 游戏ID
	Name                   string `json:"name"`                 // 游戏名称
	PlaytimeForever        int    `json:"playtime_forever"`     // 总游玩时长(分钟)
	Playtime2Weeks         int    `json:"playtime_2weeks"`      // 近2周游玩时长(分钟)
	IconURL                string `json:"icon_url"`             // 游戏图标完整URL
	CapsuleURL             string `json:"capsule_url"`          // 游戏封面完整URL
	LastPlayedTime         int64  `json:"last_played_time"`     // 最后游玩时间戳
	LastPlayedTimeStr      string `json:"last_played_time_str"` // 最后游玩时间格式化字符串
	HasCommunityVisible    bool   `json:"has_community_visb"`   // 社区可见性
	PlaytimeWindowsForever int    `json:"playtime_windows"`     // Windows端时长
	PlaytimeDeckForever    int    `json:"playtime_deck"`        // SteamDeck端时长
	HasDLC                 bool   `json:"has_dlc"`              // 是否有DLC
}

type Player struct {
	SteamID      string `json:"steam_id"`      // Steam唯一ID
	PersonaName  string `json:"persona_name"`  // 昵称
	ProfileURL   string `json:"profile_url"`   // 个人主页链接
	AvatarURL    string `json:"avatar_url"`    // 小尺寸头像
	AvatarMedium string `json:"avatar_medium"` // 半尺寸头像
	AvatarFull   string `json:"avatar_full"`   // 全尺寸头像
	TimeCreated  string `json:"time_created"`  // 账号创建时间
	LastLogoff   string `json:"last_logoff"`   // 最后离线时间
	IsOnline     bool   `json:"is_online"`     // 是否在线
	RealName     string `json:"real_name"`     // 真实姓名
	CountryCode  string `json:"country_code"`  // 国家码
}

type PlayerAchievement struct {
	SteamID         string `json:"steam_id"`         // 玩家SteamID
	GameName        string `json:"game_name"`        // 游戏名称
	AppID           uint64 `json:"app_id"`           // 游戏ID
	AchievementAPI  string `json:"achievement_api"`  // 成就唯一标识
	AchievementName string `json:"achievement_name"` // 成就名称
	Achieved        bool   `json:"achieved"`         // 是否完成
	UnlockTime      int64  `json:"unlock_time"`      // 解锁时间戳
	UnlockTimeStr   string `json:"unlock_time_str"`  // 解锁时间格式化字符串
	Description     string `json:"description"`      // 成就描述
}

type ProfileItemBriefInfo struct {
	ID            int64  `json:"id"`              // 道具定义ID
	AppID         int64  `json:"app_id"`          // 所属应用ID
	Name          string `json:"name"`            // 道具名称
	Title         string `json:"title"`           // 道具标题
	Description   string `json:"description"`     // 道具描述
	PointCost     string `json:"point_cost"`      // 所需积分
	IsActive      bool   `json:"is_active"`       // 是否装备中
	IsAnimated    bool   `json:"is_animated"`     // 是否动画效果
	LargeImageURL string `json:"large_image_url"` // 大尺寸图片完整地址
	SmallImageURL string `json:"small_image_url"` // 小尺寸图片完整地址
	WebmMovieURL  string `json:"webm_movie_url"`  // WebM 动画完整地址
	Mp4MovieURL   string `json:"mp4_movie_url"`   // MP4 动画完整地址
}

type ProfileItemDefinition struct {
	AppID                 int64             `json:"appid"`                   // 应用ID
	DefID                 int64             `json:"defid"`                   // 道具定义ID
	Type                  int               `json:"type"`                    // 道具类型标识
	CommunityItemClass    int               `json:"community_item_class"`    // 社区道具分类
	CommunityItemType     int               `json:"community_item_type"`     // 社区道具类型
	PointCost             string            `json:"point_cost"`              // 所需积分
	TimestampCreated      int64             `json:"timestamp_created"`       // 创建时间戳
	TimestampUpdated      int64             `json:"timestamp_updated"`       // 更新时间戳
	TimestampAvailable    int64             `json:"timestamp_available"`     // 可用开始时间戳
	TimestampAvailableEnd int64             `json:"timestamp_available_end"` // 可用结束时间戳
	Quantity              string            `json:"quantity"`                // 数量
	InternalDescription   string            `json:"internal_description"`    // 内部描述
	Active                bool              `json:"active"`                  // 是否激活
	CommunityItemData     CommunityItemData `json:"community_item_data"`     // 社区道具详情
	UsableDuration        int               `json:"usable_duration"`         // 可用时长
	BundleDiscount        int               `json:"bundle_discount"`         // 捆绑折扣
}

type ReactionSummaryBriefInfo struct {
	ReactionID     int64  `json:"reaction_id"`     // 互动类型ID
	Given          int64  `json:"given"`           // 发出该类型互动数
	Received       int64  `json:"received"`        // 收到该类型互动数
	PointsGiven    string `json:"points_given"`    // 发出该类型互动获得积分
	PointsReceived string `json:"points_received"` // 收到该类型互动获得积分
	IconURL        string `json:"icon_url"`        // 互动类型图标地址
}

type ReactionSummaryItem struct {
	ReactionID     int64  `json:"reactionid"`      // 互动类型ID
	Given          int64  `json:"given"`           // 发出该类型互动数
	Received       int64  `json:"received"`        // 收到该类型互动数
	PointsGiven    string `json:"points_given"`    // 发出该类型互动获得积分
	PointsReceived string `json:"points_received"` // 收到该类型互动获得积分
}

type SharedAppBrief struct {
	AppID          uint64   `json:"appid"`            // 共享应用的Steam AppID
	OwnerSteamIDs  []string `json:"owner_steamids"`   // 该应用的拥有者ID
	Name           string   `json:"name"`             // 应用名称
	Cover          string   `json:"cover"`            // 应用封面图文件名
	Icon           string   `json:"icon"`             // 应用图标哈希值
	ExcludeReason  int      `json:"exclude_reason"`   // 排除共享的原因标识(0=可正常共享)
	RtTimeAcquired string   `json:"rt_time_acquired"` // 应用获取时间戳
	RtLastPlayed   string   `json:"rt_last_played"`   // 最近一次游玩时间戳
	RtPlaytime     int64    `json:"rt_playtime"`      // 累计游玩时长(分钟)
	AppType        int      `json:"app_type"`         // 应用类型标识 1=游戏 2=软件
}

type SteamOwnedGamesResponse struct {
	Response struct {
		GameCount int `json:"game_count"` // 游戏总数
		Games     []struct {
			AppID                  uint64 `json:"appid"`                       // 游戏唯一ID
			Name                   string `json:"name"`                        // 游戏名称
			Playtime2Weeks         int    `json:"playtime_2weeks"`             // 近2周游玩时长(分钟)
			PlaytimeForever        int    `json:"playtime_forever"`            // 总游玩时长(分钟)
			ImgIconURL             string `json:"img_icon_url"`                // 游戏图标哈希(小图标)
			HasCommunityVisible    bool   `json:"has_community_visible_stats"` // 是否显示社区统计
			PlaytimeWindowsForever int    `json:"playtime_windows_forever"`    // Windows端总时长
			PlaytimeMacForever     int    `json:"playtime_mac_forever"`        // Mac端总时长
			PlaytimeLinuxForever   int    `json:"playtime_linux_forever"`      // Linux端总时长
			PlaytimeDeckForever    int    `json:"playtime_deck_forever"`       // SteamDeck端总时长
			RTimeLastPlayed        int64  `json:"rtime_last_played"`           // 最后游玩时间戳
			CapsuleFilename        string `json:"capsule_filename"`            // 封面图文件名
			HasWorkshop            bool   `json:"has_workshop"`                // 是否有创意工坊
			HasMarket              bool   `json:"has_market"`                  // 是否有市场
			HasDLC                 bool   `json:"has_dlc"`                     // 是否有DLC
			ContentDescriptorIDs   []int  `json:"content_descriptorids"`
			PlaytimeDisconnected   int    `json:"playtime_disconnected"` // 离线游玩时长
		} `json:"games"`
	} `json:"response"`
}

type SteamPlayerAchievementsResponse struct {
	PlayerStats struct {
		SteamID      string `json:"steamID"`  // 玩家SteamID
		GameName     string `json:"gameName"` // 游戏名称
		Achievements []struct {
			APIName     string `json:"apiname"`     // 成就唯一标识
			Achieved    int    `json:"achieved"`    // 是否完成: 1=完成, 0=未完成
			UnlockTime  int64  `json:"unlocktime"`  // 解锁时间戳
			Name        string `json:"name"`        // 成就名称
			Description string `json:"description"` // 成就描述
		} `json:"achievements"`
		Success bool `json:"success"` // 请求是否成功
	} `json:"playerstats"`
}

type SteamPlayerResponse struct {
	Response struct {
		Players []struct {
			SteamID                  string `json:"steamid"`                  // Steam 账号唯一 ID
			CommunityVisibilityState int    `json:"communityvisibilitystate"` // 社区可见性
			ProfileState             int    `json:"profilestate"`
			PersonaName              string `json:"personaname"`       // 用户显示名称
			CommentPermission        int    `json:"commentpermission"` // 评论权限: 1=允许, 0=禁止
			ProfileURL               string `json:"profileurl"`        // 个人主页地址
			Avatar                   string `json:"avatar"`            // 小尺寸头像URL
			AvatarMedium             string `json:"avatarmedium"`      // 半尺寸头像URL
			AvatarFull               string `json:"avatarfull"`        // 全尺寸头像URL
			AvatarHash               string `json:"avatarhash"`        // 头像哈希值
			LastLogoff               int64  `json:"lastlogoff"`        // 最后离线时间戳
			PersonaState             int    `json:"personastate"`      // 在线状态: 0=离线 1=在线
			RealName                 string `json:"realname"`          // 真实姓名(用户填写)
			PrimaryClanID            string `json:"primaryclanid"`     // 主要所属群组 ID
			TimeCreated              int64  `json:"timecreated"`       // 账号创建时间戳
			PersonaStateFlags        int    `json:"personastateflags"`
			LocCountryCode           string `json:"loccountrycode"` // 国家码
			LocStateCode             string `json:"locstatecode"`   // 省份/州码
			LocCityID                int    `json:"loccityid"`      // 城市ID
		} `json:"players"`
	} `json:"response"`
}

type SteamServerResponse struct {
	Server a2s.ServerInfo `json:"server"`
	Player a2s.PlayerInfo `json:"player"`
	Rules  a2s.RulesInfo  `json:"rules"`
}

type SteamStoreTokenResponse struct {
	Data struct {
		WebapiToken string `json:"webapi_token"` // 成就唯一标识
	} `json:"data"`
	Success int `json:"success"` // 请求是否成功
}

type SteamUserCartResponse struct {
	Response struct {
		Cart struct {
			LineItems []struct {
				LineItemID     string `json:"line_item_id"`
				Type           int    `json:"type"`
				PackageID      int    `json:"packageid"`  // 促销包裹ID
				IsValid        bool   `json:"is_valid"`   // 是否有效
				TimeAdded      int64  `json:"time_added"` // 添加时间
				PriceWhenAdded struct {
					AmountInCents   string `json:"amount_in_cents"`  // 价格
					CurrencyCode    int    `json:"currency_code"`    // 货币码
					FormattedAmount string `json:"formatted_amount"` // 格式化金额
				} `json:"price_when_added"` // 添加时的价格
				Flags struct {
					IsGift    bool `json:"is_gift"`    // 是否为礼物
					IsPrivate bool `json:"is_private"` // 是否私有
				} `json:"flags"` // 标识
			} `json:"line_items"` // 购物车行项目列表
			Subtotal struct {
				AmountInCents   string `json:"amount_in_cents"`  // 小计金额
				CurrencyCode    int    `json:"currency_code"`    // 货币编码
				FormattedAmount string `json:"formatted_amount"` // 格式化小计金额
			} `json:"subtotal"` // 购物车小计
			IsValid bool `json:"is_valid"` // 购物车是否有效
		} `json:"cart"` // 购物车信息
	} `json:"response"` // 响应主体
}

type SubscriptionBillCountResponse struct {
	Response struct {
		ActiveSubscriptionsCount   int64 `json:"active_subscriptions_count"`   // 激活的订阅数量
		InactiveSubscriptionsCount int64 `json:"inactive_subscriptions_count"` // 未激活的订阅数量
	} `json:"response"`
}

type UserCart struct {
	Items          []CartItem `json:"items"`           // 购物车物品
	TotalPrice     string     `json:"total_price"`     // 总价
	FormattedTotal string     `json:"formatted_total"` // 格式化的总价
}

type UserReactionsTotalBrief struct {
	TotalGiven          int64  `json:"total_given"`           // 总发出互动数
	TotalReceived       int64  `json:"total_received"`        // 总收到互动数
	TotalPointsGiven    string `json:"total_points_given"`    // 发出互动总积分
	TotalPointsReceived string `json:"total_points_received"` // 收到互动总积分
	// 各分类互动精简列表
	Total       []ReactionSummaryBriefInfo `json:"total"`        // 所有互动类型汇总
	UserReviews []ReactionSummaryBriefInfo `json:"user_reviews"` // 用户评论互动汇总
	UGC         []ReactionSummaryBriefInfo `json:"ugc"`          // UGC内容互动汇总
	Profile     []ReactionSummaryBriefInfo `json:"profile"`      // 个人资料互动汇总
}