/**
 * 聊天网关层 DTO 定义
 * 
 * 功能描述：
 * - 定义聊天相关的数据传输对象
 * - 用于 HTTP 和 WebSocket 请求的数据验证
 * - 提供请求参数的类型约束和校验规则
 * 
 * 最近修改：
 * - 2026-01-14: 代码规范优化 - 清理未使用的导入 (修改者: moyin)
 * - 2026-01-14: 代码规范优化 - 完善注释规范 (修改者: moyin)
 * 
 * @author moyin
 * @version 1.0.2
 * @since 2026-01-14
 * @lastModified 2026-01-14
 */

import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
import { IsString, IsNotEmpty, IsOptional, IsNumber } from 'class-validator';
import { Type } from 'class-transformer';

/**
 * 发送聊天消息请求 DTO
 */
export class SendChatMessageDto {
  @ApiProperty({
    description: '消息内容',
    example: '大家好！我刚进入游戏',
    maxLength: 1000
  })
  @IsString()
  @IsNotEmpty()
  content: string;

  @ApiProperty({
    description: '消息范围',
    example: 'local',
    enum: ['local', 'global'],
    default: 'local'
  })
  @IsString()
  @IsNotEmpty()
  scope: string;

  @ApiPropertyOptional({
    description: '地图ID（可选，用于地图相关消息）',
    example: 'whale_port'
  })
  @IsOptional()
  @IsString()
  mapId?: string;
}

/**
 * 获取聊天历史请求 DTO
 */
export class GetChatHistoryDto {
  @ApiPropertyOptional({
    description: '地图ID（可选）',
    example: 'whale_port'
  })
  @IsOptional()
  @IsString()
  mapId?: string;

  @ApiPropertyOptional({
    description: '消息数量限制',
    example: 50,
    default: 50,
    minimum: 1,
    maximum: 100
  })
  @IsOptional()
  @IsNumber()
  @Type(() => Number)
  limit?: number = 50;

  @ApiPropertyOptional({
    description: '偏移量（分页用）',
    example: 0,
    default: 0,
    minimum: 0
  })
  @IsOptional()
  @IsNumber()
  @Type(() => Number)
  offset?: number = 0;
}

/**
 * WebSocket 登录消息 DTO
 */
export class WsLoginDto {
  @IsString()
  @IsNotEmpty()
  token: string;
}

/**
 * WebSocket 聊天消息 DTO
 */
export class WsChatMessageDto {
  @IsString()
  @IsNotEmpty()
  content: string;

  @IsString()
  @IsOptional()
  scope?: string;
}

/**
 * WebSocket 位置更新 DTO
 */
export class WsPositionUpdateDto {
  @IsNumber()
  x: number;

  @IsNumber()
  y: number;

  @IsString()
  @IsNotEmpty()
  mapId: string;
}