@gerege-systems/eid-mongolia-sdk 0.41.0 → 0.43.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
@@ -998,6 +998,75 @@ KeyUsage contentCommitment, QUALIFIED (qcStatements), issuer allowlist (анхд
998
998
  `PERMISSION_DENIED` / `RP_REQUIRED`, 404 `QR_TOKEN_INVALID`, 409 `NO_SIGNING_CERTIFICATE`, 429 `RATE_LIMITED`; `GET /session`-ийн
999
999
  410 → `QrError` `QR_PRESENTATION_GONE` (presentation нэг л удаа өгөгдөнө). `qr.issuer` тохиргоо — тест орчинд л.
1000
1000
 
1001
+ ## 3i. Байгууллагын цахим тамга (e-Seal) — `eid.seal`, `sealPdf` (0.42.0)
1002
+
1003
+ Байгууллагын нэрийн өмнөөс **хүнгүй, автомат** систем баримт тамгална (нэхэмжлэх, тодорхойлолт, хуулга): түлхүүр eID-ийн
1004
+ серверт, иргэн/PIN/апп оролцохгүй, хариу шууд (session-гүй). RP-д тухайн байгууллагын **`SEAL:<orgEtsi>`** эрх хэрэгтэй
1005
+ (eID-ийн оператор олгоно; эрхгүй бол `ForbiddenError` 403). Иргэн байгууллагын нэрийн өмнөөс зурах бол §3a (тамга биш).
1006
+ Зөвхөн backend (RP secret).
1007
+
1008
+ ```ts
1009
+ import { sealPdf, PadesError } from "@gerege-systems/eid-mongolia-sdk/pades";
1010
+
1011
+ const done = await sealPdf(eid.seal, "NTRMN-6235972", pdfBytes, { reason: "Нэхэмжлэх" });
1012
+ writeFileSync("sealed.pdf", done.pdf); // PAdES-BASELINE-LT, байгууллагын тамгатай
1013
+ ```
1014
+
1015
+ - Урсгал: `eid.seal.getCertificate(org)` (`GET /seal/certificate/{orgEtsi}`) → `prepare` (signerCert = тамганы cert) →
1016
+ 32 байт DTBS-ийг `eid.seal.seal(org, dtbs, "SHA-256")` (`POST /seal/{orgEtsi}`, `{digest, hashType}`) → `complete`.
1017
+ PDF eID руу очихгүй.
1018
+ - **RFC 3161 timestamp заавал** (eID TSA, `complete.tsaUrl`): TSA хүрэхгүй бол `TSA_UNAVAILABLE`, цагийн тэмдэггүй файл
1019
+ буцаахгүй; OCSP/CRL + DSS → B-LT. Тамга үл харагдах, баталгаажуулалтын (QR) хуудасгүй — тамга иргэний гарын үсгийн
1020
+ бүртгэлд (`registerSignature`) ордоггүй тул `/verify/{docId}` холбоос өгөхгүй.
1021
+ - Шалгагч (`validatePdf`, CA `/v3/validate/pdf`) энэ гарын үсгийг `certificate.usage: "seal"` гэж ангилна — хэрэглэгчид
1022
+ «Байгууллагын тамга» гэж харуулна уу.
1023
+ - `eid.seal.seal` хариуг шалгана: гарын үсэг хариуны гэрчилгээгээр digest дээр таарч, гэрчилгээ e-Seal профайл
1024
+ (`isSealCertificate`: KeyUsage = зөвхөн nonRepudiation, EKU-гүй) байх ёстой — эс бөгөөс `ValidationError`.
1025
+ `hashAlgorithm`: `SHA-256` (анхдагч) | `SHA-384` | `SHA-512`.
1026
+ - Алдаа: `PadesError` `SIGNER_INVALID` (cert e-Seal биш, эсвэл тамгалах хооронд cert солигдсон — дахин оролд),
1027
+ `SIGNATURE_INVALID`, `TSA_UNAVAILABLE` / `LTV_UNAVAILABLE` (`retryable`); RP-API-ийн алдаа хэвээр: **429
1028
+ `RATE_LIMITED`** → `ApiError` (`retryable`, `retryAfterMs`-ийн дараа дахин), 404 — байгууллага олдсонгүй, 409 —
1029
+ байгууллага ACTIVE биш эсвэл идэвхтэй тамганы гэрчилгээ алга/цуцлагдсан.
1030
+ - `eid.seal.getCertificate(org)` нь байгууллагын **одоогийн (олгогдсон, идэвхтэй)** тамганы гэрчилгээг буцаана — шинээр
1031
+ олгохгүй; идэвхтэй cert алга / цуцлагдсан бол 409. Go: `pades.SealPDF`; .NET: `EidPades.SealAsync`.
1032
+
1033
+ ### Тамганы гэрчилгээ олгуулах (0.43.0)
1034
+
1035
+ Гэрчилгээг RP ч, оператор ч шууд гаргахгүй — **хүсэлт** үүсгэнэ. Байгууллагын хүчинтэй **ADMIN** төлөөлөгч бүр (идэвхтэй
1036
+ eID төхөөрөмжтэй, ≤ 5) eID аппад «"<байгууллага>"-ын цахим тамганы гэрчилгээ олгохыг зөвшөөрч байна» хүсэлт хүлээн авч
1037
+ **PIN2**-оор батална. Нэг ADMIN баталмагц гэрчилгээ гарна (`ISSUED`); татгалзвал `REJECTED`; батлах хугацаа (гарын
1038
+ үсгийн session TTL + 2 мин) дуусвал `EXPIRED`.
1039
+
1040
+ ```ts
1041
+ import { SealApproverUnavailableError, SealCertificateRequestError } from "@gerege-systems/eid-mongolia-sdk";
1042
+
1043
+ const req = await eid.seal.requestCertificate("NTRMN-6235972"); // 202 {requestId, status: "PENDING", expiresAt, approvers}
1044
+ try {
1045
+ const cert = await eid.seal.waitForCertificate("NTRMN-6235972", req.requestId, { timeoutMs: 10 * 60_000 });
1046
+ // cert: {certificate (DER), serialNumber, notBefore, notAfter, certificateLevel, …} — getCertificate-тэй ижил хэлбэр
1047
+ } catch (e) {
1048
+ if (e instanceof SealCertificateRequestError) {
1049
+ // e.outcome: "REJECTED" | "EXPIRED" | "FAILED" → шинэ хүсэлт; "TIMEOUT" → ижил requestId-аар дахин хүлээж болно
1050
+ } else if (e instanceof SealApproverUnavailableError) {
1051
+ // (requestCertificate) байгууллагад идэвхтэй eID-тэй ADMIN алга
1052
+ } else throw e;
1053
+ }
1054
+ ```
1055
+
1056
+ - `requestCertificate(org)` — `POST /seal/certificate/{orgEtsi}` → `SealCertificateRequest` (`requestId`, `status:
1057
+ "PENDING"`, `createdAt`, `expiresAt`, `approvers`). Байгууллагад PENDING хүсэлт байвал CA түүнийг буцаана (шинэ push үгүй).
1058
+ - `getCertificateRequest(org, requestId)` — `GET /seal/certificate/{orgEtsi}/requests/{requestId}`: `status` = `PENDING` |
1059
+ `APPROVED` (олгогдож байна) | `ISSUED` (`certificate` бөглөгдсөн) | `REJECTED` | `EXPIRED` | `FAILED` (`failure`:
1060
+ `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED`). Нэг удаагийн шалгалт (өөрийн UI poll).
1061
+ - `waitForCertificate(org, requestId, { timeoutMs = 15 мин, intervalMs = 3 с, signal })` — ISSUED болтол асууж гэрчилгээг
1062
+ буцаана; REJECTED / EXPIRED / FAILED / хугацаа дууссан → `SealCertificateRequestError` (`outcome`, `requestId`,
1063
+ `failure`). 429/503 + Retry-After (`ApiError.retryable`) — Retry-After-ийг хүлээгээд үргэлжилнэ; `signal` тасрахад
1064
+ `signal.reason`.
1065
+ - Алдаа: **409 `SEAL_APPROVER_UNAVAILABLE`** → `SealApproverUnavailableError`; 409 (code-гүй) — байгууллага ACTIVE биш;
1066
+ **404 `SEAL_REQUEST_NOT_FOUND`** → `SealRequestNotFoundError` (өөр байгууллагын id ч мөн); 403 → `ForbiddenError`
1067
+ (`SEAL:<orgEtsi>` эрхгүй); **429 `RATE_LIMITED`** → `ApiError` (`retryAfterMs`) — байгууллагад цагт 5 хүсэлт (PIN2 push
1068
+ спамаас хамгаална). Хүсэлтийн төлөвийн poll тооцоонд орохгүй.
1069
+
1001
1070
  ## 4. QR ба ижил төхөөрөмж — device link v3
1002
1071
 
1003
1072
  Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
@@ -1,4 +1,4 @@
1
- import './errors-CgJcEjrZ.cjs';
1
+ import './errors-BN0Fp3qd.cjs';
2
2
 
3
3
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
4
4
  interface NavigatorLike {
@@ -1,4 +1,4 @@
1
- import './errors-CgJcEjrZ.js';
1
+ import './errors-BN0Fp3qd.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-BRCGPiTf.cjs';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-BN0Fp3qd.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-BaDpcNNs.js';
2
+ export { D as DeviceLinkError, E as EidError } from './errors-BN0Fp3qd.js';
package/dist/browser.js CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  DeviceLinkError,
6
6
  EidError
7
- } from "./chunk-PWFTN52X.js";
7
+ } from "./chunk-GBG7CMO7.js";
8
8
  export {
9
9
  DeviceLinkError,
10
10
  EidError,
@@ -68,6 +68,21 @@ 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 SealCertificateRequestError = class extends EidError {
76
+ constructor(outcome, requestId, failure) {
77
+ 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})` : ""}`);
78
+ this.outcome = outcome;
79
+ this.requestId = requestId;
80
+ this.failure = failure;
81
+ }
82
+ outcome;
83
+ requestId;
84
+ failure;
85
+ };
71
86
  var RETRYABLE_ERROR_CODES = [
72
87
  "RATE_LIMITED",
73
88
  "STATE_UNAVAILABLE",
@@ -135,7 +150,7 @@ var ResponseTooLargeError = class extends EidError {
135
150
  limit;
136
151
  };
137
152
  function maskPath(path) {
138
- return path.split(/[?#]/)[0].replace(/\/(etsi|document|linked)\/[^/?#\s]+/g, "/$1/\u2026");
153
+ return path.split(/[?#]/)[0].replace(/\/(etsi|document|linked|seal(?:\/certificate)?)\/[^/?#\s]+/g, "/$1/\u2026");
139
154
  }
140
155
  var SessionFailedError = class extends EidError {
141
156
  constructor(endResult) {
@@ -160,6 +175,9 @@ export {
160
175
  CertChoiceInvalidError,
161
176
  RequestInvalidError,
162
177
  QrTokenInvalidError,
178
+ SealApproverUnavailableError,
179
+ SealRequestNotFoundError,
180
+ SealCertificateRequestError,
163
181
  RETRYABLE_ERROR_CODES,
164
182
  parseRetryAfter,
165
183
  ON_BEHALF_ERROR_CODES,
@@ -87,6 +87,34 @@ 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
+ /** Тамганы гэрчилгээний хүсэлтийн төгсгөлийн (ISSUED биш) төлөв, эсвэл `waitForCertificate`-ийн хугацаа дууссан. */
103
+ type SealRequestOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "TIMEOUT";
104
+ /**
105
+ * `eid.seal.waitForCertificate` — хүсэлт гэрчилгээгүй дууссан: `REJECTED` (ADMIN татгалзсан), `EXPIRED` (батлах хугацаа
106
+ * дууссан), `FAILED` (`failure`: `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` г.м.) — бүгд шинэ хүсэлт (`requestCertificate`)
107
+ * шаардана; `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт серверт PENDING хэвээр (ижил `requestId`-аар дахин хүлээж болно).
108
+ */
109
+ declare class SealCertificateRequestError extends EidError {
110
+ readonly outcome: SealRequestOutcome;
111
+ readonly requestId: string;
112
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
113
+ readonly failure?: string | undefined;
114
+ constructor(outcome: SealRequestOutcome, requestId: string,
115
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
116
+ failure?: string | undefined);
117
+ }
90
118
  /**
91
119
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
92
120
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -170,4 +198,4 @@ declare class AppTransactionTooLargeError extends EidError {
170
198
  declare class DeviceLinkError extends EidError {
171
199
  }
172
200
 
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 };
201
+ 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, SessionFailedError as l, parseRetryAfter as p };
@@ -87,6 +87,34 @@ 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
+ /** Тамганы гэрчилгээний хүсэлтийн төгсгөлийн (ISSUED биш) төлөв, эсвэл `waitForCertificate`-ийн хугацаа дууссан. */
103
+ type SealRequestOutcome = "REJECTED" | "EXPIRED" | "FAILED" | "TIMEOUT";
104
+ /**
105
+ * `eid.seal.waitForCertificate` — хүсэлт гэрчилгээгүй дууссан: `REJECTED` (ADMIN татгалзсан), `EXPIRED` (батлах хугацаа
106
+ * дууссан), `FAILED` (`failure`: `SEAL_ISSUANCE_FAILED` | `PUSH_FAILED` г.м.) — бүгд шинэ хүсэлт (`requestCertificate`)
107
+ * шаардана; `TIMEOUT` — `timeoutMs` дууссан ч хүсэлт серверт PENDING хэвээр (ижил `requestId`-аар дахин хүлээж болно).
108
+ */
109
+ declare class SealCertificateRequestError extends EidError {
110
+ readonly outcome: SealRequestOutcome;
111
+ readonly requestId: string;
112
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
113
+ readonly failure?: string | undefined;
114
+ constructor(outcome: SealRequestOutcome, requestId: string,
115
+ /** Серверийн `failure` код (FAILED/EXPIRED үед), байхгүй бол undefined. */
116
+ failure?: string | undefined);
117
+ }
90
118
  /**
91
119
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
92
120
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -170,4 +198,4 @@ declare class AppTransactionTooLargeError extends EidError {
170
198
  declare class DeviceLinkError extends EidError {
171
199
  }
172
200
 
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 };
201
+ 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, SessionFailedError as l, parseRetryAfter as p };