grpc

type Client struct {
	*grpc.ClientConn
}

type ClientConfig struct {
	// Address is the TCP address to connect to.
	Address string

	// KeepAlive indicates how the GRPC client should configure the connection's keep alive.
	KeepAlive struct {
		// ClientParameters is used to set keepalive parameters on the client-side. These configure
		// how the client will actively probe to notice when a connection is broken and send pings so
		// intermediaries will be aware of the liveness of the connection. Make sure these parameters
		// are set in coordination with the keepalive policy on the server, as incompatible settings
		// can result in closing of connection.
		ClientParameters struct {
			// If true, client sends keepalive pings even with no active RPCs. If false, when there are
			// no active RPCs, Time and Timeout will be ignored and no keepalive pings will be sent.
			// By default, it is false.
			PermitWithoutStream bool

			// After a duration of this time if the client doesn't see any activity it pings the server
			// to see if the transport is still alive. If set below 10s, a minimum value of 10s will be
			// used instead. By default, it is 10 * time.Second.
			Time time.Duration

			// After having pinged for keepalive check, the client waits for a duration of Timeout and
			// if no activity is seen even after that the connection is closed. By default, it is
			// 20 * time.Second.
			Timeout time.Duration
		}
	}
}

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

type ServerConfig struct {
	// Address is the TCP address to listen on.
	Address string

	// GracefulShutdownHandler is a function that runs before the gRPC server is gracefully shut down.
	GracefulShutdownHandler func() error

	// GRPCGatewayServer indicates the `grpc-gateway` server that the service is connected to.
	GRPCGatewayServer string

	// KeepAlive indicates how the gRPC server should configure the connection's keep alive.
	KeepAlive struct {
		// EnforcementPolicy is used to set keepalive enforcement policy on the server-side. Server
		// will close connection with a client that violates this policy.
		EnforcementPolicy struct {
			// MinTime is the minimum amount of time a client should wait before sending a keepalive
			// ping. By default, it is 5 * time.Second.
			MinTime time.Duration

			// If true, server allows keepalive pings even when there are no active streams(RPCs). If
			// false, and client sends ping when there are no active streams, server will send GOAWAY
			// and close the connection. By default, it is false.
			PermitWithoutStream bool
		}

		// ServerParameters is used to set keepalive and max-age parameters on the server-side.
		ServerParameters struct {
			// MaxConnectionAge is a duration for the maximum amount of time a connection may exist
			// before it will be closed by sending a GoAway. A random jitter of +/-10% will be added
			// to MaxConnectionAge to spread out connection storms.
			MaxConnectionAge time.Duration

			// MaxConnectionIdle is a duration for the amount of time after which an idle connection
			// would be closed by sending a GoAway. Idleness duration is defined since the most recent
			// time the number of outstanding RPCs became zero or the connection establishment.
			MaxConnectionIdle time.Duration

			// After a duration of this time if the server doesn't see any activity it pings the client
			// to see if the transport is still alive. If set below 1s, a minimum value of 1s will be
			// used instead.
			Time time.Duration

			// After having pinged for keepalive check, the server waits for a duration of Timeout and
			// if no activity is seen even after that the connection is closed.
			Timeout time.Duration
		}
	}

	// ReflectionService indicates if the gRPC server should register the reflection service.
	ReflectionService bool

	// TracerProvider is the provider that uses the exporter to push traces to the collector.
	TracerProvider *tracer.Provider

	// TracerProviderShutdownHandler is a function that shuts down the tracer's exporter/provider before
	// the gRPC server is gracefully shut down.
	TracerProviderShutdownHandler func() error
}