@gerege-systems/eid-mongolia-sdk 0.42.0 → 0.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1026,9 +1026,83 @@ writeFileSync("sealed.pdf", done.pdf); // PAdES-BASELINE-LT, байгуулла
1026
1026
  - Алдаа: `PadesError` `SIGNER_INVALID` (cert e-Seal биш, эсвэл тамгалах хооронд cert солигдсон — дахин оролд),
1027
1027
  `SIGNATURE_INVALID`, `TSA_UNAVAILABLE` / `LTV_UNAVAILABLE` (`retryable`); RP-API-ийн алдаа хэвээр: **429
1028
1028
  `RATE_LIMITED`** → `ApiError` (`retryable`, `retryAfterMs`-ийн дараа дахин), 404 — байгууллага олдсонгүй, 409 —
1029
- байгууллага ACTIVE биш эсвэл идэвхтэй тамганы гэрчилгээ алга/цуцлагдсан.
1030
- - Тамганы гэрчилгээ олгох (`POST /seal/certificate/{orgEtsi}`) энэ хувилбарт алга — байгууллагын захирлын
1031
- баталгаажуулалттай олголтын урсгал CA-д нэвтэрмэгц нэмэгдэнэ. Go: `pades.SealPDF`; .NET: `EidPades.SealAsync`.
1029
+ байгууллага ACTIVE биш эсвэл идэвхтэй тамганы гэрчилгээ алга/цуцлагдсан, **503 `SEAL_SERVICE_DISABLED`** →
1030
+ `SealServiceDisabledError` (доорх «Үйлчилгээ унтраалттай»).
1031
+ - `eid.seal.getCertificate(org)` нь байгууллагын **одоогийн (олгогдсон, идэвхтэй)** тамганы гэрчилгээг буцаана — шинээр
1032
+ олгохгүй; идэвхтэй cert алга / цуцлагдсан бол 409. Go: `pades.SealPDF`; .NET: `EidPades.SealAsync`.
1033
+
1034
+ ### Тамганы гэрчилгээ олгуулах (0.43.0)
1035
+
1036
+ Гэрчилгээг RP ч, оператор ч шууд гаргахгүй — **хүсэлт** үүсгэнэ. Байгууллагын хүчинтэй **ADMIN** төлөөлөгч бүр (идэвхтэй
1037
+ eID төхөөрөмжтэй, ≤ 5) eID аппад «"<байгууллага>"-ын цахим тамганы гэрчилгээ олгохыг зөвшөөрч байна» хүсэлт хүлээн авч
1038
+ **PIN2**-оор батална. Нэг ADMIN баталмагц гэрчилгээ гарна (`ISSUED`); татгалзвал `REJECTED`; батлах хугацаа (гарын
1039
+ үсгийн session TTL + 2 мин) дуусвал `EXPIRED`.
1040
+
1041
+ ```ts
1042
+ import { SealApproverUnavailableError, SealCertificateRequestError } from "@gerege-systems/eid-mongolia-sdk";
1043
+
1044
+ const req = await eid.seal.requestCertificate("NTRMN-6235972"); // 202 {requestId, status: "PENDING", expiresAt, approvers}
1045
+ try {
1046
+ const cert = await eid.seal.waitForCertificate("NTRMN-6235972", req.requestId, { timeoutMs: 10 * 60_000 });
1047
+ // cert: {certificate (DER), serialNumber, notBefore, notAfter, certificateLevel, …} — getCertificate-тэй ижил хэлбэр
1048
+ } catch (e) {
1049
+ if (e instanceof SealCertificateRequestError) {
1050
+ // e.outcome: "REJECTED" | "EXPIRED" | "FAILED" → шинэ хүсэлт; "TIMEOUT" → ижил requestId-аар дахин хүлээж болно
1051
+ } else if (e instanceof SealApproverUnavailableError) {
1052
+ // (requestCertificate) байгууллагад идэвхтэй eID-тэй ADMIN алга
1053
+ } else throw e;
1054
+ }
1055
+ ```
1056
+
1057
+ - `requestCertificate(org)` — `POST /seal/certificate/{orgEtsi}` → `SealCertificateRequest` (`requestId`, `status:
1058
+ "PENDING"`, `createdAt`, `expiresAt`, `approvers`). Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй).
1059
+ - `getCertificateRequest(org, requestId)` — `GET /seal/certificate/{orgEtsi}/requests/{requestId}`: `status` = `PENDING` |
1060
+ `APPROVED` (олгогдож байна) | `ISSUED` (`certificate` бөглөгдсөн) | `REJECTED` | `EXPIRED` | `FAILED` (`failure`:
1061
+ `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` | `SEAL_SERVICE_DISABLED`). Нэг удаагийн шалгалт (өөрийн UI poll).
1062
+ - `waitForCertificate(org, requestId, { timeoutMs = 15 мин, intervalMs = 3 с, signal })` — ISSUED болтол асууж гэрчилгээг
1063
+ буцаана; REJECTED / EXPIRED / FAILED / хугацаа дууссан → `SealCertificateRequestError` (`outcome`, `requestId`,
1064
+ `failure`). 429/503 + Retry-After (`ApiError.retryable`) — Retry-After-ийг хүлээгээд үргэлжилнэ; `signal` тасрахад
1065
+ `signal.reason`.
1066
+ - Алдаа: **409 `SEAL_APPROVER_UNAVAILABLE`** → `SealApproverUnavailableError`; 409 (code-гүй) — байгууллага ACTIVE биш;
1067
+ **404 `SEAL_REQUEST_NOT_FOUND`** → `SealRequestNotFoundError` (өөр байгууллагын id ч мөн); 403 → `ForbiddenError`
1068
+ (`SEAL:<orgEtsi>` эрхгүй); **429 `RATE_LIMITED`** → `ApiError` (`retryAfterMs`) — байгууллагад цагт 5 хүсэлт (PIN2 push
1069
+ спамаас хамгаална). Хүсэлтийн төлөвийн poll тооцоонд орохгүй; **503 `SEAL_SERVICE_DISABLED`** →
1070
+ `SealServiceDisabledError` (доорх).
1071
+
1072
+ ### Үйлчилгээ унтраалттай — `SealServiceDisabledError` (503 `SEAL_SERVICE_DISABLED`)
1073
+
1074
+ eID-ийн оператор тамганы хоёр үйлчилгээг платформ даяар тус тусад нь унтрааж чадна. Унтраалттай үед CA
1075
+ `503 {"error", "code": "SEAL_SERVICE_DISABLED", "service"}` буцаана (Retry-After-гүй) — SDK `SealServiceDisabledError`
1076
+ (`ApiError`-ийн дэд анги; `status: 503`, `code`, `service`) шиднэ:
1077
+
1078
+ | `service` | Хаана | Утга |
1079
+ |---|---|---|
1080
+ | `"issuance"` | `eid.seal.requestCertificate` | гэрчилгээ олголт унтраалттай — шинэ хүсэлт авахгүй |
1081
+ | `"sealing"` | `eid.seal.seal`, `sealPdf` | тамгалалт унтраалттай |
1082
+
1083
+ ```ts
1084
+ import { SealServiceDisabledError } from "@gerege-systems/eid-mongolia-sdk";
1085
+
1086
+ try {
1087
+ await sealPdf(eid.seal, "NTRMN-6235972", pdfBytes);
1088
+ } catch (e) {
1089
+ if (e instanceof SealServiceDisabledError) {
1090
+ // e.service: "issuance" | "sealing" | undefined — хэрэглэгчид «үйлчилгээ түр унтраалттай»; автоматаар давтахгүй
1091
+ } else throw e;
1092
+ }
1093
+ ```
1094
+
1095
+ - `retryable` үргэлж `false`: хэзээ асахыг CA хэлэхгүй тул SDK (`sealPdf`, `waitForCertificate`) давтахгүй, шууд шиднэ.
1096
+ Бусад 503 (ж: `STATE_UNAVAILABLE` + Retry-After) хэвээр `ApiError` (`retryable`).
1097
+ - Хүлээгдэж буй хүсэлтийг ADMIN баталсан ч олголт унтраалттай бол хүсэлт `FAILED`, `failure: "SEAL_SERVICE_DISABLED"`
1098
+ (гэрчилгээ гарахгүй) — `waitForCertificate` → `SealCertificateRequestError` (`outcome: "FAILED"`, `failure`); олголт
1099
+ асмагц шинэ хүсэлт үүсгэнэ.
1100
+ - Хэзээ ч унтардаггүй: `getCertificate`, `getCertificateRequest` / `waitForCertificate`-ийн poll, шалгалт
1101
+ (`validatePdf`, CA `/v3/validate/*`), OCSP/CRL — өмнө тамгалсан баримт хүчинтэй хэвээр.
1102
+ - Амьд төлөв: [`/.well-known/eid`](https://rp.eidmongolia.mn/.well-known/eid)-ийн `seal` блок — `{issuanceEnabled,
1103
+ sealingEnabled, disabledCode: "SEAL_SERVICE_DISABLED"}`.
1104
+ - `certificateLevel` (`getCertificate`, `seal`-ийн хариу) нь гэрчилгээнээс өөрөөс нь: QcSSCD байвал `QSCD`, үгүй бол
1105
+ `QUALIFIED`.
1032
1106
 
1033
1107
  ## 4. QR ба ижил төхөөрөмж — device link v3
1034
1108
 
@@ -1,4 +1,4 @@
1
- import './errors-CgJcEjrZ.cjs';
1
+ import './errors-Dg6wBO_8.cjs';
2
2
 
3
3
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
4
  interface NavigatorLike {
@@ -1,4 +1,4 @@
1
- import './errors-CgJcEjrZ.js';
1
+ import './errors-Dg6wBO_8.js';
2
2
 
3
3
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
4
  interface NavigatorLike {
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-Cbph4U6r.cjs';
2
- export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.cjs';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-BauJmOqC.cjs';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-Dg6wBO_8.cjs';
package/dist/browser.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-aa_Judox.js';
2
- export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.js';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-DxOBHC54.js';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-Dg6wBO_8.js';
package/dist/browser.js CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  DeviceLinkError,
6
6
  EidError
7
- } from "./chunk-A6FYBPRV.js";
7
+ } from "./chunk-PM2B6WB5.js";
8
8
  export {
9
9
  DeviceLinkError,
10
10
  EidError,
@@ -68,6 +68,42 @@ var RequestInvalidError = class extends ApiError {
68
68
  };
69
69
  var QrTokenInvalidError = class extends ApiError {
70
70
  };
71
+ var SealApproverUnavailableError = class extends ApiError {
72
+ };
73
+ var SealRequestNotFoundError = class extends ApiError {
74
+ };
75
+ var SealServiceDisabledError = class extends ApiError {
76
+ /** Хариуны биеийн `service`; байхгүй / танигдаагүй утга бол undefined. */
77
+ service;
78
+ constructor(status, body, code, init) {
79
+ super(status, body, code, init);
80
+ this.service = sealServiceOf(body);
81
+ }
82
+ /** Үргэлж `false` — proxy Retry-After нэмсэн ч давтахгүй. */
83
+ get retryable() {
84
+ return false;
85
+ }
86
+ };
87
+ function sealServiceOf(body) {
88
+ try {
89
+ const v = JSON.parse(body);
90
+ const s = v && typeof v === "object" ? v.service : void 0;
91
+ return s === "issuance" || s === "sealing" ? s : void 0;
92
+ } catch {
93
+ return void 0;
94
+ }
95
+ }
96
+ var SealCertificateRequestError = class extends EidError {
97
+ constructor(outcome, requestId, failure) {
98
+ super(`\u0442\u0430\u043C\u0433\u0430\u043D\u044B \u0433\u044D\u0440\u0447\u0438\u043B\u0433\u044D\u044D\u043D\u0438\u0439 \u0445\u04AF\u0441\u044D\u043B\u0442 ${outcome}${failure ? ` (${failure})` : ""}`);
99
+ this.outcome = outcome;
100
+ this.requestId = requestId;
101
+ this.failure = failure;
102
+ }
103
+ outcome;
104
+ requestId;
105
+ failure;
106
+ };
71
107
  var RETRYABLE_ERROR_CODES = [
72
108
  "RATE_LIMITED",
73
109
  "STATE_UNAVAILABLE",
@@ -160,6 +196,10 @@ export {
160
196
  CertChoiceInvalidError,
161
197
  RequestInvalidError,
162
198
  QrTokenInvalidError,
199
+ SealApproverUnavailableError,
200
+ SealRequestNotFoundError,
201
+ SealServiceDisabledError,
202
+ SealCertificateRequestError,
163
203
  RETRYABLE_ERROR_CODES,
164
204
  parseRetryAfter,
165
205
  ON_BEHALF_ERROR_CODES,
@@ -87,6 +87,51 @@ declare class RequestInvalidError extends ApiError {
87
87
  */
88
88
  declare class QrTokenInvalidError extends ApiError {
89
89
  }
90
+ /**
91
+ * 409 `SEAL_APPROVER_UNAVAILABLE` (`eid.seal.requestCertificate`) — байгууллагад идэвхтэй eID төхөөрөмжтэй ADMIN төлөөлөгч
92
+ * алга: тамганы гэрчилгээг PIN2-оор батлах хүн байхгүй. Байгууллагын ADMIN eID-ээ идэвхжүүлсний дараа дахин хүснэ.
93
+ */
94
+ declare class SealApproverUnavailableError extends ApiError {
95
+ }
96
+ /**
97
+ * 404 `SEAL_REQUEST_NOT_FOUND` (`eid.seal.getCertificateRequest`) — тамганы гэрчилгээний хүсэлт олдсонгүй (эсвэл өөр
98
+ * байгууллагынх).
99
+ */
100
+ declare class SealRequestNotFoundError extends ApiError {
101
+ }
102
+ /** Унтраалттай тамганы үйлчилгээ (CA `{"service"}`): `issuance` — гэрчилгээ олголт, `sealing` — тамгалалт. */
103
+ type SealService = "issuance" | "sealing";
104
+ /**
105
+ * 503 `SEAL_SERVICE_DISABLED` (`eid.seal.requestCertificate` → `service: "issuance"`; `eid.seal.seal` / `sealPdf` →
106
+ * `service: "sealing"`) — eID-ийн оператор тамганы үйлчилгээг платформ даяар унтраасан. Retry-After-гүй, хэзээ асахыг CA
107
+ * хэлэхгүй: `retryable` үргэлж `false` — автоматаар давтахгүй, хэрэглэгчид «үйлчилгээ түр унтраалттай» гэж харуулна.
108
+ * Гэрчилгээ татах (`getCertificate`), хүсэлтийн төлөв (`getCertificateRequest`), шалгалт унтардаггүй. Амьд төлөв:
109
+ * `/.well-known/eid`-ийн `seal.issuanceEnabled` / `seal.sealingEnabled`.
110
+ */
111
+ declare class SealServiceDisabledError extends ApiError {
112
+ /** Хариуны биеийн `service`; байхгүй / танигдаагүй утга бол undefined. */
113
+ readonly service: SealService | undefined;
114
+ constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
115
+ /** Үргэлж `false` — proxy Retry-After нэмсэн ч давтахгүй. */
116
+ get retryable(): boolean;
117
+ }
118
+ /** Тамганы гэрчилгээний хүсэлтийн төгсгөлийн (ISSUED биш) төлөв, эсвэл `waitForCertificate`-ийн хугацаа дууссан. */
119
+ type SealRequestOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "TIMEOUT";
120
+ /**
121
+ * `eid.seal.waitForCertificate` — хүсэлт гэрчилгээгүй дууссан: `REJECTED` (ADMIN татгалзсан), `EXPIRED` (батлах хугацаа
122
+ * дууссан), `FAILED` (`failure`: `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` | `SEAL_SERVICE_DISABLED` — батлах үед олголт
123
+ * унтраалттай байсан, г.м.) — бүгд шинэ хүсэлт (`requestCertificate`) шаардана; `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт
124
+ * серверт PENDING хэвээр (ижил `requestId`-аар дахин хүлээж болно).
125
+ */
126
+ declare class SealCertificateRequestError extends EidError {
127
+ readonly outcome: SealRequestOutcome;
128
+ readonly requestId: string;
129
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
130
+ readonly failure?: string | undefined;
131
+ constructor(outcome: SealRequestOutcome, requestId: string,
132
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
133
+ failure?: string | undefined);
134
+ }
90
135
  /**
91
136
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
92
137
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -170,4 +215,4 @@ declare class AppTransactionTooLargeError extends EidError {
170
215
  declare class DeviceLinkError extends EidError {
171
216
  }
172
217
 
173
- export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
218
+ export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SealApproverUnavailableError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, SealCertificateRequestError as i, SealRequestNotFoundError as j, type SealRequestOutcome as k, type SealService as l, SealServiceDisabledError as m, SessionFailedError as n, parseRetryAfter as p };
@@ -87,6 +87,51 @@ declare class RequestInvalidError extends ApiError {
87
87
  */
