<?php
namespace app\common\utils;

class WsResponse
{
    /**
     * 成功返回
     *
     * @param string $event   事件名称
     * @param array  $data    返回数据
     * @param string|null $traceId 请求追踪ID，可选，默认 null
     * @param int    $code    错误码
     * @param string $message 错误信息
     * @return string JSON
     */
    public static function success(string $event, array $data = [], ?string $traceId = null, string $message = 'ok', int $code = 0): string
    {
        return json_encode([
            'event'     => $event,
            'code'      => $code,
            'message'   => $message,
            'data'      => $data,
            'trace_id'  => $traceId, // 如果没有传就是 null
        ], JSON_UNESCAPED_UNICODE);
    }

    /**
     * 错误返回
     *
     * @param string $event   事件名称
     * @param int    $code    错误码
     * @param string $message 错误信息
     * @param string|null $traceId 请求追踪ID，可选，默认 null
     * @param array  $data    附加数据（可选）
     * @return string JSON
     */
    public static function error(string $event, int $code, string $message, ?string $traceId = null, array $data = []): string
    {
        return json_encode([
            'event'     => $event,
            'code'      => $code,
            'message'   => $message,
            'data'      => $data,
            'trace_id'  => $traceId, // 如果没有传就是 null
        ], JSON_UNESCAPED_UNICODE);
    }
}