interfaces

type BaseStatusWriter interface {
	// SetStatusCode sets the HTTP status code.
	SetStatusCode(statusCode int)

	// SetHeaders sets the response headers.
	SetHeaders(headers map[string][]string)

	// SetBody sets the response body.
	SetBody(body string)

	// SetError sets the error message.
	SetError(err error)

	// SetRequestDetails sets the request details.
	SetRequestDetails(url, method, body string, headers map[string][]string)
}

type CachedResponse interface {
	// GetCachedResponse returns the cached response.
	GetCachedResponse() HTTPResponse
}

type DisposableRequestResource interface {
	// Embed client.Object for Kubernetes object access (includes metav1.Object and runtime.Object)
	client.Object

	// GetSpec returns the request specification (ForProvider parameters).
	// For DisposableRequest, the spec also serves as the RollbackAware interface.
	GetSpec() SimpleHTTPRequestSpec

	// DisposableRequestStatusReader for accessing response and status information
	DisposableRequestStatusReader

	// DisposableRequestStatusWriter for modifying response and status information
	DisposableRequestStatusWriter
}

type DisposableRequestStatus interface {
	DisposableRequestStatusReader
	DisposableRequestStatusWriter
}

type DisposableRequestStatusReader interface {
	// GetSynced returns whether the resource is synced.
	GetSynced() bool

	// GetFailed returns the number of failed attempts.
	GetFailed() int32

	// GetResponse returns the HTTP response.
	GetResponse() HTTPResponse
}

type DisposableRequestStatusWriter interface {
	BaseStatusWriter

	// SetSynced sets the synced status.
	SetSynced(synced bool)

	// SetFailed sets the number of failed attempts.
	SetFailed(failed int32)

	// SetLastReconcileTime sets the last reconcile time.
	SetLastReconcileTime()
}

type HTTPMapping interface {
	// GetMethod returns the HTTP method (POST, GET, PUT, DELETE, PATCH, HEAD, OPTIONS).
	GetMethod() string

	// SetMethod sets the HTTP method.
	SetMethod(method string)

	// GetAction returns the action type (CREATE, OBSERVE, UPDATE, REMOVE).
	// Returns empty string if not applicable.
	GetAction() string

	// GetBody returns the body template for this mapping.
	GetBody() string

	// GetURL returns the URL template for this mapping.
	GetURL() string

	// GetHeaders returns the headers for this mapping.
	GetHeaders() map[string][]string
}

type HTTPPayload interface {
	// GetBaseURL returns the base URL.
	GetBaseURL() string

	// GetBody returns the payload body.
	GetBody() string
}

type HTTPRequestSpec interface {
	// GetWaitTimeout returns the maximum time duration for waiting.
	GetWaitTimeout() *metav1.Duration

	// GetInsecureSkipTLSVerify returns whether to skip TLS certificate verification.
	GetInsecureSkipTLSVerify() bool

	// GetSecretInjectionConfigs returns the secret injection configurations.
	GetSecretInjectionConfigs() []common.SecretInjectionConfig

	// GetHeaders returns the default headers for the request.
	GetHeaders() map[string][]string
}

type HTTPResponse interface {
	// GetStatusCode returns the HTTP status code.
	GetStatusCode() int

	// GetBody returns the response body.
	GetBody() string

	// GetHeaders returns the response headers.
	GetHeaders() map[string][]string
}

type MappedHTTPRequestSpec interface {
	HTTPRequestSpec

	// GetMappings returns the HTTP mappings for different methods/actions.
	GetMappings() []HTTPMapping

	// GetPayload returns the payload configuration.
	GetPayload() HTTPPayload
}

type ReconciliationPolicyAware interface {
	// GetNextReconcile returns the duration after which the next reconcile should occur.
	GetNextReconcile() *metav1.Duration

	// GetShouldLoopInfinitely returns whether reconciliation should loop indefinitely.
	GetShouldLoopInfinitely() bool
}

type RequestResource interface {
	// Embed client.Object for Kubernetes object access (includes metav1.Object and runtime.Object)
	client.Object

	// GetSpec returns the request specification (ForProvider parameters).
	GetSpec() MappedHTTPRequestSpec

	// RequestStatusReader for accessing response and status information
	RequestStatusReader

	// RequestStatusWriter for modifying response and status information
	RequestStatusWriter

	// CachedResponse for accessing cached response
	CachedResponse
}

type RequestStatus interface {
	RequestStatusReader
	RequestStatusWriter
	CachedResponse
}

type RequestStatusReader interface {
	// GetResponse returns the HTTP response.
	GetResponse() HTTPResponse

	// GetFailed returns the number of failed attempts.
	GetFailed() int32

	// GetRequestDetails returns the request details mapping.
	GetRequestDetails() HTTPMapping
}

type RequestStatusWriter interface {
	BaseStatusWriter

	// SetCache sets the cached response.
	SetCache(statusCode int, headers map[string][]string, body string)

	// ResetFailures resets the failure count.
	ResetFailures()
}

type ResponseCheck interface {
	// GetType returns the check type (DEFAULT or CUSTOM).
	GetType() string

	// GetLogic returns the custom logic for the check (jq expression).
	GetLogic() string
}

type ResponseCheckAware interface {
	// GetExpectedResponseCheck returns the expected response check configuration.
	GetExpectedResponseCheck() ResponseCheck

	// GetIsRemovedCheck returns the is-removed check configuration.
	GetIsRemovedCheck() ResponseCheck
}

type RollbackAware interface {
	// GetRollbackRetriesLimit returns the maximum number of rollback retry attempts.
	GetRollbackRetriesLimit() *int32
}

type SimpleHTTPRequestSpec interface {
	HTTPRequestSpec

	// GetURL returns the URL for the request.
	GetURL() string

	// GetMethod returns the HTTP method for the request.
	GetMethod() string

	// GetBody returns the body of the request.
	GetBody() string

	// GetExpectedResponse returns the jq filter expression for validating the response.
	GetExpectedResponse() string
}