// Package utils 提供通用工具函数
// 包括统一的 JSON 响应格式化、错误处理等
package utils

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

// Response 统一API响应结构体
type Response struct {
	Code    int         `json:"code"`    // 业务状态码：0=成功，非0=失败
	Message string      `json:"message"` // 提示信息
	Data    interface{} `json:"data"`    // 响应数据，可以是任意类型
}

// Success 返回成功响应
// c: Gin上下文
// data: 响应数据
func Success(c *gin.Context, data interface{}) {
	c.JSON(http.StatusOK, Response{
		Code:    0,
		Message: "success",
		Data:    data,
	})
}

// SuccessWithMessage 返回带自定义消息的成功响应
// c: Gin上下文
// message: 自定义提示信息
// data: 响应数据
func SuccessWithMessage(c *gin.Context, message string, data interface{}) {
	c.JSON(http.StatusOK, Response{
		Code:    0,
		Message: message,
		Data:    data,
	})
}

// Error 返回错误响应
// c: Gin上下文
// code: 业务错误码（非0）
// message: 错误提示信息
func Error(c *gin.Context, code int, message string) {
	c.JSON(http.StatusOK, Response{
		Code:    code,
		Message: message,
		Data:    nil,
	})
}

// ErrorWithHTTP 返回带HTTP状态码的错误响应
// c: Gin上下文
// httpCode: HTTP状态码
// code: 业务错误码
// message: 错误提示信息
func ErrorWithHTTP(c *gin.Context, httpCode int, code int, message string) {
	c.JSON(httpCode, Response{
		Code:    code,
		Message: message,
		Data:    nil,
	})
}

// PageResult 分页查询结果结构体
type PageResult struct {
	List     interface{} `json:"list"`     // 数据列表
	Total    int64       `json:"total"`    // 总记录数
	Page     int         `json:"page"`     // 当前页码
	PageSize int         `json:"pageSize"` // 每页条数
}

// SuccessPage 返回分页查询成功响应
// c: Gin上下文
// list: 数据列表
// total: 总记录数
// page: 当前页码
// pageSize: 每页条数
func SuccessPage(c *gin.Context, list interface{}, total int64, page, pageSize int) {
	Success(c, PageResult{
		List:     list,
		Total:    total,
		Page:     page,
		PageSize: pageSize,
	})
}