fix(cli,web): команды аккаунтов в CLI и повтор запросов при 429
- deploy/glchat-cli.sh: reset-password/make-admin/remove-admin больше не заглушки «появится в фазе 1» (AGENT.md 10.7), добавлены totp-setup, totp-reset и delete-user; подкоманды обслуживания идут через общий app_cli - cmd/glchat: команда delete-user (мягкое удаление как в админ-панели, защита от удаления инстанс-админа и подтверждение --yes), исправлен потерянный комментарий cliCleanup - deploy/install.sh: убраны устаревшие формулировки про фазу 1 - web: политика повторов запросов — 429 повторяется с паузой retry_after_ms (до двух раз, не дольше 5 с), 4xx не повторяются; тесты web/tests/queryRetry.test.ts - scripts/test-install.sh: проверка, что заглушек в CLI не осталось
This commit is contained in:
@@ -1,18 +1,97 @@
|
||||
import { QueryClient } from '@tanstack/react-query';
|
||||
|
||||
import { ApiError, apiErrorField } from '@/api/client';
|
||||
|
||||
/**
|
||||
* Единый QueryClient приложения. Живёт в модуле (а не в main.tsx), чтобы
|
||||
* не-React код — например стор шлюза — мог инвалидировать кэш REST-запросов.
|
||||
*/
|
||||
let client: QueryClient | null = null;
|
||||
|
||||
/**
|
||||
* Сколько раз повторять запрос, упёршийся в лимит частоты (429). Сервер вместе
|
||||
* с ошибкой присылает `retry_after_ms`, поэтому повтор не «долбит» лимит, а
|
||||
* ждёт назначенную паузу: под нагрузкой матрицы 11.6 списки (участники, звуки,
|
||||
* эмодзи) иначе остаются пустыми до ручного «Повторить».
|
||||
*/
|
||||
const RATE_LIMIT_RETRIES = 2;
|
||||
|
||||
/**
|
||||
* Предел паузы, которую имеет смысл выждать внутри запроса. Если сервер просит
|
||||
* больше (например, минутный лимит загрузок), повтор не делаем: пользователю
|
||||
* полезнее сразу увидеть понятную ошибку с кнопкой «Повторить», чем ждать.
|
||||
*/
|
||||
const MAX_RATE_LIMIT_WAIT_MS = 5_000;
|
||||
|
||||
/** Запас к паузе сервера: часы клиента и сервера расходятся, окно скользящее. */
|
||||
const RATE_LIMIT_MARGIN_MS = 250;
|
||||
|
||||
/** Повторы «обычных» сбоев (сеть, 5xx) — как было: одна попытка. */
|
||||
const TRANSIENT_RETRIES = 1;
|
||||
|
||||
function errorStatus(error: unknown): number | null {
|
||||
if (error instanceof ApiError) {
|
||||
return error.status;
|
||||
}
|
||||
const status = (error as { status?: unknown } | null)?.status;
|
||||
return typeof status === 'number' ? status : null;
|
||||
}
|
||||
|
||||
function isAbort(error: unknown): boolean {
|
||||
return error instanceof DOMException && error.name === 'AbortError';
|
||||
}
|
||||
|
||||
/**
|
||||
* Пауза из ответа 429 (`retry_after_ms`) плюс небольшой запас. `null` — сервер
|
||||
* паузу не назвал: тогда работает обычная выдержка с удвоением.
|
||||
*/
|
||||
function rateLimitWaitMs(error: unknown): number | null {
|
||||
const value = apiErrorField(error, 'retry_after_ms');
|
||||
if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
|
||||
return null;
|
||||
}
|
||||
return Math.round(value) + RATE_LIMIT_MARGIN_MS;
|
||||
}
|
||||
|
||||
/**
|
||||
* Политика повторов для запросов: 4xx (кроме 429) повторять бессмысленно —
|
||||
* ответ не изменится; 429 повторяем с паузой сервера; сеть и 5xx — один раз.
|
||||
*/
|
||||
export function shouldRetryQuery(failureCount: number, error: unknown): boolean {
|
||||
if (isAbort(error)) {
|
||||
return false;
|
||||
}
|
||||
const status = errorStatus(error);
|
||||
if (status === 429) {
|
||||
if (failureCount >= RATE_LIMIT_RETRIES) {
|
||||
return false;
|
||||
}
|
||||
const wait = rateLimitWaitMs(error);
|
||||
return wait === null || wait <= MAX_RATE_LIMIT_WAIT_MS;
|
||||
}
|
||||
if (status !== null && status < 500) {
|
||||
return false;
|
||||
}
|
||||
return failureCount < TRANSIENT_RETRIES;
|
||||
}
|
||||
|
||||
/** Задержка перед повтором: пауза сервера для 429, иначе удвоение с потолком. */
|
||||
export function queryRetryDelay(failureCount: number, error: unknown): number {
|
||||
const wait = rateLimitWaitMs(error);
|
||||
if (wait !== null) {
|
||||
return Math.min(wait, MAX_RATE_LIMIT_WAIT_MS);
|
||||
}
|
||||
return Math.min(1_000 * 2 ** failureCount, 8_000);
|
||||
}
|
||||
|
||||
export function getQueryClient(): QueryClient {
|
||||
client ??= new QueryClient({
|
||||
defaultOptions: {
|
||||
queries: {
|
||||
staleTime: 30_000,
|
||||
refetchOnWindowFocus: false,
|
||||
retry: 1,
|
||||
retry: shouldRetryQuery,
|
||||
retryDelay: queryRetryDelay,
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user