@gerege-systems/eid-mongolia-sdk 0.15.4 → 0.16.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
@@ -6,8 +6,8 @@ RP-API v3, Smart-ID нийцтэй. Бүрэн баримт: <https://developer.
6
6
 
7
7
  > ⚠️ SDK **backend**-д ажиллана: бүх дуудлага API secret (`rp_sk_…`)-ээр баталгаажна, secret-ийг браузер/гар утсанд
8
8
  > хэзээ ч задлахгүй. Браузерт зөвхөн таны backend-ийн өгсөн холбоос/QR/товч харагдана — «eID-ээр нэвтрэх» товч
9
- > (`/button`) ч таны backend-ийг л дуудна (§1a). `@gerege-systems/eid-mongolia-sdk/browser`-ийн legacy device-link
10
- > туслахууд 2026-10-07-оос ажиллахгүй (§4). Үл хамаарах: `@gerege-systems/eid-mongolia-sdk/pades` (клиент талын PDF
9
+ > (`/button`) ч таны backend-ийг л дуудна (§1a). `@gerege-systems/eid-mongolia-sdk/browser` нь зөвхөн
10
+ > `isMobileUserAgent` ба алдааны классуудыг гаргана (legacy `deviceLink`/`openOrShowQR` 0.16.0-д хасагдсан, §4). Үл хамаарах: `@gerege-systems/eid-mongolia-sdk/pades` (клиент талын PDF
11
11
  > гарын үсэг, secret-гүй) хөтөч болон Node-д ажиллана (§3d).
12
12
 
13
13
  ## Суулгах
@@ -200,7 +200,7 @@ eid-login-button::part(icon) { width: 24px; height: 24px; }
200
200
  **eID аппын доод хувилбар.** `flowType` бэхлэлт (device link v3) ба Web2App-ийн `userChallengeVerifier` нь
201
201
  **iOS 2.2.3 (build 59)**, **Android 2.2.3 (versionCode 60)**-аас эхэлсэн. eID сервер 2026-10-07-оос legacy холбоосыг
202
202
  бүрэн хассан (v3-гүй session-д утас `DEVICE_LINK_REQUIRED`) бөгөөд доод хувилбарыг `/mobile/app-config`-оор албадан
203
- шинэчлүүлдэг: Android 2026-10-07-оос ≥ 70 (төхөөрөмжийн баталгаатай), 2026-10-14-ний байдлаар iOS ≥ 2.2.7,
203
+ шинэчлүүлдэг: Android 2026-10-07-оос ≥ 70 (төхөөрөмжийн баталгаатай), 2026-10-15-ны байдлаар iOS ≥ 2.2.7,
204
204
  Android ≥ 83 (`curl https://ca.eidmongolia.mn/mobile/app-config`). Иймд гарын үсэг зурж чадах бүх апп эдгээрийг дэмжинэ —
205
205
  RP талд нэмэлт шалгалт хэрэггүй. Эх сурвалж: eID CA-ийн `docs/DEVICE_LINK_V3.md` §5, §7; changelog
206
206
  `2026-10-02-ios-min-version-2-2-3`, `2026-10-07-android-min-70`.
@@ -313,7 +313,6 @@ UTF8String/PrintableString/BMPString. `parseSubject` нь зөвхөн задл
313
313
 
314
314
  > **Ижил утсан дээр push хэрэглэхгүй.** Push (`notificationBy*`)-ийн хүсэлт eID аппад мэдэгдэл / «хүлээгдэж буй»
315
315
  > жагсаалтаар ирдэг; Smart-ID ба eID-д Notification төрлийн device link **байхгүй** (CA `docs/DEVICE_LINK_V3.md` §3).
316
- > Хуучин `/dl?sessionId&vc` холбоос (`deviceLink`) push session-д ч юу ч өгөхгүй (сервер `DEVICE_LINK_REQUIRED`).
317
316
  > Иргэн RP-ийг eID апптай ижил утсан дээр нээсэн бол push-ийн оронд **device-link Web2App** урсгал хэрэглэ
318
317
  > (`auth.deviceLink*` / `signPdfDigest({ flow: "device-link" })` + `buildDeviceLink(…, "Web2App")`, §4) — товч аппыг шууд
319
318
  > нээж, callback-аар буцна. Push-д «eID аппаа нээнэ үү» гэсэн текст л хангалттай.
@@ -358,7 +357,7 @@ certificate-choice бүгдэд, 2026-10-14-өөс). Хуучин CA (талба
358
357
  Эцсийн үнэн нь `GET /session` (`TIMEOUT`).
359
358
 
360
359
  **Session эхлэх алдаа** (`ApiError`-ийн дэд анги, `.code`-той): `NoSigningCertificateError` — 409
361
- `NO_SIGNING_CERTIFICATE` (sign / certificate-choice start, `/pdf/sign/prepare`: иргэнд идэвхтэй төхөөрөмж / хүчинтэй
360
+ `NO_SIGNING_CERTIFICATE` (sign / certificate-choice start: иргэнд идэвхтэй төхөөрөмж / хүчинтэй
362
361
  гарын үсгийн гэрчилгээ алга, session үүсээгүй); `CertChoiceInvalidError` — 409 `CERT_CHOICE_INVALID` (linked sign-ийн
363
362
  certificate-choice хүчингүй / хуучирсан / ашиглагдсан → cert-choice-ийг дахин эхлүүл); `RequestInvalidError` — 400
364
363
  `REQUEST_INVALID` (ж: linked-д `linkedSessionID` дутуу).
@@ -366,7 +365,7 @@ certificate-choice хүчингүй / хуучирсан / ашиглагдса
366
365
  ### 3.1. Гэрчилгээг урьдчилж мэдэх (client-side PAdES / CMS)
367
366
 
368
367
  Гэрчилгээ DTBS-д (`signingCertificateV2`) ордог тул эхлээд certificate-choice, дараа нь digest-ийг **яг тэр төхөөрөмж
369
- рүү (`documentNumber`)** зуруулна. Олон утастай иргэнд etsi-ээр эхлүүлбэл өөр утас зурж, гарын үсэг гэрчилгээтэйгээ
368
+ рүү (`documentNumber`)** зуруулна. RP-д эрх: certificate-choice — `CERT`, digest sign — `SIGN`. Олон утастай иргэнд etsi-ээр эхлүүлбэл өөр утас зурж, гарын үсэг гэрчилгээтэйгээ
370
369
  таарахгүй.
371
370
 
372
371
  ```ts
@@ -455,7 +454,8 @@ const who = await eid.token.authVerify(ch.challengeId, authCertDer, rs);
455
454
  // токеноор PDF: §3d — prepare() → токен CKM_ECDSA(dtbs) → r||s → complete() → registerSignature() (sessionID-гүй, medium "token")
456
455
  ```
457
456
 
458
- `/token/auth/*` нь CA-д байгаа ч `/.well-known/eid`-д хараахан жагсаагдаагүй (гэрээний тест WARN).
457
+ `/token/auth/*` нь `/.well-known/eid`-ийн `endpoints.token.auth_challenge` / `auth_verify`-д жагсаагдсан (AUTH эрх) —
458
+ гэрээний тест бусад route-ийн адил шалгана.
459
459
 
460
460
  ## 3d. PDF гарын үсэг (PAdES, клиент тал) — `@gerege-systems/eid-mongolia-sdk/pades`
461
461
 
@@ -467,12 +467,12 @@ DSS-д), Adobe / EU DSS-д «LTV enabled», баталгаажуулах (QR) х
467
467
 
468
468
  | Функц | Хаана | Тайлбар |
469
469
  |---|---|---|
470
- | `prepare(pdf, { signerCert, claimedRole?, verifyPage?, fileName?, lang?, docId?, … })` | браузер / Node | `{ dtbs, digest, docId, state }` — сүлжээгүй |
470
+ | `prepare(pdf, { signerCert, claimedRole?, verifyPage?, fileName?, lang?, docId?, appearance?, … })` | браузер / Node | `{ dtbs, digest, docId, state }` — сүлжээгүй |
471
471
  | `eid.signPdfDigest({ dtbs, fileName, signer, flow?, onBehalfOf? })` | RP backend | DTBS-д гарын үсгийн session (push эсвэл device-link) |
472
472
  | `complete(state, signature)` | браузер / Node | TSA + OCSP/CRL → `{ pdf, cms, docId, outSha256, inSha256, hasPage, pageSha256, … }` |
473
473
  | `eid.registerSignature(registrationFromCompleted(done, { fileName, sessionID }))` | RP backend | `POST /pdf/signatures` — `/verify/{docID}` бүртгэл |
474
474
 
475
- `/pades` хөтчийн bundle ~125 KB gzip (Noto Sans фонт asset-тэй, CI-д ≤ 300 KB); үндсэн entry үүнийг агуулахгүй. `/pades` (ба бүх багц) **Node ≥ 18** (CI: 18 / 20 / 22),
475
+ `/pades` хөтчийн bundle ~127 KB gzip (Noto Sans фонт asset-тэй, CI-д ≤ 300 KB); үндсэн entry үүнийг агуулахгүй. `/pades` (ба бүх багц) **Node ≥ 18** (CI: 18 / 20 / 22),
476
476
  орчин үеийн хөтөч. Браузерийн CSP: `connect-src https://tsa.timeserver.mn https://ocsp.eidmongolia.mn
477
477
  https://crl.eidmongolia.mn`. Хөтөчид гэрчилгээний `http://` AIA/CDP-г зөвхөн эдгээр хостод `https://` болгоно; үндэсний
478
478
  CA-ийн CRL (`esign.gov.mn`) нь `crl.eidmongolia.mn` толин хуулбараас (бүх платформд). Шалгагч (`verify`) энд
@@ -480,9 +480,11 @@ CA-ийн CRL (`esign.gov.mn`) нь `crl.eidmongolia.mn` толин хуулба
480
480
  CMS гарын үсэг, eID олгогч, timestamp, DSS) л шалгана.
