@gerege-systems/eid-mongolia-sdk 0.46.1 → 0.47.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
@@ -1051,11 +1051,73 @@ writeFileSync("sealed.pdf", done.pdf); // PAdES-BASELINE-LT, байгуулла
1051
1051
  `SealCertExpiredError` | `SealCertNotYetValidError`) — 200-аар хүчингүй гэрчилгээ буцаахгүй. Go: `pades.SealPDF`; .NET:
1052
1052
  `EidPades.SealAsync`.
1053
1053
 
1054
+ ### Тамганы эрх хүсэх — RP-ийн санаачилсан (0.47.0)
1055
+
1056
+ Операторгүйгээр: танай системд байгууллагын **Гүйцэтгэх захирал**-ыг eID-ээр нэвтрүүлж (AUTHENTICATION session), тэр
1057
+ session-оор эрхийн хүсэлт илгээнэ. Захирал eID аппдаа RP-ийн нэр, байгууллагыг харж **PIN2**-оор зөвшөөрнө. Биллинг
1058
+ тооцохгүй; `SEAL:<orgEtsi>` эрх урьдчилж шаардахгүй.
1059
+
1060
+ ```ts
1061
+ import {
1062
+ ForbiddenError, AuthSessionTooOldError, AuthSessionAlreadyUsedError, SealGrantRequestError,
1063
+ } from "@gerege-systems/eid-mongolia-sdk";
1064
+ import { sealPdf } from "@gerege-systems/eid-mongolia-sdk/pades";
1065
+
1066
+ // 1. Захирлыг нэвтрүүлнэ (танай RP-ийн auth session, OK-оор дууссан) — sessionId-г хадгална.
1067
+ const session = await eid.auth.notificationByEtsi("PNOMN-12345678", [{ type: "displayTextAndPIN", displayText60: "Нэвтрэх" }]);
1068
+ const result = await eid.session.waitForResult(session.sessionId, { expiresAt: session.expiresAt });
1069
+ eid.validator.validateAuth(result, session.acsp!); // нэвтрэлт OK байх ёстой
1070
+
1071
+ // 2. Нэвтрэлтээс хойш 5 минутын дотор хүсэлт илгээнэ — push зөвхөн тэр захирал руу очно.
1072
+ try {
1073
+ const g = await eid.seal.requestGrant("NTRMN-6235972", session.sessionId); // 202 {grantId, status: "PENDING", expiresAt}
1074
+ // 3. Захирал PIN2-оор зөвшөөрөх хүртэл хүлээнэ.
1075
+ await eid.seal.waitForGrant(g.grantId, { timeoutMs: 10 * 60_000 });
1076
+ // 4. Одоо /seal/{orgEtsi} ажиллана.
1077
+ const sealed = await sealPdf(eid.seal, "NTRMN-6235972", pdfBytes);
1078
+ } catch (e) {
1079
+ if (e instanceof ForbiddenError && e.code === "NOT_ORG_CEO") {
1080
+ // нэвтэрсэн хүн байгууллагын улсын бүртгэлээр баталгаажсан Гүйцэтгэх захирал биш
1081
+ } else if (e instanceof AuthSessionTooOldError || e instanceof AuthSessionAlreadyUsedError) {
1082
+ // захирлыг дахин нэвтрүүлж шинэ session-оор хүснэ
1083
+ } else if (e instanceof SealGrantRequestError) {
1084
+ // e.outcome: "REJECTED" | "EXPIRED" | "FAILED" | "REVOKED" → шинэ нэвтрэлт + хүсэлт; "TIMEOUT" → ижил grantId-аар дахин хүлээж болно
1085
+ } else throw e;
1086
+ }
1087
+ ```
1088
+
1089
+ - `requestGrant(orgEtsi, sessionId)` — `POST /seal/grants` `{orgEtsi, sessionId}` → `SealGrantRequest` (`grantId`,
1090
+ `status: "PENDING"`, `expiresAt`). `sessionId` — танай RP-ийн эхлүүлсэн, сүүлийн **5 минутад** OK-оор дууссан
1091
+ AUTHENTICATION session; түүний хүн байгууллагын улсын бүртгэлээр баталгаажсан **Гүйцэтгэх захирал** байх ёстой, push
1092
+ зөвхөн түүн рүү. **Нэг session — нэг хүсэлт**; ижил session-ээр дахин дуудвал ижил PENDING хүсэлтийг буцаана.
1093
+ - `grantStatus(grantId)` — `GET /seal/grants/{grantId}`: `status` = `PENDING` | `APPROVED` | `REJECTED` | `EXPIRED` |
1094
+ `FAILED` | `REVOKED`; `approvedAt`, `revokedAt`, `failure`. Зөвхөн хүсэлтийн эзэн RP (бусад нь `SealGrantNotFoundError`).
1095
+ Эрх **цуцлагдтал хүчинтэй** (захирал eID аппаас, эсвэл оператор цуцална → `REVOKED`; `expiresAt` нь зөвхөн PENDING
1096
+ хүсэлтийг зөвшөөрөх хугацаа).
1097
+ - `waitForGrant(grantId, { timeoutMs = 15 мин, intervalMs = 3 с, signal })` — APPROVED болтол асууж буцаана;
1098
+ REJECTED / EXPIRED / FAILED / REVOKED / хугацаа дууссан → `SealGrantRequestError` (`outcome`, `grantId`, `failure`).
1099
+ 429/503 + Retry-After-ийг `waitForCertificate`-тэй адил хүлээнэ.
1100
+ - `eid.organization.sealGrants(personEtsi)` — `GET /organization/seal-grants/etsi/{personEtsi}` (PKI_READ; иргэн сүүлийн
1101
+ 24 цагт танай RP-ээр нэвтэрсэн): иргэн улсын бүртгэлээр Гүйцэтгэх захирал байгаа байгууллага бүр
1102
+ (`orgEtsi`, `orgName`, `orgStatus`) ба тэдгээрийн эрхүүд (`grants[]`: `grantId`, `rpName`, `rpDomain?`, `status`,
1103
+ `createdAt`, `decidedAt?`, `expiresAt?`, `approverName?`, `sealCount`, `sealCount30d`, `lastSealedAt`). Энгийн RP зөвхөн
1104
+ өөрийн эрхийг харна. Зөвхөн унших.
1105
+ - Алдаа (`requestGrant`): **400 `REQUEST_INVALID`** → `RequestInvalidError`; **403 `RP_NOT_REGISTERED` | `NOT_ORG_CEO`** →
1106
+ `ForbiddenError` (`e.code`); **404 `AUTH_SESSION_NOT_FOUND`** → `AuthSessionNotFoundError` (өөр RP-ийн session ч мөн),
1107
+ **404 `ORG_NOT_FOUND`** → `ApiError`; **409** `AUTH_SESSION_WRONG_FLOW` / `AUTH_SESSION_NOT_COMPLETED` /
1108
+ `AUTH_SESSION_TOO_OLD` / `AUTH_SESSION_ALREADY_USED` → `AuthSessionWrongFlowError` / `AuthSessionNotCompletedError` /
1109
+ `AuthSessionTooOldError` / `AuthSessionAlreadyUsedError`; `ORG_NOT_ACTIVE` → `OrgNotActiveError`; `RP_NOT_ACTIVE` →
1110
+ `RpNotActiveError`; `SEAL_GRANT_ALREADY_APPROVED` → `SealGrantAlreadyApprovedError`; `RP_PERMISSIONS_FULL` →
1111
+ `RpPermissionsFullError`; `SEAL_APPROVER_UNAVAILABLE` → `SealApproverUnavailableError`; **429 `RATE_LIMITED`** →
1112
+ `ApiError` (`retryAfterMs`). Кодын жагсаалт: `SEAL_GRANT_ERROR_CODES`. Go: `Seal.RequestGrant` / `GrantStatus` /
1113
+ `Organization.SealGrants`.
1114
+
1054
1115
  ### Тамганы эрх, түлхүүр, хүчинтэй хугацаа (0.45.0)
