protocol

type Protocol interface {
	// Name returns the name of the plugin.
	Name() string

	// ParamName returns the name of the plugin's parameter, used for configuration.
	ParamName() string

	// Init initializes the protocol plugin. param is the ProtocolParam string configured by the user.
	// Returns an error if initialization fails.
	Init(param string) error

	// Obfuscate modifies internal protocol fields before data is sent (encrypted/encapsulated).
	// data is ProtocolData, context provides context information.
	// Returns the modified data. If an error is returned, the operation should be aborted.
	Obfuscate(data ProtocolData, context ProtocolContext) (ProtocolData, error)

	// Deobfuscate restores internal protocol fields after data is received (decrypted/de-encapsulated).
	// data is ProtocolData, context provides context information.
	// Returns the restored data. If an error is returned, the operation should be aborted.
	Deobfuscate(data ProtocolData, context ProtocolContext) (ProtocolData, error)
}

type ProtocolContext struct {
	// Type indicates the type of data being operated on, e.g., "tcp_request", "udp_message", "auth_request", "auth_response"
	// Plugins can use this field for type assertion.
	Type string

	// IsClient indicates whether the current operation is happening on the client side (true for client, false for server).
	IsClient bool

	// PeerAddr is the network address of the peer.
	PeerAddr net.Addr

	// SessionID is only valid for UDP messages.
	SessionID uint32

	// StreamID is only valid for TCP Streams (QUIC Streams).
	StreamID uquic.StreamID
}

type ProtocolData interface{}

type ProtocolFactory func() Protocol