481
481
 
482
482
  **Зурагчийн гэрчилгээ.** `prepare` иргэний SIGN гэрчилгээг (`signingCertificateV2`) шаарддаг тул session-оос ӨМНӨ
483
- хэрэгтэй — одоогоор `eid.person.certificates(etsi)` (`PKI_READ`; `type: "SIGN"`, `status: "VALID"`, `keyMedium: "MOBILE"`
484
- мөрийн `certValue` + `documentNumber`). Session-ийг тэр `documentNumber`-ээр эхлүүлнэ — өөр төхөөрөмж зурвал `complete`
485
- `SIGNATURE_INVALID`.
483
+ хэрэгтэй. Үндсэн зам — **certificate-choice** (§3.1; RP-д `CERT` эрх): `validateCertificateChoice` → `signer.certificate`
484
+ + `signer.documentNumber`, дараа нь `digestForSigner` / `deviceLinkForSigner`-ээр тэр төхөөрөмж рүү зуруулна.
485
+ `eid.person.certificates(etsi)` (`PKI_READ`; `type: "SIGN"`, `status: "VALID"`, `keyMedium: "MOBILE"` мөрийн `certValue` +
486
+ `documentNumber`) нь зөвхөн итгэмжлэгдсэн RP-д, иргэн сүүлийн 24 цагт тухайн RP-д амжилттай нэвтэрсэн үед (бусад → 403).
487
+ Session-ийг тэр `documentNumber`-ээр эхлүүлнэ — өөр төхөөрөмж зурвал `complete` `SIGNATURE_INVALID`.
486
488
 
