@gerege-systems/eid-mongolia-sdk 0.36.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -922,45 +922,55 @@ try {
922
922
  ч тогтооно). `session_id`, `doc_id`, `on_behalf_of_*` нь CA-ийн бүртгэлээс — локал тайланд байхгүй.
923
923
  - Хөтчийн bundle (минифай): ~253 KB, gzip ~137 KB (`npm run size:validate`, хязгаар 300 KB).
924
924
 
925
- ## 3h. «Миний QR» — биечлэн шалгах (`eid.qr`, 0.33.0)
925
+ ## 3h. «Миний QR» — биечлэн шалгах (`eid.qr`, 0.37.0)
926
926
 
927
- Иргэн eID апп дээрээ «Миний QR»-ийг харуулна (`EIDMN-QR1:<token>`, 120 с, нэг удаагийн). RP (касс, POS, апп) скан хийж
928
- хүссэн аттрибутаа асууна → иргэн утсан дээрээ хүсэлтийг (RP нэр, аттрибутын жагсаалт, VC) харж PIN1-ээр зөвшөөрнө →
929
- RP CA-ийн ES256 гарын үсэгтэй presentation авна. RP-д `AUTH` + `QR_PRESENT` + аттрибут бүрд `QR_ATTR:<нэр>` эрх.
930
-
931
- Каталог (`QR_ATTRIBUTES`): `age_over_18`, `age_over_21` (bool, төрсөн огноо задлахгүй), `full_name`
932
- ({surname, givenName}), `phone` (E.164), `birth_date` (YYYY-MM-DD, мэдрэмтгий), `civil_id` (мэдрэмтгий). Бүртгэлд
933
- байхгүй утга → `unavailable`, алдаа биш.
927
+ Иргэн eID апп дээрээ «Миний QR»-ийг харуулна (`EIDMN-QR1:<token>`, 120 с, нэг удаагийн). RP (касс, POS, апп) скан хийнэ →
928
+ иргэн утсан дээрээ «Та <RP>-д «Миний мэдээлэл» хэсгийн бүх мэдээллийг хуваалцах гэж байна» гэсэн өгүүлбэрийг PIN2-оор
929
+ (QUALIFIED гарын үсгийн түлхүүр) зөвшөөрнө → RP иргэний **өөрийн** гарын үсэгтэй (PS256 JWS, `x5c` = [SIGN гэрчилгээ,
930
+ олгогч CA]) «Миний мэдээлэл»-ийг (апп дээр хадгалсан түлхүүр/утга яг тэр хэвээр, нүүрний JPEG зураг) авна. RP-д зөвхөн
931
+ `QR_PRESENT` эрх. CA өгөгдлийг DB-д хадгалахгүй — RP-ийн анхны амжилттай уншилтаар устгана.
934
932
 
935
933
  ```ts
936
934
  import { QrError, QrTokenInvalidError, SessionFailedError } from "@gerege-systems/eid-mongolia-sdk";
937
935
 
938
- const s = await eid.qr.start({ qr: scanned, attributes: ["age_over_18"], nonce: orderId }); // eid.qr.parse(scanned) — зөвхөн токен
939
- showOnPos(s.vc); // иргэний утсанд ижил код
940
- // s-ийг (JSON) хадгалж болно — result-д nonce, хүссэн аттрибутыг тулгана.
936
+ const s = await eid.qr.start({ qr: scanned, nonce: orderId }); // nonce өгөөгүй бол base64url(16 байт); VC алга
937
+ // s ({ sessionId, nonce })-ийг JSON-оор хадгалж болно — result/check-д nonce, session-ийг тулгана.
941
938
  try {
942
- const p = await eid.qr.result(s);
943
- if (p.attrs.age_over_18) sell();
939
+ const p = await eid.qr.result(s); // эсвэл polling UI: await eid.qr.check(s) → { complete: false } | { complete: true, result }
940
+ p.data; // { birth_date: "1990-01-01", given_name: "Бат", … } — payload-ийн дарааллаар, түлхүүр verbatim
941
+ p.source; // "dan" | "passport" | "citizenid" | "gsign" | "guardian" | "unknown" | …
942
+ p.photo; // Uint8Array (JPEG) | undefined
943
+ p.signer; // { certificate, etsi: "PNOMN-…", givenName, surname, commonName } — гэрчилгээнээс
944
+ p.signedAt; // Date (iat)
945
+ p.sha256; // hex SHA-256(signingInput) = CA-ийн аудитын qrsha (маргаанд тулгах)
944
946
  } catch (e) {
945
947
  if (e instanceof QrTokenInvalidError) {/* start: 404 — шинэ QR гаргуул */}
946
948
  else if (e instanceof SessionFailedError) {/* USER_REFUSED, TIMEOUT … */}
947
- else if (e instanceof QrError && e.code === "QR_PRESENTATION_INVALID") {/* ИТГЭХГҮЙ */}
948
- else if (e instanceof QrError && e.code === "QR_JWKS_UNAVAILABLE") {/* түр — дахин оролд */}
949
+ else if (e instanceof QrError && e.code === "QR_PRESENTATION_GONE") {/* аль хэдийн уншигдсан / хугацаа дууссан — шинэ QR */}
950
+ else if (e instanceof QrError && e.code === "QR_REVOCATION_UNKNOWN") {/* OCSP хариугүй — түр, дахин verify */}
951
+ else if (e instanceof QrError) {/* QR_* шалгалт унасан — ИТГЭХГҮЙ */}
949
952
  else throw e;
950
953
  }
951
954
  ```
