/**
 * API响应格式标准化工具
 * 统一前后端接口返回格式
 */

/**
 * 标准API响应格式
 * @typedef {Object} ApiResponse
 * @property {boolean} success - 请求是否成功
 * @property {string} message - 响应消息
 * @property {*} data - 响应数据
 * @property {number} total - 总记录数（分页时使用）
 * @property {number} page - 当前页码（分页时使用）
 * @property {number} limit - 每页记录数（分页时使用）
 * @property {Object} meta - 元数据（可选）
 * @property {string} timestamp - 响应时间戳
 * @property {string} requestId - 请求ID（用于追踪）
 */

/**
 * 创建标准成功响应
 * @param {*} data - 响应数据
 * @param {string} message - 响应消息
 * @param {Object} options - 其他选项
 * @returns {ApiResponse} 标准响应格式
 */
export const createSuccessResponse = (data = null, message = '操作成功', options = {}) => {
  const response = {
    success: true,
    message,
    data,
    timestamp: new Date().toISOString(),
    requestId: options.requestId || generateRequestId()
  };

  // 添加分页信息
  if (options.total !== undefined) {
    response.total = options.total;
  }
  if (options.page !== undefined) {
    response.page = options.page;
  }
  if (options.limit !== undefined) {
    response.limit = options.limit;
  }

  // 添加元数据
  if (options.meta) {
    response.meta = options.meta;
  }

  return response;
};

/**
 * 创建标准错误响应
 * @param {string} message - 错误消息
 * @param {string} code - 错误代码
 * @param {*} details - 错误详情
 * @param {Object} options - 其他选项
 * @returns {ApiResponse} 标准错误响应格式
 */
export const createErrorResponse = (message = '操作失败', code = 'UNKNOWN_ERROR', details = null, options = {}) => {
  return {
    success: false,
    message,
    code,
    details,
    timestamp: new Date().toISOString(),
    requestId: options.requestId || generateRequestId()
  };
};

/**
 * 创建分页响应
 * @param {Array} data - 数据列表
 * @param {number} total - 总记录数
 * @param {number} page - 当前页码
 * @param {number} limit - 每页记录数
 * @param {string} message - 响应消息
 * @param {Object} options - 其他选项
 * @returns {ApiResponse} 分页响应格式
 */
export const createPaginatedResponse = (data, total, page, limit, message = '获取数据成功', options = {}) => {
  return createSuccessResponse(data, message, {
    total,
    page,
    limit,
    ...options
  });
};

/**
 * 生成请求ID
 * @returns {string} 请求ID
 */
const generateRequestId = () => {
  return `req_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
};

/**
 * 验证API响应格式
 * @param {*} response - 响应对象
 * @returns {boolean} 是否为标准格式
 */
export const isValidApiResponse = (response) => {
  // 基本格式检查：必须有 success 和 message 字段
  // timestamp 为可选字段（兼容旧接口）
  return response && 
         typeof response === 'object' && 
         typeof response.success === 'boolean' && 
         (typeof response.message === 'string' || response.message === undefined);
};

/**
 * 提取响应数据
 * @param {ApiResponse} response - API响应
 * @returns {*} 响应数据
 */
export const extractData = (response) => {
  if (!isValidApiResponse(response)) {
    console.warn('Invalid API response format:', response);
    return response;
  }
  
  if (!response.success) {
    throw new Error(response.message);
  }
  
  return response.data;
};

/**
 * 提取分页信息
 * @param {ApiResponse} response - API响应
 * @returns {Object} 分页信息
 */
export const extractPagination = (response) => {
  if (!isValidApiResponse(response)) {
    return null;
  }
  
  return {
    total: response.total || 0,
    page: response.page || 1,
    limit: response.limit || 10,
    totalPages: response.total ? Math.ceil(response.total / (response.limit || 10)) : 0
  };
};

/**
 * 错误代码常量
 */
export const ERROR_CODES = {
  // 认证相关
  UNAUTHORIZED: 'UNAUTHORIZED',
  TOKEN_EXPIRED: 'TOKEN_EXPIRED',
  INVALID_TOKEN: 'INVALID_TOKEN',
  
  // 权限相关
  FORBIDDEN: 'FORBIDDEN',
  INSUFFICIENT_PERMISSIONS: 'INSUFFICIENT_PERMISSIONS',
  
  // 资源相关
  NOT_FOUND: 'NOT_FOUND',
  RESOURCE_CONFLICT: 'RESOURCE_CONFLICT',
  RESOURCE_LOCKED: 'RESOURCE_LOCKED',
  
  // 验证相关
  VALIDATION_ERROR: 'VALIDATION_ERROR',
  INVALID_INPUT: 'INVALID_INPUT',
  MISSING_REQUIRED_FIELD: 'MISSING_REQUIRED_FIELD',
  
  // 业务相关
  BUSINESS_ERROR: 'BUSINESS_ERROR',
  OPERATION_FAILED: 'OPERATION_FAILED',
  DUPLICATE_ENTRY: 'DUPLICATE_ENTRY',
  
  // 系统相关
  INTERNAL_ERROR: 'INTERNAL_ERROR',
  SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
  DATABASE_ERROR: 'DATABASE_ERROR',
  NETWORK_ERROR: 'NETWORK_ERROR',
  
  // 未知错误
  UNKNOWN_ERROR: 'UNKNOWN_ERROR'
};

/**
 * 成功消息常量
 */
export const SUCCESS_MESSAGES = {
  // 通用操作
  OPERATION_SUCCESS: '操作成功',
  DATA_SAVED: '数据保存成功',
  DATA_UPDATED: '数据更新成功',
  DATA_DELETED: '数据删除成功',
  DATA_RETRIEVED: '数据获取成功',
  
  // 认证相关
  LOGIN_SUCCESS: '登录成功',
  LOGOUT_SUCCESS: '登出成功',
  PASSWORD_CHANGED: '密码修改成功',
  
  // 文件相关
  FILE_UPLOADED: '文件上传成功',
  FILE_DELETED: '文件删除成功',
  
  // 导出相关
  EXPORT_SUCCESS: '数据导出成功',
  IMPORT_SUCCESS: '数据导入成功'
};