487
489
  ### Вэб RP (браузер prepare/complete, backend session)
488
490
 
@@ -528,6 +530,18 @@ reply({ verifyUrl: reg.verifyUrl });
528
530
  `priorSignatures` болгож дамжуулна; `registerSignature` 409 `PRIOR_MISMATCH`-ийн дараа өөрөө revision-оор тааруулна
529
531
  (`priorRevisionSha256`-г гараар өгвөл оролдохгүй). Хөтчөөс JSON-оор дамжуулахдаа `priorRevisionSha256`-ийг ч явуул.
530
532
 
533
+ **Харагдах гарын үсэг (сонголттой).** `appearance: { page?, x, y, width, height, lang? }` өгвөл гарын үсэг хуудсан дээр
534
+ харагдана (QR + нэр, `claimedRole`, «eID Mongolia-аар зурсан», огноо `YYYY-MM-DD HH:MM (+08)`); байхгүй бол үл харагдах
535
+ (өмнөхтэй байт-ижил). Координат pt-ээр, хуудасны CropBox-ийн `/Rotate`-ийн дараах (дэлгэцэнд харагдах) зүүн доод булангаас;
536
+ `page` 1-ээс (байхгүй = оролтын сүүлийн хуудас; нэмэх verify хуудас тооцогдохгүй). Өндөр ≥ 45 pt; хуудаснаас гарах, бичвэр
537
+ багтахгүй, docId-гүй (хуудасгүй гарын үсэгтэй баримт) бол `REQUEST_INVALID`. Харагдах бүр ~+90 KB. Дүрэм: Go репогийн
538
+ `pades/APPEARANCE_SPEC.md`.
539
+
540
+ ```ts
541
+ const p = await prepare(pdfBytes, { signerCert, verifyPage: true, fileName: "Гэрээ №12.pdf",
542
+ appearance: { page: 1, x: 340, y: 36, width: 220, height: 64 } });
543
+ ```
544
+
531
545
  ### Зөвхөн Node (backend бүгдийг хийнэ)
532
546
 