88
88
  declare class QrTokenInvalidError extends ApiError {
89
89
  }
90
+ /**
91
+ * 409 `SEAL_APPROVER_UNAVAILABLE` (`eid.seal.requestCertificate`) — байгууллагад идэвхтэй eID төхөөрөмжтэй ADMIN төлөөлөгч
92
+ * алга: тамганы гэрчилгээг PIN2-оор батлах хүн байхгүй. Байгууллагын ADMIN eID-ээ идэвхжүүлсний дараа дахин хүснэ.
93
+ */
94
+ declare class SealApproverUnavailableError extends ApiError {
95
+ }
96
+ /**
97
+ * 404 `SEAL_REQUEST_NOT_FOUND` (`eid.seal.getCertificateRequest`) — тамганы гэрчилгээний хүсэлт олдсонгүй (эсвэл өөр
98
+ * байгууллагынх).
99
+ */
100
+ declare class SealRequestNotFoundError extends ApiError {
101
+ }
102
+ /** Унтраалттай тамганы үйлчилгээ (CA `{"service"}`): `issuance` — гэрчилгээ олголт, `sealing` — тамгалалт. */
103
+ type SealService = "issuance" | "sealing";
104
+ /**
105
+ * 503 `SEAL_SERVICE_DISABLED` (`eid.seal.requestCertificate` → `service: "issuance"`; `eid.seal.seal` / `sealPdf` →
106
+ * `service: "sealing"`) — eID-ийн оператор тамганы үйлчилгээг платформ даяар унтраасан. Retry-After-гүй, хэзээ асахыг CA
107
+ * хэлэхгүй: `retryable` үргэлж `false` — автоматаар давтахгүй, хэрэглэгчид «үйлчилгээ түр унтраалттай» гэж харуулна.
108
+ * Гэрчилгээ татах (`getCertificate`), хүсэлтийн төлөв (`getCertificateRequest`), шалгалт унтардаггүй. Амьд төлөв:
109
+ * `/.well-known/eid`-ийн `seal.issuanceEnabled` / `seal.sealingEnabled`.
110
+ */
111
+ declare class SealServiceDisabledError extends ApiError {
112
+ /** Хариуны биеийн `service`; байхгүй / танигдаагүй утга бол undefined. */
113
+ readonly service: SealService | undefined;
114
+ constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
115
+ /** Үргэлж `false` — proxy Retry-After нэмсэн ч давтахгүй. */
116
+ get retryable(): boolean;
117
+ }
118
+ /** Тамганы гэрчилгээний хүсэлтийн төгсгөлийн (ISSUED биш) төлөв, эсвэл `waitForCertificate`-ийн хугацаа дууссан. */
119
+ type SealRequestOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "TIMEOUT";
120
+ /**
121
+ * `eid.seal.waitForCertificate` — хүсэлт гэрчилгээгүй дууссан: `REJECTED` (ADMIN татгалзсан), `EXPIRED` (батлах хугацаа
122
+ * дууссан), `FAILED` (`failure`: `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` | `SEAL_SERVICE_DISABLED` — батлах үед олголт
123
+ * унтраалттай байсан, г.м.) — бүгд шинэ хүсэлт (`requestCertificate`) шаардана; `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт
124
+ * серверт PENDING хэвээр (ижил `requestId`-аар дахин хүлээж болно).
125
+ */
126
+ declare class SealCertificateRequestError extends EidError {
127
+ readonly outcome: SealRequestOutcome;
128
+ readonly requestId: string;
129
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
130
+ readonly failure?: string | undefined;
131
+ constructor(outcome: SealRequestOutcome, requestId: string,
132
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
133
+ failure?: string | undefined);
134
+ }
90
135
  /**
91
136
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
92
137
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -170,4 +215,4 @@ declare class AppTransactionTooLargeError extends EidError {
170
215
  declare class DeviceLinkError extends EidError {
171
216
  }
172
217
 
173
- export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
218
+ export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SealApproverUnavailableError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, SealCertificateRequestError as i, SealRequestNotFoundError as j, type SealRequestOutcome as k, type SealService as l, SealServiceDisabledError as m, SessionFailedError as n, parseRetryAfter as p };
package/dist/index.cjs CHANGED
@@ -33,6 +33,8 @@ __export(index_exports, {
33
33
  DEFAULT_MAX_WAIT_MS: () => DEFAULT_MAX_WAIT_MS,
34
34
  DEFAULT_PDF_TIMEOUT_MS: () => DEFAULT_PDF_TIMEOUT_MS,
35
35
  DEFAULT_QR_ISSUER: () => DEFAULT_QR_ISSUER,
36
+ DEFAULT_SEAL_POLL_INTERVAL_MS: () => DEFAULT_SEAL_POLL_INTERVAL_MS,
37
+ DEFAULT_SEAL_WAIT_TIMEOUT_MS: () => DEFAULT_SEAL_WAIT_TIMEOUT_MS,
36
38
  DEFAULT_SHARE_TIMEOUT_MS: () => DEFAULT_SHARE_TIMEOUT_MS,
37
39
  DEFAULT_SIGN_SESSION_TTL_MS: () => DEFAULT_SIGN_SESSION_TTL_MS,
38
40
  DeviceLinkError: () => DeviceLinkError,
@@ -69,6 +71,10 @@ __export(index_exports, {
69
71
  SHARE_ERROR_CODES: () => SHARE_ERROR_CODES,
70
72
  SHARE_FORM_FIELDS: () => SHARE_FORM_FIELDS,
71
73
  SealApi: () => SealApi,
74
+ SealApproverUnavailableError: () => SealApproverUnavailableError,
75
+ SealCertificateRequestError: () => SealCertificateRequestError,
76
+ SealRequestNotFoundError: () => SealRequestNotFoundError,
77
+ SealServiceDisabledError: () => SealServiceDisabledError,
72
78
  SessionApi: () => SessionApi,
73
79
  SessionFailedError: () => SessionFailedError,
74
80
  ShareError: () => ShareError,
@@ -190,6 +196,42 @@ var RequestInvalidError = class extends ApiError {
190
196
  };
191
197
  var QrTokenInvalidError = class extends ApiError {
192
198
  };
199
+ var SealApproverUnavailableError = class extends ApiError {
200
+ };
201
+ var SealRequestNotFoundError = class extends ApiError {
202
+ };
203
+ var SealServiceDisabledError = class extends ApiError {
204
+ /** Хариуны биеийн `service`; байхгүй / танигдаагүй утга бол undefined. */
205
+ service;
206
+ constructor(status, body, code, init) {
207
+ super(status, body, code, init);
208
+ this.service = sealServiceOf(body);
209
+ }
210
+ /** Үргэлж `false` — proxy Retry-After нэмсэн ч давтахгүй. */
211
+ get retryable() {
212
+ return false;
213
+ }
214
+ };
215
+ function sealServiceOf(body) {
216
+ try {
217
+ const v = JSON.parse(body);
218
+ const s = v && typeof v === "object" ? v.service : void 0;
219
+ return s === "issuance" || s === "sealing" ? s : void 0;
220
+ } catch {
221
+ return void 0;
222
+ }
223
+ }
224
+ var SealCertificateRequestError = class extends EidError {
225
+ constructor(outcome, requestId, failure) {
226
+ super(`\u0442\u0430\u043C\u0433\u0430\u043D\u044B \u0433\u044D\u0440\u0447\u0438\u043B\u0433\u044D\u044D\u043D\u0438\u0439 \u0445\u04AF\u0441\u044D\u043B\u0442 ${outcome}${failure ? ` (${failure})` : ""}`);
227
+ this.outcome = outcome;
228
+ this.requestId = requestId;
229
+ this.failure = failure;
230
+ }
231
+ outcome;
232
+ requestId;
233
+ failure;
234
+ };
193
235
  var RETRYABLE_ERROR_CODES = [
194
236
  "RATE_LIMITED",
195
237
  "STATE_UNAVAILABLE",
@@ -343,7 +385,7 @@ var Http = class {
343
385
  { headers, retryAfterMs }
344
386
  );
345
387
  }
