<?php

/**
 * 文件功能：聊天室全屏特效广播事件
 *
 * 管理员触发烟花/下雨/雷电等特效后，
 * 通过 WebSocket 广播给房间内所有在线用户，前端收到后播放对应 Canvas 动画。
 *
 * @package  App\Events
 * @author   ChatRoom Laravel
 * @version  1.0.0
 */

namespace App\Events;

use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class EffectBroadcast implements ShouldBroadcastNow
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * 支持的特效类型列表（用于校验）
     */
    public const TYPES = ['fireworks', 'rain', 'lightning'];

    /**
     * 构造函数
     *
     * @param  int     $roomId    房间 ID
     * @param  string  $type      特效类型：fireworks / rain / lightning
     * @param  string  $operator  触发特效的管理员用户名
     */
    public function __construct(
        public readonly int $roomId,
        public readonly string $type,
        public readonly string $operator,
    ) {}

    /**
     * 广播频道：向房间内所有在线用户推送
     *
     * @return array<int, \Illuminate\Broadcasting\Channel>
     */
    public function broadcastOn(): array
    {
        return [
            new PresenceChannel('room.' . $this->roomId),
        ];
    }

    /**
     * 广播数据：特效类型和操作者
     *
     * @return array<string, mixed>
     */
    public function broadcastWith(): array
    {
        return [
            'type'     => $this->type,
            'operator' => $this->operator,
        ];
    }
}