<?php

namespace App\Events;

use Illuminate\Broadcasting\Channel;
use Illuminate\Queue\SerializesModels;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;

/**
 * 界面文档扩展：`play.catalog_updated` —— 玩法目录/限额/封顶等生效版本变更。
 *
 * 触发时机：后台发布玩法配置、赔率、风控封顶版本（及同类全量变更）时。
 * 前端处理：重新拉取 `GET /api/v1/play/effective`。
 */
final class PlayCatalogUpdatedBroadcast implements ShouldBroadcast
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /** 异步广播队列 */
    public string $queue = 'broadcasts';

    /** 最多重试 3 次 */
    public int $tries = 3;

    /** 单任务超时 10 秒 */
    public int $timeout = 10;

    /**
     * @param  string  $module  play_config|odds|risk_cap
     * @param  array<string, mixed>|null  $meta
     */
    public function __construct(
        public readonly string $module,
        public readonly int $versionId,
        public readonly string $versionLabel,
        public readonly ?array $meta,
        public readonly int $emittedAtMs,
    ) {}

    /** @return array<int, Channel> */
    public function broadcastOn(): array
    {
        return [new Channel('lottery-hall')];
    }

    public function broadcastAs(): string
    {
        return 'play.catalog_updated';
    }

    /**
     * @return array{module: string, version_id: int, version_label: string, meta: array<string, mixed>|null, message: string, emitted_at_ms: int}
     */
    public function broadcastWith(): array
    {
        return [
            'module' => $this->module,
            'version_id' => $this->versionId,
            'version_label' => $this->versionLabel,
            'meta' => $this->meta,
            'message' => '玩法配置已更新，请刷新后下注',
            'emitted_at_ms' => $this->emittedAtMs,
        ];
    }
}
