@gerege-systems/eid-mongolia-sdk 0.17.0 → 0.18.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 +50 -0
- package/dist/index.cjs +133 -1
- package/dist/index.d.cts +122 -2
- package/dist/index.d.ts +122 -2
- package/dist/index.js +129 -1
- 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
|
|
@@ -636,6 +640,51 @@ Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуу
|
|
|
636
640
|
ажиллуулахад татахгүй, цуцлалт, COEP-гүй хуудас. Мобайл хөтөчид 250 MB WASM санах ой их шаардана — сул утсанд унаж
|
|
637
641
|
болзошгүй.
|
|
638
642
|
|
|
643
|
+
## 3f. Гарын үсэгтэй файлыг имэйлээр — `eid.share()` (`SIGN` эрх)
|
|
644
|
+
|
|
645
|
+
Гарын үсэг зурсан PDF-ээ дараагийн гарын үсэг зурагч / хүлээн авагч руу хавсралтаар илгээнэ (`POST /share`). CA файлыг
|
|
646
|
+
**хадгалахгүй**: eID-ийн хүчинтэй гарын үсэгтэй эсэхийг шалгаад илгээж, хаяна. Хүлээн авагч бүрт тусдаа имэйл.
|
|
647
|
+
|
|
648
|
+
> CA-ийн туг одоогоор **унтраалттай** (`share.enabled=false` → 503 `SHARE_DISABLED`). Дуудахын өмнө
|
|
649
|
+
> `await eid.shareInfo()`-ийн `enabled`-ийг шалга.
|
|
650
|
+
|
|
651
|
+
```ts
|
|
652
|
+
import { ShareError } from "@gerege-systems/eid-mongolia-sdk";
|
|
653
|
+
|
|
654
|
+
const info = await eid.shareInfo(); // { enabled, maxFileBytes, maxRecipients, quota: { perRPHour, perRPDay, perRecipientDay }, … }
|
|
655
|
+
if (info.enabled) {
|
|
656
|
+
try {
|
|
657
|
+
const r = await eid.share({
|
|
658
|
+
file: signedPdf, // Uint8Array | ArrayBuffer | Blob/File; ≤ 3 080 192 байт
|
|
659
|
+
filename: "гэрээ.pdf", // .pdf өргөтгөлтэй; анхдагч File-ийн нэр эсвэл document.pdf
|
|
660
|
+
to: ["next@example.mn"], // 1–5, давхардалгүй
|
|
661
|
+
subject: "Гэрээ — гарын үсэг", // ≤ 150; CA «‹RP нэр›: …» угтвар тавина
|
|
662
|
+
message: "Хоёр дахь гарын үсгийг зурна уу", // ≤ 1000
|
|
663
|
+
lang: "mn", // mn | en
|
|
664
|
+
});
|
|
665
|
+
console.log(r.sent, r.sha256, r.signatures, r.docID); // docID — CA-д бүртгэлтэй бол (имэйлд verify холбоос)
|
|
666
|
+
} catch (e) {
|
|
667
|
+
if (e instanceof ShareError) {
|
|
668
|
+
// e.code: ShareErrorCode; 422 → e.reason; 502 → e.sent / e.failed / e.recipients ("sent" | "failed", to-гийн дарааллаар)
|
|
669
|
+
}
|
|
670
|
+
throw e;
|
|
671
|
+
}
|
|
672
|
+
}
|
|
673
|
+
```
|
|
674
|
+
|
|
675
|
+
| HTTP | `ShareError.code` | Тайлбар |
|
|
676
|
+
|---|---|---|
|
|
677
|
+
| 400 | `REQUEST_INVALID`, `FILE_EMPTY`, `RECIPIENT_REQUIRED`, `TOO_MANY_RECIPIENTS`, `RECIPIENT_INVALID`, `RECIPIENT_DUPLICATE` | талбарын алдаа |
|
|
678
|
+
| 413 | `FILE_TOO_LARGE` | файл / имэйл хязгаараас их |
|
|
679
|
+
| 415 | `FILE_TYPE_NOT_SUPPORTED` | PDF биш (өргөтгөл, Content-Type, `%PDF-` гурвуулаа таарна) |
|
|
680
|
+
| 422 | `FILE_NOT_SIGNED` | `.reason`: `no_signature` \| `invalid` \| `untrusted` |
|
|
681
|
+
| 429 | `RATE_LIMITED` | квот; `.retryAfterMs`, `.retryable` |
|
|
682
|
+
| 502 | `MAIL_FAILED` | `.sent`, `.failed`, `.recipients` — зөвхөн `failed`-ийг дахин илгээ |
|
|
683
|
+
| 503 | `SHARE_DISABLED`, `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` | туг / тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
|
|
684
|
+
|
|
685
|
+
401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт 30 / өдөрт 200 хүсэлт,
|
|
686
|
+
хүлээн авагч тутам өдөрт 10 имэйл (бодит утгыг `shareInfo().quota`-аас). Хугацаа анхдагч 150 с (`timeoutMs`).
|
|
687
|
+
|
|
639
688
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
640
689
|
|
|
641
690
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
|
@@ -766,6 +815,7 @@ OK ирж болзошгүй. Иймд `ResponseValidator`:
|
|
|
766
815
|
| `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start); `ApiError`-ийн дэд анги |
|
|
767
816
|
| `CertChoiceInvalidError` | 409 `CERT_CHOICE_INVALID` — linked sign-ийн certificate-choice хүчингүй; `ApiError`-ийн дэд анги |
|
|
768
817
|
| `RequestInvalidError` | 400 `REQUEST_INVALID` — хүсэлт буруу (ж: `linkedSessionID` дутуу); `ApiError`-ийн дэд анги |
|
|
818
|
+
| `ShareError` | `share()`-ийн 4xx/5xx (401/403-аас бусад) — `.code` (`ShareErrorCode`), `.reason` (422), `.sent`/`.failed`/`.recipients` (502); `ApiError`-ийн дэд анги |
|
|
769
819
|
| `ApiError` | бусад HTTP алдаа (`.status`, `.body`, серверийн `.code`, `.retryAfterMs`, `.headers`, `.retryable` — ж: 404 `ORG_NOT_FOUND`) |
|
|
770
820
|
| `ResponseTooLargeError` | хариу SDK-ийн хязгаараас их (JSON 4 MiB) — `.op`, `.limit` |
|
|
771
821
|
| `NetworkError` | timeout/сүлжээ (`.op` — таних тэмдэггүй зам, `.timeout`) |
|
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,8 +43,11 @@ __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,
|
|
48
52
|
TokenApi: () => TokenApi,
|
|
49
53
|
ValidationError: () => ValidationError,
|
|
@@ -226,6 +230,10 @@ var Http = class {
|
|
|
226
230
|
const text = new TextDecoder().decode(await readLimited(res, MAX_JSON_BYTES, op));
|
|
227
231
|
return { status: res.status, body: text ? JSON.parse(text) : {} };
|
|
228
232
|
}
|
|
233
|
+
/** multipart/form-data POST (`/share`); Content-Type-ийг (boundary) fetch тавина. */
|
|
234
|
+
postForm(path, form, timeoutMs) {
|
|
235
|
+
return this.json("POST", path, form, void 0, timeoutMs);
|
|
236
|
+
}
|
|
229
237
|
get(path, timeoutMs) {
|
|
230
238
|
return this.json("GET", path, void 0, void 0, timeoutMs);
|
|
231
239
|
}
|
|
@@ -344,7 +352,8 @@ var RP_ROUTES = {
|
|
|
344
352
|
tokenCertificateResult: { method: "GET", path: "/token/certificate/{sessionID}" },
|
|
345
353
|
pdfSignatures: { method: "POST", path: "/pdf/signatures" },
|
|
346
354
|
tokenAuthChallenge: { method: "POST", path: "/token/auth/challenge" },
|
|
347
|
-
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" }
|
|
355
|
+
tokenAuthVerify: { method: "POST", path: "/token/auth/verify" },
|
|
356
|
+
share: { method: "POST", path: "/share" }
|
|
348
357
|
};
|
|
349
358
|
var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
350
359
|
"docID",
|
|
@@ -362,6 +371,7 @@ var PDF_SIGNATURE_REGISTER_FIELDS = [
|
|
|
362
371
|
"onBehalfOf",
|
|
363
372
|
"signerEtsi"
|
|
364
373
|
];
|
|
374
|
+
var SHARE_FORM_FIELDS = ["file", "filename", "to", "subject", "message", "lang"];
|
|
365
375
|
function routePath(route, ...args) {
|
|
366
376
|
let i = 0;
|
|
367
377
|
const out = route.path.replace(/\{[^}]*\}/g, () => {
|
|
@@ -1378,6 +1388,109 @@ function tokenLimitOf(err) {
|
|
|
1378
1388
|
return void 0;
|
|
1379
1389
|
}
|
|
1380
1390
|
|
|
1391
|
+
// src/share.ts
|
|
1392
|
+
var DEFAULT_SHARE_TIMEOUT_MS = 15e4;
|
|
1393
|
+
var SHARE_ERROR_CODES = [
|
|
1394
|
+
"REQUEST_INVALID",
|
|
1395
|
+
"FILE_EMPTY",
|
|
1396
|
+
"RECIPIENT_REQUIRED",
|
|
1397
|
+
"TOO_MANY_RECIPIENTS",
|
|
1398
|
+
"RECIPIENT_INVALID",
|
|
1399
|
+
"RECIPIENT_DUPLICATE",
|
|
1400
|
+
"FILE_TOO_LARGE",
|
|
1401
|
+
"FILE_TYPE_NOT_SUPPORTED",
|
|
1402
|
+
"FILE_NOT_SIGNED",
|
|
1403
|
+
"RATE_LIMITED",
|
|
1404
|
+
"MAIL_FAILED",
|
|
1405
|
+
"SHARE_DISABLED",
|
|
1406
|
+
"MAIL_UNAVAILABLE",
|
|
1407
|
+
"VALIDATOR_UNAVAILABLE",
|
|
1408
|
+
"VALIDATOR_BUSY"
|
|
1409
|
+
];
|
|
1410
|
+
var ShareError = class extends ApiError {
|
|
1411
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
1412
|
+
reason;
|
|
1413
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
1414
|
+
sent;
|
|
1415
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
1416
|
+
failed;
|
|
1417
|
+
/**
|
|
1418
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
1419
|
+
* бүү илгээ).
|
|
1420
|
+
*/
|
|
1421
|
+
recipients;
|
|
1422
|
+
constructor(status, body, code, init) {
|
|
1423
|
+
super(status, body, code, init);
|
|
1424
|
+
const o = parseObject(body);
|
|
1425
|
+
if (typeof o.reason === "string") this.reason = o.reason;
|
|
1426
|
+
if (typeof o.sent === "number") this.sent = o.sent;
|
|
1427
|
+
if (typeof o.failed === "number") this.failed = o.failed;
|
|
1428
|
+
if (Array.isArray(o.recipients)) this.recipients = o.recipients.map(String);
|
|
1429
|
+
}
|
|
1430
|
+
};
|
|
1431
|
+
var DISCOVERY_PATH = "/.well-known/eid";
|
|
1432
|
+
function parseObject(text) {
|
|
1433
|
+
try {
|
|
1434
|
+
const v = JSON.parse(text);
|
|
1435
|
+
return v && typeof v === "object" ? v : {};
|
|
1436
|
+
} catch {
|
|
1437
|
+
return {};
|
|
1438
|
+
}
|
|
1439
|
+
}
|
|
1440
|
+
async function shareFile(http, input) {
|
|
1441
|
+
const to = typeof input.to === "string" ? [input.to] : [...input.to];
|
|
1442
|
+
const blob = input.file instanceof Blob ? input.file : new Blob([new Uint8Array(input.file)], { type: "application/pdf" });
|
|
1443
|
+
const filename = input.filename ?? input.file.name ?? "document.pdf";
|
|
1444
|
+
const form = new FormData();
|
|
1445
|
+
for (const a of to) form.append("to", a);
|
|
1446
|
+
if (input.subject !== void 0) form.append("subject", input.subject);
|
|
1447
|
+
if (input.message !== void 0) form.append("message", input.message);
|
|
1448
|
+
if (input.lang !== void 0) form.append("lang", input.lang);
|
|
1449
|
+
if (input.filename !== void 0) form.append("filename", input.filename);
|
|
1450
|
+
form.append("file", blob.type ? blob : new Blob([blob], { type: "application/pdf" }), filename || "document.pdf");
|
|
1451
|
+
let raw;
|
|
1452
|
+
try {
|
|
1453
|
+
raw = await http.postForm(RP_ROUTES.share.path, form, input.timeoutMs ?? DEFAULT_SHARE_TIMEOUT_MS);
|
|
1454
|
+
} catch (e) {
|
|
1455
|
+
if (e instanceof ApiError && !(e instanceof ShareError)) {
|
|
1456
|
+
throw new ShareError(e.status, e.body, e.code, { headers: e.headers, retryAfterMs: e.retryAfterMs });
|
|
1457
|
+
}
|
|
1458
|
+
throw e;
|
|
1459
|
+
}
|
|
1460
|
+
const o = raw && typeof raw === "object" ? raw : {};
|
|
1461
|
+
return {
|
|
1462
|
+
sent: Number(o.sent ?? 0),
|
|
1463
|
+
sha256: String(o.sha256 ?? ""),
|
|
1464
|
+
signatures: Number(o.signatures ?? 0),
|
|
1465
|
+
...typeof o.docID === "string" && o.docID ? { docID: o.docID } : {},
|
|
1466
|
+
raw
|
|
1467
|
+
};
|
|
1468
|
+
}
|
|
1469
|
+
async function shareInfo(http) {
|
|
1470
|
+
const d = await http.get(DISCOVERY_PATH);
|
|
1471
|
+
const s = d.share && typeof d.share === "object" ? d.share : {};
|
|
1472
|
+
const q = s.quota && typeof s.quota === "object" ? s.quota : {};
|
|
1473
|
+
return {
|
|
1474
|
+
enabled: s.enabled === true,
|
|
1475
|
+
endpoint: String(s.endpoint ?? ""),
|
|
1476
|
+
formats: Array.isArray(s.formats) ? s.formats : [],
|
|
1477
|
+
languages: Array.isArray(s.languages) ? s.languages.map(String) : [],
|
|
1478
|
+
maxFileBytes: Number(s.maxFileBytes ?? 0),
|
|
1479
|
+
maxFilenameChars: Number(s.maxFilenameChars ?? 0),
|
|
1480
|
+
maxMessageChars: Number(s.maxMessageChars ?? 0),
|
|
1481
|
+
maxRecipients: Number(s.maxRecipients ?? 0),
|
|
1482
|
+
maxSubjectChars: Number(s.maxSubjectChars ?? 0),
|
|
1483
|
+
permission: String(s.permission ?? ""),
|
|
1484
|
+
quota: {
|
|
1485
|
+
perRPHour: Number(q.perRPHour ?? 0),
|
|
1486
|
+
perRPDay: Number(q.perRPDay ?? 0),
|
|
1487
|
+
perRecipientDay: Number(q.perRecipientDay ?? 0)
|
|
1488
|
+
},
|
|
1489
|
+
requiresValidSignature: s.requiresValidSignature === true,
|
|
1490
|
+
raw: d.share
|
|
1491
|
+
};
|
|
1492
|
+
}
|
|
1493
|
+
|
|
1381
1494
|
// src/validator.ts
|
|
1382
1495
|
var import_node_crypto4 = require("crypto");
|
|
1383
1496
|
var CITIZEN_ISSUING_CA_SKI = "b8a37f2c64ad677912db7d9e34f246358a2fb909";
|
|
@@ -1983,6 +2096,7 @@ var EidClient = class {
|
|
|
1983
2096
|
validator;
|
|
1984
2097
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
1985
2098
|
rpName;
|
|
2099
|
+
http;
|
|
1986
2100
|
constructor(cfg) {
|
|
1987
2101
|
if (!cfg.credentials?.apiSecret) throw new Error("EidClient: credentials.apiSecret \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
|
|
1988
2102
|
const base = resolveBaseUrl(cfg.baseUrl);
|
|
@@ -2003,6 +2117,7 @@ var EidClient = class {
|
|
|
2003
2117
|
this.session = new SessionApi(http);
|
|
2004
2118
|
this.validator = new ResponseValidator(cfg.trust ?? {});
|
|
2005
2119
|
this.rpName = cfg.credentials.rpName;
|
|
2120
|
+
this.http = http;
|
|
2006
2121
|
}
|
|
2007
2122
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
2008
2123
|
signPdfDigest(input) {
|
|
@@ -2012,6 +2127,19 @@ var EidClient = class {
|
|
|
2012
2127
|
registerSignature(input) {
|
|
2013
2128
|
return this.sign.registerSignature(input);
|
|
2014
2129
|
}
|
|
2130
|
+
/**
|
|
2131
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
2132
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
2133
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
2134
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
2135
|
+
*/
|
|
2136
|
+
share(input) {
|
|
2137
|
+
return shareFile(this.http, input);
|
|
2138
|
+
}
|
|
2139
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
2140
|
+
shareInfo() {
|
|
2141
|
+
return shareInfo(this.http);
|
|
2142
|
+
}
|
|
2015
2143
|
};
|
|
2016
2144
|
|
|
2017
2145
|
// src/ocsp.ts
|
|
@@ -3266,6 +3394,7 @@ function createEidLogin(opts) {
|
|
|
3266
3394
|
CITIZEN_ISSUING_CA_SKI,
|
|
3267
3395
|
CertChoiceInvalidError,
|
|
3268
3396
|
DEFAULT_BASE_URL,
|
|
3397
|
+
DEFAULT_SHARE_TIMEOUT_MS,
|
|
3269
3398
|
DEFAULT_SIGN_SESSION_TTL_MS,
|
|
3270
3399
|
DeviceLinkError,
|
|
3271
3400
|
EidClient,
|
|
@@ -3282,8 +3411,11 @@ function createEidLogin(opts) {
|
|
|
3282
3411
|
RequestInvalidError,
|
|
3283
3412
|
ResponseTooLargeError,
|
|
3284
3413
|
ResponseValidator,
|
|
3414
|
+
SHARE_ERROR_CODES,
|
|
3415
|
+
SHARE_FORM_FIELDS,
|
|
3285
3416
|
SessionApi,
|
|
3286
3417
|
SessionFailedError,
|
|
3418
|
+
ShareError,
|
|
3287
3419
|
SignApi,
|
|
3288
3420
|
TokenApi,
|
|
3289
3421
|
ValidationError,
|
package/dist/index.d.cts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
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-DFnRVCfN.cjs';
|
|
2
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-DFnRVCfN.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 мөрөнд токенд холбогдсон байгууллага; хувийн токенд алга. */
|
|
@@ -627,6 +642,95 @@ declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
|
|
|
627
642
|
*/
|
|
628
643
|
declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
|
|
629
644
|
|
|
645
|
+
/** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
|
|
646
|
+
declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
|
|
647
|
+
/** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
|
|
648
|
+
interface ShareInput {
|
|
649
|
+
/** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
|
|
650
|
+
file: Blob | Uint8Array | ArrayBuffer;
|
|
651
|
+
/**
|
|
652
|
+
* Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
|
|
653
|
+
* нэр, байхгүй бол `document.pdf`.
|
|
654
|
+
*/
|
|
655
|
+
filename?: string;
|
|
656
|
+
/** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
|
|
657
|
+
to: string | readonly string[];
|
|
658
|
+
/** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
|
|
659
|
+
subject?: string;
|
|
660
|
+
/** Илгээгчийн тэмдэглэл (≤ 1000). */
|
|
661
|
+
message?: string;
|
|
662
|
+
/** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
|
|
663
|
+
lang?: "mn" | "en";
|
|
664
|
+
/** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
|
|
665
|
+
timeoutMs?: number;
|
|
666
|
+
}
|
|
667
|
+
/** 200 хариу. */
|
|
668
|
+
interface ShareResult {
|
|
669
|
+
/** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
|
|
670
|
+
sent: number;
|
|
671
|
+
/** Файлын SHA-256 (hex). */
|
|
672
|
+
sha256: string;
|
|
673
|
+
/** Хүчинтэй eID гарын үсгийн тоо. */
|
|
674
|
+
signatures: number;
|
|
675
|
+
/** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
|
|
676
|
+
docID?: string;
|
|
677
|
+
raw: unknown;
|
|
678
|
+
}
|
|
679
|
+
/** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
|
|
680
|
+
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";
|
|
681
|
+
/** {@link ShareErrorCode}-ийн бүх утга. */
|
|
682
|
+
declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
|
|
683
|
+
/** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
|
|
684
|
+
type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
|
|
685
|
+
/**
|
|
686
|
+
* `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
|
|
687
|
+
* ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
|
|
688
|
+
* (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
|
|
689
|
+
* SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
|
|
690
|
+
* undefined.
|
|
691
|
+
*/
|
|
692
|
+
declare class ShareError extends ApiError {
|
|
693
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
694
|
+
readonly reason?: ShareNotSignedReason | string;
|
|
695
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
696
|
+
readonly sent?: number;
|
|
697
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
698
|
+
readonly failed?: number;
|
|
699
|
+
/**
|
|
700
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
701
|
+
* бүү илгээ).
|
|
702
|
+
*/
|
|
703
|
+
readonly recipients?: readonly string[];
|
|
704
|
+
constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
|
|
705
|
+
}
|
|
706
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок. */
|
|
707
|
+
interface ShareInfo {
|
|
708
|
+
/** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
|
|
709
|
+
enabled: boolean;
|
|
710
|
+
endpoint: string;
|
|
711
|
+
formats: {
|
|
712
|
+
name: string;
|
|
713
|
+
extension: string;
|
|
714
|
+
mime: string;
|
|
715
|
+
}[];
|
|
716
|
+
languages: string[];
|
|
717
|
+
maxFileBytes: number;
|
|
718
|
+
maxFilenameChars: number;
|
|
719
|
+
maxMessageChars: number;
|
|
720
|
+
maxRecipients: number;
|
|
721
|
+
maxSubjectChars: number;
|
|
722
|
+
/** Шаардлагатай RP эрх (SIGN). */
|
|
723
|
+
permission: string;
|
|
724
|
+
/** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
|
|
725
|
+
quota: {
|
|
726
|
+
perRPHour: number;
|
|
727
|
+
perRPDay: number;
|
|
728
|
+
perRecipientDay: number;
|
|
729
|
+
};
|
|
730
|
+
requiresValidSignature: boolean;
|
|
731
|
+
raw: unknown;
|
|
732
|
+
}
|
|
733
|
+
|
|
630
734
|
/** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
|
|
631
735
|
interface CertSubject {
|
|
632
736
|
/** 2.5.4.42 GIVENNAME. */
|
|
@@ -943,11 +1047,21 @@ declare class EidClient {
|
|
|
943
1047
|
readonly validator: ResponseValidator;
|
|
944
1048
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
945
1049
|
readonly rpName: string;
|
|
1050
|
+
private readonly http;
|
|
946
1051
|
constructor(cfg: ClientConfig);
|
|
947
1052
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
948
1053
|
signPdfDigest(input: PdfDigestInput): Promise<PdfDigestSession>;
|
|
949
1054
|
/** {@link SignApi.registerSignature} — `pades.complete()`-ийн CMS-ийг CA-д бүртгэнэ (`POST /pdf/signatures`). */
|
|
950
1055
|
registerSignature(input: RegisterSignatureInput): Promise<RegisterSignatureResult>;
|
|
1056
|
+
/**
|
|
1057
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1058
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1059
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1060
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1061
|
+
*/
|
|
1062
|
+
share(input: ShareInput): Promise<ShareResult>;
|
|
1063
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1064
|
+
shareInfo(): Promise<ShareInfo>;
|
|
951
1065
|
}
|
|
952
1066
|
|
|
953
1067
|
/**
|
|
@@ -956,6 +1070,12 @@ declare class EidClient {
|
|
|
956
1070
|
* `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
|
|
957
1071
|
*/
|
|
958
1072
|
declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
|
|
1073
|
+
/**
|
|
1074
|
+
* `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
|
|
1075
|
+
* 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
|
|
1076
|
+
* тайлбартай гэрээний тест тулгана.
|
|
1077
|
+
*/
|
|
1078
|
+
declare const SHARE_FORM_FIELDS: readonly ["file", "filename", "to", "subject", "message", "lang"];
|
|
959
1079
|
|
|
960
1080
|
interface OcspCheckerOptions {
|
|
961
1081
|
/** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
|
|
@@ -1311,4 +1431,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
|
|
|
1311
1431
|
*/
|
|
1312
1432
|
declare function createEidLogin(opts: EidLoginOptions): EidLogin;
|
|
1313
1433
|
|
|
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 };
|
|
1434
|
+
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, 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 };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
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-BPhROZkH.js';
|
|
2
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-BPhROZkH.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 мөрөнд токенд холбогдсон байгууллага; хувийн токенд алга. */
|
|
@@ -627,6 +642,95 @@ declare function tokenAuthDigest(rpUUID: string, challengeB64: string): Buffer;
|
|
|
627
642
|
*/
|
|
628
643
|
declare function tokenLimitOf(err: unknown): TokenLimit | undefined;
|
|
629
644
|
|
|
645
|
+
/** Хүсэлтийн хугацаа: CA бүх хүлээн авагчид 120 с-д илгээнэ, nginx 150 с. */
|
|
646
|
+
declare const DEFAULT_SHARE_TIMEOUT_MS = 150000;
|
|
647
|
+
/** `client.share()`-ийн оролт. Хязгаар (CA main 0329ef95): discovery-ийн `share` блок ({@link ShareInfo}). */
|
|
648
|
+
interface ShareInput {
|
|
649
|
+
/** Гарын үсэгтэй файл (одоогоор зөвхөн PDF), ≤ 3 080 192 байт. `File` бол нэр нь `filename`-ийн анхдагч. */
|
|
650
|
+
file: Blob | Uint8Array | ArrayBuffer;
|
|
651
|
+
/**
|
|
652
|
+
* Хавсралтын нэр (≤ 120 тэмдэгт). Өргөтгөл нь форматтай таарах ёстой (`.pdf`) — эс бөгөөс 415. Анхдагч: `File`-ийн
|
|
653
|
+
* нэр, байхгүй бол `document.pdf`.
|
|
654
|
+
*/
|
|
655
|
+
filename?: string;
|
|
656
|
+
/** Хүлээн авагч, 1–5 (хүн бүрт тусдаа имэйл). Давхардвал 400 RECIPIENT_DUPLICATE. */
|
|
657
|
+
to: string | readonly string[];
|
|
658
|
+
/** Имэйлийн гарчиг (≤ 150); CA үргэлж `‹RP нэр›: …` угтвар тавина. */
|
|
659
|
+
subject?: string;
|
|
660
|
+
/** Илгээгчийн тэмдэглэл (≤ 1000). */
|
|
661
|
+
message?: string;
|
|
662
|
+
/** Имэйлийн хэл: `mn` (анхдагч) | `en`. */
|
|
663
|
+
lang?: "mn" | "en";
|
|
664
|
+
/** Хүсэлтийн хугацаа (мс). Анхдагч {@link DEFAULT_SHARE_TIMEOUT_MS}. */
|
|
665
|
+
timeoutMs?: number;
|
|
666
|
+
}
|
|
667
|
+
/** 200 хариу. */
|
|
668
|
+
interface ShareResult {
|
|
669
|
+
/** Илгээсэн имэйлийн тоо (= хүлээн авагчийн тоо). */
|
|
670
|
+
sent: number;
|
|
671
|
+
/** Файлын SHA-256 (hex). */
|
|
672
|
+
sha256: string;
|
|
673
|
+
/** Хүчинтэй eID гарын үсгийн тоо. */
|
|
674
|
+
signatures: number;
|
|
675
|
+
/** CA-д (`/pdf/signatures`) бүртгэлтэй бол баримтын ID — имэйлд verify холбоос орно. */
|
|
676
|
+
docID?: string;
|
|
677
|
+
raw: unknown;
|
|
678
|
+
}
|
|
679
|
+
/** `share()`-ийн CA алдааны кодууд ({@link ShareError.code}). */
|
|
680
|
+
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";
|
|
681
|
+
/** {@link ShareErrorCode}-ийн бүх утга. */
|
|
682
|
+
declare const SHARE_ERROR_CODES: readonly ShareErrorCode[];
|
|
683
|
+
/** 422 FILE_NOT_SIGNED-ийн шалтгаан. */
|
|
684
|
+
type ShareNotSignedReason = "no_signature" | "invalid" | "untrusted";
|
|
685
|
+
/**
|
|
686
|
+
* `share()`-ийн CA алдаа (401/403-аас бусад 4xx/5xx; 401 → AuthenticationError, 403 → ForbiddenError). `code`
|
|
687
|
+
* ({@link ShareErrorCode}): 400 талбарын алдаа, 413 FILE_TOO_LARGE, 415 FILE_TYPE_NOT_SUPPORTED, 422 FILE_NOT_SIGNED
|
|
688
|
+
* (+`reason`), 429 RATE_LIMITED (+`retryAfterMs`), 502 MAIL_FAILED (+`sent`, `failed`, `recipients`), 503
|
|
689
|
+
* SHARE_DISABLED / MAIL_UNAVAILABLE / VALIDATOR_UNAVAILABLE / VALIDATOR_BUSY. JSON биш хариу (proxy) бол `code`
|
|
690
|
+
* undefined.
|
|
691
|
+
*/
|
|
692
|
+
declare class ShareError extends ApiError {
|
|
693
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
694
|
+
readonly reason?: ShareNotSignedReason | string;
|
|
695
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
696
|
+
readonly sent?: number;
|
|
697
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
698
|
+
readonly failed?: number;
|
|
699
|
+
/**
|
|
700
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
701
|
+
* бүү илгээ).
|
|
702
|
+
*/
|
|
703
|
+
readonly recipients?: readonly string[];
|
|
704
|
+
constructor(status: number, body: string, code?: string, init?: HttpErrorInit);
|
|
705
|
+
}
|
|
706
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок. */
|
|
707
|
+
interface ShareInfo {
|
|
708
|
+
/** CA-ийн туг. false бол `share()` → 503 SHARE_DISABLED. */
|
|
709
|
+
enabled: boolean;
|
|
710
|
+
endpoint: string;
|
|
711
|
+
formats: {
|
|
712
|
+
name: string;
|
|
713
|
+
extension: string;
|
|
714
|
+
mime: string;
|
|
715
|
+
}[];
|
|
716
|
+
languages: string[];
|
|
717
|
+
maxFileBytes: number;
|
|
718
|
+
maxFilenameChars: number;
|
|
719
|
+
maxMessageChars: number;
|
|
720
|
+
maxRecipients: number;
|
|
721
|
+
maxSubjectChars: number;
|
|
722
|
+
/** Шаардлагатай RP эрх (SIGN). */
|
|
723
|
+
permission: string;
|
|
724
|
+
/** RP тутам цаг/өдөр (хүсэлт), хүлээн авагч тутам өдөр (имэйл, RP тус бүрд). */
|
|
725
|
+
quota: {
|
|
726
|
+
perRPHour: number;
|
|
727
|
+
perRPDay: number;
|
|
728
|
+
perRecipientDay: number;
|
|
729
|
+
};
|
|
730
|
+
requiresValidSignature: boolean;
|
|
731
|
+
raw: unknown;
|
|
732
|
+
}
|
|
733
|
+
|
|
630
734
|
/** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
|
|
631
735
|
interface CertSubject {
|
|
632
736
|
/** 2.5.4.42 GIVENNAME. */
|
|
@@ -943,11 +1047,21 @@ declare class EidClient {
|
|
|
943
1047
|
readonly validator: ResponseValidator;
|
|
944
1048
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
945
1049
|
readonly rpName: string;
|
|
1050
|
+
private readonly http;
|
|
946
1051
|
constructor(cfg: ClientConfig);
|
|
947
1052
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
948
1053
|
signPdfDigest(input: PdfDigestInput): Promise<PdfDigestSession>;
|
|
949
1054
|
/** {@link SignApi.registerSignature} — `pades.complete()`-ийн CMS-ийг CA-д бүртгэнэ (`POST /pdf/signatures`). */
|
|
950
1055
|
registerSignature(input: RegisterSignatureInput): Promise<RegisterSignatureResult>;
|
|
1056
|
+
/**
|
|
1057
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1058
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1059
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1060
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1061
|
+
*/
|
|
1062
|
+
share(input: ShareInput): Promise<ShareResult>;
|
|
1063
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1064
|
+
shareInfo(): Promise<ShareInfo>;
|
|
951
1065
|
}
|
|
952
1066
|
|
|
953
1067
|
/**
|
|
@@ -956,6 +1070,12 @@ declare class EidClient {
|
|
|
956
1070
|
* `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
|
|
957
1071
|
*/
|
|
958
1072
|
declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
|
|
1073
|
+
/**
|
|
1074
|
+
* `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
|
|
1075
|
+
* 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
|
|
1076
|
+
* тайлбартай гэрээний тест тулгана.
|
|
1077
|
+
*/
|
|
1078
|
+
declare const SHARE_FORM_FIELDS: readonly ["file", "filename", "to", "subject", "message", "lang"];
|
|
959
1079
|
|
|
960
1080
|
interface OcspCheckerOptions {
|
|
961
1081
|
/** fetch (тест/proxy). Анхдагч globalThis.fetch. Redirect дагахгүй ("manual"). */
|
|
@@ -1311,4 +1431,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
|
|
|
1311
1431
|
*/
|
|
1312
1432
|
declare function createEidLogin(opts: EidLoginOptions): EidLogin;
|
|
1313
1433
|
|
|
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 };
|
|
1434
|
+
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, 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 };
|
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, () => {
|
|
@@ -1197,6 +1203,109 @@ function tokenLimitOf(err) {
|
|
|
1197
1203
|
return void 0;
|
|
1198
1204
|
}
|
|
1199
1205
|
|
|
1206
|
+
// src/share.ts
|
|
1207
|
+
var DEFAULT_SHARE_TIMEOUT_MS = 15e4;
|
|
1208
|
+
var SHARE_ERROR_CODES = [
|
|
1209
|
+
"REQUEST_INVALID",
|
|
1210
|
+
"FILE_EMPTY",
|
|
1211
|
+
"RECIPIENT_REQUIRED",
|
|
1212
|
+
"TOO_MANY_RECIPIENTS",
|
|
1213
|
+
"RECIPIENT_INVALID",
|
|
1214
|
+
"RECIPIENT_DUPLICATE",
|
|
1215
|
+
"FILE_TOO_LARGE",
|
|
1216
|
+
"FILE_TYPE_NOT_SUPPORTED",
|
|
1217
|
+
"FILE_NOT_SIGNED",
|
|
1218
|
+
"RATE_LIMITED",
|
|
1219
|
+
"MAIL_FAILED",
|
|
1220
|
+
"SHARE_DISABLED",
|
|
1221
|
+
"MAIL_UNAVAILABLE",
|
|
1222
|
+
"VALIDATOR_UNAVAILABLE",
|
|
1223
|
+
"VALIDATOR_BUSY"
|
|
1224
|
+
];
|
|
1225
|
+
var ShareError = class extends ApiError {
|
|
1226
|
+
/** 422 FILE_NOT_SIGNED: no_signature | invalid | untrusted. */
|
|
1227
|
+
reason;
|
|
1228
|
+
/** 502 MAIL_FAILED: амжилттай илгээсэн тоо. */
|
|
1229
|
+
sent;
|
|
1230
|
+
/** 502 MAIL_FAILED: амжилтгүй тоо. */
|
|
1231
|
+
failed;
|
|
1232
|
+
/**
|
|
1233
|
+
* 502 MAIL_FAILED: `to`-гийн дарааллаар `"sent"` | `"failed"`. Зөвхөн `failed`-ийг дахин илгээ (амжилттайг дахин
|
|
1234
|
+
* бүү илгээ).
|
|
1235
|
+
*/
|
|
1236
|
+
recipients;
|
|
1237
|
+
constructor(status, body, code, init) {
|
|
1238
|
+
super(status, body, code, init);
|
|
1239
|
+
const o = parseObject(body);
|
|
1240
|
+
if (typeof o.reason === "string") this.reason = o.reason;
|
|
1241
|
+
if (typeof o.sent === "number") this.sent = o.sent;
|
|
1242
|
+
if (typeof o.failed === "number") this.failed = o.failed;
|
|
1243
|
+
if (Array.isArray(o.recipients)) this.recipients = o.recipients.map(String);
|
|
1244
|
+
}
|
|
1245
|
+
};
|
|
1246
|
+
var DISCOVERY_PATH = "/.well-known/eid";
|
|
1247
|
+
function parseObject(text) {
|
|
1248
|
+
try {
|
|
1249
|
+
const v = JSON.parse(text);
|
|
1250
|
+
return v && typeof v === "object" ? v : {};
|
|
1251
|
+
} catch {
|
|
1252
|
+
return {};
|
|
1253
|
+
}
|
|
1254
|
+
}
|
|
1255
|
+
async function shareFile(http, input) {
|
|
1256
|
+
const to = typeof input.to === "string" ? [input.to] : [...input.to];
|
|
1257
|
+
const blob = input.file instanceof Blob ? input.file : new Blob([new Uint8Array(input.file)], { type: "application/pdf" });
|
|
1258
|
+
const filename = input.filename ?? input.file.name ?? "document.pdf";
|
|
1259
|
+
const form = new FormData();
|
|
1260
|
+
for (const a of to) form.append("to", a);
|
|
1261
|
+
if (input.subject !== void 0) form.append("subject", input.subject);
|
|
1262
|
+
if (input.message !== void 0) form.append("message", input.message);
|
|
1263
|
+
if (input.lang !== void 0) form.append("lang", input.lang);
|
|
1264
|
+
if (input.filename !== void 0) form.append("filename", input.filename);
|
|
1265
|
+
form.append("file", blob.type ? blob : new Blob([blob], { type: "application/pdf" }), filename || "document.pdf");
|
|
1266
|
+
let raw;
|
|
1267
|
+
try {
|
|
1268
|
+
raw = await http.postForm(RP_ROUTES.share.path, form, input.timeoutMs ?? DEFAULT_SHARE_TIMEOUT_MS);
|
|
1269
|
+
} catch (e) {
|
|
1270
|
+
if (e instanceof ApiError && !(e instanceof ShareError)) {
|
|
1271
|
+
throw new ShareError(e.status, e.body, e.code, { headers: e.headers, retryAfterMs: e.retryAfterMs });
|
|
1272
|
+
}
|
|
1273
|
+
throw e;
|
|
1274
|
+
}
|
|
1275
|
+
const o = raw && typeof raw === "object" ? raw : {};
|
|
1276
|
+
return {
|
|
1277
|
+
sent: Number(o.sent ?? 0),
|
|
1278
|
+
sha256: String(o.sha256 ?? ""),
|
|
1279
|
+
signatures: Number(o.signatures ?? 0),
|
|
1280
|
+
...typeof o.docID === "string" && o.docID ? { docID: o.docID } : {},
|
|
1281
|
+
raw
|
|
1282
|
+
};
|
|
1283
|
+
}
|
|
1284
|
+
async function shareInfo(http) {
|
|
1285
|
+
const d = await http.get(DISCOVERY_PATH);
|
|
1286
|
+
const s = d.share && typeof d.share === "object" ? d.share : {};
|
|
1287
|
+
const q = s.quota && typeof s.quota === "object" ? s.quota : {};
|
|
1288
|
+
return {
|
|
1289
|
+
enabled: s.enabled === true,
|
|
1290
|
+
endpoint: String(s.endpoint ?? ""),
|
|
1291
|
+
formats: Array.isArray(s.formats) ? s.formats : [],
|
|
1292
|
+
languages: Array.isArray(s.languages) ? s.languages.map(String) : [],
|
|
1293
|
+
maxFileBytes: Number(s.maxFileBytes ?? 0),
|
|
1294
|
+
maxFilenameChars: Number(s.maxFilenameChars ?? 0),
|
|
1295
|
+
maxMessageChars: Number(s.maxMessageChars ?? 0),
|
|
1296
|
+
maxRecipients: Number(s.maxRecipients ?? 0),
|
|
1297
|
+
maxSubjectChars: Number(s.maxSubjectChars ?? 0),
|
|
1298
|
+
permission: String(s.permission ?? ""),
|
|
1299
|
+
quota: {
|
|
1300
|
+
perRPHour: Number(q.perRPHour ?? 0),
|
|
1301
|
+
perRPDay: Number(q.perRPDay ?? 0),
|
|
1302
|
+
perRecipientDay: Number(q.perRecipientDay ?? 0)
|
|
1303
|
+
},
|
|
1304
|
+
requiresValidSignature: s.requiresValidSignature === true,
|
|
1305
|
+
raw: d.share
|
|
1306
|
+
};
|
|
1307
|
+
}
|
|
1308
|
+
|
|
1200
1309
|
// src/validator.ts
|
|
1201
1310
|
import { X509Certificate as X509Certificate3, constants, createHash as createHash3, publicDecrypt, verify } from "crypto";
|
|
1202
1311
|
var CITIZEN_ISSUING_CA_SKI = "b8a37f2c64ad677912db7d9e34f246358a2fb909";
|
|
@@ -1802,6 +1911,7 @@ var EidClient = class {
|
|
|
1802
1911
|
validator;
|
|
1803
1912
|
/** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
|
|
1804
1913
|
rpName;
|
|
1914
|
+
http;
|
|
1805
1915
|
constructor(cfg) {
|
|
1806
1916
|
if (!cfg.credentials?.apiSecret) throw new Error("EidClient: credentials.apiSecret \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
|
|
1807
1917
|
const base = resolveBaseUrl(cfg.baseUrl);
|
|
@@ -1822,6 +1932,7 @@ var EidClient = class {
|
|
|
1822
1932
|
this.session = new SessionApi(http);
|
|
1823
1933
|
this.validator = new ResponseValidator(cfg.trust ?? {});
|
|
1824
1934
|
this.rpName = cfg.credentials.rpName;
|
|
1935
|
+
this.http = http;
|
|
1825
1936
|
}
|
|
1826
1937
|
/** {@link SignApi.pdfDigest} — клиент талын PAdES-ийн DTBS-д гарын үсгийн session (PDF CA руу очихгүй). */
|
|
1827
1938
|
signPdfDigest(input) {
|
|
@@ -1831,6 +1942,19 @@ var EidClient = class {
|
|
|
1831
1942
|
registerSignature(input) {
|
|
1832
1943
|
return this.sign.registerSignature(input);
|
|
1833
1944
|
}
|
|
1945
|
+
/**
|
|
1946
|
+
* `POST /share` (SIGN эрх) — гарын үсэгтэй файлыг (PDF, eID-ийн хүчинтэй гарын үсэгтэй) 1–5 хүлээн авагч руу
|
|
1947
|
+
* имэйлээр, хавсралтаар илгээнэ; CA файлыг хадгалахгүй. Алдаа: `ShareError` (`code`, 422-д `reason`, 502-д
|
|
1948
|
+
* `sent`/`failed`/`recipients`), 401 AuthenticationError, 403 ForbiddenError. CA-ийн туг унтраалттай бол 503
|
|
1949
|
+
* SHARE_DISABLED — {@link shareInfo}-оор урьдчилан шалга.
|
|
1950
|
+
*/
|
|
1951
|
+
share(input) {
|
|
1952
|
+
return shareFile(this.http, input);
|
|
1953
|
+
}
|
|
1954
|
+
/** Discovery (`/.well-known/eid`)-ийн `share` блок: `enabled`, формат, хязгаар, квот. */
|
|
1955
|
+
shareInfo() {
|
|
1956
|
+
return shareInfo(this.http);
|
|
1957
|
+
}
|
|
1834
1958
|
};
|
|
1835
1959
|
|
|
1836
1960
|
// src/ocsp.ts
|
|
@@ -2536,6 +2660,7 @@ export {
|
|
|
2536
2660
|
CITIZEN_ISSUING_CA_SKI,
|
|
2537
2661
|
CertChoiceInvalidError,
|
|
2538
2662
|
DEFAULT_BASE_URL,
|
|
2663
|
+
DEFAULT_SHARE_TIMEOUT_MS,
|
|
2539
2664
|
DEFAULT_SIGN_SESSION_TTL_MS,
|
|
2540
2665
|
DeviceLinkError,
|
|
2541
2666
|
EidClient,
|
|
@@ -2552,8 +2677,11 @@ export {
|
|
|
2552
2677
|
RequestInvalidError,
|
|
2553
2678
|
ResponseTooLargeError,
|
|
2554
2679
|
ResponseValidator,
|
|
2680
|
+
SHARE_ERROR_CODES,
|
|
2681
|
+
SHARE_FORM_FIELDS,
|
|
2555
2682
|
SessionApi,
|
|
2556
2683
|
SessionFailedError,
|
|
2684
|
+
ShareError,
|
|
2557
2685
|
SignApi,
|
|
2558
2686
|
TokenApi,
|
|
2559
2687
|
ValidationError,
|
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.0",
|
|
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",
|