@gerege-systems/eid-mongolia-sdk 0.25.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.cjs CHANGED
@@ -27,8 +27,10 @@ __export(index_exports, {
27
27
  AuthenticationError: () => AuthenticationError,
28
28
  CITIZEN_INTERMEDIATES_PEM: () => CITIZEN_INTERMEDIATES_PEM,
29
29
  CITIZEN_ISSUING_CA_SKI: () => CITIZEN_ISSUING_CA_SKI,
30
+ CSR_KEY_REUSED: () => CSR_KEY_REUSED,
30
31
  CertChoiceInvalidError: () => CertChoiceInvalidError,
31
32
  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
33
+ DEFAULT_MAX_WAIT_MS: () => DEFAULT_MAX_WAIT_MS,
32
34
  DEFAULT_PDF_TIMEOUT_MS: () => DEFAULT_PDF_TIMEOUT_MS,
33
35
  DEFAULT_SHARE_TIMEOUT_MS: () => DEFAULT_SHARE_TIMEOUT_MS,
34
36
  DEFAULT_SIGN_SESSION_TTL_MS: () => DEFAULT_SIGN_SESSION_TTL_MS,
@@ -37,10 +39,12 @@ __export(index_exports, {
37
39
  EidError: () => EidError,
38
40
  ForbiddenError: () => ForbiddenError,
39
41
  Http: () => Http,
42
+ KYC_INCOMPLETE: () => KYC_INCOMPLETE,
40
43
  LoginStoreFullError: () => LoginStoreFullError,
41
44
  MAX_APP_TRANSACTION_BYTES: () => MAX_APP_TRANSACTION_BYTES,
42
45
  MEMORY_LOGIN_STORE_MAX: () => MEMORY_LOGIN_STORE_MAX,
43
46
  NATIONAL_ROOT_CA_PEM: () => NATIONAL_ROOT_CA_PEM,
47
+ NO_ACTIVE_DEVICE: () => NO_ACTIVE_DEVICE,
44
48
  NetworkError: () => NetworkError,
45
49
  NoSigningCertificateError: () => NoSigningCertificateError,
46
50
  ON_BEHALF_ERROR_CODES: () => ON_BEHALF_ERROR_CODES,
@@ -59,8 +63,11 @@ __export(index_exports, {
59
63
  ShareError: () => ShareError,
60
64
  SignApi: () => SignApi,
61
65
  TOKEN_CONFLICT_CODES: () => TOKEN_CONFLICT_CODES,
66
+ TOKEN_ERROR_CODES: () => TOKEN_ERROR_CODES,
67
+ TOKEN_ISSUANCE_PENDING: () => TOKEN_ISSUANCE_PENDING,
62
68
  TokenApi: () => TokenApi,
63
69
  ValidationError: () => ValidationError,
70
+ WAIT_GRACE_MS: () => WAIT_GRACE_MS,
64
71
  acspV2Digest: () => acspV2Digest,
65
72
  buildAcspV2Payload: () => buildAcspV2Payload,
66
73
  buildDeviceLink: () => buildDeviceLink,
@@ -579,6 +586,15 @@ var AuthApi = class {
579
586
 
580
587
  // src/sign.ts
581
588
  function registrationFromCompleted(done, extra) {
589
+ const fail2 = (m) => {
590
+ throw new ValidationError(`registrationFromCompleted: ${m}`);
591
+ };
592
+ const sessionID = extra.sessionID?.trim() ?? "";
593
+ const medium = extra.medium || (sessionID ? "phone" : "token");
594
+ if (medium !== "phone" && medium !== "token") fail2("medium: phone | token");
595
+ if (medium === "phone" && !sessionID) fail2("medium phone-\u0434 sessionID \u0437\u0430\u0430\u0432\u0430\u043B");
596
+ if (medium === "token" && sessionID) fail2("medium token-\u0434 sessionID \u0438\u043B\u0433\u044D\u044D\u0445\u0433\u04AF\u0439");
597
+ 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");
582
598
  const out = {
583
599
  docID: done.docId,
584
600
  revIndex: done.revIndex,
@@ -588,8 +604,8 @@ function registrationFromCompleted(done, extra) {
588
604
  sigRevSha256: done.sigRevSha256,
589
605
  outSha256: done.outSha256
590
606
  };
591
- if (extra.medium) out.medium = extra.medium;
592
- if (extra.sessionID) out.sessionID = extra.sessionID;
607
+ out.medium = medium;
608
+ if (sessionID) out.sessionID = sessionID;
593
609
  if (done.hasPage && done.pageSha256) out.pageSha256 = done.pageSha256;
594
610
  if (extra.priorRevisionSha256?.length) {
595
611
  if (done.priorCmsSha256.length) out.priorCmsSha256 = done.priorCmsSha256;
@@ -647,6 +663,7 @@ function buildRegisterBody(input) {
647
663
  const medium = input.medium ?? (sessionID ? "phone" : "token");
648
664
  if (medium !== "phone" && medium !== "token") fail2("medium: phone | token");
649
665
  if (medium === "phone" && !sessionID) fail2("phone-\u0434 sessionID \u0437\u0430\u0430\u0432\u0430\u043B");
666
+ if (medium === "token" && sessionID) fail2("token-\u0434 sessionID \u0438\u043B\u0433\u044D\u044D\u0445\u0433\u04AF\u0439");
650
667
  const priorCms = (input.priorCmsSha256 ?? []).map((h, i) => hex(`priorCmsSha256[${i}]`, h));
651
668
  const priorRev = (input.priorRevisionSha256 ?? []).map((h, i) => hex(`priorRevisionSha256[${i}]`, h));
652
669
  if (priorCms.length + priorRev.length !== input.revIndex - 1) fail2("priorCmsSha256 + priorRevisionSha256-\u0438\u0439\u043D \u0442\u043E\u043E = revIndex \u2212 1");
@@ -938,7 +955,9 @@ var SignApi = class {
938
955
 
939
956
  // src/session.ts
940
957
  var SERVER_POLL_MS = 3e4;
941
- var MAX_WAIT_MS = 15e4;
958
+ var DEFAULT_MAX_WAIT_MS = 6e5;
959
+ var WAIT_GRACE_MS = 15e3;
960
+ var DISCOVERY_TIMEOUT_MS = 5e3;
942
961
  function asRecord(v) {
943
962
  return v && typeof v === "object" ? v : {};
944
963
  }
@@ -1047,11 +1066,14 @@ var SessionApi = class {
1047
1066
  return parseSessionResult(raw);
1048
1067
  }
1049
1068
  /**
1050
- * COMPLETE болтол давтаж poll хийнэ. maxWaitMs дуустал хүлээгээд гараагүй бол сүүлчийн
1069
+ * COMPLETE болтол давтаж poll хийнэ. Анхдагчаар session-ий амьдрах хугацаа дуустал хүлээнэ: `expiresAt` (start
1070
+ * хариуны `expiresAt`, мс epoch) + {@link WAIT_GRACE_MS}; алга бол discovery `sessionTtl` (max(auth, sign)) + grace;
1071
+ * тэр нь ч мэдэгдэхгүй бол {@link DEFAULT_MAX_WAIT_MS}. `maxWaitMs` өгвөл түүнийг л дагана. CA хугацаа дууссан
1072
+ * session-ийг COMPLETE/TIMEOUT болгодог тул ердийн үед тэр үр дүн ирнэ; хугацаа дуустал COMPLETE болоогүй бол сүүлчийн
1051
1073
  * (RUNNING) үр дүнг буцаана — дуудагч endResult==null-ийг TIMEOUT мэт боловсруулна.
1052
1074
  */
1053
1075
  async waitForResult(sessionId, opts) {
1054
- const deadline = Date.now() + (opts?.maxWaitMs ?? MAX_WAIT_MS);
1076
+ const deadline = await this.waitDeadline(opts);
1055
1077
  const pollMs = opts?.serverPollMs ?? SERVER_POLL_MS;
1056
1078
  let last = { state: "RUNNING" };
1057
1079
  while (Date.now() < deadline) {
@@ -1061,6 +1083,22 @@ var SessionApi = class {
1061
1083
  }
1062
1084
  return last;
1063
1085
  }
1086
+ /** waitForResult-ийн дуусах мөч (мс epoch): maxWaitMs > expiresAt > discovery sessionTtl > DEFAULT_MAX_WAIT_MS. */
1087
+ async waitDeadline(opts) {
1088
+ const now = Date.now();
1089
+ if (opts?.maxWaitMs !== void 0) return now + opts.maxWaitMs;
1090
+ if (opts?.expiresAt !== void 0 && Number.isFinite(opts.expiresAt)) {
1091
+ return Math.max(opts.expiresAt + WAIT_GRACE_MS, now + 1e3);
1092
+ }
1093
+ try {
1094
+ const t = asRecord(asRecord(await this.http.get("/.well-known/eid", DISCOVERY_TIMEOUT_MS)).sessionTtl);
1095
+ const sec = (v) => typeof v === "number" && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0;
1096
+ const ttl = Math.max(sec(t.auth), sec(t.sign)) * 1e3;
1097
+ if (ttl > 0) return now + ttl + WAIT_GRACE_MS;
1098
+ } catch {
1099
+ }
1100
+ return now + DEFAULT_MAX_WAIT_MS;
1101
+ }
1064
1102
  };
1065
1103
 
1066
1104
  // src/organization.ts
@@ -1921,6 +1959,40 @@ function hexSha256Equal(hex, data) {
1921
1959
  return (0, import_node_crypto4.timingSafeEqual)((0, import_node_crypto4.createHash)("sha256").update(data).digest(), Buffer.from(hex, "hex"));
1922
1960
  }
1923
1961
  var TOKEN_CONFLICT_CODES = ["TOKEN_LIMIT_REACHED", "TOKEN_IN_USE", "TOKEN_SCOPE_CHANGE", "ACCOUNT_DELETE_PENDING"];
1962
+ var TOKEN_ISSUANCE_PENDING = "TOKEN_ISSUANCE_PENDING";
1963
+ var KYC_INCOMPLETE = "KYC_INCOMPLETE";
1964
+ var NO_ACTIVE_DEVICE = "NO_ACTIVE_DEVICE";
1965
+ var CSR_KEY_REUSED = "CSR_KEY_REUSED";
1966
+ var TOKEN_ERROR_CODES = [
1967
+ ...TOKEN_CONFLICT_CODES,
1968
+ "APP_ATTESTATION_INVALID",
1969
+ "TOKEN_ISSUANCE_PENDING",
1970
+ "KYC_INCOMPLETE",
1971
+ "NO_ACTIVE_DEVICE",
1972
+ "CSR_KEY_REUSED",
1973
+ "CSR_INVALID",
1974
+ "CSR_KEY_UNSUPPORTED",
1975
+ "CSR_SIGNATURE_INVALID",
1976
+ "CSR_KEYS_IDENTICAL",
1977
+ "ISSUANCE_FAILED",
1978
+ "RESULT_EXPIRED",
1979
+ "CSR_DIGEST_MISMATCH",
1980
+ "SIGNER_CERT_CHANGED",
1981
+ "ISSUANCE_ERROR",
1982
+ "REGISTRY_FAILED",
1983
+ "RP_REQUIRED",
1984
+ "CHALLENGE_EXPIRED",
1985
+ "CHALLENGE_USED",
1986
+ "CERT_INVALID",
1987
+ "CERT_NOT_ACTIVE",
1988
+ "REQUEST_INVALID",
1989
+ "SIGNATURE_INVALID",
1990
+ "SESSION_MISMATCH",
1991
+ "SESSION_NOT_COMPLETE",
1992
+ "SESSION_FAILED",
1993
+ ...ON_BEHALF_ERROR_CODES,
1994
+ ...RETRYABLE_ERROR_CODES
1995
+ ];
1924
1996
  function supersedesOf(v) {
1925
1997
  return Array.isArray(v) ? { supersedes: v.map((x) => ({ tokenSerial: String(rec4(x).tokenSerial ?? "") })) } : {};
1926
1998
  }
@@ -2343,8 +2415,8 @@ var EidClient = class {
2343
2415
  /**
2344
2416
  * `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
2345
2417
  * имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
2346
- * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
2347
- * SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
2418
+ * `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. Имэйл/шалгагч тохируулаагүй бол 503
2419
+ * MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE (хуучин CA: SHARE_DISABLED) — {@link shareInfo}-оор урьдчилан шалга.
2348
2420
  */
2349
2421
  share(input) {
2350
2422
  return shareFile(this.http, input);
@@ -3018,7 +3090,7 @@ function ocspRevocationChecker(opts = {}) {
3018
3090
  const tu = resp.thisUpdate.date.getTime();
3019
3091
  if (tu > t + CLOCK_SKEW_MS || tu < t - MAX_AGE_MS) continue;
3020
3092
  if (resp.nextUpdate && resp.nextUpdate.getTime() < t) continue;
3021
- return resp.status === "good" ? "good" : "revoked";
3093
+ return { status: resp.status === "good" ? "good" : "revoked", nextUpdate: resp.nextUpdate?.getTime() };
3022
3094
  } catch {
3023
3095
  }
3024
3096
  }
@@ -3036,13 +3108,17 @@ function ocspRevocationChecker(opts = {}) {
3036
3108
  const key = (0, import_node_crypto5.createHash)("sha256").update(issuer.raw).digest("hex").slice(0, 16) + ":" + cert.serialNumber;
3037
3109
  const exp = cache.get(key);
3038
3110
  if (exp !== void 0 && now() < exp) return "good";
3039
- const status = await ask(leaf, iss);
3040
- if (!status) return "unknown";
3041
- if (status === "good") {
3042
- if (cache.size >= CACHE_MAX) cache.clear();
3043
- cache.set(key, now() + CACHE_TTL_MS);
3111
+ const r = await ask(leaf, iss);
3112
+ if (!r) return "unknown";
3113
+ if (r.status === "good") {
3114
+ const t = now();
3115
+ const until = Math.min(t + CACHE_TTL_MS, r.nextUpdate ?? Infinity);
3116
+ if (until > t) {
3117
+ if (cache.size >= CACHE_MAX) cache.clear();
3118
+ cache.set(key, until);
3119
+ }
3044
3120
  }
3045
- return status;
3121
+ return r.status;
3046
3122
  };
3047
3123
  }
3048
3124
 
@@ -3751,8 +3827,10 @@ function createEidLogin(opts) {
3751
3827
  AuthenticationError,
3752
3828
  CITIZEN_INTERMEDIATES_PEM,
3753
3829
  CITIZEN_ISSUING_CA_SKI,
3830
+ CSR_KEY_REUSED,
3754
3831
  CertChoiceInvalidError,
3755
3832
  DEFAULT_BASE_URL,
3833
+ DEFAULT_MAX_WAIT_MS,
3756
3834
  DEFAULT_PDF_TIMEOUT_MS,
3757
3835
  DEFAULT_SHARE_TIMEOUT_MS,
3758
3836
  DEFAULT_SIGN_SESSION_TTL_MS,
@@ -3761,10 +3839,12 @@ function createEidLogin(opts) {
3761
3839
  EidError,
3762
3840
  ForbiddenError,
3763
3841
  Http,
3842
+ KYC_INCOMPLETE,
3764
3843
  LoginStoreFullError,
3765
3844
  MAX_APP_TRANSACTION_BYTES,
3766
3845
  MEMORY_LOGIN_STORE_MAX,
3767
3846
  NATIONAL_ROOT_CA_PEM,
3847
+ NO_ACTIVE_DEVICE,
3768
3848
  NetworkError,
3769
3849
  NoSigningCertificateError,
3770
3850
  ON_BEHALF_ERROR_CODES,
@@ -3783,8 +3863,11 @@ function createEidLogin(opts) {
3783
3863
  ShareError,
3784
3864
  SignApi,
3785
3865
  TOKEN_CONFLICT_CODES,
3866
+ TOKEN_ERROR_CODES,
3867
+ TOKEN_ISSUANCE_PENDING,
3786
3868
  TokenApi,
3787
3869
  ValidationError,
3870
+ WAIT_GRACE_MS,
3788
3871
  acspV2Digest,
3789
3872
  buildAcspV2Payload,
3790
3873
  buildDeviceLink,
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 };