1055
1116
 
1056
- - **Эрх (`SEAL:<orgEtsi>`) — байгууллагын зөвшөөрлөөр.** eID-ийн оператор танай RP-д эрхийн **хүсэлт** үүсгэнэ; тухайн
1057
- байгууллагын **улсын бүртгэлээр баталгаажсан ADMIN** eID аппдаа RP-ийн нэр, домэйн, байгууллагын нэр, регистрийн дугаарыг
1058
- харж **PIN2**-оор зөвшөөрсний дараа л эрх үүснэ. Зөвшөөрөх хүртэл (татгалзсан, хугацаа дууссан үед ч) тамгалалт ба
1117
+ - **Эрх (`SEAL:<orgEtsi>`) — байгууллагын зөвшөөрлөөр.** Эрхийг **танай RP өөрөө хүсч** болно (дээрх «Тамганы эрх хүсэх»,
1118
+ 0.47.0), эсвэл eID-ийн оператор хүсэлт үүсгэнэ. Хоёр замд ч тухайн байгууллагын **улсын бүртгэлээр баталгаажсан**
1119
+ Гүйцэтгэх захирал/ADMIN eID аппдаа RP-ийн нэр, домэйн, байгууллагын нэр, регистрийн дугаарыг харж **PIN2**-оор зөвшөөрсний
1120
+ дараа л эрх үүснэ. Зөвшөөрөх хүртэл (татгалзсан, хугацаа дууссан үед ч) тамгалалт ба
1059
1121
  гэрчилгээний хүсэлт (`seal`, `sealPdf`, `requestCertificate`, `getCertificateRequest`) `ForbiddenError` 403
1060
1122
  (`getCertificate` эрх шаардахгүй). Оператор эрхийг хассан эсвэл байгууллага цуцлагдсан бол эрх хүчингүй болно (403). Эрхтэй
