grpcx

type BadBodyError struct{ Detail string }

type Call struct {
	// Server is grpc://host:port, grpcs://host:port or host:port (see
	// model.GRPCTarget for which of those is plaintext).
	Server string
	// Method is package.Service/Method.
	Method string
	// JSON is the request message; empty means {}.
	JSON []byte
	// Metadata is sent with the call; names are lower-cased, and -bin names are
	// refused.
	Metadata []transport.Header
	TLS      *tls.Config
	// Root is the collection directory the Protos and Imports are relative to.
	Root string
	// Protos are .proto files relative to Root. Empty: the schema is asked of the
	// server by reflection.
	Protos []string
	// Imports are the roots the files' imports are resolved against, relative to
	// Root. Root itself is always one.
	Imports []string
	// Receive says which messages of a server stream to keep and how long to
	// wait for them; unused for a unary call.
	Receive *transport.Receive
	// Web makes the call over gRPC-Web: an HTTP POST to Server (an http:// or
	// https:// address) instead of an HTTP/2 connection, for proxies and
	// gateways that speak gRPC-Web. It needs Protos and cannot stream from the client.
	Web bool
	// Timeout is the deadline of the whole call; zero means DefaultTimeout.
	Timeout time.Duration
	Clock   func() time.Time // nil: time.Now
}

type Method struct {
	Service      string // acme.orders.v1.Orders
	Name         string // Get
	ClientStream bool
	ServerStream bool
	Input        string // full name of the request message
	Output       string
	// Example is a request message as compact JSON with every field at its
	// zero value, for a starting point.
	Example string
}

type ProtoFile struct {
	Path string // as imports name it: "orders.proto", "common/types.proto"
	Data []byte
}

type ProtoImport struct {
	Files   []ProtoFile
	Methods []Method
}

type Result struct {
	Messages []transport.Message
	Header   []transport.Header // response metadata
	Trailer  []transport.Header
	Code     codes.Code
	Message  string // the status message
	// Warnings are things the call went ahead despite: a field of the JSON
	// that the request message does not have, which was left out.
	Warnings []string
	Connect  time.Duration
	Total    time.Duration
}

type SchemaError struct {
	Detail string
	// Proto is true when the .proto files are at fault (they did not compile or
	// register), not the method or the server.
	Proto bool
}