@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 +77 -3
- package/dist/{browser-Cbph4U6r.d.cts → browser-BauJmOqC.d.cts} +1 -1
- package/dist/{browser-aa_Judox.d.ts → browser-DxOBHC54.d.ts} +1 -1
- package/dist/browser.d.cts +2 -2
- package/dist/browser.d.ts +2 -2
- package/dist/browser.js +1 -1
- package/dist/{chunk-A6FYBPRV.js → chunk-PM2B6WB5.js} +40 -0
- package/dist/{errors-CgJcEjrZ.d.ts → errors-Dg6wBO_8.d.cts} +46 -1
- package/dist/{errors-CgJcEjrZ.d.cts → errors-Dg6wBO_8.d.ts} +46 -1
- package/dist/index.cjs +162 -19
- package/dist/index.d.cts +77 -7
- package/dist/index.d.ts +77 -7
- package/dist/index.js +125 -20
- package/dist/pades.d.cts +3 -2
- package/dist/pades.d.ts +3 -2
- package/dist/pades.js +1 -1
- package/dist/validate.d.cts +1 -1
- package/dist/validate.d.ts +1 -1
- package/dist/validate.js +1 -1
- package/package.json +1 -1
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
|
-
|
|
1031
|
-
|
|
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
|
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
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-
|
|
2
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
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
|
@@ -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,
|
|
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,
|
|
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
|
-
/**
|
|
2112
|
+
/**
|
|
2113
|
+
* `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
|
|
2114
|
+
* (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
|
|
2115
|
+
*/
|
|
2017
2116
|
async getCertificate(orgEtsi) {
|
|
2018
|
-
|
|
2019
|
-
|
|
2020
|
-
|
|
2021
|
-
|
|
2022
|
-
|
|
2023
|
-
|
|
2024
|
-
|
|
2025
|
-
|
|
2026
|
-
|
|
2027
|
-
|
|
2028
|
-
|
|
2029
|
-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
-
/**
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
-
/**
|
|
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-
|
|
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
|
-
/**
|
|
1818
|
+
/**
|
|
1819
|
+
* `GET /seal/certificate/{orgEtsi}` — байгууллагын одоогийн (хамгийн сүүлд олгогдсон, идэвхтэй) тамганы гэрчилгээ
|
|
1820
|
+
* (PAdES-ийн signerCert). Шинээр олгохгүй — олголт {@link requestCertificate}. Идэвхтэй cert алга / цуцлагдсан бол 409.
|
|
1821
|
+
*/
|
|
1761
1822
|
async getCertificate(orgEtsi) {
|
|
1762
|
-
|
|
1763
|
-
|
|
1764
|
-
|
|
1765
|
-
|
|
1766
|
-
|
|
1767
|
-
|
|
1768
|
-
|
|
1769
|
-
|
|
1770
|
-
|
|
1771
|
-
|
|
1772
|
-
|
|
1773
|
-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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
package/dist/validate.d.cts
CHANGED
package/dist/validate.d.ts
CHANGED
package/dist/validate.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gerege-systems/eid-mongolia-sdk",
|
|
3
|
-
"version": "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",
|