533
547
  ```ts
@@ -560,8 +574,8 @@ writeFileSync("signed.pdf", done.pdf);
560
574
  `state` нь бэлтгэсэн PDF-ийг агуулна — PDF-тэй ижил нууцлалтай хадгал. Формат нь Go SDK-тай ижил (хөтөчид `prepare`,
561
575
  Go backend-д `complete` хийж болно).
562
576
 
563
- 0.14.0-д `eid.pdf` (`prepare`, `document`, `documentVerified`, `tokenPrepare`, `tokenFinalize`, `tokenDocument`) ба
564
- `pdfTimeoutMs` / `pdfMaxBytes` устсан — PDF upload endpoint-ууд CA-д байхгүй болно.
577
+ 0.15.0-д `eid.pdf` (`prepare`, `document`, `documentVerified`, `tokenPrepare`, `tokenFinalize`, `tokenDocument`) ба
578
+ `pdfTimeoutMs` / `pdfMaxBytes` устсан — PDF upload endpoint-ууд CA-д байхгүй (2026-10-14-нд устсан, 404).
565
579
 
566
580
  ## 4. QR ба ижил төхөөрөмж — device link v3
567
581
 
@@ -640,9 +654,10 @@ eid.validator.validateAuth(result, s.acsp, {
640
654
  QR ба товч хоёуланг харуулсан хуудсанд: callback-аар ирсэн үр дүнг `Web2App`/`App2App`-аар, poll-оор ирснийг
641
655
  `QR`-аар шалга (товчоор нээгдсэн session зөвхөн callback-аар дуусна).
642
656
 
643
- > ⚠️ **Legacy холбоос хасагдсан (2026-10-07).** Статик `deviceLink(session)` (`{deviceLinkBase}?sessionId=…&vc=…`)
644
- > болон `/browser` entry-ийн `openOrShowQR`-ээр нээгдсэн session-д сервер утасны үйлдлийг `DEVICE_LINK_REQUIRED`-аар
645
- > татгалзана — зөвхөн v3 (`buildDeviceLink`) ажиллана. Аппын доод хувилбар: iOS 2.2.3 (59), Android 70.
657
+ > ⚠️ **Legacy холбоос хасагдсан.** Статик `{deviceLinkBase}?sessionId=…&vc=…` холбоосыг сервер 2026-10-07-нд,
658
+ > түүнийг угсардаг `deviceLink` / `openOrShowQR`-ийг SDK 0.16.0-д хассан — зөвхөн v3 (`buildDeviceLink`) ажиллана.
659
+ > v3 (`flowType`, `userChallengeVerifier`) iOS 2.2.3 (59) / Android 60-аас дэмжигдэнэ; сервер албадах доод хувилбар 2026-10-15-ны байдлаар iOS ≥ 2.2.7, Android ≥ 83
660
+ > (`/mobile/app-config`, §«eID аппын доод хувилбар»).
646
661
 
647
662
  ## Аюулгүй байдал — яагаад `validator` заавал
648
663
 
@@ -689,7 +704,7 @@ OK ирж болзошгүй. Иймд `ResponseValidator`:
689
704
  | `ForbiddenError` | 403 — IP allowlist / mTLS / RP-ийн эрх; onBehalfOf татгалзвал `.code` (`OnBehalfErrorCode`) |
690
705
  | `SessionFailedError` | endResult ≠ OK (TIMEOUT, USER_REFUSED…) — `.endResult`-оор салга |
691
706
  | `ValidationError` | cert chain/signature/level шалгалт бүтэлгүйтсэн |
692
- | `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start, PDF prepare); `ApiError`-ийн дэд анги |
707
+ | `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start); `ApiError`-ийн дэд анги |
693
708
  | `CertChoiceInvalidError` | 409 `CERT_CHOICE_INVALID` — linked sign-ийн certificate-choice хүчингүй; `ApiError`-ийн дэд анги |
694
709
  | `RequestInvalidError` | 400 `REQUEST_INVALID` — хүсэлт буруу (ж: `linkedSessionID` дутуу); `ApiError`-ийн дэд анги |
695
710
  | `ApiError` | бусад HTTP алдаа (`.status`, `.body`, серверийн `.code`, `.retryAfterMs`, `.headers`, `.retryable` — ж: 404 `ORG_NOT_FOUND`) |
@@ -720,8 +735,8 @@ npm run size:pades # /pades хөтчийн bundle gzip ≤ 300 KB
720
735
 
721
736
  `/pades`-ийн conformance fixture (golden: оролт, тестийн PKI-ийн гэрчилгээ, TSA/OCSP/CRL-ийн тогтмол хариу, хүлээгдэх
722
737
  sha256) ба фонт/гинжийн asset-ийг Go reference-ээс `node scripts/sync-pades-golden.mjs` хуулна (`GO_SDK_COMMIT` —
723
- tag `pades-golden-vN`); CI `--check`-ээр бэхэлсэн commit-тэй тулгана. Профайл: Go репогийн `pades/PROFILE.md`,
724
- `PAGE_SPEC.md`, `PRECHECKS.md`, `WIRE.md`.
738
+ tag `pades-golden-vN`, одоо v3); CI `--check`-ээр бэхэлсэн commit-тэй тулгана. Профайл: Go репогийн `pades/PROFILE.md`,
739
+ `PAGE_SPEC.md`, `PRECHECKS.md`, `WIRE.md`, `APPEARANCE_SPEC.md`.
725
740
 
726
741
  ### Гэрээний шалгалт
727
742
 
@@ -1,4 +1,18 @@
1
- import './errors-Z7SgLVTr.js';
1
+ import './errors-pK1L0s4N.js';
2
+
3
+ /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
+ interface NavigatorLike {
5
+ userAgent?: string;
6
+ maxTouchPoints?: number;
7
+ userAgentData?: {
8
+ mobile?: boolean;
9
+ };
10
+ }
11
+ /**
12
+ * Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
13
+ * илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
14
+ */
15
+ declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
2
16
 
3
17
  /** Сертификатын баталгаажуулалтын түвшин (eIDAS LoA). QUALIFIED — хууль ёсны гарын үсэгт. */
4
18
  type CertificateLevel = "ADVANCED" | "QUALIFIED" | "QSCD";
@@ -76,7 +90,10 @@ interface NotificationSession {
76
90
  acsp?: AcspContext;
77
91
  /** Sign session-ий хүсэлтэд илгээсэн утгууд ({@link SignContext}); auth / certificate-choice-д undefined. */
78
92
  sign?: SignContext;
79
- /** Sign / certificate-choice session-ий ТООЦООЛСОН дуусах мөч (ms epoch) — {@link sessionExpiry}; auth-д undefined. */
93
+ /**
94
+ * Session дуусах мөч (ms epoch): CA-ийн start хариуны `expiresAt` (0.14.2-оос; auth / sign / certificate-choice). Хуучин
95
+ * CA (талбаргүй) үед sign / certificate-choice-д тооцоолсон ({@link sessionExpiry}), auth-д undefined.
96
+ */
80
97
  expiresAt?: number;
81
98
  }
82
99
  /**
@@ -287,50 +304,4 @@ interface RpCredentials {
287
304
  apiSecret: string;
288
305
  }
289
306
 
290
- /** Холбоос угсрахад хэрэгтэй талбарууд — backend хариунаас браузерт зөвхөн эдгээрийг дамжуулна. */
291
- type DeviceLinkInput = Pick<DeviceLinkSession, "sessionId" | "vc" | "deviceLinkBase">;
292
- /**
293
- * Device-link session-ийн холбоос: `${deviceLinkBase}?sessionId=<uuid>&vc=<код>`.
294
- * QR-д эсвэл «eID аппаар нээх» товчинд тавина.
295
- *
296
- * @deprecated Legacy статик холбоос — холбоосын төрөл (QR/Web2App) хамгаалагдаагүй, relay-д нээлттэй.
297
- * Сервер 2026-10-07-нд хассан: ийм холбоосоор нээгдсэн session-д утасны үйлдлийг `DEVICE_LINK_REQUIRED`-аар
298
- * татгалзана. Backend-д {@link buildDeviceLink} (v3) ашиглана.
299
- *
300
- * @throws {DeviceLinkError} deviceLinkBase байхгүй / http(s) биш, sessionId UUID биш, vc 5 орон биш.
301
- */
302
- declare function deviceLink(session: DeviceLinkInput): string;
303
- /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
304
- interface NavigatorLike {
305
- userAgent?: string;
306
- maxTouchPoints?: number;
307
- userAgentData?: {
308
- mobile?: boolean;
309
- };
310
- }
311
- /**
312
- * Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
313
- * илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
314
- */
315
- declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
316
- interface OpenOrShowQROptions {
317
- /** Desktop дээр QR харуулах (link-ийг QR болгох нь RP-ийн UI). */
318
- showQR: (link: string) => void;
319
- /** Гар утас эсэх — boolean эсвэл функц. Анхдагч {@link isMobileUserAgent}. */
320
- isMobile?: boolean | (() => boolean);
321
- }
322
- /**
323
- * Браузерт: гар утсан дээр eID аппыг шууд нээнэ (`location.assign(link)` — Universal Link /
324
- * App Link), бусад үед `showQR(link)` дуудна. Буцаах утга: `"opened"` эсвэл `"qr"`.
325
- *
326
- * (!) Товчны click handler дотроос ШУУД (await-гүйгээр) дууд — session-ийг урьдчилж эхлүүлээд
327
- * хадгал. iOS урт async гинжийн дараах навигацийг хэрэглэгчийн үйлдэл гэж тооцохгүй тул Universal
328
- * Link-ийг алгасаж /dl хуудсыг нээдэг; тэр хуудас «Аппаар нээх» товч ба store холбоосыг санал болгоно.
329
- *
330
- * @throws {DeviceLinkError} холбоос угсрах боломжгүй бол ({@link deviceLink}).
331
- * @deprecated Legacy {@link deviceLink} холбоос дээр тулгуурладаг — сервер 2026-10-07-нд хассан тул ажиллахгүй.
332
- * QR-ийг backend-ийн `buildDeviceLink` (v3)-ээр, утсан дээр Web2App холбоосыг энгийн `<a href>`-ээр харуулна.
333
- */
334
- declare function openOrShowQR(session: DeviceLinkInput, opts: OpenOrShowQROptions): "opened" | "qr";
335
-
336
- export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OpenOrShowQROptions as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type DeviceLinkInput as d, type NavigatorLike as e, type OrgResult as f, type Representation as g, type SessionState as h, type SignContext as i, type SignatureAlgorithmParameters as j, type SignatureProtocol as k, type TokenCertStatus as l, deviceLink as m, isMobileUserAgent as n, openOrShowQR as o, parseExpiresAt as p, startExpiry as q, sessionExpiry as s };
307
+ export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type NavigatorLike as d, type Representation as e, type SessionState as f, type SignContext as g, type SignatureAlgorithmParameters as h, type SignatureProtocol as i, type TokenCertStatus as j, isMobileUserAgent as k, startExpiry as l, parseExpiresAt as p, sessionExpiry as s };
@@ -1,4 +1,18 @@
1
- import './errors-Z7SgLVTr.cjs';
1
+ import './errors-pK1L0s4N.cjs';
2
+
3
+ /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
+ interface NavigatorLike {
5
+ userAgent?: string;
6
+ maxTouchPoints?: number;
7
+ userAgentData?: {
8
+ mobile?: boolean;
9
+ };
10
+ }
11
+ /**
12
+ * Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
13
+ * илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
14
+ */
15
+ declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
2
16
 
3
17
  /** Сертификатын баталгаажуулалтын түвшин (eIDAS LoA). QUALIFIED — хууль ёсны гарын үсэгт. */
4
18
  type CertificateLevel = "ADVANCED" | "QUALIFIED" | "QSCD";
@@ -76,7 +90,10 @@ interface NotificationSession {
76
90
  acsp?: AcspContext;
77
91
  /** Sign session-ий хүсэлтэд илгээсэн утгууд ({@link SignContext}); auth / certificate-choice-д undefined. */
78
92
  sign?: SignContext;
79
- /** Sign / certificate-choice session-ий ТООЦООЛСОН дуусах мөч (ms epoch) — {@link sessionExpiry}; auth-д undefined. */
93
+ /**
94
+ * Session дуусах мөч (ms epoch): CA-ийн start хариуны `expiresAt` (0.14.2-оос; auth / sign / certificate-choice). Хуучин
95
+ * CA (талбаргүй) үед sign / certificate-choice-д тооцоолсон ({@link sessionExpiry}), auth-д undefined.
96
+ */
80
97
  expiresAt?: number;
81
98
  }
82
99
  /**
@@ -287,50 +304,4 @@ interface RpCredentials {
287
304
  apiSecret: string;
288
305
  }
289
306
 
290
- /** Холбоос угсрахад хэрэгтэй талбарууд — backend хариунаас браузерт зөвхөн эдгээрийг дамжуулна. */
291
- type DeviceLinkInput = Pick<DeviceLinkSession, "sessionId" | "vc" | "deviceLinkBase">;
292
- /**
293
- * Device-link session-ийн холбоос: `${deviceLinkBase}?sessionId=<uuid>&vc=<код>`.
294
- * QR-д эсвэл «eID аппаар нээх» товчинд тавина.
295
- *
296
- * @deprecated Legacy статик холбоос — холбоосын төрөл (QR/Web2App) хамгаалагдаагүй, relay-д нээлттэй.
297
- * Сервер 2026-10-07-нд хассан: ийм холбоосоор нээгдсэн session-д утасны үйлдлийг `DEVICE_LINK_REQUIRED`-аар
298
- * татгалзана. Backend-д {@link buildDeviceLink} (v3) ашиглана.
299
- *
300
- * @throws {DeviceLinkError} deviceLinkBase байхгүй / http(s) биш, sessionId UUID биш, vc 5 орон биш.
301
- */
302
- declare function deviceLink(session: DeviceLinkInput): string;
303
- /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
304
- interface NavigatorLike {
305
- userAgent?: string;
306
- maxTouchPoints?: number;
307
- userAgentData?: {
308
- mobile?: boolean;
309
- };
310
- }
311
- /**
312
- * Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
313
- * илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
314
- */
315
- declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
316
- interface OpenOrShowQROptions {
317
- /** Desktop дээр QR харуулах (link-ийг QR болгох нь RP-ийн UI). */
318
- showQR: (link: string) => void;
319
- /** Гар утас эсэх — boolean эсвэл функц. Анхдагч {@link isMobileUserAgent}. */
320
- isMobile?: boolean | (() => boolean);
321
- }
322
- /**
323
- * Браузерт: гар утсан дээр eID аппыг шууд нээнэ (`location.assign(link)` — Universal Link /
324
- * App Link), бусад үед `showQR(link)` дуудна. Буцаах утга: `"opened"` эсвэл `"qr"`.
325
- *
326
- * (!) Товчны click handler дотроос ШУУД (await-гүйгээр) дууд — session-ийг урьдчилж эхлүүлээд
327
- * хадгал. iOS урт async гинжийн дараах навигацийг хэрэглэгчийн үйлдэл гэж тооцохгүй тул Universal
328
- * Link-ийг алгасаж /dl хуудсыг нээдэг; тэр хуудас «Аппаар нээх» товч ба store холбоосыг санал болгоно.
329
- *
330
- * @throws {DeviceLinkError} холбоос угсрах боломжгүй бол ({@link deviceLink}).
331
- * @deprecated Legacy {@link deviceLink} холбоос дээр тулгуурладаг — сервер 2026-10-07-нд хассан тул ажиллахгүй.
332
- * QR-ийг backend-ийн `buildDeviceLink` (v3)-ээр, утсан дээр Web2App холбоосыг энгийн `<a href>`-ээр харуулна.
333
- */
334
- declare function openOrShowQR(session: DeviceLinkInput, opts: OpenOrShowQROptions): "opened" | "qr";
335
-
336
- export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OpenOrShowQROptions as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type DeviceLinkInput as d, type NavigatorLike as e, type OrgResult as f, type Representation as g, type SessionState as h, type SignContext as i, type SignatureAlgorithmParameters as j, type SignatureProtocol as k, type TokenCertStatus as l, deviceLink as m, isMobileUserAgent as n, openOrShowQR as o, parseExpiresAt as p, startExpiry as q, sessionExpiry as s };
307
+ export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type NavigatorLike as d, type Representation as e, type SessionState as f, type SignContext as g, type SignatureAlgorithmParameters as h, type SignatureProtocol as i, type TokenCertStatus as j, isMobileUserAgent as k, startExpiry as l, parseExpiresAt as p, sessionExpiry as s };
package/dist/browser.cjs CHANGED
@@ -22,43 +22,11 @@ var browser_exports = {};
22
22
  __export(browser_exports, {
23
23
  DeviceLinkError: () => DeviceLinkError,
24
24
  EidError: () => EidError,
25
- deviceLink: () => deviceLink,
26
- isMobileUserAgent: () => isMobileUserAgent,
27
- openOrShowQR: () => openOrShowQR
25
+ isMobileUserAgent: () => isMobileUserAgent
28
26
  });
29
27
  module.exports = __toCommonJS(browser_exports);
30
28
 
31
- // src/errors.ts
32
- var EidError = class extends Error {
33
- constructor(message) {
34
- super(message);
35
- this.name = new.target.name;
36
- }
37
- };
38
- var DeviceLinkError = class extends EidError {
39
- };
40
-
41
29
  // src/devicelink.ts
42
- var SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
43
- var VC_RE = /^[0-9]{5}$/;
44
- function deviceLink(session) {
45
- const base = session.deviceLinkBase?.trim();
46
- if (!base) throw new DeviceLinkError("deviceLink: \u0445\u0430\u0440\u0438\u0443\u043D\u0434 deviceLinkBase \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 device-link session \u044D\u0441\u044D\u0445\u0438\u0439\u0433 \u0448\u0430\u043B\u0433\u0430");
47
- let u;
48
- try {
49
- u = new URL(base);
50
- } catch {
51
- throw new DeviceLinkError(`deviceLink: deviceLinkBase \u0431\u0443\u0440\u0443\u0443 URL: ${base}`);
52
- }
53
- if (u.protocol !== "https:" && u.protocol !== "http:") {
54
- throw new DeviceLinkError(`deviceLink: deviceLinkBase https URL \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439: ${u.protocol}`);
55
- }
56
- if (!SESSION_ID_RE.test(session.sessionId)) throw new DeviceLinkError("deviceLink: sessionId UUID (lowercase) \u0431\u0438\u0448");
57
- if (session.vc == null || !VC_RE.test(session.vc)) throw new DeviceLinkError("deviceLink: vc 5 \u043E\u0440\u043E\u043D\u0442\u043E\u0439 \u0442\u043E\u043E \u0431\u0438\u0448");
58
- u.searchParams.set("sessionId", session.sessionId);
59
- u.searchParams.set("vc", session.vc);
60
- return u.toString();
61
- }
62
30
  function isMobileUserAgent(nav) {
63
31
  const n = nav ?? globalThis.navigator;
64
32
  if (!n) return false;
@@ -67,23 +35,19 @@ function isMobileUserAgent(nav) {
67
35
  if (/Android|iPhone|iPod|iPad/i.test(ua)) return true;
68
36
  return /Macintosh/.test(ua) && (n.maxTouchPoints ?? 0) > 1;
69
37
  }
70
- function openOrShowQR(session, opts) {
71
- const link = deviceLink(session);
72
- const mobile = typeof opts.isMobile === "function" ? opts.isMobile() : opts.isMobile ?? isMobileUserAgent();
73
- if (mobile) {
74
- const loc = globalThis.location;
75
- if (!loc) throw new DeviceLinkError("openOrShowQR: location \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 \u0437\u04E9\u0432\u0445\u04E9\u043D \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0442");
76
- loc.assign(link);
77
- return "opened";
38
+
39
+ // src/errors.ts
40
+ var EidError = class extends Error {
41
+ constructor(message) {
42
+ super(message);
43
+ this.name = new.target.name;
78
44
  }
79
- opts.showQR(link);
80
- return "qr";
81
- }
45
+ };
46
+ var DeviceLinkError = class extends EidError {
47
+ };
82
48
  // Annotate the CommonJS export names for ESM import in node:
83
49
  0 && (module.exports = {
84
50
  DeviceLinkError,
85
51
  EidError,
86
- deviceLink,
87
- isMobileUserAgent,
88
- openOrShowQR
52
+ isMobileUserAgent
89
53
  });
@@ -1,2 +1,2 @@
1
- export { d as DeviceLinkInput, D as DeviceLinkSession, e as NavigatorLike, O as OpenOrShowQROptions, m as deviceLink, n as isMobileUserAgent, o as openOrShowQR } from './browser-8k_VDSP8.cjs';
2
- export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.cjs';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-DFnRVCfN.cjs';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-pK1L0s4N.cjs';
package/dist/browser.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { d as DeviceLinkInput, D as DeviceLinkSession, e as NavigatorLike, O as OpenOrShowQROptions, m as deviceLink, n as isMobileUserAgent, o as openOrShowQR } from './browser-BZ3hvv6-.js';
2
- export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.js';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-BPhROZkH.js';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-pK1L0s4N.js';
package/dist/browser.js CHANGED
@@ -1,16 +1,12 @@
1
1
  import {
2
- deviceLink,
3
- isMobileUserAgent,
4
- openOrShowQR
5
- } from "./chunk-REWNE7PO.js";
2
+ isMobileUserAgent
3
+ } from "./chunk-WOWGH65C.js";
6
4
  import {
7
5
  DeviceLinkError,
8
6
  EidError
9
- } from "./chunk-TB2KQH3W.js";
7
+ } from "./chunk-Y3JYLJPG.js";
10
8
  export {
11
9
  DeviceLinkError,
12
10
  EidError,
13
- deviceLink,
14
- isMobileUserAgent,
15
- openOrShowQR
11
+ isMobileUserAgent
16
12
  };
@@ -0,0 +1,13 @@
1
+ // src/devicelink.ts
2
+ function isMobileUserAgent(nav) {
3
+ const n = nav ?? globalThis.navigator;
4
+ if (!n) return false;
5
+ if (n.userAgentData?.mobile === true) return true;
6
+ const ua = n.userAgent ?? "";
7
+ if (/Android|iPhone|iPod|iPad/i.test(ua)) return true;
8
+ return /Macintosh/.test(ua) && (n.maxTouchPoints ?? 0) > 1;
9
+ }
10
+
11
+ export {
12
+ isMobileUserAgent
13
+ };
@@ -48,7 +48,7 @@ var ApiError = class extends EidError {
48
48
  headers;
49
49
  /**
50
50
  * Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
51
- * PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
51
+ * RATE_LIMITED, 503 STATE_UNAVAILABLE / ISSUANCE_PENDING г.м.) тавина.
52
52
  */
53
53
  retryAfterMs;
54
54
  /**
@@ -67,10 +67,6 @@ var CertChoiceInvalidError = class extends ApiError {
67
67
  var RequestInvalidError = class extends ApiError {
68
68
  };
69
69
  var RETRYABLE_ERROR_CODES = [
70
- "PDF_PREPARE_BUSY",
71
- "DOCUMENT_PENDING",
72
- "TSA_UNAVAILABLE",
73
- "LTV_UNAVAILABLE",
74
70
  "RATE_LIMITED",
75
71
  "STATE_UNAVAILABLE",
76
72
  "ISSUANCE_PENDING"
@@ -52,7 +52,7 @@ declare class ApiError extends EidError {
52
52
  readonly headers?: Headers;
53
53
  /**
54
54
  * Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
55
- * PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
55
+ * RATE_LIMITED, 503 STATE_UNAVAILABLE / ISSUANCE_PENDING г.м.) тавина.
56
56
  */
57
57
  readonly retryAfterMs?: number;
58
58
  constructor(status: number, body: string,
@@ -66,7 +66,7 @@ declare class ApiError extends EidError {
66
66
  }
67
67
  /**
68
68
  * 409 `NO_SIGNING_CERTIFICATE` — иргэнд (баримтад) идэвхтэй төхөөрөмж / SIGN credential / хүчинтэй гарын үсгийн
69
- * гэрчилгээ алга: sign ба certificate-choice session start, `/pdf/sign/prepare`. Session үүсээгүй. Танихгүй
69
+ * гэрчилгээ алга: sign ба certificate-choice session start. Session үүсээгүй. Танихгүй
70
70
  * лавлагаанд ч ижил хариу (бүртгэл задлахгүй) — хэрэглэгчид «eID гарын үсгийн гэрчилгээгүй» гэж харуулна.
71
71
  */
72
72
  declare class NoSigningCertificateError extends ApiError {
@@ -82,11 +82,11 @@ declare class CertChoiceInvalidError extends ApiError {
82
82
  declare class RequestInvalidError extends ApiError {
83
83
  }
84
84
  /**
85
- * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
86
- * DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
87
- * STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
85
+ * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
86
+ * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
87
+ * TSA_UNAVAILABLE / LTV_UNAVAILABLE нь CA-ийн биш — клиент талын `PadesError.code` (`/pades`, өөрийн `retryable`).
88
88
  */
89
- type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
89
+ type RetryableErrorCode = "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
90
90
  /** {@link RetryableErrorCode}-ийн бүх утга. */
91
91
  declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
92
92
  /** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
@@ -95,8 +95,8 @@ declare function parseRetryAfter(value: string | null | undefined, now?: number)
95
95
  * Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
96
96
  * `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
