@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 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-15-ны байдлаар iOS ≥ 2.2.7,
231
- Android ≥ 83 (`curl https://ca.eidmongolia.mn/mobile/app-config`). Иймд гарын үсэг зурж чадах бүх апп эдгээрийг дэмжинэ —
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-гүй. eID-ийн 5xx, холболтын алдаа, JSON бус 4xx (eID-ийн
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
- const result = await eid.session.waitForResult(s.sessionId); // long-poll
327
- const who = eid.validator.validateAuth(result, s.acsp); // ← гинж + ACSP_V2 крипто-баталгаажуулна
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; // "Болд Бат", "PNOMN-12345678" (givenName/surname/commonName/country…)
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 = buildDtbs(signer.certificate); // 32 байт SHA-256, стандарт base64
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"`, `revokedAt`-гүй.
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.groupBy(certificates.filter((c) => c.tokenSerial), (c) => c.tokenSerial!);
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 ~127 KB gzip (Noto Sans фонт asset-тэй, CI-д ≤ 300 KB); үндсэн entry үүнийг агуулахгүй. `/pades` (ба бүх багц) **Node ≥ 18** (CI: 18 / 20 / 22),
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` толин хуулбараас (бүх платформд). Шалгагч (`verify`) энд
564
- **байхгүй** — бүрэн криптограф шалгалт Go backend SDK-д; `prepare` нь өмнөх гарын үсгийг «хөнгөн» шалгуураар (бүтэц,
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 { signerCert, documentNumber } = await api("/sign/pdf/signer"); // backend: person.certificates
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-ээс (байхгүй = оролтын сүүлийн хуудас; нэмэх verify хуудас тооцогдохгүй). Өндөр ≥ 45 pt; хуудаснаас гарах, бичвэр
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
- `pdfTimeoutMs` / `pdfMaxBytes` устсан — PDF upload endpoint-ууд CA-д байхгүй (2026-10-14-нд устсан, 404).
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 MB),
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 тутам цагт 30 / өдөрт 200 хүсэлт,
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, { expectedFlowType: "QR" });
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-15-ны байдлаар iOS ≥ 2.2.7, Android ≥ 83
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`, одоо v5 — `placement/` scanner vectors-той); CI `--check`-ээр бэхэлсэн commit-тэй тулгана. Профайл:
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-BM8D3VEw.js';
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
- * харуулна. ПИН БИШ. Холбоосын `vc` параметрт мөн орно.
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-BM8D3VEw.cjs';
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
- * харуулна. ПИН БИШ. Холбоосын `vc` параметрт мөн орно.
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,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-Df4wTfZx.cjs';
2
- export { D as DeviceLinkError, E as EidError } from './errors-BM8D3VEw.cjs';
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-BYY0cP2D.js';
2
- export { D as DeviceLinkError, E as EidError } from './errors-BM8D3VEw.js';
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
- function pageCount(doc) {
2288
+ var MAX_VERIFY_ANNOTS = 1e4;
2289
+ function defaultStampPage(doc, verifyUri) {
2289
2290
  const inc = new Incremental(doc);
2290
- let n = 0;
2291
+ const pages = [];
2291
2292
  const walk = (v, depth) => {
2292
- if (depth > MAX_DEPTH2 || n > 1 << 16) return;
2293
+ if (depth > MAX_DEPTH2 || pages.length > 1 << 16) return;
2293
2294
  switch (v.key("Type").name()) {
2294
2295
  case "Page":
2295
- n++;
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
- return n;
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
- pageCount
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) хүчингүй: өөр RP, COMPLETE+OK биш,
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) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
161
- * эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
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, ON_BEHALF_ERROR_CODES as O, PDF_REGISTER_ERROR_CODES as P, RETRYABLE_ERROR_CODES as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, type OnBehalfErrorCode as d, type PdfRegisterErrorCode as e, RequestInvalidError as f, ResponseTooLargeError as g, type RetryableErrorCode as h, parseRetryAfter as p };
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) хүчингүй: өөр RP, COMPLETE+OK биш,
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) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
161
- * эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
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, ON_BEHALF_ERROR_CODES as O, PDF_REGISTER_ERROR_CODES as P, RETRYABLE_ERROR_CODES as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, type OnBehalfErrorCode as d, type PdfRegisterErrorCode as e, RequestInvalidError as f, ResponseTooLargeError as g, type RetryableErrorCode as h, parseRetryAfter as p };
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 };