@gerege-systems/eid-mongolia-sdk 0.25.0 → 0.27.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 +43 -31
- package/dist/{browser-BYY0cP2D.d.ts → browser-Cgtf5eHN.d.cts} +4 -4
- package/dist/{browser-Df4wTfZx.d.cts → browser-DgiXeZf-.d.ts} +4 -4
- package/dist/browser.d.cts +2 -2
- package/dist/browser.d.ts +2 -2
- package/dist/{chunk-CRXEUCMP.js → chunk-YRL4CWWI.js} +31 -6
- package/dist/{errors-BM8D3VEw.d.ts → errors-CxAr-WIA.d.cts} +6 -5
- package/dist/{errors-BM8D3VEw.d.cts → errors-CxAr-WIA.d.ts} +6 -5
- package/dist/index.cjs +97 -14
- package/dist/index.d.cts +66 -16
- package/dist/index.d.ts +66 -16
- package/dist/index.js +90 -14
- package/dist/pades.cjs +36 -10
- package/dist/pades.d.cts +12 -3
- package/dist/pades.d.ts +12 -3
- package/dist/pades.js +8 -7
- package/dist/validate.d.cts +1 -1
- package/dist/validate.d.ts +1 -1
- package/dist/validate.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -35,7 +35,7 @@ Smart-ID-тэй RP-үүдийн хэв маяг: хөтөчид **нэг тов
|
|
|
35
35
|
|
|
36
36
|
| Хаана | Юу болно |
|
|
37
37
|
|---|---|
|
|
38
|
-
| Desktop хөтөч | Цонх: QR (секунд тутам шинэчлэгдэнэ) + баталгаажуулах код + «Хүсэлтийн хугацаа m:ss» (сүүлийн 30с анхааруулах өнгө) + «Регистрийн дугаараар нэвтрэх» товч (ижил цонхонд доош дэлгэгдэх push хэсэг), шууд төлөв |
|
|
38
|
+
| Desktop хөтөч | Цонх: QR (~1–2 секунд тутам шинэчлэгдэнэ — status long-poll ≤ 1 с + 1 с) + баталгаажуулах код + «Хүсэлтийн хугацаа m:ss» (сүүлийн 30с анхааруулах өнгө) + «Регистрийн дугаараар нэвтрэх» товч (ижил цонхонд доош дэлгэгдэх push хэсэг), шууд төлөв |
|
|
39
39
|
| Утасны хөтөч | Товч → `start?mode=web2app` → сервер 302 → eID апп (Web2App). Апп баталгаажуулаад `/auth/eid/callback` руу буцаана |
|
|
40
40
|
| Backend | session эхлүүлэх, QR угсрах (`sessionSecret` серверт), poll, `validateAuth` (гинж + ACSP_V2 + `flowType` + Web2App-д `userChallengeVerifier`) → таны `onSuccess` |
|
|
41
41
|
|
|
@@ -227,8 +227,8 @@ eid-login-button::part(icon) { width: 24px; height: 24px; }
|
|
|
227
227
|
**eID аппын доод хувилбар.** `flowType` бэхлэлт (device link v3) ба Web2App-ийн `userChallengeVerifier` нь
|
|
228
228
|
**iOS 2.2.3 (build 59)**, **Android 2.2.3 (versionCode 60)**-аас эхэлсэн. eID сервер 2026-10-07-оос legacy холбоосыг
|
|
229
229
|
бүрэн хассан (v3-гүй session-д утас `DEVICE_LINK_REQUIRED`) бөгөөд доод хувилбарыг `/mobile/app-config`-оор албадан
|
|
230
|
-
шинэчлүүлдэг: Android 2026-10-07-оос ≥ 70 (төхөөрөмжийн баталгаатай), 2026-10-
|
|
231
|
-
Android ≥
|
|
230
|
+
шинэчлүүлдэг: Android 2026-10-07-оос ≥ 70 (төхөөрөмжийн баталгаатай), 2026-10-20-ны байдлаар iOS ≥ 2.2.8,
|
|
231
|
+
Android ≥ 91 (`curl https://ca.eidmongolia.mn/mobile/app-config`). Иймд гарын үсэг зурж чадах бүх апп эдгээрийг дэмжинэ —
|
|
232
232
|
RP талд нэмэлт шалгалт хэрэггүй. Эх сурвалж: eID CA-ийн `docs/DEVICE_LINK_V3.md` §5, §7; changelog
|
|
233
233
|
`2026-10-02-ios-min-version-2-2-3`, `2026-10-07-android-min-70`.
|
|
234
234
|
|
|
@@ -247,8 +247,8 @@ RP талд нэмэлт шалгалт хэрэггүй. Эх сурвалж: e
|
|
|
247
247
|
5 оронтой — eID-тэй ижил хэлбэр), expiresIn}`, ижил cookie; `status` нь eID-ээс асуулгүй `pollMs`-ийн хугацаанд барьж
|
|
248
248
|
`PENDING`, TTL-ийн дараа `EXPIRED` — утсаа аваагүй иргэнтэй ялгаагүй (бодит push-ийн CA `TIMEOUT` ч `EXPIRED` болно). Push start-ийн хариу бүр (бодит, decoy, 502)
|
|
249
249
|
`pushFloorMs`-оос (анхдагч 1000) хурдан гарахгүй — decoy-г цагаар ялгахгүйн тулд (`handle(Request)`-д хүсэлт тасарвал
|
|
250
|
-
хүлээхгүй; `handleRequest`-д `signal` өг). Хязгаар (`push:<idCode>`, `start:<ip>`) decoy-д ч үйлчилнэ; 429 ба 400
|
|
251
|
-
(`invalid_id` — хэлбэрийн алдаа, бүртгэлээс хамааралгүй) нь floor
|
|
250
|
+
хүлээхгүй; `handleRequest`-д `signal` өг). Хязгаар (`push:<idCode>`, `start:<ip>`) decoy-д ч үйлчилнэ; хязгаарлагчийн 429 ба 400
|
|
251
|
+
(`invalid_id` — хэлбэрийн алдаа, бүртгэлээс хамааралгүй) нь floor-гүй (eID-ийн 429 ба 503 `busy` floor-той). eID-ийн 5xx, холболтын алдаа, JSON бус 4xx (eID-ийн
|
|
252
252
|
өмнөх proxy, ж: mTLS татгалзал), 401/403 (RP-ийн нууц/эрх) ба 429 нь **decoy биш** — `502 eid_unavailable` / `429` (eID
|
|
253
253
|
порталын зан: тасалдлыг decoy-оор нуувал иргэн дуусахгүй spinner харна; эдгээр нь дугаараас хамаардаггүй тул oracle
|
|
254
254
|
биш). Унтраах: `decoy: false`, `pushFloorMs: 0` — **⚠️** тэгвэл `/start` нь «энэ регистр eID-д бүртгэлтэй эсэх»-ийг
|
|
@@ -279,7 +279,7 @@ RP талд нэмэлт шалгалт хэрэггүй. Эх сурвалж: e
|
|
|
279
279
|
**Redis store** (SDK нэмэлт хамааралгүй — жишээ нь `ioredis`):
|
|
280
280
|
|
|
281
281
|
```ts
|
|
282
|
-
import Redis from "ioredis";
|
|
282
|
+
import { Redis } from "ioredis";
|
|
283
283
|
import type { EidLoginStore, EidLoginTx } from "@gerege-systems/eid-mongolia-sdk";
|
|
284
284
|
|
|
285
285
|
const redis = new Redis(process.env.REDIS_URL!);
|
|
@@ -304,13 +304,13 @@ Tx-д `sessionSecret` (QR угсрах материал) байдаг — Redis-
|
|
|
304
304
|
## 2. Нэвтрэлт (push)
|
|
305
305
|
|
|
306
306
|
```ts
|
|
307
|
-
import { EidClient } from "@gerege-systems/eid-mongolia-sdk";
|
|
307
|
+
import { EidClient, NATIONAL_ROOT_CA_PEM } from "@gerege-systems/eid-mongolia-sdk";
|
|
308
308
|
|
|
309
309
|
const eid = new EidClient({
|
|
310
310
|
// baseUrl анхдагч https://rp.eidmongolia.mn (RP-API, /v3-гүй) — mTLS-тэй RP ч мөн энэ хост
|
|
311
311
|
credentials: {
|
|
312
312
|
rpUUID: process.env.EID_RP_UUID!,
|
|
313
|
-
rpName: "Интернэт банк", // дэд системийн нэр, ≤120
|
|
313
|
+
rpName: "Интернэт банк", // дэд системийн нэр, ≤ 120 байт UTF-8 (кирилл ≈ 60 үсэг; CA илүүг таслана)
|
|
314
314
|
apiSecret: process.env.EID_SECRET!, // rp_sk_…
|
|
315
315
|
},
|
|
316
316
|
trust: { trustAnchorsPem: [NATIONAL_ROOT_CA_PEM] }, // ← Mongolian National Root CA, production-д ЗААВАЛ (завсрын 02–04 SDK-д суусан)
|
|
@@ -323,11 +323,13 @@ const s = await eid.auth.notificationByEtsi("PNOMN-12345678", [
|
|
|
323
323
|
|
|
324
324
|
showToUser(s.vc); // ← иргэний утсан дээр харагдах баталгаажуулах код (VC)
|
|
325
325
|
|
|
326
|
-
|
|
327
|
-
|
|
326
|
+
// long-poll; session-ий хугацаа дуустал хүлээнэ: expiresAt + 15 с (алга бол discovery sessionTtl, эс бөгөөс 600 с).
|
|
327
|
+
// CA хугацаа дууссан session-ийг COMPLETE/TIMEOUT болгоно. { maxWaitMs } өгвөл түүгээр таслана (RUNNING буцна).
|
|
328
|
+
const result = await eid.session.waitForResult(s.sessionId, { expiresAt: s.expiresAt });
|
|
329
|
+
const who = eid.validator.validateAuth(result, s.acsp!); // ← гинж + ACSP_V2 крипто-баталгаажуулна (RUNNING бол ValidationError)
|
|
328
330
|
|
|
329
331
|
console.log(who.documentNumber, who.subject); // баталгаажсан иргэн
|
|
330
|
-
const { name, serialNumber } = who.parsedSubject; //
|
|
332
|
+
const { name, serialNumber } = who.parsedSubject; // латин «givenName surname», "PNOMN-12345678" (givenName/surname/commonName/country…)
|
|
331
333
|
```
|
|
332
334
|
|
|
333
335
|
Session-ий `person` блок (CA бүртгэлээс — гэрчилгээнд байдаггүй кирилл нэр, төрсөн огноо, хүйс) гарын үсэгт **ордоггүй** —
|
|
@@ -405,7 +407,8 @@ certificate-choice хүчингүй / хуучирсан / ашиглагдса
|
|
|
405
407
|
```ts
|
|
406
408
|
const cc = await eid.sign.certificateChoiceByEtsi("PNOMN-12345678"); // эсвэл certificateChoiceDeviceLink() (зөвхөн QR)
|
|
407
409
|
const signer = eid.validator.validateCertificateChoice(await eid.session.waitForResult(cc.sessionId), cc.sessionId);
|
|
408
|
-
const dtbs =
|
|
410
|
+
const dtbs = myCmsBuilder.dtbs(signer.certificate); // таных: SHA-256(signedAttrs), 32 байт, стандарт base64 (PDF бол /pades prepare)
|
|
411
|
+
const ix = [{ type: "displayTextAndPIN" as const, displayText60: "Гэрээнд гарын үсэг зурах" }];
|
|
409
412
|
const s = await eid.sign.digestForSigner(signer, dtbs, ix, { fileName: "Гэрээ.pdf" }); // linked/{documentNumber}
|
|
410
413
|
// QR / Web2App: eid.sign.deviceLinkForSigner(signer, dtbs, ix, { callbackUrl })
|
|
411
414
|
const r = await eid.session.waitForResult(s.sessionId);
|
|
@@ -470,7 +473,7 @@ Session-ий `onBehalfOf` блок (`role`/`roleLabel`/`rightType`/`rightTypeLab
|
|
|
470
473
|
|
|
471
474
|
Гэрчилгээ бүрт (0.18.0-аас) `issuedAt` (олгосон), `revokedAt?` (цуцалсан — REVOKED), `revocationReason?` (RFC 5280
|
|
472
475
|
нэр: `keyCompromise`, `superseded`, `cessationOfOperation` …). `status` өөрчлөгдөхгүй: сунгалт/дахин бүртгэлээр
|
|
473
|
-
солигдсон мөр `SUSPENDED` + `revocationReason: "superseded"
|
|
476
|
+
солигдсон мөр `SUSPENDED` + `revocationReason: "superseded"` + `revokedAt` (солигдсон мөч, CA 2026-10-16-аас).
|
|
474
477
|
|
|
475
478
|
`keyMedium: "TOKEN"` мөрөнд `organization?` (байгууллагын токен) ба `tokenSerial?` — гэрчилгээ олгогдсон USB токены
|
|
476
479
|
серийн дугаар. Нэг токены AUTH + SIGN-ийг байгууллага/огноогоор таамаглахгүй, `tokenSerial`-аар бүлэглэ (сунгалтаар
|
|
@@ -478,7 +481,8 @@ Session-ий `onBehalfOf` блок (`role`/`roleLabel`/`rightType`/`rightTypeLab
|
|
|
478
481
|
|
|
479
482
|
```ts
|
|
480
483
|
const { certificates } = await eid.person.certificates(etsi);
|
|
481
|
-
const byToken = Map
|
|
484
|
+
const byToken = new Map<string, typeof certificates>(); // Map.groupBy нь Node ≥ 21 — Node 18/20-д ажиллахгүй
|
|
485
|
+
for (const c of certificates) if (c.tokenSerial) byToken.set(c.tokenSerial, [...(byToken.get(c.tokenSerial) ?? []), c]);
|
|
482
486
|
```
|
|
483
487
|
|
|
484
488
|
## 3c. USB токен
|
|
@@ -555,13 +559,13 @@ DSS-д), Adobe / EU DSS-д «LTV enabled», баталгаажуулах (QR) х
|
|
|
555
559
|
| `prepare(pdf, { signerCert, claimedRole?, verifyPage?, fileName?, lang?, docId?, appearance?, … })` | браузер / Node | `{ dtbs, digest, docId, state, placement? }` — сүлжээгүй |
|
|
556
560
|
| `eid.signPdfDigest({ dtbs, fileName, signer, flow?, onBehalfOf? })` | RP backend | DTBS-д гарын үсгийн session (push эсвэл device-link) |
|
|
557
561
|
| `complete(state, signature)` | браузер / Node | TSA + OCSP/CRL → `{ pdf, cms, docId, outSha256, inSha256, hasPage, pageSha256, … }` |
|
|
558
|
-
| `eid.registerSignature(registrationFromCompleted(done, { fileName, sessionID }))` | RP backend | `POST /pdf/signatures` — `/verify/{docID}`
|
|
562
|
+
| `eid.registerSignature(registrationFromCompleted(done, { fileName, sessionID, onBehalfOf? }))` | RP backend | `POST /pdf/signatures` — `/verify/{docID}` бүртгэл. `medium` алга бол `sessionID`-аас (phone ⇔ sessionID); зөрчил эсвэл `claimedRole`-той гарын үсэгт `onBehalfOf` алга бол `ValidationError` |
|
|
559
563
|
|
|
560
|
-
`/pades` хөтчийн bundle ~
|
|
564
|
+
`/pades` хөтчийн bundle ~136 KB gzip (Noto Sans фонт asset-тэй, CI-д ≤ 300 KB); үндсэн entry үүнийг агуулахгүй. `/pades` (ба бүх багц) **Node ≥ 18** (CI: 18 / 20 / 22),
|
|
561
565
|
орчин үеийн хөтөч. Браузерийн CSP: `connect-src https://tsa.timeserver.mn https://ocsp.eidmongolia.mn
|
|
562
566
|
https://crl.eidmongolia.mn`. Хөтөчид гэрчилгээний `http://` AIA/CDP-г зөвхөн эдгээр хостод `https://` болгоно; үндэсний
|
|
563
|
-
CA-ийн CRL (`esign.gov.mn`) нь `crl.eidmongolia.mn` толин хуулбараас (бүх платформд). Шалгагч
|
|
564
|
-
**байхгүй** — бүрэн
|
|
567
|
+
CA-ийн CRL (`esign.gov.mn`) нь `crl.eidmongolia.mn` толин хуулбараас (бүх платформд). Шалгагч `/pades`-д
|
|
568
|
+
**байхгүй** — бүрэн шалгалт `@gerege-systems/eid-mongolia-sdk/validate` (`validatePdf`, §3g) эсвэл Go `pades.ValidatePDF`-д; `prepare` нь өмнөх гарын үсгийг «хөнгөн» шалгуураар (бүтэц,
|
|
565
569
|
CMS гарын үсэг, eID олгогч, timestamp, DSS) л шалгана.
|
|
566
570
|
|
|
567
571
|
**Зурагчийн гэрчилгээ.** `prepare` иргэний SIGN гэрчилгээг (`signingCertificateV2`) шаарддаг тул session-оос ӨМНӨ
|
|
@@ -577,7 +581,8 @@ Session-ийг тэр `documentNumber`-ээр эхлүүлнэ — өөр төх
|
|
|
577
581
|
// ── браузер ─────────────────────────────────────────────────────────────────────────────
|
|
578
582
|
import { prepare, complete } from "@gerege-systems/eid-mongolia-sdk/pades";
|
|
579
583
|
|
|
580
|
-
const {
|
|
584
|
+
const { certB64, documentNumber } = await api("/sign/pdf/signer"); // backend: person.certificates
|
|
585
|
+
const signerCert = Uint8Array.from(atob(certB64), (ch) => ch.charCodeAt(0)); // prepare нь DER Uint8Array авна
|
|
581
586
|
const p = await prepare(pdfBytes, {
|
|
582
587
|
signerCert, verifyPage: true, fileName: "Гэрээ №12.pdf",
|
|
583
588
|
claimedRole, // байгууллагаар бол getRepresentations()-ийн claimedRole ЯГ ХЭВЭЭР
|
|
@@ -590,8 +595,12 @@ const done = await complete(p.state, signature);
|
|
|
590
595
|
const { pdf, signerCert: _c, ...meta } = done; // PDF backend рүү очихгүй
|
|
591
596
|
await api(`/sign/pdf/${s.sessionId}/register`, { ...meta, cms: b64(done.cms) });
|
|
592
597
|
download(done.pdf, "Гэрээ №12.pdf");
|
|
598
|
+
```
|
|
593
599
|
|
|
600
|
+
```ts
|
|
594
601
|
// ── RP backend (Node) ─────────────────────────────────────────────────────────────────────
|
|
602
|
+
import { registrationFromCompleted } from "@gerege-systems/eid-mongolia-sdk";
|
|
603
|
+
|
|
595
604
|
// /sign/pdf/start — sessionSecret (device-link) backend-ээс гарахгүй; s.digest-ийг session-д хадгал.
|
|
596
605
|
const s = await eid.signPdfDigest({
|
|
597
606
|
dtbs: req.body.dtbs, fileName: req.body.fileName,
|
|
@@ -624,7 +633,8 @@ reply({ verifyUrl: reg.verifyUrl });
|
|
|
624
633
|
**Харагдах гарын үсэг (сонголттой).** `appearance: { page?, x, y, width, height, lang? }` өгвөл гарын үсэг хуудсан дээр
|
|
625
634
|
харагдана (QR + нэр, `claimedRole`, «eID Mongolia-аар зурсан», огноо `YYYY-MM-DD HH:MM (+08)`); байхгүй бол үл харагдах
|
|
626
635
|
(өмнөхтэй байт-ижил). Координат pt-ээр, хуудасны CropBox-ийн `/Rotate`-ийн дараах (дэлгэцэнд харагдах) зүүн доод булангаас;
|
|
627
|
-
`page` 1-ээс (
|
|
636
|
+
`page` 1-ээс (байхгүй/0 = оролтын eID verify хуудас БИШ сүүлийн хуудас — энэ prepare-ийн нэмэх ба өмнөх гарын үсгүүдийн
|
|
637
|
+
нэмсэн verify хуудас тооцогдохгүй (0.26.0+); тодорхой дугаар нь verify хуудас байсан ч хэвээр). Өндөр ≥ 45 pt; хуудаснаас гарах, бичвэр
|
|
628
638
|
багтахгүй, docId-гүй (хуудасгүй гарын үсэгтэй баримт) бол `REQUEST_INVALID`. Харагдах бүр ~+90 KB. Дүрэм: Go репогийн
|
|
629
639
|
`pades/APPEARANCE_SPEC.md`.
|
|
630
640
|
|
|
@@ -645,6 +655,7 @@ if (p.placement?.status === "overlap") notice("Гарын үсэг хуудас
|
|
|
645
655
|
### Зөвхөн Node (backend бүгдийг хийнэ)
|
|
646
656
|
|
|
647
657
|
```ts
|
|
658
|
+
import { writeFileSync } from "node:fs";
|
|
648
659
|
import { registrationFromCompleted } from "@gerege-systems/eid-mongolia-sdk";
|
|
649
660
|
import { prepare, complete, PadesError } from "@gerege-systems/eid-mongolia-sdk/pades";
|
|
650
661
|
|
|
@@ -679,12 +690,12 @@ TSA timestamp-аар өөрөө **2 удаа** дахин оролдоно (ни
|
|
|
679
690
|
`PadesError.code` (тогтвортой, бүх платформд ижил): `PDF_INVALID`, `PDF_ENCRYPTED`, `PDF_LOCKED` (DocMDP P=1),
|
|
680
691
|
`PDF_TOO_LARGE`, `PDF_TOO_MANY_SIGNATURES`, `PDF_PRIOR_SIGNATURE_INVALID`, `PDF_FOREIGN_SIGNATURE`, `SIGNER_INVALID`,
|
|
681
692
|
`REQUEST_INVALID`, `SIGNATURE_INVALID` (state хэвээр — дахин зуруулж болно), `TSA_UNAVAILABLE`, `LTV_UNAVAILABLE`
|
|
682
|
-
(`retryable`), `SELF_VALIDATION_FAILED`, `PLACEHOLDER_OVERFLOW`, `STATE_INVALID`, `INTERNAL
|
|
693
|
+
(`retryable`), `SELF_VALIDATION_FAILED`, `PLACEHOLDER_OVERFLOW`, `STATE_INVALID`, `INTERNAL` (зөвхөн TS — Go-д байхгүй).
|
|
683
694
|
`state` нь бэлтгэсэн PDF-ийг агуулна — PDF-тэй ижил нууцлалтай хадгал. Формат нь Go SDK-тай ижил (хөтөчид `prepare`,
|
|
684
695
|
Go backend-д `complete` хийж болно).
|
|
685
696
|
|
|
686
697
|
0.15.0-д `eid.pdf` (`prepare`, `document`, `documentVerified`, `tokenPrepare`, `tokenFinalize`, `tokenDocument`) ба
|
|
687
|
-
`
|
|
698
|
+
`pdfMaxBytes` устсан (`pdfTimeoutMs` 0.19.0-д `registerSignature`-д зориулж буцаж нэмэгдсэн — доор) — PDF upload endpoint-ууд CA-д байхгүй (2026-10-14-нд устсан, 404).
|
|
688
699
|
|
|
689
700
|
**Хугацаа.** `registerSignature` (`POST /pdf/signatures` — CA CMS + TSA + LTV-г шалгадаг) 0.19.0-аас өөрийн
|
|
690
701
|
`pdfTimeoutMs`-тэй, анхдагч **80 с** (`DEFAULT_PDF_TIMEOUT_MS`; Go SDK `Config.PDFTimeout` / `DefaultPDFTimeout`-тэй ижил);
|
|
@@ -704,6 +715,7 @@ npx eid-mongolia-convert-assets public/eid-convert
|
|
|
704
715
|
|
|
705
716
|
```ts
|
|
706
717
|
import { wordToPdf, converterStatus, isWordFile, ConvertError } from "@gerege-systems/eid-mongolia-sdk/convert";
|
|
718
|
+
import { prepare } from "@gerege-systems/eid-mongolia-sdk/pades";
|
|
707
719
|
|
|
708
720
|
if (isWordFile(file)) {
|
|
709
721
|
const s = await converterStatus({ assetsBase: "/eid-convert/" }); // { cached, downloadBytes } — мобайл датанд анхааруул
|
|
@@ -777,7 +789,7 @@ if (isWordFile(file)) {
|
|
|
777
789
|
- MPL-2.0: `<хувилбар>/NOTICE.txt` (эх код, лицензийн холбоос) asset-уудтай хамт үйлчилгээнд байна — хэрэглэгчийн
|
|
778
790
|
нүүрэнд (тусламж/лиценз хэсэгт) LibreOffice-ийг дурд.
|
|
779
791
|
|
|
780
|
-
`ConvertError.code`: `UNSUPPORTED_ENVIRONMENT`, `NOT_ISOLATED`, `UNSUPPORTED_FILE`, `INPUT_TOO_LARGE` (> 50
|
|
792
|
+
`ConvertError.code`: `UNSUPPORTED_ENVIRONMENT`, `NOT_ISOLATED`, `UNSUPPORTED_FILE`, `INPUT_TOO_LARGE` (хоосон эсвэл > 50 MiB),
|
|
781
793
|
`ASSETS_UNAVAILABLE` (`retryable`), `CONVERT_FAILED` (эвдэрсэн / нууц үгтэй баримт). `warnings[].code`:
|
|
782
794
|
`FONT_SUBSTITUTED` (`fonts` — хувиргагчид байхгүй, хэмжээ-нийцтэй орлуулагчгүй фонт; Times New Roman / Arial /
|
|
783
795
|
Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуулагч анхааруулахгүй), `FONT_FALLBACK` (`fonts` —
|
|
@@ -824,13 +836,13 @@ if (info.enabled) {
|
|
|
824
836
|
|---|---|---|
|
|
825
837
|
| 400 | `REQUEST_INVALID`, `FILE_EMPTY`, `RECIPIENT_REQUIRED`, `TOO_MANY_RECIPIENTS`, `RECIPIENT_INVALID`, `RECIPIENT_DUPLICATE` | талбарын алдаа |
|
|
826
838
|
| 413 | `FILE_TOO_LARGE` | файл / имэйл хязгаараас их |
|
|
827
|
-
| 415 | `FILE_TYPE_NOT_SUPPORTED` | PDF биш (өргөтгөл, Content-Type, `%PDF-` гурвуулаа таарна) |
|
|
839
|
+
| 415 | `FILE_TYPE_NOT_SUPPORTED` | PDF биш (өргөтгөл, Content-Type, `%PDF-` гурвуулаа таарна), задрахгүй эсвэл шифрлэгдсэн PDF |
|
|
828
840
|
| 422 | `FILE_NOT_SIGNED` | `.reason`: `no_signature` \| `invalid` \| `untrusted` |
|
|
829
841
|
| 429 | `RATE_LIMITED` | квот; `.retryAfterMs`, `.retryable` |
|
|
830
842
|
| 502 | `MAIL_FAILED` | `.sent`, `.failed`, `.recipients` — зөвхөн `failed`-ийг дахин илгээ |
|
|
831
843
|
| 503 | `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` (`SHARE_DISABLED` — хуучин CA) | тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
|
|
832
844
|
|
|
833
|
-
401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт
|
|
845
|
+
401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт 300 / өдөрт 3000 хүсэлт,
|
|
834
846
|
хүлээн авагч тутам өдөрт 10 имэйл (бодит утгыг `shareInfo().quota`-аас). Хугацаа анхдагч 150 с (`timeoutMs`).
|
|
835
847
|
|
|
836
848
|
## 3g. Гарын үсэгтэй PDF шалгах — `@gerege-systems/eid-mongolia-sdk/validate` (0.20.0)
|
|
@@ -848,7 +860,7 @@ try {
|
|
|
848
860
|
s.signer_name; s.signing_time; s.signature_level; s.certificate_level; s.problems; s.visible; s.key_medium;
|
|
849
861
|
}
|
|
850
862
|
} catch (e) {
|
|
851
|
-
if (e instanceof ValidatePdfError) e.code; // PDF_NO_SIGNATURE | PDF_INVALID | PDF_ENCRYPTED | PDF_TOO_LARGE | PDF_TOO_MANY_SIGNATURES | UNSUPPORTED_ENVIRONMENT
|
|
863
|
+
if (e instanceof ValidatePdfError) e.code; // PDF_NO_SIGNATURE | PDF_INVALID | PDF_ENCRYPTED | PDF_TOO_LARGE | PDF_TOO_MANY_SIGNATURES | UNSUPPORTED_ENVIRONMENT | REQUEST_INVALID (roots/intermediates/issuers)
|
|
852
864
|
}
|
|
853
865
|
```
|
|
854
866
|
|
|
@@ -941,10 +953,10 @@ SSE/WebSocket-оор түлхэх бол `qrDeviceLinkTicker(input, (link) => se
|
|
|
941
953
|
|
|
942
954
|
```ts
|
|
943
955
|
// QR хуудас → poll-оор дууссан үр дүн
|
|
944
|
-
eid.validator.validateAuth(result, s.acsp
|
|
956
|
+
eid.validator.validateAuth(result, s.acsp!, { expectedFlowType: "QR" });
|
|
945
957
|
|
|
946
958
|
// Web2App/App2App товч → апп callback URL-д `userChallengeVerifier` нэмж буцна
|
|
947
|
-
eid.validator.validateAuth(result, s.acsp
|
|
959
|
+
eid.validator.validateAuth(result, s.acsp!, {
|
|
948
960
|
expectedFlowType: "Web2App", // RP-ийн апп дахь товч бол "App2App"
|
|
949
961
|
userChallengeVerifier: callbackQuery.get("userChallengeVerifier") ?? undefined,
|
|
950
962
|
});
|
|
@@ -956,7 +968,7 @@ QR ба товч хоёуланг харуулсан хуудсанд: callback-
|
|
|
956
968
|
|
|
957
969
|
> ⚠️ **Legacy холбоос хасагдсан.** Статик `{deviceLinkBase}?sessionId=…&vc=…` холбоосыг сервер 2026-10-07-нд,
|
|
958
970
|
> түүнийг угсардаг `deviceLink` / `openOrShowQR`-ийг SDK 0.16.0-д хассан — зөвхөн v3 (`buildDeviceLink`) ажиллана.
|
|
959
|
-
> v3 (`flowType`, `userChallengeVerifier`) iOS 2.2.3 (59) / Android 60-аас дэмжигдэнэ; сервер албадах доод хувилбар 2026-10-
|
|
971
|
+
> v3 (`flowType`, `userChallengeVerifier`) iOS 2.2.3 (59) / Android 60-аас дэмжигдэнэ; сервер албадах доод хувилбар 2026-10-20-ны байдлаар iOS ≥ 2.2.8, Android ≥ 91
|
|
960
972
|
> (`/mobile/app-config`, §«eID аппын доод хувилбар»).
|
|
961
973
|
|
|
962
974
|
## Аюулгүй байдал — яагаад `validator` заавал
|
|
@@ -1035,7 +1047,7 @@ const eid = new EidClient({
|
|
|
1035
1047
|
|
|
1036
1048
|
```bash
|
|
1037
1049
|
npm install
|
|
1038
|
-
npm run lint # tsc --noEmit
|
|
1050
|
+
npm run lint # tsc --noEmit (үндсэн + tsconfig.button.json)
|
|
1039
1051
|
npm test # build + node --test (pades golden — Go reference-тэй байт-ижил)
|
|
1040
1052
|
npm run golden:check # test/fixtures/pades/golden + src/pades/assets ↔ бэхэлсэн Go commit
|
|
1041
1053
|
npm run size:pades # /pades хөтчийн bundle gzip ≤ 300 KB
|
|
@@ -1044,7 +1056,7 @@ npm run test:convert-e2e # /convert жинхэнэ LibreOffice Chromium-д (BR
|
|
|
1044
1056
|
|
|
1045
1057
|
`/pades`-ийн conformance fixture (golden: оролт, тестийн PKI-ийн гэрчилгээ, TSA/OCSP/CRL-ийн тогтмол хариу, хүлээгдэх
|
|
1046
1058
|
sha256) ба фонт/гинжийн asset-ийг Go reference-ээс `node scripts/sync-pades-golden.mjs` хуулна (`GO_SDK_COMMIT` —
|
|
1047
|
-
tag `pades-golden-vN`, одоо
|
|
1059
|
+
tag `pades-golden-vN`, одоо v6 — `placement/` scanner vectors-той, page 0 verify хуудас алгасна); CI `--check`-ээр бэхэлсэн commit-тэй тулгана. Профайл:
|
|
1048
1060
|
Go репогийн `pades/PROFILE.md`, `PAGE_SPEC.md`, `PRECHECKS.md`, `WIRE.md`, `APPEARANCE_SPEC.md`, `PLACEMENT_SPEC.md`.
|
|
1049
1061
|
|
|
1050
1062
|
### Гэрээний шалгалт
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import './errors-
|
|
1
|
+
import './errors-CxAr-WIA.cjs';
|
|
2
2
|
|
|
3
3
|
/** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
|
|
4
4
|
interface NavigatorLike {
|
|
@@ -143,7 +143,7 @@ interface DeviceLinkSession {
|
|
|
143
143
|
deviceLinkBase: string | null;
|
|
144
144
|
/**
|
|
145
145
|
* Verification Code (5 оронтой) — иргэний утсан дээр харагдах кодтой НҮДЭЭР тулгахад RP UI-д
|
|
146
|
-
* харуулна. ПИН БИШ.
|
|
146
|
+
* харуулна. ПИН БИШ.
|
|
147
147
|
*/
|
|
148
148
|
vc: string | null;
|
|
149
149
|
rpChallenge: string;
|
|
@@ -300,8 +300,8 @@ interface RpCredentials {
|
|
|
300
300
|
/** relying_parties-д бүртгэлтэй RP UUID. */
|
|
301
301
|
rpUUID: string;
|
|
302
302
|
/**
|
|
303
|
-
* Дэд системийн нэр (ж: «Интернэт банк») — CA-д session бүрд хадгалагдана, ≤120
|
|
304
|
-
* (сервер илүүг таслана). Иргэний утсан дээр харагдах нэр нь RP-ийн бүртгэлийн нэр.
|
|
303
|
+
* Дэд системийн нэр (ж: «Интернэт банк») — CA-д session бүрд хадгалагдана, ≤ 120 байт UTF-8
|
|
304
|
+
* (кирилл ≈ 60 үсэг; сервер илүүг байтаар таслана). Иргэний утсан дээр харагдах нэр нь RP-ийн бүртгэлийн нэр.
|
|
305
305
|
*/
|
|
306
306
|
rpName: string;
|
|
307
307
|
/** API secret (rp_sk_…). Зөвхөн backend-д хадгална — браузерт ХЭЗЭЭ Ч задлахгүй. */
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import './errors-
|
|
1
|
+
import './errors-CxAr-WIA.js';
|
|
2
2
|
|
|
3
3
|
/** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
|
|
4
4
|
interface NavigatorLike {
|
|
@@ -143,7 +143,7 @@ interface DeviceLinkSession {
|
|
|
143
143
|
deviceLinkBase: string | null;
|
|
144
144
|
/**
|
|
145
145
|
* Verification Code (5 оронтой) — иргэний утсан дээр харагдах кодтой НҮДЭЭР тулгахад RP UI-д
|
|
146
|
-
* харуулна. ПИН БИШ.
|
|
146
|
+
* харуулна. ПИН БИШ.
|
|
147
147
|
*/
|
|
148
148
|
vc: string | null;
|
|
149
149
|
rpChallenge: string;
|
|
@@ -300,8 +300,8 @@ interface RpCredentials {
|
|
|
300
300
|
/** relying_parties-д бүртгэлтэй RP UUID. */
|
|
301
301
|
rpUUID: string;
|
|
302
302
|
/**
|
|
303
|
-
* Дэд системийн нэр (ж: «Интернэт банк») — CA-д session бүрд хадгалагдана, ≤120
|
|
304
|
-
* (сервер илүүг таслана). Иргэний утсан дээр харагдах нэр нь RP-ийн бүртгэлийн нэр.
|
|
303
|
+
* Дэд системийн нэр (ж: «Интернэт банк») — CA-д session бүрд хадгалагдана, ≤ 120 байт UTF-8
|
|
304
|
+
* (кирилл ≈ 60 үсэг; сервер илүүг байтаар таслана). Иргэний утсан дээр харагдах нэр нь RP-ийн бүртгэлийн нэр.
|
|
305
305
|
*/
|
|
306
306
|
rpName: string;
|
|
307
307
|
/** API secret (rp_sk_…). Зөвхөн backend-д хадгална — браузерт ХЭЗЭЭ Ч задлахгүй. */
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-Cgtf5eHN.cjs';
|
|
2
|
+
export { D as DeviceLinkError, E as EidError } from './errors-CxAr-WIA.cjs';
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-DgiXeZf-.js';
|
|
2
|
+
export { D as DeviceLinkError, E as EidError } from './errors-CxAr-WIA.js';
|
|
@@ -2285,14 +2285,15 @@ function nthPage(root, n) {
|
|
|
2285
2285
|
};
|
|
2286
2286
|
return walk(root, 0);
|
|
2287
2287
|
}
|
|
2288
|
-
|
|
2288
|
+
var MAX_VERIFY_ANNOTS = 1e4;
|
|
2289
|
+
function defaultStampPage(doc, verifyUri) {
|
|
2289
2290
|
const inc = new Incremental(doc);
|
|
2290
|
-
|
|
2291
|
+
const pages = [];
|
|
2291
2292
|
const walk = (v, depth) => {
|
|
2292
|
-
if (depth > MAX_DEPTH2 ||
|
|
2293
|
+
if (depth > MAX_DEPTH2 || pages.length > 1 << 16) return;
|
|
2293
2294
|
switch (v.key("Type").name()) {
|
|
2294
2295
|
case "Page":
|
|
2295
|
-
|
|
2296
|
+
pages.push(v);
|
|
2296
2297
|
break;
|
|
2297
2298
|
case "Pages": {
|
|
2298
2299
|
const kids = v.key("Kids");
|
|
@@ -2301,7 +2302,31 @@ function pageCount(doc) {
|
|
|
2301
2302
|
}
|
|
2302
2303
|
};
|
|
2303
2304
|
walk(inc.root().key("Pages"), 0);
|
|
2304
|
-
|
|
2305
|
+
const n = pages.length;
|
|
2306
|
+
for (let i = n - 1; i >= 0; i--) {
|
|
2307
|
+
if (!isVerifyPage(pages[i], verifyUri)) return { page: i + 1, n };
|
|
2308
|
+
}
|
|
2309
|
+
return { page: n, n };
|
|
2310
|
+
}
|
|
2311
|
+
function isVerifyPage(page, verifyUri) {
|
|
2312
|
+
try {
|
|
2313
|
+
const annots = page.key("Annots");
|
|
2314
|
+
if (annots.kind() !== "array") return false;
|
|
2315
|
+
const want = latin1(verifyUri);
|
|
2316
|
+
const m = Math.min(annots.len(), MAX_VERIFY_ANNOTS);
|
|
2317
|
+
for (let i = 0; i < m; i++) {
|
|
2318
|
+
const a = annots.index(i);
|
|
2319
|
+
if (a.kind() !== "dict" || a.key("Subtype").name() !== "Link") continue;
|
|
2320
|
+
const act = a.key("A");
|
|
2321
|
+
if (act.kind() !== "dict" || act.key("S").name() !== "URI") continue;
|
|
2322
|
+
const u = act.key("URI");
|
|
2323
|
+
if (u.kind() !== "string") continue;
|
|
2324
|
+
const got = u.rawString();
|
|
2325
|
+
if (got.length === want.length && got.every((b, j) => b === want[j])) return true;
|
|
2326
|
+
}
|
|
2327
|
+
} catch {
|
|
2328
|
+
}
|
|
2329
|
+
return false;
|
|
2305
2330
|
}
|
|
2306
2331
|
|
|
2307
2332
|
export {
|
|
@@ -2330,5 +2355,5 @@ export {
|
|
|
2330
2355
|
visibleRect,
|
|
2331
2356
|
pageGeometry,
|
|
2332
2357
|
nthPage,
|
|
2333
|
-
|
|
2358
|
+
defaultStampPage
|
|
2334
2359
|
};
|
|
@@ -72,9 +72,9 @@ declare class ApiError extends EidError {
|
|
|
72
72
|
declare class NoSigningCertificateError extends ApiError {
|
|
73
73
|
}
|
|
74
74
|
/**
|
|
75
|
-
* 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй:
|
|
75
|
+
* 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй: COMPLETE+OK биш,
|
|
76
76
|
* өөр documentNumber, 5 минутаас хуучин, гэрчилгээ солигдсон, эсвэл аль хэдийн ашиглагдсан. Certificate-choice-ийг
|
|
77
|
-
* дахин эхлүүлнэ.
|
|
77
|
+
* дахин эхлүүлнэ. (Өөр RP-ийн эсвэл олдохгүй linked session → 404 ApiError.)
|
|
78
78
|
*/
|
|
79
79
|
declare class CertChoiceInvalidError extends ApiError {
|
|
80
80
|
}
|
|
@@ -157,10 +157,11 @@ declare class ValidationError extends EidError {
|
|
|
157
157
|
declare class AppTransactionTooLargeError extends EidError {
|
|
158
158
|
}
|
|
159
159
|
/**
|
|
160
|
-
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй —
|
|
161
|
-
*
|
|
160
|
+
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй — `deviceLinkBase` https биш,
|
|
161
|
+
* sessionToken/sessionSecret/lang хэлбэр буруу, эсвэл төрөлд хэрэгтэй талбар (receivedAt, rpChallenge/digest,
|
|
162
|
+
* initialCallbackUrl) дутуу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
|
|
162
163
|
*/
|
|
163
164
|
declare class DeviceLinkError extends EidError {
|
|
164
165
|
}
|
|
165
166
|
|
|
166
|
-
export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N,
|
|
167
|
+
export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
|
|
@@ -72,9 +72,9 @@ declare class ApiError extends EidError {
|
|
|
72
72
|
declare class NoSigningCertificateError extends ApiError {
|
|
73
73
|
}
|
|
74
74
|
/**
|
|
75
|
-
* 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй:
|
|
75
|
+
* 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй: COMPLETE+OK биш,
|
|
76
76
|
* өөр documentNumber, 5 минутаас хуучин, гэрчилгээ солигдсон, эсвэл аль хэдийн ашиглагдсан. Certificate-choice-ийг
|
|
77
|
-
* дахин эхлүүлнэ.
|
|
77
|
+
* дахин эхлүүлнэ. (Өөр RP-ийн эсвэл олдохгүй linked session → 404 ApiError.)
|
|
78
78
|
*/
|
|
79
79
|
declare class CertChoiceInvalidError extends ApiError {
|
|
80
80
|
}
|
|
@@ -157,10 +157,11 @@ declare class ValidationError extends EidError {
|
|
|
157
157
|
declare class AppTransactionTooLargeError extends EidError {
|
|
158
158
|
}
|
|
159
159
|
/**
|
|
160
|
-
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй —
|
|
161
|
-
*
|
|
160
|
+
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй — `deviceLinkBase` https биш,
|
|
161
|
+
* sessionToken/sessionSecret/lang хэлбэр буруу, эсвэл төрөлд хэрэгтэй талбар (receivedAt, rpChallenge/digest,
|
|
162
|
+
* initialCallbackUrl) дутуу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
|
|
162
163
|
*/
|
|
163
164
|
declare class DeviceLinkError extends EidError {
|
|
164
165
|
}
|
|
165
166
|
|
|
166
|
-
export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N,
|
|
167
|
+
export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
|