itd-api

Тема

itd-api / AuthResource

Interface: AuthResource ​

Defined in: resources/auth.ts:67

Авторизация, сессии и пароли.

Доступна как itd.auth.

Extends ​

  • BaseResource

Methods ​

changePassword() ​

ts
changePassword(input, options?): Promise<void>;

Defined in: resources/auth.ts:380

Меняет пароль. Требует действующей сессии.

При неверном текущем пароле сервер отвечает ACCOUNT_CURRENT_PASSWORD_INCORRECT.

Parameters ​

input ​
currentPassword ​

string

newPassword ​

string

options? ​

RequestOptions = {}

Returns ​

Promise<void>

Example ​

ts
await itd.auth.changePassword({ currentPassword, newPassword });

check() ​

ts
check(options?): Promise<AuthState>;

Defined in: resources/auth.ts:80

Проверяет состояние авторизации и возвращает текущего пользователя.

Без авторизации возвращает authenticated: false и user: null.

Parameters ​

options? ​

RequestOptions = {}

Returns ​

Promise<AuthState>

forgotPassword() ​

ts
forgotPassword(input, options?): Promise<string>;

Defined in: resources/auth.ts:299

Запрашивает письмо с кодом для сброса пароля.

Parameters ​

input ​

ForgotPasswordInput

options? ​

RequestOptions = {}

Returns ​

Promise<string>

flowToken, который нужно передать в resetPassword

hasRefreshSession() ​

ts
hasRefreshSession(): Promise<boolean>;

Defined in: resources/auth.ts:260

Есть ли признак живой сессии обновления.

Проверяет cookie is_auth, которую сервер ставит рядом с refresh-токеном, а также refresh-токен, переданный строкой. Позволяет не дёргать API у неавторизованного пользователя. В браузере всегда true: cookie ведёт сама среда, и прочитать её из JS нельзя.

Читает TokenStorage, поэтому результат верен и до первого запроса.

Returns ​

Promise<boolean>

Example ​

ts
if (await itd.auth.hasRefreshSession()) await itd.auth.refresh();
else redirectToLogin();

logout() ​

ts
logout(options?): Promise<void>;

Defined in: resources/auth.ts:265

Завершает текущую сессию на сервере и очищает локальную.

Parameters ​

options? ​

RequestOptions = {}

Returns ​

Promise<void>

logoutAll() ​

ts
logoutAll(options?): Promise<void>;

Defined in: resources/auth.ts:284

Завершает все сессии пользователя и очищает локальную.

Собран из двух запросов, потому что единого эндпоинта на сервере нет: POST /api/v1/auth/logout-all отвечает 404. Сначала отзываются все прочие сессии (DELETE /api/v1/auth/sessions), затем завершается текущая — в обратном порядке отзывать было бы уже нечем.

Parameters ​

options? ​

RequestOptions = {}

Returns ​

Promise<void>

refresh() ​

ts
refresh(): Promise<string>;

Defined in: resources/auth.ts:240

Обновляет токен доступа.

Параллельные вызовы объединяются в один сетевой запрос. При включённом autoRefresh вызывать вручную обычно не нужно.

Returns ​

Promise<string>

resendOtp() ​

ts
resendOtp(input, options?): Promise<void>;

Defined in: resources/auth.ts:172

Отправляет код подтверждения повторно.

Parameters ​

input ​
email ​

string

flowToken ​

string

options? ​

RequestOptions = {}

Returns ​

Promise<void>

resetPassword() ​

ts
resetPassword(input, options?): Promise<void>;

Defined in: resources/auth.ts:323

Устанавливает новый пароль по коду из письма.

Сервер ждёт все четыре поля сразу — email, otp, flowToken и newPassword; при нехватке любого отвечает 422.

Parameters ​

input ​

ResetPasswordInput

options? ​

RequestOptions = {}

Returns ​

Promise<void>

resetPasswordWithOtp() ​

ts
resetPasswordWithOtp(input, options?): Promise<void>;

Defined in: resources/auth.ts:350

Полный сброс пароля с кодом из письма.

Тот же приём, что и signInWithOtp: код запрашивается функцией getOtp, остальное библиотека делает сама.

Parameters ​

input ​

ForgotPasswordInput & object

options? ​

RequestOptions = {}

Returns ​

Promise<void>

Example ​

ts
await itd.auth.resetPasswordWithOtp({
  email,
  turnstileToken,
  newPassword,
  getOtp: () => rl.question('Код из письма: '),
});

revokeOtherSessions() ​

ts
revokeOtherSessions(options?): Promise<void>;

Defined in: resources/auth.ts:413

Завершает все сессии, кроме текущей.

Parameters ​

options? ​

RequestOptions = {}

Returns ​

Promise<void>

revokeSession() ​

ts
revokeSession(sessionId, options?): Promise<void>;

Defined in: resources/auth.ts:404

Завершает указанную сессию.

Parameters ​

sessionId ​

string

options? ​

RequestOptions = {}

Returns ​

Promise<void>

sessions() ​

ts
sessions(options?): Promise<Session[]>;

Defined in: resources/auth.ts:393

Загружает список активных сессий. У текущей поле isCurrent равно true.

Parameters ​

options? ​

RequestOptions = {}

Returns ​

Promise<Session[]>

signIn() ​

ts
signIn(credentials, options?): Promise<SignInResult>;

Defined in: resources/auth.ts:121

Выполняет вход.

Если сервер потребовал код подтверждения, вернётся status: 'otp_required' — тогда продолжайте через verifyOtp либо воспользуйтесь signInWithOtp.

При успешном входе токен сохраняется в клиенте автоматически.

Parameters ​

credentials ​

CaptchaCredentials

email, пароль и обязательный токен капчи — см. CaptchaCredentials

options? ​

RequestOptions = {}

Returns ​

Promise<SignInResult>

signInWithOtp() ​

ts
signInWithOtp(input, options?): Promise<string>;

Defined in: resources/auth.ts:204

Полный вход с подтверждением по коду.

Удобно для скриптов и ботов: код запрашивается функцией getOtp, а всё остальное библиотека делает сама.

Parameters ​

input ​

CaptchaCredentials & object

options? ​

RequestOptions = {}

Returns ​

Promise<string>

Example ​

ts
import { createInterface } from 'node:readline/promises';

const rl = createInterface({ input: process.stdin, output: process.stdout });

const token = await itd.auth.signInWithOtp({
  email, password,
  getOtp: () => rl.question('Код из письма: '),
});

signOut() ​

ts
signOut(): Promise<void>;

Defined in: resources/auth.ts:290

Забывает сессию локально, не обращаясь к серверу.

Returns ​

Promise<void>

signUp() ​

ts
signUp(credentials, options?): Promise<string>;

Defined in: resources/auth.ts:93

Регистрирует аккаунт и запускает подтверждение по коду.

Parameters ​

credentials ​

CaptchaCredentials

options? ​

RequestOptions = {}

Returns ​

Promise<string>

flowToken, который нужно передать в verifyOtp

verifyOtp() ​

ts
verifyOtp(input, options?): Promise<string>;

Defined in: resources/auth.ts:149

Подтверждает вход кодом из письма.

Полученный токен сохраняется в клиенте автоматически.

Parameters ​

input ​

Credentials & object

options? ​

RequestOptions = {}

Returns ​

Promise<string>

Документация itd-api

MIT License