api

type ClientExternalSurroundingLog struct {
	AppName      string                 `json:"app_name"`
	Path         string                 `json:"path"`
	Host         string                 `json:"host"`
	Url          string                 `json:"url"`
	Request      SurroundingLogRequest  `json:"request"`
	Response     SurroundingLogResponse `json:"response"`
	ResponseTime time.Duration          `json:"response_time"`
	MemoryUsage  uint64                 `json:"memory_usage"`
}

type HTTPClient interface {
	// Call send given request using HTTP, and optionally set custom timeout if
	// provided, otherwise will use DEFAULT_TIMEOUT.
	//
	// This function also help setting any necessary metadata for spotlibs using
	// ctx pkg that also come from this lib.
	Call(req *http.Request, timeouts ...time.Duration) (HTTPResponse, error)
}

type HTTPClientExternal interface {
	// Call send given request using HTTP, and optionally set custom timeout if
	// provided, otherwise will use DEFAULT_TIMEOUT.
	//
	// This function also help setting any necessary metadata for spotlibs using
	// ctx pkg that also come from this lib.
	Call(requestClient context.Context, req *http.Request, timeouts ...time.Duration) (HTTPResponse, error)
}

type HTTPResponse interface {
	// GetStatusCode get the http status code.
	GetStatusCode() int
	// GetBody get the raw response body in bytes.
	GetBody() []byte
	// GetHeaders get the original response header, after combining the value to
	// one using comma.
	GetHeaders() map[string]string
	// GetHeader get the response header by the given key after combining the value
	// using comma.
	GetHeader(key string) string
}

type MapRoute struct {
	Flag    bool   `json:"flag"`
	MockURL string `json:"mock_url"`
}

type SOAPClient interface {
	// Call sends a SOAP request to the given URL with the specified action
	// and parameters. Returns the raw content of <{Action}Result> element
	// (typically a JSON string for .NET services).
	//
	// The caller is responsible for unmarshaling the result bytes.
	Call(ctx context.Context, url string, action string, params map[string]string, timeouts ...time.Duration) ([]byte, error)
}

type SOAPFault struct {
	Code   string // e.g. "soap:Server" (1.1) or "env:Sender" (1.2)
	Reason string // human-readable error message
	Detail string // optional detail content
}

type SOAPOption func(*soapClient)

type SOAPSurroundingLog struct {
	AppName      string                 `json:"app_name"`
	Path         string                 `json:"path"`
	Host         string                 `json:"host"`
	URL          string                 `json:"url"`
	SOAPAction   string                 `json:"soap_action"`
	SOAPVersion  string                 `json:"soap_version"`
	Request      SurroundingLogRequest  `json:"request"`
	Response     SurroundingLogResponse `json:"response"`
	ResponseTime time.Duration          `json:"response_time"`
	MemoryUsage  uint64                 `json:"memory_usage"`
}

type SOAPVersion int

type SurroundingLogRequest struct {
	Method string `json:"method"`
	Header any    `json:"header"`
	Body   any    `json:"body"`
}

type SurroundingLogResponse struct {
	HttpCode int `json:"http_code"`
	Header   any `json:"header"`
	Body     any `json:"body"`
}

type WSPasswordType int

type WSSecurity struct {
	Username     string
	Password     string
	PasswordType WSPasswordType
	AddTimestamp bool          // Add wsu:Timestamp to Security header
	AddNonce     bool          // Add Nonce to UsernameToken (always true for Digest)
	TimestampTTL time.Duration // Timestamp validity duration (default: 5 minutes)
}