SPA: экран ввода ключа и сборка под префиксом /pdf-converter/

ApiKeyGate: ключ в localStorage (wordpdf.api.key), при 401 очищается и
форма открывается заново; заголовок X-API-Key подставляет только api.ts.
base сборки — env VITE_BASE (дефолт '/'); vite.local.config.ts — локальный
прогон без прод-префикса.
This commit is contained in:
Pjandro
2026-10-14 01:50:40 +00:00
parent 25ed56bf20
commit 4634c0c5aa
6 changed files with 194 additions and 24 deletions
+39 -3
View File
@@ -1,23 +1,59 @@
/** Ошибка API: сервер ответил не 2xx — текст из JSON `{"error": …}`. */
export class ApiError extends Error {}
/** Ключ не принят сервером (401): сервер изменился/ключ отозван. */
export class UnauthorizedError extends ApiError {}
const API_KEY_STORAGE = 'wordpdf.api.key'
export function getApiKey(): string | null {
try { return localStorage.getItem(API_KEY_STORAGE) } catch { return null }
}
export function setApiKey(key: string): void {
try { localStorage.setItem(API_KEY_STORAGE, key) } catch { /* приватный режим: ключ только на эту загрузку */ }
}
export function clearApiKey(): void {
try { localStorage.removeItem(API_KEY_STORAGE) } catch { /* нечего чистить */ }
}
export interface ConvertResult {
blob: Blob
filename: string
}
/** Настройки на один вызов: поля соответствуют параметрам API. Лимиты
* входа (размер/страницы) задаёт только сервер, параметрами не шлются. */
export interface ConvertOptions {
renderCharts: boolean
renderSmartArt: boolean
}
/**
* Единственная сетевая точка приложения: POST /api/v1/convert (multipart,
* поле `file`) → PDF-blob + имя файла из Content-Disposition.
* Таймаут на фронте не ставим: конвертация долгая — это ожидаемо.
* поля `file`, `renderCharts`, `renderSmartArt`) → PDF-blob + имя файла из
* Content-Disposition. Таймаут на фронте не ставим: конвертация долгая —
* это ожидаемо.
*/
export async function convertDocx(
file: File,
signal: AbortSignal,
options: ConvertOptions,
): Promise<ConvertResult> {
const fd = new FormData()
fd.append('file', file, file.name)
const resp = await fetch('/api/v1/convert', { method: 'POST', body: fd, signal })
fd.append('renderCharts', String(options.renderCharts))
fd.append('renderSmartArt', String(options.renderSmartArt))
const key = getApiKey()
const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, {
method: 'POST',
body: fd,
signal,
headers: key ? { 'X-API-Key': key } : undefined,
})
// очистка до UI: после отзыва ключа форма откроется пустой
if (resp.status === 401) {
clearApiKey()
throw new UnauthorizedError('Ключ доступа не принят')
}
if (!resp.ok) {
const json = (await resp.json().catch(() => null)) as { error?: string } | null
throw new ApiError(json?.error ?? `HTTP ${resp.status}`)