Files
java-word-pdf/wordpdf-web/src/api.ts
T
Pjandro 2750486c91 dev-стенд: 0.0.0.0:9011, vite host:true, гейт ключа только по 401-зонду
- docker-compose.dev.yml: ports 127.0.0.1:9011:80 → 9011:80 (вход по LAN-IP хоста)
- vite.config.ts: server.host=true — dev-сервер тоже на все интерфейсы
- api.ts: probeApiKey() — GET /api/v1/convert (POST-only эндпоинт): 401 от
  ApiKeyFilter ⟺ сервер требует ключ; при выключенной аутентификации не 401
- App.tsx: экран ApiKeyGate показывается только когда зонд вернул 'required';
  401 на конвертации возвращает к гейту (setGate('required'))
- AGENTS.md: обновлены поведенческие строки (dev-вход, контракт гейта)
2026-10-16 22:11:53 +00:00

95 lines
4.0 KiB
TypeScript

/** Ошибка 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
errorOnCharts: boolean
errorOnSmartArt: boolean
}
/**
* Единственная сетевая точка приложения: POST /api/v1/convert (multipart,
* поля `file`, `renderCharts`, `renderSmartArt`, `errorOnCharts`,
* `errorOnSmartArt`) → 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)
fd.append('renderCharts', String(options.renderCharts))
fd.append('renderSmartArt', String(options.renderSmartArt))
fd.append('errorOnCharts', String(options.errorOnCharts))
fd.append('errorOnSmartArt', String(options.errorOnSmartArt))
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}`)
}
// Framework 7 отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) —
// флаг i обязателен; фолбэк — имя исходника с заменой расширения
const cd = resp.headers.get('Content-Disposition') ?? ''
const m = /filename\*=utf-8''([^;]+)/i.exec(cd)
const filename = m ? decodeURIComponent(m[1]) : file.name.replace(/\.docx$/i, '') + '.pdf'
const blob = await resp.blob()
return { blob, filename }
}
/**
* Требует ли сервер ключ: GET /api/v1/convert (эндпоинт POST-only) —
* 401 пишет ApiKeyFilter при требуемом и непринятом ключе; при выключенной
* аутентификации (dev) до фильтра дело не доходит — 405 от Spring.
* Сетевая ошибка — 'open': не блокировать UI, конвертация сама покажет ошибку.
*/
export async function probeApiKey(): Promise<'open' | 'required'> {
const key = getApiKey()
try {
const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, {
headers: key ? { 'X-API-Key': key } : undefined,
})
if (resp.status === 401) {
clearApiKey() // ключ устарел/отозван — форма откроется пустой
return 'required'
}
return 'open'
} catch {
return 'open'
}
}