user

type ChangePasswordResponse struct {
	Updated bool `json:"updated"`
}

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type DeletedResponse struct {
	Deleted bool `json:"deleted"`
}

type Error = ErrorResponse

type ErrorResponse struct {
	Error string `json:"error"`
}

type ErrorType string

type ForgotPasswordRequest struct {
	Email string `json:"email"`
}

type GetUserErrLogsParams struct {
	Limit      *int           `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor     *int64         `form:"cursor,omitempty" json:"cursor,omitempty"`
	GroupId    *int64         `form:"group_id,omitempty" json:"group_id,omitempty"`
	KeyId      *int64         `form:"key_id,omitempty" json:"key_id,omitempty"`
	Model      *string        `form:"model,omitempty" json:"model,omitempty"`
	Format     *RequestFormat `form:"format,omitempty" json:"format,omitempty"`
	StatusCode *int           `form:"status_code,omitempty" json:"status_code,omitempty"`
	ErrorType  *string        `form:"error_type,omitempty" json:"error_type,omitempty"`
	From       time.Time      `form:"from" json:"from"`
	To         time.Time      `form:"to" json:"to"`
}

type GetUserKeysParams struct {
	Limit  *int                    `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int                    `form:"offset,omitempty" json:"offset,omitempty"`
	Name   *string                 `form:"name,omitempty" json:"name,omitempty"`
	Sort   *string                 `form:"sort,omitempty" json:"sort,omitempty"`
	Order  *GetUserKeysParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetUserKeysParamsOrder string

type GetUserRedemptionsParams struct {
	Page     *int                           `form:"page,omitempty" json:"page,omitempty"`
	PageSize *int                           `form:"page_size,omitempty" json:"page_size,omitempty"`
	Sort     *string                        `form:"sort,omitempty" json:"sort,omitempty"`
	Order    *GetUserRedemptionsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetUserRedemptionsParamsOrder string

type GetUserStatsParams struct {
	From        time.Time                      `form:"from" json:"from"`
	To          time.Time                      `form:"to" json:"to"`
	Granularity *GetUserStatsParamsGranularity `form:"granularity,omitempty" json:"granularity,omitempty"`
	Model       *string                        `form:"model,omitempty" json:"model,omitempty"`
}

type GetUserStatsParamsGranularity string

type GetUserStatsTTFTParams struct {
	From  time.Time `form:"from" json:"from"`
	To    time.Time `form:"to" json:"to"`
	Model *string   `form:"model,omitempty" json:"model,omitempty"`
}

type GetUserUsageLogsParams struct {
	Limit     *int           `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor    *int64         `form:"cursor,omitempty" json:"cursor,omitempty"`
	GroupId   *int64         `form:"group_id,omitempty" json:"group_id,omitempty"`
	KeyId     *int64         `form:"key_id,omitempty" json:"key_id,omitempty"`
	Model     *string        `form:"model,omitempty" json:"model,omitempty"`
	Format    *RequestFormat `form:"format,omitempty" json:"format,omitempty"`
	ErrorType *string        `form:"error_type,omitempty" json:"error_type,omitempty"`
	From      time.Time      `form:"from" json:"from"`
	To        time.Time      `form:"to" json:"to"`
}

type Group struct {
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表/消费路径过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`
	ID        *int64     `json:"ID,omitempty"`
	Name      *string    `json:"Name,omitempty"`

	// PriceMultiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与万分数换算——存储 15000 ↔ 显示 1.5）
	PriceMultiplier *float64 `json:"PriceMultiplier,omitempty"`

	// ProtocolConvert 协议转换方向集合（空数组 = off = 不转换；多方向按客户端格式命中）
	ProtocolConvert *[]GroupProtocolConvert `json:"ProtocolConvert,omitempty"`
	UpdatedAt       *time.Time              `json:"UpdatedAt,omitempty"`
	Visibility      *GroupVisibility        `json:"Visibility,omitempty"`
}

type GroupProtocolConvert string

type GroupVisibility string

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type Key struct {
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表/鉴权过滤已删；GET 单个可查已删项）
	DeletedAt      *time.Time `json:"DeletedAt"`
	GroupID        *int64     `json:"GroupID,omitempty"`
	ID             *int64     `json:"ID,omitempty"`
	MaxConcurrency *int       `json:"MaxConcurrency,omitempty"`
	Name           *string    `json:"Name,omitempty"`

	// Quota 累计 token 上限；0 = 不限
	Quota *int64 `json:"Quota,omitempty"`

	// QuotaUsed 已消耗（后扣；无额度 key 恒 0）
	QuotaUsed *int64     `json:"QuotaUsed,omitempty"`
	Status    *KeyStatus `json:"Status,omitempty"`
	UpdatedAt *time.Time `json:"UpdatedAt,omitempty"`
	UserID    *int64     `json:"UserID,omitempty"`

	// Key key 明文（长期可查看/复制；DB 泄露即暴露——自托管权衡，用户裁决）
	Key *string `json:"key,omitempty"`
}

type KeyCreate struct {
	GroupId int64 `json:"group_id"`

	// MaxConcurrency 单 key 在途上限；0 = 不限
	MaxConcurrency *int   `json:"max_concurrency,omitempty"`
	Name           string `json:"name"`

	// Quota 累计 token 上限；0 = 不限
	Quota *int64 `json:"quota,omitempty"`
}

type KeyListResponse struct {
	Rows  []Key `json:"rows"`
	Total int64 `json:"total"`
}

type KeyStatus string

type KeyUpdate struct {
	MaxConcurrency *int       `json:"max_concurrency,omitempty"`
	Name           *string    `json:"name,omitempty"`
	Quota          *int64     `json:"quota,omitempty"`
	Status         *KeyStatus `json:"status,omitempty"`
}

type MiddlewareFunc func(http.Handler) http.Handler

type PostUserAuthChangePasswordJSONRequestBody = UserAuthChangePassword

type PostUserAuthForgotPasswordJSONRequestBody = ForgotPasswordRequest

type PostUserAuthLoginJSONRequestBody = UserAuthLogin

type PostUserAuthRegisterCodeJSONRequestBody = RegisterCodeRequest

type PostUserAuthRegisterJSONRequestBody = UserAuthRegister

type PostUserAuthResetPasswordJSONRequestBody = ResetPasswordRequest

type PostUserKeysJSONRequestBody = KeyCreate

type PostUserRedemptionsJSONRequestBody = RedeemRequest

type PutUserKeysIdJSONRequestBody = KeyUpdate

type RedeemRequest struct {
	Code string `json:"code"`
}

type RedeemResponse struct {
	Applied struct {
		ResourceExpiresAt *time.Time     `json:"resource_expires_at"`
		Type              RedemptionType `json:"type"`

		// Value 兑换时的值快照（同面值单位语义）
		Value float64 `json:"value"`
	} `json:"applied"`
}

type RedemptionRecord struct {
	Code              string         `json:"Code"`
	CodeID            int64          `json:"CodeID"`
	CodeType          RedemptionType `json:"CodeType"`
	CreatedAt         time.Time      `json:"CreatedAt"`
	ID                int64          `json:"ID"`
	Remark            *string        `json:"Remark"`
	ResourceExpiresAt *time.Time     `json:"ResourceExpiresAt"`

	// Value 兑换时的值快照（同面值单位语义）
	Value float64 `json:"Value"`
}

type RedemptionRecordListResponse struct {
	Rows  []RedemptionRecord `json:"rows"`
	Total int64              `json:"total"`
}

type RedemptionType string

type RegisterCodeRequest struct {
	Email string `json:"email"`
}

type RequestFormat string

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type ResetPasswordRequest struct {
	Code        string `json:"code"`
	Email       string `json:"email"`
	NewPassword string `json:"new_password"`
}

type SentResponse struct {
	Sent bool `json:"sent"`
}

type ServerInterface interface {
	// 修改密码（旧密码校验复用登录语义——失败 401 同登录文案防枚举；新密码非空且 ≤72 字节，非法 400；不撤销既有 JWT，新密码下次登录生效）
	// (POST /api/user/auth/change-password)
	PostUserAuthChangePassword(w http.ResponseWriter, r *http.Request)
	// 忘记密码发码（恒 200 {sent:true}，反枚举——无论账号是否存在或邮件是否启用）
	// (POST /api/user/auth/forgot-password)
	PostUserAuthForgotPassword(w http.ResponseWriter, r *http.Request)
	// 登录（bcrypt 校验 → JWT）
	// (POST /api/user/auth/login)
	PostUserAuthLogin(w http.ResponseWriter, r *http.Request)
	// 当前用户信息（JWT）
	// (GET /api/user/auth/me)
	GetUserAuthMe(w http.ResponseWriter, r *http.Request)
	// 注册（signup_enabled 开关检查；注册即登录返回 JWT）
	// (POST /api/user/auth/register)
	PostUserAuthRegister(w http.ResponseWriter, r *http.Request)
	// 发送注册验证码（signup_enabled  gate 403；已注册静默抑制仍 200；限频 429）
	// (POST /api/user/auth/register-code)
	PostUserAuthRegisterCode(w http.ResponseWriter, r *http.Request)
	// 重置密码（验证码校验→更新密码；不撤销既有 JWT）
	// (POST /api/user/auth/reset-password)
	PostUserAuthResetPassword(w http.ResponseWriter, r *http.Request)
	// 我的错误明细（err_logs 完整错误面：拒绝 + 异常双轨；强制 user_id = 当前用户，防越权）
	// (GET /api/user/err_logs)
	GetUserErrLogs(w http.ResponseWriter, r *http.Request, params GetUserErrLogsParams)
	// 可选组列表（public 全部 + 已授予 private；只读，key 创建时选组）
	// (GET /api/user/groups)
	GetUserGroups(w http.ResponseWriter, r *http.Request)
	// 我的 key 列表（分页/排序；key 明文长期可查看/复制）
	// (GET /api/user/keys)
	GetUserKeys(w http.ResponseWriter, r *http.Request, params GetUserKeysParams)
	// 创建 key（组可选性校验：public 或已授予 private；明文长期回显）
	// (POST /api/user/keys)
	PostUserKeys(w http.ResponseWriter, r *http.Request)
	// 删除 key（仅本人；Auth 快照增量移除——立即失效）
	// (DELETE /api/user/keys/{id})
	DeleteUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// key 详情（仅本人；他人 key → 404）
	// (GET /api/user/keys/{id})
	GetUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 更新 key（name/status/max_concurrency/quota；仅本人）
	// (PUT /api/user/keys/{id})
	PutUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 轮换 key（仅本人；新明文生效，旧 key 立即失效）
	// (POST /api/user/keys/{id}/rotate)
	PostUserKeysIdRotate(w http.ResponseWriter, r *http.Request, id int64)
	// 我的兑换记录（use 快照 + 码的 type/remark 联查；强制 user_id = 当前用户，防越权）
	// (GET /api/user/redemptions)
	GetUserRedemptions(w http.ResponseWriter, r *http.Request, params GetUserRedemptionsParams)
	// 兑换码（400 invalid code：不存在/失效/过期/用尽，统一不泄露细节；409 already redeemed 重复兑换）
	// (POST /api/user/redemptions)
	PostUserRedemptions(w http.ResponseWriter, r *http.Request)
	// 我的用量统计（强制 user_id = 当前用户）
	// (GET /api/user/stats)
	GetUserStats(w http.ResponseWriter, r *http.Request, params GetUserStatsParams)
	// 我的 TTFT 聚合（强制 user_id = 当前用户）
	// (GET /api/user/stats/ttft)
	GetUserStatsTTFT(w http.ResponseWriter, r *http.Request, params GetUserStatsTTFTParams)
	// 我的临时额度（仅有效额度：未过期且正余额，用尽/过期隐藏；expires_at 升序 FEFO 同序、永久最后；强制 user_id = 当前用户，无 user_id 参数防越权）
	// (GET /api/user/temp-balances)
	GetUserTempBalances(w http.ResponseWriter, r *http.Request)
	// 我的用量明细（usage_logs 纯计费明细；强制 user_id = 当前用户，防越权；error_type 值域 none/abort）
	// (GET /api/user/usage_logs)
	GetUserUsageLogs(w http.ResponseWriter, r *http.Request, params GetUserUsageLogsParams)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StatTTFTSummary struct {
	AvgMS  float64               `json:"AvgMS"`
	Count  int64                 `json:"Count"`
	MaxMS  int64                 `json:"MaxMS"`
	P50MS  int64                 `json:"P50MS"`
	P95MS  int64                 `json:"P95MS"`
	P99MS  int64                 `json:"P99MS"`
	Source StatTTFTSummarySource `json:"Source"`
}

type StatTTFTSummarySource string

type StatTrendPoint struct {
	BucketTime          *time.Time `json:"BucketTime,omitempty"`
	CacheCreationTokens *int64     `json:"CacheCreationTokens,omitempty"`
	CacheReadTokens     *int64     `json:"CacheReadTokens,omitempty"`
	CallCount           *int64     `json:"CallCount,omitempty"`

	// Cost 成本 USD（毫分 /1e5）
	Cost         *float64 `json:"Cost,omitempty"`
	ErrorCount   *int64   `json:"ErrorCount,omitempty"`
	InputTokens  *int64   `json:"InputTokens,omitempty"`
	OutputTokens *int64   `json:"OutputTokens,omitempty"`

	// RawCost 原始成本 USD（毫分 /1e5）
	RawCost      *float64 `json:"RawCost,omitempty"`
	RequestCount *int64   `json:"RequestCount,omitempty"`

	// TTFTAvgMS TTFT 平均毫秒（TTFTTotalMS/TTFTCount，无样本 0）
	TTFTAvgMS *float64 `json:"TTFTAvgMS,omitempty"`

	// TTFTMaxMS TTFT 最大毫秒
	TTFTMaxMS   *int64 `json:"TTFTMaxMS,omitempty"`
	TotalTokens *int64 `json:"TotalTokens,omitempty"`
}

type TempBalanceRow struct {
	// AmountUsd 金额 USD（毫分 /1e5；1 USD = 100,000 毫分）
	AmountUsd float64 `json:"amount_usd"`

	// ExpiresAt 到期时间；null = 永久额度
	ExpiresAt *time.Time `json:"expires_at"`
	Id        int64      `json:"id"`

	// Note 固定系统备注（signup bonus / redemption code），无敏感信息
	Note *string `json:"note"`
}

type TempBalancesResponse struct {
	Rows []TempBalanceRow `json:"rows"`

	// TotalUsd 有效额度合计 USD（毫分 Σ /1e5；0 = 无有效额度）
	TotalUsd float64 `json:"total_usd"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type User struct {
	// Balance 余额 USD（浮点；内部存储毫分——1 USD = 100,000 毫分，API 边界换算）
	Balance        *float64    `json:"Balance,omitempty"`
	CreatedAt      *time.Time  `json:"CreatedAt,omitempty"`
	Email          *string     `json:"Email,omitempty"`
	ID             *int64      `json:"ID,omitempty"`
	MaxConcurrency *int        `json:"MaxConcurrency,omitempty"`
	Role           *UserRole   `json:"Role,omitempty"`
	Status         *UserStatus `json:"Status,omitempty"`
	UpdatedAt      *time.Time  `json:"UpdatedAt,omitempty"`
}

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

type UserAuthChangePassword struct {
	// NewPassword 非空且 ≤72 字节（bcrypt 截断限制），非法 400
	NewPassword string `json:"new_password"`
	OldPassword string `json:"old_password"`
}

type UserAuthLogin struct {
	Email    string `json:"email"`
	Password string `json:"password"`
}

type UserAuthRegister struct {
	// Code 可选：邮箱验证码（mail.register_verification 开启时必填，否则 400 email verification required）
	Code     *string `json:"code,omitempty"`
	Email    string  `json:"email"`
	Password string  `json:"password"`
}

type UserAuthResponse struct {
	Token string `json:"token"`
	User  User   `json:"user"`
}

type UserErrLog struct {
	// BillingTier 计费档位（service_tier 归一化：priority/flex/fast/auto）；null = 未计费路径
	BillingTier *string `json:"BillingTier"`

	// ClientIP 客户端 IP（CF-Connecting-IP / True-Client-IP / X-Real-IP 按序识别；无则 RemoteAddr 剥端口）；空 = 无
	ClientIP  *string    `json:"ClientIP,omitempty"`
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// ErrorMessage 错误文本（拒绝文案/上游 body，域内截断 500 字符）；null = 无错误文本
	ErrorMessage *string        `json:"ErrorMessage"`
	ErrorType    *ErrorType     `json:"ErrorType,omitempty"`
	Format       *RequestFormat `json:"Format,omitempty"`
	GroupID      *int64         `json:"GroupID,omitempty"`
	ID           *int64         `json:"ID,omitempty"`

	// KeyID 鉴权归属 key；0 = 无
	KeyID     *int64  `json:"KeyID,omitempty"`
	LatencyMS *int64  `json:"LatencyMS,omitempty"`
	Model     *string `json:"Model,omitempty"`
	RequestID *string `json:"RequestID,omitempty"`

	// StatusCode 错误状态码（完整错误面；0 = 连接级）
	StatusCode *int `json:"StatusCode,omitempty"`

	// UserID 鉴权归属用户；0 = 无
	UserID *int64 `json:"UserID,omitempty"`
}

type UserErrLogsResponse struct {
	// NextCursor 下一页游标（本页最后一条 id）；null = 无更多行
	NextCursor *int64       `json:"next_cursor"`
	Rows       []UserErrLog `json:"rows"`
}

type UserLogsResponse struct {
	// NextCursor 下一页游标（本页最后一条 id）；null = 无更多行
	NextCursor *int64         `json:"next_cursor"`
	Rows       []UserUsageLog `json:"rows"`
}

type UserRole string

type UserStatus string

type UserUsageLog struct {
	// AboveHit 任一分量超 above 阈值命中分段
	AboveHit *bool `json:"AboveHit,omitempty"`

	// BillingTier 请求 service_tier 归一化值（priority/flex/fast/auto）；空 = 未计费路径
	BillingTier         *string `json:"BillingTier,omitempty"`
	CacheCreationTokens *int64  `json:"CacheCreationTokens,omitempty"`
	CacheReadTokens     *int64  `json:"CacheReadTokens,omitempty"`

	// ClientIP 客户端 IP（CF-Connecting-IP / True-Client-IP / X-Real-IP 按序识别；无则 RemoteAddr 剥端口）；空 = 无
	ClientIP *string `json:"ClientIP,omitempty"`

	// Cost 计费成本（毫分，1 USD = 100,000 毫分）；错误请求（402/4xx）为 0
	Cost        *int64         `json:"Cost,omitempty"`
	CreatedAt   *time.Time     `json:"CreatedAt,omitempty"`
	ErrorType   *ErrorType     `json:"ErrorType,omitempty"`
	Format      *RequestFormat `json:"Format,omitempty"`
	GroupID     *int64         `json:"GroupID,omitempty"`
	ID          *int64         `json:"ID,omitempty"`
	InputTokens *int64         `json:"InputTokens,omitempty"`

	// KeyID 鉴权归属 key；0 = 无
	KeyID        *int64  `json:"KeyID,omitempty"`
	LatencyMS    *int64  `json:"LatencyMS,omitempty"`
	MappedModel  *string `json:"MappedModel"`
	Model        *string `json:"Model,omitempty"`
	OutputTokens *int64  `json:"OutputTokens,omitempty"`

	// Overdraft 本次扣费透支（余额不足扣为负余额）
	Overdraft *bool `json:"Overdraft,omitempty"`

	// PriceCacheCreationMillis 缓存写单价快照（每 M token 毫分）；null = 该请求无缓存写或无缓存价
	PriceCacheCreationMillis *int64 `json:"PriceCacheCreationMillis"`

	// PriceCacheReadMillis 缓存读单价快照（每 M token 毫分）；null = 该请求无缓存读或无缓存价
	PriceCacheReadMillis *int64 `json:"PriceCacheReadMillis"`

	// PriceInputMillis 输入单价快照（每 M token 毫分，1 USD = 100,000 毫分；pricing 同款单位）；null = 未计费路径
	PriceInputMillis *int64 `json:"PriceInputMillis"`

	// PriceOutputMillis 输出单价快照（每 M token 毫分）；null = 未计费路径
	PriceOutputMillis *int64 `json:"PriceOutputMillis"`

	// RawCost 原始成本（毫分，乘倍率前——免费组 cost=0 但 raw 有值，实际消耗口径）；bill 未装配/无价防御路径恒 0
	RawCost   *int64  `json:"RawCost,omitempty"`
	RequestID *string `json:"RequestID,omitempty"`

	// TTFTMS 首 token 时间毫秒（流式首 chunk 采集）；非流式/失败/无首 token 路径 = null
	TTFTMS      *int64 `json:"TTFTMS"`
	TotalTokens *int64 `json:"TotalTokens,omitempty"`

	// UserID 鉴权归属用户；0 = 无
	UserID *int64 `json:"UserID,omitempty"`
}