config

type File struct {
	// DefaultProfile — какой профиль брать, если в командной строке имя
	// не названо. Может быть пустым: когда профиль в файле один, выбирать
	// не из чего.
	DefaultProfile string `toml:"default_profile"`
	// Profiles — секции [profile.<имя>].
	Profiles map[string]*Profile `toml:"profile"`
}

type Profile struct {
	// Name — имя секции. Заполняется при разборе, в файле его нет.
	Name string `toml:"-"`

	// Peer — адрес VPS в виде host:port.
	Peer string `toml:"peer"`
	// PasswordRef — ссылка на пароль подключения в хранилище секретов.
	PasswordRef string `toml:"password_ref"`
	// VkHashesRef — ссылка на список хешей звонков VK.
	VkHashesRef string `toml:"vk_hashes_ref"`

	// Workers — число воркеров. Кратно девяти, потолок 108; округляет
	// и обрезает ядро (core.Config.Normalize), здесь значение не трогают.
	Workers int `toml:"workers"`
	// Obfs — режим RTP-маскировки: audio или video.
	Obfs string `toml:"obfs"`
	// TurnTransport — udp или tcp. TCP помогает в сетях, где душат UDP.
	TurnTransport string `toml:"turn_transport"`
	// DTLS — поднимать ли DTLS поверх TURN. Указатель, потому что «не задано»
	// и «задано false» здесь разные вещи: пропущенное поле означает обычный
	// режим с DTLS, а false — прямой RTP-obfs AEAD, который требует сервера,
	// запущенного с -listen-direct.
	DTLS *bool `toml:"dtls"`
	// DNS — резолвер для доменов VK.
	DNS string `toml:"dns"`
	// Datapath — как отдавать трафик: socks, tun или external.
	Datapath string `toml:"datapath"`
	// KillSwitch — блокировать ли трафик системы, пока туннель не поднят
	// (tun и external, plan-e3.md). Указатель: пропущенное поле значит
	// «включён», выключает только явное false. Читать — KillSwitchOn.
	KillSwitch *bool `toml:"kill_switch"`

	// Socks — секция [profile.<имя>.socks].
	Socks SocksSection `toml:"socks"`
}

type SecretStore interface {
	// Put кладёт значение под именем name и возвращает ссылку на него.
	// Повторный вызов с тем же name перезаписывает прежнее значение и
	// возвращает ту же ссылку — чтобы `tt profile set` не плодил осиротевшие
	// записи при каждом запуске.
	Put(name, value string) (ref string, err error)
	// Get разворачивает ссылку обратно в значение.
	Get(ref string) (value string, err error)
	// Delete убирает значение из хранилища. Ссылка, которой в хранилище нет,
	// ошибкой не считается: `tt profile rm` должен доводить удаление до конца,
	// даже если запись пропала раньше.
	Delete(ref string) error
}

type ShareLink struct {
	// Name — имя профиля, как его назвали в приложении: бывают кириллица и
	// пробелы. Имя для нашего файла — ProfileName.
	Name string
	// Peer — адрес сервера, с портом.
	Peer string
	// Password — пароль подключения. Пусто — в ссылке его не было.
	Password string
	// Hashes — хеши звонков VK строкой, как в ссылке: через запятую, перевод
	// строки, бывают ссылки на звонки целиком. Пусто — в ссылке хешей нет
	// (у Android это «общие хеши» приложения, у нас их нет).
	Hashes string
	// Workers — число воркеров, если оно в ссылке есть и отличается от
	// умолчания ядра; иначе 0.
	Workers int
}

type SocksSection struct {
	Listen string `toml:"listen"`
}