clients

type ConditionalTuple = authztypes.ConditionalTuple

type InviteMailObserver interface {
	// IncInviteMailOutcome — исход одной попытки отправки; kind — вид события
	// из MailEventTypes, outcome — клетка из InviteMailOutcomes.
	IncInviteMailOutcome(kind, outcome string)
}

type InviteMailSender struct {
	// contains filtered or unexported fields
}

type InviteMailTransport interface {
	Send(ctx context.Context, ev MailEvent) error
}

type MailEvent struct {
	// To — адрес получателя. Единственная координата, без которой письмо
	// отправить некому.
	To string `json:"to"`
	// AccountID — аккаунт. Атрибуция и тело письма приглашения.
	AccountID string `json:"account_id"`
	// UserID — строка человека. Атрибуция; отправка от неё не зависит.
	UserID string `json:"user_id"`
	// LoginURL — адрес страницы входа. Пусто → берётся из настройки установки.
	LoginURL string `json:"login_url,omitempty"`
	// Code — код в форме для человека; у видов восстановления и подтверждения.
	// Строка этих видов без кода нерастолковываема.
	Code string `json:"code,omitempty"`
	// CodeValidMinutes — срок кода в минутах, как его называет письмо (Ф1-25:
	// «код с объявленным сроком»). У видов восстановления и подтверждения.
	CodeValidMinutes int `json:"code_valid_minutes,omitempty"`
	// ChangedAt — момент смены адреса (RFC 3339, до секунды); у уведомления о
	// смене адреса. Нового адреса уведомление не несёт.
	ChangedAt string `json:"changed_at,omitempty"`
	// Kind — вид события строки; проставляется применителем, в нагрузке не
	// хранится.
	Kind string `json:"-"`
}

type MailRelay struct {
	// Addr — `host:port` почтового узла.
	Addr string
	// From — адрес отправителя, ОДИН на установку (Р16).
	From string
	// FromName — отображаемое имя отправителя; необязательно.
	FromName string
	// Username/Password — удостоверение. Приезжает из СЕКРЕТА, не из карты
	// настроек (Р6). ПАРА: половина настройки хуже отсутствия обеих, потому что
	// выглядит настроенной (Р4).
	Username string
	Password string
	// AttemptTimeout — СОБСТВЕННЫЙ предел времени на ОДНУ попытку: весь разговор
	// с узлом, от соединения до принятого письма. Отдельная величина от числа
	// повторов, и наблюдаема она на узле, который принимает соединение и молчит.
	AttemptTimeout time.Duration
	// TLSMode — посадка полосы. Р5: шифрование обязательно и на стенде тоже.
	TLSMode MailTLSMode
	// RootCAs — якорь доверия для проверки сертификата узла. nil означает
	// системный набор, а НЕ отключённую проверку: проверка не отключается ничем.
	RootCAs *x509.CertPool
	// ServerName — имя, по которому сверяется сертификат узла. Пусто → берётся
	// из Addr.
	ServerName string
	// LoginURL — адрес страницы входа, который несёт письмо. Ссылки-предъявителя
	// приглашение НЕ несёт (Р24): обладание письмом доступа не даёт.
	LoginURL string
}

type MailTLSMode int

type RelationQueries interface {
	// CheckWithContext — вердикт с условным контекстом запроса.
	CheckWithContext(ctx context.Context, subject, relation, object string, condCtx map[string]any) (allowed bool, err error)

	// BatchCheckWithContext — ОДИН вопрос о МНОГИХ объектах одного типа; по
	// вердикту на объект, позиционно.
	//
	// Объявлен здесь, а не отдельной способностью, НАМЕРЕННО: этот порт — тип
	// поля в каждом читающем use-case, а фильтр страницы (`internal/authzfilter`)
	// выбирает батчевый путь. Провязка, потерявшая способность, продолжала бы
	// возвращать верные строки, платя по обращению за строку, и заметить это было
	// бы нечем. Здесь потеря — ошибка компиляции.
	//
	// Стоимость страницы принадлежит ЗАПРОСУ: ответ собирается одной читающей
	// транзакцией, поэтому все объекты страницы видят один снимок базы.
	BatchCheckWithContext(ctx context.Context, subject, relation string, objects []string,
		condCtx map[string]any) (allowed []bool, err error)

	// ListSubjects — кто держит это отношение на объекте, СТРАНИЦЕЙ С КУРСОРОМ.
	//
	// Курсор обязателен и это не оформление: перечисление без продолжения
	// оставляет остаток недостижимым при живых правах — ровно то, ради чего снято
	// перечисление объектов (решение Р1 приёмки R7-3).
	ListSubjects(ctx context.Context, objectType, objectID, relation string,
		pageSize int, pageToken string) (subjects []string, nextPageToken string, err error)
}

type RelationStore interface {
	// Check — держит ли субъект это отношение на этом объекте.
	//
	// Ошибка означает «ответа нет», а не «доступа нет»: вызывающий обязан
	// различать их, иначе недоступность базы читалась бы как законный отказ.
	Check(ctx context.Context, subject, relation, object string) (allowed bool, err error)
}

type RelationTuple struct {
	User     string
	Relation string
	Object   string
}

type TupleConditionRef = authztypes.TupleConditionRef