@gerege-systems/eid-mongolia-sdk 0.26.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts 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-Df4wTfZx.cjs';
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-Df4wTfZx.cjs';
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-Cgtf5eHN.cjs';
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-Cgtf5eHN.cjs';
3
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, A as ApiError, H as HttpErrorInit } from './errors-CxAr-WIA.cjs';
4
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CxAr-WIA.cjs';
3
5
  import { X509Certificate, KeyObject } from 'node:crypto';
4
- import { A as ApiError, H as HttpErrorInit } from './errors-BM8D3VEw.cjs';
5
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, d as OnBehalfErrorCode, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, R as RETRYABLE_ERROR_CODES, f as RequestInvalidError, g as ResponseTooLargeError, h as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-BM8D3VEw.cjs';
6
6
 
7
7
  interface HttpConfig {
8
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -240,10 +240,14 @@ interface CompletedForRegistration {
240
240
  priorCmsSha256: string[];
241
241
  /** `complete().priorRevisionSha256` (0.15.2+) — байвал `priorSignatures` бөглөгдөж горим A-ийн өмнөх мөрийг SDK өөрөө тааруулна. */
242
242
  priorRevisionSha256?: string[];
243
+ /** `complete().claimedRole` (0.27.0+) — хоосон биш бол `onBehalfOf` заавал. */
244
+ claimedRole?: string;
243
245
  }
244
246
  /**
245
247
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
246
- * тооцно; `pageSha256` зөвхөн хуудастай үед).
248
+ * тооцно; `pageSha256` зөвхөн хуудастай үед). `medium` алга бол `sessionID`-аас (CA-ийн дүрэм: phone ⇔ sessionID).
249
+ * @throws {ValidationError} phone + sessionID алга, token + sessionID, үл мэдэгдэх medium, эсвэл `claimedRole`-той гарын
250
+ * үсэгт `onBehalfOf` алга (CA-д очихоос өмнө; Go / .NET / Swift / Kotlin-д REQUEST_INVALID).
247
251
  */
248
252
  declare function registrationFromCompleted(done: CompletedForRegistration, extra: Pick<RegisterSignatureInput, "fileName" | "sessionID" | "medium" | "onBehalfOf" | "signerEtsi" | "priorRevisionSha256">): RegisterSignatureInput;
249
253
  /** `POST /pdf/signatures`-ийн хариу (201 шинэ, 200 идэмпотент давталт). */
@@ -350,6 +354,16 @@ declare class SignApi {
350
354
  deviceLinkForSigner(signer: SignerRef, digestB64: string, interactions: Interaction[], opts?: SignOptions): Promise<DeviceLinkSession>;
351
355
  }
352
356
 
357
+ /**
358
+ * Нийт хүлээх хугацааны нөөц утга (мс): `maxWaitMs`, `expiresAt` өгөөгүй, discovery-ийн `sessionTtl` ч мэдэгдэхгүй үед
359
+ * (CA-ийн гарын үсгийн session-ий анхдагч 600 с).
360
+ */
361
+ declare const DEFAULT_MAX_WAIT_MS = 600000;
362
+ /**
363
+ * `expiresAt` / discovery `sessionTtl`-ээс хойш нэмж хүлээх хугацаа (мс): CA хугацаа дууссан session-ийг дараагийн poll-д
364
+ * COMPLETE/TIMEOUT болгодог тул сүүлчийн poll дуусах мөчөөс хойш явагдаж, цагийн бага зөрүүг даана.
365
+ */
366
+ declare const WAIT_GRACE_MS = 15000;
353
367
  /** RP-API-ийн session JSON-ийг SessionResult болгон задална (rpclient.ts-тэй ижил mapping). */
354
368
  declare function parseSessionResult(raw: unknown): SessionResult;
355
369
  /**
@@ -366,13 +380,19 @@ declare class SessionApi {
366
380
  /** Нэг удаагийн long-poll. serverPollMs хүртэл хүлээнэ. */
367
381
  poll(sessionId: string, serverPollMs?: number): Promise<SessionResult>;
368
382
  /**
369
- * COMPLETE болтол давтаж poll хийнэ. maxWaitMs дуустал хүлээгээд гараагүй бол сүүлчийн
383
+ * COMPLETE болтол давтаж poll хийнэ. Анхдагчаар session-ий амьдрах хугацаа дуустал хүлээнэ: `expiresAt` (start
384
+ * хариуны `expiresAt`, мс epoch) + {@link WAIT_GRACE_MS}; алга бол discovery `sessionTtl` (max(auth, sign)) + grace;
385
+ * тэр нь ч мэдэгдэхгүй бол {@link DEFAULT_MAX_WAIT_MS}. `maxWaitMs` өгвөл түүнийг л дагана. CA хугацаа дууссан
386
+ * session-ийг COMPLETE/TIMEOUT болгодог тул ердийн үед тэр үр дүн ирнэ; хугацаа дуустал COMPLETE болоогүй бол сүүлчийн
370
387
  * (RUNNING) үр дүнг буцаана — дуудагч endResult==null-ийг TIMEOUT мэт боловсруулна.
371
388
  */
372
389
  waitForResult(sessionId: string, opts?: {
373
390
  maxWaitMs?: number;
374
391
  serverPollMs?: number;
392
+ expiresAt?: number;
375
393
  }): Promise<SessionResult>;
394
+ /** waitForResult-ийн дуусах мөч (мс epoch): maxWaitMs > expiresAt > discovery sessionTtl > DEFAULT_MAX_WAIT_MS. */
395
+ private waitDeadline;
376
396
  }
377
397
 
