@gerege-systems/eid-mongolia-sdk 0.16.0 → 0.18.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 +111 -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/index.cjs +133 -1
- package/dist/index.d.cts +122 -2
- package/dist/index.d.ts +122 -2
- package/dist/index.js +129 -1
- 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 бүртгүүлэх
|
|
@@ -434,6 +434,10 @@ Session-ий `onBehalfOf` блок (`role`/`roleLabel`/`rightType`/`rightTypeLab
|
|
|
434
434
|
`eid.person.certificates(etsi)` · `devices` · `activity(etsi, { flow, limit, offset })` · `summary` · `children` — иргэн
|
|
435
435
|
сүүлийн 24 цагт танай RP-ээр нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Хариу бүрт `raw`.
|
|
436
436
|
|
|
437
|
+
Гэрчилгээ бүрт (0.18.0-аас) `issuedAt` (олгосон), `revokedAt?` (цуцалсан — REVOKED), `revocationReason?` (RFC 5280
|
|
438
|
+
нэр: `keyCompromise`, `superseded`, `cessationOfOperation` …). `status` өөрчлөгдөхгүй: сунгалт/дахин бүртгэлээр
|
|
439
|
+
солигдсон мөр `SUSPENDED` + `revocationReason: "superseded"`, `revokedAt`-гүй.
|
|
440
|
+
|
|
437
441
|
## 3c. USB токен
|
|
438
442
|
|
|
439
443
|
```ts
|
|
@@ -577,6 +581,110 @@ Go backend-д `complete` хийж болно).
|
|
|
577
581
|
0.15.0-д `eid.pdf` (`prepare`, `document`, `documentVerified`, `tokenPrepare`, `tokenFinalize`, `tokenDocument`) ба
|
|
578
582
|
`pdfTimeoutMs` / `pdfMaxBytes` устсан — PDF upload endpoint-ууд CA-д байхгүй (2026-10-14-нд устсан, 404).
|
|
579
583
|
|
|
584
|
+
## 3e. Word → PDF хөтөч дотор — `@gerege-systems/eid-mongolia-sdk/convert`
|
|
585
|
+
|
|
586
|
+
Иргэн Word (.docx / .doc) баримт сонговол хөтөч өөрөө PDF болгоно — **файл сервер рүү ОЧИХГҮЙ** (§3d-тэй ижил зарчим).
|
|
587
|
+
Хувиргагч нь LibreOffice 24.8-ийн WebAssembly build (`@matbee/libreoffice-converter@2.7.2`, MPL-2.0), Web Worker-т.
|
|
588
|
+
Гарын үсэг **Word файлд биш, хувиргасан PDF-д** зурагдана — иргэнд тэр PDF-ийг (яг тэр байтуудыг) зурахаас ӨМНӨ заавал
|
|
589
|
+
харуулж, «шалгасан» гэж зөвшөөрүүл; хувиргалтад фонт, мөр, хуудас шилжиж болно (`warnings`).
|
|
590
|
+
|
|
591
|
+
```bash
|
|
592
|
+
npm install @gerege-systems/eid-mongolia-sdk @matbee/libreoffice-converter@2.7.2 # optional peer — зөвхөн /convert-д
|
|
593
|
+
npx eid-mongolia-convert-assets public/eid-convert # build үед; git-д commit хийхгүй (~250 MB)
|
|
594
|
+
```
|
|
595
|
+
|
|
596
|
+
```ts
|
|
597
|
+
import { wordToPdf, converterStatus, isWordFile, ConvertError } from "@gerege-systems/eid-mongolia-sdk/convert";
|
|
598
|
+
|
|
599
|
+
if (isWordFile(file)) {
|
|
600
|
+
const s = await converterStatus({ assetsBase: "/eid-convert/" }); // { cached, downloadBytes } — мобайл датанд анхааруул
|
|
601
|
+
const { pdf, pages, warnings } = await wordToPdf(file, {
|
|
602
|
+
assetsBase: "/eid-convert/",
|
|
603
|
+
signal: controller.signal, // цуцлах → DOMException AbortError
|
|
604
|
+
onProgress: ({ phase, percent, loaded, total }) => show(phase, percent), // download (зөвхөн эхний удаа) → init → convert
|
|
605
|
+
});
|
|
606
|
+
preview(pdf); // иргэн шалгаад зөвшөөрнө
|
|
607
|
+
const p = await prepare(pdf, { signerCert, verifyPage: true, fileName: "Гэрээ.pdf" }); // §3d
|
|
608
|
+
}
|
|
609
|
+
```
|
|
610
|
+
|
|
611
|
+
| Функц | Тайлбар |
|
|
612
|
+
|---|---|
|
|
613
|
+
| `wordToPdf(file, { assetsBase, onProgress?, signal?, fileName? })` | `{ pdf, pages, warnings }`. Нэг worker-ийг дахин ашиглана, дуудлагууд дараалалд |
|
|
614
|
+
| `converterStatus({ assetsBase })` | `{ cached, downloadBytes }` — татахаас өмнө хэмжээг хэлэх (gzip хэмжээ, кэштэй бол 0) |
|
|
615
|
+
| `isWordFile(file \| name)` | .docx / .doc эсэх (нэр, MIME). Агуулгыг `wordToPdf` эхний байтаар шалгана |
|
|
616
|
+
| `disposeConverter()` | worker-ийг зогсоож санах ойг чөлөөлнө (кэш үлдэнэ) |
|
|
617
|
+
|
|
618
|
+
**Хост дээр (заавал).**
|
|
619
|
+
- Хувиргах хуудас **crossOriginIsolated**: `Cross-Origin-Opener-Policy: same-origin` + `Cross-Origin-Embedder-Policy:
|
|
620
|
+
require-corp` (SharedArrayBuffer). Зөвхөн тэр route-д тавьж болно — тэгвэл тэр хуудас руу **hard navigation**
|
|
621
|
+
(`<a href>`, client-side router биш). Үгүй бол `wordToPdf` шууд `NOT_ISOLATED` (хүлээхгүй). COEP-ийн дор гадны
|
|
622
|
+
CORP/CORS-гүй зураг, iframe ачаалагдахгүй.
|
|
623
|
+
- Asset-ууд **өөрийн хост** дээр (`assetsBase`): `manifest.json` — `Cache-Control: no-cache`; `<хувилбар>/*` — урт кэш
|
|
624
|
+
(`public, max-age=31536000, immutable`), `.wasm` → `application/wasm`, gzip/brotli шахалттай (≈250 MB → gzip 77 MB).
|
|
625
|
+
Эхний удаа татсаныг SDK Cache Storage-д хадгална (дахин татахгүй); хувилбар солигдвол хуучныг устгана.
|
|
626
|
+
- Worker-ийн скриптүүдэд (`<assetsBase><хувилбар>/*.js`) **тусдаа CSP**: `default-src 'self'; script-src 'self'
|
|
627
|
+
'wasm-unsafe-eval' 'unsafe-eval'` (Emscripten-д `eval` хэрэгтэй — зөвхөн worker-т). Хуудасны хатуу CSP (nonce +
|
|
628
|
+
`'strict-dynamic'`) хэвээр байна; хуудсанд `connect-src 'self'` хангалттай.
|
|
629
|
+
- MPL-2.0: `<хувилбар>/NOTICE.txt` (эх код, лицензийн холбоос) asset-уудтай хамт үйлчилгээнд байна — хэрэглэгчийн
|
|
630
|
+
нүүрэнд (тусламж/лиценз хэсэгт) LibreOffice-ийг дурд.
|
|
631
|
+
|
|
632
|
+
`ConvertError.code`: `UNSUPPORTED_ENVIRONMENT`, `NOT_ISOLATED`, `UNSUPPORTED_FILE`, `INPUT_TOO_LARGE` (> 50 MB),
|
|
633
|
+
`ASSETS_UNAVAILABLE` (`retryable`), `CONVERT_FAILED` (эвдэрсэн / нууц үгтэй баримт). `warnings[].code`:
|
|
634
|
+
`FONT_SUBSTITUTED` (`fonts` — хувиргагчид байхгүй, хэмжээ-нийцтэй орлуулагчгүй фонт; Times New Roman / Arial /
|
|
635
|
+
Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуулагч анхааруулахгүй), `FONT_FALLBACK` (`fonts` —
|
|
636
|
+
зарим тэмдэгтийг өөр фонтоор, жишээ нь Caladea-д кирилл байхгүй тул Noto), `PDF_NEAR_LIMIT` / `PDF_TOO_LARGE` (`bytes`,
|
|
637
|
+
`limit` — §3d `prepare`-ийн 10 223 616 байт). Фонтын анхааруулга .docx-д л (heuristic); .doc-д үгүй.
|
|
638
|
+
|
|
639
|
+
Шалгасан: Chromium ба WebKit (Playwright, `npm run test:convert-e2e`) — .docx ба .doc → PDF → `prepare`, кэштэй дахин
|
|
640
|
+
ажиллуулахад татахгүй, цуцлалт, COEP-гүй хуудас. Мобайл хөтөчид 250 MB WASM санах ой их шаардана — сул утсанд унаж
|
|
641
|
+
болзошгүй.
|
|
642
|
+
|
|
643
|
+
## 3f. Гарын үсэгтэй файлыг имэйлээр — `eid.share()` (`SIGN` эрх)
|
|
644
|
+
|
|
645
|
+
Гарын үсэг зурсан PDF-ээ дараагийн гарын үсэг зурагч / хүлээн авагч руу хавсралтаар илгээнэ (`POST /share`). CA файлыг
|
|
646
|
+
**хадгалахгүй**: eID-ийн хүчинтэй гарын үсэгтэй эсэхийг шалгаад илгээж, хаяна. Хүлээн авагч бүрт тусдаа имэйл.
|
|
647
|
+
|
|
648
|
+
> CA-ийн туг одоогоор **унтраалттай** (`share.enabled=false` → 503 `SHARE_DISABLED`). Дуудахын өмнө
|
|
649
|
+
> `await eid.shareInfo()`-ийн `enabled`-ийг шалга.
|
|
650
|
+
|
|
651
|
+
```ts
|
|
652
|
+
import { ShareError } from "@gerege-systems/eid-mongolia-sdk";
|
|
653
|
+
|
|
654
|
+
const info = await eid.shareInfo(); // { enabled, maxFileBytes, maxRecipients, quota: { perRPHour, perRPDay, perRecipientDay }, … }
|
|
655
|
+
if (info.enabled) {
|
|
656
|
+
try {
|
|
657
|
+
const r = await eid.share({
|
|
658
|
+
file: signedPdf, // Uint8Array | ArrayBuffer | Blob/File; ≤ 3 080 192 байт
|
|
659
|
+
filename: "гэрээ.pdf", // .pdf өргөтгөлтэй; анхдагч File-ийн нэр эсвэл document.pdf
|
|
660
|
+
to: ["next@example.mn"], // 1–5, давхардалгүй
|
|
661
|
+
subject: "Гэрээ — гарын үсэг", // ≤ 150; CA «‹RP нэр›: …» угтвар тавина
|
|
662
|
+
message: "Хоёр дахь гарын үсгийг зурна уу", // ≤ 1000
|
|
663
|
+
lang: "mn", // mn | en
|
|
664
|
+
});
|
|
665
|
+
console.log(r.sent, r.sha256, r.signatures, r.docID); // docID — CA-д бүртгэлтэй бол (имэйлд verify холбоос)
|
|
666
|
+
} catch (e) {
|
|
667
|
+
if (e instanceof ShareError) {
|
|
668
|
+
// e.code: ShareErrorCode; 422 → e.reason; 502 → e.sent / e.failed / e.recipients ("sent" | "failed", to-гийн дарааллаар)
|
|
669
|
+
}
|
|
670
|
+
throw e;
|
|
671
|
+
}
|
|
672
|
+
}
|
|
673
|
+
```
|
|
674
|
+
|
|
675
|
+
| HTTP | `ShareError.code` | Тайлбар |
|
|
676
|
+
|---|---|---|
|
|
677
|
+
| 400 | `REQUEST_INVALID`, `FILE_EMPTY`, `RECIPIENT_REQUIRED`, `TOO_MANY_RECIPIENTS`, `RECIPIENT_INVALID`, `RECIPIENT_DUPLICATE` | талбарын алдаа |
|
|
678
|
+
| 413 | `FILE_TOO_LARGE` | файл / имэйл хязгаараас их |
|
|
679
|
+
| 415 | `FILE_TYPE_NOT_SUPPORTED` | PDF биш (өргөтгөл, Content-Type, `%PDF-` гурвуулаа таарна) |
|
|
680
|
+
| 422 | `FILE_NOT_SIGNED` | `.reason`: `no_signature` \| `invalid` \| `untrusted` |
|
|
681
|
+
| 429 | `RATE_LIMITED` | квот; `.retryAfterMs`, `.retryable` |
|
|
682
|
+
| 502 | `MAIL_FAILED` | `.sent`, `.failed`, `.recipients` — зөвхөн `failed`-ийг дахин илгээ |
|
|
683
|
+
| 503 | `SHARE_DISABLED`, `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` | туг / тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
|
|
684
|
+
|
|
685
|
+
401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт 30 / өдөрт 200 хүсэлт,
|
|
686
|
+
хүлээн авагч тутам өдөрт 10 имэйл (бодит утгыг `shareInfo().quota`-аас). Хугацаа анхдагч 150 с (`timeoutMs`).
|
|
687
|
+
|
|
580
688
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
581
689
|
|
|
582
690
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
|
@@ -707,6 +815,7 @@ OK ирж болзошгүй. Иймд `ResponseValidator`:
|
|
|
707
815
|
| `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start); `ApiError`-ийн дэд анги |
|
|
708
816
|
| `CertChoiceInvalidError` | 409 `CERT_CHOICE_INVALID` — linked sign-ийн certificate-choice хүчингүй; `ApiError`-ийн дэд анги |
|
|
709
817
|
| `RequestInvalidError` | 400 `REQUEST_INVALID` — хүсэлт буруу (ж: `linkedSessionID` дутуу); `ApiError`-ийн дэд анги |
|
|
818
|
+
| `ShareError` | `share()`-ийн 4xx/5xx (401/403-аас бусад) — `.code` (`ShareErrorCode`), `.reason` (422), `.sent`/`.failed`/`.recipients` (502); `ApiError`-ийн дэд анги |
|
|
710
819
|
| `ApiError` | бусад HTTP алдаа (`.status`, `.body`, серверийн `.code`, `.retryAfterMs`, `.headers`, `.retryable` — ж: 404 `ORG_NOT_FOUND`) |
|
|
711
820
|
| `ResponseTooLargeError` | хариу SDK-ийн хязгаараас их (JSON 4 MiB) — `.op`, `.limit` |
|
|
712
821
|
| `NetworkError` | timeout/сүлжээ (`.op` — таних тэмдэггүй зам, `.timeout`) |
|
|
@@ -731,6 +840,7 @@ npm run lint # tsc --noEmit
|
|
|
731
840
|
npm test # build + node --test (pades golden — Go reference-тэй байт-ижил)
|
|
732
841
|
npm run golden:check # test/fixtures/pades/golden + src/pades/assets ↔ бэхэлсэн Go commit
|
|
733
842
|
npm run size:pades # /pades хөтчийн bundle gzip ≤ 300 KB
|
|
843
|
+
npm run test:convert-e2e # /convert жинхэнэ LibreOffice Chromium-д (BROWSER=webkit — WebKit)
|
|
734
844
|
```
|
|
735
845
|
|
|
736
846
|
`/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 };
|