97
97
  * баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
98
- * session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
99
- * баримт үүсээгүй).
98
+ * session); 404: ORG_NOT_FOUND; 403 REPRESENTATION_REVOKED — `POST /pdf/signatures` (session-оос хойш төлөөлөл
99
+ * хасагдсан, бүртгэгдээгүй) ба токены гэрчилгээ олголт (TOKEN_ISSUE).
100
100
  */
101
101
  type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
102
102
  /** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
@@ -116,7 +116,7 @@ declare class NetworkError extends EidError {
116
116
  });
117
117
  }
118
118
  /**
119
- * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
119
+ * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB) — бие таслагдаж задлагдахгүй. `op` — method +
120
120
  * таних тэмдэггүй зам.
121
121
  */
122
122
  declare class ResponseTooLargeError extends EidError {
@@ -52,7 +52,7 @@ declare class ApiError extends EidError {
52
52
  readonly headers?: Headers;
53
53
  /**
54
54
  * Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
55
- * PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
55
+ * RATE_LIMITED, 503 STATE_UNAVAILABLE / ISSUANCE_PENDING г.м.) тавина.
56
56
  */
57
57
  readonly retryAfterMs?: number;
58
58
  constructor(status: number, body: string,
@@ -66,7 +66,7 @@ declare class ApiError extends EidError {
66
66
  }
67
67
  /**
68
68
  * 409 `NO_SIGNING_CERTIFICATE` — иргэнд (баримтад) идэвхтэй төхөөрөмж / SIGN credential / хүчинтэй гарын үсгийн
69
- * гэрчилгээ алга: sign ба certificate-choice session start, `/pdf/sign/prepare`. Session үүсээгүй. Танихгүй
69
+ * гэрчилгээ алга: sign ба certificate-choice session start. Session үүсээгүй. Танихгүй
70
70
  * лавлагаанд ч ижил хариу (бүртгэл задлахгүй) — хэрэглэгчид «eID гарын үсгийн гэрчилгээгүй» гэж харуулна.
71
71
  */
72
72
  declare class NoSigningCertificateError extends ApiError {
@@ -82,11 +82,11 @@ declare class CertChoiceInvalidError extends ApiError {
82
82
  declare class RequestInvalidError extends ApiError {
83
83
  }
84
84
  /**
85
- * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
86
- * DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
87
- * STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
85
+ * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
86
+ * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
87
+ * TSA_UNAVAILABLE / LTV_UNAVAILABLE нь CA-ийн биш — клиент талын `PadesError.code` (`/pades`, өөрийн `retryable`).
88
88
  */
89
- type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
89
+ type RetryableErrorCode = "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
90
90
  /** {@link RetryableErrorCode}-ийн бүх утга. */
91
91
  declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
92
92
  /** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
@@ -95,8 +95,8 @@ declare function parseRetryAfter(value: string | null | undefined, now?: number)
95
95
  * Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
96
96
  * `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
97
97
  * баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
98
- * session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
99
- * баримт үүсээгүй).
98
+ * session); 404: ORG_NOT_FOUND; 403 REPRESENTATION_REVOKED — `POST /pdf/signatures` (session-оос хойш төлөөлөл
99
+ * хасагдсан, бүртгэгдээгүй) ба токены гэрчилгээ олголт (TOKEN_ISSUE).
100
100
  */
101
101
  type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
102
102
  /** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
@@ -116,7 +116,7 @@ declare class NetworkError extends EidError {
116
116
  });
117
117
  }
118
118
  /**
119
- * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
119
+ * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB) — бие таслагдаж задлагдахгүй. `op` — method +
120
120
  * таних тэмдэггүй зам.
121
121
  */
122
122
  declare class ResponseTooLargeError extends EidError {