@gerege-systems/eid-mongolia-sdk 0.31.0 → 0.33.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.cjs CHANGED
@@ -32,6 +32,10 @@ __export(index_exports, {
32
32
  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
33
33
  DEFAULT_MAX_WAIT_MS: () => DEFAULT_MAX_WAIT_MS,
34
34
  DEFAULT_PDF_TIMEOUT_MS: () => DEFAULT_PDF_TIMEOUT_MS,
35
+ DEFAULT_QR_ISSUER: () => DEFAULT_QR_ISSUER,
36
+ DEFAULT_QR_JWKS_CACHE_TTL_MS: () => DEFAULT_QR_JWKS_CACHE_TTL_MS,
37
+ DEFAULT_QR_JWKS_URL: () => DEFAULT_QR_JWKS_URL,
38
+ DEFAULT_QR_MAX_AGE_MS: () => DEFAULT_QR_MAX_AGE_MS,
35
39
  DEFAULT_SHARE_TIMEOUT_MS: () => DEFAULT_SHARE_TIMEOUT_MS,
36
40
  DEFAULT_SIGN_SESSION_TTL_MS: () => DEFAULT_SIGN_SESSION_TTL_MS,
37
41
  DeviceLinkError: () => DeviceLinkError,
@@ -52,6 +56,13 @@ __export(index_exports, {
52
56
  PDF_REGISTER_ERROR_CODES: () => PDF_REGISTER_ERROR_CODES,
53
57
  PDF_SIGNATURE_REGISTER_FIELDS: () => PDF_SIGNATURE_REGISTER_FIELDS,
54
58
  PersonApi: () => PersonApi,
59
+ QR_ATTRIBUTES: () => QR_ATTRIBUTES,
60
+ QR_CLOCK_SKEW_MS: () => QR_CLOCK_SKEW_MS,
61
+ QR_ERROR_CODES: () => QR_ERROR_CODES,
62
+ QR_PREFIX: () => QR_PREFIX,
63
+ QrApi: () => QrApi,
64
+ QrError: () => QrError,
65
+ QrTokenInvalidError: () => QrTokenInvalidError,
55
66
  RETRYABLE_ERROR_CODES: () => RETRYABLE_ERROR_CODES,
56
67
  RequestInvalidError: () => RequestInvalidError,
57
68
  ResponseTooLargeError: () => ResponseTooLargeError,
@@ -82,6 +93,7 @@ __export(index_exports, {
82
93
  memoryLoginStore: () => memoryLoginStore,
83
94
  ocspRevocationChecker: () => ocspRevocationChecker,
84
95
  parseExpiresAt: () => parseExpiresAt,
96
+ parseQr: () => parseQr,
85
97
  parseRetryAfter: () => parseRetryAfter,
86
98
  parseSessionResult: () => parseSessionResult,
87
99
  parseSubject: () => parseSubject,
@@ -98,6 +110,7 @@ __export(index_exports, {
98
110
  userChallengeOf: () => userChallengeOf,
99
111
  verifyPayloadSignature: () => verifyPayloadSignature,
100
112
  verifyPrehashedSignature: () => verifyPrehashedSignature,
113
+ verifyQrPresentation: () => verifyQrPresentation,
101
114
  verifyTokenCertificates: () => verifyTokenCertificates,
102
115
  withReturnHint: () => withReturnHint
103
116
  });
@@ -171,6 +184,8 @@ var CertChoiceInvalidError = class extends ApiError {
171
184
  };
172
185
  var RequestInvalidError = class extends ApiError {
173
186
  };
187
+ var QrTokenInvalidError = class extends ApiError {
188
+ };
174
189
  var RETRYABLE_ERROR_CODES = [
175
190
  "RATE_LIMITED",
176
191
  "STATE_UNAVAILABLE",
@@ -325,7 +340,7 @@ var Http = class {
325
340
  { headers, retryAfterMs }
326
341
  );
327
342
  }
328
- const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : ApiError;
343
+ const Typed = code === "NO_SIGNING_CERTIFICATE" ? NoSigningCertificateError : code === "CERT_CHOICE_INVALID" ? CertChoiceInvalidError : code === "REQUEST_INVALID" ? RequestInvalidError : code === "QR_TOKEN_INVALID" ? QrTokenInvalidError : ApiError;
329
344
  throw new Typed(res.status, text, code, { headers, retryAfterMs });
330
345
  }
331
346
  };
@@ -391,12 +406,15 @@ var RP_ROUTES = {
391
406
  personActivity: { method: "GET", path: "/rp/activity/etsi/{personEtsi}" },
392
407
  personSummary: { method: "GET", path: "/person/summary/etsi/{personEtsi}" },
393
408
  personChildren: { method: "GET", path: "/person/children/etsi/{personEtsi}" },
409
+ personSignatureImage: { method: "GET", path: "/person/etsi/{personEtsi}/signature-image" },
394
410
  tokenCertificate: { method: "POST", path: "/token/certificate" },
395
411
  tokenCertificateResult: { method: "GET", path: "/token/certificate/{sessionID}" },
396
412
  pdfSignatures: { method: "POST", path: "/pdf/signatures" },
397
413
  tokenAuthChallenge: { method: "POST", path: "/token/auth/challenge" },
398
414
  tokenAuthVerify: { method: "POST", path: "/token/auth/verify" },
399
- share: { method: "POST", path: "/share" }
415
+ share: { method: "POST", path: "/share" },
416
+ /** «Миний QR» (CA гэрээ v1, 2026-10-23). */
417
+ authQr: { method: "POST", path: "/authentication/qr" }
400
418
  };
401
419
  var PDF_SIGNATURE_REGISTER_FIELDS = [
402
420
  "docID",
@@ -998,6 +1016,7 @@ function parseSessionResult(raw) {
998
1016
  onBehalfOf: parseOrg(r.onBehalfOf),
999
1017
  person: parsePerson(r.person),
1000
1018
  tokenCertificate: parseTokenCert(r.tokenCertificate),
1019
+ presentation: parsePresentation(r.presentation),
1001
1020
  raw
1002
1021
  };
1003
1022
  }
@@ -1019,6 +1038,11 @@ function parsePerson(raw) {
1019
1038
  if (typeof p.geID === "number" && p.geID !== 0) out.geID = p.geID;
1020
1039
  return Object.keys(out).length ? out : null;
1021
1040
  }
1041
+ function parsePresentation(raw) {
1042
+ const p = asRecord(raw);
1043
+ if (typeof p.jws !== "string" || !p.jws) return null;
1044
+ return { jws: p.jws, ...p.claims && typeof p.claims === "object" ? { claims: p.claims } : {} };
1045
+ }
1022
1046
  function parseTokenCert(raw) {
1023
1047
  const t = asRecord(raw);
1024
1048
  const status = str(t.status);
@@ -1162,6 +1186,19 @@ var PersonApi = class {
1162
1186
  children(personEtsi) {
1163
1187
  return this.get(routePath(RP_ROUTES.personChildren, personEtsi));
1164
1188
  }
1189
+ /**
1190
+ * GET /person/etsi/{personEtsi}/signature-image — иргэний гарын үсгийн зураг (харагдах гарын үсэгт:
1191
+ * `appearance.signatureImage = img.pdfImage`). PKI_READ биш, **SIGN** эрх; иргэн сүүлийн 24 цагт танай RP-ээр
1192
+ * нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Иргэн зураг хадгалаагүй (404) бол `null`.
1193
+ */
1194
+ async signatureImage(personEtsi) {
1195
+ try {
1196
+ return rec3(await this.http.get(routePath(RP_ROUTES.personSignatureImage, personEtsi)));
1197
+ } catch (e) {
1198
+ if (e instanceof ApiError && e.status === 404) return null;
1199
+ throw e;
1200
+ }
1201
+ }
1165
1202
  };
1166
1203
 
1167
1204
  // src/token.ts
@@ -1618,9 +1655,9 @@ var ResponseValidator = class {
1618
1655
  ...this.intermediates.map((c) => [c, false])
1619
1656
  ]) {
1620
1657
  if (cas.includes(cand) || !signedBy(cur, cand)) continue;
1621
- const bad = caReason(cand, cas.length, now, usage);
1622
- if (bad) {
1623
- reason ??= bad;
1658
+ const bad2 = caReason(cand, cas.length, now, usage);
1659
+ if (bad2) {
1660
+ reason ??= bad2;
1624
1661
  continue;
1625
1662
  }
1626
1663
  if (isAnchor || extend(cand, [...cas, cand])) return true;
@@ -2257,6 +2294,318 @@ function tokenLimitOf(err) {
2257
2294
  return void 0;
2258
2295
  }
2259
2296
 
2297
+ // src/myqr.ts
2298
+ var import_node_crypto5 = require("crypto");
2299
+ var QR_ATTRIBUTES = ["age_over_18", "age_over_21", "full_name", "phone", "birth_date", "civil_id"];
2300
+ var QR_PREFIX = "EIDMN-QR1:";
2301
+ var DEFAULT_QR_ISSUER = "https://ca.eidmongolia.mn";
2302
+ var DEFAULT_QR_JWKS_URL = "https://ca.eidmongolia.mn/.well-known/eid-jwks.json";
2303
+ var DEFAULT_QR_JWKS_CACHE_TTL_MS = 36e5;
2304
+ var DEFAULT_QR_MAX_AGE_MS = 6e5;
2305
+ var QR_CLOCK_SKEW_MS = 6e4;
2306
+ var JWKS_MIN_REFRESH_MS = 3e4;
2307
+ var MAX_JWS = 16 << 10;
2308
+ var MAX_JWKS = 64 << 10;
2309
+ var QR_ERROR_CODES = [
2310
+ "QR_FORMAT_INVALID",
2311
+ "QR_TOKEN_INVALID",
2312
+ "QR_ATTRIBUTES_INVALID",
2313
+ "QR_PRESENTATION_INVALID",
2314
+ "QR_JWKS_UNAVAILABLE"
2315
+ ];
2316
+ var QrError = class extends EidError {
2317
+ constructor(code, reason) {
2318
+ super(`${code}: ${reason}`);
2319
+ this.code = code;
2320
+ this.reason = reason;
2321
+ }
2322
+ code;
2323
+ reason;
2324
+ };
2325
+ var bad = (reason) => new QrError("QR_PRESENTATION_INVALID", reason);
2326
+ var TOKEN_RE = /^[A-Za-z0-9_-]{43}$/;
2327
+ function parseQr(scanned) {
2328
+ let s = String(scanned ?? "").trim();
2329
+ if (s.startsWith(QR_PREFIX)) s = s.slice(QR_PREFIX.length);
2330
+ if (!TOKEN_RE.test(s)) throw new QrError("QR_FORMAT_INVALID", "eID \xAB\u041C\u0438\u043D\u0438\u0439 QR\xBB \u0431\u0438\u0448");
2331
+ return s;
2332
+ }
2333
+ function checkAttributes(attrs) {
2334
+ if (!attrs?.length) throw new QrError("QR_ATTRIBUTES_INVALID", "\u0430\u0442\u0442\u0440\u0438\u0431\u0443\u0442 \u0441\u043E\u043D\u0433\u043E\u043E\u0433\u04AF\u0439");
2335
+ const seen = /* @__PURE__ */ new Set();
2336
+ for (const a of attrs) {
2337
+ if (!QR_ATTRIBUTES.includes(a)) throw new QrError("QR_ATTRIBUTES_INVALID", `\u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0438\u0434 \u0430\u043B\u0433\u0430: ${a}`);
2338
+ if (seen.has(a)) throw new QrError("QR_ATTRIBUTES_INVALID", `\u0434\u0430\u0432\u0445\u0430\u0440\u0434\u0441\u0430\u043D: ${a}`);
2339
+ seen.add(a);
2340
+ }
2341
+ return [...attrs];
2342
+ }
2343
+ var UnknownKid = class extends Error {
2344
+ };
2345
+ var B64URL_RE = /^[A-Za-z0-9_-]*$/;
2346
+ function b64url(s) {
2347
+ if (!B64URL_RE.test(s) || s.length % 4 === 1) throw bad("base64url \u0431\u0443\u0440\u0443\u0443");
2348
+ return Buffer.from(s, "base64url");
2349
+ }
2350
+ function keyFor(jwks, kid) {
2351
+ const j = jwks?.keys?.find((k) => k?.kid === kid);
2352
+ if (!j) throw new UnknownKid();
2353
+ if (j.kty !== "EC" || j.crv !== "P-256" || j.alg && j.alg !== "ES256" || j.use && j.use !== "sig") {
2354
+ throw bad(`kid ${kid} \u043D\u044C ES256 P-256 \u0442\u04AF\u043B\u0445\u04AF\u04AF\u0440 \u0431\u0438\u0448`);
2355
+ }
2356
+ try {
2357
+ if (b64url(j.x ?? "").length !== 32 || b64url(j.y ?? "").length !== 32) throw new Error("x/y");
2358
+ return (0, import_node_crypto5.createPublicKey)({ key: { kty: "EC", crv: "P-256", x: j.x, y: j.y }, format: "jwk" });
2359
+ } catch {
2360
+ throw bad(`kid ${kid}: \u0442\u04AF\u043B\u0445\u04AF\u04AF\u0440 \u0431\u0443\u0440\u0443\u0443`);
2361
+ }
2362
+ }
2363
+ function isObj(v) {
2364
+ return !!v && typeof v === "object" && !Array.isArray(v);
2365
+ }
2366
+ var PHONE_RE = /^\+[1-9][0-9]{6,14}$/;
2367
+ var DATE_RE = /^([0-9]{4})-([0-9]{2})-([0-9]{2})$/;
2368
+ function validDate(s) {
2369
+ const m = DATE_RE.exec(s);
2370
+ if (!m) return false;
2371
+ const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
2372
+ const t = new Date(Date.UTC(y, mo - 1, d));
2373
+ return t.getUTCFullYear() === y && t.getUTCMonth() === mo - 1 && t.getUTCDate() === d;
2374
+ }
2375
+ function setAttr(out, name, v) {
2376
+ const wrong = () => bad(`${name}-\u0438\u0439\u043D \u0442\u04E9\u0440\u04E9\u043B \u0431\u0443\u0440\u0443\u0443`);
2377
+ switch (name) {
2378
+ case "age_over_18":
2379
+ case "age_over_21":
2380
+ if (typeof v !== "boolean") throw wrong();
2381
+ out[name] = v;
2382
+ return;
2383
+ case "full_name":
2384
+ if (!isObj(v) || typeof v.surname !== "string" || typeof v.givenName !== "string" || !v.givenName) throw wrong();
2385
+ out.full_name = { surname: v.surname, givenName: v.givenName };
2386
+ return;
2387
+ case "phone":
2388
+ if (typeof v !== "string" || !PHONE_RE.test(v)) throw wrong();
2389
+ out.phone = v;
2390
+ return;
2391
+ case "birth_date":
2392
+ if (typeof v !== "string" || !validDate(v)) throw wrong();
2393
+ out.birth_date = v;
2394
+ return;
2395
+ case "civil_id":
2396
+ if (typeof v !== "string" || !v) throw wrong();
2397
+ out.civil_id = v;
2398
+ return;
2399
+ }
2400
+ throw wrong();
2401
+ }
2402
+ function numericDate(v) {
2403
+ return typeof v === "number" && Number.isFinite(v) && v > 0 && v < 1e11 ? v * 1e3 : void 0;
2404
+ }
2405
+ function verifyInner(jws, jwks, exp) {
2406
+ if (typeof jws !== "string" || !jws || jws.length > MAX_JWS) throw bad("JWS \u0445\u043E\u043E\u0441\u043E\u043D \u044D\u0441\u0432\u044D\u043B \u0445\u044D\u0442 \u0443\u0440\u0442");
2407
+ const parts = jws.split(".");
2408
+ if (parts.length !== 3) throw bad("compact JWS \u0431\u0438\u0448");
2409
+ const [h64, p64, s64] = parts;
2410
+ const hb = b64url(h64);
2411
+ const pb = b64url(p64);
2412
+ const sig = b64url(s64);
2413
+ let hdr;
2414
+ try {
2415
+ hdr = JSON.parse(hb.toString("utf8"));
2416
+ } catch {
2417
+ throw bad("header JSON \u0431\u0438\u0448");
2418
+ }
2419
+ if (!isObj(hdr) || hdr.alg !== "ES256") throw bad("alg ES256 \u0431\u0438\u0448");
2420
+ if ("crit" in hdr) throw bad("crit \u0434\u044D\u043C\u0436\u0438\u0445\u0433\u04AF\u0439");
2421
+ if (typeof hdr.kid !== "string" || !hdr.kid) throw bad("kid \u0430\u043B\u0433\u0430");
2422
+ const key = keyFor(jwks, hdr.kid);
2423
+ if (sig.length !== 64) throw bad("ES256 \u0433\u0430\u0440\u044B\u043D \u04AF\u0441\u044D\u0433 64 \u0431\u0430\u0439\u0442 \u0431\u0438\u0448");
2424
+ const ok = (0, import_node_crypto5.verify)("sha256", Buffer.from(`${h64}.${p64}`, "ascii"), { key, dsaEncoding: "ieee-p1363" }, sig);
2425
+ if (!ok) throw bad("\u0433\u0430\u0440\u044B\u043D \u04AF\u0441\u044D\u0433 \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
2426
+ let c;
2427
+ try {
2428
+ c = JSON.parse(pb.toString("utf8"));
2429
+ } catch {
2430
+ throw bad("payload JSON \u0431\u0438\u0448");
2431
+ }
2432
+ if (!isObj(c)) throw bad("payload JSON \u043E\u0431\u044A\u0435\u043A\u0442 \u0431\u0438\u0448");
2433
+ if (c.iss !== (exp.issuer || DEFAULT_QR_ISSUER)) throw bad("iss \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
2434
+ if (!exp.audience || typeof c.aud !== "string" || c.aud.toLowerCase() !== exp.audience.toLowerCase()) throw bad("aud (RP UUID) \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
2435
+ if (!exp.sessionId || c.sid !== exp.sessionId) throw bad("sid \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
2436
+ if (!exp.nonce || c.nonce !== exp.nonce) throw bad("nonce \u0442\u0430\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439");
2437
+ if (typeof c.sub !== "string" || !c.sub) throw bad("sub \u0430\u043B\u0433\u0430");
2438
+ const now = exp.now ?? Date.now();
2439
+ const iat = numericDate(c.iat);
2440
+ if (iat === void 0) throw bad("iat \u0430\u043B\u0433\u0430");
2441
+ if (iat > now + QR_CLOCK_SKEW_MS) throw bad("iat \u0438\u0440\u044D\u044D\u0434\u04AF\u0439\u0434");
2442
+ if (now - iat > (exp.maxAgeMs && exp.maxAgeMs > 0 ? exp.maxAgeMs : DEFAULT_QR_MAX_AGE_MS)) throw bad("presentation \u0445\u0443\u0443\u0447\u0438\u0440\u0441\u0430\u043D");
2443
+ if ("exp" in c) {
2444
+ const e = numericDate(c.exp);
2445
+ if (e === void 0 || now >= e + QR_CLOCK_SKEW_MS) throw bad("exp \u0434\u0443\u0443\u0441\u0441\u0430\u043D");
2446
+ }
2447
+ const want = new Set(exp.attributes);
2448
+ const got = /* @__PURE__ */ new Set();
2449
+ let attrs = {};
2450
+ if ("attrs" in c) {
2451
+ if (!isObj(c.attrs)) throw bad("attrs \u043E\u0431\u044A\u0435\u043A\u0442 \u0431\u0438\u0448");
2452
+ attrs = c.attrs;
2453
+ }
2454
+ const out = { sub: c.sub, attrs: {}, unavailable: [], sessionId: exp.sessionId, issuedAt: iat, jws };
2455
+ for (const [name, v] of Object.entries(attrs)) {
2456
+ if (!want.has(name)) throw bad(`\u0445\u04AF\u0441\u044D\u044D\u0433\u04AF\u0439 \u0430\u0442\u0442\u0440\u0438\u0431\u0443\u0442: ${name}`);
2457
+ setAttr(out.attrs, name, v);
2458
+ got.add(name);
2459
+ }
2460
+ if ("unavailable" in c) {
2461
+ if (!Array.isArray(c.unavailable)) throw bad("unavailable \u043C\u0430\u0441\u0441\u0438\u0432 \u0431\u0438\u0448");
2462
+ for (const x of c.unavailable) {
2463
+ if (typeof x !== "string" || !want.has(x) || got.has(x)) throw bad(`unavailable \u0431\u0443\u0440\u0443\u0443: ${String(x)}`);
2464
+ got.add(x);
2465
+ out.unavailable.push(x);
2466
+ }
2467
+ }
2468
+ if (got.size !== want.size) throw bad("\u0445\u04AF\u0441\u0441\u044D\u043D \u0430\u0442\u0442\u0440\u0438\u0431\u0443\u0442\u044B\u043D \u0445\u0430\u0440\u0438\u0443 \u0434\u0443\u0442\u0443\u0443");
2469
+ return out;
2470
+ }
2471
+ function verifyQrPresentation(jws, jwks, expect2) {
2472
+ try {
2473
+ return verifyInner(jws, jwks, expect2);
2474
+ } catch (e) {
2475
+ if (e instanceof UnknownKid) throw bad("JWKS-\u0434 kid \u0430\u043B\u0433\u0430");
2476
+ throw e;
2477
+ }
2478
+ }
2479
+ var QrApi = class {
2480
+ constructor(d) {
2481
+ this.d = d;
2482
+ }
2483
+ d;
2484
+ jwks = null;
2485
+ fetchedAt = 0;
2486
+ lastAttempt = 0;
2487
+ inflight = null;
2488
+ /** {@link parseQr}. */
2489
+ parse(scanned) {
2490
+ return parseQr(scanned);
2491
+ }
2492
+ /**
2493
+ * `POST /authentication/qr` — QR-ийн токеныг (нэг удаагийн) CA-д өгч иргэний утас руу хүсэлт илгээнэ; `vc`-г кассын
2494
+ * дэлгэцэнд харуул. Алдаа: {@link QrError} (FORMAT / ATTRIBUTES — CA руу явахгүй), 404 {@link QrTokenInvalidError}
2495
+ * (шинэ QR гаргуул), 403 ForbiddenError (QR_PRESENT / QR_ATTR:* эрх алга).
2496
+ */
2497
+ async start(input) {
2498
+ const token = parseQr(input.qr);
2499
+ const attributes = checkAttributes(input.attributes);
2500
+ const rpChallenge = randomChallenge(32);
2501
+ const nonce = input.nonce?.trim() || void 0;
2502
+ const body = {
2503
+ qr: QR_PREFIX + token,
2504
+ attributes,
2505
+ relyingPartyUUID: this.d.credentials.rpUUID,
2506
+ relyingPartyName: this.d.credentials.rpName,
2507
+ signatureProtocol: "ACSP_V2",
2508
+ signatureProtocolParameters: { rpChallenge },
2509
+ ...nonce ? { nonce } : {}
2510
+ };
2511
+ const r = await this.d.http.post(routePath(RP_ROUTES.authQr), body);
2512
+ const sessionId = typeof r.sessionID === "string" ? r.sessionID : "";
2513
+ if (!sessionId) throw new EidError("POST /authentication/qr: sessionID \u0430\u043B\u0433\u0430");
2514
+ const vcRaw = r.vc;
2515
+ const vc = typeof vcRaw === "string" ? vcRaw : isObj(vcRaw) && vcRaw.value != null ? String(vcRaw.value) : "";
2516
+ const expiresAt = parseExpiresAt(r.expiresAt);
2517
+ return { sessionId, vc, nonce: nonce ?? rpChallenge, attributes, ...expiresAt !== void 0 ? { expiresAt } : {} };
2518
+ }
2519
+ /**
2520
+ * Session дуустал long-poll хийж presentation-ийг CA-ийн JWKS-ээр шалгана. Татгалзсан / хугацаа дууссан бол
2521
+ * SessionFailedError (`USER_REFUSED`, `TIMEOUT` г.м.); шалгалт унавал {@link QrError} `QR_PRESENTATION_INVALID`;
2522
+ * JWKS татагдахгүй бол `QR_JWKS_UNAVAILABLE` (дахин оролдож болно).
2523
+ */
2524
+ async result(session, opts) {
2525
+ if (!session?.sessionId) throw new EidError("qr.result: QrSession \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
2526
+ const r = await this.d.session.waitForResult(session.sessionId, { expiresAt: session.expiresAt, ...opts });
2527
+ if (r.state !== "COMPLETE") throw new SessionFailedError("TIMEOUT");
2528
+ if (r.endResult !== "OK") throw new SessionFailedError(r.endResult ?? "UNKNOWN");
2529
+ const jws = r.presentation?.jws;
2530
+ if (!jws) throw bad("\u0445\u0430\u0440\u0438\u0443\u043D\u0434 presentation \u0430\u043B\u0433\u0430");
2531
+ return this.verify(jws, session);
2532
+ }
2533
+ /** Хадгалсан presentation JWS-ийг QrSession-тэй тулгаж шалгана (JWKS кэш; танихгүй kid → нэг удаа дахин татна). */
2534
+ async verify(jws, session) {
2535
+ const cfg = this.d.config ?? {};
2536
+ const exp = {
2537
+ issuer: cfg.issuer,
2538
+ audience: this.d.credentials.rpUUID,
2539
+ sessionId: session.sessionId,
2540
+ nonce: session.nonce,
2541
+ attributes: session.attributes,
2542
+ maxAgeMs: cfg.maxAgeMs
2543
+ };
2544
+ try {
2545
+ return verifyInner(jws, await this.keys(false), exp);
2546
+ } catch (e) {
2547
+ if (!(e instanceof UnknownKid)) throw e;
2548
+ }
2549
+ return verifyQrPresentation(jws, await this.keys(true), exp);
2550
+ }
2551
+ async keys(force) {
2552
+ const ttl = this.d.config?.jwksCacheTtlMs && this.d.config.jwksCacheTtlMs > 0 ? this.d.config.jwksCacheTtlMs : DEFAULT_QR_JWKS_CACHE_TTL_MS;
2553
+ const now = Date.now();
2554
+ const fresh = this.jwks && now - this.fetchedAt < ttl;
2555
+ if (fresh && (!force || now - this.lastAttempt < JWKS_MIN_REFRESH_MS)) return this.jwks;
2556
+ if (!this.inflight) {
2557
+ this.lastAttempt = now;
2558
+ this.inflight = this.fetchJwks().then((k) => {
2559
+ this.jwks = k;
2560
+ this.fetchedAt = Date.now();
2561
+ return k;
2562
+ }).finally(() => {
2563
+ this.inflight = null;
2564
+ });
2565
+ }
2566
+ return this.inflight;
2567
+ }
2568
+ async fetchJwks() {
2569
+ const url = this.d.config?.jwksUrl || DEFAULT_QR_JWKS_URL;
2570
+ const fail2 = (why) => new QrError("QR_JWKS_UNAVAILABLE", why);
2571
+ let u;
2572
+ try {
2573
+ u = new URL(url);
2574
+ } catch {
2575
+ throw fail2("jwksUrl \u0431\u0443\u0440\u0443\u0443");
2576
+ }
2577
+ if (u.protocol !== "https:" && !(u.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(u.hostname))) {
2578
+ throw fail2("jwksUrl https \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439");
2579
+ }
2580
+ const init = {
2581
+ method: "GET",
2582
+ headers: { Accept: "application/json" },
2583
+ signal: AbortSignal.timeout(this.d.timeoutMs ?? 15e3)
2584
+ };
2585
+ if (this.d.dispatcher) init.dispatcher = this.d.dispatcher;
2586
+ let res;
2587
+ try {
2588
+ res = await (this.d.fetchImpl ?? fetch)(url, init);
2589
+ } catch (e) {
2590
+ throw fail2(`\u0442\u0430\u0442\u0430\u0433\u0434\u0441\u0430\u043D\u0433\u04AF\u0439: ${e.message}`);
2591
+ }
2592
+ if (res.status !== 200) {
2593
+ await res.body?.cancel().catch(() => void 0);
2594
+ throw fail2(`HTTP ${res.status}`);
2595
+ }
2596
+ const text = await res.text();
2597
+ if (text.length > MAX_JWKS) throw fail2("JWKS \u0445\u044D\u0442 \u0442\u043E\u043C");
2598
+ let k;
2599
+ try {
2600
+ k = JSON.parse(text);
2601
+ } catch {
2602
+ throw fail2("JWKS JSON \u0431\u0438\u0448");
2603
+ }
2604
+ if (!isObj(k) || !Array.isArray(k.keys) || k.keys.length === 0) throw fail2("JWKS \u0445\u043E\u043E\u0441\u043E\u043D");
2605
+ return k;
2606
+ }
2607
+ };
2608
+
2260
2609
  // src/share.ts
2261
2610
  var DEFAULT_SHARE_TIMEOUT_MS = 15e4;
2262
2611
  var SHARE_ERROR_CODES = [
@@ -2389,6 +2738,8 @@ var EidClient = class {
2389
2738
  organization;
2390
2739
  person;
2391
2740
  token;
2741
+ /** «Миний QR» (биечлэн шалгах): parse → start → result. */
2742
+ qr;
2392
2743
  session;
2393
2744
  validator;
2394
2745
  /** `credentials.rpName` — иргэний утсанд харагдах RP нэр. */
@@ -2413,6 +2764,15 @@ var EidClient = class {
2413
2764
  this.validator = new ResponseValidator(cfg.trust ?? {});
2414
2765
  this.token = new TokenApi(http, cfg.credentials, this.validator);
2415
2766
  this.session = new SessionApi(http);
2767
+ this.qr = new QrApi({
2768
+ http,
2769
+ session: this.session,
2770
+ credentials: cfg.credentials,
2771
+ config: cfg.qr,
2772
+ fetchImpl: cfg.fetchImpl,
2773
+ dispatcher: cfg.dispatcher,
2774
+ timeoutMs: cfg.timeoutMs
2775
+ });
2416
2776
  this.rpName = cfg.credentials.rpName;
2417
2777
  this.http = http;
2418
2778
  }
@@ -2440,7 +2800,7 @@ var EidClient = class {
2440
2800
  };
2441
2801
 
2442
2802
  // src/ocsp.ts
2443
- var import_node_crypto5 = require("crypto");
2803
+ var import_node_crypto6 = require("crypto");
2444
2804
 
2445
2805
  // src/pades/bytes.ts
2446
2806
  var enc = new TextEncoder();
@@ -3117,7 +3477,7 @@ function ocspRevocationChecker(opts = {}) {
3117
3477
  } catch {
3118
3478
  return "unknown";
3119
3479
  }
3120
- const key = (0, import_node_crypto5.createHash)("sha256").update(issuer.raw).digest("hex").slice(0, 16) + ":" + cert.serialNumber;
3480
+ const key = (0, import_node_crypto6.createHash)("sha256").update(issuer.raw).digest("hex").slice(0, 16) + ":" + cert.serialNumber;
3121
3481
  const exp = cache.get(key);
3122
3482
  if (exp !== void 0 && now() < exp) return "good";
3123
3483
  const r = await ask(leaf, iss);
@@ -3145,10 +3505,10 @@ function isMobileUserAgent(nav) {
3145
3505
  }
3146
3506
 
3147
3507
  // src/devicelinkv3.ts
3148
- var import_node_crypto6 = require("crypto");
3508
+ var import_node_crypto7 = require("crypto");
3149
3509
  var TYPES = ["QR", "Web2App", "App2App"];
3150
3510
  var PROTOCOL = { auth: "ACSP_V2", sign: "RAW_DIGEST_SIGNATURE", cert: "" };
3151
- var TOKEN_RE = /^[A-Za-z0-9_-]+$/;
3511
+ var TOKEN_RE2 = /^[A-Za-z0-9_-]+$/;
3152
3512
  var LANG_RE = /^[a-z]{3}$/;
3153
3513
  var STD_B64_RE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
3154
3514
  var b642 = (s) => Buffer.from(s, "utf8").toString("base64");
@@ -3168,7 +3528,7 @@ function buildDeviceLink(p) {
3168
3528
  if (u.protocol !== "https:" || /[?#]/.test(base)) fail("deviceLinkBase \u043D\u044C query/fragment-\u0433\u04AF\u0439 https URL \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439");
3169
3529
  if (!TYPES.includes(p.deviceLinkType)) fail(`deviceLinkType ${String(p.deviceLinkType)} (QR | Web2App | App2App)`);
3170
3530
  if (!(p.sessionType in PROTOCOL)) fail(`sessionType ${String(p.sessionType)} (auth | sign | cert)`);
3171
- if (!p.sessionToken || !TOKEN_RE.test(p.sessionToken)) fail("sessionToken \u0445\u044D\u043B\u0431\u044D\u0440 \u0431\u0443\u0440\u0443\u0443");
3531
+ if (!p.sessionToken || !TOKEN_RE2.test(p.sessionToken)) fail("sessionToken \u0445\u044D\u043B\u0431\u044D\u0440 \u0431\u0443\u0440\u0443\u0443");
3172
3532
  if (!LANG_RE.test(p.lang ?? "")) fail("lang \u043D\u044C ISO 639-2 \u0433\u0443\u0440\u0432\u0430\u043D \u0436\u0438\u0436\u0438\u0433 \u04AF\u0441\u044D\u0433 (mon, eng)");
3173
3533
  if (!p.sessionSecret || !STD_B64_RE.test(p.sessionSecret)) fail("sessionSecret \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442 Base64 (padding-\u0442\u044D\u0439) \u0431\u0438\u0448");
3174
3534
  let challenge = "";
@@ -3202,7 +3562,7 @@ function buildDeviceLink(p) {
3202
3562
  callback,
3203
3563
  unprotected
3204
3564
  ].join("|");
3205
- const authCode = (0, import_node_crypto6.createHmac)("sha256", Buffer.from(p.sessionSecret, "base64")).update(payload, "utf8").digest("base64url");
3565
+ const authCode = (0, import_node_crypto7.createHmac)("sha256", Buffer.from(p.sessionSecret, "base64")).update(payload, "utf8").digest("base64url");
3206
3566
  return `${unprotected}&authCode=${authCode}`;
3207
3567
  }
3208
3568
  function deviceLinkInput(s, deviceLinkType, lang) {
@@ -3246,7 +3606,7 @@ function qrDeviceLinkTicker(input, onLink, opts) {
3246
3606
  }
3247
3607
 
3248
3608
  // src/login.ts
3249
- var import_node_crypto7 = require("crypto");
3609
+ var import_node_crypto8 = require("crypto");
3250
3610
  var MEMORY_LOGIN_STORE_MAX = 1e4;
3251
3611
  var LoginStoreFullError = class extends Error {
3252
3612
  constructor() {
@@ -3342,7 +3702,7 @@ function forwardedClientIp(headers, trustProxy) {
3342
3702
  }
3343
3703
  var ID_RE = /^(\p{L}{2}[0-9]{8}|[0-9]{8,14}|PNOMN-[0-9]{8,14})$/u;
3344
3704
  var UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
3345
- var B64URL_RE = /^[A-Za-z0-9_-]{43}$/;
3705
+ var B64URL_RE2 = /^[A-Za-z0-9_-]{43}$/;
3346
3706
  var IOS_BROWSERS = [
3347
3707
  [/CriOS/i, "googlechromes"],
3348
3708
  [/EdgiOS/i, "microsoft-edge-https"],
@@ -3385,11 +3745,11 @@ function readCookie(h, name) {
3385
3745
  }
3386
3746
  return "";
3387
3747
  }
3388
- var sha256hex = (s) => (0, import_node_crypto7.createHash)("sha256").update(s).digest("hex");
3748
+ var sha256hex = (s) => (0, import_node_crypto8.createHash)("sha256").update(s).digest("hex");
3389
3749
  function safeEqualHex(a, b) {
3390
3750
  const x = Buffer.from(a, "hex");
3391
3751
  const y = Buffer.from(b, "hex");
3392
- return x.length === y.length && x.length > 0 && (0, import_node_crypto7.timingSafeEqual)(x, y);
3752
+ return x.length === y.length && x.length > 0 && (0, import_node_crypto8.timingSafeEqual)(x, y);
3393
3753
  }
3394
3754
  function sleep(ms2, signal) {
3395
3755
  return new Promise((resolve) => {
@@ -3464,7 +3824,7 @@ function createEidLogin(opts) {
3464
3824
  const pushFloorMs = opts.pushFloorMs ?? 1e3;
3465
3825
  const revocation = opts.revocation === false ? void 0 : opts.revocation ?? ocspRevocationChecker();
3466
3826
  const revocationMode = opts.revocationMode ?? "soft-fail";
3467
- const auditKey = opts.auditKey ?? (0, import_node_crypto7.randomBytes)(32);
3827
+ const auditKey = opts.auditKey ?? (0, import_node_crypto8.randomBytes)(32);
3468
3828
  let caTtl = 0;
3469
3829
  let caTtlNext = 0;
3470
3830
  let caTtlInflight;
@@ -3497,7 +3857,7 @@ function createEidLogin(opts) {
3497
3857
  const d = Math.round((expiresAt - sent) / 1e3) * 1e3;
3498
3858
  if (d > 0) caTtl = d;
3499
3859
  }
3500
- const pushKey = (idCode) => (0, import_node_crypto7.createHmac)("sha256", auditKey).update(`eid-push-audit:${idCode}`).digest("hex").slice(0, 32);
3860
+ const pushKey = (idCode) => (0, import_node_crypto8.createHmac)("sha256", auditKey).update(`eid-push-audit:${idCode}`).digest("hex").slice(0, 32);
3501
3861
  async function emit(kind, sessionId, meta, ctx2) {
3502
3862
  if (!opts.onEvent) return;
3503
3863
  try {
@@ -3547,7 +3907,7 @@ function createEidLogin(opts) {
3547
3907
  const dot = raw.indexOf(".");
3548
3908
  const sid = raw.slice(0, dot);
3549
3909
  const binding = raw.slice(dot + 1);
3550
- if (dot < 0 || !UUID_RE2.test(sid) || !B64URL_RE.test(binding)) return void 0;
3910
+ if (dot < 0 || !UUID_RE2.test(sid) || !B64URL_RE2.test(binding)) return void 0;
3551
3911
  const tx = await store.get(sid);
3552
3912
  if (!tx || !safeEqualHex(tx.bindingHash, sha256hex(binding))) return void 0;
3553
3913
  if (tx.expiresAt <= Date.now()) {
@@ -3611,7 +3971,7 @@ function createEidLogin(opts) {
3611
3971
  return { ...await save(tx, ttlMs), appLink };
3612
3972
  }
3613
3973
  async function save(tx, ttlMs) {
3614
- const binding = (0, import_node_crypto7.randomBytes)(32).toString("base64url");
3974
+ const binding = (0, import_node_crypto8.randomBytes)(32).toString("base64url");
3615
3975
  const full = { ...tx, bindingHash: sha256hex(binding), expiresAt: Date.now() + ttlMs };
3616
3976
  await store.set(full.sessionId, full, ttlMs);
3617
3977
  const expiresIn = Math.ceil(ttlMs / 1e3);
@@ -3620,7 +3980,7 @@ function createEidLogin(opts) {
3620
3980
  }
3621
3981
  function startDecoy(ttlMs) {
3622
3982
  const acsp = void 0;
3623
- return save({ sessionId: (0, import_node_crypto7.randomUUID)(), mode: "push", vc: String((0, import_node_crypto7.randomInt)(1e5)).padStart(5, "0"), acsp, decoy: true }, ttlMs);
3983
+ return save({ sessionId: (0, import_node_crypto8.randomUUID)(), mode: "push", vc: String((0, import_node_crypto8.randomInt)(1e5)).padStart(5, "0"), acsp, decoy: true }, ttlMs);
3624
3984
  }
3625
3985
  async function start(req) {
3626
3986
  const url = new URL(req.url, "http://x");
@@ -3844,6 +4204,10 @@ function createEidLogin(opts) {
3844
4204
  DEFAULT_BASE_URL,
3845
4205
  DEFAULT_MAX_WAIT_MS,
3846
4206
  DEFAULT_PDF_TIMEOUT_MS,
4207
+ DEFAULT_QR_ISSUER,
4208
+ DEFAULT_QR_JWKS_CACHE_TTL_MS,
4209
+ DEFAULT_QR_JWKS_URL,
4210
+ DEFAULT_QR_MAX_AGE_MS,
3847
4211
  DEFAULT_SHARE_TIMEOUT_MS,
3848
4212
  DEFAULT_SIGN_SESSION_TTL_MS,
3849
4213
  DeviceLinkError,
@@ -3864,6 +4228,13 @@ function createEidLogin(opts) {
3864
4228
  PDF_REGISTER_ERROR_CODES,
3865
4229
  PDF_SIGNATURE_REGISTER_FIELDS,
3866
4230
  PersonApi,
4231
+ QR_ATTRIBUTES,
4232
+ QR_CLOCK_SKEW_MS,
4233
+ QR_ERROR_CODES,
4234
+ QR_PREFIX,
4235
+ QrApi,
4236
+ QrError,
4237
+ QrTokenInvalidError,
3867
4238
  RETRYABLE_ERROR_CODES,
3868
4239
  RequestInvalidError,
3869
4240
  ResponseTooLargeError,
@@ -3894,6 +4265,7 @@ function createEidLogin(opts) {
3894
4265
  memoryLoginStore,
3895
4266
  ocspRevocationChecker,
3896
4267
  parseExpiresAt,
4268
+ parseQr,
3897
4269
  parseRetryAfter,
3898
4270
  parseSessionResult,
3899
4271
  parseSubject,
@@ -3910,6 +4282,7 @@ function createEidLogin(opts) {
3910
4282
  userChallengeOf,
3911
4283
  verifyPayloadSignature,
3912
4284
  verifyPrehashedSignature,
4285
+ verifyQrPresentation,
3913
4286
  verifyTokenCertificates,
3914
4287
  withReturnHint
3915
4288
  });