cloudflare

type HTTPDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type HandleOpts struct {
	// StartSession nil → real cloudflare.StartSession adapter.
	StartSession func(SessionStartOptions) (Session, error)
	// WaitSignal nil → block until SIGINT/SIGTERM.
	WaitSignal func() error
	// WaitReady nil → WaitPublicReady against the public probe URL.
	WaitReady func(WaitReadyOptions) (time.Duration, error)
	// HTTPClient nil → &http.Client{Timeout: 10s} for readiness probes.
	HTTPClient HTTPDoer
	// Stdout/Stderr nil → os.Stdout / os.Stderr (help + user messages).
	Stdout io.Writer
	Stderr io.Writer
	// NoColorEnv nil → os.Getenv("NO_COLOR"); set in tests to control auto mode.
	NoColorEnv *string
}

type Session interface {
	Stop() error
	PublicBaseURL() string
}

type SessionStartOptions struct {
	Domain     string
	LocalURL   string
	TunnelName string
}

type WaitReadyOptions struct {
	Client       HTTPDoer
	URL          string
	Timeout      time.Duration // 0 → DefaultReadyTimeout
	PollInterval time.Duration // 0 → DefaultReadyPollInterval
	Log          io.Writer     // progress; may be nil
	// Interactive: TTY in-place progress (\r + clear). false = newline + heartbeat.
	Interactive bool
	// HeartbeatInterval: non-interactive re-emit interval for same signature (0 → 10s).
	HeartbeatInterval time.Duration
	Style             color.Style
	// Optional injectables for tests (nil → real time):
	Sleep func(d time.Duration)
	Now   func() time.Time
}