@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 +35 -20
- package/dist/{browser-BZ3hvv6-.d.ts → browser-BPhROZkH.d.ts} +20 -49
- package/dist/{browser-8k_VDSP8.d.cts → browser-DFnRVCfN.d.cts} +20 -49
- package/dist/browser.cjs +11 -47
- package/dist/browser.d.cts +2 -2
- package/dist/browser.d.ts +2 -2
- package/dist/browser.js +4 -8
- package/dist/chunk-WOWGH65C.js +13 -0
- package/dist/{chunk-TB2KQH3W.js → chunk-Y3JYLJPG.js} +1 -5
- package/dist/{errors-Z7SgLVTr.d.cts → errors-pK1L0s4N.d.cts} +9 -9
- package/dist/{errors-Z7SgLVTr.d.ts → errors-pK1L0s4N.d.ts} +9 -9
- package/dist/index.cjs +13 -53
- package/dist/index.d.cts +9 -7
- package/dist/index.d.ts +9 -7
- package/dist/index.js +15 -19
- package/dist/pades.cjs +341 -46
- package/dist/pades.d.cts +19 -2
- package/dist/pades.d.ts +19 -2
- package/dist/pades.js +342 -47
- package/package.json +1 -1
- package/dist/chunk-REWNE7PO.js +0 -51
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
|
|
10
|
-
>
|
|
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-
|
|
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
|
|
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/*` нь
|
|
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 ~
|
|
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
|
-
|
|
484
|
-
|
|
485
|
-
`
|
|
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.
|
|
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 холбоос
|
|
644
|
-
>
|
|
645
|
-
>
|
|
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
|
|
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
|
|
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-
|
|
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
|
-
/**
|
|
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
|
-
|
|
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-
|
|
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
|
-
/**
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
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
|
-
|
|
80
|
-
|
|
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
|
-
|
|
87
|
-
isMobileUserAgent,
|
|
88
|
-
openOrShowQR
|
|
52
|
+
isMobileUserAgent
|
|
89
53
|
});
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export {
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
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 {
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
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
|
-
|
|
3
|
-
|
|
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-
|
|
7
|
+
} from "./chunk-Y3JYLJPG.js";
|
|
10
8
|
export {
|
|
11
9
|
DeviceLinkError,
|
|
12
10
|
EidError,
|
|
13
|
-
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
|
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`.
|
|
86
|
-
*
|
|
87
|
-
*
|
|
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 = "
|
|
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;
|
|
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
|
|
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
|
-
*
|
|
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
|
|
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`.
|
|
86
|
-
*
|
|
87
|
-
*
|
|
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 = "
|
|
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;
|
|
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
|
|
119
|
+
* Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB) — бие таслагдаж задлагдахгүй. `op` — method +
|
|
120
120
|
* таних тэмдэггүй зам.
|
|
121
121
|
*/
|
|
122
122
|
declare class ResponseTooLargeError extends EidError {
|