jsonrpc

type RPCClient interface {
	// Call 进行 JSON-RPC 调用
	Call(ctx context.Context, method string, params ...any) (*RPCResponse, error)
	// CallRaw 基于所给请求体进行 JSON-RPC 调用
	CallRaw(ctx context.Context, req *RPCRequest) (*RPCResponse, error)
	// CallFor 进行 JSON-RPC 调用并将响应结果反序列化到所给类型对象中
	CallFor(ctx context.Context, out any, method string, params ...any) error
	// CallRawFor 基于所给请求体进行 JSON-RPC 调用并将响应结果反序列化到所给类型对象中
	CallRawFor(ctx context.Context, out any, req *RPCRequest) error

	// CallBatch 进行 JSON-RPC 批量调用（内部会自动设置 JSONRPC 与 ID 字段，ID 将从 1 开始递增）
	CallBatch(ctx context.Context, reqs RPCRequests) (RPCResponses, error)
	// CallBatchRaw 基于所给请求体列表进行 JSON-RPC 批量调用
	CallBatchRaw(ctx context.Context, reqs RPCRequests) (RPCResponses, error)

	// NewHTTPRequest 新建 HTTP 请求体（req 可以为 *RPCRequest 或 RPCRequests）
	NewHTTPRequest(ctx context.Context, req any) (*http.Request, error)
	// CallWithHTTPRequest 使用 http.Request 进行 JSON-RPC 调用
	CallWithHTTPRequest(httpReq *http.Request) (*http.Response, *RPCResponse, error)
	// CallBatchWithHTTPRequest 使用 http.Request 进行 JSON-RPC 批量调用
	CallBatchWithHTTPRequest(httpReq *http.Request) (*http.Response, []*RPCResponse, error)
}

type RPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    any    `json:"data,omitempty"`
}

type RPCOption func(server *rpcClient)

type RPCRequest struct {
	JSONRPC    string         `json:"jsonrpc"`
	ID         int            `json:"id"`
	Method     string         `json:"method"`
	Params     any            `json:"params,omitempty"`
	Extensions map[string]any `json:"-"` // 规范定义之外的拓展字段
}

type RPCRequests []*RPCRequest

type RPCResponse struct {
	JSONRPC    string         `json:"jsonrpc"`
	ID         int            `json:"id"`
	Result     any            `json:"result,omitempty"`
	Error      any            `json:"error,omitempty"`
	Extensions map[string]any `json:"-"` // 规范定义之外的拓展字段
}

type RPCResponses []*RPCResponse