pluginhooks

type Empty struct{}

type Plugin interface {
	// OnSessionOpen phase will initialize the configuration in memory
	// that could be used to other phases. The response will be used to mutate
	// the session params received.
	// Return an error in case any pre-condition doesn't match
	OnSessionOpen(*SesssionParams, *SessionParamsResponse) error
	// OnReceive phase process each received packet
	// the response object should be used to mutate the request packet or
	// returning an error and stopping processing further packets
	OnReceive(*Request, *Response) error
	// OnSend phase will trigger when a packet will be sent
	// to the client. The request will contain the packet and type
	// and the response could mutate the payload or return an error
	// if a condiction is not met.
	OnSend(*Request, *Response) error
}

type RPCPluginMethod string

type Request struct {
	SessionID  string
	PacketType string
	Payload    []byte
}

type Response struct {
	// mutate | stop | log (default)
	Payload []byte
	Err     error
}

type SessionParamsResponse struct {
	ConnectionEnvVars map[string]any
	ConnectionCommand []string
	ClientArgs        []string
}

type SesssionParams struct {
	SessionID         string
	UserID            string
	PluginEnvVars     map[string]string
	ConnectionName    string
	ConnectionType    string
	ConnectionEnvVars map[string]any
	ConnectionConfig  map[string]any
	ConnectionCommand []string
	ClientArgs        []string
	ClientVerb        string
}