workflow

type Action struct {
	URL    string `yaml:"url,omitempty"`
	Headed bool   `yaml:"headed,omitempty"` // show browser window (used by BRZ_HEADED=auto)
	Steps  []Step `yaml:"steps"`
}

type ActionResult struct {
	OK           bool   `json:"ok"`
	Action       string `json:"action"`
	Steps        int    `json:"steps"`
	DurationMs   int64  `json:"duration_ms"`
	Download     string `json:"download,omitempty"`
	DownloadSize int64  `json:"download_size,omitempty"`
	Error        string `json:"error,omitempty"`
	FailedStep   int    `json:"failed_step,omitempty"`
	StepType     string `json:"step_type,omitempty"`
	Screenshot   string `json:"screenshot,omitempty"`
	PageHTML     string `json:"page_html,omitempty"` // page HTML at time of failure (for debugging)
	PageURL      string `json:"page_url,omitempty"`  // page URL at time of failure
	Escalated    bool   `json:"escalated,omitempty"` // true if auto-escalated from headless to headed
}

type ClickStep struct {
	Selector string `yaml:"selector"`
	Text     string `yaml:"text,omitempty"` // match by visible text
	Nth      int    `yaml:"nth,omitempty"`  // 0-indexed, use when multiple matches
	Timeout  string `yaml:"timeout,omitempty"`
}

type DownloadStep struct {
	Timeout string `yaml:"timeout,omitempty"`
	SaveAs  string `yaml:"save_as,omitempty"` // optional filename pattern
}

type ElementInfo struct {
	Selector    string `json:"selector"`
	Tag         string `json:"tag"`
	Type        string `json:"type,omitempty"`
	Name        string `json:"name,omitempty"`
	Placeholder string `json:"placeholder,omitempty"`
	Text        string `json:"text,omitempty"`
	Href        string `json:"href,omitempty"`
	Value       string `json:"value,omitempty"`
	Role        string `json:"role,omitempty"`
	Hidden      bool   `json:"hidden,omitempty"`
}

type Executor struct {

	// LastDownload holds the path to the most recently downloaded file.
	LastDownload string
	// LastResult holds the string result of the most recent action (e.g. downloaded CSV content).
	LastResult string
	// contains filtered or unexported fields
}

type FillStep struct {
	Selector string `yaml:"selector"`
	Value    string `yaml:"value"`           // supports ${ENV_VAR} interpolation
	Clear    bool   `yaml:"clear,omitempty"` // clear field before filling
}

type InspectResult struct {
	OK         bool          `json:"ok"`
	URL        string        `json:"url"`
	Title      string        `json:"title"`
	Elements   []ElementInfo `json:"elements"`
	Total      int           `json:"total"`
	Truncated  bool          `json:"truncated,omitempty"`
	DurationMs int64         `json:"duration_ms"`
	Error      string        `json:"error,omitempty"`
}

type Option func(*Executor)

type SleepStep struct {
	Duration string `yaml:"duration"`
}

type Step struct {
	// Navigation
	Navigate string `yaml:"navigate,omitempty"`

	// Interactions
	Click    *ClickStep    `yaml:"click,omitempty"`
	Fill     *FillStep     `yaml:"fill,omitempty"`
	Upload   *UploadStep   `yaml:"upload,omitempty"`
	Download *DownloadStep `yaml:"download,omitempty"`

	// Waits
	WaitVisible *WaitStep    `yaml:"wait_visible,omitempty"`
	WaitText    *WaitStep    `yaml:"wait_text,omitempty"`
	WaitURL     *WaitURLStep `yaml:"wait_url,omitempty"`

	// Utilities
	Screenshot string     `yaml:"screenshot,omitempty"`
	Sleep      *SleepStep `yaml:"sleep,omitempty"`
	Eval       string     `yaml:"eval,omitempty"`

	// Control flow
	Label    string `yaml:"label,omitempty"`    // human-readable step description for logging
	Optional bool   `yaml:"optional,omitempty"` // if true, step failure is non-fatal
}

type UploadStep struct {
	Selector string `yaml:"selector"`
	Source   string `yaml:"source"` // "result" to use previous step's output, or a path
}

type WaitStep struct {
	Selector string `yaml:"selector,omitempty"`
	Text     string `yaml:"text,omitempty"`
	State    string `yaml:"state,omitempty"` // visible, attached, hidden
	Timeout  string `yaml:"timeout,omitempty"`
}

type WaitURLStep struct {
	Match   string `yaml:"match"`
	Timeout string `yaml:"timeout,omitempty"`
}

type Workflow struct {
	Name    string            `yaml:"name"`
	Env     map[string]string `yaml:"env,omitempty"`
	Actions map[string]Action `yaml:"actions"`
}