@gerege-systems/eid-mongolia-sdk 0.18.2 → 0.19.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/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
- import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, P as PersonBlock, b as RepresentationsResponse, A as AcspContext, F as FlowType } from './browser-CcQqyw_e.js';
2
- export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-CcQqyw_e.js';
3
- import { A as ApiError, H as HttpErrorInit } from './errors-pK1L0s4N.js';
4
- export { a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, R as RETRYABLE_ERROR_CODES, d as RequestInvalidError, e as ResponseTooLargeError, f as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-pK1L0s4N.js';
1
+ import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, P as PersonBlock, b as RepresentationsResponse, A as AcspContext, F as FlowType } from './browser-DBR6ziM5.js';
2
+ export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-DBR6ziM5.js';
5
3
  import { X509Certificate, KeyObject } from 'node:crypto';
4
+ import { A as ApiError, H as HttpErrorInit } from './errors-xTmsGXyo.js';
5
+ export { a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, P as PDF_REGISTER_ERROR_CODES, d as PdfRegisterErrorCode, R as RETRYABLE_ERROR_CODES, e as RequestInvalidError, f as ResponseTooLargeError, g as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-xTmsGXyo.js';
6
6
 
7
7
  interface HttpConfig {
8
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -90,6 +90,8 @@ interface SignDefaults {
90
90
  certificateLevel: CertificateLevel;
91
91
  /** Sign / certificate-choice session-ий `expiresAt`-ийг тооцоолох хугацаа (мс); undefined = 600000. */
92
92
  sessionTtlMs?: number;
93
+ /** registerSignature-ийн HTTP хугацаа (мс); алга бол 80 000. */
94
+ pdfTimeoutMs?: number;
93
95
  }
94
96
  interface SignOptions {
95
97
  certificateLevel?: CertificateLevel;
@@ -294,11 +296,9 @@ declare class SignApi {
294
296
  /**
295
297
  * `POST /pdf/signatures` — `pades.complete()`-ийн дараа CMS-ийг CA-д бүртгэнэ (`/verify/{docID}`, иргэний түүх). PDF
296
298
  * илгээгдэхгүй. SIGN эрх. CA CMS-ийг шалгана: 04-ийн SIGN cert, session digest = SHA-256(signedAttrs), claimedRole ↔
297
- * төлөөлөл. Алдаа (`ApiError.code`; CA `pades_register.go`): 400 `REQUEST_INVALID` / `CMS_INVALID` /
298
- * `SIGNATURE_INVALID` / `TIMESTAMP_INVALID`; 403/404 onBehalfOf-ийн код (`REPRESENTATION_REVOKED` г.м.); 404
299
- * `DOC_NOT_FOUND`; 409 `SIGNER_MISMATCH` / `SIGNER_CERT_INVALID` / `CLAIMED_ROLE_MISMATCH` / `DOC_ID_CONFLICT` /
300
- * `REGISTRY_CONFLICT` / `PRIOR_MISMATCH` / `SESSION_MISMATCH` / `SESSION_NOT_COMPLETE` / `SESSION_FAILED`; 413
301
- * `REQUEST_TOO_LARGE`; 429 `RATE_LIMITED`. Бүртгэлгүй файл ч Adobe/EU DSS-д хүчинтэй — зөвхөн `/verify` «бүртгэлгүй» гэнэ.
299
+ * төлөөлөл. Алдаа: `ApiError.code` / `ForbiddenError.code` ∈ {@link PdfRegisterErrorCode}
300
+ * (`PDF_REGISTER_ERROR_CODES`; CA `pades_register.go`). Бүртгэлгүй файл ч Adobe/EU DSS-д хүчинтэй — зөвхөн `/verify`
301
+ * «бүртгэлгүй» гэнэ.
302
302
  */
303
303
  registerSignature(input: RegisterSignatureInput): Promise<RegisterSignatureResult>;
304
304
  private registerBody;
@@ -529,246 +529,6 @@ declare class PersonApi {
529
529
  children(personEtsi: string): Promise<PersonChildren>;
530
530
  }
531
531
 
532
- interface TokenCertInput {
533
- /** Иргэн (PNOMN-…) — батлах push түүний утсанд очно. */
534
- signerEtsi: string;
535
- /** PKCS#10 DER (EC P-256, ecdsa-with-SHA256, өөр өөр түлхүүр, ≤ 4 KiB). */
536
- csrAuth: Uint8Array;
537
- csrSign: Uint8Array;
538
- /** `[A-Za-z0-9-]{1,64}`. */
539
- tokenSerial: string;
540
- /** Заавал биш (≤ 64). */
541
- tokenLabel?: string;
542
- /** Байгууллагын токен (NTRMN-…); хоосон/алга = хувийн токен. */
543
- onBehalfOf?: string;
544
- }
545
- interface TokenCertStart {
546
- sessionId: string;
547
- /** Иргэнд ХАРУУЛАХ баталгаажуулах код (ПИН биш). */
548
- vc: string | null;
549
- /** hex(SHA-256(CSR DER)) — SDK илгээсэн CSR-тэй тулгасан (жижиг үсэг). */
550
- csrAuthSha256: string;
551
- csrSignSha256: string;
552
- expiresAt?: string;
553
- }
554
- interface TokenCertItem {
555
- /** base64 DER. */
556
- certificate: string;
557
- certificatePem: string;
558
- serialHex: string;
559
- notBefore: string;
560
- notAfter: string;
561
- }
562
- /** GET /token/certificate/{sessionID} (зөвхөн үүсгэсэн RP, 24 цаг идэмпотент). */
563
- interface TokenCertResult {
564
- status: string;
565
- auth: TokenCertItem | null;
566
- sign: TokenCertItem | null;
567
- /** base64 DER: 04, 03, 02 (root-гүй). */
568
- chain: string[];
569
- chainPem: string;
570
- /** Хувийн токенд null. */
571
- organization: TokenOrganization | null;
572
- keyMedium: string;
573
- certificateLevel: string;
574
- raw: unknown;
575
- }
576
- interface TokenAuthChallenge {
577
- challengeId: string;
578
- /** base64 (32 байт). */
579
- challenge: string;
580
- /** CA-ийн холбосон RP (жижиг үсэг) — hash-д ЯГ ЭНЭ мөр орно. */
581
- rpUUID: string;
582
- expiresAt: string;
583
- }
584
- /** CA-ийн баталгаажуулсан иргэн; givenName/surname — KYC бүртгэлээс (кирилл). */
585
- interface TokenIdentity {
586
- etsi: string;
587
- givenName: string;
588
- surname: string;
589
- }
590
- interface TokenAuthResult {
591
- identity: TokenIdentity;
592
- serialHex: string;
593
- notAfter: string;
594
- /** Токен байгууллагад холбогдсон бол; эс бөгөөс null. */
595
- organization: TokenOrganization | null;
596
- raw: unknown;
597
- }
598
- /** 409 TOKEN_LIMIT_REACHED-ийн дэлгэрэнгүй. `limit` 0 = тухайн төрлийн олголт хаалттай. */
599
- interface TokenLimit {
600
- kind: "PERSONAL" | "ORGANIZATION";
601
- limit: number;
602
- /** Зөвхөн ORGANIZATION-д (NTRMN-…). */
603
- organization?: string;
604
- }
605
- /**
606
- * Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
607
- * - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
608
- * - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
609
- * - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
610
- * байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна.
611
- */
612
- type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE";
613
- /** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
614
- declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
615
- /** Discovery (`/.well-known/eid`)-ийн `tokenCertificate` блок. */
616
- interface TokenCertInfo {
617
- enabled: boolean;
618
- /** `POST` олголтын бүтэн URL. */
619
- issue: string;
620
- /** `GET` үр дүнгийн URL template (`{sessionID}`). */
621
- result: string;
622
- /** Шаардлагатай RP эрх (TOKEN_ISSUE). */
623
- permission: string;
624
- certificateLevel: string;
625
- keyAlgorithm: string;
626
- /** `"optional"` — хоосон = хувийн токен. */
627
- onBehalfOf: string;
628
- /**
629
- * true — сунгалт (ижил `tokenSerial` дээр ACTIVE бүртгэлтэй) scope-ийг хадгална; өөр scope бол 409
630
- * `TOKEN_SCOPE_CHANGE`. Хуучин CA-д талбар алга → false.
631
- */
632
- scopeLockedOnRenewal: boolean;
633
- raw: unknown;
634
- }
635
- declare class TokenApi {
636
- private readonly http;
637
- private readonly creds;
638
- constructor(http: Http, creds: RpCredentials);
639
- /**
640
- * POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
641
- * CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
642
- *
643
- * Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
644
- * байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
645
- * 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
646
- * Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
647
- */
648
- issueCertificate(input: TokenCertInput): Promise<TokenCertStart>;
649
- /** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
650
- certificateInfo(): Promise<TokenCertInfo>;
651
- /**
652
- * GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
653
- * {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
654
- * 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
655
- */
656
- certificateResult(sessionId: string): Promise<TokenCertResult>;
657
- /** POST /token/auth/challenge — энэ RP-д холбогдсон нэг удаагийн challenge (2 мин). */
658
- authChallenge(): Promise<TokenAuthChallenge>;
659
- /**
660
- * POST /token/auth/verify — токены AUTH гэрчилгээ (DER) + challenge дээрх түүхий r||s. CA гинж, төлөв, цуцлалт, гарын
661
- * үсгийг шалгана; SDK нэмж endResult === OK ба identity.etsi === гэрчилгээний SERIALNUMBER-ийг тулгана (эс бөгөөс
662
- * ValidationError). Challenge нэг удаагийн — алдааны дараа шинээр авна.
663
- */
664
- authVerify(challengeId: string, certDer: Uint8Array, signature: Uint8Array): Promise<TokenAuthResult>;
665
- }
666
- /**
667
- * Олгосон AUTH/SIGN гэрчилгээ бүр задарч, илгээсэн CSR-ийн public key-тэй (SPKI) ЯГ таарахыг шалгана. Таарахгүй бол
668
- * ValidationError — гэрчилгээг токенд бүү бич.
669
- */
670
- declare function verifyTokenCertificates(result: TokenCertResult, csrAuth: Uint8Array, csrSign: Uint8Array): void;
671
- /**
672
- * Токены зурах 32 байт: SHA-256("eID-TOKEN-AUTH" || rpUUID || challenge) (docs/TOKEN_AUTH.md). `rpUUID` — challenge
673
- * хариуны `rpUUID` (жижиг үсэг, 36), `challengeB64` — 32 байт base64. Токен үүнийг CKM_ECDSA-аар зурж, түүхий r||s
674
- * (64 байт)-ийг authVerify-д өгнө.
675
- */
676
- declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
677
- /**
678
- * err нь 409 TOKEN_LIMIT_REACHED бол түүний `{kind, limit, organization}`. Гэрээнээс гадуур хэлбэр бол undefined —
679
- * татгалзал хүчинтэй хэвээр, дэлгэрэнгүйгүй.
680
- */
681
- declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
682
-
683
- /** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
684
- declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
685
- /** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
686
- interface ShareInput {
687
- /** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
688
- file: Blob | Uint8Array | ArrayBuffer;
689
- /**
690
- * Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
691
- * нэр, байхгүй бол `document.pdf`.
692
- */
693
- filename?: string;
694
- /** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
695
- to: string | readonly string[];
696
- /** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
697
- subject?: string;
698
- /** Илгээгчийн тэмдэглэл (≤ 1000). */
699
- message?: string;
700
- /** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
701
- lang?: "mn" | "en";
702
- /** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
703
- timeoutMs?: number;
704
- }
705
- /** 200 хариу. */
706
- interface ShareResult {
707
- /** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
708
- sent: number;
709
- /** Файлын SHA-256 (hex). */
710
- sha256: string;
711
- /** Хүчинтэй eID гарын үсгийн тоо. */
712
- signatures: number;
713
- /** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
714
- docID?: string;
715
- raw: unknown;
716
- }
717
- /** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
718
- type ShareErrorCode = "REQUEST_INVALID" | "FILE_EMPTY" | "RECIPIENT_REQUIRED" | "TOO_MANY_RECIPIENTS" | "RECIPIENT_INVALID" | "RECIPIENT_DUPLICATE" | "FILE_TOO_LARGE" | "FILE_TYPE_NOT_SUPPORTED" | "FILE_NOT_SIGNED" | "RATE_LIMITED" | "MAIL_FAILED" | "SHARE_DISABLED" | "MAIL_UNAVAILABLE" | "VALIDATOR_UNAVAILABLE" | "VALIDATOR_BUSY";
719
- /** {@link ShareErrorCode}-ийн бүх утга. */
720
- declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
721
- /** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
722
- type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
723
- /**
724
- * `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
725
- * ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
726
- * (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
727
- * SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
728
- * undefined.
729
- */
730
- declare class ShareError extends ApiError {
731
- /** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
732
- readonly reason?: ShareNotSignedReason | string;
733
- /** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
734
- readonly sent?: number;
735
- /** 502 MAIL_FAILED: амжилтгүй тоо. */
736
- readonly failed?: number;
737
- /**
738
- * 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
739
- * бүү илгээ).
740
- */
741
- readonly recipients?: readonly string[];
742
- constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
743
- }
744
- /** Discovery (`/.well-known/eid`)-ийн `share` блок. */
745
- interface ShareInfo {
746
- /** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
747
- enabled: boolean;
748
- endpoint: string;
749
- formats: {
750
- name: string;
751
- extension: string;
752
- mime: string;
753
- }[];
754
- languages: string[];
755
- maxFileBytes: number;
756
- maxFilenameChars: number;
757
- maxMessageChars: number;
758
- maxRecipients: number;
759
- maxSubjectChars: number;
760
- /** Шаардлагатай RP эрх (SIGN). */
761
- permission: string;
762
- /** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
763
- quota: {
764
- perRPHour: number;
765
- perRPDay: number;
766
- perRecipientDay: number;
767
- };
768
- requiresValidSignature: boolean;
769
- raw: unknown;
770
- }
771
-
772
532
  /** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
773
533
  interface CertSubject {
774
534
  /** 2.5.4.42 GIVENNAME. */
@@ -882,6 +642,17 @@ type RevocationOutcome = "good" | "unchecked" | "skipped";
882
642
  * гаргадаг цорын ганц CA. `TrustConfig.allowedIssuerSkis`-д.
883
643
  */
884
644
  declare const CITIZEN_ISSUING_CA_SKI = "b8a37f2c64ad677912db7d9e34f246358a2fb909";
645
+ /**
646
+ * Mongolian National Root CA (01) — итгэлийн тулгуур (`TrustConfig.trustAnchorsPem`). Нийтийн эх:
647
+ * https://ca.eidmongolia.mn/pki/mongolian-national-root-ca.cer. Go SDK `eid.NationalRootCAPEM`-тэй ижил.
648
+ */
649
+ declare const NATIONAL_ROOT_CA_PEM: string;
650
+ /**
651
+ * Иргэний гэрчилгээний завсрын CA-ууд: 02 National Issuing CA (MDDC) → 03 Gerege Issuing CA → 04 eID Mongolia Issuing
652
+ * CA. RP-API хариунд гинж ирдэггүй — `TrustConfig.intermediatesPem` өгөөгүй бол (0.19.0-аас) эдгээрийг анхдагчаар
653
+ * хэрэглэнэ. Go SDK `eid.CitizenIntermediatesPEM`-тэй ижил.
654
+ */
655
+ declare const CITIZEN_INTERMEDIATES_PEM: readonly string[];
885
656
  type RevocationChecker = (cert: X509Certificate, issuer: X509Certificate | undefined) => Promise<RevocationStatus>;
886
657
  interface TrustConfig {
887
658
  /**
@@ -890,7 +661,7 @@ interface TrustConfig {
890
661
  * үл тоомсорлоно — зөвхөн dev/тест).
891
662
  */
892
663
  trustAnchorsPem?: string[];
893
- /** Intermediate CA PEM-үүд (leaf ↔ root хооронд). */
664
+ /** Intermediate CA PEM-үүд (leaf ↔ root хооронд). Алга бол {@link CITIZEN_INTERMEDIATES_PEM} (02, 03, 04; 0.19.0-аас). */
894
665
  intermediatesPem?: string[];
895
666
  /** Шаардах certLevel (default QUALIFIED). ADVANCED тохируулбал доод түвшин зөвшөөрнө. */
896
667
  requiredLevel?: CertificateLevel;
@@ -912,14 +683,21 @@ interface TrustConfig {
912
683
  */
913
684
  revocationMode?: "hard-fail" | "soft-fail";
914
685
  /**
915
- * Иргэний гэрчилгээг шууд гаргасан CA-ийн Subject Key Identifier (hex, ":" зөвшөөрнө) жагсаалт. Хоосон/алга бол trust
916
- * anchor хүртэл гинжлэгдсэн дурын CA зөвшөөрөгдөнө (хуучин зан). Ижил root-ийн доорх өөр CA (ж: байгууллагын Issuing
917
- * CA) иргэний гэрчилгээ гаргахаас хамгаалахад: `[CITIZEN_ISSUING_CA_SKI]`.
686
+ * Иргэний гэрчилгээг шууд гаргасан CA-ийн Subject Key Identifier (hex, ":" зөвшөөрнө) жагсаалт. **0.19.0-аас анхдагч
687
+ * `[CITIZEN_ISSUING_CA_SKI]`** (trust anchor тохируулсан үед) — ижил root-ийн доорх өөр CA (ж: байгууллагын Issuing CA)
688
+ * иргэний гэрчилгээ гаргахаас хамгаална. Өгвөл энэ жагсаалтаар солино (үргэлж шалгана, `allowUntrusted` үед ч).
689
+ * Дурын issuer-ийг зөвшөөрөх бол {@link allowAnyIssuer}.
918
690
  */
919
691
  allowedIssuerSkis?: string[];
920
692
  /**
921
- * true бол гэрчилгээний зориулалтыг CA-ийн профайлаар шалгана: auth → KeyUsage digitalSignature + ExtKeyUsage
922
- * clientAuth (P-CITIZEN-AUTH); sign → KeyUsage contentCommitment / nonRepudiation (P-CITIZEN-SIGN). Анхдагч false.
693
+ * true бол анхдагч issuer allowlist-ийг (`[CITIZEN_ISSUING_CA_SKI]`) унтраана — trust anchor хүртэл гинжлэгдсэн дурын CA
694
+ * (0.18.x-ийн зан). `allowedIssuerSkis` өгсөн бол түүнийг шалгасаар байна. Тест/dev, эсвэл өөр Issuing CA-тай орчинд л.
695
+ */
696
+ allowAnyIssuer?: boolean;
697
+ /**
698
+ * Гэрчилгээний зориулалтыг CA-ийн профайлаар шалгана: auth → KeyUsage digitalSignature + ExtKeyUsage clientAuth
699
+ * (P-CITIZEN-AUTH); sign → KeyUsage contentCommitment / nonRepudiation (P-CITIZEN-SIGN). **0.19.0-аас анхдагч true**
700
+ * — нэвтрэлтийн (PIN1) түлхүүрийн гарын үсэг `validateSign`-д тэнцэхгүй. `false` — шалгахгүй (хуучин зан, зөвлөхгүй).
923
701
  */
924
702
  checkKeyUsage?: boolean;
925
703
  /** ACSP_V2 payload-ийн scheme нэр (CA-ийн `capabilities.acsp_scheme_name`); анхдагч "smart-id". */
@@ -934,6 +712,10 @@ interface VerifiedIdentity {
934
712
  subject: string;
935
713
  /** Subject-ийн задалсан талбарууд (нэр, ETSI `serialNumber`, улс) — {@link parseSubject}. */
936
714
  parsedSubject: CertSubject;
715
+ /**
716
+ * Үнэлэгдсэн түвшин: хариуны `certificateLevel` ба гэрчилгээнээс тогтоосон түвшний ({@link certificateLevelOf}) бага
717
+ * нь. Хариу гэрчилгээнээс өндөр түвшин зарлавал ValidationError.
718
+ */
937
719
  certificateLevel: string;
938
720
  }
939
721
  /** Баталгаажсан гарын үсэг (sign). */
@@ -945,6 +727,8 @@ interface VerifiedSignature {
945
727
  subject: string;
946
728
  /** Subject-ийн задалсан талбарууд — {@link parseSubject}. */
947
729
  parsedSubject: CertSubject;
730
+ /** Үнэлэгдсэн түвшин ({@link VerifiedIdentity.certificateLevel}-тэй ижил дүрэм; гарын үсгийн гэрчилгээнд qcStatements). */
731
+ certificateLevel: string;
948
732
  }
949
733
  declare class ResponseValidator {
950
734
  private readonly anchors;
@@ -995,6 +779,14 @@ declare class ResponseValidator {
995
779
  private sessionDone;
996
780
  /** Хариуны гэрчилгээ: documentNumber, задлалт, хугацаа, certLevel, зориулалт (protocol), гинж, issuer. */
997
781
  private leafOf;
782
+ /**
783
+ * Токены нэвтрэлтийн гэрчилгээ ({@link TokenApi.authVerify}) — хугацаа, зориулалт (auth), гинж, issuer. Түвшинг
784
+ * шалгахгүй (USB токен ADVANCED).
785
+ * @internal
786
+ */
787
+ verifyTokenAuthCertificate(leaf: X509Certificate): void;
788
+ /** Зориулалт (protocol), гинж, issuer — хугацаа/түвшнийг дуудагч шалгасан. */
789
+ private verifyCertificate;
998
790
  /**
999
791
  * checkKeyUsage үед гэрчилгээний зориулалт протоколд тохирох эсэх (CA crypto/ca_profile.go): ACSP_V2 (auth) → KU
1000
792
  * digitalSignature + EKU clientAuth (эсвэл anyExtendedKeyUsage); RAW_DIGEST_SIGNATURE (sign) → KU contentCommitment.
@@ -1040,6 +832,263 @@ declare function userChallengeOf(verifier: string): string;
1040
832
  declare function verifyPayloadSignature(payload: Buffer, sigB64: string, key: KeyObject, alg: string, hash: string): boolean;
1041
833
  /** Prehashed digest (sign) дээрх гарын үсэг. RSA: raw public op + EMSA-PSS-VERIFY / PKCS#1 DigestInfo. */
1042
834
  declare function verifyPrehashedSignature(digest: Buffer, sigB64: string, key: KeyObject, alg: string, hash: string): boolean;
835
+ /**
836
+ * Гэрчилгээнээс тогтоох түвшин (CA `crypto/ca_profile.go`): qcStatements-д QcCompliance → QUALIFIED (+ QcSSCD →
837
+ * QSCD); qcStatements алга бол — гарын үсгийн гэрчилгээ ADVANCED (USB токен), нэвтрэлтийн гэрчилгээ (CA AUTH-д
838
+ * qcStatements бичдэггүй) KeyUsage-аар: keyEncipherment-тэй (утасны P-CITIZEN-AUTH) → QUALIFIED, үгүй (токены
839
+ * P-CITIZEN-AUTH-TOKEN) → ADVANCED. `protocol` — "ACSP_V2" (auth) эсвэл "RAW_DIGEST_SIGNATURE" (sign).
840
+ */
841
+ declare function certificateLevelOf(cert: X509Certificate, protocol: string): CertificateLevel;
842
+
843
+ interface TokenCertInput {
844
+ /** Иргэн (PNOMN-…) — батлах push түүний утсанд очно. */
845
+ signerEtsi: string;
846
+ /** PKCS#10 DER (EC P-256, ecdsa-with-SHA256, өөр өөр түлхүүр, ≤ 4 KiB). */
847
+ csrAuth: Uint8Array;
848
+ csrSign: Uint8Array;
849
+ /** `[A-Za-z0-9-]{1,64}`. */
850
+ tokenSerial: string;
851
+ /** Заавал биш (≤ 64). */
852
+ tokenLabel?: string;
853
+ /** Байгууллагын токен (NTRMN-…); хоосон/алга = хувийн токен. */
854
+ onBehalfOf?: string;
855
+ }
856
+ interface TokenCertStart {
857
+ sessionId: string;
858
+ /** Иргэнд ХАРУУЛАХ баталгаажуулах код (ПИН биш). */
859
+ vc: string | null;
860
+ /** hex(SHA-256(CSR DER)) — SDK илгээсэн CSR-тэй тулгасан (жижиг үсэг). */
861
+ csrAuthSha256: string;
862
+ csrSignSha256: string;
863
+ expiresAt?: string;
864
+ }
865
+ interface TokenCertItem {
866
+ /** base64 DER. */
867
+ certificate: string;
868
+ certificatePem: string;
869
+ serialHex: string;
870
+ notBefore: string;
871
+ notAfter: string;
872
+ }
873
+ /** GET /token/certificate/{sessionID} (зөвхөн үүсгэсэн RP, 24 цаг идэмпотент). */
874
+ interface TokenCertResult {
875
+ status: string;
876
+ auth: TokenCertItem | null;
877
+ sign: TokenCertItem | null;
878
+ /** base64 DER: 04, 03, 02 (root-гүй). */
879
+ chain: string[];
880
+ chainPem: string;
881
+ /** Хувийн токенд null. */
882
+ organization: TokenOrganization | null;
883
+ keyMedium: string;
884
+ certificateLevel: string;
885
+ raw: unknown;
886
+ }
887
+ interface TokenAuthChallenge {
888
+ challengeId: string;
889
+ /** base64 (32 байт). */
890
+ challenge: string;
891
+ /** CA-ийн холбосон RP (жижиг үсэг) — hash-д ЯГ ЭНЭ мөр орно. */
892
+ rpUUID: string;
893
+ expiresAt: string;
894
+ }
895
+ /** CA-ийн баталгаажуулсан иргэн; givenName/surname — KYC бүртгэлээс (кирилл). */
896
+ interface TokenIdentity {
897
+ etsi: string;
898
+ givenName: string;
899
+ surname: string;
900
+ }
901
+ interface TokenAuthResult {
902
+ identity: TokenIdentity;
903
+ serialHex: string;
904
+ notAfter: string;
905
+ /** Токен байгууллагад холбогдсон бол; эс бөгөөс null. */
906
+ organization: TokenOrganization | null;
907
+ raw: unknown;
908
+ }
909
+ /** 409 TOKEN_LIMIT_REACHED-ийн дэлгэрэнгүй. `limit` 0 = тухайн төрлийн олголт хаалттай. */
910
+ interface TokenLimit {
911
+ kind: "PERSONAL" | "ORGANIZATION";
912
+ limit: number;
913
+ /** Зөвхөн ORGANIZATION-д (NTRMN-…). */
914
+ organization?: string;
915
+ }
916
+ /**
917
+ * Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
918
+ * - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
919
+ * - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
920
+ * - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
921
+ * байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна.
922
+ */
923
+ type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE";
924
+ /** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
925
+ declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
926
+ /** Discovery (`/.well-known/eid`)-ийн `tokenCertificate` блок. */
927
+ interface TokenCertInfo {
928
+ enabled: boolean;
929
+ /** `POST` олголтын бүтэн URL. */
930
+ issue: string;
931
+ /** `GET` үр дүнгийн URL template (`{sessionID}`). */
932
+ result: string;
933
+ /** Шаардлагатай RP эрх (TOKEN_ISSUE). */
934
+ permission: string;
935
+ certificateLevel: string;
936
+ keyAlgorithm: string;
937
+ /** `"optional"` — хоосон = хувийн токен. */
938
+ onBehalfOf: string;
939
+ /**
940
+ * true — сунгалт (ижил `tokenSerial` дээр ACTIVE бүртгэлтэй) scope-ийг хадгална; өөр scope бол 409
941
+ * `TOKEN_SCOPE_CHANGE`. Хуучин CA-д талбар алга → false.
942
+ */
943
+ scopeLockedOnRenewal: boolean;
944
+ raw: unknown;
945
+ }
946
+ declare class TokenApi {
947
+ private readonly http;
948
+ private readonly creds;
949
+ /** authVerify-ийн гэрчилгээний шалгалт (EidClient-ийн `trust`). */
950
+ private readonly validator;
951
+ constructor(http: Http, creds: RpCredentials,
952
+ /** authVerify-ийн гэрчилгээний шалгалт (EidClient-ийн `trust`). */
953
+ validator: ResponseValidator);
954
+ /**
955
+ * POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
956
+ * CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
957
+ *
958
+ * Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
959
+ * байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
960
+ * 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
961
+ * Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
962
+ */
963
+ issueCertificate(input: TokenCertInput): Promise<TokenCertStart>;
964
+ /** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
965
+ certificateInfo(): Promise<TokenCertInfo>;
966
+ /**
967
+ * GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
968
+ * {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
969
+ * 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
970
+ */
971
+ certificateResult(sessionId: string): Promise<TokenCertResult>;
972
+ /** POST /token/auth/challenge — энэ RP-д холбогдсон нэг удаагийн challenge (2 мин). */
973
+ authChallenge(): Promise<TokenAuthChallenge>;
974
+ /**
975
+ * POST /token/auth/verify — токены AUTH гэрчилгээ (DER) + challenge дээрх түүхий r||s (64 байт).
976
+ *
977
+ * **0.19.0-аас SDK CA-ийн OK-д дангаар итгэхгүй** (бусад auth-тай ижил): CA руу илгээхээс өмнө `challenge.rpUUID` ===
978
+ * энэ RP, гарын үсэг {@link tokenAuthDigest}`(challenge.rpUUID, challenge.challenge)` дээр гэрчилгээний түлхүүрээр
979
+ * (EC P-256) таарах, гэрчилгээ `trust`-аар (хугацаа, зориулалт auth, гинж, issuer allowlist — {@link ResponseValidator})
980
+ * хүчинтэйг шалгана; дараа нь CA-ийн endResult === OK ба identity.etsi === гэрчилгээний SERIALNUMBER. Эс бөгөөс
981
+ * ValidationError. Цуцлалтыг (OCSP) CA шалгана; RP нэмж `validator.checkRevocation(cert)` дуудаж болно.
982
+ * `challenge` — {@link authChallenge}-ийн хариу (RP хадгалсан, эсвэл клиентээс буцаж ирсэн — CA challengeId-ээр
983
+ * тулгана). Challenge нэг удаагийн — алдааны дараа шинээр авна.
984
+ */
985
+ authVerify(challenge: TokenAuthChallenge, certDer: Uint8Array, signature: Uint8Array): Promise<TokenAuthResult>;
986
+ }
987
+ /**
988
+ * Олгосон AUTH/SIGN гэрчилгээ бүр задарч, илгээсэн CSR-ийн public key-тэй (SPKI) ЯГ таарахыг шалгана. Таарахгүй бол
989
+ * ValidationError — гэрчилгээг токенд бүү бич.
990
+ */
991
+ declare function verifyTokenCertificates(result: TokenCertResult, csrAuth: Uint8Array, csrSign: Uint8Array): void;
992
+ /**
993
+ * Токены зурах 32 байт: SHA-256("eID-TOKEN-AUTH" || rpUUID || challenge) (docs/TOKEN_AUTH.md). `rpUUID` — challenge
994
+ * хариуны `rpUUID` (жижиг үсэг, 36), `challengeB64` — 32 байт base64. Токен үүнийг CKM_ECDSA-аар зурж, түүхий r||s
995
+ * (64 байт)-ийг authVerify-д өгнө.
996
+ */
997
+ declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
998
+ /**
999
+ * err нь 409 TOKEN_LIMIT_REACHED бол түүний `{kind, limit, organization}`. Гэрээнээс гадуур хэлбэр бол undefined —
1000
+ * татгалзал хүчинтэй хэвээр, дэлгэрэнгүйгүй.
1001
+ */
1002
+ declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
1003
+
1004
+ /** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
1005
+ declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
1006
+ /** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
1007
+ interface ShareInput {
1008
+ /** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
1009
+ file: Blob | Uint8Array | ArrayBuffer;
1010
+ /**
1011
+ * Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
1012
+ * нэр, байхгүй бол `document.pdf`.
1013
+ */
1014
+ filename?: string;
1015
+ /** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
1016
+ to: string | readonly string[];
1017
+ /** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
1018
+ subject?: string;
1019
+ /** Илгээгчийн тэмдэглэл (≤ 1000). */
1020
+ message?: string;
1021
+ /** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
1022
+ lang?: "mn" | "en";
1023
+ /** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
1024
+ timeoutMs?: number;
1025
+ }
1026
+ /** 200 хариу. */
1027
+ interface ShareResult {
1028
+ /** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
1029
+ sent: number;
1030
+ /** Файлын SHA-256 (hex). */
1031
+ sha256: string;
1032
+ /** Хүчинтэй eID гарын үсгийн тоо. */
1033
+ signatures: number;
1034
+ /** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
1035
+ docID?: string;
1036
+ raw: unknown;
1037
+ }
1038
+ /** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
1039
+ type ShareErrorCode = "REQUEST_INVALID" | "FILE_EMPTY" | "RECIPIENT_REQUIRED" | "TOO_MANY_RECIPIENTS" | "RECIPIENT_INVALID" | "RECIPIENT_DUPLICATE" | "FILE_TOO_LARGE" | "FILE_TYPE_NOT_SUPPORTED" | "FILE_NOT_SIGNED" | "RATE_LIMITED" | "MAIL_FAILED" | "SHARE_DISABLED" | "MAIL_UNAVAILABLE" | "VALIDATOR_UNAVAILABLE" | "VALIDATOR_BUSY";
1040
+ /** {@link ShareErrorCode}-ийн бүх утга. */
1041
+ declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
1042
+ /** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
1043
+ type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
1044
+ /**
1045
+ * `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
1046
+ * ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
1047
+ * (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
1048
+ * SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
1049
+ * undefined.
1050
+ */
1051
+ declare class ShareError extends ApiError {
1052
+ /** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
1053
+ readonly reason?: ShareNotSignedReason | string;
1054
+ /** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
1055
+ readonly sent?: number;
1056
+ /** 502 MAIL_FAILED: амжилтгүй тоо. */
1057
+ readonly failed?: number;
1058
+ /**
1059
+ * 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
1060
+ * бүү илгээ).
1061
+ */
1062
+ readonly recipients?: readonly string[];
1063
+ constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
1064
+ }
1065
+ /** Discovery (`/.well-known/eid`)-ийн `share` блок. */
1066
+ interface ShareInfo {
1067
+ /** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
1068
+ enabled: boolean;
1069
+ endpoint: string;
1070
+ formats: {
1071
+ name: string;
1072
+ extension: string;
1073
+ mime: string;
1074
+ }[];
1075
+ languages: string[];
1076
+ maxFileBytes: number;
1077
+ maxFilenameChars: number;
1078
+ maxMessageChars: number;
1079
+ maxRecipients: number;
1080
+ maxSubjectChars: number;
1081
+ /** Шаардлагатай RP эрх (SIGN). */
1082
+ permission: string;
1083
+ /** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
1084
+ quota: {
1085
+ perRPHour: number;
1086
+ perRPDay: number;
1087
+ perRecipientDay: number;
1088
+ };
1089
+ requiresValidSignature: boolean;
1090
+ raw: unknown;
1091
+ }
1043
1092
 
1044
1093
  interface ClientConfig {
1045
1094
  /**
@@ -1053,6 +1102,11 @@ interface ClientConfig {
1053
1102
  defaultCertificateLevel?: CertificateLevel;
1054
1103
  /** HTTP timeout (мс). */
1055
1104
  timeoutMs?: number;
1105
+ /**
1106
+ * `registerSignature` (`POST /pdf/signatures`)-ийн хугацаа (мс). Анхдагч {@link DEFAULT_PDF_TIMEOUT_MS} (80 с — CA CMS +
1107
+ * TSA + LTV-г шалгадаг; nginx proxy_read_timeout-оос бага; Go SDK `Config.PDFTimeout`-тэй ижил). 0.18.x-д ердийн 15 с.
1108
+ */
1109
+ pdfTimeoutMs?: number;
1056
1110
  /** undici Dispatcher (mTLS client cert). */
1057
1111
  dispatcher?: unknown;
1058
1112
  /** fetch орлуулагч (тест). */
@@ -1073,6 +1127,8 @@ interface ClientConfig {
1073
1127
  }
1074
1128
  /** RP-API-ийн албан ёсны хост (2026-09-28-наас бүх RP, /v3-гүй). */
1075
1129
  declare const DEFAULT_BASE_URL = "https://rp.eidmongolia.mn";
1130
+ /** `registerSignature`-ийн анхдагч хугацаа (мс) — Go SDK `DefaultPDFTimeout` (80s)-тэй ижил. */
1131
+ declare const DEFAULT_PDF_TIMEOUT_MS = 80000;
1076
1132
  /** baseUrl-ийг шалгаж, төгсгөлийн "/"-ийг хасна. */
1077
1133
  declare function resolveBaseUrl(baseUrl: string | undefined): string;
1078
1134
  declare class EidClient {
@@ -1294,8 +1350,18 @@ interface EidLoginStore {
1294
1350
  /** Устгана; байсан бол true. Амжилтыг нэг л удаа гаргахад ашиглана (атомар байх ёстой — Redis `DEL`). */
1295
1351
  delete(sessionId: string): Promise<boolean> | boolean;
1296
1352
  }
1297
- /** Нэг процессын санах ойн сан (TTL-тэй). Олон instance / serverless-д тохирохгүй. */
1298
- declare function memoryLoginStore(): EidLoginStore;
1353
+ /** {@link memoryLoginStore}-ийн анхдагч дээд хэмжээ (идэвхтэй нэвтрэлт). */
1354
+ declare const MEMORY_LOGIN_STORE_MAX = 10000;
1355
+ /** Санах ойн сан дүүрсэн (хугацаа нь дуусаагүй `max` нэвтрэлт) — start 503 `busy`. */
1356
+ declare class LoginStoreFullError extends Error {
1357
+ constructor();
1358
+ }
1359
+ /**
1360
+ * Нэг процессын санах ойн сан (TTL-тэй). Олон instance / serverless-д тохирохгүй. Хэмжээ `max`-аар (анхдагч
1361
+ * {@link MEMORY_LOGIN_STORE_MAX}) хязгаарлагдана: дүүрвэл хугацаа дууссаныг цэвэрлээд, хоосроогүй бол ШИНЭ нэвтрэлтийг
1362
+ * {@link LoginStoreFullError}-оор татгалзана — эхэлсэн нэвтрэлтүүдийг хэзээ ч устгахгүй (хуучныг шахаж гаргахгүй).
1363
+ */
1364
+ declare function memoryLoginStore(max?: number): EidLoginStore;
1299
1365
  /** Хүсэлтийн хүрээ — onSuccess / rateLimit / onError-д. */
1300
1366
  interface EidLoginContext {
1301
1367
  request: EidLoginRequest;
@@ -1340,7 +1406,11 @@ interface EidLoginRateLimits {
1340
1406
  start?: EidLoginRateRule;
1341
1407
  push?: EidLoginRateRule;
1342
1408
  }
1343
- /** Анхдагч хязгаар — `rateLimit`-ийн объектод өгөөгүй төрөл энүүгээр үлдэнэ. `{ ...defaultRateLimit, start: … }`. */
1409
+ /**
1410
+ * Анхдагч хязгаар — `rateLimit`-ийн объектод өгөөгүй төрөл энүүгээр үлдэнэ. `{ ...defaultRateLimit, start: … }`.
1411
+ * push: нэг дугаарт 60 секундэд 3 (MFA fatigue); start (0.19.0-аас): нэг IP-ээс 60 секундэд 20 (ip мэдэгдэж байвал —
1412
+ * `req.ip` / `trustProxy`).
1413
+ */
1344
1414
  declare const defaultRateLimit: Readonly<EidLoginRateLimits>;
1345
1415
  interface EidLoginOptions {
1346
1416
  client: EidClient;
@@ -1374,7 +1444,8 @@ interface EidLoginOptions {
1374
1444
  };
1375
1445
  /**
1376
1446
  * Хязгаарлалт. Түлхүүр: `start:<ip>` (ip мэдэгдэж байвал), `push:<idCode>`; false → 429.
1377
- * Анхдагч {@link defaultRateLimit}: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — MFA fatigue-ээс.
1447
+ * Анхдагч {@link defaultRateLimit}: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — MFA fatigue-ээс; start-д нэг IP-ээс
1448
+ * 60 секундэд 20 (0.19.0-аас).
1378
1449
  *
1379
1450
  * - Объект `{ start?, push? }` — анхдагчтай НЭГТГЭГДЭНЭ: өгсөн төрөл анхдагчийг дарна, өгөөгүй нь анхдагчаараа.
1380
1451
  * Утга: `{ limit, windowMs }` (санах ойн гулсах цонх), функц (Redis г.м.) эсвэл `false` (тухайн төрлийг хязгаарлахгүй).
@@ -1469,4 +1540,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1469
1540
  */
1470
1541
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1471
1542
 
1472
- export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
1543
+ export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_PDF_TIMEOUT_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, LoginStoreFullError, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, certificateLevelOf, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };