@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 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
- /** FAILED үед: endResult (USER_REFUSED, TIMEOUT …) эсвэл CSR_DIGEST_MISMATCH, TOKEN_LIMIT_REACHED г.м. */
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
- /** FAILED үед: endResult (USER_REFUSED, TIMEOUT …) эсвэл CSR_DIGEST_MISMATCH, TOKEN_LIMIT_REACHED г.м. */
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;
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, k as isMobileUserAgent } from './browser-DFnRVCfN.cjs';
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-BPhROZkH.js';
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-DFnRVCfN.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-DFnRVCfN.cjs';
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-BPhROZkH.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-BPhROZkH.js';
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.17.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",