exports.go

package jrpc

import (
	"context"

	"gfx.cafe/open/jrpc/contrib/codecs"
	"gfx.cafe/open/jrpc/pkg/codec"
	"gfx.cafe/open/jrpc/pkg/server"
)

// to make the repo cleaner, we export everything here. this way the packages dont need to ever import this

type (
	// Conn is used to make requests to jsonrpc2 servers
	Conn = codec.Conn
	// Handler is the equivilant of http.Handler, but for jsonrpc.
	Handler = codec.Handler
	// HandlerFunc is a Handler that exists as a function
	HandlerFunc = codec.HandlerFunc
	// ResponseWriter is used to write responses to the request
	ResponseWriter = codec.ResponseWriter
	// StreamingConn is a conn that supports streaming methods
	StreamingConn = codec.Conn
	// Request is the request object
	Request = codec.Request
)
type (
	// BatchElem is an element of a batch request
	BatchElem = codec.BatchElem
)

var (

	// DialContext is to dial a conn with context
	DialContext = codecs.DialContext
	// Dial is to dial a conn with context.Background()
	Dial = codecs.Dial

	// ContextWithConn will attach a conn to the context
	ContextWithConn = codec.ContextWithConn
	// ContextWithPeerInfo will attach a peerinfo to the context
	ContextWithPeerInfo = server.ContextWithPeerInfo

	// ConnFromContext will retrieve a conn from context
	ConnFromContext = codec.ConnFromContext
	// PeerInfoFromContext will retrieve a peerinfo from context
	PeerInfoFromContext = server.PeerInfoFromContext
)

// Do will use the conn to perform a jsonrpc2 call.
func Do[T any](ctx context.Context, c Conn, method string, args any) (*T, error) {
	return codec.Do[T](ctx, c, method, args)
}

// Call will use the conn to perform a jsonrpc2 call, except the args will be encoded as an array of arguments.
func Call[T any](ctx context.Context, c Conn, method string, args ...any) (*T, error) {
	return codec.Call[T](ctx, c, method, args...)
}

// CallInto is the same as Call, except instead of returning, you provide a pointer to the result
var CallInto = codec.CallInto