<?php

namespace App\Module\Pet\Events;

use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

/**
 * 宠物升级事件
 * 
 * 当宠物升级时触发此事件，允许其他系统响应宠物等级的变化。
 * 此事件可用于更新宠物属性、解锁新技能、记录升级日志等。
 */
class PetLevelUpEvent
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * 用户ID
     *
     * @var int
     */
    public int $userId;

    /**
     * 宠物ID
     *
     * @var int
     */
    public int $petId;

    /**
     * 旧等级
     *
     * @var int
     */
    public int $oldLevel;

    /**
     * 新等级
     *
     * @var int
     */
    public int $newLevel;

    /**
     * 新解锁的技能列表
     *
     * @var array
     */
    public array $unlockedSkills;

    /**
     * 创建一个新的事件实例
     *
     * @param int $userId 用户ID
     * @param int $petId 宠物ID
     * @param int $oldLevel 旧等级
     * @param int $newLevel 新等级
     * @param array $unlockedSkills 新解锁的技能列表
     * @return void
     */
    public function __construct(int $userId, int $petId, int $oldLevel, int $newLevel, array $unlockedSkills = [])
    {
        $this->userId = $userId;
        $this->petId = $petId;
        $this->oldLevel = $oldLevel;
        $this->newLevel = $newLevel;
        $this->unlockedSkills = $unlockedSkills;
    }
}