346
- const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : code === "QR_TOKEN_INVALID" ? QrTokenInvalidError : ApiError;
388
+ const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : code === "QR_TOKEN_INVALID" ? QrTokenInvalidError : code === "SEAL_APPROVER_UNAVAILABLE" ? SealApproverUnavailableError : code === "SEAL_REQUEST_NOT_FOUND" ? SealRequestNotFoundError : code === "SEAL_SERVICE_DISABLED" ? SealServiceDisabledError : ApiError;
347
389
  throw new Typed(res.status, text, code, { headers, retryAfterMs });
348
390
  }
349
391
  };
@@ -419,6 +461,10 @@ var RP_ROUTES = {
419
461
  authQr: { method: "POST", path: "/authentication/qr" },
420
462
  /** Байгууллагын тамганы гэрчилгээ (CA `dto.SealCertificateResponse`). */
421
463
  sealCertificate: { method: "GET", path: "/seal/certificate/{orgEtsi}" },
464
+ /** Тамганы гэрчилгээний хүсэлт (CA !483): 202 `dto.SealCertificateRequestResponse` (PENDING, ADMIN PIN2-оор батална). */
465
+ sealCertificateRequest: { method: "POST", path: "/seal/certificate/{orgEtsi}" },
466
+ /** Тамганы гэрчилгээний хүсэлтийн төлөв (CA !483, ORG_ONBOARDING §4.3) — ISSUED үед `certificate`-тэй. */
467
+ sealCertificateRequestStatus: { method: "GET", path: "/seal/certificate/{orgEtsi}/requests/{requestId}" },
422
468
  /** Байгууллагын тамга (CA `dto.SealRequest` `{digest, hashType}` → `dto.SealResponse`). */
423
469
  seal: { method: "POST", path: "/seal/{orgEtsi}" }
424
470
  };
@@ -1988,6 +2034,8 @@ function basicConstraintsPathLen(cert) {
1988
2034
  }
1989
2035
 
1990
2036
  // src/seal.ts
2037
+ var DEFAULT_SEAL_WAIT_TIMEOUT_MS = 15 * 6e4;
2038
+ var DEFAULT_SEAL_POLL_INTERVAL_MS = 3e3;
1991
2039
  var rec3 = (v) => v && typeof v === "object" ? v : {};