952
955
 
953
- Дүрэм (гурван SDK-д ижил, `testdata/qr_vectors.json`-оор баталгаажсан): JWS `alg` = ES256, header-т `kid`
954
- (JWKS-ээс; танихгүй kid → JWKS-ийг нэг удаа дахин татна), `iss` = `https://ca.eidmongolia.mn`, `aud` = таны RP UUID,
955
- `sid` = session, `nonce` = таны nonce (өгөөгүй бол SDK-ийн rpChallenge), `iat` ≤ одоо+60 с ба ≥ одоо−10 мин,
956
- `attrs` ∪ `unavailable` = хүссэн аттрибутууд яг (илүү/дутуу → татгалзана), аттрибут бүрийн төрөл (bool, E.164,
957
- YYYY-MM-DD, {surname, givenName}). Токен нэг удаагийн, 120 с; хариунд гэрчилгээ, person блок, иргэний дугаар
958
- (`civil_id` хүсээгүй бол) ирэхгүй. `sub` — энэ RP-д зориулсан тогтмол pairwise id. **Polling UI** (0.34.0+): `eid.qr.check(s)` — нэг удаа шалгана → `{ state: "RUNNING" }` эсвэл `{ state: "COMPLETE",
959
- presentation }`. `result`-ийн `maxWaitMs` дуусахад иргэн хараахан хариулаагүй бол `QrError` `QR_PENDING` (дахин дуудаж болно);
960
- CA-ийн жинхэнэ хугацаа дуусалт нь `SessionFailedError` `TIMEOUT`.
961
-
962
- CA-ийн бусад код (`code`): 400 `REQUEST_INVALID` (үл мэдэгдэх талбар ч), 403 `PERMISSION_DENIED` / `RP_REQUIRED`, 429 `RATE_LIMITED`, 503 `QR_UNAVAILABLE` (түр), 410 `QR_PRESENTATION_EXPIRED` (session-ийн үр дүнг иргэн зөвшөөрснөөс хойш 10 минутын дотор л уншина), 410 `QR_SUBJECT_GONE` (ховор); RP-ийн эрх уншилт бүрд дахин шалгагдана (хураагдвал 403). `aud` том/жижиг үсэг ялгахгүй тулгана (CA жижиг үсгээр бичнэ). `qr` тохиргоо (`jwksUrl`, `issuer`, `jwksCacheTtlMs`, `maxAgeMs`) — тест орчинд л. Хадгалсан JWS-ийг
963
- сүлжээгүй дахин шалгах: `verifyQrPresentation(jws, jwks, expect)`.
956
+ Шалгалт (`verifyQrPresentation(jws, expect, trust)`; Go / .NET SDK-тэй ижил, `test/fixtures/myqr_vectors.json`):
957
+ хэлбэр (≤ 512 KiB, 3 сегмент) → header яг `alg` PS256 / `typ` `eidmn-myqr+jwt` / `x5c` 2 гэрчилгээ (`QR_HEADER_INVALID`)
958
+ → гинж: x5c[1] ∪ `trust.intermediatesPem` → `trust.trustAnchorsPem` (анхдагч `NATIONAL_ROOT_CA_PEM`), цаг ± 60 с, CA биш,
959
+ KeyUsage contentCommitment, QUALIFIED (qcStatements), issuer allowlist (анхдагч `CITIZEN_ISSUING_CA_SKI`), RSA ≥ 2048
960
+ (`QR_CHAIN_INVALID`; x5c[1] хэзээ ч anchor биш) → цуцлалт `trust.revocation` (алга бол SDK-ийн OCSP; `revocationMode`
961
+ анхдагч hard-fail: `QR_CERT_REVOKED` / `QR_REVOCATION_UNKNOWN`) → PS256 (salt 32) хүлээн авсан байтаар
962
+ (`QR_SIGNATURE_INVALID`) → claim: `iss` = `https://ca.eidmongolia.mn`, `sub` = гэрчилгээний serialNumber, `statement` нь
963
+ `rp_name`-ээс угсарсантай яг тэнцүү (`QR_CLAIMS_INVALID`), `aud` = RP UUID (том/жижиг үсэг ялгахгүй,
964
+ `QR_AUDIENCE_MISMATCH`), `sid` (`QR_SESSION_MISMATCH`), `nonce` (`QR_NONCE_MISMATCH`), `0 < exp − iat ≤ 300`,
965
+ `iat ≤ одоо+60` (`QR_NOT_YET_VALID`), `одоо < exp+60` (`QR_EXPIRED`) → өгөгдөл: `source` `^[a-z0-9_-]{1,32}$`, `fields`
966
+ ≤ 128 түлхүүр (1–64 тэмдэгт, удирдлагын тэмдэгтгүй), утга string ≤ 2048 байт, `photo` хатуу base64 JPEG ≤ 150 KiB,
967
+ өөр гишүүнгүй (`QR_DATA_INVALID`). `trust` = `ClientConfig.trust` (`allowUntrusted`, `checkKeyUsage: false` энд
968
+ үйлчлэхгүй).
969
+
970
+ `result`-ийн `maxWaitMs` дуусахад иргэн хариулаагүй бол `QrError` `QR_PENDING` (дахин дуудаж болно). CA-ийн код
971
+ (`ApiError` / `ForbiddenError`-ийн `code`): 400 `REQUEST_INVALID` (nonce 16–128 байт ASCII 0x21–0x7E), 403
972
+ `PERMISSION_DENIED` / `RP_REQUIRED`, 404 `QR_TOKEN_INVALID`, 409 `NO_SIGNING_CERTIFICATE`, 429 `RATE_LIMITED`; `GET /session`-ийн
973
+ 410 → `QrError` `QR_PRESENTATION_GONE` (presentation нэг л удаа өгөгдөнө). `qr.issuer` тохиргоо — тест орчинд л.
964
974
 
