auth

type ExportDestination string

type LoginProgress struct {
	// OnUserCode is called with the code the user must type in the browser, before the browser is
	// opened. Only called when the server issued one. Implementations MUST display it — a user who
	// never sees it cannot complete the login.
	OnUserCode func(code string)
	// OnBrowserOpen is called when the browser is about to open, with the fallback URL.
	OnBrowserOpen func(loginURL string)
	// OnWaiting is called when polling starts.
	OnWaiting func()
	// OnServerMessage is called with the server's advisory message, if any. Used to reach CLI
	// versions we can't otherwise update (e.g. deprecation notices), so it should be shown.
	OnServerMessage func(message string)
}

type LoginResponse struct {
	SessionToken string    `json:"sessionToken"`
	PollSecret   string    `json:"pollSecret"`
	LoginURL     string    `json:"loginUrl"`
	ExpiresAt    time.Time `json:"expiresAt"`
	Message      string    `json:"message"`

	// UserCode is the device-flow user code (RFC 8628 §3.3). The user types it in the browser to
	// confirm they're authorizing this terminal. Present only when we advertised supportsUserCode.
	//
	// Display it, and nothing more: it must reach the browser by the user reading it here and typing
	// it in. Never put it in a URL, and don't log it.
	UserCode string `json:"userCode"`
}

type PollResponse struct {
	Status string  `json:"status"`
	ApiKey *string `json:"apiKey,omitempty"`
	Error  *string `json:"error,omitempty"`
}