378
398
  declare class OrganizationApi {
@@ -951,16 +971,45 @@ interface TokenLimit {
951
971
  organization?: string;
952
972
  }
953
973
  /**
954
- * Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
974
+ * Токены олголтын гол 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
955
975
  * - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
956
976
  * - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
957
977
  * - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
958
978
  * байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна;
959
979
  * - `ACCOUNT_DELETE_PENDING` — иргэн «Бүртгэл устгах» хүсэлт (PENDING) өгсөн: токен олгохгүй (CA !377).
980
+ *
981
+ * CA өөр 409 ч буцаана — {@link TOKEN_ISSUANCE_PENDING}, {@link KYC_INCOMPLETE}, {@link NO_ACTIVE_DEVICE},
982
+ * {@link CSR_KEY_REUSED} — exhaustive `switch`-ийг эвдэхгүйн тулд энэ төрөлд биш, тусдаа тогтмол ба
983
+ * {@link TOKEN_ERROR_CODES} (токены бүх код)-д.
960
984
  */
961
985
  type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE" | "ACCOUNT_DELETE_PENDING";
962
986
  /** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
963
987
  declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
988
+ /** 409 — энэ иргэнд өөр CSR-тэй олголт хүлээгдэж байна (утсаар батлах эсвэл хугацаа дуусахыг хүлээнэ); dryRun-д ч. */
989
+ declare const TOKEN_ISSUANCE_PENDING = "TOKEN_ISSUANCE_PENDING";
990
+ /** 409 — иргэний латин нэр бүртгэлгүй (гэрчилгээний subject үүсэхгүй); session-ий `tokenCertificate.errorCode`-д ч. */
991
+ declare const KYC_INCOMPLETE = "KYC_INCOMPLETE";
992
+ /** 409 — иргэнд идэвхтэй eID утас (хүчинтэй гарын үсгийн гэрчилгээ) алга — батлах push очихгүй. */
993
+ declare const NO_ACTIVE_DEVICE = "NO_ACTIVE_DEVICE";
994
+ /** 409 — CSR-ийн түлхүүрт гэрчилгээ аль хэдийн олгогдсон — токенд шинэ түлхүүр үүсгэнэ. */
995
+ declare const CSR_KEY_REUSED = "CSR_KEY_REUSED";
996
+ /**
997
+ * Токены олголт / үр дүн / нэвтрэлтийн CA-ийн тогтвортой кодууд (`ApiError.code` / `ForbiddenError.code`, session-ий
998
+ * `tokenCertificate.errorCode`; CA `tokencert.go`, `token_auth.go`). {@link TokenConflictCode}-оос тусдаа — шинэ код
999
+ * нэмэгдэхэд тэр төрлийн exhaustive `switch` эвдрэхгүй.
1000
+ * - олголт 400: CSR_INVALID, CSR_KEY_UNSUPPORTED, CSR_SIGNATURE_INVALID, CSR_KEYS_IDENTICAL, APP_ATTESTATION_INVALID,
1001
+ * REQUEST_INVALID; 409: {@link TokenConflictCode}, TOKEN_ISSUANCE_PENDING, KYC_INCOMPLETE, NO_ACTIVE_DEVICE,
1002
+ * CSR_KEY_REUSED; 403/404: {@link OnBehalfErrorCode}-ийн кодууд;
1003
+ * - үр дүн (`certificateResult`): 409 SESSION_NOT_COMPLETE, SESSION_FAILED, ISSUANCE_FAILED; 410 RESULT_EXPIRED;
1004
+ * - session-ий errorCode (FAILED): SESSION_MISMATCH, CSR_DIGEST_MISMATCH, SIGNER_CERT_CHANGED, SIGNATURE_INVALID,
1005
+ * ISSUANCE_ERROR, REGISTRY_FAILED (+ дээрх зарим нь);
1006
+ * - токеноор нэвтрэлт: 403 RP_REQUIRED; 400 CERT_INVALID, SIGNATURE_INVALID; 409 CHALLENGE_USED, CERT_NOT_ACTIVE;
1007
+ * 410 CHALLENGE_EXPIRED;
1008
+ * - түр: {@link RETRYABLE_ERROR_CODES}.
1009
+ */
1010
+ type TokenErrorCode = TokenConflictCode | "APP_ATTESTATION_INVALID" | "TOKEN_ISSUANCE_PENDING" | "KYC_INCOMPLETE" | "NO_ACTIVE_DEVICE" | "CSR_KEY_REUSED" | "CSR_INVALID" | "CSR_KEY_UNSUPPORTED" | "CSR_SIGNATURE_INVALID" | "CSR_KEYS_IDENTICAL" | "ISSUANCE_FAILED" | "RESULT_EXPIRED" | "CSR_DIGEST_MISMATCH" | "SIGNER_CERT_CHANGED" | "ISSUANCE_ERROR" | "REGISTRY_FAILED" | "RP_REQUIRED" | "CHALLENGE_EXPIRED" | "CHALLENGE_USED" | "CERT_INVALID" | "CERT_NOT_ACTIVE" | "REQUEST_INVALID" | "SIGNATURE_INVALID" | "SESSION_MISMATCH" | "SESSION_NOT_COMPLETE" | "SESSION_FAILED" | OnBehalfErrorCode | RetryableErrorCode;
1011
+ /** {@link TokenErrorCode}-ийн бүх утга (runtime шалгалтад). */
1012
+ declare const TOKEN_ERROR_CODES: readonly TokenErrorCode[];
964
1013
  /** {@link TokenApi.previewCertificate}-ийн хариу. `supersedes` — бодит олголт амжилттай болоход солигдох хувийн токенууд. */
965
1014
  interface TokenCertPreview {
966
1015
  supersedes?: {
@@ -1128,7 +1177,7 @@ declare class ShareError extends ApiError {
1128
1177
  }
1129
1178
  /** Discovery (`/.well-known/eid`)-ийн `share` блок. */
1130
1179
  interface ShareInfo {
1131
- /** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
1180
+ /** Имэйлийн үйлчилгээ ба шалгагч тохируулагдсан эсэх. false бол `share()` → 503 MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED). */
1132
1181
  enabled: boolean;
1133
1182
  endpoint: string;
1134
1183
  formats: {
@@ -1182,8 +1231,8 @@ interface ClientConfig {
1182
1231
  language?: string;
1183
1232
  /**
1184
1233
  * Sign / certificate-choice session-ий `expiresAt`-ийг тооцоолох хугацаа (мс). Анхдагч 600000
1185
- * ({@link DEFAULT_SIGN_SESSION_TTL_MS}, CA-ийн анхдагч); CA-ийн админ тохиргоог өөрчилсөн бол тааруул. CA session start
1186
- * хариунд хугацаа буцаадаггүй.
1234
+ * ({@link DEFAULT_SIGN_SESSION_TTL_MS}, CA-ийн анхдагч); CA-ийн админ тохиргоог өөрчилсөн бол тааруул. Зөвхөн CA-ийн
1235
+ * start хариунд `expiresAt` ирээгүй (хуучин CA) үед хэрэглэгдэнэ.
1187
1236
  */
1188
1237
  signSessionTtlMs?: number;
1189
1238
  /** Trust anchor (Root CA) — validator-д. Production-д ЗААВАЛ. */
@@ -1214,8 +1263,8 @@ declare class EidClient {
1214
1263
  /**
1215
1264
  * `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
1216
1265
  * имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
1217
- * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
1218
- * SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
1266
+ * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. Имэйл/шалгагч тохируулаагүй бол 503
1267
+ * MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED) — {@link shareInfo}-оор урьдчилан шалга.
1219
1268
  */
1220
1269
  share(input: ShareInput): Promise<ShareResult>;
1221
1270
  /** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
@@ -1246,7 +1295,7 @@ interface OcspCheckerOptions {
1246
1295
  /**
1247
1296
  * AIA OCSP-оор цуцлалт шалгагч ({@link RevocationChecker}):
1248
1297
  *
1249
- * - good → "good" (5 мин кэшлэнэ);
1298
+ * - good → "good" (min(5 мин, хариуны nextUpdate) кэшлэнэ);
1250
1299
  * - revoked, мөн unknown (олгогч энэ serial-ийг олгоогүй — өөр хэн нэгний хийсэн гэрчилгээ) → "revoked";
1251
1300
  * - хариугүй (AIA алга, issuer олдоогүй, timeout, HTTP ≠ 200, гарын үсэг/serial/хугацаа таараагүй) → "unknown" —
1252
1301
  * `revocationMode` шийднэ: soft-fail — зөвшөөрнө ("unchecked"), hard-fail — татгалзана.
@@ -1267,7 +1316,7 @@ declare function randomChallenge(bytes?: number): string;
1267
1316
  declare function interactionsToBase64(interactions: Interaction[]): string;
1268
1317
  /** ACSP_V2 payload-ийн бүх орц (Smart-ID v3 §ACSP_V2 digest calculation). */
1269
1318
  interface AcspV2Params {
1270
- /** default "smart-id" (серверийн SMARTID_ACSP_SCHEME_NAME-тэй ижил). */
1319
+ /** default "smart-id" (серверийн EID_ACSP_SCHEME_NAME-тэй ижил). */
1271
1320
  schemeName?: string;
1272
1321
  serverRandom: string;
1273
1322
  rpChallenge: string;
@@ -1548,7 +1597,8 @@ interface EidLoginOptions {
1548
1597
  /**
1549
1598
  * Push start-ийн хариу (бодит, decoy, 502) хамгийн багадаа энэ хугацаанд (мс) гарна: decoy микросекундэд, бодит push
1550
1599
  * eID-ийн round trip-ээр бэлэн болдог тул цаг нь л ялгана. Анхдагч 1000; `0` — унтраана (⚠️ decoy-г хугацаагаар
1551
- * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. 429 ба 400-д хамаарахгүй.
1600
+ * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. Хязгаарлагчийн 429 ба 400-д
1601
+ * хамаарахгүй (eID-ийн 429 ба 503 `busy` floor-той).
1552
1602
  */
1553
1603
  pushFloorMs?: number;
1554
1604
  /**
@@ -1611,4 +1661,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1611
1661
  */
1612
1662
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1613
1663
 
1614
- export { APP_ATTESTATION_INVALID, 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, MAX_APP_TRANSACTION_BYTES, 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, type SessionTtl, 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 TokenCertPreview, 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 };
1664
+ export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, 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, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, 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, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, 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 };
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-BYY0cP2D.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-BYY0cP2D.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-DgiXeZf-.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-DgiXeZf-.js';
3
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, A as ApiError, H as HttpErrorInit } from './errors-CxAr-WIA.js';
4
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CxAr-WIA.js';
3
5
  import { X509Certificate, KeyObject } from 'node:crypto';
4
- import { A as ApiError, H as HttpErrorInit } from './errors-BM8D3VEw.js';
5
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, d as OnBehalfErrorCode, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, R as RETRYABLE_ERROR_CODES, f as RequestInvalidError, g as ResponseTooLargeError, h as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-BM8D3VEw.js';
6
6
 
7
7
  interface HttpConfig {
8
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -240,10 +240,14 @@ interface CompletedForRegistration {
240
240
  priorCmsSha256: string[];
241
241
  /** `complete().priorRevisionSha256` (0.15.2+) — байвал `priorSignatures` бөглөгдөж горим A-ийн өмнөх мөрийг SDK өөрөө тааруулна. */
242
242
  priorRevisionSha256?: string[];
243
+ /** `complete().claimedRole` (0.27.0+) — хоосон биш бол `onBehalfOf` заавал. */
244
+ claimedRole?: string;
243
245
  }
244
246
  /**
245
247
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
246
- * тооцно; `pageSha256` зөвхөн хуудастай үед).
248
+ * тооцно; `pageSha256` зөвхөн хуудастай үед). `medium` алга бол `sessionID`-аас (CA-ийн дүрэм: phone ⇔ sessionID).
249
+ * @throws {ValidationError} phone + sessionID алга, token + sessionID, үл мэдэгдэх medium, эсвэл `claimedRole`-той гарын
250
+ * үсэгт `onBehalfOf` алга (CA-д очихоос өмнө; Go / .NET / Swift / Kotlin-д REQUEST_INVALID).
247
251
  */
248
252
  declare function registrationFromCompleted(done: CompletedForRegistration, extra: Pick<RegisterSignatureInput, "fileName" | "sessionID" | "medium" | "onBehalfOf" | "signerEtsi" | "priorRevisionSha256">): RegisterSignatureInput;
249
253
  /** `POST /pdf/signatures`-ийн хариу (201 шинэ, 200 идэмпотент давталт). */
@@ -350,6 +354,16 @@ declare class SignApi {
350
354
  deviceLinkForSigner(signer: SignerRef, digestB64: string, interactions: Interaction[], opts?: SignOptions): Promise<DeviceLinkSession>;
351
355
  }
352
356
 
357
+ /**
358
+ * Нийт хүлээх хугацааны нөөц утга (мс): `maxWaitMs`, `expiresAt` өгөөгүй, discovery-ийн `sessionTtl` ч мэдэгдэхгүй үед
359
+ * (CA-ийн гарын үсгийн session-ий анхдагч 600 с).
360
+ */
361
+ declare const DEFAULT_MAX_WAIT_MS = 600000;
362
+ /**
363
+ * `expiresAt` / discovery `sessionTtl`-ээс хойш нэмж хүлээх хугацаа (мс): CA хугацаа дууссан session-ийг дараагийн poll-д
364
+ * COMPLETE/TIMEOUT болгодог тул сүүлчийн poll дуусах мөчөөс хойш явагдаж, цагийн бага зөрүүг даана.
365
+ */
366
+ declare const WAIT_GRACE_MS = 15000;
353
367
  /** RP-API-ийн session JSON-ийг SessionResult болгон задална (rpclient.ts-тэй ижил mapping). */
354
368
  declare function parseSessionResult(raw: unknown): SessionResult;
355
369
  /**
@@ -366,13 +380,19 @@ declare class SessionApi {
366
380
  /** Нэг удаагийн long-poll. serverPollMs хүртэл хүлээнэ. */
367
381
  poll(sessionId: string, serverPollMs?: number): Promise<SessionResult>;
368
382
  /**
369
- * COMPLETE болтол давтаж poll хийнэ. maxWaitMs дуустал хүлээгээд гараагүй бол сүүлчийн
383
+ * COMPLETE болтол давтаж poll хийнэ. Анхдагчаар session-ий амьдрах хугацаа дуустал хүлээнэ: `expiresAt` (start
384
+ * хариуны `expiresAt`, мс epoch) + {@link WAIT_GRACE_MS}; алга бол discovery `sessionTtl` (max(auth, sign)) + grace;
385
+ * тэр нь ч мэдэгдэхгүй бол {@link DEFAULT_MAX_WAIT_MS}. `maxWaitMs` өгвөл түүнийг л дагана. CA хугацаа дууссан
386
+ * session-ийг COMPLETE/TIMEOUT болгодог тул ердийн үед тэр үр дүн ирнэ; хугацаа дуустал COMPLETE болоогүй бол сүүлчийн
370
387
  * (RUNNING) үр дүнг буцаана — дуудагч endResult==null-ийг TIMEOUT мэт боловсруулна.
371
388
  */
372
389
  waitForResult(sessionId: string, opts?: {
373
390
  maxWaitMs?: number;
374
391
  serverPollMs?: number;
392
+ expiresAt?: number;
375
393
  }): Promise<SessionResult>;
394
+ /** waitForResult-ийн дуусах мөч (мс epoch): maxWaitMs > expiresAt > discovery sessionTtl > DEFAULT_MAX_WAIT_MS. */
395
+ private waitDeadline;
376
396
  }
377
397
 
378
398
  declare class OrganizationApi {
@@ -951,16 +971,45 @@ interface TokenLimit {
951
971
  organization?: string;
952
972
  }
953
973
  /**
954
- * Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
974
+ * Токены олголтын гол 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
955
975
  * - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
956
976
  * - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
957
977
  * - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
958
978
  * байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна;
959
979
  * - `ACCOUNT_DELETE_PENDING` — иргэн «Бүртгэл устгах» хүсэлт (PENDING) өгсөн: токен олгохгүй (CA !377).
980
+ *
981
+ * CA өөр 409 ч буцаана — {@link TOKEN_ISSUANCE_PENDING}, {@link KYC_INCOMPLETE}, {@link NO_ACTIVE_DEVICE},
982
+ * {@link CSR_KEY_REUSED} — exhaustive `switch`-ийг эвдэхгүйн тулд энэ төрөлд биш, тусдаа тогтмол ба
983
+ * {@link TOKEN_ERROR_CODES} (токены бүх код)-д.
960
984
  */
961
985
  type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE" | "ACCOUNT_DELETE_PENDING";
962
986
  /** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
963
987
  declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
988
+ /** 409 — энэ иргэнд өөр CSR-тэй олголт хүлээгдэж байна (утсаар батлах эсвэл хугацаа дуусахыг хүлээнэ); dryRun-д ч. */
989
+ declare const TOKEN_ISSUANCE_PENDING = "TOKEN_ISSUANCE_PENDING";
990
+ /** 409 — иргэний латин нэр бүртгэлгүй (гэрчилгээний subject үүсэхгүй); session-ий `tokenCertificate.errorCode`-д ч. */
991
+ declare const KYC_INCOMPLETE = "KYC_INCOMPLETE";
992
+ /** 409 — иргэнд идэвхтэй eID утас (хүчинтэй гарын үсгийн гэрчилгээ) алга — батлах push очихгүй. */
993
+ declare const NO_ACTIVE_DEVICE = "NO_ACTIVE_DEVICE";
994
+ /** 409 — CSR-ийн түлхүүрт гэрчилгээ аль хэдийн олгогдсон — токенд шинэ түлхүүр үүсгэнэ. */
995
+ declare const CSR_KEY_REUSED = "CSR_KEY_REUSED";
996
+ /**
997
+ * Токены олголт / үр дүн / нэвтрэлтийн CA-ийн тогтвортой кодууд (`ApiError.code` / `ForbiddenError.code`, session-ий
998
+ * `tokenCertificate.errorCode`; CA `tokencert.go`, `token_auth.go`). {@link TokenConflictCode}-оос тусдаа — шинэ код
999
+ * нэмэгдэхэд тэр төрлийн exhaustive `switch` эвдрэхгүй.
1000
+ * - олголт 400: CSR_INVALID, CSR_KEY_UNSUPPORTED, CSR_SIGNATURE_INVALID, CSR_KEYS_IDENTICAL, APP_ATTESTATION_INVALID,
1001
+ * REQUEST_INVALID; 409: {@link TokenConflictCode}, TOKEN_ISSUANCE_PENDING, KYC_INCOMPLETE, NO_ACTIVE_DEVICE,
1002
+ * CSR_KEY_REUSED; 403/404: {@link OnBehalfErrorCode}-ийн кодууд;
1003
+ * - үр дүн (`certificateResult`): 409 SESSION_NOT_COMPLETE, SESSION_FAILED, ISSUANCE_FAILED; 410 RESULT_EXPIRED;
1004
+ * - session-ий errorCode (FAILED): SESSION_MISMATCH, CSR_DIGEST_MISMATCH, SIGNER_CERT_CHANGED, SIGNATURE_INVALID,
1005
+ * ISSUANCE_ERROR, REGISTRY_FAILED (+ дээрх зарим нь);
1006
+ * - токеноор нэвтрэлт: 403 RP_REQUIRED; 400 CERT_INVALID, SIGNATURE_INVALID; 409 CHALLENGE_USED, CERT_NOT_ACTIVE;
1007
+ * 410 CHALLENGE_EXPIRED;
1008
+ * - түр: {@link RETRYABLE_ERROR_CODES}.
1009
+ */
1010
+ type TokenErrorCode = TokenConflictCode | "APP_ATTESTATION_INVALID" | "TOKEN_ISSUANCE_PENDING" | "KYC_INCOMPLETE" | "NO_ACTIVE_DEVICE" | "CSR_KEY_REUSED" | "CSR_INVALID" | "CSR_KEY_UNSUPPORTED" | "CSR_SIGNATURE_INVALID" | "CSR_KEYS_IDENTICAL" | "ISSUANCE_FAILED" | "RESULT_EXPIRED" | "CSR_DIGEST_MISMATCH" | "SIGNER_CERT_CHANGED" | "ISSUANCE_ERROR" | "REGISTRY_FAILED" | "RP_REQUIRED" | "CHALLENGE_EXPIRED" | "CHALLENGE_USED" | "CERT_INVALID" | "CERT_NOT_ACTIVE" | "REQUEST_INVALID" | "SIGNATURE_INVALID" | "SESSION_MISMATCH" | "SESSION_NOT_COMPLETE" | "SESSION_FAILED" | OnBehalfErrorCode | RetryableErrorCode;
1011
+ /** {@link TokenErrorCode}-ийн бүх утга (runtime шалгалтад). */
1012
+ declare const TOKEN_ERROR_CODES: readonly TokenErrorCode[];
964
1013
  /** {@link TokenApi.previewCertificate}-ийн хариу. `supersedes` — бодит олголт амжилттай болоход солигдох хувийн токенууд. */
965
1014
  interface TokenCertPreview {
966
1015
  supersedes?: {
@@ -1128,7 +1177,7 @@ declare class ShareError extends ApiError {
1128
1177
  }
1129
1178
  /** Discovery (`/.well-known/eid`)-ийн `share` блок. */
1130
1179
  interface ShareInfo {
1131
- /** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
1180
+ /** Имэйлийн үйлчилгээ ба шалгагч тохируулагдсан эсэх. false бол `share()` → 503 MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED). */
1132
1181
  enabled: boolean;
1133
1182
  endpoint: string;
1134
1183
  formats: {
@@ -1182,8 +1231,8 @@ interface ClientConfig {
1182
1231
  language?: string;
1183
1232
  /**
1184
1233
  * Sign / certificate-choice session-ий `expiresAt`-ийг тооцоолох хугацаа (мс). Анхдагч 600000
1185
- * ({@link DEFAULT_SIGN_SESSION_TTL_MS}, CA-ийн анхдагч); CA-ийн админ тохиргоог өөрчилсөн бол тааруул. CA session start
1186
- * хариунд хугацаа буцаадаггүй.
1234
+ * ({@link DEFAULT_SIGN_SESSION_TTL_MS}, CA-ийн анхдагч); CA-ийн админ тохиргоог өөрчилсөн бол тааруул. Зөвхөн CA-ийн
1235
+ * start хариунд `expiresAt` ирээгүй (хуучин CA) үед хэрэглэгдэнэ.
1187
1236
  */
1188
1237
  signSessionTtlMs?: number;
1189
1238
  /** Trust anchor (Root CA) — validator-д. Production-д ЗААВАЛ. */
@@ -1214,8 +1263,8 @@ declare class EidClient {
1214
1263
  /**
1215
1264
  * `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
1216
1265
  * имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
1217
- * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
1218
- * SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
1266
+ * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. Имэйл/шалгагч тохируулаагүй бол 503
1267
+ * MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED) — {@link shareInfo}-оор урьдчилан шалга.
1219
1268
  */
1220
1269
  share(input: ShareInput): Promise<ShareResult>;
1221
1270
  /** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
@@ -1246,7 +1295,7 @@ interface OcspCheckerOptions {
1246
1295
  /**
1247
1296
  * AIA OCSP-оор цуцлалт шалгагч ({@link RevocationChecker}):
1248
1297
  *
1249
- * - good → "good" (5 мин кэшлэнэ);
1298
+ * - good → "good" (min(5 мин, хариуны nextUpdate) кэшлэнэ);
1250
1299
  * - revoked, мөн unknown (олгогч энэ serial-ийг олгоогүй — өөр хэн нэгний хийсэн гэрчилгээ) → "revoked";
1251
1300
  * - хариугүй (AIA алга, issuer олдоогүй, timeout, HTTP ≠ 200, гарын үсэг/serial/хугацаа таараагүй) → "unknown" —
1252
1301
  * `revocationMode` шийднэ: soft-fail — зөвшөөрнө ("unchecked"), hard-fail — татгалзана.
@@ -1267,7 +1316,7 @@ declare function randomChallenge(bytes?: number): string;
1267
1316
  declare function interactionsToBase64(interactions: Interaction[]): string;
1268
1317
  /** ACSP_V2 payload-ийн бүх орц (Smart-ID v3 §ACSP_V2 digest calculation). */
1269
1318
  interface AcspV2Params {
1270
- /** default "smart-id" (серверийн SMARTID_ACSP_SCHEME_NAME-тэй ижил). */
1319
+ /** default "smart-id" (серверийн EID_ACSP_SCHEME_NAME-тэй ижил). */
1271
1320
  schemeName?: string;
1272
1321
  serverRandom: string;
1273
1322
  rpChallenge: string;
@@ -1548,7 +1597,8 @@ interface EidLoginOptions {
1548
1597
  /**
1549
1598
  * Push start-ийн хариу (бодит, decoy, 502) хамгийн багадаа энэ хугацаанд (мс) гарна: decoy микросекундэд, бодит push
1550
1599
  * eID-ийн round trip-ээр бэлэн болдог тул цаг нь л ялгана. Анхдагч 1000; `0` — унтраана (⚠️ decoy-г хугацаагаар
1551
- * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. 429 ба 400-д хамаарахгүй.
1600
+ * ялгаж болно). Хүсэлт тасарвал (`signal`) хүлээхгүй. Хязгаарлагчийн 429 ба 400-д
1601
+ * хамаарахгүй (eID-ийн 429 ба 503 `busy` floor-той).
1552
1602
  */
1553
1603
  pushFloorMs?: number;
1554
1604
  /**
@@ -1611,4 +1661,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1611
1661
  */
1612
1662
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1613
1663
 
1614
- export { APP_ATTESTATION_INVALID, 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, MAX_APP_TRANSACTION_BYTES, 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, type SessionTtl, 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 TokenCertPreview, 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 };
1664
+ export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, 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, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, 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, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, 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 };
package/dist/index.js CHANGED
@@ -364,6 +364,15 @@ var AuthApi = class {
364
364
 
365
365
  // src/sign.ts
366
366
  function registrationFromCompleted(done, extra) {
367
+ const fail2 = (m) => {
368
+ throw new ValidationError(`registrationFromCompleted: ${m}`);
369
+ };
370
+ const sessionID = extra.sessionID?.trim() ?? "";
371
+ const medium = extra.medium || (sessionID ? "phone" : "token");
372
+ if (medium !== "phone" && medium !== "token") fail2("medium: phone | token");
373
+ if (medium === "phone" && !sessionID) fail2("medium phone-\u0434 sessionID \u0437\u0430\u0430\u0432\u0430\u043B");
374
+ if (medium === "token" && sessionID) fail2("medium token-\u0434 sessionID \u0438\u043B\u0433\u044D\u044D\u0445\u0433\u04AF\u0439");
375
+ if (done.claimedRole && !extra.onBehalfOf?.trim()) fail2("claimedRole-\u0442\u043E\u0439 \u0433\u0430\u0440\u044B\u043D \u04AF\u0441\u044D\u0433\u0442 onBehalfOf (NTRMN-\u2026) \u0437\u0430\u0430\u0432\u0430\u043B");
367
376
  const out = {
368
377
  docID: done.docId,
369
378
  revIndex: done.revIndex,
@@ -373,8 +382,8 @@ function registrationFromCompleted(done, extra) {
373
382
  sigRevSha256: done.sigRevSha256,
374
383
  outSha256: done.outSha256
375
384
  };
376
- if (extra.medium) out.medium = extra.medium;
377
- if (extra.sessionID) out.sessionID = extra.sessionID;
385
+ out.medium = medium;
386
+ if (sessionID) out.sessionID = sessionID;
378
387
  if (done.hasPage && done.pageSha256) out.pageSha256 = done.pageSha256;
379
388
  if (extra.priorRevisionSha256?.length) {
380
389
  if (done.priorCmsSha256.length) out.priorCmsSha256 = done.priorCmsSha256;
@@ -432,6 +441,7 @@ function buildRegisterBody(input) {
432
441
  const medium = input.medium ?? (sessionID ? "phone" : "token");
433
442
  if (medium !== "phone" && medium !== "token") fail2("medium: phone | token");
434
443
  if (medium === "phone" && !sessionID) fail2("phone-\u0434 sessionID \u0437\u0430\u0430\u0432\u0430\u043B");
444
+ if (medium === "token" && sessionID) fail2("token-\u0434 sessionID \u0438\u043B\u0433\u044D\u044D\u0445\u0433\u04AF\u0439");
435
445
  const priorCms = (input.priorCmsSha256 ?? []).map((h, i) => hex(`priorCmsSha256[${i}]`, h));
436
446
  const priorRev = (input.priorRevisionSha256 ?? []).map((h, i) => hex(`priorRevisionSha256[${i}]`, h));
437
447
  if (priorCms.length + priorRev.length !== input.revIndex - 1) fail2("priorCmsSha256 + priorRevisionSha256-\u0438\u0439\u043D \u0442\u043E\u043E = revIndex \u2212 1");
@@ -723,7 +733,9 @@ var SignApi = class {
723
733
 
724
734
  // src/session.ts
725
735
  var SERVER_POLL_MS = 3e4;
726
- var MAX_WAIT_MS = 15e4;
736
+ var DEFAULT_MAX_WAIT_MS = 6e5;
737
+ var WAIT_GRACE_MS = 15e3;
738
+ var DISCOVERY_TIMEOUT_MS = 5e3;
727
739
  function asRecord(v) {
728
740
  return v && typeof v === "object" ? v : {};
729
741
  }
@@ -832,11 +844,14 @@ var SessionApi = class {
832
844
  return parseSessionResult(raw);
833
845
  }
834
846
  /**
835
- * COMPLETE болтол давтаж poll хийнэ. maxWaitMs дуустал хүлээгээд гараагүй бол сүүлчийн
847
+ * COMPLETE болтол давтаж poll хийнэ. Анхдагчаар session-ий амьдрах хугацаа дуустал хүлээнэ: `expiresAt` (start
848
+ * хариуны `expiresAt`, мс epoch) + {@link WAIT_GRACE_MS}; алга бол discovery `sessionTtl` (max(auth, sign)) + grace;
849
+ * тэр нь ч мэдэгдэхгүй бол {@link DEFAULT_MAX_WAIT_MS}. `maxWaitMs` өгвөл түүнийг л дагана. CA хугацаа дууссан
850
+ * session-ийг COMPLETE/TIMEOUT болгодог тул ердийн үед тэр үр дүн ирнэ; хугацаа дуустал COMPLETE болоогүй бол сүүлчийн
836
851
  * (RUNNING) үр дүнг буцаана — дуудагч endResult==null-ийг TIMEOUT мэт боловсруулна.
837
852
  */
838
853
  async waitForResult(sessionId, opts) {
839
- const deadline = Date.now() + (opts?.maxWaitMs ?? MAX_WAIT_MS);
854
+ const deadline = await this.waitDeadline(opts);
840
855
  const pollMs = opts?.serverPollMs ?? SERVER_POLL_MS;
841
856
  let last = { state: "RUNNING" };
842
857
  while (Date.now() < deadline) {
@@ -846,6 +861,22 @@ var SessionApi = class {
846
861
  }
847
862
  return last;
848
863
  }
864
+ /** waitForResult-ийн дуусах мөч (мс epoch): maxWaitMs > expiresAt > discovery sessionTtl > DEFAULT_MAX_WAIT_MS. */
865
+ async waitDeadline(opts) {
866
+ const now = Date.now();
867
+ if (opts?.maxWaitMs !== void 0) return now + opts.maxWaitMs;
868
+ if (opts?.expiresAt !== void 0 && Number.isFinite(opts.expiresAt)) {
869
+ return Math.max(opts.expiresAt + WAIT_GRACE_MS, now + 1e3);
870
+ }
871
+ try {
872
+ const t = asRecord(asRecord(await this.http.get("/.well-known/eid", DISCOVERY_TIMEOUT_MS)).sessionTtl);
873
+ const sec = (v) => typeof v === "number" && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0;
874
+ const ttl = Math.max(sec(t.auth), sec(t.sign)) * 1e3;
875
+ if (ttl > 0) return now + ttl + WAIT_GRACE_MS;
876
+ } catch {
877
+ }
878
+ return now + DEFAULT_MAX_WAIT_MS;
879
+ }
849
880
  };
850
881
 
851
882
  // src/organization.ts
@@ -1688,6 +1719,40 @@ function hexSha256Equal(hex, data) {
1688
1719
  return timingSafeEqual(createHash3("sha256").update(data).digest(), Buffer.from(hex, "hex"));
1689
1720
  }
1690
1721
  var TOKEN_CONFLICT_CODES = ["TOKEN_LIMIT_REACHED", "TOKEN_IN_USE", "TOKEN_SCOPE_CHANGE", "ACCOUNT_DELETE_PENDING"];
1722
+ var TOKEN_ISSUANCE_PENDING = "TOKEN_ISSUANCE_PENDING";
1723
+ var KYC_INCOMPLETE = "KYC_INCOMPLETE";
1724
+ var NO_ACTIVE_DEVICE = "NO_ACTIVE_DEVICE";
1725
+ var CSR_KEY_REUSED = "CSR_KEY_REUSED";
1726
+ var TOKEN_ERROR_CODES = [
1727
+ ...TOKEN_CONFLICT_CODES,
1728
+ "APP_ATTESTATION_INVALID",
1729
+ "TOKEN_ISSUANCE_PENDING",
1730
+ "KYC_INCOMPLETE",
1731
+ "NO_ACTIVE_DEVICE",
1732
+ "CSR_KEY_REUSED",
1733
+ "CSR_INVALID",
1734
+ "CSR_KEY_UNSUPPORTED",
1735
+ "CSR_SIGNATURE_INVALID",
1736
+ "CSR_KEYS_IDENTICAL",
1737
+ "ISSUANCE_FAILED",
1738
+ "RESULT_EXPIRED",
1739
+ "CSR_DIGEST_MISMATCH",
1740
+ "SIGNER_CERT_CHANGED",
1741
+ "ISSUANCE_ERROR",
1742
+ "REGISTRY_FAILED",
1743
+ "RP_REQUIRED",
1744
+ "CHALLENGE_EXPIRED",
1745
+ "CHALLENGE_USED",
1746
+ "CERT_INVALID",
1747
+ "CERT_NOT_ACTIVE",
1748
+ "REQUEST_INVALID",
1749
+ "SIGNATURE_INVALID",
1750
+ "SESSION_MISMATCH",
1751
+ "SESSION_NOT_COMPLETE",
1752
+ "SESSION_FAILED",
1753
+ ...ON_BEHALF_ERROR_CODES,
1754
+ ...RETRYABLE_ERROR_CODES
1755
+ ];
1691
1756
  function supersedesOf(v) {
1692
1757
  return Array.isArray(v) ? { supersedes: v.map((x) => ({ tokenSerial: String(rec4(x).tokenSerial ?? "") })) } : {};
1693
1758
  }
@@ -2110,8 +2175,8 @@ var EidClient = class {
2110
2175
  /**
2111
2176
  * `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
2112
2177
  * имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
2113
- * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
2114
- * SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
2178
+ * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. Имэйл/шалгагч тохируулаагүй бол 503
2179
+ * MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED) — {@link shareInfo}-оор урьдчилан шалга.
2115
2180
  */
2116
2181
  share(input) {
2117
2182
  return shareFile(this.http, input);
@@ -2164,7 +2229,7 @@ function ocspRevocationChecker(opts = {}) {
2164
2229
  const tu = resp.thisUpdate.date.getTime();
2165
2230
  if (tu > t + CLOCK_SKEW_MS || tu < t - MAX_AGE_MS) continue;
2166
2231
  if (resp.nextUpdate && resp.nextUpdate.getTime() < t) continue;
2167
- return resp.status === "good" ? "good" : "revoked";
2232
+ return { status: resp.status === "good" ? "good" : "revoked", nextUpdate: resp.nextUpdate?.getTime() };
2168
2233
  } catch {
2169
2234
  }
2170
2235
  }
@@ -2182,13 +2247,17 @@ function ocspRevocationChecker(opts = {}) {
2182
2247
  const key = createHash4("sha256").update(issuer.raw).digest("hex").slice(0, 16) + ":" + cert.serialNumber;
2183
2248
  const exp = cache.get(key);
2184
2249
  if (exp !== void 0 && now() < exp) return "good";
2185
- const status = await ask(leaf, iss);
2186
- if (!status) return "unknown";
2187
- if (status === "good") {
2188
- if (cache.size >= CACHE_MAX) cache.clear();
2189
- cache.set(key, now() + CACHE_TTL_MS);
2250
+ const r = await ask(leaf, iss);
2251
+ if (!r) return "unknown";
2252
+ if (r.status === "good") {
2253
+ const t = now();
2254
+ const until = Math.min(t + CACHE_TTL_MS, r.nextUpdate ?? Infinity);
2255
+ if (until > t) {
2256
+ if (cache.size >= CACHE_MAX) cache.clear();
2257
+ cache.set(key, until);
2258
+ }
2190
2259
  }
2191
- return status;
2260
+ return r.status;
2192
2261
  };
2193
2262
  }
2194
2263
 
@@ -2886,8 +2955,10 @@ export {
2886
2955
  AuthenticationError,
2887
2956
  CITIZEN_INTERMEDIATES_PEM,
2888
2957
  CITIZEN_ISSUING_CA_SKI,
2958
+ CSR_KEY_REUSED,
2889
2959
  CertChoiceInvalidError,
2890
2960
  DEFAULT_BASE_URL,
2961
+ DEFAULT_MAX_WAIT_MS,
2891
2962
  DEFAULT_PDF_TIMEOUT_MS,
2892
2963
  DEFAULT_SHARE_TIMEOUT_MS,
2893
2964
  DEFAULT_SIGN_SESSION_TTL_MS,
@@ -2896,10 +2967,12 @@ export {
2896
2967
  EidError,
2897
2968
  ForbiddenError,
2898
2969
  Http,
2970
+ KYC_INCOMPLETE,
2899
2971
  LoginStoreFullError,
2900
2972
  MAX_APP_TRANSACTION_BYTES,
2901
2973
  MEMORY_LOGIN_STORE_MAX,
2902
2974
  NATIONAL_ROOT_CA_PEM,
2975
+ NO_ACTIVE_DEVICE,
2903
2976
  NetworkError,
2904
2977
  NoSigningCertificateError,
2905
2978
  ON_BEHALF_ERROR_CODES,
@@ -2918,8 +2991,11 @@ export {
2918
2991
  ShareError,
2919
2992
  SignApi,
2920
2993
  TOKEN_CONFLICT_CODES,
2994
+ TOKEN_ERROR_CODES,
2995
+ TOKEN_ISSUANCE_PENDING,
2921
2996
  TokenApi,
2922
2997
  ValidationError,
2998
+ WAIT_GRACE_MS,
2923
2999
  acspV2Digest,
2924
3000
  buildAcspV2Payload,
2925
3001
  buildDeviceLink,
package/dist/pades.cjs CHANGED
@@ -5323,7 +5323,7 @@ async function complete2(state, signature, opts = {}) {
5323
5323
  const now = opts.now ?? (() => /* @__PURE__ */ new Date());
5324
5324
  const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
5325
5325
  const fetchFn = opts.fetch ?? globalThis.fetch?.bind(globalThis);
5326
- if (!fetchFn) throw new PadesError("TSA_UNAVAILABLE", "fetch \u0430\u043B\u0433\u0430 (Node \u2265 18 \u044D\u0441\u0432\u044D\u043B opts.fetch)");
5326
+ if (!fetchFn) throw new PadesError("REQUEST_INVALID", "fetch \u0430\u043B\u0433\u0430 (Node \u2265 18 \u044D\u0441\u0432\u044D\u043B opts.fetch)");
5327
5327
  const ltvRetries = opts.ltvRetries ?? DEFAULT_LTV_RETRIES;
5328
5328
  if (!Number.isInteger(ltvRetries) || ltvRetries < 0 || ltvRetries > MAX_LTV_RETRIES) {
5329
5329
  throw new PadesError("REQUEST_INVALID", `ltvRetries 0\u2013${MAX_LTV_RETRIES} \u0431\u04AF\u0445\u044D\u043B \u0442\u043E\u043E`);
@@ -5405,7 +5405,8 @@ async function complete2(state, signature, opts = {}) {
5405
5405
  sigRevSha256: toHex(await sha256(signed)),
5406
5406
  priorCmsSha256: prior,
5407
5407
  priorRevisionSha256: priorRev,
5408
- signerCert: cert.raw
5408
+ signerCert: cert.raw,
5409
+ claimedRole: st.claimedRole
5409
5410
  };
5410
5411
  }
5411
5412
  // Annotate the CommonJS export names for ESM import in node: