Files
java-word-pdf/wordpdf-web/src/api.ts
T
Pjandro 93ec325aa6
PR checks / java (pull_request) Successful in 47s
PR checks / web (pull_request) Successful in 1m6s
OLE-объекты: переключатель errorOnOle + тихое удаление из docx
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».

- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
  фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
  oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
  drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
2026-10-22 21:08:18 +00:00

93 lines
3.9 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 {
errorOnCharts: boolean
errorOnSmartArt: boolean
errorOnOle: boolean
}
/**
* Единственная сетевая точка приложения: POST /api/v1/convert (multipart,
* поля `file`, `errorOnCharts`, `errorOnSmartArt`, `errorOnOle`) → 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('errorOnCharts', String(options.errorOnCharts))
fd.append('errorOnSmartArt', String(options.errorOnSmartArt))
fd.append('errorOnOle', String(options.errorOnOle))
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'
}
}