@gerege-systems/eid-mongolia-sdk 0.22.0 → 0.24.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/dist/index.js CHANGED
@@ -13,6 +13,7 @@ import {
13
13
  } from "./chunk-ISTWNY6N.js";
14
14
  import {
15
15
  ApiError,
16
+ AppTransactionTooLargeError,
16
17
  AuthenticationError,
17
18
  CertChoiceInvalidError,
18
19
  DeviceLinkError,
@@ -29,7 +30,7 @@ import {
29
30
  ValidationError,
30
31
  maskPath,
31
32
  parseRetryAfter
32
- } from "./chunk-ZB7LEWA5.js";
33
+ } from "./chunk-H7JOACAZ.js";
33
34
 
34
35
  // src/http.ts
35
36
  var DEFAULT_TIMEOUT_MS = 15e3;
@@ -326,6 +327,15 @@ var AuthApi = class {
326
327
  ...expiresAt !== void 0 ? { expiresAt } : {}
327
328
  };
328
329
  }
330
+ /**
331
+ * Discovery (`/.well-known/eid`)-ийн `sessionTtl` — CA-ийн нэвтрэлт / гарын үсгийн session-ий хугацаа (мс; CA-ийн
332
+ * «Системийн тохиргоо»-оос амьд). Хуучин CA-д (талбар алга) 0.
333
+ */
334
+ async sessionTtl() {
335
+ const t = rec(rec(await this.http.get("/.well-known/eid")).sessionTtl);
336
+ const ms2 = (v) => typeof v === "number" && Number.isFinite(v) && v > 0 ? Math.floor(v) * 1e3 : 0;
337
+ return { authMs: ms2(t.auth), signMs: ms2(t.sign) };
338
+ }
329
339
  /** Push — РД/иргэний дугаар/ETSI-ээр (сервер төрлийг таьна). Иргэний утас руу мэдэгдэл очно. */
