session

type Browser struct {
	Name   string   // for messages and the profile dir, e.g. "zen" or "chromium-browser"
	Argv   []string // command prefix; d2l appends its flags and the URL
	Family Family
	// Flatpak and Snap browsers can only write inside their sandbox, so the
	// login profile has to live there.
	Flatpak string // app ID
	Snap    string // snap name
}

type Cookie struct {
	Name   string `json:"name"`
	Value  string `json:"value"`
	Domain string `json:"domain"`
	Path   string `json:"path"`
}

type Family int

type LoginOptions struct {
	BaseURL string
	Browser string // command from the config; empty means the default browser
	// Interactive skips the silent headless attempt and opens a window right away.
	Interactive bool
	// Silent only tries the hidden browser and never opens a window.
	Silent bool
	// Validate checks captured cookies against the server. Login keeps
	// waiting until it accepts a session. Nil accepts the first one.
	Validate func(context.Context, *Session) error
	// Logf receives progress lines.
	Logf func(format string, args ...any)
}

type Session struct {
	BaseURL string    `json:"base_url"`
	Cookies []Cookie  `json:"cookies"`
	SavedAt time.Time `json:"saved_at"`
}