api

type Config struct {
	ClientID       string
	ClientSecret   string
	BaseURL        string
	APIVersion     string
	Timeout        time.Duration
	MaxRetry       int
	UserAgent      string            // e.g. "aura-go-client/v1.8.0"; defaults to "aura-go-client" if empty
	HTTPClient     *http.Client      // optional custom HTTP client; when non-nil it replaces the default transport
	DefaultHeaders map[string]string // optional headers merged into every authenticated request
}

type Error struct {
	StatusCode int           `json:"status_code"`
	Message    string        `json:"message"`
	Details    []ErrorDetail `json:"details,omitempty"`
}

type ErrorDetail struct {
	Message string `json:"message"`
	Reason  string `json:"reason,omitempty"`
	Field   string `json:"field,omitempty"`
}

type RequestService interface {
	Get(ctx context.Context, endpoint string) (*Response, error)
	Post(ctx context.Context, endpoint string, body string) (*Response, error)
	Put(ctx context.Context, endpoint string, body string) (*Response, error)
	Patch(ctx context.Context, endpoint string, body string) (*Response, error)
	Delete(ctx context.Context, endpoint string) (*Response, error)
	// Close releases idle connections held by the underlying HTTP transport.
	// It should be called (typically via defer) when the client is no longer needed.
	Close()
}

type Response struct {
	StatusCode int
	Body       []byte
}