1061
1123
  байх хугацаанд RP-ийн нэр, callback host, mTLS гэрчилгээний subject өөрчлөгдөхгүй (операторын талын дүрэм — өөрчлөх бол
@@ -1,4 +1,4 @@
1
- import './errors-yzUBuWFg.js';
1
+ import './errors-BekL912E.js';
2
2
 
3
3
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
4
  interface NavigatorLike {
@@ -302,6 +302,43 @@ interface RepresentationsResponse {
302
302
  /** Серверийн түүхий JSON (SDK задлаагүй шинэ талбарт). */
303
303
  raw?: unknown;
304
304
  }
305
+ /**
306
+ * Байгууллагын тамга ашиглах нэг RP-ийн эрх (CA `dto.MobileSealGrant`; `GET /organization/seal-grants/etsi/{personEtsi}`).
307
+ * Энгийн RP зөвхөн өөрийн эрхийг харна.
308
+ */
309
+ interface PersonSealGrant {
310
+ grantId: string;
311
+ rpName: string;
312
+ rpDomain?: string;
313
+ /** `APPROVED` | `PENDING`. */
314
+ status: "APPROVED" | "PENDING" | string;
315
+ /** RFC 3339. */
316
+ createdAt: string;
317
+ decidedAt?: string;
318
+ /** Зөвхөн PENDING. */
319
+ expiresAt?: string;
320
+ approverName?: string;
321
+ /** Энэ RP тухайн байгууллагын нэрээр хийсэн амжилттай тамгалалт (нийт / сүүлийн 30 өдөр). Статистик түр боломжгүй бол алга. */
322
+ sealCount?: number;
323
+ sealCount30d?: number;
324
+ /** RFC 3339; хэзээ ч тамгалаагүй бол `null`, статистик түр боломжгүй бол алга. */
325
+ lastSealedAt?: string | null;
326
+ }
327
+ /** Иргэн Гүйцэтгэх захирал байгаа нэг байгууллага ба түүний RP тамганы эрхүүд. */
328
+ interface PersonOrgSealGrants {
329
+ orgEtsi: string;
330
+ orgName: string;
331
+ /** `ACTIVE` | `SUSPENDED` | `REVOKED` | … */
332
+ orgStatus: string;
333
+ grants: PersonSealGrant[];
334
+ }
335
+ /** GET /organization/seal-grants/etsi/{personEtsi} хариу. */
336
+ interface PersonSealGrantsResponse {
337
+ personEtsi: string;
338
+ organizations: PersonOrgSealGrants[];
339
+ /** Серверийн түүхий JSON. */
340
+ raw?: unknown;
341
+ }
305
342
  /** Session-ий байгууллагын блок — байгууллага + тухайн иргэний эрх (бүртгэлээс real-time). */
306
343
  interface OrgResult {
307
344
  /** `NTRMN-<улсын бүртгэлийн дугаар>`. */
@@ -329,4 +366,4 @@ interface RpCredentials {
329
366
  apiSecret: string;
330
367
  }
331
368
 
332
- export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type NavigatorLike as d, type Representation as e, type SessionPresentation as f, type SessionState as g, type SignContext as h, type SignatureAlgorithmParameters as i, type SignatureProtocol as j, type TokenCertStatus as k, isMobileUserAgent as l, startExpiry as m, parseExpiresAt as p, sessionExpiry as s };
369
+ export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, type PersonSealGrantsResponse as c, DEFAULT_SIGN_SESSION_TTL_MS as d, type NavigatorLike as e, type PersonOrgSealGrants as f, type PersonSealGrant as g, type Representation as h, type SessionPresentation as i, type SessionState as j, type SignContext as k, type SignatureAlgorithmParameters as l, type SignatureProtocol as m, type TokenCertStatus as n, isMobileUserAgent as o, parseExpiresAt as p, startExpiry as q, sessionExpiry as s };
@@ -1,4 +1,4 @@
1
- import './errors-yzUBuWFg.cjs';
1
+ import './errors-BekL912E.cjs';
2
2
 
3
3
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
4
  interface NavigatorLike {
@@ -302,6 +302,43 @@ interface RepresentationsResponse {
302
302
  /** Серверийн түүхий JSON (SDK задлаагүй шинэ талбарт). */
303
303
  raw?: unknown;
304
304
  }
305
+ /**
306
+ * Байгууллагын тамга ашиглах нэг RP-ийн эрх (CA `dto.MobileSealGrant`; `GET /organization/seal-grants/etsi/{personEtsi}`).
307
+ * Энгийн RP зөвхөн өөрийн эрхийг харна.
308
+ */
309
+ interface PersonSealGrant {
310
+ grantId: string;
311
+ rpName: string;
312
+ rpDomain?: string;
313
+ /** `APPROVED` | `PENDING`. */
314
+ status: "APPROVED" | "PENDING" | string;
315
+ /** RFC 3339. */
316
+ createdAt: string;
317
+ decidedAt?: string;
318
+ /** Зөвхөн PENDING. */
319
+ expiresAt?: string;
320
+ approverName?: string;
321
+ /** Энэ RP тухайн байгууллагын нэрээр хийсэн амжилттай тамгалалт (нийт / сүүлийн 30 өдөр). Статистик түр боломжгүй бол алга. */
322
+ sealCount?: number;
323
+ sealCount30d?: number;
324
+ /** RFC 3339; хэзээ ч тамгалаагүй бол `null`, статистик түр боломжгүй бол алга. */
325
+ lastSealedAt?: string | null;
326
+ }
327
+ /** Иргэн Гүйцэтгэх захирал байгаа нэг байгууллага ба түүний RP тамганы эрхүүд. */
328
+ interface PersonOrgSealGrants {
329
+ orgEtsi: string;
330
+ orgName: string;
331
+ /** `ACTIVE` | `SUSPENDED` | `REVOKED` | … */
332
+ orgStatus: string;
333
+ grants: PersonSealGrant[];
334
+ }
335
+ /** GET /organization/seal-grants/etsi/{personEtsi} хариу. */
336
+ interface PersonSealGrantsResponse {
337
+ personEtsi: string;
338
+ organizations: PersonOrgSealGrants[];
339
+ /** Серверийн түүхий JSON. */
340
+ raw?: unknown;
341
+ }
305
342
  /** Session-ий байгууллагын блок — байгууллага + тухайн иргэний эрх (бүртгэлээс real-time). */
306
343
  interface OrgResult {
307
344
  /** `NTRMN-<улсын бүртгэлийн дугаар>`. */
@@ -329,4 +366,4 @@ interface RpCredentials {
329
366
  apiSecret: string;
330
367
  }
331
368
 
332
- export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type NavigatorLike as d, type Representation as e, type SessionPresentation as f, type SessionState as g, type SignContext as h, type SignatureAlgorithmParameters as i, type SignatureProtocol as j, type TokenCertStatus as k, isMobileUserAgent as l, startExpiry as m, parseExpiresAt as p, sessionExpiry as s };
369
+ export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OrgResult as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, type PersonSealGrantsResponse as c, DEFAULT_SIGN_SESSION_TTL_MS as d, type NavigatorLike as e, type PersonOrgSealGrants as f, type PersonSealGrant as g, type Representation as h, type SessionPresentation as i, type SessionState as j, type SignContext as k, type SignatureAlgorithmParameters as l, type SignatureProtocol as m, type TokenCertStatus as n, isMobileUserAgent as o, parseExpiresAt as p, startExpiry as q, sessionExpiry as s };
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-Dn-mhGl0.cjs';
2
- export { D as DeviceLinkError, E as EidError } from './errors-yzUBuWFg.cjs';
1
+ export { D as DeviceLinkSession, e as NavigatorLike, o as isMobileUserAgent } from './browser-C-n2Wa5u.cjs';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-BekL912E.cjs';
package/dist/browser.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-CSP4_HJj.js';
2
- export { D as DeviceLinkError, E as EidError } from './errors-yzUBuWFg.js';
1
+ export { D as DeviceLinkSession, e as NavigatorLike, o as isMobileUserAgent } from './browser-5yPFDx6a.js';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-BekL912E.js';
package/dist/browser.js CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  DeviceLinkError,
6
6
  EidError
7
- } from "./chunk-6AGWRTZG.js";
7
+ } from "./chunk-J4BEQDT3.js";
8
8
  export {
9
9
  DeviceLinkError,
10
10
  EidError,
@@ -72,6 +72,24 @@ var SealApproverUnavailableError = class extends ApiError {
72
72
  };
73
73
  var SealRequestNotFoundError = class extends ApiError {
74
74
  };
75
+ var AuthSessionWrongFlowError = class extends ApiError {
76
+ };
77
+ var AuthSessionNotCompletedError = class extends ApiError {
78
+ };
79
+ var AuthSessionTooOldError = class extends ApiError {
80
+ };
81
+ var AuthSessionAlreadyUsedError = class extends ApiError {
82
+ };
83
+ var AuthSessionNotFoundError = class extends ApiError {
84
+ };
85
+ var SealGrantAlreadyApprovedError = class extends ApiError {
86
+ };
87
+ var SealGrantNotFoundError = class extends ApiError {
88
+ };
89
+ var RpNotActiveError = class extends ApiError {
90
+ };
91
+ var RpPermissionsFullError = class extends ApiError {
92
+ };
75
93
  var OrgNotActiveError = class extends ApiError {
76
94
  };
77
95
  var SealNotIssuedError = class extends ApiError {
@@ -95,6 +113,24 @@ var SEAL_ERROR_CODES = [
95
113
  "SEAL_REQUEST_NOT_FOUND",
96
114
  "SEAL_SERVICE_DISABLED"
97
115
  ];
116
+ var SEAL_GRANT_ERROR_CODES = [
117
+ "REQUEST_INVALID",
118
+ "RP_NOT_REGISTERED",
119
+ "NOT_ORG_CEO",
120
+ "AUTH_SESSION_NOT_FOUND",
121
+ "ORG_NOT_FOUND",
122
+ "SEAL_GRANT_NOT_FOUND",
123
+ "AUTH_SESSION_WRONG_FLOW",
124
+ "AUTH_SESSION_NOT_COMPLETED",
125
+ "AUTH_SESSION_TOO_OLD",
126
+ "AUTH_SESSION_ALREADY_USED",
127
+ "ORG_NOT_ACTIVE",
128
+ "RP_NOT_ACTIVE",
129
+ "SEAL_GRANT_ALREADY_APPROVED",
130
+ "RP_PERMISSIONS_FULL",
131
+ "SEAL_APPROVER_UNAVAILABLE",
132
+ "RATE_LIMITED"
133
+ ];
98
134
  var SealServiceDisabledError = class extends ApiError {
99
135
  /** Хариуны биеийн `service`; байхгүй / танигдаагүй утга бол undefined. */
100
136
  service;
@@ -127,6 +163,17 @@ var SealCertificateRequestError = class extends EidError {
127
163
  requestId;
128
164
  failure;
129
165
  };
166
+ var SealGrantRequestError = class extends EidError {
167
+ constructor(outcome, grantId, failure) {
168
+ super(`\u0442\u0430\u043C\u0433\u0430\u043D\u044B \u044D\u0440\u0445\u0438\u0439\u043D \u0445\u04AF\u0441\u044D\u043B\u0442 ${outcome}${failure ? ` (${failure})` : ""}`);
169
+ this.outcome = outcome;
170
+ this.grantId = grantId;
171
+ this.failure = failure;
172
+ }
173
+ outcome;
174
+ grantId;
175
+ failure;
176
+ };
130
177
  var RETRYABLE_ERROR_CODES = [
131
178
  "RATE_LIMITED",
132
179
  "STATE_UNAVAILABLE",
@@ -221,6 +268,15 @@ export {
221
268
  QrTokenInvalidError,
222
269
  SealApproverUnavailableError,
223
270
  SealRequestNotFoundError,
271
+ AuthSessionWrongFlowError,
272
+ AuthSessionNotCompletedError,
273
+ AuthSessionTooOldError,
274
+ AuthSessionAlreadyUsedError,
275
+ AuthSessionNotFoundError,
276
+ SealGrantAlreadyApprovedError,
277
+ SealGrantNotFoundError,
278
+ RpNotActiveError,
279
+ RpPermissionsFullError,
224
280
  OrgNotActiveError,
225
281
  SealNotIssuedError,
226
282
  SealCertRevokedError,
@@ -228,8 +284,10 @@ export {
228
284
  SealCertExpiredError,
229
285
  SealCertNotYetValidError,
230
286
  SEAL_ERROR_CODES,
287
+ SEAL_GRANT_ERROR_CODES,
231
288
  SealServiceDisabledError,
232
289
  SealCertificateRequestError,
290
+ SealGrantRequestError,
233
291
  RETRYABLE_ERROR_CODES,
234
292
  parseRetryAfter,
235
293
  ON_BEHALF_ERROR_CODES,
@@ -99,6 +99,36 @@ declare class SealApproverUnavailableError extends ApiError {
99
99
  */
100
100
  declare class SealRequestNotFoundError extends ApiError {
101
101
  }
102
+ /**
103
+ * Тамганы эрхийн хүсэлтийн (`eid.seal.requestGrant`) 409 `AUTH_SESSION_WRONG_FLOW` — `sessionId` AUTHENTICATION session
104
+ * биш («Миний QR» ч биш). Програмын алдаа.
105
+ */
106
+ declare class AuthSessionWrongFlowError extends ApiError {
107
+ }
108
+ /** 409 `AUTH_SESSION_NOT_COMPLETED` (`requestGrant`) — session дуусаагүй эсвэл OK-оос өөр үр дүнтэй. Иргэнийг дахин нэвтрүүлнэ. */
109
+ declare class AuthSessionNotCompletedError extends ApiError {
110
+ }
111
+ /** 409 `AUTH_SESSION_TOO_OLD` (`requestGrant`) — session дууссанаас хойш 5 минутаас их. Иргэнийг дахин нэвтрүүлж шууд хүснэ. */
112
+ declare class AuthSessionTooOldError extends ApiError {
113
+ }
114
+ /** 409 `AUTH_SESSION_ALREADY_USED` (`requestGrant`) — энэ session өөр тамганы эрхийн хүсэлтийн үндэс болсон (нэг session — нэг хүсэлт). */
115
+ declare class AuthSessionAlreadyUsedError extends ApiError {
116
+ }
117
+ /** 404 `AUTH_SESSION_NOT_FOUND` (`requestGrant`) — session байхгүй, эсвэл өөр RP-ийнх (ялгахгүй). */
118
+ declare class AuthSessionNotFoundError extends ApiError {
119
+ }
120
+ /** 409 `SEAL_GRANT_ALREADY_APPROVED` (`requestGrant`) — энэ RP тухайн байгууллагад тамганы эрхтэй аль хэдийн. */
121
+ declare class SealGrantAlreadyApprovedError extends ApiError {
122
+ }
123
+ /** 404 `SEAL_GRANT_NOT_FOUND` (`eid.seal.grantStatus` / `waitForGrant`) — хүсэлт олдсонгүй (эсвэл өөр RP-ийнх). */
124
+ declare class SealGrantNotFoundError extends ApiError {
125
+ }
126
+ /** 409 `RP_NOT_ACTIVE` (`requestGrant`) — танай RP идэвхтэй биш (операторт хандана). */
127
+ declare class RpNotActiveError extends ApiError {
128
+ }
129
+ /** 409 `RP_PERMISSIONS_FULL` (`requestGrant`) — RP-ийн эрхийн жагсаалт дүүрсэн; шинэ байгууллагын эрх нэмэгдэхгүй. */
130
+ declare class RpPermissionsFullError extends ApiError {
131
+ }
102
132
  /**
103
133
  * 409 `ORG_NOT_ACTIVE` (`eid.seal.seal` / `sealPdf`, `eid.seal.requestCertificate`) — байгууллага eID-д `ACTIVE` биш (түр
104
134
  * зогссон / цуцлагдсан). Тамганы гэрчилгээ ба RP-ийн тамганы эрх түр зогсолтод хэвээр — байгууллага сэргэмэгц үргэлжилнэ;
@@ -147,6 +177,16 @@ declare class SealCertNotYetValidError extends ApiError {
147
177
  type SealErrorCode = "ORG_NOT_ACTIVE" | "SEAL_NOT_ISSUED" | "SEAL_CERT_REVOKED" | "SEAL_KEY_UNAVAILABLE" | "SEAL_CERT_EXPIRED" | "SEAL_CERT_NOT_YET_VALID" | "SEAL_APPROVER_UNAVAILABLE" | "SEAL_REQUEST_NOT_FOUND" | "SEAL_SERVICE_DISABLED";
148
178
  /** {@link SealErrorCode}-ийн бүх утга (runtime шалгалтад). */
149
179
  declare const SEAL_ERROR_CODES: readonly SealErrorCode[];
180
+ /**
181
+ * Тамганы эрхийн хүсэлтийн (`/seal/grants`) CA алдааны тогтвортой кодууд — `ApiError.code` / `ForbiddenError.code`.
182
+ * 400 REQUEST_INVALID; 403 RP_NOT_REGISTERED | NOT_ORG_CEO ({@link ForbiddenError}); 404 AUTH_SESSION_NOT_FOUND |
183
+ * ORG_NOT_FOUND | SEAL_GRANT_NOT_FOUND; 409 AUTH_SESSION_WRONG_FLOW | AUTH_SESSION_NOT_COMPLETED | AUTH_SESSION_TOO_OLD |
184
+ * AUTH_SESSION_ALREADY_USED | ORG_NOT_ACTIVE | RP_NOT_ACTIVE | SEAL_GRANT_ALREADY_APPROVED | RP_PERMISSIONS_FULL |
185
+ * SEAL_APPROVER_UNAVAILABLE; 429 RATE_LIMITED.
186
+ */
187
+ type SealGrantErrorCode = "REQUEST_INVALID" | "RP_NOT_REGISTERED" | "NOT_ORG_CEO" | "AUTH_SESSION_NOT_FOUND" | "ORG_NOT_FOUND" | "SEAL_GRANT_NOT_FOUND" | "AUTH_SESSION_WRONG_FLOW" | "AUTH_SESSION_NOT_COMPLETED" | "AUTH_SESSION_TOO_OLD" | "AUTH_SESSION_ALREADY_USED" | "ORG_NOT_ACTIVE" | "RP_NOT_ACTIVE" | "SEAL_GRANT_ALREADY_APPROVED" | "RP_PERMISSIONS_FULL" | "SEAL_APPROVER_UNAVAILABLE" | "RATE_LIMITED";
188
+ /** {@link SealGrantErrorCode}-ийн бүх утга (runtime шалгалтад). */
189
+ declare const SEAL_GRANT_ERROR_CODES: readonly SealGrantErrorCode[];
150
190
  /** Унтраалттай тамганы үйлчилгээ (CA `{"service"}`): `issuance` — гэрчилгээ олголт, `sealing` — тамгалалт. */
151
191
  type SealService = "issuance" | "sealing";
152
192
  /**
@@ -180,6 +220,22 @@ declare class SealCertificateRequestError extends EidError {
180
220
  /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
181
221
  failure?: string | undefined);
182
222
  }
223
+ /** Тамганы эрхийн хүсэлтийн (APPROVED биш) төгсгөлийн төлөв, эсвэл `waitForGrant`-ийн хугацаа дууссан. */
224
+ type SealGrantOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "REVOKED" | "TIMEOUT";
225
+ /**
226
+ * `eid.seal.waitForGrant` — хүсэлт эрхгүй дууссан: `REJECTED` (захирал татгалзсан), `EXPIRED` (зөвшөөрөх хугацаа дууссан),
227
+ * `FAILED` (push илгээгдээгүй г.м.), `REVOKED` (эрх цуцлагдсан) — бүгд шинэ хүсэлт (шинэ нэвтрэлт + `requestGrant`) шаардана;
228
+ * `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт серверт PENDING хэвээр (ижил `grantId`-аар дахин хүлээж болно).
229
+ */
230
+ declare class SealGrantRequestError extends EidError {
231
+ readonly outcome: SealGrantOutcome;
232
+ readonly grantId: string;
233
+ /** Серверийн `failure` код (FAILED / EXPIRED / REVOKED үед), байхгүй бол undefined. */
234
+ readonly failure?: string | undefined;
235
+ constructor(outcome: SealGrantOutcome, grantId: string,
236
+ /** Серверийн `failure` код (FAILED / EXPIRED / REVOKED үед), байхгүй бол undefined. */
237
+ failure?: string | undefined);
238
+ }
183
239
  /**
184
240
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
185
241
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -263,4 +319,4 @@ declare class AppTransactionTooLargeError extends EidError {
263
319
  declare class DeviceLinkError extends EidError {
264
320
  }
265
321
 
266
- 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, SEAL_ERROR_CODES as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, OrgNotActiveError as e, type PdfRegisterErrorCode as f, RETRYABLE_ERROR_CODES as g, RequestInvalidError as h, ResponseTooLargeError as i, SealApproverUnavailableError as j, SealCertExpiredError as k, SealCertNotYetValidError as l, SealCertRevokedError as m, SealCertificateRequestError as n, type SealErrorCode as o, SealKeyUnavailableError as p, SealNotIssuedError as q, SealRequestNotFoundError as r, type SealRequestOutcome as s, type SealService as t, SealServiceDisabledError as u, SessionFailedError as v, parseRetryAfter as w };
322
+ export { ApiError as A, type SealGrantOutcome as B, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, SealGrantRequestError as G, type HttpErrorInit as H, SealKeyUnavailableError as I, SealNotIssuedError as J, SealRequestNotFoundError as K, type SealRequestOutcome as L, type SealService as M, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SEAL_ERROR_CODES as S, SealServiceDisabledError as T, SessionFailedError as U, ValidationError as V, parseRetryAfter as W, AppTransactionTooLargeError as a, AuthSessionAlreadyUsedError as b, AuthSessionNotCompletedError as c, AuthSessionNotFoundError as d, AuthSessionTooOldError as e, AuthSessionWrongFlowError as f, AuthenticationError as g, NoSigningCertificateError as h, ON_BEHALF_ERROR_CODES as i, OrgNotActiveError as j, type PdfRegisterErrorCode as k, RETRYABLE_ERROR_CODES as l, RequestInvalidError as m, ResponseTooLargeError as n, RpNotActiveError as o, RpPermissionsFullError as p, SEAL_GRANT_ERROR_CODES as q, SealApproverUnavailableError as r, SealCertExpiredError as s, SealCertNotYetValidError as t, SealCertRevokedError as u, SealCertificateRequestError as v, type SealErrorCode as w, SealGrantAlreadyApprovedError as x, type SealGrantErrorCode as y, SealGrantNotFoundError as z };
@@ -99,6 +99,36 @@ declare class SealApproverUnavailableError extends ApiError {
99
99
  */
100
100
  declare class SealRequestNotFoundError extends ApiError {
101
101
  }
102
+ /**
103
+ * Тамганы эрхийн хүсэлтийн (`eid.seal.requestGrant`) 409 `AUTH_SESSION_WRONG_FLOW` — `sessionId` AUTHENTICATION session
104
+ * биш («Миний QR» ч биш). Програмын алдаа.
105
+ */
106
+ declare class AuthSessionWrongFlowError extends ApiError {
107
+ }
108
+ /** 409 `AUTH_SESSION_NOT_COMPLETED` (`requestGrant`) — session дуусаагүй эсвэл OK-оос өөр үр дүнтэй. Иргэнийг дахин нэвтрүүлнэ. */
109
+ declare class AuthSessionNotCompletedError extends ApiError {
110
+ }
111
+ /** 409 `AUTH_SESSION_TOO_OLD` (`requestGrant`) — session дууссанаас хойш 5 минутаас их. Иргэнийг дахин нэвтрүүлж шууд хүснэ. */
112
+ declare class AuthSessionTooOldError extends ApiError {
113
+ }
114
+ /** 409 `AUTH_SESSION_ALREADY_USED` (`requestGrant`) — энэ session өөр тамганы эрхийн хүсэлтийн үндэс болсон (нэг session — нэг хүсэлт). */
115
+ declare class AuthSessionAlreadyUsedError extends ApiError {
116
+ }
117
+ /** 404 `AUTH_SESSION_NOT_FOUND` (`requestGrant`) — session байхгүй, эсвэл өөр RP-ийнх (ялгахгүй). */
118
+ declare class AuthSessionNotFoundError extends ApiError {
119
+ }
120
+ /** 409 `SEAL_GRANT_ALREADY_APPROVED` (`requestGrant`) — энэ RP тухайн байгууллагад тамганы эрхтэй аль хэдийн. */
121
+ declare class SealGrantAlreadyApprovedError extends ApiError {
122
+ }
123
+ /** 404 `SEAL_GRANT_NOT_FOUND` (`eid.seal.grantStatus` / `waitForGrant`) — хүсэлт олдсонгүй (эсвэл өөр RP-ийнх). */
124
+ declare class SealGrantNotFoundError extends ApiError {
125
+ }
126
+ /** 409 `RP_NOT_ACTIVE` (`requestGrant`) — танай RP идэвхтэй биш (операторт хандана). */
127
+ declare class RpNotActiveError extends ApiError {
128
+ }
129
+ /** 409 `RP_PERMISSIONS_FULL` (`requestGrant`) — RP-ийн эрхийн жагсаалт дүүрсэн; шинэ байгууллагын эрх нэмэгдэхгүй. */
130
+ declare class RpPermissionsFullError extends ApiError {
131
+ }
102
132
  /**
103
133
  * 409 `ORG_NOT_ACTIVE` (`eid.seal.seal` / `sealPdf`, `eid.seal.requestCertificate`) — байгууллага eID-д `ACTIVE` биш (түр
104
134
  * зогссон / цуцлагдсан). Тамганы гэрчилгээ ба RP-ийн тамганы эрх түр зогсолтод хэвээр — байгууллага сэргэмэгц үргэлжилнэ;
@@ -147,6 +177,16 @@ declare class SealCertNotYetValidError extends ApiError {
147
177
  type SealErrorCode = "ORG_NOT_ACTIVE" | "SEAL_NOT_ISSUED" | "SEAL_CERT_REVOKED" | "SEAL_KEY_UNAVAILABLE" | "SEAL_CERT_EXPIRED" | "SEAL_CERT_NOT_YET_VALID" | "SEAL_APPROVER_UNAVAILABLE" | "SEAL_REQUEST_NOT_FOUND" | "SEAL_SERVICE_DISABLED";
148
178
  /** {@link SealErrorCode}-ийн бүх утга (runtime шалгалтад). */
149
179
  declare const SEAL_ERROR_CODES: readonly SealErrorCode[];
180
+ /**
181
+ * Тамганы эрхийн хүсэлтийн (`/seal/grants`) CA алдааны тогтвортой кодууд — `ApiError.code` / `ForbiddenError.code`.
182
+ * 400 REQUEST_INVALID; 403 RP_NOT_REGISTERED | NOT_ORG_CEO ({@link ForbiddenError}); 404 AUTH_SESSION_NOT_FOUND |
183
+ * ORG_NOT_FOUND | SEAL_GRANT_NOT_FOUND; 409 AUTH_SESSION_WRONG_FLOW | AUTH_SESSION_NOT_COMPLETED | AUTH_SESSION_TOO_OLD |
184
+ * AUTH_SESSION_ALREADY_USED | ORG_NOT_ACTIVE | RP_NOT_ACTIVE | SEAL_GRANT_ALREADY_APPROVED | RP_PERMISSIONS_FULL |
185
+ * SEAL_APPROVER_UNAVAILABLE; 429 RATE_LIMITED.
186
+ */
187
+ type SealGrantErrorCode = "REQUEST_INVALID" | "RP_NOT_REGISTERED" | "NOT_ORG_CEO" | "AUTH_SESSION_NOT_FOUND" | "ORG_NOT_FOUND" | "SEAL_GRANT_NOT_FOUND" | "AUTH_SESSION_WRONG_FLOW" | "AUTH_SESSION_NOT_COMPLETED" | "AUTH_SESSION_TOO_OLD" | "AUTH_SESSION_ALREADY_USED" | "ORG_NOT_ACTIVE" | "RP_NOT_ACTIVE" | "SEAL_GRANT_ALREADY_APPROVED" | "RP_PERMISSIONS_FULL" | "SEAL_APPROVER_UNAVAILABLE" | "RATE_LIMITED";
188
+ /** {@link SealGrantErrorCode}-ийн бүх утга (runtime шалгалтад). */
189
+ declare const SEAL_GRANT_ERROR_CODES: readonly SealGrantErrorCode[];
150
190
  /** Унтраалттай тамганы үйлчилгээ (CA `{"service"}`): `issuance` — гэрчилгээ олголт, `sealing` — тамгалалт. */
151
191
  type SealService = "issuance" | "sealing";
152
192
  /**
@@ -180,6 +220,22 @@ declare class SealCertificateRequestError extends EidError {
180
220
  /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
181
221
  failure?: string | undefined);
182
222
  }
223
+ /** Тамганы эрхийн хүсэлтийн (APPROVED биш) төгсгөлийн төлөв, эсвэл `waitForGrant`-ийн хугацаа дууссан. */
224
+ type SealGrantOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "REVOKED" | "TIMEOUT";
225
+ /**
226
+ * `eid.seal.waitForGrant` — хүсэлт эрхгүй дууссан: `REJECTED` (захирал татгалзсан), `EXPIRED` (зөвшөөрөх хугацаа дууссан),
227
+ * `FAILED` (push илгээгдээгүй г.м.), `REVOKED` (эрх цуцлагдсан) — бүгд шинэ хүсэлт (шинэ нэвтрэлт + `requestGrant`) шаардана;
228
+ * `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт серверт PENDING хэвээр (ижил `grantId`-аар дахин хүлээж болно).
229
+ */
230
+ declare class SealGrantRequestError extends EidError {
231
+ readonly outcome: SealGrantOutcome;
232
+ readonly grantId: string;
233
+ /** Серверийн `failure` код (FAILED / EXPIRED / REVOKED үед), байхгүй бол undefined. */
234
+ readonly failure?: string | undefined;
235
+ constructor(outcome: SealGrantOutcome, grantId: string,
236
+ /** Серверийн `failure` код (FAILED / EXPIRED / REVOKED үед), байхгүй бол undefined. */
237
+ failure?: string | undefined);
238
+ }
183
239
  /**
184
240
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
185
241
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -263,4 +319,4 @@ declare class AppTransactionTooLargeError extends EidError {
263
319
  declare class DeviceLinkError extends EidError {
264
320
  }
265
321
 
266
- 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, SEAL_ERROR_CODES as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, OrgNotActiveError as e, type PdfRegisterErrorCode as f, RETRYABLE_ERROR_CODES as g, RequestInvalidError as h, ResponseTooLargeError as i, SealApproverUnavailableError as j, SealCertExpiredError as k, SealCertNotYetValidError as l, SealCertRevokedError as m, SealCertificateRequestError as n, type SealErrorCode as o, SealKeyUnavailableError as p, SealNotIssuedError as q, SealRequestNotFoundError as r, type SealRequestOutcome as s, type SealService as t, SealServiceDisabledError as u, SessionFailedError as v, parseRetryAfter as w };
322
+ export { ApiError as A, type SealGrantOutcome as B, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, SealGrantRequestError as G, type HttpErrorInit as H, SealKeyUnavailableError as I, SealNotIssuedError as J, SealRequestNotFoundError as K, type SealRequestOutcome as L, type SealService as M, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SEAL_ERROR_CODES as S, SealServiceDisabledError as T, SessionFailedError as U, ValidationError as V, parseRetryAfter as W, AppTransactionTooLargeError as a, AuthSessionAlreadyUsedError as b, AuthSessionNotCompletedError as c, AuthSessionNotFoundError as d, AuthSessionTooOldError as e, AuthSessionWrongFlowError as f, AuthenticationError as g, NoSigningCertificateError as h, ON_BEHALF_ERROR_CODES as i, OrgNotActiveError as j, type PdfRegisterErrorCode as k, RETRYABLE_ERROR_CODES as l, RequestInvalidError as m, ResponseTooLargeError as n, RpNotActiveError as o, RpPermissionsFullError as p, SEAL_GRANT_ERROR_CODES as q, SealApproverUnavailableError as r, SealCertExpiredError as s, SealCertNotYetValidError as t, SealCertRevokedError as u, SealCertificateRequestError as v, type SealErrorCode as w, SealGrantAlreadyApprovedError as x, type SealGrantErrorCode as y, SealGrantNotFoundError as z };