oobclient

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

type Interaction struct {
	// Protocol identifies the type of interaction.
	// Values: "http", "dns", "smtp", "ftp", "ldap", "smb", "responder"
	Protocol string `json:"protocol"`

	// UniqueID is the subdomain portion matching correlation-id + nonce.
	UniqueID string `json:"unique-id"`

	// FullId is the complete identifier including any subdomain prefixes.
	FullId string `json:"full-id"`

	// QType is the DNS query type, populated only when Protocol is "dns".
	// Values: "A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA"
	QType string `json:"q-type,omitempty"`

	// RawRequest contains the raw request data captured by the server.
	// For HTTP, this includes headers and body. For DNS, the query details.
	RawRequest string `json:"raw-request,omitempty"`

	// RawResponse is the raw response data, if applicable.
	RawResponse string `json:"raw-response,omitempty"`

	// SMTPFrom is the MAIL FROM address. Only for "smtp" protocol.
	SMTPFrom string `json:"smtp-from,omitempty"`

	// SMTPTo is the RCPT TO address. Only for "smtp" protocol.
	SMTPTo string `json:"smtp-to,omitempty"`

	// RemoteAddress is the client IP or IP:port that made the interaction.
	RemoteAddress string `json:"remote-address"`

	// Timestamp is when the server captured the interaction.
	Timestamp time.Time `json:"timestamp"`
}

type InteractionCallback func(*Interaction)

type Options struct {
	// ServerURLs specifies interactsh servers to try.
	// The list is tried starting at a random index, until one succeeds.
	// Default: public go-appsec servers (oscar.oastsrv.net, alpha.oastsrv.net, sierra.oastsrv.net, tango.oastsrv.net)
	ServerURLs []string

	// Token is an optional authentication token for protected servers.
	// Leave empty for public servers that don't require authentication.
	Token string

	// HTTPClient is an optional custom HTTP client. If provided, HTTPTimeout is ignored.
	HTTPClient *http.Client

	// HTTPTimeout is the timeout for HTTP requests when using the default client.
	// Ignored if HTTPClient is provided.
	// Default: 10 seconds
	HTTPTimeout time.Duration

	// KeepAliveInterval is how often to re-register to prevent session eviction.
	// Default: 60 seconds
	KeepAliveInterval time.Duration

	// DisableKeepAlive disables periodic re-registration.
	// When true, KeepAliveInterval is ignored.
	DisableKeepAlive bool

	// DisableHTTPFallback prevents falling back to HTTP if HTTPS fails.
	// Default: false (fallback enabled)
	DisableHTTPFallback bool

	// Response configures a stored HTTP response served for
	// interactions matching this session's correlation ID.
	// Supported only by the interactsh-lite server implementation.
	Response *ResponseConfig

	// CorrelationIdLength is the length of the correlation ID preamble.
	// Must match server configuration exactly. Cannot be customized with default servers.
	// Minimum: 4. Default: 16 for default servers, 20 for user-provided servers.
	CorrelationIdLength int

	// CorrelationIdNonceLength is the length of the nonce suffix for unique URLs.
	// Must be >= the server's configured cidn for interactions to be matched.
	// Minimum: 4. Default: 4 for default servers, 13 for user-provided servers.
	CorrelationIdNonceLength int
}

type ResponseConfig struct {
	StatusCode int      `json:"status-code,omitempty"` // HTTP status code
	Headers    []string `json:"headers,omitempty"`     // "Name: Value" format
	Body       string   `json:"body,omitempty"`        // response body
}