package com.market.model.ws;

import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.List;

/**
 * 前端 WebSocket 响应/推送报文
 *
 * <p>订阅/取消 ACK：
 * <pre>{"id":"1","status":"ok","subbed":"market.btcusdt.kline.1m","ts":1234567890}</pre>
 *
 * <p>主动推送：
 * <pre>{"ch":"market.btcusdt.kline.1m","ts":1234567890,"tick":{...}}</pre>
 *
 * <p>req 响应：
 * <pre>{"id":"3","status":"ok","rep":"market.btcusdt.kline.1m","ts":1234567890,"data":{...}}</pre>
 *
 * <p>错误：
 * <pre>{"id":"1","status":"error","err-code":"bad-request","err-msg":"...","ts":1234567890}</pre>
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@JsonInclude(JsonInclude.Include.NON_NULL)
public class WsResponse {

    /** 对应请求的 ID */
    private String id;

    /** ok / error */
    private String status;

    /** sub ACK（已成功订阅的主题列表） */
    private List<String> subbed;

    /** unsub ACK（已取消的主题列表） */
    private List<String> unsubbed;

    /** req ACK（单个主题，每个主题单独响应） */
    private String rep;

    /** 推送频道（主动推送时使用） */
    private String ch;

    /** 时间戳（ms） */
    private Long ts;

    /** 主动推送数据体 */
    private Object tick;

    /** req 响应数据体 */
    private Object data;

    @JsonProperty("err-code")
    private String errCode;

    @JsonProperty("err-msg")
    private String errMsg;
}
