jrm1

type Client struct {
	// contains filtered or unexported fields
}

type ClientSettings struct {
	// contains filtered or unexported fields
}

type Processor struct {
	// contains filtered or unexported fields
}

type ProcessorSettings struct {
	// When enabled, RPC processor (server) will catch exceptions.
	CatchExceptions bool

	// When enabled, RPC processor (server) will journal exceptions.
	LogExceptions bool

	// When enabled, RPC processor (server) will count requests.
	CountRequests bool

	// Name of a meta-data field where to store request duration.
	// When enabled, RPC processor (server) will measure time taken to run
	// functions. Duration is shown only for successful function calls.
	// To enable this feature, set the field name as non-null value.
	DurationFieldName *string

	// Name of a meta-data field where to store ID of the current request.
	// When enabled, RPC processor (server) will add ID of the current request
	// as a meta-data field, so that user function will be able to read it.
	// This field is automatically removed when function call finishes.
	// To enable this feature, set the field name as non-null value.
	RequestIdFieldName *string
}

type ResponseMetaData map[string]any

type RpcError struct {
	// Error code.
	Code RpcErrorCode `json:"code"`

	// Error message.
	Message RpcErrorMessage `json:"message"`

	// Some additional details about an error.
	Data any `json:"data"`
}

type RpcErrorCode int

type RpcErrorMessage string

type RpcErrorStd struct {
	RpcError
}

type RpcFunction func(params *json.RawMessage, metaData *ResponseMetaData) (result any, re *RpcError)

type RpcHttpRequest struct {
	// contains filtered or unexported fields
}

type RpcRequest struct {
	// RPC protocol name.
	ProtocolName *string `json:"jsonrpc"`

	// Identifier of request.
	Id *string `json:"id"`

	// Name of the requested RPC function (method, procedure).
	Method *string `json:"method"`

	// Arguments for the requested RPC function (method, procedure).
	Parameters *json.RawMessage `json:"params"`
}

type RpcResponse struct {
	// RPC protocol name.
	ProtocolName string `json:"jsonrpc"`

	// Identifier of request and its response.
	Id *string `json:"id"`

	// Result returned by the called RPC function (method, procedure).
	Result any `json:"result"`

	// Error returned by the called RPC function (method, procedure).
	Error *RpcError `json:"error"`

	// Additional meta-information about the RPC call. This information is not
	// returned by the called function (method, procedure), however the called
	// function (method, procedure) has an interface to interact with this
	// information. It is provided for some specific purposes, such as
	// debugging, logging, transmission of various environment settings, not
	// directly related to the RPC function (method, procedure). The most
	// evident usage of this object is providing an ability to see an ID of the
	// RPC request inside the called RPC function (method, procedure). Another
	// usage example is storing duration of the RPC call, which can be
	// automatically performed by this framework.
	Meta *ResponseMetaData `json:"meta,omitempty"`

	// Flag of success.
	// This field serves at least two purposes. First, it provides additional
	// robustness via redundancy. Second, it allows to check for success not
	// having to parse the whole result JSON object. If you are familiar with
	// the HTTP status code 200, you will understand the idea.
	OK bool `json:"ok"`
}

type RpcResponseRaw struct {
	// RPC protocol name.
	ProtocolName string `json:"jsonrpc"`

	// Identifier of request and its response.
	Id *string `json:"id"`

	// Result returned by the called RPC function (method, procedure).
	Result *json.RawMessage `json:"result"`

	// Error returned by the called RPC function (method, procedure).
	Error *RpcError `json:"error"`

	// Additional meta-information about the RPC call. This information is not
	// returned by the called function (method, procedure), however the called
	// function (method, procedure) has an interface to interact with this
	// information. It is provided for some specific purposes, such as
	// debugging, logging, transmission of various environment settings, not
	// directly related to the RPC function (method, procedure). The most
	// evident usage of this object is providing an ability to see an ID of the
	// RPC request inside the called RPC function (method, procedure). Another
	// usage example is storing duration of the RPC call, which can be
	// automatically performed by this framework.
	Meta *ResponseMetaData `json:"meta,omitempty"`

	// Flag of success.
	// This field serves at least two purposes. First, it provides additional
	// robustness via redundancy. Second, it allows to check for success not
	// having to parse the whole result JSON object. If you are familiar with
	// the HTTP status code 200, you will understand the idea.
	OK bool `json:"ok"`
}