@gerege-systems/eid-mongolia-sdk 0.15.0 → 0.15.2

package/dist/index.d.cts

@@ -25,6 +25,11 @@ declare class Http {
     private readonly cfg;
     constructor(cfg: HttpConfig);
     post(path: string, body: unknown, timeoutMs?: number): Promise<unknown>;
+    /** {@link post} + HTTP статус (201 / 200-г ялгах: `POST /pdf/signatures`). */
+    postWithStatus(path: string, body: unknown, timeoutMs?: number): Promise<{
+        status: number;
+        body: unknown;
+    }>;
     get(path: string, timeoutMs?: number): Promise<unknown>;
     private json;
     private send;
@@ -187,11 +192,26 @@ interface RegisterSignatureInput {
     priorCmsSha256?: string[];
     /** Горим A-ийн (CA угсарсан) өмнөх гарын үсгүүдийн revision SHA-256. `priorCmsSha256`-тай нийлээд = `revIndex − 1`. */
     priorRevisionSha256?: string[];
+    /**
+     * SDK-д л (CA руу илгээхгүй): өмнөх гарын үсэг бүрийн хоёр түлхүүр, баримтын дарааллаар — {@link registrationFromCompleted}
+     * бөглөнө. CA өмнөх мөр бүрийг өөрийнх нь түлхүүрээр таньдаг (клиент талын мөр — CMS, горим A — revision), файлаас аль
+     * нь болохыг ялгах боломжгүй. Тиймээс `registerSignature` эхлээд бүгдийг CMS-ээр илгээж, 409 `PRIOR_MISMATCH` бол
+     * эхний k-г revision-оор (горим A нь клиент талынхаас өмнө), өмнөх нь ≤ 4 бол бүх хослолыг оролдоно.
+     * `priorRevisionSha256`-г гараар өгсөн бол оролдохгүй.
+     */
+    priorSignatures?: PriorSignature[];
     /** Байгууллагын нэрийн өмнөөс (`NTRMN-…`) — session-ийнхтэй ижил. */
     onBehalfOf?: string;
     /** Заавал биш (`PNOMN-…`): ирвэл CMS-ийн зурагчийн SERIALNUMBER-тэй тэнцүү (эс бөгөөс 409 `SIGNER_MISMATCH`). */
     signerEtsi?: string;
 }
+/** Өмнөх нэг гарын үсгийн хоёр түлхүүр ({@link RegisterSignatureInput.priorSignatures}). */
+interface PriorSignature {
+    /** CMS DER-ийн SHA-256 (hex) — клиент талын мөр. */
+    cmsSha256: string;
+    /** `sha256(doc[0 : ByteRange[2]+ByteRange[3]])` (hex) — горим A-ийн мөр (CA `sig_rev_sha256`). */
+    revisionSha256: string;
+}
 /** {@link registrationFromCompleted}-д хэрэгтэй `pades.complete()`-ийн хэсэг (JSON-оор дамжсан бол `cms` нь base64). */
 interface CompletedForRegistration {
     docId: string;
@@ -203,6 +223,8 @@ interface CompletedForRegistration {
     sigRevSha256: string;
     outSha256: string;
     priorCmsSha256: string[];
+    /** `complete().priorRevisionSha256` (0.15.2+) — байвал `priorSignatures` бөглөгдөж горим A-ийн өмнөх мөрийг SDK өөрөө тааруулна. */
+    priorRevisionSha256?: string[];
 }
 /**
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
@@ -217,6 +239,8 @@ interface RegisterSignatureResult {
     registeredAt: string;
     /** Нийтийн шалгах хуудас (`https://ca.eidmongolia.mn/verify/<docID>`). */
     verifyUrl: string;
+    /** true — 201 (шинээр бүртгэв); false — 200 (ижил биеийн идэмпотент давталт, анхны хариу). */
+    created: boolean;
     raw: unknown;
 }
 /**
@@ -860,6 +884,11 @@ declare class ResponseValidator {
      * "skipped" (hook алга). "revoked", мөн hard-fail горимд "unknown" → ValidationError; hook-ийн алдаа дамжина.
      */
     checkRevocationStatus(cert: X509Certificate): Promise<RevocationOutcome>;
+    /**
+     * {@link checkRevocationStatus}-тэй ижил, гэхдээ TrustConfig-ийн биш өгсөн checker ба горимоор (issuer-ийг trust
+     * pool-оос олно). checker алга бол "skipped"; горим анхдагч "hard-fail".
+     */
+    checkRevocationWith(cert: X509Certificate, checker: RevocationChecker | undefined, mode?: "hard-fail" | "soft-fail"): Promise<RevocationOutcome>;
 }
 /** Payload (auth) дээрх гарын үсэг — алгоритмаар салаалж node:crypto verify. */
 /** Smart-ID: userChallenge = BASE64URL(SHA-256(UTF-8(userChallengeVerifier))), padding-гүй. */