330
340
  async notificationByEtsi(id, interactions, opts) {
331
341
  const { body, acsp } = this.baseBody(randomChallenge(), interactions, ["Notification"], opts);
@@ -1668,6 +1678,8 @@ function basicConstraintsPathLen(cert) {
1668
1678
  }
1669
1679
 
1670
1680
  // src/token.ts
1681
+ var MAX_APP_TRANSACTION_BYTES = 16 * 1024;
1682
+ var APP_ATTESTATION_INVALID = "APP_ATTESTATION_INVALID";
1671
1683
  function rec4(v) {
1672
1684
  return v && typeof v === "object" ? v : {};
1673
1685
  }
@@ -1676,6 +1688,9 @@ function hexSha256Equal(hex, data) {
1676
1688
  return timingSafeEqual(createHash3("sha256").update(data).digest(), Buffer.from(hex, "hex"));
1677
1689
  }
1678
1690
  var TOKEN_CONFLICT_CODES = ["TOKEN_LIMIT_REACHED", "TOKEN_IN_USE", "TOKEN_SCOPE_CHANGE", "ACCOUNT_DELETE_PENDING"];
1691
+ function supersedesOf(v) {
1692
+ return Array.isArray(v) ? { supersedes: v.map((x) => ({ tokenSerial: String(rec4(x).tokenSerial ?? "") })) } : {};
1693
+ }
1679
1694
  var DISCOVERY_PATH = "/.well-known/eid";
1680
1695
  var TOKEN_RESULT_TIMEOUT_MS = 3e4;
1681
1696
  var TokenApi = class {
@@ -1695,11 +1710,44 @@ var TokenApi = class {
1695
1710
  * байгууллагын токен зөвхөн тэр байгууллагаар (`onBehalfOf` ижил), хувийн токен зөвхөн хувиараа. Өөр scope бол
1696
1711
  * 409 `TOKEN_SCOPE_CHANGE` (override үгүй); scope солих = иргэн eID апп-аас токеноо цуцлаад шинээр олгуулна.
1697
1712
  * Бусад 409: `TOKEN_LIMIT_REACHED` ({@link tokenLimitOf}), `TOKEN_IN_USE` ({@link TokenConflictCode}).
1713
+ * 400 {@link APP_ATTESTATION_INVALID} — `appTransaction` хүчингүй; {@link MAX_APP_TRANSACTION_BYTES}-аас их бол
1714
+ * {@link AppTransactionTooLargeError} (илгээхгүй).
1698
1715
  */
1699
1716
  async issueCertificate(input) {
1717
+ const r = rec4(await this.http.post(routePath(RP_ROUTES.tokenCertificate), this.certBody(input)));
1718
+ if (!hexSha256Equal(r.csrAuthSha256, input.csrAuth) || !hexSha256Equal(r.csrSignSha256, input.csrSign)) {
1719
+ throw new ValidationError("token: CA-\u0438\u0439\u043D csrAuthSha256/csrSignSha256 \u0438\u043B\u0433\u044D\u044D\u0441\u044D\u043D CSR-\u0442\u044D\u0439 \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
1720
+ }
1721
+ const vc = rec4(r.vc).value ?? (typeof r.vc === "string" ? r.vc : void 0);
1722
+ return {
1723
+ sessionId: String(r.sessionID ?? ""),
1724
+ vc: vc != null ? String(vc) : null,
1725
+ csrAuthSha256: String(r.csrAuthSha256).toLowerCase(),
1726
+ csrSignSha256: String(r.csrSignSha256).toLowerCase(),
1727
+ ...typeof r.expiresAt === "string" ? { expiresAt: r.expiresAt } : {},
1728
+ ...supersedesOf(r.supersedes)
1729
+ };
1730
+ }
1731
+ /**
1732
+ * POST /token/certificate `{"dryRun": true}` (CA 2026-10-19, discovery `tokenCertificate.dryRun`): {@link issueCertificate}-ийн
1733
+ * бүх шалгалт ижил алдааны кодтой, гэхдээ session / утас руу push үүсэхгүй. Урсгал: CSR → previewCertificate →
1734
+ * `supersedes` байвал иргэнд анхааруулж зөвшөөрүүлэх → issueCertificate (ижил оролт). Хурдны хязгаар (RP, иргэн) 20/мин
1735
+ * (push-ийн 3/цагийг зарцуулахгүй). Хариунд `dryRun: true` алга бол ValidationError. Хуучин CA-д 400 (танихгүй талбар).
1736
+ */
1737
+ async previewCertificate(input) {
1738
+ const r = rec4(await this.http.post(routePath(RP_ROUTES.tokenCertificate), { ...this.certBody(input), dryRun: true }));
1739
+ if (r.dryRun !== true) throw new ValidationError("token: dryRun \u0445\u0430\u0440\u0438\u0443 \u0431\u0438\u0448 (CA dryRun-\u0438\u0439\u0433 \u0434\u044D\u043C\u0436\u0438\u0445\u0433\u04AF\u0439)");
1740
+ return { ...supersedesOf(r.supersedes) };
1741
+ }
1742
+ /** Оролтыг шалгаж POST /token/certificate-ийн биеийг угсарна. CA DisallowUnknownFields — яг эдгээр талбар. */
1743
+ certBody(input) {
1700
1744
  if (!input.signerEtsi?.trim() || !input.csrAuth?.length || !input.csrSign?.length || !input.tokenSerial?.trim()) {
1701
1745
  throw new Error("token: signerEtsi, csrAuth, csrSign, tokenSerial \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
1702
1746
  }
1747
+ const appTransaction = input.appTransaction?.trim() ?? "";
1748
+ if (Buffer.byteLength(input.appTransaction ?? "", "utf8") > MAX_APP_TRANSACTION_BYTES) {
1749
+ throw new AppTransactionTooLargeError("token: appTransaction 16 KiB-\u0430\u0430\u0441 \u0438\u0445");
1750
+ }
1703
1751
  const body = {
1704
1752
  relyingPartyUUID: this.creds.rpUUID,
1705
1753
  relyingPartyName: this.creds.rpName,
@@ -1711,18 +1759,8 @@ var TokenApi = class {
1711
1759
  flow: "notification"
1712
1760
  };
1713
1761
  if (input.tokenLabel) body.tokenLabel = input.tokenLabel;
1714
- const r = rec4(await this.http.post(routePath(RP_ROUTES.tokenCertificate), body));
1715
- if (!hexSha256Equal(r.csrAuthSha256, input.csrAuth) || !hexSha256Equal(r.csrSignSha256, input.csrSign)) {
1716
- throw new ValidationError("token: CA-\u0438\u0439\u043D csrAuthSha256/csrSignSha256 \u0438\u043B\u0433\u044D\u044D\u0441\u044D\u043D CSR-\u0442\u044D\u0439 \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
1717
- }
1718
- const vc = rec4(r.vc).value ?? (typeof r.vc === "string" ? r.vc : void 0);
1719
- return {
1720
- sessionId: String(r.sessionID ?? ""),
1721
- vc: vc != null ? String(vc) : null,
1722
- csrAuthSha256: String(r.csrAuthSha256).toLowerCase(),
1723
- csrSignSha256: String(r.csrSignSha256).toLowerCase(),
1724
- ...typeof r.expiresAt === "string" ? { expiresAt: r.expiresAt } : {}
1725
- };
1762
+ if (appTransaction) body.appTransaction = appTransaction;
1763
+ return body;
1726
1764
  }
1727
1765
  /** Discovery-ийн `tokenCertificate` блок. Блок байхгүй (хуучин CA) бол `enabled: false`. */
1728
1766
  async certificateInfo() {
@@ -1737,6 +1775,9 @@ var TokenApi = class {
1737
1775
  keyAlgorithm: String(t.keyAlgorithm ?? ""),
1738
1776
  onBehalfOf: String(t.onBehalfOf ?? ""),
1739
1777
  scopeLockedOnRenewal: t.scopeLockedOnRenewal === true,
1778
+ appTransaction: String(t.appTransaction ?? ""),
1779
+ personalAutoSupersede: t.personalAutoSupersede === true,
1780
+ dryRun: t.dryRun === true,
1740
1781
  raw: d.tokenCertificate
1741
1782
  };
1742
1783
  }
@@ -2472,6 +2513,38 @@ function createEidLogin(opts) {
2472
2513
  const revocation = opts.revocation === false ? void 0 : opts.revocation ?? ocspRevocationChecker();
2473
2514
  const revocationMode = opts.revocationMode ?? "soft-fail";
2474
2515
  const auditKey = opts.auditKey ?? randomBytes2(32);
2516
+ let caTtl = 0;
2517
+ let caTtlNext = 0;
2518
+ let caTtlInflight;
2519
+ function authTtl(ctx) {
2520
+ if (Date.now() < caTtlNext) return Promise.resolve(caTtl);
2521
+ caTtlInflight ??= (async () => {
2522
+ caTtlNext = Date.now() + 6e4;
2523
+ let timer;
2524
+ try {
2525
+ const t = await Promise.race([
2526
+ client.auth.sessionTtl(),
2527
+ new Promise((_, rej) => {
2528
+ timer = setTimeout(() => rej(new Error("discovery timeout")), 2e3);
2529
+ })
2530
+ ]);
2531
+ caTtlNext = Date.now() + 6e5;
2532
+ if (t.authMs > 0) caTtl = t.authMs;
2533
+ } catch (e) {
2534
+ onError(new Error(`eid-login: discovery sessionTtl: ${e instanceof Error ? e.message : e}`), ctx);
2535
+ } finally {
2536
+ clearTimeout(timer);
2537
+ caTtlInflight = void 0;
2538
+ }
2539
+ return caTtl;
2540
+ })();
2541
+ return caTtlInflight;
2542
+ }
2543
+ function observeAuthTtl(sent, expiresAt) {
2544
+ if (expiresAt === void 0 || caTtl > 0) return;
2545
+ const d = Math.round((expiresAt - sent) / 1e3) * 1e3;
2546
+ if (d > 0) caTtl = d;
2547
+ }
2475
2548
  const pushKey = (idCode) => createHmac2("sha256", auditKey).update(`eid-push-audit:${idCode}`).digest("hex").slice(0, 32);
2476
2549
  async function emit(kind, sessionId, meta, ctx) {
2477
2550
  if (!opts.onEvent) return;
@@ -2546,17 +2619,20 @@ function createEidLogin(opts) {
2546
2619
  interactions: tx.acsp.interactions
2547
2620
  });
2548
2621
  }
2549
- async function begin(req, mode, idCode, lang) {
2622
+ async function begin(req, mode, idCode, lang, ttlMs) {
2623
+ const sent = Date.now();
2550
2624
  const level = opts.certificateLevel ? { certificateLevel: opts.certificateLevel } : {};
2551
2625
  let tx;
2552
2626
  let appLink;
2553
2627
  if (mode === "push") {
2554
2628
  const s = await client.auth.notificationByEtsi(idCode, interactions, level);
2555
2629
  tx = { sessionId: s.sessionId, mode, vc: s.vc, acsp: s.acsp };
2630
+ observeAuthTtl(sent, s.expiresAt);
2556
2631
  } else {
2557
2632
  const callbackUrl = mode === "web2app" ? withReturnHint(opts.callbackUrl, header(req.headers, "user-agent")) : void 0;
2558
2633
  const s = await client.auth.deviceLinkAnonymous(interactions, { ...level, callbackUrl });
2559
2634
  if (!s.deviceLinkBase || !s.sessionToken || !s.sessionSecret || !s.acsp) throw new Error("eID \u0445\u0430\u0440\u0438\u0443\u043D\u0434 device link \u0442\u0430\u043B\u0431\u0430\u0440 \u0434\u0443\u0442\u0443\u0443");
2635
+ if (s.expiresAt !== void 0) ttlMs = Math.min(ttlMs, Math.floor((s.expiresAt - Date.now()) / 1e3) * 1e3);
2560
2636
  tx = {
2561
2637
  sessionId: s.sessionId,
2562
2638
  mode,
@@ -2579,18 +2655,20 @@ function createEidLogin(opts) {
2579
2655
  });
2580
2656
  }
2581
2657
  }
2582
- return { ...await save(tx), appLink };
2658
+ if (ttlMs < 1e3) throw new Error("eID session-\u0438\u0439 \u0445\u0443\u0433\u0430\u0446\u0430\u0430 \u0434\u0443\u0443\u0441\u0441\u0430\u043D (expiresAt)");
2659
+ return { ...await save(tx, ttlMs), appLink };
2583
2660
  }
2584
- async function save(tx) {
2661
+ async function save(tx, ttlMs) {
2585
2662
  const binding = randomBytes2(32).toString("base64url");
2586
- const full = { ...tx, bindingHash: sha256hex(binding), expiresAt: Date.now() + ttl };
2587
- await store.set(full.sessionId, full, ttl);
2588
- const setCookie = `${cookieName}=${full.sessionId}.${binding}; ${cookieAttrs(Math.ceil(ttl / 1e3))}`;
2589
- return { tx: full, setCookie, appLink: void 0 };
2663
+ const full = { ...tx, bindingHash: sha256hex(binding), expiresAt: Date.now() + ttlMs };
2664
+ await store.set(full.sessionId, full, ttlMs);
2665
+ const expiresIn = Math.ceil(ttlMs / 1e3);
2666
+ const setCookie = `${cookieName}=${full.sessionId}.${binding}; ${cookieAttrs(expiresIn)}`;
2667
+ return { tx: full, setCookie, expiresIn, appLink: void 0 };
2590
2668
  }
2591
- function startDecoy() {
2669
+ function startDecoy(ttlMs) {
2592
2670
  const acsp = void 0;
2593
- return save({ sessionId: randomUUID(), mode: "push", vc: String(randomInt(1e5)).padStart(5, "0"), acsp, decoy: true });
2671
+ return save({ sessionId: randomUUID(), mode: "push", vc: String(randomInt(1e5)).padStart(5, "0"), acsp, decoy: true }, ttlMs);
2594
2672
  }
2595
2673
  async function start(req) {
2596
2674
  const url = new URL(req.url, "http://x");
@@ -2628,11 +2706,16 @@ function createEidLogin(opts) {
2628
2706
  if (ip && !await rateLimit(`start:${ip}`)) return limited();
2629
2707
  if (mode === "push" && !await rateLimit(`push:${idCode}`)) return limited();
2630
2708
  const began = Date.now();
2709
+ let ttlMs = ttl;
2710
+ if (mode === "push") {
2711
+ const ca = await authTtl(ctx);
2712
+ if (ca > 0) ttlMs = Math.min(ttlMs, ca);
2713
+ }
2631
2714
  let r;
2632
2715
  let err;
2633
2716
  let decoy = false;
2634
2717
  try {
2635
- r = await begin(req, mode, idCode, lang);
2718
+ r = await begin(req, mode, idCode, lang, ttlMs);
2636
2719
  } catch (e) {
2637
2720
  err = e;
2638
2721
  }
@@ -2641,7 +2724,7 @@ function createEidLogin(opts) {
2641
2724
  onError(new Error(`eid-login: eID push-\u0438\u0439\u0433 \u0442\u0430\u0442\u0433\u0430\u043B\u0437\u0430\u0432 (${ae.status}${ae.code ? ` ${ae.code}` : ""}); decoy session-\u043E\u043E\u0440 \u0445\u0430\u0440\u0438\u0443\u043B\u0430\u0432`), ctx);
2642
2725
  err = void 0;
2643
2726
  try {
2644
- r = await startDecoy();
2727
+ r = await startDecoy(ttlMs);
2645
2728
  decoy = true;
2646
2729
  } catch (e) {
2647
2730
  err = e;
@@ -2660,7 +2743,7 @@ function createEidLogin(opts) {
2660
2743
  }
2661
2744
  return json(
2662
2745
  200,
2663
- { mode, vc: r.tx.vc, ...mode === "qr" ? { qr: qrLink(r.tx) } : {}, expiresIn: Math.ceil(ttl / 1e3) },
2746
+ { mode, vc: r.tx.vc, ...mode === "qr" ? { qr: qrLink(r.tx) } : {}, expiresIn: r.expiresIn },
2664
2747
  { "Set-Cookie": r.setCookie }
2665
2748
  );
2666
2749
  }
@@ -2796,7 +2879,9 @@ function createEidLogin(opts) {
2796
2879
  return { handleRequest, handle };
2797
2880
  }
2798
2881
  export {
2882
+ APP_ATTESTATION_INVALID,
2799
2883
  ApiError,
2884
+ AppTransactionTooLargeError,
2800
2885
  AuthApi,
2801
2886
  AuthenticationError,
2802
2887
  CITIZEN_INTERMEDIATES_PEM,
@@ -2812,6 +2897,7 @@ export {
2812
2897
  ForbiddenError,
2813
2898
  Http,
2814
2899
  LoginStoreFullError,
2900
+ MAX_APP_TRANSACTION_BYTES,
2815
2901
  MEMORY_LOGIN_STORE_MAX,
2816
2902
  NATIONAL_ROOT_CA_PEM,
2817
2903
  NetworkError,
package/dist/pades.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-xTmsGXyo.cjs';
1
+ import { E as EidError } from './errors-BM8D3VEw.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
package/dist/pades.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-xTmsGXyo.js';
1
+ import { E as EidError } from './errors-BM8D3VEw.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
package/dist/pades.js CHANGED
@@ -55,7 +55,7 @@ import {
55
55
  } from "./chunk-ISTWNY6N.js";
56
56
  import {
57
57
  EidError
58
- } from "./chunk-ZB7LEWA5.js";
58
+ } from "./chunk-H7JOACAZ.js";
59
59
 
60
60
  // src/pades/limits.ts
61
61
  var MAX_INPUT_BYTES = (10 << 20) - (256 << 10);
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-xTmsGXyo.cjs';
1
+ import { E as EidError } from './errors-BM8D3VEw.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-xTmsGXyo.js';
1
+ import { E as EidError } from './errors-BM8D3VEw.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
package/dist/validate.js CHANGED
@@ -64,7 +64,7 @@ import {
64
64
  } from "./chunk-ISTWNY6N.js";
65
65
  import {
66
66
  EidError
67
- } from "./chunk-ZB7LEWA5.js";
67
+ } from "./chunk-H7JOACAZ.js";
68
68
 
69
69
  // src/pades/validate/evaluate.ts
70
70
  var PROBLEMS = {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gerege-systems/eid-mongolia-sdk",
3
- "version": "0.22.0",
3
+ "version": "0.24.0",
4
4
  "description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
5
5
  "license": "MIT",
6
6
  "type": "module",