@gerege-systems/eid-mongolia-sdk 0.17.0 → 0.18.1
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 +58 -0
- package/dist/{browser-BPhROZkH.d.ts → browser-CcQqyw_e.d.ts} +5 -1
- package/dist/{browser-DFnRVCfN.d.cts → browser-DDt-m7-E.d.cts} +5 -1
- package/dist/browser.d.cts +1 -1
- package/dist/browser.d.ts +1 -1
- package/dist/index.cjs +160 -2
- package/dist/index.d.cts +163 -5
- package/dist/index.d.ts +163 -5
- package/dist/index.js +155 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -434,6 +434,10 @@ Session-ий `onBehalfOf` блок (`role`/`roleLabel`/`rightType`/`rightTypeLab
|
|
|
434
434
|
`eid.person.certificates(etsi)` · `devices` · `activity(etsi, { flow, limit, offset })` · `summary` · `children` — иргэн
|
|
435
435
|
сүүлийн 24 цагт танай RP-ээр нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Хариу бүрт `raw`.
|
|
436
436
|
|
|
437
|
+
Гэрчилгээ бүрт (0.18.0-аас) `issuedAt` (олгосон), `revokedAt?` (цуцалсан — REVOKED), `revocationReason?` (RFC 5280
|
|
438
|
+
нэр: `keyCompromise`, `superseded`, `cessationOfOperation` …). `status` өөрчлөгдөхгүй: сунгалт/дахин бүртгэлээр
|
|
439
|
+
солигдсон мөр `SUSPENDED` + `revocationReason: "superseded"`, `revokedAt`-гүй.
|
|
440
|
+
|
|
437
441
|
## 3c. USB токен
|
|
438
442
|
|
|
439
443
|
```ts
|
|
@@ -445,6 +449,7 @@ const st = await eid.token.issueCertificate({ signerEtsi, csrAuth, csrSign, toke
|
|
|
445
449
|
const res = await eid.token.certificateResult(st.sessionId);
|
|
446
450
|
verifyTokenCertificates(res, csrAuth, csrSign); // гэрчилгээ бүр CSR-ийн түлхүүртэй
|
|
447
451
|
// 409 TOKEN_LIMIT_REACHED → tokenLimitOf(err): { kind, limit, organization? }
|
|
452
|
+
// 409 TOKEN_IN_USE — serial өөр иргэнд; 409 TOKEN_SCOPE_CHANGE — сунгалт scope солих гэсэн (доор)
|
|
448
453
|
|
|
449
454
|
// токеноор нэвтрэх (AUTH эрх)
|
|
450
455
|
const ch = await eid.token.authChallenge();
|
|
@@ -454,6 +459,13 @@ const who = await eid.token.authVerify(ch.challengeId, authCertDer, rs);
|
|
|
454
459
|
// токеноор PDF: §3d — prepare() → токен CKM_ECDSA(dtbs) → r||s → complete() → registerSignature() (sessionID-гүй, medium "token")
|
|
455
460
|
```
|
|
456
461
|
|
|
462
|
+
**Сунгалт scope-ийг хадгална** (CA 2026-10-16, discovery `tokenCertificate.scopeLockedOnRenewal: true` —
|
|
463
|
+
`eid.token.certificateInfo()`): ижил `tokenSerial` дээр иргэний ACTIVE бүртгэл байвал олголт = сунгалт; байгууллагын
|
|
464
|
+
токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол `POST` (эсвэл
|
|
465
|
+
батлалтын дараа `certificateResult`) 409 `TOKEN_SCOPE_CHANGE`, session-ий `tokenCertificate.errorCode` мөн ийм — override
|
|
466
|
+
байхгүй. Scope солих = иргэн eID апп-аас токеноо цуцлаад (`/v3/mobile/tokens/{tokenSerial}/revoke`) шинээр олгуулна;
|
|
467
|
+
хэрэглэгчид: «Токены төрлийг (хувийн/байгууллага) солихын тулд eID апп-аас токеныг цуцлаад шинээр олгуулна уу».
|
|
468
|
+
|
|
457
469
|
`/token/auth/*` нь `/.well-known/eid`-ийн `endpoints.token.auth_challenge` / `auth_verify`-д жагсаагдсан (AUTH эрх) —
|
|
458
470
|
гэрээний тест бусад route-ийн адил шалгана.
|
|
459
471
|
|
|
@@ -636,6 +648,51 @@ Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуу
|
|
|
636
648
|
ажиллуулахад татахгүй, цуцлалт, COEP-гүй хуудас. Мобайл хөтөчид 250 MB WASM санах ой их шаардана — сул утсанд унаж
|
|
637
649
|
болзошгүй.
|
|
638
650
|
|
|
651
|
+
## 3f. Гарын үсэгтэй файлыг имэйлээр — `eid.share()` (`SIGN` эрх)
|
|
652
|
+
|
|
653
|
+
Гарын үсэг зурсан PDF-ээ дараагийн гарын үсэг зурагч / хүлээн авагч руу хавсралтаар илгээнэ (`POST /share`). CA файлыг
|
|
654
|
+
**хадгалахгүй**: eID-ийн хүчинтэй гарын үсэгтэй эсэхийг шалгаад илгээж, хаяна. Хүлээн авагч бүрт тусдаа имэйл.
|
|
655
|
+
|
|
656
|
+
> CA-ийн туг одоогоор **унтраалттай** (`share.enabled=false` → 503 `SHARE_DISABLED`). Дуудахын өмнө
|
|
657
|
+
> `await eid.shareInfo()`-ийн `enabled`-ийг шалга.
|
|
658
|
+
|
|
659
|
+
```ts
|
|
660
|
+
import { ShareError } from "@gerege-systems/eid-mongolia-sdk";
|
|
661
|
+
|
|
662
|
+
const info = await eid.shareInfo(); // { enabled, maxFileBytes, maxRecipients, quota: { perRPHour, perRPDay, perRecipientDay }, … }
|
|
663
|
+
if (info.enabled) {
|
|
664
|
+
try {
|
|
665
|
+
const r = await eid.share({
|
|
666
|
+
file: signedPdf, // Uint8Array | ArrayBuffer | Blob/File; ≤ 3 080 192 байт
|
|
667
|
+
filename: "гэрээ.pdf", // .pdf өргөтгөлтэй; анхдагч File-ийн нэр эсвэл document.pdf
|
|
668
|
+
to: ["next@example.mn"], // 1–5, давхардалгүй
|
|
669
|
+
subject: "Гэрээ — гарын үсэг", // ≤ 150; CA «‹RP нэр›: …» угтвар тавина
|
|
670
|
+
message: "Хоёр дахь гарын үсгийг зурна уу", // ≤ 1000
|
|
671
|
+
lang: "mn", // mn | en
|
|
672
|
+
});
|
|
673
|
+
console.log(r.sent, r.sha256, r.signatures, r.docID); // docID — CA-д бүртгэлтэй бол (имэйлд verify холбоос)
|
|
674
|
+
} catch (e) {
|
|
675
|
+
if (e instanceof ShareError) {
|
|
676
|
+
// e.code: ShareErrorCode; 422 → e.reason; 502 → e.sent / e.failed / e.recipients ("sent" | "failed", to-гийн дарааллаар)
|
|
677
|
+
}
|
|
678
|
+
throw e;
|
|
679
|
+
}
|
|
680
|
+
}
|
|
681
|
+
```
|
|
682
|
+
|
|
683
|
+
| HTTP | `ShareError.code` | Тайлбар |
|
|
684
|
+
|---|---|---|
|
|
685
|
+
| 400 | `REQUEST_INVALID`, `FILE_EMPTY`, `RECIPIENT_REQUIRED`, `TOO_MANY_RECIPIENTS`, `RECIPIENT_INVALID`, `RECIPIENT_DUPLICATE` | талбарын алдаа |
|
|
686
|
+
| 413 | `FILE_TOO_LARGE` | файл / имэйл хязгаараас их |
|
|
687
|
+
| 415 | `FILE_TYPE_NOT_SUPPORTED` | PDF биш (өргөтгөл, Content-Type, `%PDF-` гурвуулаа таарна) |
|
|
688
|
+
| 422 | `FILE_NOT_SIGNED` | `.reason`: `no_signature` \| `invalid` \| `untrusted` |
|
|
689
|
+
| 429 | `RATE_LIMITED` | квот; `.retryAfterMs`, `.retryable` |
|
|
690
|
+
| 502 | `MAIL_FAILED` | `.sent`, `.failed`, `.recipients` — зөвхөн `failed`-ийг дахин илгээ |
|
|
691
|
+
| 503 | `SHARE_DISABLED`, `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` | туг / тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
|
|
692
|
+
|
|
693
|
+
401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт 30 / өдөрт 200 хүсэлт,
|
|
694
|
+
хүлээн авагч тутам өдөрт 10 имэйл (бодит утгыг `shareInfo().quota`-аас). Хугацаа анхдагч 150 с (`timeoutMs`).
|
|
695
|
+
|
|
639
696
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
640
697
|
|
|
641
698
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
|
@@ -766,6 +823,7 @@ OK ирж болзошгүй. Иймд `ResponseValidator`:
|
|
|
766
823
|
| `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start); `ApiError`-ийн дэд анги |
|
|
767
824
|
| `CertChoiceInvalidError` | 409 `CERT_CHOICE_INVALID` — linked sign-ийн certificate-choice хүчингүй; `ApiError`-ийн дэд анги |
|
|
768
825
|
| `RequestInvalidError` | 400 `REQUEST_INVALID` — хүсэлт буруу (ж: `linkedSessionID` дутуу); `ApiError`-ийн дэд анги |
|
|
826
|
+
| `ShareError` | `share()`-ийн 4xx/5xx (401/403-аас бусад) — `.code` (`ShareErrorCode`), `.reason` (422), `.sent`/`.failed`/`.recipients` (502); `ApiError`-ийн дэд анги |
|
|
769
827
|
| `ApiError` | бусад HTTP алдаа (`.status`, `.body`, серверийн `.code`, `.retryAfterMs`, `.headers`, `.retryable` — ж: 404 `ORG_NOT_FOUND`) |
|
|
770
828
|
| `ResponseTooLargeError` | хариу SDK-ийн хязгаараас их (JSON 4 MiB) — `.op`, `.limit` |
|
|
771
829
|
| `NetworkError` | timeout/сүлжээ (`.op` — таних тэмдэггүй зам, `.timeout`) |
|
|
@@ -232,7 +232,11 @@ type TokenCertStatus = "PENDING" | "ISSUED" | "FAILED" | "EXPIRED";
|
|
|
232
232
|
/** GET /session/{id}-ийн `tokenCertificate` (TOKEN_CERT §Төлөв). */
|
|
233
233
|
interface TokenCertSessionBlock {
|
|
234
234
|
status: TokenCertStatus | string;
|
|
235
|
-
/**
|
|
235
|
+
/**
|
|
236
|
+
* FAILED үед: endResult (USER_REFUSED, TIMEOUT …) эсвэл CSR_DIGEST_MISMATCH, SIGNER_CERT_CHANGED, SIGNATURE_INVALID,
|
|
237
|
+
* SESSION_MISMATCH, REPRESENTATION_REVOKED, KYC_INCOMPLETE, TOKEN_LIMIT_REACHED, TOKEN_IN_USE, TOKEN_SCOPE_CHANGE,
|
|
238
|
+
* ISSUANCE_FAILED, REGISTRY_FAILED.
|
|
239
|
+
*/
|
|
236
240
|
errorCode?: string;
|
|
237
241
|
authSerialHex?: string;
|
|
238
242
|
signSerialHex?: string;
|
|
@@ -232,7 +232,11 @@ type TokenCertStatus = "PENDING" | "ISSUED" | "FAILED" | "EXPIRED";
|
|
|
232
232
|
/** GET /session/{id}-ийн `tokenCertificate` (TOKEN_CERT §Төлөв). */
|
|
233
233
|
interface TokenCertSessionBlock {
|
|
234
234
|
status: TokenCertStatus | string;
|
|
235
|
-
/**
|
|
235
|
+
/**
|
|
236
|
+
* FAILED үед: endResult (USER_REFUSED, TIMEOUT …) эсвэл CSR_DIGEST_MISMATCH, SIGNER_CERT_CHANGED, SIGNATURE_INVALID,
|
|
237
|
+
* SESSION_MISMATCH, REPRESENTATION_REVOKED, KYC_INCOMPLETE, TOKEN_LIMIT_REACHED, TOKEN_IN_USE, TOKEN_SCOPE_CHANGE,
|
|
238
|
+
* ISSUANCE_FAILED, REGISTRY_FAILED.
|
|
239
|
+
*/
|
|
236
240
|
errorCode?: string;
|
|
237
241
|
authSerialHex?: string;
|
|
238
242
|
signSerialHex?: string;
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-DDt-m7-E.cjs';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-pK1L0s4N.cjs';
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-CcQqyw_e.js';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-pK1L0s4N.js';
|
package/dist/index.cjs
CHANGED
|
@@ -26,6 +26,7 @@ __export(index_exports, {
|
|
|
26
26
|
CITIZEN_ISSUING_CA_SKI: () => CITIZEN_ISSUING_CA_SKI,
|
|
27
27
|
CertChoiceInvalidError: () => CertChoiceInvalidError,
|
|
28
28
|
DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
|
|
29
|
+
DEFAULT_SHARE_TIMEOUT_MS: () => DEFAULT_SHARE_TIMEOUT_MS,
|
|
29
30
|
DEFAULT_SIGN_SESSION_TTL_MS: () => DEFAULT_SIGN_SESSION_TTL_MS,
|
|
30
31
|
DeviceLinkError: () => DeviceLinkError,
|
|
31
32
|
EidClient: () => EidClient,
|
|
@@ -42,9 +43,13 @@ __export(index_exports, {
|
|
|
42
43
|
RequestInvalidError: () => RequestInvalidError,
|
|
43
44
|
ResponseTooLargeError: () => ResponseTooLargeError,
|
|
44
45
|
ResponseValidator: () => ResponseValidator,
|
|
46
|
+
SHARE_ERROR_CODES: () => SHARE_ERROR_CODES,
|
|
47
|
+
SHARE_FORM_FIELDS: () => SHARE_FORM_FIELDS,
|
|
45
48
|
SessionApi: () => SessionApi,
|
|
46
49
|
SessionFailedError: () => SessionFailedError,
|
|
50
|
+
ShareError: () => ShareError,
|
|
47
51
|
SignApi: () => SignApi,
|
|
52
|
+
TOKEN_CONFLICT_CODES: () => TOKEN_CONFLICT_CODES,
|
|
48
53
|
TokenApi: () => TokenApi,
|
|
49
54
|
ValidationError: () => ValidationError,
|
|
50
55
|
acspV2Digest: () => acspV2Digest,
|
|
@@ -226,6 +231,10 @@ var Http = class {
|
|
|
226
231
|
const text = new TextDecoder().decode(await readLimited(res, MAX_JSON_BYTES, op));
|
|
227
232
|
return { status: res.status, body: text ? JSON.parse(text) : {} };
|
|
228
233
|
}
|
|
234
|
+
/** multipart/form-data POST (`/share`); Content-Type-ийг (boundary) fetch тавина. */
|
|
235
|
+
postForm(path, form, timeoutMs) {
|
|
236
|
+
return this.json("POST", path, form, void 0, timeoutMs);
|
|
237
|
+
}
|
|
229
238
|
get(path, timeoutMs) {
|
|
230
239
|
return this.json("GET", path, void 0, void 0, timeoutMs);
|
|
231
240
|
}
|
|
@@ -344,7 +353,8 @@ var RP_ROUTES = {
|
|
|
344
353
|
tokenCertificateResult: { method: "GET", path: "/token/certificate/{sessionID}" },
|
|
345
354
|
pdfSignatures: { method: "POST", path: "/pdf/signatures" },
|
|
346
355
|
tokenAuthChallenge: { method: "POST", path: "/token/auth/challenge" },
|
|
347
|
-
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" }
|
|
356
|
+
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" },
|
|
357
|
+
share: { method: "POST", path: "/share" }
|
|
348
358
|
};
|
|
349
359
|
var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
350
360
|
"docID",
|
|
@@ -362,6 +372,7 @@ var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
|
362
372
|
"onBehalfOf",
|
|
363
373
|
"signerEtsi"
|
|
364
374
|
];
|
|
375
|
+
var SHARE_FORM_FIELDS = ["file", "filename", "to", "subject", "message", "lang"];
|
|
365
376
|
function routePath(route, ...args) {
|
|
366
377
|
let i = 0;
|
|
367
378
|
const out = route.path.replace(/\{[^}]*\}/g, () => {
|
|
@@ -1214,6 +1225,8 @@ function hexSha256Equal(hex, data) {
|
|
|
1214
1225
|
if (typeof hex !== "string" || !/^[0-9a-fA-F]{64}$/.test(hex)) return false;
|
|
1215
1226
|
return (0, import_node_crypto3.timingSafeEqual)((0, import_node_crypto3.createHash)("sha256").update(data).digest(), Buffer.from(hex, "hex"));
|
|
1216
1227
|
}
|
|
1228
|
+
var TOKEN_CONFLICT_CODES = ["TOKEN_LIMIT_REACHED", "TOKEN_IN_USE", "TOKEN_SCOPE_CHANGE"];
|
|
1229
|
+
var DISCOVERY_PATH = "/.well-known/eid";
|
|
1217
1230
|
var TOKEN_RESULT_TIMEOUT_MS = 3e4;
|
|
1218
1231
|
var TokenApi = class {
|
|
1219
1232
|
constructor(http, creds) {
|
|
@@ -1225,6 +1238,11 @@ var TokenApi = class {
|
|
|
1225
1238
|
/**
|
|
1226
1239
|
* POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
|
|
1227
1240
|
* CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
|
|
1241
|
+
*
|
|
1242
|
+
* Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
|
|
1243
|
+
* байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
|
|
1244
|
+
* 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
|
|
1245
|
+
* Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
|
|
1228
1246
|
*/
|
|
1229
1247
|
async issueCertificate(input) {
|
|
1230
1248
|
if (!input.signerEtsi?.trim() || !input.csrAuth?.length || !input.csrSign?.length || !input.tokenSerial?.trim()) {
|
|
@@ -1254,9 +1272,26 @@ var TokenApi = class {
|
|
|
1254
1272
|
...typeof r.expiresAt === "string" ? { expiresAt: r.expiresAt } : {}
|
|
1255
1273
|
};
|
|
1256
1274
|
}
|
|
1275
|
+
/** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
|
|
1276
|
+
async certificateInfo() {
|
|
1277
|
+
const d = rec4(await this.http.get(DISCOVERY_PATH));
|
|
1278
|
+
const t = rec4(d.tokenCertificate);
|
|
1279
|
+
return {
|
|
1280
|
+
enabled: t.enabled === true,
|
|
1281
|
+
issue: String(t.issue ?? ""),
|
|
1282
|
+
result: String(t.result ?? ""),
|
|
1283
|
+
permission: String(t.permission ?? ""),
|
|
1284
|
+
certificateLevel: String(t.certificateLevel ?? ""),
|
|
1285
|
+
keyAlgorithm: String(t.keyAlgorithm ?? ""),
|
|
1286
|
+
onBehalfOf: String(t.onBehalfOf ?? ""),
|
|
1287
|
+
scopeLockedOnRenewal: t.scopeLockedOnRenewal === true,
|
|
1288
|
+
raw: d.tokenCertificate
|
|
1289
|
+
};
|
|
1290
|
+
}
|
|
1257
1291
|
/**
|
|
1258
1292
|
* GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
|
|
1259
|
-
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга.
|
|
1293
|
+
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
|
|
1294
|
+
* 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
|
|
1260
1295
|
*/
|
|
1261
1296
|
async certificateResult(sessionId) {
|
|
1262
1297
|
const raw = await this.http.get(routePath(RP_ROUTES.tokenCertificateResult, sessionId), TOKEN_RESULT_TIMEOUT_MS);
|
|
@@ -1378,6 +1413,109 @@ function tokenLimitOf(err) {
|
|
|
1378
1413
|
return void 0;
|
|
1379
1414
|
}
|
|
1380
1415
|
|
|
1416
|
+
// src/share.ts
|
|
1417
|
+
var DEFAULT_SHARE_TIMEOUT_MS = 15e4;
|
|
1418
|
+
var SHARE_ERROR_CODES = [
|
|
1419
|
+
"REQUEST_INVALID",
|
|
1420
|
+
"FILE_EMPTY",
|
|
1421
|
+
"RECIPIENT_REQUIRED",
|
|
1422
|
+
"TOO_MANY_RECIPIENTS",
|
|
1423
|
+
"RECIPIENT_INVALID",
|
|
1424
|
+
"RECIPIENT_DUPLICATE",
|
|
1425
|
+
"FILE_TOO_LARGE",
|
|
1426
|
+
"FILE_TYPE_NOT_SUPPORTED",
|
|
1427
|
+
"FILE_NOT_SIGNED",
|
|
1428
|
+
"RATE_LIMITED",
|
|
1429
|
+
"MAIL_FAILED",
|
|
1430
|
+
"SHARE_DISABLED",
|
|
1431
|
+
"MAIL_UNAVAILABLE",
|
|
1432
|
+
"VALIDATOR_UNAVAILABLE",
|
|
1433
|
+
"VALIDATOR_BUSY"
|
|
1434
|
+
];
|
|
1435
|
+
var ShareError = class extends ApiError {
|
|
1436
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
1437
|
+
reason;
|
|
1438
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
1439
|
+
sent;
|
|
1440
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
1441
|
+
failed;
|
|
1442
|
+
/**
|
|
1443
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
1444
|
+
* бүү илгээ).
|
|
1445
|
+
*/
|
|
1446
|
+
recipients;
|
|
1447
|
+
constructor(status, body, code, init) {
|
|
1448
|
+
super(status, body, code, init);
|
|
1449
|
+
const o = parseObject(body);
|
|
1450
|
+
if (typeof o.reason === "string") this.reason = o.reason;
|
|
1451
|
+
if (typeof o.sent === "number") this.sent = o.sent;
|
|
1452
|
+
if (typeof o.failed === "number") this.failed = o.failed;
|
|
1453
|
+
if (Array.isArray(o.recipients)) this.recipients = o.recipients.map(String);
|
|
1454
|
+
}
|
|
1455
|
+
};
|
|
1456
|
+
var DISCOVERY_PATH2 = "/.well-known/eid";
|
|
1457
|
+
function parseObject(text) {
|
|
1458
|
+
try {
|
|
1459
|
+
const v = JSON.parse(text);
|
|
1460
|
+
return v && typeof v === "object" ? v : {};
|
|
1461
|
+
} catch {
|
|
1462
|
+
return {};
|
|
1463
|
+
}
|
|
1464
|
+
}
|
|
1465
|
+
async function shareFile(http, input) {
|
|
1466
|
+
const to = typeof input.to === "string" ? [input.to] : [...input.to];
|
|
1467
|
+
const blob = input.file instanceof Blob ? input.file : new Blob([new Uint8Array(input.file)], { type: "application/pdf" });
|
|
1468
|
+
const filename = input.filename ?? input.file.name ?? "document.pdf";
|
|
1469
|
+
const form = new FormData();
|
|
1470
|
+
for (const a of to) form.append("to", a);
|
|
1471
|
+
if (input.subject !== void 0) form.append("subject", input.subject);
|
|
1472
|
+
if (input.message !== void 0) form.append("message", input.message);
|
|
1473
|
+
if (input.lang !== void 0) form.append("lang", input.lang);
|
|
1474
|
+
if (input.filename !== void 0) form.append("filename", input.filename);
|
|
1475
|
+
form.append("file", blob.type ? blob : new Blob([blob], { type: "application/pdf" }), filename || "document.pdf");
|
|
1476
|
+
let raw;
|
|
1477
|
+
try {
|
|
1478
|
+
raw = await http.postForm(RP_ROUTES.share.path, form, input.timeoutMs ?? DEFAULT_SHARE_TIMEOUT_MS);
|
|
1479
|
+
} catch (e) {
|
|
1480
|
+
if (e instanceof ApiError && !(e instanceof ShareError)) {
|
|
1481
|
+
throw new ShareError(e.status, e.body, e.code, { headers: e.headers, retryAfterMs: e.retryAfterMs });
|
|
1482
|
+
}
|
|
1483
|
+
throw e;
|
|
1484
|
+
}
|
|
1485
|
+
const o = raw && typeof raw === "object" ? raw : {};
|
|
1486
|
+
return {
|
|
1487
|
+
sent: Number(o.sent ?? 0),
|
|
1488
|
+
sha256: String(o.sha256 ?? ""),
|
|
1489
|
+
signatures: Number(o.signatures ?? 0),
|
|
1490
|
+
...typeof o.docID === "string" && o.docID ? { docID: o.docID } : {},
|
|
1491
|
+
raw
|
|
1492
|
+
};
|
|
1493
|
+
}
|
|
1494
|
+
async function shareInfo(http) {
|
|
1495
|
+
const d = await http.get(DISCOVERY_PATH2);
|
|
1496
|
+
const s = d.share && typeof d.share === "object" ? d.share : {};
|
|
1497
|
+
const q = s.quota && typeof s.quota === "object" ? s.quota : {};
|
|
1498
|
+
return {
|
|
1499
|
+
enabled: s.enabled === true,
|
|
1500
|
+
endpoint: String(s.endpoint ?? ""),
|
|
1501
|
+
formats: Array.isArray(s.formats) ? s.formats : [],
|
|
1502
|
+
languages: Array.isArray(s.languages) ? s.languages.map(String) : [],
|
|
1503
|
+
maxFileBytes: Number(s.maxFileBytes ?? 0),
|
|
1504
|
+
maxFilenameChars: Number(s.maxFilenameChars ?? 0),
|
|
1505
|
+
maxMessageChars: Number(s.maxMessageChars ?? 0),
|
|
1506
|
+
maxRecipients: Number(s.maxRecipients ?? 0),
|
|
1507
|
+
maxSubjectChars: Number(s.maxSubjectChars ?? 0),
|
|
1508
|
+
permission: String(s.permission ?? ""),
|
|
1509
|
+
quota: {
|
|
1510
|
+
perRPHour: Number(q.perRPHour ?? 0),
|
|
1511
|
+
perRPDay: Number(q.perRPDay ?? 0),
|
|
1512
|
+
perRecipientDay: Number(q.perRecipientDay ?? 0)
|
|
1513
|
+
},
|
|
1514
|
+
requiresValidSignature: s.requiresValidSignature === true,
|
|
1515
|
+
raw: d.share
|
|
1516
|
+
};
|
|
1517
|
+
}
|
|
1518
|
+
|
|
1381
1519
|
// src/validator.ts
|
|
1382
1520
|
var import_node_crypto4 = require("crypto");
|
|
1383
1521
|
var CITIZEN_ISSUING_CA_SKI = "b8a37f2c64ad677912db7d9e34f246358a2fb909";
|
|
@@ -1983,6 +2121,7 @@ var EidClient = class {
|
|
|
1983
2121
|
validator;
|
|
1984
2122
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
1985
2123
|
rpName;
|
|
2124
|
+
http;
|
|
1986
2125
|
constructor(cfg) {
|
|
1987
2126
|
if (!cfg.credentials?.apiSecret) throw new Error("EidClient: credentials.apiSecret \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
|
|
1988
2127
|
const base = resolveBaseUrl(cfg.baseUrl);
|
|
@@ -2003,6 +2142,7 @@ var EidClient = class {
|
|
|
2003
2142
|
this.session = new SessionApi(http);
|
|
2004
2143
|
this.validator = new ResponseValidator(cfg.trust ?? {});
|
|
2005
2144
|
this.rpName = cfg.credentials.rpName;
|
|
2145
|
+
this.http = http;
|
|
2006
2146
|
}
|
|
2007
2147
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
2008
2148
|
signPdfDigest(input) {
|
|
@@ -2012,6 +2152,19 @@ var EidClient = class {
|
|
|
2012
2152
|
registerSignature(input) {
|
|
2013
2153
|
return this.sign.registerSignature(input);
|
|
2014
2154
|
}
|
|
2155
|
+
/**
|
|
2156
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
2157
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
2158
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
2159
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
2160
|
+
*/
|
|
2161
|
+
share(input) {
|
|
2162
|
+
return shareFile(this.http, input);
|
|
2163
|
+
}
|
|
2164
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
2165
|
+
shareInfo() {
|
|
2166
|
+
return shareInfo(this.http);
|
|
2167
|
+
}
|
|
2015
2168
|
};
|
|
2016
2169
|
|
|
2017
2170
|
// src/ocsp.ts
|
|
@@ -3266,6 +3419,7 @@ function createEidLogin(opts) {
|
|
|
3266
3419
|
CITIZEN_ISSUING_CA_SKI,
|
|
3267
3420
|
CertChoiceInvalidError,
|
|
3268
3421
|
DEFAULT_BASE_URL,
|
|
3422
|
+
DEFAULT_SHARE_TIMEOUT_MS,
|
|
3269
3423
|
DEFAULT_SIGN_SESSION_TTL_MS,
|
|
3270
3424
|
DeviceLinkError,
|
|
3271
3425
|
EidClient,
|
|
@@ -3282,9 +3436,13 @@ function createEidLogin(opts) {
|
|
|
3282
3436
|
RequestInvalidError,
|
|
3283
3437
|
ResponseTooLargeError,
|
|
3284
3438
|
ResponseValidator,
|
|
3439
|
+
SHARE_ERROR_CODES,
|
|
3440
|
+
SHARE_FORM_FIELDS,
|
|
3285
3441
|
SessionApi,
|
|
3286
3442
|
SessionFailedError,
|
|
3443
|
+
ShareError,
|
|
3287
3444
|
SignApi,
|
|
3445
|
+
TOKEN_CONFLICT_CODES,
|
|
3288
3446
|
TokenApi,
|
|
3289
3447
|
ValidationError,
|
|
3290
3448
|
acspV2Digest,
|
package/dist/index.d.cts
CHANGED
|
@@ -1,7 +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 SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-
|
|
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-DDt-m7-E.cjs';
|
|
2
|
+
export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-DDt-m7-E.cjs';
|
|
3
|
+
import { A as ApiError, H as HttpErrorInit } from './errors-pK1L0s4N.cjs';
|
|
4
|
+
export { a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, R as RETRYABLE_ERROR_CODES, d as RequestInvalidError, e as ResponseTooLargeError, f as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-pK1L0s4N.cjs';
|
|
3
5
|
import { X509Certificate, KeyObject } from 'node:crypto';
|
|
4
|
-
export { A as ApiError, a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, H as HttpErrorInit, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, R as RETRYABLE_ERROR_CODES, d as RequestInvalidError, e as ResponseTooLargeError, f as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-pK1L0s4N.cjs';
|
|
5
6
|
|
|
6
7
|
interface HttpConfig {
|
|
7
8
|
/** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
|
|
@@ -30,6 +31,8 @@ declare class Http {
|
|
|
30
31
|
status: number;
|
|
31
32
|
body: unknown;
|
|
32
33
|
}>;
|
|
34
|
+
/** multipart/form-data POST (`/share`); Content-Type-ийг (boundary) fetch тавина. */
|
|
35
|
+
postForm(path: string, form: FormData, timeoutMs?: number): Promise<unknown>;
|
|
33
36
|
get(path: string, timeoutMs?: number): Promise<unknown>;
|
|
34
37
|
private json;
|
|
35
38
|
private send;
|
|
@@ -389,6 +392,18 @@ interface PersonCertificate {
|
|
|
389
392
|
notBefore: string;
|
|
390
393
|
notAfter: string;
|
|
391
394
|
issuerDn: string;
|
|
395
|
+
/** Олгосон мөч (RFC 3339). Хуучин CA-д байхгүй. */
|
|
396
|
+
issuedAt?: string;
|
|
397
|
+
/**
|
|
398
|
+
* Цуцалсан мөч (RFC 3339) — REVOKED-д. Сунгалт/дахин бүртгэлээр солигдсон (status SUSPENDED,
|
|
399
|
+
* `revocationReason: "superseded"`) мөрд ихэвчлэн байхгүй.
|
|
400
|
+
*/
|
|
401
|
+
revokedAt?: string;
|
|
402
|
+
/**
|
|
403
|
+
* RFC 5280 CRLReason-ийн нэр: keyCompromise, cACompromise, affiliationChanged, superseded, cessationOfOperation,
|
|
404
|
+
* certificateHold, privilegeWithdrawn г.м. `status` өөрчлөгдөхгүй — солигдсоныг (SUSPENDED) `superseded`-ээр ялга.
|
|
405
|
+
*/
|
|
406
|
+
revocationReason?: string;
|
|
392
407
|
/** base64 DER (нийтийн артефакт). */
|
|
393
408
|
certValue?: string;
|
|
394
409
|
/** TOKEN мөрөнд токенд холбогдсон байгууллага; хувийн токенд алга. */
|
|
@@ -587,6 +602,36 @@ interface TokenLimit {
|
|
|
587
602
|
/** Зөвхөн ORGANIZATION-д (NTRMN-…). */
|
|
588
603
|
organization?: string;
|
|
589
604
|
}
|
|
605
|
+
/**
|
|
606
|
+
* Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
|
|
607
|
+
* - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
|
|
608
|
+
* - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
|
|
609
|
+
* - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
|
|
610
|
+
* байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна.
|
|
611
|
+
*/
|
|
612
|
+
type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE";
|
|
613
|
+
/** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
|
|
614
|
+
declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
|
|
615
|
+
/** Discovery (`/.well-known/eid`)-ийн `tokenCertificate` блок. */
|
|
616
|
+
interface TokenCertInfo {
|
|
617
|
+
enabled: boolean;
|
|
618
|
+
/** `POST` олголтын бүтэн URL. */
|
|
619
|
+
issue: string;
|
|
620
|
+
/** `GET` үр дүнгийн URL template (`{sessionID}`). */
|
|
621
|
+
result: string;
|
|
622
|
+
/** Шаардлагатай RP эрх (TOKEN_ISSUE). */
|
|
623
|
+
permission: string;
|
|
624
|
+
certificateLevel: string;
|
|
625
|
+
keyAlgorithm: string;
|
|
626
|
+
/** `"optional"` — хоосон = хувийн токен. */
|
|
627
|
+
onBehalfOf: string;
|
|
628
|
+
/**
|
|
629
|
+
* true — сунгалт (ижил `tokenSerial` дээр ACTIVE бүртгэлтэй) scope-ийг хадгална; өөр scope бол 409
|
|
630
|
+
* `TOKEN_SCOPE_CHANGE`. Хуучин CA-д талбар алга → false.
|
|
631
|
+
*/
|
|
632
|
+
scopeLockedOnRenewal: boolean;
|
|
633
|
+
raw: unknown;
|
|
634
|
+
}
|
|
590
635
|
declare class TokenApi {
|
|
591
636
|
private readonly http;
|
|
592
637
|
private readonly creds;
|
|
@@ -594,11 +639,19 @@ declare class TokenApi {
|
|
|
594
639
|
/**
|
|
595
640
|
* POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
|
|
596
641
|
* CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
|
|
642
|
+
*
|
|
643
|
+
* Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
|
|
644
|
+
* байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
|
|
645
|
+
* 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
|
|
646
|
+
* Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
|
|
597
647
|
*/
|
|
598
648
|
issueCertificate(input: TokenCertInput): Promise<TokenCertStart>;
|
|
649
|
+
/** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
|
|
650
|
+
certificateInfo(): Promise<TokenCertInfo>;
|
|
599
651
|
/**
|
|
600
652
|
* GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
|
|
601
|
-
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга.
|
|
653
|
+
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
|
|
654
|
+
* 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
|
|
602
655
|
*/
|
|
603
656
|
certificateResult(sessionId: string): Promise<TokenCertResult>;
|
|
604
657
|
/** POST /token/auth/challenge — энэ RP-д холбогдсон нэг удаагийн challenge (2 мин). */
|
|
@@ -627,6 +680,95 @@ declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
|
|
|
627
680
|
*/
|
|
628
681
|
declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
|
|
629
682
|
|
|
683
|
+
/** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
|
|
684
|
+
declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
|
|
685
|
+
/** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
|
|
686
|
+
interface ShareInput {
|
|
687
|
+
/** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
|
|
688
|
+
file: Blob | Uint8Array | ArrayBuffer;
|
|
689
|
+
/**
|
|
690
|
+
* Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
|
|
691
|
+
* нэр, байхгүй бол `document.pdf`.
|
|
692
|
+
*/
|
|
693
|
+
filename?: string;
|
|
694
|
+
/** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
|
|
695
|
+
to: string | readonly string[];
|
|
696
|
+
/** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
|
|
697
|
+
subject?: string;
|
|
698
|
+
/** Илгээгчийн тэмдэглэл (≤ 1000). */
|
|
699
|
+
message?: string;
|
|
700
|
+
/** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
|
|
701
|
+
lang?: "mn" | "en";
|
|
702
|
+
/** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
|
|
703
|
+
timeoutMs?: number;
|
|
704
|
+
}
|
|
705
|
+
/** 200 хариу. */
|
|
706
|
+
interface ShareResult {
|
|
707
|
+
/** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
|
|
708
|
+
sent: number;
|
|
709
|
+
/** Файлын SHA-256 (hex). */
|
|
710
|
+
sha256: string;
|
|
711
|
+
/** Хүчинтэй eID гарын үсгийн тоо. */
|
|
712
|
+
signatures: number;
|
|
713
|
+
/** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
|
|
714
|
+
docID?: string;
|
|
715
|
+
raw: unknown;
|
|
716
|
+
}
|
|
717
|
+
/** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
|
|
718
|
+
type ShareErrorCode = "REQUEST_INVALID" | "FILE_EMPTY" | "RECIPIENT_REQUIRED" | "TOO_MANY_RECIPIENTS" | "RECIPIENT_INVALID" | "RECIPIENT_DUPLICATE" | "FILE_TOO_LARGE" | "FILE_TYPE_NOT_SUPPORTED" | "FILE_NOT_SIGNED" | "RATE_LIMITED" | "MAIL_FAILED" | "SHARE_DISABLED" | "MAIL_UNAVAILABLE" | "VALIDATOR_UNAVAILABLE" | "VALIDATOR_BUSY";
|
|
719
|
+
/** {@link ShareErrorCode}-ийн бүх утга. */
|
|
720
|
+
declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
|
|
721
|
+
/** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
|
|
722
|
+
type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
|
|
723
|
+
/**
|
|
724
|
+
* `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
|
|
725
|
+
* ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
|
|
726
|
+
* (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
|
|
727
|
+
* SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
|
|
728
|
+
* undefined.
|
|
729
|
+
*/
|
|
730
|
+
declare class ShareError extends ApiError {
|
|
731
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
732
|
+
readonly reason?: ShareNotSignedReason | string;
|
|
733
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
734
|
+
readonly sent?: number;
|
|
735
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
736
|
+
readonly failed?: number;
|
|
737
|
+
/**
|
|
738
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
739
|
+
* бүү илгээ).
|
|
740
|
+
*/
|
|
741
|
+
readonly recipients?: readonly string[];
|
|
742
|
+
constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
|
|
743
|
+
}
|
|
744
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок. */
|
|
745
|
+
interface ShareInfo {
|
|
746
|
+
/** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
|
|
747
|
+
enabled: boolean;
|
|
748
|
+
endpoint: string;
|
|
749
|
+
formats: {
|
|
750
|
+
name: string;
|
|
751
|
+
extension: string;
|
|
752
|
+
mime: string;
|
|
753
|
+
}[];
|
|
754
|
+
languages: string[];
|
|
755
|
+
maxFileBytes: number;
|
|
756
|
+
maxFilenameChars: number;
|
|
757
|
+
maxMessageChars: number;
|
|
758
|
+
maxRecipients: number;
|
|
759
|
+
maxSubjectChars: number;
|
|
760
|
+
/** Шаардлагатай RP эрх (SIGN). */
|
|
761
|
+
permission: string;
|
|
762
|
+
/** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
|
|
763
|
+
quota: {
|
|
764
|
+
perRPHour: number;
|
|
765
|
+
perRPDay: number;
|
|
766
|
+
perRecipientDay: number;
|
|
767
|
+
};
|
|
768
|
+
requiresValidSignature: boolean;
|
|
769
|
+
raw: unknown;
|
|
770
|
+
}
|
|
771
|
+
|
|
630
772
|
/** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
|
|
631
773
|
interface CertSubject {
|
|
632
774
|
/** 2.5.4.42 GIVENNAME. */
|
|
@@ -943,11 +1085,21 @@ declare class EidClient {
|
|
|
943
1085
|
readonly validator: ResponseValidator;
|
|
944
1086
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
945
1087
|
readonly rpName: string;
|
|
1088
|
+
private readonly http;
|
|
946
1089
|
constructor(cfg: ClientConfig);
|
|
947
1090
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
948
1091
|
signPdfDigest(input: PdfDigestInput): Promise<PdfDigestSession>;
|
|
949
1092
|
/** {@link SignApi.registerSignature} — `pades.complete()`-ийн CMS-ийг CA-д бүртгэнэ (`POST /pdf/signatures`). */
|
|
950
1093
|
registerSignature(input: RegisterSignatureInput): Promise<RegisterSignatureResult>;
|
|
1094
|
+
/**
|
|
1095
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1096
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1097
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1098
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1099
|
+
*/
|
|
1100
|
+
share(input: ShareInput): Promise<ShareResult>;
|
|
1101
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1102
|
+
shareInfo(): Promise<ShareInfo>;
|
|
951
1103
|
}
|
|
952
1104
|
|
|
953
1105
|
/**
|
|
@@ -956,6 +1108,12 @@ declare class EidClient {
|
|
|
956
1108
|
* `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
|
|
957
1109
|
*/
|
|
958
1110
|
declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
|
|
1111
|
+
/**
|
|
1112
|
+
* `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
|
|
1113
|
+
* 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
|
|
1114
|
+
* тайлбартай гэрээний тест тулгана.
|
|
1115
|
+
*/
|
|
1116
|
+
declare const SHARE_FORM_FIELDS: readonly ["file", "filename", "to", "subject", "message", "lang"];
|
|
959
1117
|
|
|
960
1118
|
interface OcspCheckerOptions {
|
|
961
1119
|
/** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
|
|
@@ -1311,4 +1469,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
|
|
|
1311
1469
|
*/
|
|
1312
1470
|
declare function createEidLogin(opts: EidLoginOptions): EidLogin;
|
|
1313
1471
|
|
|
1314
|
-
export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, Interaction, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
|
|
1472
|
+
export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +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 SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-
|
|
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-CcQqyw_e.js';
|
|
2
|
+
export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionState, g as SignContext, h as SignatureAlgorithmParameters, i as SignatureProtocol, T as TokenCertSessionBlock, j as TokenCertStatus, k as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, l as startExpiry } from './browser-CcQqyw_e.js';
|
|
3
|
+
import { A as ApiError, H as HttpErrorInit } from './errors-pK1L0s4N.js';
|
|
4
|
+
export { a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, R as RETRYABLE_ERROR_CODES, d as RequestInvalidError, e as ResponseTooLargeError, f as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-pK1L0s4N.js';
|
|
3
5
|
import { X509Certificate, KeyObject } from 'node:crypto';
|
|
4
|
-
export { A as ApiError, a as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, E as EidError, F as ForbiddenError, H as HttpErrorInit, N as NetworkError, b as NoSigningCertificateError, O as ON_BEHALF_ERROR_CODES, c as OnBehalfErrorCode, R as RETRYABLE_ERROR_CODES, d as RequestInvalidError, e as ResponseTooLargeError, f as RetryableErrorCode, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-pK1L0s4N.js';
|
|
5
6
|
|
|
6
7
|
interface HttpConfig {
|
|
7
8
|
/** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
|
|
@@ -30,6 +31,8 @@ declare class Http {
|
|
|
30
31
|
status: number;
|
|
31
32
|
body: unknown;
|
|
32
33
|
}>;
|
|
34
|
+
/** multipart/form-data POST (`/share`); Content-Type-ийг (boundary) fetch тавина. */
|
|
35
|
+
postForm(path: string, form: FormData, timeoutMs?: number): Promise<unknown>;
|
|
33
36
|
get(path: string, timeoutMs?: number): Promise<unknown>;
|
|
34
37
|
private json;
|
|
35
38
|
private send;
|
|
@@ -389,6 +392,18 @@ interface PersonCertificate {
|
|
|
389
392
|
notBefore: string;
|
|
390
393
|
notAfter: string;
|
|
391
394
|
issuerDn: string;
|
|
395
|
+
/** Олгосон мөч (RFC 3339). Хуучин CA-д байхгүй. */
|
|
396
|
+
issuedAt?: string;
|
|
397
|
+
/**
|
|
398
|
+
* Цуцалсан мөч (RFC 3339) — REVOKED-д. Сунгалт/дахин бүртгэлээр солигдсон (status SUSPENDED,
|
|
399
|
+
* `revocationReason: "superseded"`) мөрд ихэвчлэн байхгүй.
|
|
400
|
+
*/
|
|
401
|
+
revokedAt?: string;
|
|
402
|
+
/**
|
|
403
|
+
* RFC 5280 CRLReason-ийн нэр: keyCompromise, cACompromise, affiliationChanged, superseded, cessationOfOperation,
|
|
404
|
+
* certificateHold, privilegeWithdrawn г.м. `status` өөрчлөгдөхгүй — солигдсоныг (SUSPENDED) `superseded`-ээр ялга.
|
|
405
|
+
*/
|
|
406
|
+
revocationReason?: string;
|
|
392
407
|
/** base64 DER (нийтийн артефакт). */
|
|
393
408
|
certValue?: string;
|
|
394
409
|
/** TOKEN мөрөнд токенд холбогдсон байгууллага; хувийн токенд алга. */
|
|
@@ -587,6 +602,36 @@ interface TokenLimit {
|
|
|
587
602
|
/** Зөвхөн ORGANIZATION-д (NTRMN-…). */
|
|
588
603
|
organization?: string;
|
|
589
604
|
}
|
|
605
|
+
/**
|
|
606
|
+
* Токены олголтын 409 кодууд (`ApiError.code`; session-ий `tokenCertificate.errorCode`-д ч ирнэ):
|
|
607
|
+
* - `TOKEN_LIMIT_REACHED` — иргэний токены хязгаар хүрсэн ({@link tokenLimitOf});
|
|
608
|
+
* - `TOKEN_IN_USE` — `tokenSerial` өөр иргэнд хүчинтэй гэрчилгээтэй бүртгэлтэй;
|
|
609
|
+
* - `TOKEN_SCOPE_CHANGE` — сунгалт scope-ийг солих гэсэн (хувийн ↔ байгууллага, эсвэл өөр `onBehalfOf`). Override
|
|
610
|
+
* байхгүй: иргэн eID апп-аас токеноо цуцалж (`/v3/mobile/tokens/{tokenSerial}/revoke`) байж шинэ scope-оор олгуулна.
|
|
611
|
+
*/
|
|
612
|
+
type TokenConflictCode = "TOKEN_LIMIT_REACHED" | "TOKEN_IN_USE" | "TOKEN_SCOPE_CHANGE";
|
|
613
|
+
/** {@link TokenConflictCode}-ийн бүх утга (runtime шалгалтад). */
|
|
614
|
+
declare const TOKEN_CONFLICT_CODES: readonly TokenConflictCode[];
|
|
615
|
+
/** Discovery (`/.well-known/eid`)-ийн `tokenCertificate` блок. */
|
|
616
|
+
interface TokenCertInfo {
|
|
617
|
+
enabled: boolean;
|
|
618
|
+
/** `POST` олголтын бүтэн URL. */
|
|
619
|
+
issue: string;
|
|
620
|
+
/** `GET` үр дүнгийн URL template (`{sessionID}`). */
|
|
621
|
+
result: string;
|
|
622
|
+
/** Шаардлагатай RP эрх (TOKEN_ISSUE). */
|
|
623
|
+
permission: string;
|
|
624
|
+
certificateLevel: string;
|
|
625
|
+
keyAlgorithm: string;
|
|
626
|
+
/** `"optional"` — хоосон = хувийн токен. */
|
|
627
|
+
onBehalfOf: string;
|
|
628
|
+
/**
|
|
629
|
+
* true — сунгалт (ижил `tokenSerial` дээр ACTIVE бүртгэлтэй) scope-ийг хадгална; өөр scope бол 409
|
|
630
|
+
* `TOKEN_SCOPE_CHANGE`. Хуучин CA-д талбар алга → false.
|
|
631
|
+
*/
|
|
632
|
+
scopeLockedOnRenewal: boolean;
|
|
633
|
+
raw: unknown;
|
|
634
|
+
}
|
|
590
635
|
declare class TokenApi {
|
|
591
636
|
private readonly http;
|
|
592
637
|
private readonly creds;
|
|
@@ -594,11 +639,19 @@ declare class TokenApi {
|
|
|
594
639
|
/**
|
|
595
640
|
* POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
|
|
596
641
|
* CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
|
|
642
|
+
*
|
|
643
|
+
* Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
|
|
644
|
+
* байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
|
|
645
|
+
* 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
|
|
646
|
+
* Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
|
|
597
647
|
*/
|
|
598
648
|
issueCertificate(input: TokenCertInput): Promise<TokenCertStart>;
|
|
649
|
+
/** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
|
|
650
|
+
certificateInfo(): Promise<TokenCertInfo>;
|
|
599
651
|
/**
|
|
600
652
|
* GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
|
|
601
|
-
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга.
|
|
653
|
+
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
|
|
654
|
+
* 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
|
|
602
655
|
*/
|
|
603
656
|
certificateResult(sessionId: string): Promise<TokenCertResult>;
|
|
604
657
|
/** POST /token/auth/challenge — энэ RP-д холбогдсон нэг удаагийн challenge (2 мин). */
|
|
@@ -627,6 +680,95 @@ declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
|
|
|
627
680
|
*/
|
|
628
681
|
declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
|
|
629
682
|
|
|
683
|
+
/** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
|
|
684
|
+
declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
|
|
685
|
+
/** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
|
|
686
|
+
interface ShareInput {
|
|
687
|
+
/** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
|
|
688
|
+
file: Blob | Uint8Array | ArrayBuffer;
|
|
689
|
+
/**
|
|
690
|
+
* Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
|
|
691
|
+
* нэр, байхгүй бол `document.pdf`.
|
|
692
|
+
*/
|
|
693
|
+
filename?: string;
|
|
694
|
+
/** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
|
|
695
|
+
to: string | readonly string[];
|
|
696
|
+
/** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
|
|
697
|
+
subject?: string;
|
|
698
|
+
/** Илгээгчийн тэмдэглэл (≤ 1000). */
|
|
699
|
+
message?: string;
|
|
700
|
+
/** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
|
|
701
|
+
lang?: "mn" | "en";
|
|
702
|
+
/** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
|
|
703
|
+
timeoutMs?: number;
|
|
704
|
+
}
|
|
705
|
+
/** 200 хариу. */
|
|
706
|
+
interface ShareResult {
|
|
707
|
+
/** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
|
|
708
|
+
sent: number;
|
|
709
|
+
/** Файлын SHA-256 (hex). */
|
|
710
|
+
sha256: string;
|
|
711
|
+
/** Хүчинтэй eID гарын үсгийн тоо. */
|
|
712
|
+
signatures: number;
|
|
713
|
+
/** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
|
|
714
|
+
docID?: string;
|
|
715
|
+
raw: unknown;
|
|
716
|
+
}
|
|
717
|
+
/** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
|
|
718
|
+
type ShareErrorCode = "REQUEST_INVALID" | "FILE_EMPTY" | "RECIPIENT_REQUIRED" | "TOO_MANY_RECIPIENTS" | "RECIPIENT_INVALID" | "RECIPIENT_DUPLICATE" | "FILE_TOO_LARGE" | "FILE_TYPE_NOT_SUPPORTED" | "FILE_NOT_SIGNED" | "RATE_LIMITED" | "MAIL_FAILED" | "SHARE_DISABLED" | "MAIL_UNAVAILABLE" | "VALIDATOR_UNAVAILABLE" | "VALIDATOR_BUSY";
|
|
719
|
+
/** {@link ShareErrorCode}-ийн бүх утга. */
|
|
720
|
+
declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
|
|
721
|
+
/** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
|
|
722
|
+
type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
|
|
723
|
+
/**
|
|
724
|
+
* `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
|
|
725
|
+
* ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
|
|
726
|
+
* (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
|
|
727
|
+
* SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
|
|
728
|
+
* undefined.
|
|
729
|
+
*/
|
|
730
|
+
declare class ShareError extends ApiError {
|
|
731
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
732
|
+
readonly reason?: ShareNotSignedReason | string;
|
|
733
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
734
|
+
readonly sent?: number;
|
|
735
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
736
|
+
readonly failed?: number;
|
|
737
|
+
/**
|
|
738
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
739
|
+
* бүү илгээ).
|
|
740
|
+
*/
|
|
741
|
+
readonly recipients?: readonly string[];
|
|
742
|
+
constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
|
|
743
|
+
}
|
|
744
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок. */
|
|
745
|
+
interface ShareInfo {
|
|
746
|
+
/** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
|
|
747
|
+
enabled: boolean;
|
|
748
|
+
endpoint: string;
|
|
749
|
+
formats: {
|
|
750
|
+
name: string;
|
|
751
|
+
extension: string;
|
|
752
|
+
mime: string;
|
|
753
|
+
}[];
|
|
754
|
+
languages: string[];
|
|
755
|
+
maxFileBytes: number;
|
|
756
|
+
maxFilenameChars: number;
|
|
757
|
+
maxMessageChars: number;
|
|
758
|
+
maxRecipients: number;
|
|
759
|
+
maxSubjectChars: number;
|
|
760
|
+
/** Шаардлагатай RP эрх (SIGN). */
|
|
761
|
+
permission: string;
|
|
762
|
+
/** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
|
|
763
|
+
quota: {
|
|
764
|
+
perRPHour: number;
|
|
765
|
+
perRPDay: number;
|
|
766
|
+
perRecipientDay: number;
|
|
767
|
+
};
|
|
768
|
+
requiresValidSignature: boolean;
|
|
769
|
+
raw: unknown;
|
|
770
|
+
}
|
|
771
|
+
|
|
630
772
|
/** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
|
|
631
773
|
interface CertSubject {
|
|
632
774
|
/** 2.5.4.42 GIVENNAME. */
|
|
@@ -943,11 +1085,21 @@ declare class EidClient {
|
|
|
943
1085
|
readonly validator: ResponseValidator;
|
|
944
1086
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
945
1087
|
readonly rpName: string;
|
|
1088
|
+
private readonly http;
|
|
946
1089
|
constructor(cfg: ClientConfig);
|
|
947
1090
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
948
1091
|
signPdfDigest(input: PdfDigestInput): Promise<PdfDigestSession>;
|
|
949
1092
|
/** {@link SignApi.registerSignature} — `pades.complete()`-ийн CMS-ийг CA-д бүртгэнэ (`POST /pdf/signatures`). */
|
|
950
1093
|
registerSignature(input: RegisterSignatureInput): Promise<RegisterSignatureResult>;
|
|
1094
|
+
/**
|
|
1095
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1096
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1097
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1098
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1099
|
+
*/
|
|
1100
|
+
share(input: ShareInput): Promise<ShareResult>;
|
|
1101
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1102
|
+
shareInfo(): Promise<ShareInfo>;
|
|
951
1103
|
}
|
|
952
1104
|
|
|
953
1105
|
/**
|
|
@@ -956,6 +1108,12 @@ declare class EidClient {
|
|
|
956
1108
|
* `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
|
|
957
1109
|
*/
|
|
958
1110
|
declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
|
|
1111
|
+
/**
|
|
1112
|
+
* `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
|
|
1113
|
+
* 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
|
|
1114
|
+
* тайлбартай гэрээний тест тулгана.
|
|
1115
|
+
*/
|
|
1116
|
+
declare const SHARE_FORM_FIELDS: readonly ["file", "filename", "to", "subject", "message", "lang"];
|
|
959
1117
|
|
|
960
1118
|
interface OcspCheckerOptions {
|
|
961
1119
|
/** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
|
|
@@ -1311,4 +1469,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
|
|
|
1311
1469
|
*/
|
|
1312
1470
|
declare function createEidLogin(opts: EidLoginOptions): EidLogin;
|
|
1313
1471
|
|
|
1314
|
-
export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, Interaction, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SessionApi, SessionResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
|
|
1472
|
+
export { AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_ISSUING_CA_SKI, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, NotificationSession, type OcspCheckerOptions, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, type QrDeviceLinkTickerOptions, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyTokenCertificates, withReturnHint };
|
package/dist/index.js
CHANGED
|
@@ -45,6 +45,10 @@ var Http = class {
|
|
|
45
45
|
const text = new TextDecoder().decode(await readLimited(res, MAX_JSON_BYTES, op));
|
|
46
46
|
return { status: res.status, body: text ? JSON.parse(text) : {} };
|
|
47
47
|
}
|
|
48
|
+
/** multipart/form-data POST (`/share`); Content-Type-ийг (boundary) fetch тавина. */
|
|
49
|
+
postForm(path, form, timeoutMs) {
|
|
50
|
+
return this.json("POST", path, form, void 0, timeoutMs);
|
|
51
|
+
}
|
|
48
52
|
get(path, timeoutMs) {
|
|
49
53
|
return this.json("GET", path, void 0, void 0, timeoutMs);
|
|
50
54
|
}
|
|
@@ -163,7 +167,8 @@ var RP_ROUTES = {
|
|
|
163
167
|
tokenCertificateResult: { method: "GET", path: "/token/certificate/{sessionID}" },
|
|
164
168
|
pdfSignatures: { method: "POST", path: "/pdf/signatures" },
|
|
165
169
|
tokenAuthChallenge: { method: "POST", path: "/token/auth/challenge" },
|
|
166
|
-
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" }
|
|
170
|
+
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" },
|
|
171
|
+
share: { method: "POST", path: "/share" }
|
|
167
172
|
};
|
|
168
173
|
var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
169
174
|
"docID",
|
|
@@ -181,6 +186,7 @@ var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
|
181
186
|
"onBehalfOf",
|
|
182
187
|
"signerEtsi"
|
|
183
188
|
];
|
|
189
|
+
var SHARE_FORM_FIELDS = ["file", "filename", "to", "subject", "message", "lang"];
|
|
184
190
|
function routePath(route, ...args) {
|
|
185
191
|
let i = 0;
|
|
186
192
|
const out = route.path.replace(/\{[^}]*\}/g, () => {
|
|
@@ -1033,6 +1039,8 @@ function hexSha256Equal(hex, data) {
|
|
|
1033
1039
|
if (typeof hex !== "string" || !/^[0-9a-fA-F]{64}$/.test(hex)) return false;
|
|
1034
1040
|
return timingSafeEqual(createHash2("sha256").update(data).digest(), Buffer.from(hex, "hex"));
|
|
1035
1041
|
}
|
|
1042
|
+
var TOKEN_CONFLICT_CODES = ["TOKEN_LIMIT_REACHED", "TOKEN_IN_USE", "TOKEN_SCOPE_CHANGE"];
|
|
1043
|
+
var DISCOVERY_PATH = "/.well-known/eid";
|
|
1036
1044
|
var TOKEN_RESULT_TIMEOUT_MS = 3e4;
|
|
1037
1045
|
var TokenApi = class {
|
|
1038
1046
|
constructor(http, creds) {
|
|
@@ -1044,6 +1052,11 @@ var TokenApi = class {
|
|
|
1044
1052
|
/**
|
|
1045
1053
|
* POST /token/certificate — токены AUTH + SIGN гэрчилгээ олголт эхлүүлнэ (иргэн утсаараа батална). CA-ийн буцаасан
|
|
1046
1054
|
* CSR hash-ууд илгээсэнтэй таарахгүй бол ValidationError.
|
|
1055
|
+
*
|
|
1056
|
+
* Сунгалт: ижил `tokenSerial` дээр энэ иргэний ACTIVE бүртгэл байвал олголт = сунгалт, **scope-ийг хадгална** —
|
|
1057
|
+
* байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
|
|
1058
|
+
* 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
|
|
1059
|
+
* Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
|
|
1047
1060
|
*/
|
|
1048
1061
|
async issueCertificate(input) {
|
|
1049
1062
|
if (!input.signerEtsi?.trim() || !input.csrAuth?.length || !input.csrSign?.length || !input.tokenSerial?.trim()) {
|
|
@@ -1073,9 +1086,26 @@ var TokenApi = class {
|
|
|
1073
1086
|
...typeof r.expiresAt === "string" ? { expiresAt: r.expiresAt } : {}
|
|
1074
1087
|
};
|
|
1075
1088
|
}
|
|
1089
|
+
/** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
|
|
1090
|
+
async certificateInfo() {
|
|
1091
|
+
const d = rec4(await this.http.get(DISCOVERY_PATH));
|
|
1092
|
+
const t = rec4(d.tokenCertificate);
|
|
1093
|
+
return {
|
|
1094
|
+
enabled: t.enabled === true,
|
|
1095
|
+
issue: String(t.issue ?? ""),
|
|
1096
|
+
result: String(t.result ?? ""),
|
|
1097
|
+
permission: String(t.permission ?? ""),
|
|
1098
|
+
certificateLevel: String(t.certificateLevel ?? ""),
|
|
1099
|
+
keyAlgorithm: String(t.keyAlgorithm ?? ""),
|
|
1100
|
+
onBehalfOf: String(t.onBehalfOf ?? ""),
|
|
1101
|
+
scopeLockedOnRenewal: t.scopeLockedOnRenewal === true,
|
|
1102
|
+
raw: d.tokenCertificate
|
|
1103
|
+
};
|
|
1104
|
+
}
|
|
1076
1105
|
/**
|
|
1077
1106
|
* GET /token/certificate/{sessionID} — олгосон AUTH + SIGN гэрчилгээ + гинж. Токенд бичихээс өмнө
|
|
1078
|
-
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга.
|
|
1107
|
+
* {@link verifyTokenCertificates}-ээр CSR-ийн түлхүүртэй тулга. Эхлэл ба батлалтын хооронд нөхцөл өөрчлөгдсөн бол
|
|
1108
|
+
* 409 ({@link TokenConflictCode}) — гэрчилгээ гараагүй.
|
|
1079
1109
|
*/
|
|
1080
1110
|
async certificateResult(sessionId) {
|
|
1081
1111
|
const raw = await this.http.get(routePath(RP_ROUTES.tokenCertificateResult, sessionId), TOKEN_RESULT_TIMEOUT_MS);
|
|
@@ -1197,6 +1227,109 @@ function tokenLimitOf(err) {
|
|
|
1197
1227
|
return void 0;
|
|
1198
1228
|
}
|
|
1199
1229
|
|
|
1230
|
+
// src/share.ts
|
|
1231
|
+
var DEFAULT_SHARE_TIMEOUT_MS = 15e4;
|
|
1232
|
+
var SHARE_ERROR_CODES = [
|
|
1233
|
+
"REQUEST_INVALID",
|
|
1234
|
+
"FILE_EMPTY",
|
|
1235
|
+
"RECIPIENT_REQUIRED",
|
|
1236
|
+
"TOO_MANY_RECIPIENTS",
|
|
1237
|
+
"RECIPIENT_INVALID",
|
|
1238
|
+
"RECIPIENT_DUPLICATE",
|
|
1239
|
+
"FILE_TOO_LARGE",
|
|
1240
|
+
"FILE_TYPE_NOT_SUPPORTED",
|
|
1241
|
+
"FILE_NOT_SIGNED",
|
|
1242
|
+
"RATE_LIMITED",
|
|
1243
|
+
"MAIL_FAILED",
|
|
1244
|
+
"SHARE_DISABLED",
|
|
1245
|
+
"MAIL_UNAVAILABLE",
|
|
1246
|
+
"VALIDATOR_UNAVAILABLE",
|
|
1247
|
+
"VALIDATOR_BUSY"
|
|
1248
|
+
];
|
|
1249
|
+
var ShareError = class extends ApiError {
|
|
1250
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
1251
|
+
reason;
|
|
1252
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
1253
|
+
sent;
|
|
1254
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
1255
|
+
failed;
|
|
1256
|
+
/**
|
|
1257
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
1258
|
+
* бүү илгээ).
|
|
1259
|
+
*/
|
|
1260
|
+
recipients;
|
|
1261
|
+
constructor(status, body, code, init) {
|
|
1262
|
+
super(status, body, code, init);
|
|
1263
|
+
const o = parseObject(body);
|
|
1264
|
+
if (typeof o.reason === "string") this.reason = o.reason;
|
|
1265
|
+
if (typeof o.sent === "number") this.sent = o.sent;
|
|
1266
|
+
if (typeof o.failed === "number") this.failed = o.failed;
|
|
1267
|
+
if (Array.isArray(o.recipients)) this.recipients = o.recipients.map(String);
|
|
1268
|
+
}
|
|
1269
|
+
};
|
|
1270
|
+
var DISCOVERY_PATH2 = "/.well-known/eid";
|
|
1271
|
+
function parseObject(text) {
|
|
1272
|
+
try {
|
|
1273
|
+
const v = JSON.parse(text);
|
|
1274
|
+
return v && typeof v === "object" ? v : {};
|
|
1275
|
+
} catch {
|
|
1276
|
+
return {};
|
|
1277
|
+
}
|
|
1278
|
+
}
|
|
1279
|
+
async function shareFile(http, input) {
|
|
1280
|
+
const to = typeof input.to === "string" ? [input.to] : [...input.to];
|
|
1281
|
+
const blob = input.file instanceof Blob ? input.file : new Blob([new Uint8Array(input.file)], { type: "application/pdf" });
|
|
1282
|
+
const filename = input.filename ?? input.file.name ?? "document.pdf";
|
|
1283
|
+
const form = new FormData();
|
|
1284
|
+
for (const a of to) form.append("to", a);
|
|
1285
|
+
if (input.subject !== void 0) form.append("subject", input.subject);
|
|
1286
|
+
if (input.message !== void 0) form.append("message", input.message);
|
|
1287
|
+
if (input.lang !== void 0) form.append("lang", input.lang);
|
|
1288
|
+
if (input.filename !== void 0) form.append("filename", input.filename);
|
|
1289
|
+
form.append("file", blob.type ? blob : new Blob([blob], { type: "application/pdf" }), filename || "document.pdf");
|
|
1290
|
+
let raw;
|
|
1291
|
+
try {
|
|
1292
|
+
raw = await http.postForm(RP_ROUTES.share.path, form, input.timeoutMs ?? DEFAULT_SHARE_TIMEOUT_MS);
|
|
1293
|
+
} catch (e) {
|
|
1294
|
+
if (e instanceof ApiError && !(e instanceof ShareError)) {
|
|
1295
|
+
throw new ShareError(e.status, e.body, e.code, { headers: e.headers, retryAfterMs: e.retryAfterMs });
|
|
1296
|
+
}
|
|
1297
|
+
throw e;
|
|
1298
|
+
}
|
|
1299
|
+
const o = raw && typeof raw === "object" ? raw : {};
|
|
1300
|
+
return {
|
|
1301
|
+
sent: Number(o.sent ?? 0),
|
|
1302
|
+
sha256: String(o.sha256 ?? ""),
|
|
1303
|
+
signatures: Number(o.signatures ?? 0),
|
|
1304
|
+
...typeof o.docID === "string" && o.docID ? { docID: o.docID } : {},
|
|
1305
|
+
raw
|
|
1306
|
+
};
|
|
1307
|
+
}
|
|
1308
|
+
async function shareInfo(http) {
|
|
1309
|
+
const d = await http.get(DISCOVERY_PATH2);
|
|
1310
|
+
const s = d.share && typeof d.share === "object" ? d.share : {};
|
|
1311
|
+
const q = s.quota && typeof s.quota === "object" ? s.quota : {};
|
|
1312
|
+
return {
|
|
1313
|
+
enabled: s.enabled === true,
|
|
1314
|
+
endpoint: String(s.endpoint ?? ""),
|
|
1315
|
+
formats: Array.isArray(s.formats) ? s.formats : [],
|
|
1316
|
+
languages: Array.isArray(s.languages) ? s.languages.map(String) : [],
|
|
1317
|
+
maxFileBytes: Number(s.maxFileBytes ?? 0),
|
|
1318
|
+
maxFilenameChars: Number(s.maxFilenameChars ?? 0),
|
|
1319
|
+
maxMessageChars: Number(s.maxMessageChars ?? 0),
|
|
1320
|
+
maxRecipients: Number(s.maxRecipients ?? 0),
|
|
1321
|
+
maxSubjectChars: Number(s.maxSubjectChars ?? 0),
|
|
1322
|
+
permission: String(s.permission ?? ""),
|
|
1323
|
+
quota: {
|
|
1324
|
+
perRPHour: Number(q.perRPHour ?? 0),
|
|
1325
|
+
perRPDay: Number(q.perRPDay ?? 0),
|
|
1326
|
+
perRecipientDay: Number(q.perRecipientDay ?? 0)
|
|
1327
|
+
},
|
|
1328
|
+
requiresValidSignature: s.requiresValidSignature === true,
|
|
1329
|
+
raw: d.share
|
|
1330
|
+
};
|
|
1331
|
+
}
|
|
1332
|
+
|
|
1200
1333
|
// src/validator.ts
|
|
1201
1334
|
import { X509Certificate as X509Certificate3, constants, createHash as createHash3, publicDecrypt, verify } from "crypto";
|
|
1202
1335
|
var CITIZEN_ISSUING_CA_SKI = "b8a37f2c64ad677912db7d9e34f246358a2fb909";
|
|
@@ -1802,6 +1935,7 @@ var EidClient = class {
|
|
|
1802
1935
|
validator;
|
|
1803
1936
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
1804
1937
|
rpName;
|
|
1938
|
+
http;
|
|
1805
1939
|
constructor(cfg) {
|
|
1806
1940
|
if (!cfg.credentials?.apiSecret) throw new Error("EidClient: credentials.apiSecret \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
|
|
1807
1941
|
const base = resolveBaseUrl(cfg.baseUrl);
|
|
@@ -1822,6 +1956,7 @@ var EidClient = class {
|
|
|
1822
1956
|
this.session = new SessionApi(http);
|
|
1823
1957
|
this.validator = new ResponseValidator(cfg.trust ?? {});
|
|
1824
1958
|
this.rpName = cfg.credentials.rpName;
|
|
1959
|
+
this.http = http;
|
|
1825
1960
|
}
|
|
1826
1961
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
1827
1962
|
signPdfDigest(input) {
|
|
@@ -1831,6 +1966,19 @@ var EidClient = class {
|
|
|
1831
1966
|
registerSignature(input) {
|
|
1832
1967
|
return this.sign.registerSignature(input);
|
|
1833
1968
|
}
|
|
1969
|
+
/**
|
|
1970
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1971
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1972
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1973
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1974
|
+
*/
|
|
1975
|
+
share(input) {
|
|
1976
|
+
return shareFile(this.http, input);
|
|
1977
|
+
}
|
|
1978
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1979
|
+
shareInfo() {
|
|
1980
|
+
return shareInfo(this.http);
|
|
1981
|
+
}
|
|
1834
1982
|
};
|
|
1835
1983
|
|
|
1836
1984
|
// src/ocsp.ts
|
|
@@ -2536,6 +2684,7 @@ export {
|
|
|
2536
2684
|
CITIZEN_ISSUING_CA_SKI,
|
|
2537
2685
|
CertChoiceInvalidError,
|
|
2538
2686
|
DEFAULT_BASE_URL,
|
|
2687
|
+
DEFAULT_SHARE_TIMEOUT_MS,
|
|
2539
2688
|
DEFAULT_SIGN_SESSION_TTL_MS,
|
|
2540
2689
|
DeviceLinkError,
|
|
2541
2690
|
EidClient,
|
|
@@ -2552,9 +2701,13 @@ export {
|
|
|
2552
2701
|
RequestInvalidError,
|
|
2553
2702
|
ResponseTooLargeError,
|
|
2554
2703
|
ResponseValidator,
|
|
2704
|
+
SHARE_ERROR_CODES,
|
|
2705
|
+
SHARE_FORM_FIELDS,
|
|
2555
2706
|
SessionApi,
|
|
2556
2707
|
SessionFailedError,
|
|
2708
|
+
ShareError,
|
|
2557
2709
|
SignApi,
|
|
2710
|
+
TOKEN_CONFLICT_CODES,
|
|
2558
2711
|
TokenApi,
|
|
2559
2712
|
ValidationError,
|
|
2560
2713
|
acspV2Digest,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gerege-systems/eid-mongolia-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.18.1",
|
|
4
4
|
"description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
},
|
|
45
45
|
"scripts": {
|
|
46
46
|
"build": "tsup src/index.ts src/browser.ts src/pades.ts --format esm,cjs --dts --clean && tsup src/button.ts --format esm,cjs --dts --tsconfig tsconfig.button.json && tsup src/convert.ts --format esm --dts --tsconfig tsconfig.button.json",
|
|
47
|
-
"test": "npm run build && node --test --experimental-strip-types test/sdk.test.ts test/portal-gaps.test.ts test/chain.test.ts test/qr.test.ts test/login.test.ts test/button.test.ts test/sign-gaps.test.ts test/session-start.test.ts test/pades-session.test.ts test/pades-golden.test.ts test/pades-unit.test.ts test/convert.test.ts",
|
|
47
|
+
"test": "npm run build && node --test --experimental-strip-types test/sdk.test.ts test/portal-gaps.test.ts test/chain.test.ts test/qr.test.ts test/login.test.ts test/button.test.ts test/sign-gaps.test.ts test/session-start.test.ts test/pades-session.test.ts test/pades-golden.test.ts test/pades-unit.test.ts test/convert.test.ts test/share.test.ts",
|
|
48
48
|
"test:contract": "npm run build && node --experimental-strip-types test/contract.test.ts",
|
|
49
49
|
"lint": "tsc --noEmit && tsc --noEmit -p tsconfig.button.json",
|
|
50
50
|
"golden:check": "node scripts/sync-pades-golden.mjs --check",
|