1992
2040
  var b642 = (s, what) => {
1993
2041
  if (typeof s !== "string" || s === "" || !/^[A-Za-z0-9+/]+={0,2}$/.test(s)) throw new ValidationError(`seal: ${what} base64 \u0431\u0438\u0448 \u044D\u0441\u0432\u044D\u043B \u0445\u043E\u043E\u0441\u043E\u043D`);
@@ -2008,32 +2056,121 @@ function isSealCertificate(cert) {
2008
2056
  const bits = v[bs.start + 1];
2009
2057
  return (bits & 64) !== 0 && (bits & 128) === 0;
2010
2058
  }
2059
+ function parseSealCertificate(raw, orgEtsi) {
2060
+ const r = rec3(raw);
2061
+ return {
2062
+ orgEtsi: String(r.orgEtsi ?? orgEtsi),
2063
+ certificate: b642(r.certificate, "certificate"),
2064
+ serialNumber: String(r.serialNumber ?? ""),
2065
+ subjectDn: String(r.subjectDn ?? ""),
2066
+ issuerDn: String(r.issuerDn ?? ""),
2067
+ notBefore: String(r.notBefore ?? ""),
2068
+ notAfter: String(r.notAfter ?? ""),
2069
+ certificateLevel: String(r.certificateLevel ?? ""),
2070
+ raw
2071
+ };
2072
+ }
2073
+ function parseSealRequest(raw, orgEtsi) {
2074
+ const r = rec3(raw);
2075
+ if (typeof r.requestId !== "string" || r.requestId === "" || typeof r.status !== "string" || r.status === "") {
2076
+ throw new ValidationError("seal: \u0445\u04AF\u0441\u044D\u043B\u0442\u0438\u0439\u043D \u0445\u0430\u0440\u0438\u0443\u043D\u0434 requestId/status \u0430\u043B\u0433\u0430");
2077
+ }
2078
+ const status = r.status;
2079
+ if (status === "ISSUED" && !r.certificate) throw new ValidationError("seal: ISSUED \u0445\u04AF\u0441\u044D\u043B\u0442\u044D\u0434 certificate \u0430\u043B\u0433\u0430");
2080
+ return {
2081
+ requestId: r.requestId,
2082
+ orgEtsi: String(r.orgEtsi ?? orgEtsi),
2083
+ status,
2084
+ createdAt: String(r.createdAt ?? ""),
2085
+ expiresAt: String(r.expiresAt ?? ""),
2086
+ ...typeof r.decidedAt === "string" ? { decidedAt: r.decidedAt } : {},
2087
+ ...typeof r.approvers === "number" ? { approvers: r.approvers } : {},
2088
+ ...typeof r.failure === "string" && r.failure ? { failure: r.failure } : {},
2089
+ ...r.certificate ? { certificate: parseSealCertificate(r.certificate, orgEtsi) } : {},
2090
+ raw
2091
+ };
2092
+ }
2093
+ function sleep(ms2, signal) {
2094
+ return new Promise((resolve, reject) => {
2095
+ if (signal?.aborted) return reject(signal.reason);
2096
+ const onAbort = () => {
2097
+ clearTimeout(t);
2098
+ reject(signal.reason);
2099
+ };
2100
+ const t = setTimeout(() => {
2101
+ signal?.removeEventListener("abort", onAbort);
2102
+ resolve();
2103
+ }, Math.max(0, ms2));
2104
+ signal?.addEventListener("abort", onAbort, { once: true });
2105
+ });
2106
+ }
2011
2107
  var SealApi = class {
2012
2108
  constructor(http) {
2013
2109
  this.http = http;
2014
2110
  }
2015
2111
  http;
2016
- /** `GET /seal/certificate/{orgEtsi}` — байгууллагын идэвхтэй тамганы гэрчилгээ (PAdES-ийн signerCert). */
2112
+ /**
2113
+ * `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
2114
+ * (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
2115
+ */
2017
2116
  async getCertificate(orgEtsi) {
2018
- const raw = await this.http.get(routePath(RP_ROUTES.sealCertificate, orgEtsi));
2019
- const r = rec3(raw);
2020
- return {
2021
- orgEtsi: String(r.orgEtsi ?? orgEtsi),
2022
- certificate: b642(r.certificate, "certificate"),
2023
- serialNumber: String(r.serialNumber ?? ""),
2024
- subjectDn: String(r.subjectDn ?? ""),
2025
- issuerDn: String(r.issuerDn ?? ""),
2026
- notBefore: String(r.notBefore ?? ""),
2027
- notAfter: String(r.notAfter ?? ""),
2028
- certificateLevel: String(r.certificateLevel ?? ""),
2029
- raw
2030
- };
2117
+ return parseSealCertificate(await this.http.get(routePath(RP_ROUTES.sealCertificate, orgEtsi)), orgEtsi);
2118
+ }
2119
+ /**
2120
+ * `POST /seal/certificate/{orgEtsi}` — тамганы гэрчилгээний ХҮСЭЛТ (202, `status: "PENDING"`). Байгууллагын ADMIN
2121
+ * төлөөлөгч(ид) eID аппаараа PIN2-оор батална; {@link waitForCertificate} / {@link getCertificateRequest}-ээр асууна.
2122
+ * Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй). Алдаа: 409 {@link
2123
+ * SealApproverUnavailableError} (идэвхтэй төхөөрөмжтэй ADMIN алга), 409 `ApiError` (байгууллага ACTIVE биш), 403
2124
+ * `ForbiddenError` (`SEAL:<orgEtsi>` эрхгүй), 404 (байгууллага олдсонгүй), 429 `RATE_LIMITED` (байгууллагад 5/цаг;
2125
+ * `retryAfterMs`), 503 {@link SealServiceDisabledError} (`service: "issuance"` — оператор гэрчилгээ олголтыг унтраасан;
2126
+ * Retry-After-гүй, давтахгүй).
2127
+ */
2128
+ async requestCertificate(orgEtsi) {
2129
+ return parseSealRequest(await this.http.post(routePath(RP_ROUTES.sealCertificateRequest, orgEtsi), {}), orgEtsi);
2130
+ }
2131
+ /**
2132
+ * `GET /seal/certificate/{orgEtsi}/requests/{requestId}` — хүсэлтийн төлөв; ISSUED үед `certificate` бөглөгдөнө. Олдоогүй
2133
+ * (эсвэл өөр байгууллагынх) → {@link SealRequestNotFoundError} 404.
2134
+ */
2135
+ async getCertificateRequest(orgEtsi, requestId) {
2136
+ const raw = await this.http.get(routePath(RP_ROUTES.sealCertificateRequestStatus, orgEtsi, requestId));
2137
+ return parseSealRequest(raw, orgEtsi);
2138
+ }
2139
+ /**
2140
+ * Хүсэлт ISSUED болтол `intervalMs` тутамд асууж олгогдсон гэрчилгээг буцаана. REJECTED / EXPIRED / FAILED →
2141
+ * {@link SealCertificateRequestError} (`outcome`, `failure`; шинэ хүсэлт хэрэгтэй); `timeoutMs` дуусвал `outcome:
2142
+ * "TIMEOUT"` (хүсэлт серверт PENDING хэвээр — ижил `requestId`-аар дахин хүлээж болно). Түр алдаа (`ApiError.retryable`:
2143
+ * 429/503 + Retry-After) — Retry-After-ийг хүлээгээд үргэлжилнэ; бусад алдаа шууд шидэгдэнэ ({@link
2144
+ * SealServiceDisabledError} ч мөн — давтахгүй). Хүсэлтийг батлах үед олголт унтраалттай байсан бол `FAILED` +
2145
+ * `failure: "SEAL_SERVICE_DISABLED"`.
2146
+ */
2147
+ async waitForCertificate(orgEtsi, requestId, opts = {}) {
2148
+ const interval = opts.intervalMs !== void 0 && opts.intervalMs > 0 ? opts.intervalMs : DEFAULT_SEAL_POLL_INTERVAL_MS;
2149
+ const deadline = Date.now() + (opts.timeoutMs !== void 0 && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_SEAL_WAIT_TIMEOUT_MS);
2150
+ for (; ; ) {
2151
+ if (opts.signal?.aborted) throw opts.signal.reason;
2152
+ let wait = interval;
2153
+ try {
2154
+ const r = await this.getCertificateRequest(orgEtsi, requestId);
2155
+ if (r.status === "ISSUED" && r.certificate) return r.certificate;
2156
+ if (r.status === "REJECTED" || r.status === "EXPIRED" || r.status === "FAILED") {
2157
+ throw new SealCertificateRequestError(r.status, r.requestId, r.failure);
2158
+ }
2159
+ } catch (e) {
2160
+ if (!(e instanceof ApiError && e.retryable)) throw e;
2161
+ wait = Math.max(interval, e.retryAfterMs ?? 0);
2162
+ }
2163
+ const left = deadline - Date.now();
2164
+ if (left <= 0) throw new SealCertificateRequestError("TIMEOUT", requestId);
2165
+ await sleep(Math.min(wait, left), opts.signal);
2166
+ }
2031
2167
  }
2032
2168
  /**
2033
2169
  * `POST /seal/{orgEtsi}` — digest-ийг байгууллагын тамгаар тамгална. `hashAlgorithm`: SHA-256 (анхдагч) | SHA-384 |
2034
2170
  * SHA-512; digest-ийн урт таарахгүй бол сүлжээнд гарахгүй. Хариуны гарын үсгийг хариуны гэрчилгээгээр digest дээр
2035
2171
  * шалгаж, гэрчилгээ e-Seal ({@link isSealCertificate}) эсэхийг тулгана — эс бөгөөс ValidationError. Гинж/цуцлалтыг
2036
- * `sealPdf` (OCSP/CRL) шалгана.
2172
+ * `sealPdf` (OCSP/CRL) шалгана. Оператор тамгалалтыг унтраасан үед 503 {@link SealServiceDisabledError} (`service:
2173
+ * "sealing"`; Retry-After-гүй, давтахгүй).
2037
2174
  */
2038
2175
  async seal(orgEtsi, digest2, hashAlgorithm = "SHA-256") {
2039
2176
  if (!["SHA-256", "SHA-384", "SHA-512"].includes(hashAlgorithm)) throw new ValidationError(`seal: \u0434\u044D\u043C\u0436\u0438\u0433\u0434\u044D\u044D\u0433\u04AF\u0439 hashAlgorithm ${hashAlgorithm}`);
@@ -3859,7 +3996,7 @@ function safeEqualHex(a, b) {
3859
3996
  const y = Buffer.from(b, "hex");
3860
3997
  return x.length === y.length && x.length > 0 && (0, import_node_crypto9.timingSafeEqual)(x, y);
3861
3998
  }
3862
- function sleep(ms2, signal) {
3999
+ function sleep2(ms2, signal) {
3863
4000
  return new Promise((resolve) => {
3864
4001
  if (ms2 <= 0 || signal?.aborted) return resolve();
3865
4002
  const done = () => {
@@ -4150,7 +4287,7 @@ function createEidLogin(opts) {
4150
4287
  err = e;
4151
4288
  }
4152
4289
  }
4153
- if (mode === "push" && pushFloorMs > 0) await sleep(began + pushFloorMs - Date.now(), req.signal);
4290
+ if (mode === "push" && pushFloorMs > 0) await sleep2(began + pushFloorMs - Date.now(), req.signal);
4154
4291
  if (err !== void 0 || !r) {
4155
4292
  onError(err, ctx2);
4156
4293
  if (err instanceof ApiError && err.status === 429) return limited();
@@ -4191,7 +4328,7 @@ function createEidLogin(opts) {
4191
4328
  const ctx2 = { request: req, mode: tx.mode };
4192
4329
  let r;
4193
4330
  if (tx.decoy) {
4194
- await sleep(pollMs, req.signal);
4331
+ await sleep2(pollMs, req.signal);
4195
4332
  r = { state: "RUNNING" };
4196
4333
  } else {
4197
4334
  try {
@@ -4313,6 +4450,8 @@ function createEidLogin(opts) {
4313
4450
  DEFAULT_MAX_WAIT_MS,
4314
4451
  DEFAULT_PDF_TIMEOUT_MS,
4315
4452
  DEFAULT_QR_ISSUER,
4453
+ DEFAULT_SEAL_POLL_INTERVAL_MS,
4454
+ DEFAULT_SEAL_WAIT_TIMEOUT_MS,
4316
4455
  DEFAULT_SHARE_TIMEOUT_MS,
4317
4456
  DEFAULT_SIGN_SESSION_TTL_MS,
4318
4457
  DeviceLinkError,
@@ -4349,6 +4488,10 @@ function createEidLogin(opts) {
4349
4488
  SHARE_ERROR_CODES,
4350
4489
  SHARE_FORM_FIELDS,
4351
4490
  SealApi,
4491
+ SealApproverUnavailableError,
4492
+ SealCertificateRequestError,
4493
+ SealRequestNotFoundError,
4494
+ SealServiceDisabledError,
4352
4495
  SessionApi,
4353
4496
  SessionFailedError,
4354
4497
  ShareError,
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-Cbph4U6r.cjs';
2
- export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-Cbph4U6r.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-BauJmOqC.cjs';
2
+ export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-BauJmOqC.cjs';
3
3
  import { X509Certificate, KeyObject } from 'node:crypto';
4
- import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-CgJcEjrZ.cjs';
5
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CgJcEjrZ.cjs';
4
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-Dg6wBO_8.cjs';
5
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SealApproverUnavailableError, i as SealCertificateRequestError, j as SealRequestNotFoundError, k as SealRequestOutcome, l as SealService, m as SealServiceDisabledError, n as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-Dg6wBO_8.cjs';
6
6
 
7
7
  interface HttpConfig {
8
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -421,10 +421,51 @@ interface SealCertificate {
421
421
  /** RFC 3339. */
422
422
  notBefore: string;
423
423
  notAfter: string;
424
+ /** Гэрчилгээнээс өөрөөс нь (QcSSCD байвал `QSCD`, үгүй бол `QUALIFIED`) — CA-ийн одоогийн түлхүүрийн тохиргооноос биш. */
424
425
  certificateLevel: CertificateLevel | string;
425
426
  /** Серверийн түүхий JSON. */
426
427
  raw: unknown;
427
428
  }
429
+ /** Тамганы гэрчилгээний хүсэлтийн төлөв (CA `dto.SealCertificateRequestResponse.status`). */
430
+ type SealCertificateRequestStatus = "PENDING" | "APPROVED" | "ISSUED" | "REJECTED" | "EXPIRED" | "FAILED";
431
+ /**
432
+ * `POST /seal/certificate/{orgEtsi}` (202) ба `GET /seal/certificate/{orgEtsi}/requests/{requestId}` (CA
433
+ * `dto.SealCertificateRequestResponse`).
434
+ */
435
+ interface SealCertificateRequest {
436
+ requestId: string;
437
+ orgEtsi: string;
438
+ /** PENDING / APPROVED — хүлээнэ; ISSUED — `certificate` бөглөгдсөн; REJECTED / EXPIRED / FAILED — шинэ хүсэлт. */
439
+ status: SealCertificateRequestStatus | string;
440
+ /** RFC 3339. */
441
+ createdAt: string;
442
+ /** RFC 3339 — батлах хугацааны төгсгөл (дараа нь EXPIRED). */
443
+ expiresAt: string;
444
+ decidedAt?: string;
445
+ /** PIN2 push илгээсэн ADMIN-ийн тоо (шинэ/PENDING хариунд). */
446
+ approvers?: number;
447
+ /**
448
+ * FAILED/EXPIRED үеийн машин код: `EXPIRED` | `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` | `SEAL_SERVICE_DISABLED` (ADMIN
449
+ * баталсан ч гэрчилгээ олголт унтраалттай байсан — гэрчилгээ гараагүй; олголт асмагц шинэ хүсэлт).
450
+ */
451
+ failure?: string;
452
+ /** ISSUED үед — {@link SealApi.getCertificate}-тэй ижил хэлбэр. */
453
+ certificate?: SealCertificate;
454
+ raw: unknown;
455
+ }
456
+ /** {@link SealApi.waitForCertificate}-ийн сонголт. */
457
+ interface SealWaitOptions {
458
+ /** Нийт хүлээх дээд хугацаа (мс). Анхдагч {@link DEFAULT_SEAL_WAIT_TIMEOUT_MS}. */
459
+ timeoutMs?: number;
460
+ /** Poll хоорондын зай (мс). Анхдагч {@link DEFAULT_SEAL_POLL_INTERVAL_MS}; 429/503-ын Retry-After илүү бол түүнийг дагана. */
461
+ intervalMs?: number;
462
+ /** Цуцлах — тасармагц `signal.reason`-ыг шиднэ. */
463
+ signal?: AbortSignal;
464
+ }
465
+ /** `waitForCertificate`-ийн анхдагч хүлээх хугацаа — CA-ийн батлах цонх (sign session TTL + 2 мин)-оос урт. */
466
+ declare const DEFAULT_SEAL_WAIT_TIMEOUT_MS: number;
467
+ /** `waitForCertificate`-ийн анхдагч poll зай (CA зөвлөмж 2–5 с). */
468
+ declare const DEFAULT_SEAL_POLL_INTERVAL_MS = 3000;
428
469
  /** `POST /seal/{orgEtsi}` (CA `dto.SealResponse`). */
429
470
  interface SealResult {
430
471
  orgEtsi: string;
@@ -434,6 +475,7 @@ interface SealResult {
434
475
  signatureAlgorithm: string;
435
476
  /** Тамгалсан гэрчилгээ (DER). */
436
477
  certificate: Uint8Array;
478
+ /** Тамгалсан гэрчилгээнээс өөрөөс нь (QcSSCD байвал `QSCD`, үгүй бол `QUALIFIED`). */
437
479
  certificateLevel: CertificateLevel | string;
438
480
  /** RFC 3339. */
439
481
  sealedAt: string;
@@ -447,13 +489,41 @@ declare function isSealCertificate(cert: X509Certificate | Uint8Array): boolean;
447
489
  declare class SealApi {
448
490
  private readonly http;
449
491
  constructor(http: Http);
450
- /** `GET /seal/certificate/{orgEtsi}` — байгууллагын идэвхтэй тамганы гэрчилгээ (PAdES-ийн signerCert). */
492
+ /**
493
+ * `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
494
+ * (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
495
+ */
451
496
  getCertificate(orgEtsi: string): Promise<SealCertificate>;
497
+ /**
498
+ * `POST /seal/certificate/{orgEtsi}` — тамганы гэрчилгээний ХҮСЭЛТ (202, `status: "PENDING"`). Байгууллагын ADMIN
499
+ * төлөөлөгч(ид) eID аппаараа PIN2-оор батална; {@link waitForCertificate} / {@link getCertificateRequest}-ээр асууна.
500
+ * Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй). Алдаа: 409 {@link
501
+ * SealApproverUnavailableError} (идэвхтэй төхөөрөмжтэй ADMIN алга), 409 `ApiError` (байгууллага ACTIVE биш), 403
502
+ * `ForbiddenError` (`SEAL:<orgEtsi>` эрхгүй), 404 (байгууллага олдсонгүй), 429 `RATE_LIMITED` (байгууллагад 5/цаг;
503
+ * `retryAfterMs`), 503 {@link SealServiceDisabledError} (`service: "issuance"` — оператор гэрчилгээ олголтыг унтраасан;
504
+ * Retry-After-гүй, давтахгүй).
505
+ */
506
+ requestCertificate(orgEtsi: string): Promise<SealCertificateRequest>;
507
+ /**
508
+ * `GET /seal/certificate/{orgEtsi}/requests/{requestId}` — хүсэлтийн төлөв; ISSUED үед `certificate` бөглөгдөнө. Олдоогүй
509
+ * (эсвэл өөр байгууллагынх) → {@link SealRequestNotFoundError} 404.
510
+ */
511
+ getCertificateRequest(orgEtsi: string, requestId: string): Promise<SealCertificateRequest>;
512
+ /**
513
+ * Хүсэлт ISSUED болтол `intervalMs` тутамд асууж олгогдсон гэрчилгээг буцаана. REJECTED / EXPIRED / FAILED →
514
+ * {@link SealCertificateRequestError} (`outcome`, `failure`; шинэ хүсэлт хэрэгтэй); `timeoutMs` дуусвал `outcome:
515
+ * "TIMEOUT"` (хүсэлт серверт PENDING хэвээр — ижил `requestId`-аар дахин хүлээж болно). Түр алдаа (`ApiError.retryable`:
516
+ * 429/503 + Retry-After) — Retry-After-ийг хүлээгээд үргэлжилнэ; бусад алдаа шууд шидэгдэнэ ({@link
517
+ * SealServiceDisabledError} ч мөн — давтахгүй). Хүсэлтийг батлах үед олголт унтраалттай байсан бол `FAILED` +
518
+ * `failure: "SEAL_SERVICE_DISABLED"`.
519
+ */
520
+ waitForCertificate(orgEtsi: string, requestId: string, opts?: SealWaitOptions): Promise<SealCertificate>;
452
521
  /**
453
522
  * `POST /seal/{orgEtsi}` — digest-ийг байгууллагын тамгаар тамгална. `hashAlgorithm`: SHA-256 (анхдагч) | SHA-384 |
454
523
  * SHA-512; digest-ийн урт таарахгүй бол сүлжээнд гарахгүй. Хариуны гарын үсгийг хариуны гэрчилгээгээр digest дээр
455
524
  * шалгаж, гэрчилгээ e-Seal ({@link isSealCertificate}) эсэхийг тулгана — эс бөгөөс ValidationError. Гинж/цуцлалтыг
456
- * `sealPdf` (OCSP/CRL) шалгана.
525
+ * `sealPdf` (OCSP/CRL) шалгана. Оператор тамгалалтыг унтраасан үед 503 {@link SealServiceDisabledError} (`service:
526
+ * "sealing"`; Retry-After-гүй, давтахгүй).
457
527
  */
458
528
  seal(orgEtsi: string, digest: Uint8Array, hashAlgorithm?: HashAlgorithm): Promise<SealResult>;
459
529
  }
@@ -1928,4 +1998,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1928
1998
  */
1929
1999
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1930
2000
 
1931
- 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_QR_ISSUER, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, 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 ParsedQr, 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, QR_CLOCK_SKEW_SECONDS, QR_ERROR_CODES, QR_LIMITS, QR_MAX_AGE_SECONDS, QR_PREFIX, QrApi, type QrApiDeps, type QrCheck, type QrClaims, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrPresentation, type QrSession, type QrSigner, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SEAL_REQUEST_FIELDS, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SealApi, type SealCertificate, type SealResult, 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, isSealCertificate, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, qrStatement, randomChallenge, registrationFromCompleted, resolveBaseUrl, sessionSecretDigest, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifySessionSecretDigest, verifyTokenCertificates, withReturnHint };
2001
+ 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_QR_ISSUER, DEFAULT_SEAL_POLL_INTERVAL_MS, DEFAULT_SEAL_WAIT_TIMEOUT_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, 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 ParsedQr, 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, QR_CLOCK_SKEW_SECONDS, QR_ERROR_CODES, QR_LIMITS, QR_MAX_AGE_SECONDS, QR_PREFIX, QrApi, type QrApiDeps, type QrCheck, type QrClaims, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrPresentation, type QrSession, type QrSigner, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SEAL_REQUEST_FIELDS, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SealApi, type SealCertificate, type SealCertificateRequest, type SealCertificateRequestStatus, type SealResult, type SealWaitOptions, 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, isSealCertificate, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, qrStatement, randomChallenge, registrationFromCompleted, resolveBaseUrl, sessionSecretDigest, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifySessionSecretDigest, 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-aa_Judox.js';
2
- export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-aa_Judox.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-DxOBHC54.js';
2
+ export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-DxOBHC54.js';
3
3
  import { X509Certificate, KeyObject } from 'node:crypto';
4
- import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-CgJcEjrZ.js';
5
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CgJcEjrZ.js';
4
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-Dg6wBO_8.js';
5
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SealApproverUnavailableError, i as SealCertificateRequestError, j as SealRequestNotFoundError, k as SealRequestOutcome, l as SealService, m as SealServiceDisabledError, n as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-Dg6wBO_8.js';
6
6
 
7
7
  interface HttpConfig {
8
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -421,10 +421,51 @@ interface SealCertificate {
421
421
  /** RFC 3339. */
422
422
  notBefore: string;
423
423
  notAfter: string;
424
+ /** Гэрчилгээнээс өөрөөс нь (QcSSCD байвал `QSCD`, үгүй бол `QUALIFIED`) — CA-ийн одоогийн түлхүүрийн тохиргооноос биш. */
424
425
  certificateLevel: CertificateLevel | string;
425
426
  /** Серверийн түүхий JSON. */
426
427
  raw: unknown;
427
428
  }
429
+ /** Тамганы гэрчилгээний хүсэлтийн төлөв (CA `dto.SealCertificateRequestResponse.status`). */
430
+ type SealCertificateRequestStatus = "PENDING" | "APPROVED" | "ISSUED" | "REJECTED" | "EXPIRED" | "FAILED";
431
+ /**
432
+ * `POST /seal/certificate/{orgEtsi}` (202) ба `GET /seal/certificate/{orgEtsi}/requests/{requestId}` (CA
433
+ * `dto.SealCertificateRequestResponse`).
434
+ */
435
+ interface SealCertificateRequest {
436
+ requestId: string;
437
+ orgEtsi: string;
438
+ /** PENDING / APPROVED — хүлээнэ; ISSUED — `certificate` бөглөгдсөн; REJECTED / EXPIRED / FAILED — шинэ хүсэлт. */
439
+ status: SealCertificateRequestStatus | string;
440
+ /** RFC 3339. */
441
+ createdAt: string;
442
+ /** RFC 3339 — батлах хугацааны төгсгөл (дараа нь EXPIRED). */
443
+ expiresAt: string;
444
+ decidedAt?: string;
445
+ /** PIN2 push илгээсэн ADMIN-ийн тоо (шинэ/PENDING хариунд). */
446
+ approvers?: number;
447
+ /**
448
+ * FAILED/EXPIRED үеийн машин код: `EXPIRED` | `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` | `SEAL_SERVICE_DISABLED` (ADMIN
449
+ * баталсан ч гэрчилгээ олголт унтраалттай байсан — гэрчилгээ гараагүй; олголт асмагц шинэ хүсэлт).
450
+ */
451
+ failure?: string;
452
+ /** ISSUED үед — {@link SealApi.getCertificate}-тэй ижил хэлбэр. */
453
+ certificate?: SealCertificate;
454
+ raw: unknown;
455
+ }
456
+ /** {@link SealApi.waitForCertificate}-ийн сонголт. */
457
+ interface SealWaitOptions {
458
+ /** Нийт хүлээх дээд хугацаа (мс). Анхдагч {@link DEFAULT_SEAL_WAIT_TIMEOUT_MS}. */
459
+ timeoutMs?: number;
460
+ /** Poll хоорондын зай (мс). Анхдагч {@link DEFAULT_SEAL_POLL_INTERVAL_MS}; 429/503-ын Retry-After илүү бол түүнийг дагана. */
461
+ intervalMs?: number;
462
+ /** Цуцлах — тасармагц `signal.reason`-ыг шиднэ. */
463
+ signal?: AbortSignal;
464
+ }
465
+ /** `waitForCertificate`-ийн анхдагч хүлээх хугацаа — CA-ийн батлах цонх (sign session TTL + 2 мин)-оос урт. */
466
+ declare const DEFAULT_SEAL_WAIT_TIMEOUT_MS: number;
467
+ /** `waitForCertificate`-ийн анхдагч poll зай (CA зөвлөмж 2–5 с). */
468
+ declare const DEFAULT_SEAL_POLL_INTERVAL_MS = 3000;
428
469
  /** `POST /seal/{orgEtsi}` (CA `dto.SealResponse`). */
429
470
  interface SealResult {
430
471
  orgEtsi: string;
@@ -434,6 +475,7 @@ interface SealResult {
434
475
  signatureAlgorithm: string;
435
476
  /** Тамгалсан гэрчилгээ (DER). */
436
477
  certificate: Uint8Array;
478
+ /** Тамгалсан гэрчилгээнээс өөрөөс нь (QcSSCD байвал `QSCD`, үгүй бол `QUALIFIED`). */
437
479
  certificateLevel: CertificateLevel | string;
438
480
  /** RFC 3339. */
439
481
  sealedAt: string;
@@ -447,13 +489,41 @@ declare function isSealCertificate(cert: X509Certificate | Uint8Array): boolean;
447
489
  declare class SealApi {
448
490
  private readonly http;
449
491
  constructor(http: Http);
450
- /** `GET /seal/certificate/{orgEtsi}` — байгууллагын идэвхтэй тамганы гэрчилгээ (PAdES-ийн signerCert). */
492
+ /**
493
+ * `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
494
+ * (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
495
+ */
451
496
  getCertificate(orgEtsi: string): Promise<SealCertificate>;
497
+ /**
498
+ * `POST /seal/certificate/{orgEtsi}` — тамганы гэрчилгээний ХҮСЭЛТ (202, `status: "PENDING"`). Байгууллагын ADMIN
499
+ * төлөөлөгч(ид) eID аппаараа PIN2-оор батална; {@link waitForCertificate} / {@link getCertificateRequest}-ээр асууна.
500
+ * Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй). Алдаа: 409 {@link
501
+ * SealApproverUnavailableError} (идэвхтэй төхөөрөмжтэй ADMIN алга), 409 `ApiError` (байгууллага ACTIVE биш), 403
502
+ * `ForbiddenError` (`SEAL:<orgEtsi>` эрхгүй), 404 (байгууллага олдсонгүй), 429 `RATE_LIMITED` (байгууллагад 5/цаг;
503
+ * `retryAfterMs`), 503 {@link SealServiceDisabledError} (`service: "issuance"` — оператор гэрчилгээ олголтыг унтраасан;
504
+ * Retry-After-гүй, давтахгүй).
505
+ */
506
+ requestCertificate(orgEtsi: string): Promise<SealCertificateRequest>;
507
+ /**
508
+ * `GET /seal/certificate/{orgEtsi}/requests/{requestId}` — хүсэлтийн төлөв; ISSUED үед `certificate` бөглөгдөнө. Олдоогүй
509
+ * (эсвэл өөр байгууллагынх) → {@link SealRequestNotFoundError} 404.
510
+ */
511
+ getCertificateRequest(orgEtsi: string, requestId: string): Promise<SealCertificateRequest>;
512
+ /**
513
+ * Хүсэлт ISSUED болтол `intervalMs` тутамд асууж олгогдсон гэрчилгээг буцаана. REJECTED / EXPIRED / FAILED →
514
+ * {@link SealCertificateRequestError} (`outcome`, `failure`; шинэ хүсэлт хэрэгтэй); `timeoutMs` дуусвал `outcome:
515
+ * "TIMEOUT"` (хүсэлт серверт PENDING хэвээр — ижил `requestId`-аар дахин хүлээж болно). Түр алдаа (`ApiError.retryable`:
516
+ * 429/503 + Retry-After) — Retry-After-ийг хүлээгээд үргэлжилнэ; бусад алдаа шууд шидэгдэнэ ({@link
517
+ * SealServiceDisabledError} ч мөн — давтахгүй). Хүсэлтийг батлах үед олголт унтраалттай байсан бол `FAILED` +
518
+ * `failure: "SEAL_SERVICE_DISABLED"`.
519
+ */
520
+ waitForCertificate(orgEtsi: string, requestId: string, opts?: SealWaitOptions): Promise<SealCertificate>;
452
521
  /**
453
522
  * `POST /seal/{orgEtsi}` — digest-ийг байгууллагын тамгаар тамгална. `hashAlgorithm`: SHA-256 (анхдагч) | SHA-384 |
454
523
  * SHA-512; digest-ийн урт таарахгүй бол сүлжээнд гарахгүй. Хариуны гарын үсгийг хариуны гэрчилгээгээр digest дээр
455
524
  * шалгаж, гэрчилгээ e-Seal ({@link isSealCertificate}) эсэхийг тулгана — эс бөгөөс ValidationError. Гинж/цуцлалтыг
456
- * `sealPdf` (OCSP/CRL) шалгана.
525
+ * `sealPdf` (OCSP/CRL) шалгана. Оператор тамгалалтыг унтраасан үед 503 {@link SealServiceDisabledError} (`service:
526
+ * "sealing"`; Retry-After-гүй, давтахгүй).
457
527
  */
458
528
  seal(orgEtsi: string, digest: Uint8Array, hashAlgorithm?: HashAlgorithm): Promise<SealResult>;
459
529
  }
@@ -1928,4 +1998,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1928
1998
  */
1929
1999
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1930
2000
 
1931
- 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_QR_ISSUER, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, 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 ParsedQr, 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, QR_CLOCK_SKEW_SECONDS, QR_ERROR_CODES, QR_LIMITS, QR_MAX_AGE_SECONDS, QR_PREFIX, QrApi, type QrApiDeps, type QrCheck, type QrClaims, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrPresentation, type QrSession, type QrSigner, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SEAL_REQUEST_FIELDS, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SealApi, type SealCertificate, type SealResult, 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, isSealCertificate, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, qrStatement, randomChallenge, registrationFromCompleted, resolveBaseUrl, sessionSecretDigest, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifySessionSecretDigest, verifyTokenCertificates, withReturnHint };
2001
+ 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_QR_ISSUER, DEFAULT_SEAL_POLL_INTERVAL_MS, DEFAULT_SEAL_WAIT_TIMEOUT_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, 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 ParsedQr, 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, QR_CLOCK_SKEW_SECONDS, QR_ERROR_CODES, QR_LIMITS, QR_MAX_AGE_SECONDS, QR_PREFIX, QrApi, type QrApiDeps, type QrCheck, type QrClaims, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrPresentation, type QrSession, type QrSigner, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SEAL_REQUEST_FIELDS, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SealApi, type SealCertificate, type SealCertificateRequest, type SealCertificateRequestStatus, type SealResult, type SealWaitOptions, 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, isSealCertificate, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, qrStatement, randomChallenge, registrationFromCompleted, resolveBaseUrl, sessionSecretDigest, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifySessionSecretDigest, verifyTokenCertificates, withReturnHint };
package/dist/index.js CHANGED
@@ -27,11 +27,15 @@ import {
27
27
  RETRYABLE_ERROR_CODES,
28
28
  RequestInvalidError,
29
29
  ResponseTooLargeError,
30
+ SealApproverUnavailableError,
31
+ SealCertificateRequestError,
32
+ SealRequestNotFoundError,
33
+ SealServiceDisabledError,
30
34
  SessionFailedError,
31
35
  ValidationError,
32
36
  maskPath,
33
37
  parseRetryAfter
34
- } from "./chunk-A6FYBPRV.js";
38
+ } from "./chunk-PM2B6WB5.js";
35
39
 
36
40
  // src/http.ts
37
41
  var DEFAULT_TIMEOUT_MS = 15e3;
@@ -103,7 +107,7 @@ var Http = class {
103
107
  { headers, retryAfterMs }
104
108
  );
105
109
  }
106
- const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : code === "QR_TOKEN_INVALID" ? QrTokenInvalidError : ApiError;
110
+ const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : code === "QR_TOKEN_INVALID" ? QrTokenInvalidError : code === "SEAL_APPROVER_UNAVAILABLE" ? SealApproverUnavailableError : code === "SEAL_REQUEST_NOT_FOUND" ? SealRequestNotFoundError : code === "SEAL_SERVICE_DISABLED" ? SealServiceDisabledError : ApiError;
107
111
  throw new Typed(res.status, text, code, { headers, retryAfterMs });
108
112
  }
109
113
  };
@@ -179,6 +183,10 @@ var RP_ROUTES = {
179
183
  authQr: { method: "POST", path: "/authentication/qr" },
180
184
  /** Байгууллагын тамганы гэрчилгээ (CA `dto.SealCertificateResponse`). */
181
185
  sealCertificate: { method: "GET", path: "/seal/certificate/{orgEtsi}" },
186
+ /** Тамганы гэрчилгээний хүсэлт (CA !483): 202 `dto.SealCertificateRequestResponse` (PENDING, ADMIN PIN2-оор батална). */
187
+ sealCertificateRequest: { method: "POST", path: "/seal/certificate/{orgEtsi}" },
188
+ /** Тамганы гэрчилгээний хүсэлтийн төлөв (CA !483, ORG_ONBOARDING §4.3) — ISSUED үед `certificate`-тэй. */
189
+ sealCertificateRequestStatus: { method: "GET", path: "/seal/certificate/{orgEtsi}/requests/{requestId}" },
182
190
  /** Байгууллагын тамга (CA `dto.SealRequest` `{digest, hashType}` → `dto.SealResponse`). */
183
191
  seal: { method: "POST", path: "/seal/{orgEtsi}" }
184
192
  };
@@ -1732,6 +1740,8 @@ function basicConstraintsPathLen(cert) {
1732
1740
  }
1733
1741
 
1734
1742
  // src/seal.ts
1743
+ var DEFAULT_SEAL_WAIT_TIMEOUT_MS = 15 * 6e4;
1744
+ var DEFAULT_SEAL_POLL_INTERVAL_MS = 3e3;
1735
1745
  var rec3 = (v) => v && typeof v === "object" ? v : {};
1736
1746
  var b642 = (s, what) => {
1737
1747
  if (typeof s !== "string" || s === "" || !/^[A-Za-z0-9+/]+={0,2}$/.test(s)) throw new ValidationError(`seal: ${what} base64 \u0431\u0438\u0448 \u044D\u0441\u0432\u044D\u043B \u0445\u043E\u043E\u0441\u043E\u043D`);
@@ -1752,32 +1762,121 @@ function isSealCertificate(cert) {
1752
1762
  const bits = v[bs.start + 1];
1753
1763
  return (bits & 64) !== 0 && (bits & 128) === 0;
1754
1764
  }
1765
+ function parseSealCertificate(raw, orgEtsi) {
1766
+ const r = rec3(raw);
1767
+ return {
1768
+ orgEtsi: String(r.orgEtsi ?? orgEtsi),
1769
+ certificate: b642(r.certificate, "certificate"),
1770
+ serialNumber: String(r.serialNumber ?? ""),
1771
+ subjectDn: String(r.subjectDn ?? ""),
1772
+ issuerDn: String(r.issuerDn ?? ""),
1773
+ notBefore: String(r.notBefore ?? ""),
1774
+ notAfter: String(r.notAfter ?? ""),
1775
+ certificateLevel: String(r.certificateLevel ?? ""),
1776
+ raw
1777
+ };
1778
+ }
1779
+ function parseSealRequest(raw, orgEtsi) {
1780
+ const r = rec3(raw);
1781
+ if (typeof r.requestId !== "string" || r.requestId === "" || typeof r.status !== "string" || r.status === "") {
1782
+ throw new ValidationError("seal: \u0445\u04AF\u0441\u044D\u043B\u0442\u0438\u0439\u043D \u0445\u0430\u0440\u0438\u0443\u043D\u0434 requestId/status \u0430\u043B\u0433\u0430");
1783
+ }
1784
+ const status = r.status;
1785
+ if (status === "ISSUED" && !r.certificate) throw new ValidationError("seal: ISSUED \u0445\u04AF\u0441\u044D\u043B\u0442\u044D\u0434 certificate \u0430\u043B\u0433\u0430");
1786
+ return {
1787
+ requestId: r.requestId,
1788
+ orgEtsi: String(r.orgEtsi ?? orgEtsi),
1789
+ status,
1790
+ createdAt: String(r.createdAt ?? ""),
1791
+ expiresAt: String(r.expiresAt ?? ""),
1792
+ ...typeof r.decidedAt === "string" ? { decidedAt: r.decidedAt } : {},
1793
+ ...typeof r.approvers === "number" ? { approvers: r.approvers } : {},
1794
+ ...typeof r.failure === "string" && r.failure ? { failure: r.failure } : {},
1795
+ ...r.certificate ? { certificate: parseSealCertificate(r.certificate, orgEtsi) } : {},
1796
+ raw
1797
+ };
1798
+ }
1799
+ function sleep(ms2, signal) {
1800
+ return new Promise((resolve, reject) => {
1801
+ if (signal?.aborted) return reject(signal.reason);
1802
+ const onAbort = () => {
1803
+ clearTimeout(t);
1804
+ reject(signal.reason);
1805
+ };
1806
+ const t = setTimeout(() => {
1807
+ signal?.removeEventListener("abort", onAbort);
1808
+ resolve();
1809
+ }, Math.max(0, ms2));
1810
+ signal?.addEventListener("abort", onAbort, { once: true });
1811
+ });
1812
+ }
1755
1813
  var SealApi = class {
1756
1814
  constructor(http) {
1757
1815
  this.http = http;
1758
1816
  }
1759
1817
  http;
1760
- /** `GET /seal/certificate/{orgEtsi}` — байгууллагын идэвхтэй тамганы гэрчилгээ (PAdES-ийн signerCert). */
1818
+ /**
1819
+ * `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
1820
+ * (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
1821
+ */
1761
1822
  async getCertificate(orgEtsi) {
1762
- const raw = await this.http.get(routePath(RP_ROUTES.sealCertificate, orgEtsi));
1763
- const r = rec3(raw);
1764
- return {
1765
- orgEtsi: String(r.orgEtsi ?? orgEtsi),
1766
- certificate: b642(r.certificate, "certificate"),
1767
- serialNumber: String(r.serialNumber ?? ""),
1768
- subjectDn: String(r.subjectDn ?? ""),
1769
- issuerDn: String(r.issuerDn ?? ""),
1770
- notBefore: String(r.notBefore ?? ""),
1771
- notAfter: String(r.notAfter ?? ""),
1772
- certificateLevel: String(r.certificateLevel ?? ""),
1773
- raw
1774
- };
1823
+ return parseSealCertificate(await this.http.get(routePath(RP_ROUTES.sealCertificate, orgEtsi)), orgEtsi);
1824
+ }
1825
+ /**
1826
+ * `POST /seal/certificate/{orgEtsi}` — тамганы гэрчилгээний ХҮСЭЛТ (202, `status: "PENDING"`). Байгууллагын ADMIN
1827
+ * төлөөлөгч(ид) eID аппаараа PIN2-оор батална; {@link waitForCertificate} / {@link getCertificateRequest}-ээр асууна.
1828
+ * Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй). Алдаа: 409 {@link
1829
+ * SealApproverUnavailableError} (идэвхтэй төхөөрөмжтэй ADMIN алга), 409 `ApiError` (байгууллага ACTIVE биш), 403
1830
+ * `ForbiddenError` (`SEAL:<orgEtsi>` эрхгүй), 404 (байгууллага олдсонгүй), 429 `RATE_LIMITED` (байгууллагад 5/цаг;
1831
+ * `retryAfterMs`), 503 {@link SealServiceDisabledError} (`service: "issuance"` — оператор гэрчилгээ олголтыг унтраасан;
1832
+ * Retry-After-гүй, давтахгүй).
1833
+ */
1834
+ async requestCertificate(orgEtsi) {
1835
+ return parseSealRequest(await this.http.post(routePath(RP_ROUTES.sealCertificateRequest, orgEtsi), {}), orgEtsi);
1836
+ }
1837
+ /**
1838
+ * `GET /seal/certificate/{orgEtsi}/requests/{requestId}` — хүсэлтийн төлөв; ISSUED үед `certificate` бөглөгдөнө. Олдоогүй
1839
+ * (эсвэл өөр байгууллагынх) → {@link SealRequestNotFoundError} 404.
1840
+ */
1841
+ async getCertificateRequest(orgEtsi, requestId) {
1842
+ const raw = await this.http.get(routePath(RP_ROUTES.sealCertificateRequestStatus, orgEtsi, requestId));
1843
+ return parseSealRequest(raw, orgEtsi);
1844
+ }
1845
+ /**
1846
+ * Хүсэлт ISSUED болтол `intervalMs` тутамд асууж олгогдсон гэрчилгээг буцаана. REJECTED / EXPIRED / FAILED →
1847
+ * {@link SealCertificateRequestError} (`outcome`, `failure`; шинэ хүсэлт хэрэгтэй); `timeoutMs` дуусвал `outcome:
1848
+ * "TIMEOUT"` (хүсэлт серверт PENDING хэвээр — ижил `requestId`-аар дахин хүлээж болно). Түр алдаа (`ApiError.retryable`:
1849
+ * 429/503 + Retry-After) — Retry-After-ийг хүлээгээд үргэлжилнэ; бусад алдаа шууд шидэгдэнэ ({@link
1850
+ * SealServiceDisabledError} ч мөн — давтахгүй). Хүсэлтийг батлах үед олголт унтраалттай байсан бол `FAILED` +
1851
+ * `failure: "SEAL_SERVICE_DISABLED"`.
1852
+ */
1853
+ async waitForCertificate(orgEtsi, requestId, opts = {}) {
1854
+ const interval = opts.intervalMs !== void 0 && opts.intervalMs > 0 ? opts.intervalMs : DEFAULT_SEAL_POLL_INTERVAL_MS;
1855
+ const deadline = Date.now() + (opts.timeoutMs !== void 0 && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_SEAL_WAIT_TIMEOUT_MS);
1856
+ for (; ; ) {
1857
+ if (opts.signal?.aborted) throw opts.signal.reason;
1858
+ let wait = interval;
1859
+ try {
1860
+ const r = await this.getCertificateRequest(orgEtsi, requestId);
1861
+ if (r.status === "ISSUED" && r.certificate) return r.certificate;
1862
+ if (r.status === "REJECTED" || r.status === "EXPIRED" || r.status === "FAILED") {
1863
+ throw new SealCertificateRequestError(r.status, r.requestId, r.failure);
1864
+ }
1865
+ } catch (e) {
1866
+ if (!(e instanceof ApiError && e.retryable)) throw e;
1867
+ wait = Math.max(interval, e.retryAfterMs ?? 0);
1868
+ }
1869
+ const left = deadline - Date.now();
1870
+ if (left <= 0) throw new SealCertificateRequestError("TIMEOUT", requestId);
1871
+ await sleep(Math.min(wait, left), opts.signal);
1872
+ }
1775
1873
  }
1776
1874
  /**
1777
1875
  * `POST /seal/{orgEtsi}` — digest-ийг байгууллагын тамгаар тамгална. `hashAlgorithm`: SHA-256 (анхдагч) | SHA-384 |
1778
1876
  * SHA-512; digest-ийн урт таарахгүй бол сүлжээнд гарахгүй. Хариуны гарын үсгийг хариуны гэрчилгээгээр digest дээр
1779
1877
  * шалгаж, гэрчилгээ e-Seal ({@link isSealCertificate}) эсэхийг тулгана — эс бөгөөс ValidationError. Гинж/цуцлалтыг
1780
- * `sealPdf` (OCSP/CRL) шалгана.
1878
+ * `sealPdf` (OCSP/CRL) шалгана. Оператор тамгалалтыг унтраасан үед 503 {@link SealServiceDisabledError} (`service:
1879
+ * "sealing"`; Retry-After-гүй, давтахгүй).
1781
1880
  */
1782
1881
  async seal(orgEtsi, digest, hashAlgorithm = "SHA-256") {
1783
1882
  if (!["SHA-256", "SHA-384", "SHA-512"].includes(hashAlgorithm)) throw new ValidationError(`seal: \u0434\u044D\u043C\u0436\u0438\u0433\u0434\u044D\u044D\u0433\u04AF\u0439 hashAlgorithm ${hashAlgorithm}`);
@@ -2972,7 +3071,7 @@ function safeEqualHex(a, b) {
2972
3071
  const y = Buffer.from(b, "hex");
2973
3072
  return x.length === y.length && x.length > 0 && timingSafeEqual3(x, y);
2974
3073
  }
2975
- function sleep(ms2, signal) {
3074
+ function sleep2(ms2, signal) {
2976
3075
  return new Promise((resolve) => {
2977
3076
  if (ms2 <= 0 || signal?.aborted) return resolve();
2978
3077
  const done = () => {
@@ -3263,7 +3362,7 @@ function createEidLogin(opts) {
3263
3362
  err = e;
3264
3363
  }
3265
3364
  }
3266
- if (mode === "push" && pushFloorMs > 0) await sleep(began + pushFloorMs - Date.now(), req.signal);
3365
+ if (mode === "push" && pushFloorMs > 0) await sleep2(began + pushFloorMs - Date.now(), req.signal);
3267
3366
  if (err !== void 0 || !r) {
3268
3367
  onError(err, ctx);
3269
3368
  if (err instanceof ApiError && err.status === 429) return limited();
@@ -3304,7 +3403,7 @@ function createEidLogin(opts) {
3304
3403
  const ctx = { request: req, mode: tx.mode };
3305
3404
  let r;
3306
3405
  if (tx.decoy) {
3307
- await sleep(pollMs, req.signal);
3406
+ await sleep2(pollMs, req.signal);
3308
3407
  r = { state: "RUNNING" };
3309
3408
  } else {
3310
3409
  try {
@@ -3425,6 +3524,8 @@ export {
3425
3524
  DEFAULT_MAX_WAIT_MS,
3426
3525
  DEFAULT_PDF_TIMEOUT_MS,
3427
3526
  DEFAULT_QR_ISSUER,
3527
+ DEFAULT_SEAL_POLL_INTERVAL_MS,
3528
+ DEFAULT_SEAL_WAIT_TIMEOUT_MS,
3428
3529
  DEFAULT_SHARE_TIMEOUT_MS,
3429
3530
  DEFAULT_SIGN_SESSION_TTL_MS,
3430
3531
  DeviceLinkError,
@@ -3461,6 +3562,10 @@ export {
3461
3562
  SHARE_ERROR_CODES,
3462
3563
  SHARE_FORM_FIELDS,
3463
3564
  SealApi,
3565
+ SealApproverUnavailableError,
3566
+ SealCertificateRequestError,
3567
+ SealRequestNotFoundError,
3568
+ SealServiceDisabledError,
3464
3569
  SessionApi,
3465
3570
  SessionFailedError,
3466
3571
  ShareError,
package/dist/pades.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-CgJcEjrZ.cjs';
1
+ import { E as EidError } from './errors-Dg6wBO_8.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
@@ -281,7 +281,8 @@ interface PadesSealOptions {
281
281
  *
282
282
  * @throws {PadesError} SIGNER_INVALID (гэрчилгээ e-Seal биш, эсвэл тамгалах хооронд гэрчилгээ солигдсон — дахин оролд),
283
283
  * prepare/complete-ийн бусад код (SIGNATURE_INVALID, TSA_UNAVAILABLE, LTV_UNAVAILABLE …). RP-API-ийн алдаа
284
- * (ForbiddenError — SEAL эрхгүй; ApiError 429 — `retryable`) хэвээр шидэгдэнэ.
284
+ * (ForbiddenError — SEAL эрхгүй; ApiError 429 — `retryable`; SealServiceDisabledError 503 `SEAL_SERVICE_DISABLED` —
285
+ * оператор тамгалалтыг унтраасан, давтахгүй) хэвээр шидэгдэнэ; `sealPdf` өөрөө дахин оролдохгүй.
285
286
  */
286
287
  declare function sealPdf(sealer: PadesSealer, orgEtsi: string, pdf: Uint8Array | ArrayBuffer, opts?: PadesSealOptions): Promise<PadesCompleted>;
287
288
 
package/dist/pades.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-CgJcEjrZ.js';
1
+ import { E as EidError } from './errors-Dg6wBO_8.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
@@ -281,7 +281,8 @@ interface PadesSealOptions {
281
281
  *
282
282
  * @throws {PadesError} SIGNER_INVALID (гэрчилгээ e-Seal биш, эсвэл тамгалах хооронд гэрчилгээ солигдсон — дахин оролд),
283
283
  * prepare/complete-ийн бусад код (SIGNATURE_INVALID, TSA_UNAVAILABLE, LTV_UNAVAILABLE …). RP-API-ийн алдаа
284
- * (ForbiddenError — SEAL эрхгүй; ApiError 429 — `retryable`) хэвээр шидэгдэнэ.
284
+ * (ForbiddenError — SEAL эрхгүй; ApiError 429 — `retryable`; SealServiceDisabledError 503 `SEAL_SERVICE_DISABLED` —
285
+ * оператор тамгалалтыг унтраасан, давтахгүй) хэвээр шидэгдэнэ; `sealPdf` өөрөө дахин оролдохгүй.
285
286
  */
286
287
  declare function sealPdf(sealer: PadesSealer, orgEtsi: string, pdf: Uint8Array | ArrayBuffer, opts?: PadesSealOptions): Promise<PadesCompleted>;
287
288
 
package/dist/pades.js CHANGED
@@ -59,7 +59,7 @@ import {
59
59
  } from "./chunk-ISTWNY6N.js";
60
60
  import {
61
61
  EidError
62
- } from "./chunk-A6FYBPRV.js";
62
+ } from "./chunk-PM2B6WB5.js";
63
63
 
64
64
  // src/pades/limits.ts
65
65
  var MAX_INPUT_BYTES = (10 << 20) - (256 << 10);
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-CgJcEjrZ.cjs';
1
+ import { E as EidError } from './errors-Dg6wBO_8.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-CgJcEjrZ.js';
1
+ import { E as EidError } from './errors-Dg6wBO_8.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
package/dist/validate.js CHANGED
@@ -65,7 +65,7 @@ import {
65
65
  } from "./chunk-ISTWNY6N.js";
66
66
  import {
67
67
  EidError
68
- } from "./chunk-A6FYBPRV.js";
68
+ } from "./chunk-PM2B6WB5.js";
69
69
 
70
70
  // src/pades/validate/evaluate.ts
71
71
  var PROBLEMS = {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gerege-systems/eid-mongolia-sdk",
3
- "version": "0.42.0",
3
+ "version": "0.44.0",
4
4
  "description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
5
5
  "license": "MIT",
6
6
  "type": "module",