@@ -926,6 +955,27 @@ declare class EidClient {
  */
 declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
 
+interface OcspCheckerOptions {
+    /** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
+    fetchImpl?: typeof fetch;
+    /** Нэг асуултын хугацаа (мс). Анхдагч 2000 — иргэн poll дээр хүлээж байна. */
+    timeoutMs?: number;
+    /** Цаг (мс, тест). Анхдагч Date.now. */
+    now?: () => number;
+}
+/**
+ * AIA OCSP-оор цуцлалт шалгагч ({@link RevocationChecker}):
+ *
+ * - good → "good" (5 мин кэшлэнэ);
+ * - revoked, мөн unknown (олгогч энэ serial-ийг олгоогүй — өөр хэн нэгний хийсэн гэрчилгээ) → "revoked";
+ * - хариугүй (AIA алга, issuer олдоогүй, timeout, HTTP ≠ 200, гарын үсэг/serial/хугацаа таараагүй) → "unknown" —
+ *   `revocationMode` шийднэ: soft-fail — зөвшөөрнө ("unchecked"), hard-fail — татгалзана.
+ *
+ * Хариуг олгогч эсвэл олгогчийн id-kp-OCSPSigning EKU-тэй (одоо хүчинтэй) responder зурсан, энэ serial-ийн тухай,
+ * thisUpdate ∈ [now−48ц, now+5мин], nextUpdate өнгөрөөгүй байх ёстой.
+ */
+declare function ocspRevocationChecker(opts?: OcspCheckerOptions): RevocationChecker;
+
 /** SHA-256 digest, base64. Текст эсвэл байтаас. Sign flow-ийн baримтын digest үүсгэхэд. */
 declare function sha256Base64(data: string | Uint8Array): string;
 /** Санамсаргүй RP challenge (default 64 байт), base64. Auth flow-д replay-ээс хамгаална. */
@@ -1051,6 +1101,11 @@ interface EidLoginIdentity {
     flowType: FlowType;
     /** Session-ийн `person` блок (кирилл нэр г.м.) — гэрчилгээтэй таарсан үед л, эс бөгөөс null. */
     person: PersonBlock | null;
+    /**
+     * Гэрчилгээний цуцлалтын шалгалтын дүн: "good" | "unchecked" (OCSP хариугүй, soft-fail-ээр зөвшөөрөв) | "skipped"
+     * (`revocation: false`). Аудитад хадгал.
+     */
+    revocation: RevocationOutcome;
 }
 /** Серверт хадгалах нэвтрэлтийн төлөв (JSON-д хувирна). */
 interface EidLoginTx {
@@ -1069,6 +1124,8 @@ interface EidLoginTx {
         receivedAt: number;
         lang: string;
     };
+    /** eID татгалзсан push-ийн оронд өгсөн хуурмаг session (eID-д байхгүй; хэзээ ч дуусахгүй). Зөвхөн серверт. */
+    decoy?: boolean;
 }
 /** Төлөвийн сан. Анхдагч — процессын санах ой ({@link memoryLoginStore}); олон instance бол Redis г.м. */
 interface EidLoginStore {
@@ -1092,6 +1149,39 @@ interface EidLoginSuccess {
     data?: unknown;
     headers?: Record<string, string | string[]>;
 }
+/**
+ * Аудитын үйл явдал (`onEvent`):
+ * - `push_sent` — push start амжилттай хариулсан (meta: mode, pushKey, decoy). `decoy: true` бол eID дугаарыг татгалзаж
+ *   утас руу юу ч очоогүй — хөтөч рүү хэзээ ч илэрхийлэгдэхгүй, зөвхөн таны аудитад.
+ * - `push_limited` — push хязгаарт хүрсэн, 429 (meta: mode, pushKey; sessionId null).
+ * - `refused` — иргэн утсан дээрээ татгалзсан (endResult USER_REFUSED*).
+ * - `expired` — eID session хугацаа дууссан (endResult TIMEOUT эсвэл eID-д олдохгүй).
+ * - `unverified` — баталгаажуулалт унасан (meta.reason: "validation" | "revoked" | "revocation_unavailable").
+ * - `flow_refused` — Web2App callback эхлүүлсэн хөтчийн session-тэй холбогдоогүй (meta.reason: "unbound").
+ * - `success` — иргэн баталгаажиж onSuccess дуудагдсан (meta: mode, flow, revocation).
+ * - `failed` — бусад endResult (WRONG_VC, DOCUMENT_UNUSABLE г.м.; meta.endResult).
+ */
+type EidLoginEventKind = "push_sent" | "push_limited" | "refused" | "expired" | "unverified" | "flow_refused" | "success" | "failed";
+/** `onEvent`-ийн аргумент. meta-д токен/нууц, регистрийн дугаар (PII) орохгүй. */
+interface EidLoginEvent {
+    kind: EidLoginEventKind;
+    sessionId: string | null;
+    meta: Record<string, unknown>;
+}
+/** Хязгаарлагч: true — зөвшөөрөх, false — 429. */
+type EidLoginRateLimitFn = (key: string) => boolean | Promise<boolean>;
+/** Нэг төрлийн хязгаар: санах ойн гулсах цонх, өөрийн функц, эсвэл `false` (хязгааргүй). */
+type EidLoginRateRule = {
+    limit: number;
+    windowMs: number;
+} | EidLoginRateLimitFn | false;
+/** Төрөл тус бүрийн хязгаар: `start` — `start:<ip>`, `push` — `push:<idCode>`. */
+interface EidLoginRateLimits {
+    start?: EidLoginRateRule;
+    push?: EidLoginRateRule;
+}
+/** Анхдагч хязгаар — `rateLimit`-ийн объектод өгөөгүй төрөл энүүгээр үлдэнэ. `{ ...defaultRateLimit, start: … }`. */
+declare const defaultRateLimit: Readonly<EidLoginRateLimits>;
 interface EidLoginOptions {
     client: EidClient;
     /**
@@ -1123,10 +1213,15 @@ interface EidLoginOptions {
         domain?: string;
     };
     /**
-     * Хязгаарлалт: `start:<ip>` (ip мэдэгдэж байвал) ба `push:<idCode>` түлхүүрээр дуудагдана; false → 429.
-     * Анхдагч: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — хохирогчийн утсыг мэдэгдлээр дарахаас (MFA fatigue).
+     * Хязгаарлалт. Түлхүүр: `start:<ip>` (ip мэдэгдэж байвал), `push:<idCode>`; false → 429.
+     * Анхдагч {@link defaultRateLimit}: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — MFA fatigue-ээс.
+     *
+     * - Объект `{ start?, push? }` — анхдагчтай НЭГТГЭГДЭНЭ: өгсөн төрөл анхдагчийг дарна, өгөөгүй нь анхдагчаараа.
+     *   Утга: `{ limit, windowMs }` (санах ойн гулсах цонх), функц (Redis г.м.) эсвэл `false` (тухайн төрлийг хязгаарлахгүй).
+     * - Функц `(key) => boolean` — бүх түлхүүрт дуудагдана, анхдагч хязгаар ДЭЭР НЭМЭГДЭНЭ (хоёулаа зөвшөөрөх ёстой).
+     *   Анхдагчийг сулруулах/солих бол объект хэлбэрээр тухайн төрлийг өг.
      */
-    rateLimit?: (key: string) => boolean | Promise<boolean>;
+    rateLimit?: EidLoginRateLimitFn | EidLoginRateLimits;
     /**
      * `handle(Request)`-ийн клиент IP (`start:<ip>` хязгаарт). Web-standard `Request`-д IP байдаггүй тул эсвэл энийг, эсвэл
      * {@link EidLoginOptions.trustProxy}-г өг; аль нь ч үгүй бол IP-ээр хязгаарлахгүй (анхны дуудлагад onError-оор анхааруулна).
@@ -1142,6 +1237,40 @@ interface EidLoginOptions {
     trustProxy?: boolean | number;
     /** Дотоод алдаа (eID API, store). Анхдагч console.error (мессеж л). */
     onError?: (err: unknown, ctx: EidLoginContext) => void;
+    /**
+     * eID push-ийг дугаарын шалтгаанаар татгалзвал (eID-ийн өөрийн JSON 4xx — танихгүй / ашиглах боломжгүй дугаар) decoy
+     * session-оор хариулна (анхдагч `true`). ⚠️ `false` бол `/start` нь «энэ регистр eID-д бүртгэлтэй эсэх»-ийг
+     * нэвтрээгүй хэнд ч хэлдэг oracle болно — зөвхөн дотоод/тестийн орчинд.
+     */
+    decoy?: boolean;
+    /**
+     * Push start-ийн хариу (бодит, decoy, 502) хамгийн багадаа энэ хугацаанд (мс) гарна: decoy микросекундэд, бодит push
+     * eID-ийн round trip-ээр бэлэн болдог тул цаг нь л ялгана. Анхдагч 1000; `0` — унтраана (⚠️ decoy-г хугацаагаар
+     * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. 429 ба 400-д хамаарахгүй.
+     */
+    pushFloorMs?: number;
+    /**
+     * Иргэний гэрчилгээний цуцлалт шалгагч (onSuccess-ийн өмнө). Анхдагч {@link ocspRevocationChecker} — гэрчилгээний AIA
+     * OCSP. Цуцлагдсан / олгогч мэдэхгүй → FAILED "VALIDATION". ⚠️ `false` — шалгахгүй: цуцалсан (хулгайлагдсан утасны)
+     * гэрчилгээгээр нэвтэрнэ.
+     */
+    revocation?: RevocationChecker | false;
+    /**
+     * OCSP хариугүй үед (timeout, 5xx, AIA алга): "soft-fail" (анхдагч) — зөвшөөрч onError-оор анхааруулна,
+     * `identity.revocation = "unchecked"` (eID порталын EID_OCSP=soft: CA-ийн responder унавал бүх иргэн түгжигдэхгүй);
+     * "hard-fail" — FAILED "VALIDATION".
+     */
+    revocationMode?: "soft-fail" | "hard-fail";
+    /**
+     * Аудитын hook ({@link EidLoginEventKind}). Хариу өгөхөөс өмнө await хийгдэнэ — удаан ажлыг өөрөө async болго; алдаа нь
+     * onError руу (урсгалыг зогсоохгүй). Push-д регистр биш `pushKey` = HMAC-SHA256(auditKey, дугаар)-ын 32 hex.
+     */
+    onEvent?: (event: EidLoginEvent) => void | Promise<void>;
+    /**
+     * pushKey-ийн HMAC түлхүүр (≥ 32 байт санал болгоно). Алга бол санамсаргүй — pushKey зөвхөн процесс дотор тогтвортой;
+     * instance/restart хооронд харьцуулах бол тогтмол нууц өг.
+     */
+    auditKey?: string | Uint8Array;
 }
 /** Framework-аас хамааралгүй хүсэлт (Express: `req.headers`, `req.body`, `req.ip`). */
 interface EidLoginRequest {
@@ -1152,6 +1281,8 @@ interface EidLoginRequest {
     /** POST-ийн задалсан JSON (Express `express.json()`), эсвэл түүхий мөр. */
     body?: unknown;
     ip?: string;
+    /** Хүсэлт тасрахад (клиент холболтоо хаасан) — `pushFloorMs` ба decoy poll-ын хүлээлтийг таслана. */
+    signal?: AbortSignal;
 }
 interface EidLoginResponse {
     status: number;
@@ -1178,4 +1309,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
  */
 declare function createEidLogin(opts: EidLoginOptions): EidLogin;
 
-export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, 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, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, Interaction, NotificationSession, 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 QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
+export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, 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, 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, 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, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, 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 };

package/dist/index.d.ts

@@ -25,6 +25,11 @@ declare class Http {
     private readonly cfg;
     constructor(cfg: HttpConfig);
     post(path: string, body: unknown, timeoutMs?: number): Promise<unknown>;
+    /** {@link post} + HTTP статус (201 / 200-г ялгах: `POST /pdf/signatures`). */
+    postWithStatus(path: string, body: unknown, timeoutMs?: number): Promise<{
+        status: number;
+        body: unknown;
+    }>;
     get(path: string, timeoutMs?: number): Promise<unknown>;
     private json;
     private send;
@@ -187,11 +192,26 @@ interface RegisterSignatureInput {
     priorCmsSha256?: string[];
     /** Горим A-ийн (CA угсарсан) өмнөх гарын үсгүүдийн revision SHA-256. `priorCmsSha256`-тай нийлээд = `revIndex − 1`. */
     priorRevisionSha256?: string[];
+    /**
+     * SDK-д л (CA руу илгээхгүй): өмнөх гарын үсэг бүрийн хоёр түлхүүр, баримтын дарааллаар — {@link registrationFromCompleted}
+     * бөглөнө. CA өмнөх мөр бүрийг өөрийнх нь түлхүүрээр таньдаг (клиент талын мөр — CMS, горим A — revision), файлаас аль
+     * нь болохыг ялгах боломжгүй. Тиймээс `registerSignature` эхлээд бүгдийг CMS-ээр илгээж, 409 `PRIOR_MISMATCH` бол
+     * эхний k-г revision-оор (горим A нь клиент талынхаас өмнө), өмнөх нь ≤ 4 бол бүх хослолыг оролдоно.
+     * `priorRevisionSha256`-г гараар өгсөн бол оролдохгүй.
+     */
+    priorSignatures?: PriorSignature[];
     /** Байгууллагын нэрийн өмнөөс (`NTRMN-…`) — session-ийнхтэй ижил. */
     onBehalfOf?: string;
     /** Заавал биш (`PNOMN-…`): ирвэл CMS-ийн зурагчийн SERIALNUMBER-тэй тэнцүү (эс бөгөөс 409 `SIGNER_MISMATCH`). */
     signerEtsi?: string;
 }
+/** Өмнөх нэг гарын үсгийн хоёр түлхүүр ({@link RegisterSignatureInput.priorSignatures}). */
+interface PriorSignature {
+    /** CMS DER-ийн SHA-256 (hex) — клиент талын мөр. */
+    cmsSha256: string;
+    /** `sha256(doc[0 : ByteRange[2]+ByteRange[3]])` (hex) — горим A-ийн мөр (CA `sig_rev_sha256`). */
+    revisionSha256: string;
+}
 /** {@link registrationFromCompleted}-д хэрэгтэй `pades.complete()`-ийн хэсэг (JSON-оор дамжсан бол `cms` нь base64). */
 interface CompletedForRegistration {
     docId: string;
@@ -203,6 +223,8 @@ interface CompletedForRegistration {
     sigRevSha256: string;
     outSha256: string;
     priorCmsSha256: string[];
+    /** `complete().priorRevisionSha256` (0.15.2+) — байвал `priorSignatures` бөглөгдөж горим A-ийн өмнөх мөрийг SDK өөрөө тааруулна. */
+    priorRevisionSha256?: string[];
 }
 /**
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
@@ -217,6 +239,8 @@ interface RegisterSignatureResult {
     registeredAt: string;
     /** Нийтийн шалгах хуудас (`https://ca.eidmongolia.mn/verify/<docID>`). */
     verifyUrl: string;
+    /** true — 201 (шинээр бүртгэв); false — 200 (ижил биеийн идэмпотент давталт, анхны хариу). */
+    created: boolean;
     raw: unknown;
 }
 /**
@@ -860,6 +884,11 @@ declare class ResponseValidator {
      * "skipped" (hook алга). "revoked", мөн hard-fail горимд "unknown" → ValidationError; hook-ийн алдаа дамжина.
      */
     checkRevocationStatus(cert: X509Certificate): Promise<RevocationOutcome>;
+    /**
+     * {@link checkRevocationStatus}-тэй ижил, гэхдээ TrustConfig-ийн биш өгсөн checker ба горимоор (issuer-ийг trust
+     * pool-оос олно). checker алга бол "skipped"; горим анхдагч "hard-fail".
+     */
+    checkRevocationWith(cert: X509Certificate, checker: RevocationChecker | undefined, mode?: "hard-fail" | "soft-fail"): Promise<RevocationOutcome>;
 }
 /** Payload (auth) дээрх гарын үсэг — алгоритмаар салаалж node:crypto verify. */
 /** Smart-ID: userChallenge = BASE64URL(SHA-256(UTF-8(userChallengeVerifier))), padding-гүй. */
@@ -926,6 +955,27 @@ declare class EidClient {
  */
 declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
 
+interface OcspCheckerOptions {
+    /** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
+    fetchImpl?: typeof fetch;
+    /** Нэг асуултын хугацаа (мс). Анхдагч 2000 — иргэн poll дээр хүлээж байна. */
+    timeoutMs?: number;
+    /** Цаг (мс, тест). Анхдагч Date.now. */
+    now?: () => number;
+}
+/**
+ * AIA OCSP-оор цуцлалт шалгагч ({@link RevocationChecker}):
+ *
+ * - good → "good" (5 мин кэшлэнэ);
+ * - revoked, мөн unknown (олгогч энэ serial-ийг олгоогүй — өөр хэн нэгний хийсэн гэрчилгээ) → "revoked";
+ * - хариугүй (AIA алга, issuer олдоогүй, timeout, HTTP ≠ 200, гарын үсэг/serial/хугацаа таараагүй) → "unknown" —
+ *   `revocationMode` шийднэ: soft-fail — зөвшөөрнө ("unchecked"), hard-fail — татгалзана.
+ *
+ * Хариуг олгогч эсвэл олгогчийн id-kp-OCSPSigning EKU-тэй (одоо хүчинтэй) responder зурсан, энэ serial-ийн тухай,
+ * thisUpdate ∈ [now−48ц, now+5мин], nextUpdate өнгөрөөгүй байх ёстой.
+ */
+declare function ocspRevocationChecker(opts?: OcspCheckerOptions): RevocationChecker;
+
 /** SHA-256 digest, base64. Текст эсвэл байтаас. Sign flow-ийн baримтын digest үүсгэхэд. */
 declare function sha256Base64(data: string | Uint8Array): string;
 /** Санамсаргүй RP challenge (default 64 байт), base64. Auth flow-д replay-ээс хамгаална. */
@@ -1051,6 +1101,11 @@ interface EidLoginIdentity {
     flowType: FlowType;
     /** Session-ийн `person` блок (кирилл нэр г.м.) — гэрчилгээтэй таарсан үед л, эс бөгөөс null. */
     person: PersonBlock | null;
+    /**
+     * Гэрчилгээний цуцлалтын шалгалтын дүн: "good" | "unchecked" (OCSP хариугүй, soft-fail-ээр зөвшөөрөв) | "skipped"
+     * (`revocation: false`). Аудитад хадгал.
+     */
+    revocation: RevocationOutcome;
 }
 /** Серверт хадгалах нэвтрэлтийн төлөв (JSON-д хувирна). */
 interface EidLoginTx {
@@ -1069,6 +1124,8 @@ interface EidLoginTx {
         receivedAt: number;
         lang: string;
     };
+    /** eID татгалзсан push-ийн оронд өгсөн хуурмаг session (eID-д байхгүй; хэзээ ч дуусахгүй). Зөвхөн серверт. */
+    decoy?: boolean;
 }
 /** Төлөвийн сан. Анхдагч — процессын санах ой ({@link memoryLoginStore}); олон instance бол Redis г.м. */
 interface EidLoginStore {
@@ -1092,6 +1149,39 @@ interface EidLoginSuccess {
     data?: unknown;
     headers?: Record<string, string | string[]>;
 }
+/**
+ * Аудитын үйл явдал (`onEvent`):
+ * - `push_sent` — push start амжилттай хариулсан (meta: mode, pushKey, decoy). `decoy: true` бол eID дугаарыг татгалзаж
+ *   утас руу юу ч очоогүй — хөтөч рүү хэзээ ч илэрхийлэгдэхгүй, зөвхөн таны аудитад.
+ * - `push_limited` — push хязгаарт хүрсэн, 429 (meta: mode, pushKey; sessionId null).
+ * - `refused` — иргэн утсан дээрээ татгалзсан (endResult USER_REFUSED*).
+ * - `expired` — eID session хугацаа дууссан (endResult TIMEOUT эсвэл eID-д олдохгүй).
+ * - `unverified` — баталгаажуулалт унасан (meta.reason: "validation" | "revoked" | "revocation_unavailable").
+ * - `flow_refused` — Web2App callback эхлүүлсэн хөтчийн session-тэй холбогдоогүй (meta.reason: "unbound").
+ * - `success` — иргэн баталгаажиж onSuccess дуудагдсан (meta: mode, flow, revocation).
+ * - `failed` — бусад endResult (WRONG_VC, DOCUMENT_UNUSABLE г.м.; meta.endResult).
+ */
+type EidLoginEventKind = "push_sent" | "push_limited" | "refused" | "expired" | "unverified" | "flow_refused" | "success" | "failed";
+/** `onEvent`-ийн аргумент. meta-д токен/нууц, регистрийн дугаар (PII) орохгүй. */
+interface EidLoginEvent {
+    kind: EidLoginEventKind;
+    sessionId: string | null;
+    meta: Record<string, unknown>;
+}
+/** Хязгаарлагч: true — зөвшөөрөх, false — 429. */
+type EidLoginRateLimitFn = (key: string) => boolean | Promise<boolean>;
+/** Нэг төрлийн хязгаар: санах ойн гулсах цонх, өөрийн функц, эсвэл `false` (хязгааргүй). */
+type EidLoginRateRule = {
+    limit: number;
+    windowMs: number;
+} | EidLoginRateLimitFn | false;
+/** Төрөл тус бүрийн хязгаар: `start` — `start:<ip>`, `push` — `push:<idCode>`. */
+interface EidLoginRateLimits {
+    start?: EidLoginRateRule;
+    push?: EidLoginRateRule;
+}
+/** Анхдагч хязгаар — `rateLimit`-ийн объектод өгөөгүй төрөл энүүгээр үлдэнэ. `{ ...defaultRateLimit, start: … }`. */
+declare const defaultRateLimit: Readonly<EidLoginRateLimits>;
 interface EidLoginOptions {
     client: EidClient;
     /**
@@ -1123,10 +1213,15 @@ interface EidLoginOptions {
         domain?: string;
     };
     /**
-     * Хязгаарлалт: `start:<ip>` (ip мэдэгдэж байвал) ба `push:<idCode>` түлхүүрээр дуудагдана; false → 429.
-     * Анхдагч: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — хохирогчийн утсыг мэдэгдлээр дарахаас (MFA fatigue).
+     * Хязгаарлалт. Түлхүүр: `start:<ip>` (ip мэдэгдэж байвал), `push:<idCode>`; false → 429.
+     * Анхдагч {@link defaultRateLimit}: push-д нэг дугаарт 60 секундэд 3 (санах ойд) — MFA fatigue-ээс.
+     *
+     * - Объект `{ start?, push? }` — анхдагчтай НЭГТГЭГДЭНЭ: өгсөн төрөл анхдагчийг дарна, өгөөгүй нь анхдагчаараа.
+     *   Утга: `{ limit, windowMs }` (санах ойн гулсах цонх), функц (Redis г.м.) эсвэл `false` (тухайн төрлийг хязгаарлахгүй).
+     * - Функц `(key) => boolean` — бүх түлхүүрт дуудагдана, анхдагч хязгаар ДЭЭР НЭМЭГДЭНЭ (хоёулаа зөвшөөрөх ёстой).
+     *   Анхдагчийг сулруулах/солих бол объект хэлбэрээр тухайн төрлийг өг.
      */
-    rateLimit?: (key: string) => boolean | Promise<boolean>;
+    rateLimit?: EidLoginRateLimitFn | EidLoginRateLimits;
     /**
      * `handle(Request)`-ийн клиент IP (`start:<ip>` хязгаарт). Web-standard `Request`-д IP байдаггүй тул эсвэл энийг, эсвэл
      * {@link EidLoginOptions.trustProxy}-г өг; аль нь ч үгүй бол IP-ээр хязгаарлахгүй (анхны дуудлагад onError-оор анхааруулна).
@@ -1142,6 +1237,40 @@ interface EidLoginOptions {
     trustProxy?: boolean | number;
     /** Дотоод алдаа (eID API, store). Анхдагч console.error (мессеж л). */
     onError?: (err: unknown, ctx: EidLoginContext) => void;
+    /**
+     * eID push-ийг дугаарын шалтгаанаар татгалзвал (eID-ийн өөрийн JSON 4xx — танихгүй / ашиглах боломжгүй дугаар) decoy
+     * session-оор хариулна (анхдагч `true`). ⚠️ `false` бол `/start` нь «энэ регистр eID-д бүртгэлтэй эсэх»-ийг
+     * нэвтрээгүй хэнд ч хэлдэг oracle болно — зөвхөн дотоод/тестийн орчинд.
+     */
+    decoy?: boolean;
+    /**
+     * Push start-ийн хариу (бодит, decoy, 502) хамгийн багадаа энэ хугацаанд (мс) гарна: decoy микросекундэд, бодит push
+     * eID-ийн round trip-ээр бэлэн болдог тул цаг нь л ялгана. Анхдагч 1000; `0` — унтраана (⚠️ decoy-г хугацаагаар
+     * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. 429 ба 400-д хамаарахгүй.
+     */
+    pushFloorMs?: number;
+    /**
+     * Иргэний гэрчилгээний цуцлалт шалгагч (onSuccess-ийн өмнө). Анхдагч {@link ocspRevocationChecker} — гэрчилгээний AIA
+     * OCSP. Цуцлагдсан / олгогч мэдэхгүй → FAILED "VALIDATION". ⚠️ `false` — шалгахгүй: цуцалсан (хулгайлагдсан утасны)
+     * гэрчилгээгээр нэвтэрнэ.
+     */
+    revocation?: RevocationChecker | false;
+    /**
+     * OCSP хариугүй үед (timeout, 5xx, AIA алга): "soft-fail" (анхдагч) — зөвшөөрч onError-оор анхааруулна,
+     * `identity.revocation = "unchecked"` (eID порталын EID_OCSP=soft: CA-ийн responder унавал бүх иргэн түгжигдэхгүй);
+     * "hard-fail" — FAILED "VALIDATION".
+     */
+    revocationMode?: "soft-fail" | "hard-fail";
+    /**
+     * Аудитын hook ({@link EidLoginEventKind}). Хариу өгөхөөс өмнө await хийгдэнэ — удаан ажлыг өөрөө async болго; алдаа нь
+     * onError руу (урсгалыг зогсоохгүй). Push-д регистр биш `pushKey` = HMAC-SHA256(auditKey, дугаар)-ын 32 hex.
+     */
+    onEvent?: (event: EidLoginEvent) => void | Promise<void>;
+    /**
+     * pushKey-ийн HMAC түлхүүр (≥ 32 байт санал болгоно). Алга бол санамсаргүй — pushKey зөвхөн процесс дотор тогтвортой;
+     * instance/restart хооронд харьцуулах бол тогтмол нууц өг.
+     */
+    auditKey?: string | Uint8Array;
 }
 /** Framework-аас хамааралгүй хүсэлт (Express: `req.headers`, `req.body`, `req.ip`). */
 interface EidLoginRequest {
@@ -1152,6 +1281,8 @@ interface EidLoginRequest {
     /** POST-ийн задалсан JSON (Express `express.json()`), эсвэл түүхий мөр. */
     body?: unknown;
     ip?: string;
+    /** Хүсэлт тасрахад (клиент холболтоо хаасан) — `pushFloorMs` ба decoy poll-ын хүлээлтийг таслана. */
+    signal?: AbortSignal;
 }
 interface EidLoginResponse {
     status: number;
@@ -1178,4 +1309,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
  */
 declare function createEidLogin(opts: EidLoginOptions): EidLogin;
 
-export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, 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, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, Interaction, NotificationSession, 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 QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
+export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, 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, 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, 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, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, 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 };