@gerege-systems/eid-mongolia-sdk 0.16.0 → 0.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +61 -1
- package/bin/convert-assets.mjs +79 -0
- package/bin/eid-convert.worker.js +18 -0
- package/dist/convert.d.ts +113 -0
- package/dist/convert.js +1638 -0
- package/dist/pades.cjs +3 -1
- package/dist/pades.js +3 -1
- package/package.json +23 -4
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ RP-API v3, Smart-ID нийцтэй. Бүрэн баримт: <https://developer.
|
|
|
16
16
|
npm install @gerege-systems/eid-mongolia-sdk
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
Node.js ≥ 18 (global `fetch`, `node:crypto`) — бүх entry (`.`, `/browser`, `/button`, `/pades`), CI-д Node 18 / 20 / 22-оор шалгагдана.
|
|
19
|
+
Node.js ≥ 18 (global `fetch`, `node:crypto`) — бүх entry (`.`, `/browser`, `/button`, `/pades`; `/convert` зөвхөн хөтөч, §3e), CI-д Node 18 / 20 / 22-оор шалгагдана.
|
|
20
20
|
`/pades` мөн орчин үеийн хөтөчид (Web Crypto) ажиллана.
|
|
21
21
|
|
|
22
22
|
## 1. RP бүртгүүлэх
|
|
@@ -577,6 +577,65 @@ Go backend-д `complete` хийж болно).
|
|
|
577
577
|
0.15.0-д `eid.pdf` (`prepare`, `document`, `documentVerified`, `tokenPrepare`, `tokenFinalize`, `tokenDocument`) ба
|
|
578
578
|
`pdfTimeoutMs` / `pdfMaxBytes` устсан — PDF upload endpoint-ууд CA-д байхгүй (2026-10-14-нд устсан, 404).
|
|
579
579
|
|
|
580
|
+
## 3e. Word → PDF хөтөч дотор — `@gerege-systems/eid-mongolia-sdk/convert`
|
|
581
|
+
|
|
582
|
+
Иргэн Word (.docx / .doc) баримт сонговол хөтөч өөрөө PDF болгоно — **файл сервер рүү ОЧИХГҮЙ** (§3d-тэй ижил зарчим).
|
|
583
|
+
Хувиргагч нь LibreOffice 24.8-ийн WebAssembly build (`@matbee/libreoffice-converter@2.7.2`, MPL-2.0), Web Worker-т.
|
|
584
|
+
Гарын үсэг **Word файлд биш, хувиргасан PDF-д** зурагдана — иргэнд тэр PDF-ийг (яг тэр байтуудыг) зурахаас ӨМНӨ заавал
|
|
585
|
+
харуулж, «шалгасан» гэж зөвшөөрүүл; хувиргалтад фонт, мөр, хуудас шилжиж болно (`warnings`).
|
|
586
|
+
|
|
587
|
+
```bash
|
|
588
|
+
npm install @gerege-systems/eid-mongolia-sdk @matbee/libreoffice-converter@2.7.2 # optional peer — зөвхөн /convert-д
|
|
589
|
+
npx eid-mongolia-convert-assets public/eid-convert # build үед; git-д commit хийхгүй (~250 MB)
|
|
590
|
+
```
|
|
591
|
+
|
|
592
|
+
```ts
|
|
593
|
+
import { wordToPdf, converterStatus, isWordFile, ConvertError } from "@gerege-systems/eid-mongolia-sdk/convert";
|
|
594
|
+
|
|
595
|
+
if (isWordFile(file)) {
|
|
596
|
+
const s = await converterStatus({ assetsBase: "/eid-convert/" }); // { cached, downloadBytes } — мобайл датанд анхааруул
|
|
597
|
+
const { pdf, pages, warnings } = await wordToPdf(file, {
|
|
598
|
+
assetsBase: "/eid-convert/",
|
|
599
|
+
signal: controller.signal, // цуцлах → DOMException AbortError
|
|
600
|
+
onProgress: ({ phase, percent, loaded, total }) => show(phase, percent), // download (зөвхөн эхний удаа) → init → convert
|
|
601
|
+
});
|
|
602
|
+
preview(pdf); // иргэн шалгаад зөвшөөрнө
|
|
603
|
+
const p = await prepare(pdf, { signerCert, verifyPage: true, fileName: "Гэрээ.pdf" }); // §3d
|
|
604
|
+
}
|
|
605
|
+
```
|
|
606
|
+
|
|
607
|
+
| Функц | Тайлбар |
|
|
608
|
+
|---|---|
|
|
609
|
+
| `wordToPdf(file, { assetsBase, onProgress?, signal?, fileName? })` | `{ pdf, pages, warnings }`. Нэг worker-ийг дахин ашиглана, дуудлагууд дараалалд |
|
|
610
|
+
| `converterStatus({ assetsBase })` | `{ cached, downloadBytes }` — татахаас өмнө хэмжээг хэлэх (gzip хэмжээ, кэштэй бол 0) |
|
|
611
|
+
| `isWordFile(file \| name)` | .docx / .doc эсэх (нэр, MIME). Агуулгыг `wordToPdf` эхний байтаар шалгана |
|
|
612
|
+
| `disposeConverter()` | worker-ийг зогсоож санах ойг чөлөөлнө (кэш үлдэнэ) |
|
|
613
|
+
|
|
614
|
+
**Хост дээр (заавал).**
|
|
615
|
+
- Хувиргах хуудас **crossOriginIsolated**: `Cross-Origin-Opener-Policy: same-origin` + `Cross-Origin-Embedder-Policy:
|
|
616
|
+
require-corp` (SharedArrayBuffer). Зөвхөн тэр route-д тавьж болно — тэгвэл тэр хуудас руу **hard navigation**
|
|
617
|
+
(`<a href>`, client-side router биш). Үгүй бол `wordToPdf` шууд `NOT_ISOLATED` (хүлээхгүй). COEP-ийн дор гадны
|
|
618
|
+
CORP/CORS-гүй зураг, iframe ачаалагдахгүй.
|
|
619
|
+
- Asset-ууд **өөрийн хост** дээр (`assetsBase`): `manifest.json` — `Cache-Control: no-cache`; `<хувилбар>/*` — урт кэш
|
|
620
|
+
(`public, max-age=31536000, immutable`), `.wasm` → `application/wasm`, gzip/brotli шахалттай (≈250 MB → gzip 77 MB).
|
|
621
|
+
Эхний удаа татсаныг SDK Cache Storage-д хадгална (дахин татахгүй); хувилбар солигдвол хуучныг устгана.
|
|
622
|
+
- Worker-ийн скриптүүдэд (`<assetsBase><хувилбар>/*.js`) **тусдаа CSP**: `default-src 'self'; script-src 'self'
|
|
623
|
+
'wasm-unsafe-eval' 'unsafe-eval'` (Emscripten-д `eval` хэрэгтэй — зөвхөн worker-т). Хуудасны хатуу CSP (nonce +
|
|
624
|
+
`'strict-dynamic'`) хэвээр байна; хуудсанд `connect-src 'self'` хангалттай.
|
|
625
|
+
- MPL-2.0: `<хувилбар>/NOTICE.txt` (эх код, лицензийн холбоос) asset-уудтай хамт үйлчилгээнд байна — хэрэглэгчийн
|
|
626
|
+
нүүрэнд (тусламж/лиценз хэсэгт) LibreOffice-ийг дурд.
|
|
627
|
+
|
|
628
|
+
`ConvertError.code`: `UNSUPPORTED_ENVIRONMENT`, `NOT_ISOLATED`, `UNSUPPORTED_FILE`, `INPUT_TOO_LARGE` (> 50 MB),
|
|
629
|
+
`ASSETS_UNAVAILABLE` (`retryable`), `CONVERT_FAILED` (эвдэрсэн / нууц үгтэй баримт). `warnings[].code`:
|
|
630
|
+
`FONT_SUBSTITUTED` (`fonts` — хувиргагчид байхгүй, хэмжээ-нийцтэй орлуулагчгүй фонт; Times New Roman / Arial /
|
|
631
|
+
Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуулагч анхааруулахгүй), `FONT_FALLBACK` (`fonts` —
|
|
632
|
+
зарим тэмдэгтийг өөр фонтоор, жишээ нь Caladea-д кирилл байхгүй тул Noto), `PDF_NEAR_LIMIT` / `PDF_TOO_LARGE` (`bytes`,
|
|
633
|
+
`limit` — §3d `prepare`-ийн 10 223 616 байт). Фонтын анхааруулга .docx-д л (heuristic); .doc-д үгүй.
|
|
634
|
+
|
|
635
|
+
Шалгасан: Chromium ба WebKit (Playwright, `npm run test:convert-e2e`) — .docx ба .doc → PDF → `prepare`, кэштэй дахин
|
|
636
|
+
ажиллуулахад татахгүй, цуцлалт, COEP-гүй хуудас. Мобайл хөтөчид 250 MB WASM санах ой их шаардана — сул утсанд унаж
|
|
637
|
+
болзошгүй.
|
|
638
|
+
|
|
580
639
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
581
640
|
|
|
582
641
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
|
@@ -731,6 +790,7 @@ npm run lint # tsc --noEmit
|
|
|
731
790
|
npm test # build + node --test (pades golden — Go reference-тэй байт-ижил)
|
|
732
791
|
npm run golden:check # test/fixtures/pades/golden + src/pades/assets ↔ бэхэлсэн Go commit
|
|
733
792
|
npm run size:pades # /pades хөтчийн bundle gzip ≤ 300 KB
|
|
793
|
+
npm run test:convert-e2e # /convert жинхэнэ LibreOffice Chromium-д (BROWSER=webkit — WebKit)
|
|
734
794
|
```
|
|
735
795
|
|
|
736
796
|
`/pades`-ийн conformance fixture (golden: оролт, тестийн PKI-ийн гэрчилгээ, TSA/OCSP/CRL-ийн тогтмол хариу, хүлээгдэх
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// eid-mongolia-convert-assets <гаралтын хавтас> — `@gerege-systems/eid-mongolia-sdk/convert`-ийн хөтчийн asset-уудыг
|
|
3
|
+
// төслийн node_modules-ийн `@matbee/libreoffice-converter`-оос хуулна (build үед; git-д commit хийхгүй — ~250 MB).
|
|
4
|
+
//
|
|
5
|
+
// <хавтас>/manifest.json — богино кэш (no-cache): хувилбар, файл бүрийн хэмжээ (+ gzip хэмжээ)
|
|
6
|
+
// <хавтас>/<хувилбар>/soffice.* — урт кэш (immutable)
|
|
7
|
+
// <хавтас>/<хувилбар>/eid-convert.worker.js, browser.worker.global.js
|
|
8
|
+
// <хавтас>/<хувилбар>/LICENSE-MPL-2.0.txt, NOTICE.txt
|
|
9
|
+
//
|
|
10
|
+
// `wordToPdf({ assetsBase: "<URL>/" })` нь <хавтас>-ын URL-ийг авна. Хуучин хувилбарын дэд хавтсыг устгана.
|
|
11
|
+
import { createRequire } from "node:module";
|
|
12
|
+
import { createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, rmSync, statSync, copyFileSync, writeFileSync, readFileSync } from "node:fs";
|
|
13
|
+
import { join, dirname } from "node:path";
|
|
14
|
+
import { createGzip } from "node:zlib";
|
|
15
|
+
import { pipeline } from "node:stream/promises";
|
|
16
|
+
import { Writable } from "node:stream";
|
|
17
|
+
|
|
18
|
+
const PKG = "@matbee/libreoffice-converter";
|
|
19
|
+
const FILES = {
|
|
20
|
+
"eid-convert.worker.js": null, // SDK-ийнх (bin/)
|
|
21
|
+
"soffice.js": "wasm/soffice.js",
|
|
22
|
+
"soffice.wasm": "wasm/soffice.wasm",
|
|
23
|
+
"soffice.data": "wasm/soffice.data",
|
|
24
|
+
"soffice.worker.js": "wasm/soffice.worker.js",
|
|
25
|
+
"browser.worker.global.js": "dist/browser.worker.global.js",
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
const out = process.argv[2];
|
|
29
|
+
if (!out || process.argv.length > 3) {
|
|
30
|
+
console.error("хэрэглээ: eid-mongolia-convert-assets <гаралтын хавтас>");
|
|
31
|
+
process.exit(2);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
let pkgJson;
|
|
35
|
+
try {
|
|
36
|
+
pkgJson = createRequire(join(process.cwd(), "package.json")).resolve(`${PKG}/package.json`);
|
|
37
|
+
} catch {
|
|
38
|
+
console.error(`${PKG} олдсонгүй — \`npm install ${PKG}@<SDK-ийн peerDependency хувилбар>\``);
|
|
39
|
+
process.exit(1);
|
|
40
|
+
}
|
|
41
|
+
const src = dirname(pkgJson);
|
|
42
|
+
const { version, license } = JSON.parse(readFileSync(pkgJson, "utf8"));
|
|
43
|
+
const peer = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).peerDependencies?.[PKG];
|
|
44
|
+
if (peer && peer !== version) {
|
|
45
|
+
console.error(`${PKG}@${version} суусан, SDK ${peer}-тэй л шалгагдсан — хувилбараа тааруул`);
|
|
46
|
+
process.exit(1);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const dir = `${version}/`;
|
|
50
|
+
mkdirSync(join(out, dir), { recursive: true });
|
|
51
|
+
for (const e of readdirSync(out)) {
|
|
52
|
+
if (e !== version && e !== "manifest.json" && statSync(join(out, e)).isDirectory() && /^\d+\.\d+\.\d+/.test(e)) rmSync(join(out, e), { recursive: true });
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
async function gzipSize(path) {
|
|
56
|
+
let n = 0;
|
|
57
|
+
await pipeline(createReadStream(path), createGzip({ level: 6 }), new Writable({ write(c, _e, cb) { n += c.length; cb(); } }));
|
|
58
|
+
return n;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const files = {};
|
|
62
|
+
for (const [name, rel] of Object.entries(FILES)) {
|
|
63
|
+
const from = rel === null ? new URL(name, import.meta.url).pathname : join(src, rel);
|
|
64
|
+
if (!existsSync(from)) {
|
|
65
|
+
console.error(`${PKG}/${rel} алга`);
|
|
66
|
+
process.exit(1);
|
|
67
|
+
}
|
|
68
|
+
const to = join(out, dir, name);
|
|
69
|
+
copyFileSync(from, to);
|
|
70
|
+
files[name] = { bytes: statSync(to).size, gzip: await gzipSize(to) };
|
|
71
|
+
}
|
|
72
|
+
// MPL-2.0 §3.2: эх кодын байршил ба лиценз дагалдана.
|
|
73
|
+
writeFileSync(join(out, dir, "NOTICE.txt"),
|
|
74
|
+
`${PKG}@${version} (${license}) — LibreOffice WebAssembly build.\n` +
|
|
75
|
+
`Source: https://github.com/matbeedotcom/libreoffice-document-converter (tag v${version}); LibreOffice: https://www.libreoffice.org/about-us/source-code/\n` +
|
|
76
|
+
`License text: https://www.mozilla.org/MPL/2.0/\n`);
|
|
77
|
+
writeFileSync(join(out, "manifest.json"), JSON.stringify({ format: 1, converter: PKG, version, dir, files }, null, 2) + "\n");
|
|
78
|
+
const sum = (k) => Object.values(files).reduce((s, f) => s + f[k], 0);
|
|
79
|
+
console.log(`${PKG}@${version} → ${join(out, dir)} (${(sum("bytes") / 1e6).toFixed(1)} MB, gzip ${(sum("gzip") / 1e6).toFixed(1)} MB)`);
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
// @gerege-systems/eid-mongolia-sdk/convert — хувиргагчийн worker. `?cache=<нэр>` бол soffice.wasm / soffice.data-г
|
|
2
|
+
// SDK-ийн урьдчилж татсан Cache Storage-аас өгнө (дахин татахгүй, blob URL-гүй); олдохгүй бол ердийн fetch.
|
|
3
|
+
// Дараа нь @matbee/libreoffice-converter-ийн worker-ийг ачаална. CSP: script-src 'self' 'wasm-unsafe-eval' 'unsafe-eval'.
|
|
4
|
+
(function () {
|
|
5
|
+
var name = new URL(self.location.href).searchParams.get("cache");
|
|
6
|
+
if (!name || typeof caches === "undefined") return;
|
|
7
|
+
var orig = self.fetch.bind(self);
|
|
8
|
+
self.fetch = function (input, init) {
|
|
9
|
+
var url = typeof input === "string" ? new URL(input, self.location.href).href : input instanceof URL ? input.href : input.url;
|
|
10
|
+
if (!/\/soffice\.(wasm|data)$/.test(url)) return orig(input, init);
|
|
11
|
+
return caches
|
|
12
|
+
.open(name)
|
|
13
|
+
.then(function (c) { return c.match(url); })
|
|
14
|
+
.catch(function () { return undefined; })
|
|
15
|
+
.then(function (hit) { return hit || orig(input, init); });
|
|
16
|
+
};
|
|
17
|
+
})();
|
|
18
|
+
importScripts("browser.worker.global.js");
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/** Хувиргагчийн peer багц — `eid-mongolia-convert-assets`-ийн хуулсан asset-уудтай ИЖИЛ хувилбар байх ёстой. */
|
|
2
|
+
declare const CONVERTER_PACKAGE = "@matbee/libreoffice-converter";
|
|
3
|
+
/** Word оролтын дээд хэмжээ (50 MiB) — WASM-ийн санах ойд багтах. */
|
|
4
|
+
declare const MAX_WORD_BYTES: number;
|
|
5
|
+
type ConvertErrorCode =
|
|
6
|
+
/** `window`/`Worker`/`WebAssembly` алга (Node, хуучин хөтөч). */
|
|
7
|
+
"UNSUPPORTED_ENVIRONMENT"
|
|
8
|
+
/** Хуудас crossOriginIsolated биш — COOP/COEP толгой алга (эсвэл soft navigation-аар орсон). */
|
|
9
|
+
| "NOT_ISOLATED"
|
|
10
|
+
/** .docx / .doc биш (өргөтгөл эсвэл эхний байт). */
|
|
11
|
+
| "UNSUPPORTED_FILE"
|
|
12
|
+
/** Оролт `MAX_WORD_BYTES`-аас их эсвэл хоосон. */
|
|
13
|
+
| "INPUT_TOO_LARGE"
|
|
14
|
+
/** `assetsBase`-ийн manifest/asset татагдсангүй, хэмжээ таарсангүй, peer багц алга. */
|
|
15
|
+
| "ASSETS_UNAVAILABLE"
|
|
16
|
+
/** LibreOffice баримтыг нээж/хөрвүүлж чадсангүй (эвдэрсэн, нууц үгтэй, …). */
|
|
17
|
+
| "CONVERT_FAILED";
|
|
18
|
+
/** /convert-ийн алдаа. Цуцлалт (`signal`) нь `DOMException` `AbortError` — энэ биш. */
|
|
19
|
+
declare class ConvertError extends Error {
|
|
20
|
+
readonly code: ConvertErrorCode;
|
|
21
|
+
constructor(code: ConvertErrorCode, message: string, options?: {
|
|
22
|
+
cause?: unknown;
|
|
23
|
+
});
|
|
24
|
+
/** Сүлжээ/asset-ийн түр алдаа — дахин оролдох утгатай. */
|
|
25
|
+
get retryable(): boolean;
|
|
26
|
+
}
|
|
27
|
+
type ConvertWarning =
|
|
28
|
+
/** Баримтад заасан фонт хувиргагчид байхгүй, хэмжээ-нийцтэй орлуулагч ч алга — мөр/хуудас шилжиж болно. */
|
|
29
|
+
{
|
|
30
|
+
code: "FONT_SUBSTITUTED";
|
|
31
|
+
fonts: string[];
|
|
32
|
+
message: string;
|
|
33
|
+
}
|
|
34
|
+
/** Зарим тэмдэгтийг (ихэвчлэн кирилл) өөр фонтоор зурсан — үсгийн хэлбэр өөр харагдана. */
|
|
35
|
+
| {
|
|
36
|
+
code: "FONT_FALLBACK";
|
|
37
|
+
fonts: string[];
|
|
38
|
+
message: string;
|
|
39
|
+
}
|
|
40
|
+
/** PDF гарын үсгийн хязгаарт (`/pades` `prepare`) ойрхон — баталгаажуулах хуудас нэмэгдэхэд хэтэрч болно. */
|
|
41
|
+
| {
|
|
42
|
+
code: "PDF_NEAR_LIMIT";
|
|
43
|
+
bytes: number;
|
|
44
|
+
limit: number;
|
|
45
|
+
message: string;
|
|
46
|
+
}
|
|
47
|
+
/** PDF гарын үсгийн хязгаараас их — `prepare` `PDF_TOO_LARGE`-аар татгалзана. */
|
|
48
|
+
| {
|
|
49
|
+
code: "PDF_TOO_LARGE";
|
|
50
|
+
bytes: number;
|
|
51
|
+
limit: number;
|
|
52
|
+
message: string;
|
|
53
|
+
};
|
|
54
|
+
interface WordToPdfProgress {
|
|
55
|
+
/** download — asset-ууд (зөвхөн эхний удаа, Cache Storage-д үлдэнэ); init — LibreOffice асах; convert — хувиргалт. */
|
|
56
|
+
phase: "download" | "init" | "convert";
|
|
57
|
+
/** 0–100, тухайн үе шатын дотор. */
|
|
58
|
+
percent: number;
|
|
59
|
+
/** download: татсан байт (задарсан) — `total`-тай хамт. */
|
|
60
|
+
loaded?: number;
|
|
61
|
+
total?: number;
|
|
62
|
+
}
|
|
63
|
+
interface WordToPdfOptions {
|
|
64
|
+
/** `eid-mongolia-convert-assets`-ийн гаралтын хавтасны URL (`manifest.json`-той), ж: "/eid-convert/". */
|
|
65
|
+
assetsBase: string;
|
|
66
|
+
onProgress?: (p: WordToPdfProgress) => void;
|
|
67
|
+
/** Цуцлах: татах явц зогсож, worker устана (дараагийн дуудлага шинээр асна — татсан нь кэшэд). */
|
|
68
|
+
signal?: AbortSignal;
|
|
69
|
+
/** Оролт `Uint8Array` бол өргөтгөл таних нэр (".docx" / ".doc"). `File` бол түүний нэр. */
|
|
70
|
+
fileName?: string;
|
|
71
|
+
}
|
|
72
|
+
interface WordToPdfResult {
|
|
73
|
+
pdf: Uint8Array;
|
|
74
|
+
pages: number;
|
|
75
|
+
warnings: ConvertWarning[];
|
|
76
|
+
}
|
|
77
|
+
interface ConverterStatus {
|
|
78
|
+
/** Бүх asset кэшэд бий — татах шаардлагагүй. */
|
|
79
|
+
cached: boolean;
|
|
80
|
+
/** Татах хэмжээ (байт): manifest-ийн gzip хэмжээ (сервер шахдаг бол), эс бөгөөс задарсан. Кэштэй бол 0. */
|
|
81
|
+
downloadBytes: number;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Хувиргагчийн asset кэшэд байгаа эсэх, татах хэмжээ — иргэнд (мобайл дата) татахаас ӨМНӨ хэлэхэд.
|
|
85
|
+
* Сүлжээгээр зөвхөн жижиг manifest.json-ийг асууна.
|
|
86
|
+
*/
|
|
87
|
+
declare function converterStatus(opts: {
|
|
88
|
+
assetsBase: string;
|
|
89
|
+
signal?: AbortSignal;
|
|
90
|
+
}): Promise<ConverterStatus>;
|
|
91
|
+
/** Хувиргагчийн worker-ийг зогсоож санах ойг чөлөөлнө (кэшийн asset-ууд үлдэнэ). Дараагийн `wordToPdf` дахин асаана. */
|
|
92
|
+
declare function disposeConverter(): void;
|
|
93
|
+
/** .docx / .doc эсэх — нэр (өргөтгөл) эсвэл `File`/`Blob`-ийн нэр, MIME-ээр. Агуулгыг `wordToPdf` эхний байтаар дахин шалгана. */
|
|
94
|
+
declare function isWordFile(file: Blob | File | string): boolean;
|
|
95
|
+
/** PDF-д шигтгэсэн фонтын нэрс (subset угтваргүй). LibreOffice object stream хэрэглэдэггүй тул /BaseFont шууд харагдана. */
|
|
96
|
+
declare function embeddedFonts(pdf: Uint8Array): string[];
|
|
97
|
+
/** Хүссэн фонт ↔ шигтгэсэн фонтоор анхааруулга (docx-ийн heuristic: баримтын run/docDefaults/хэрэглэсэн style-ийн фонт). */
|
|
98
|
+
declare function fontWarnings(requested: string[], embedded: string[]): ConvertWarning[];
|
|
99
|
+
/** docx-д заасан (хэрэглэгдэж буй) фонтууд. */
|
|
100
|
+
declare function docxFonts(docx: Uint8Array): string[];
|
|
101
|
+
/**
|
|
102
|
+
* Word (.docx / .doc) баримтыг ХӨТӨЧ ДОТОР PDF болгоно. Файл хаашаа ч илгээгдэхгүй.
|
|
103
|
+
*
|
|
104
|
+
* Эхний удаа ~250 MB (gzip ~77 MB) asset-ийг `assetsBase`-ээс татаж Cache Storage-д хадгална (`converterStatus`-аар
|
|
105
|
+
* урьдчилж мэд); дараагийн дуудлагууд нэг worker-ийг дахин ашиглана. Үр дүнг иргэнд ХАРУУЛЖ, зөвшөөрүүлсний дараа л
|
|
106
|
+
* `/pades` `prepare`-д өг — хувиргалтад загвар (фонт, мөр, хуудас) өөрчлөгдөж болно (`warnings`).
|
|
107
|
+
*
|
|
108
|
+
* @throws {ConvertError} UNSUPPORTED_ENVIRONMENT / NOT_ISOLATED / UNSUPPORTED_FILE / INPUT_TOO_LARGE / ASSETS_UNAVAILABLE / CONVERT_FAILED
|
|
109
|
+
* @throws {DOMException} `AbortError` — `signal` цуцлагдвал.
|
|
110
|
+
*/
|
|
111
|
+
declare function wordToPdf(file: Blob | Uint8Array, opts: WordToPdfOptions): Promise<WordToPdfResult>;
|
|
112
|
+
|
|
113
|
+
export { CONVERTER_PACKAGE, ConvertError, type ConvertErrorCode, type ConvertWarning, type ConverterStatus, MAX_WORD_BYTES, type WordToPdfOptions, type WordToPdfProgress, type WordToPdfResult, converterStatus, disposeConverter, docxFonts, embeddedFonts, fontWarnings, isWordFile, wordToPdf };
|