loginmethod

type CostClassCensus interface {
	// PasswordCostClasses — по строке на класс, с числом строк; один проход по
	// таблице способов без индекса по материалу (индекс копировал бы колонку в
	// свои страницы, и заводить его нельзя — шапка миграции таблицы).
	PasswordCostClasses(ctx context.Context) ([]CostClassCount, error)
}

type CostClassCount struct {
	Prefix string
	Rows   int64
}

type Store interface {
	// Create заводит способ.
	//
	//   - INVALID_ARGUMENT — строка негодна (`domain.LoginMethod.Validate`); до
	//     базы вход не доходит;
	//   - ALREADY_EXISTS — у человека уже есть способ этого вида. Производит
	//     ключ базы, поэтому под конкуренцией проходит ровно одна вставка;
	//   - FAILED_PRECONDITION — человека нет.
	Create(ctx context.Context, m domain.LoginMethod) (domain.LoginMethod, error)

	// Get читает способ человека данного вида. NOT_FOUND — такого способа нет.
	Get(ctx context.Context, userID domain.UserID, kind domain.LoginMethodKind) (domain.LoginMethod, error)

	// MarkEmailVerified записывает момент подтверждения адреса address человеку
	// userID — ТОЛЬКО если текущий адрес человека побайтово равен address.
	// Подтверждённость есть свойство значения: подтверждение значения, которое
	// успело смениться, не ложится.
	//
	//   - INVALID_ARGUMENT — момент нулевой;
	//   - NOT_FOUND — человека нет;
	//   - FAILED_PRECONDITION — текущий адрес не тот, что подтверждали.
	MarkEmailVerified(ctx context.Context, userID domain.UserID, address domain.Email, at time.Time) error

	// EmailVerification — момент подтверждения ТЕКУЩЕГО адреса. Исходов три,
	// и различаются они типом: (момент, true) — подтверждён; (нуль, false) — не
	// подтверждён; ошибка — спросить не удалось (NOT_FOUND — человека нет).
	EmailVerification(ctx context.Context, userID domain.UserID) (at time.Time, verified bool, err error)

	// AccessKeyEnrolled — есть ли у человека хоть одна строка ключа доступа.
	// Ключ — ресурс своей таблицы, а не строка способа входа; ось «заведено»
	// единственного писателя обнуления счёта по адресу читает его этим
	// вопросом (`humansession/completed_login.go`).
	AccessKeyEnrolled(ctx context.Context, userID domain.UserID) (bool, error)
}