yamlspec

type APIConfig struct {
	BaseURL string      `yaml:"base_url"`          // Base URL (e.g., "http://localhost:8080")
	Timeout string      `yaml:"timeout,omitempty"` // Request timeout (default: "10s")
	Auth    *AuthConfig `yaml:"auth,omitempty"`    // Optional authentication
}

type ApproxValidator struct {
	Value     float64 `yaml:"value"`
	Tolerance float64 `yaml:"tolerance"`
}

type ArrayValidator struct {
	Length   *int          `yaml:"length,omitempty"`
	Contains []interface{} `yaml:"contains,omitempty"`
	Unique   bool          `yaml:"unique,omitempty"`
}

type AuthConfig struct {
	Type   string `yaml:"type"`             // "bearer", "basic", "api_key"
	Token  string `yaml:"token,omitempty"`  // Token value
	Header string `yaml:"header,omitempty"` // Custom header name (for api_key type)
}

type ExpectedError struct {
	Code    int         `yaml:"code"`              // Error code (e.g., -32601)
	Message string      `yaml:"message,omitempty"` // Error message (partial match OK)
	Data    interface{} `yaml:"data,omitempty"`    // Error data
}

type RangeValidator struct {
	Min *float64 `yaml:"min,omitempty"`
	Max *float64 `yaml:"max,omitempty"`
}

type StageSpec struct {
	Stage       string     `yaml:"stage"`
	Title       string     `yaml:"title"`
	Description string     `yaml:"description,omitempty"`
	Background  string     `yaml:"background,omitempty"`
	API         APIConfig  `yaml:"api"`
	TestCases   []TestCase `yaml:"test_cases"`
}

type TestCase struct {
	Slug            string     `yaml:"slug"`
	TesterLogPrefix string     `yaml:"tester_log_prefix,omitempty"`
	Title           string     `yaml:"title"`
	Description     string     `yaml:"description,omitempty"`
	Hint            string     `yaml:"hint,omitempty"`
	Tags            []string   `yaml:"tags,omitempty"`
	Setup           []TestStep `yaml:"setup,omitempty"`    // Run before main steps
	Steps           []TestStep `yaml:"steps"`              // Main test steps
	Teardown        []TestStep `yaml:"teardown,omitempty"` // Run after (always executed)
	Summary         []string   `yaml:"summary,omitempty"`
}

type TestStep struct {

	// JSON-RPC fields
	Method string                 `yaml:"method,omitempty"` // JSON-RPC method name
	Params map[string]interface{} `yaml:"params,omitempty"` // JSON-RPC params

	// REST fields
	HTTPMethod string            `yaml:"http_method,omitempty"` // GET/POST/PUT/DELETE/PATCH
	Path       string            `yaml:"path,omitempty"`        // URL path (e.g., "/api/users")
	Body       interface{}       `yaml:"body,omitempty"`        // Request body (JSON)
	Headers    map[string]string `yaml:"headers,omitempty"`     // Custom headers

	// === Response Validation ===
	Expected      interface{}      `yaml:"expected"`               // Expected result
	ExpectError   *ExpectedError   `yaml:"expect_error,omitempty"` // Expected JSON-RPC error
	ValidateRules *ValidatorConfig `yaml:"validate,omitempty"`     // Advanced validation

	// === Metadata ===
	Description string `yaml:"description"`     // Human-readable description
	Delay       int    `yaml:"delay,omitempty"` // Delay in ms before step
}

type ValidatorConfig struct {
	Range   map[string]RangeValidator  `yaml:"range,omitempty"`   // Numeric range validation
	Pattern map[string]string          `yaml:"pattern,omitempty"` // Regex pattern matching
	Type    map[string]string          `yaml:"type,omitempty"`    // Type checking
	Approx  map[string]ApproxValidator `yaml:"approx,omitempty"`  // Approximate float comparison
	Array   map[string]ArrayValidator  `yaml:"array,omitempty"`   // Array validation
}