965
975
  ## 4. QR ба ижил төхөөрөмж — device link v3
966
976
 
@@ -205,8 +205,8 @@ interface SessionResult {
205
205
  /** USB токены гэрчилгээ олголтын session-ий `tokenCertificate` блок (`token.issueCertificate`); бусад урсгалд null. */
206
206
  tokenCertificate?: TokenCertSessionBlock | null;
207
207
  /**
208
- * «Миний QR» session-ий CA-ийн presentation (`qr.result` шалгана): `jws` (ES256) ба `claims` (payload-ийн хуулбар —
209
- * ШАЛГААГҮЙ; итгэхдээ `qr.result` / `verifyQrPresentation`-ийн үр дүнг л хэрэглэ). Бусад урсгалд null.
208
+ * «Миний QR» session-ий presentation: иргэний PS256 гарын үсэгтэй `jws` (x5c) — ШАЛГААГҮЙ; итгэхдээ `qr.result` /
209
+ * `verifyQrPresentation`-ийн үр дүнг л хэрэглэ. Бусад урсгалд null.
210
210
  */
211
211
  presentation?: SessionPresentation | null;
212
212
  /** Серверийн хариуны түүхий JSON (`parseSessionResult`-ийн оролт) — SDK задлаагүй талбарт. */
@@ -215,7 +215,6 @@ interface SessionResult {
215
215
  /** QR session-ий `presentation` блок. */
216
216
  interface SessionPresentation {
217
217
  jws: string;
218
- claims?: Record<string, unknown>;
219
218
  }
220
219
  /**
221
220
  * Session-ий `person` блок (CA `dto.PersonBlock`). Нэршил core.gerege.mn-тэй нэг мөр — гурван нэр ӨӨР ойлголт:
@@ -205,8 +205,8 @@ interface SessionResult {
205
205
  /** USB токены гэрчилгээ олголтын session-ий `tokenCertificate` блок (`token.issueCertificate`); бусад урсгалд null. */
206
206
  tokenCertificate?: TokenCertSessionBlock | null;
207
207
  /**
208
- * «Миний QR» session-ий CA-ийн presentation (`qr.result` шалгана): `jws` (ES256) ба `claims` (payload-ийн хуулбар —
209
- * ШАЛГААГҮЙ; итгэхдээ `qr.result` / `verifyQrPresentation`-ийн үр дүнг л хэрэглэ). Бусад урсгалд null.
208
+ * «Миний QR» session-ий presentation: иргэний PS256 гарын үсэгтэй `jws` (x5c) — ШАЛГААГҮЙ; итгэхдээ `qr.result` /
209
+ * `verifyQrPresentation`-ийн үр дүнг л хэрэглэ. Бусад урсгалд null.
210
210
  */
211
211
  presentation?: SessionPresentation | null;
212
212
  /** Серверийн хариуны түүхий JSON (`parseSessionResult`-ийн оролт) — SDK задлаагүй талбарт. */
@@ -215,7 +215,6 @@ interface SessionResult {
215
215
  /** QR session-ий `presentation` блок. */
216
216
  interface SessionPresentation {
217
217
  jws: string;
218
- claims?: Record<string, unknown>;
219
218
  }
220
219
  /**
221
220
  * Session-ий `person` блок (CA `dto.PersonBlock`). Нэршил core.gerege.mn-тэй нэг мөр — гурван нэр ӨӨР ойлголт:
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-w1Ca6FdZ.cjs';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-DdxKtnvo.cjs';
2
2
  export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.cjs';
package/dist/browser.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-CCP--VGv.js';
1
+ export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-CxTMnKOc.js';
2
2
  export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.js';