@gerege-systems/eid-mongolia-sdk 0.32.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/README.md CHANGED
@@ -947,6 +947,42 @@ try {
947
947
  ч тогтооно). `session_id`, `doc_id`, `on_behalf_of_*` нь CA-ийн бүртгэлээс — локал тайланд байхгүй.
948
948
  - Хөтчийн bundle (минифай): ~253 KB, gzip ~137 KB (`npm run size:validate`, хязгаар 300 KB).
949
949
 
950
+ ## 3h. «Миний QR» — биечлэн шалгах (`eid.qr`, 0.33.0)
951
+
952
+ Иргэн eID апп дээрээ «Миний QR»-ийг харуулна (`EIDMN-QR1:<token>`, 120 с, нэг удаагийн). RP (касс, POS, апп) скан хийж
953
+ хүссэн аттрибутаа асууна → иргэн утсан дээрээ хүсэлтийг (RP нэр, аттрибутын жагсаалт, VC) харж PIN1-ээр зөвшөөрнө →
954
+ RP CA-ийн ES256 гарын үсэгтэй presentation авна. RP-д `AUTH` + `QR_PRESENT` + аттрибут бүрд `QR_ATTR:<нэр>` эрх.
955
+
956
+ Каталог (`QR_ATTRIBUTES`): `age_over_18`, `age_over_21` (bool, төрсөн огноо задлахгүй), `full_name`
957
+ ({surname, givenName}), `phone` (E.164), `birth_date` (YYYY-MM-DD, мэдрэмтгий), `civil_id` (мэдрэмтгий). Бүртгэлд
958
+ байхгүй утга → `unavailable`, алдаа биш.
959
+
960
+ ```ts
961
+ import { QrError, QrTokenInvalidError, SessionFailedError } from "@gerege-systems/eid-mongolia-sdk";
962
+
963
+ const s = await eid.qr.start({ qr: scanned, attributes: ["age_over_18"], nonce: orderId }); // eid.qr.parse(scanned) — зөвхөн токен
964
+ showOnPos(s.vc); // иргэний утсанд ижил код
965
+ // s-ийг (JSON) хадгалж болно — result-д nonce, хүссэн аттрибутыг тулгана.
966
+ try {
967
+ const p = await eid.qr.result(s);
968
+ if (p.attrs.age_over_18) sell();
969
+ } catch (e) {
970
+ if (e instanceof QrTokenInvalidError) {/* start: 404 — шинэ QR гаргуул */}
971
+ else if (e instanceof SessionFailedError) {/* USER_REFUSED, TIMEOUT … */}
972
+ else if (e instanceof QrError && e.code === "QR_PRESENTATION_INVALID") {/* ИТГЭХГҮЙ */}
973
+ else if (e instanceof QrError && e.code === "QR_JWKS_UNAVAILABLE") {/* түр — дахин оролд */}
974
+ else throw e;
975
+ }
976
+ ```
977
+
978
+ Дүрэм (гурван SDK-д ижил, `testdata/qr_vectors.json`-оор баталгаажсан): JWS `alg` = ES256, header-т `kid`
979
+ (JWKS-ээс; танихгүй kid → JWKS-ийг нэг удаа дахин татна), `iss` = `https://ca.eidmongolia.mn`, `aud` = таны RP UUID,
980
+ `sid` = session, `nonce` = таны nonce (өгөөгүй бол SDK-ийн rpChallenge), `iat` ≤ одоо+60 с ба ≥ одоо−10 мин,
981
+ `attrs` ∪ `unavailable` = хүссэн аттрибутууд яг (илүү/дутуу → татгалзана), аттрибут бүрийн төрөл (bool, E.164,
982
+ YYYY-MM-DD, {surname, givenName}). Токен нэг удаагийн, 120 с; хариунд гэрчилгээ, person блок, иргэний дугаар
983
+ (`civil_id` хүсээгүй бол) ирэхгүй. `sub` — энэ RP-д зориулсан тогтмол pairwise id. 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-ийг
984
+ сүлжээгүй дахин шалгах: `verifyQrPresentation(jws, jwks, expect)`.
985
+
950
986
  ## 4. QR ба ижил төхөөрөмж — device link v3
951
987
 
952
988
  Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
@@ -1,5 +1,5 @@
1
- export { D as DeviceLinkError, E as EidError } from './errors-3JEfE-FW.cjs';
2
- export { D as DeviceLinkSession } from './types-ByGHVzuP.cjs';
1
+ export { D as DeviceLinkError, E as EidError } from './errors-mcDbKiz_.cjs';
2
+ export { D as DeviceLinkSession } from './types-Cf3GT4wh.cjs';
3
3
 
4
4
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
5
5
  interface NavigatorLike {
package/dist/browser.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- export { D as DeviceLinkError, E as EidError } from './errors-3JEfE-FW.js';
2
- export { D as DeviceLinkSession } from './types-ByGHVzuP.js';
1
+ export { D as DeviceLinkError, E as EidError } from './errors-mcDbKiz_.js';
2
+ export { D as DeviceLinkSession } from './types-Cf3GT4wh.js';
3
3
 
4
4
  /** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
5
5
  interface NavigatorLike {
package/dist/browser.js CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  DeviceLinkError,
6
6
  EidError
7
- } from "./chunk-R73IR6OH.js";
7
+ } from "./chunk-TNXO4QLU.js";
8
8
  export {
9
9
  DeviceLinkError,
10
10
  EidError,
@@ -66,6 +66,8 @@ var CertChoiceInvalidError = class extends ApiError {
66
66
  };
67
67
  var RequestInvalidError = class extends ApiError {
68
68
  };
69
+ var QrTokenInvalidError = class extends ApiError {
70
+ };
69
71
  var RETRYABLE_ERROR_CODES = [
70
72
  "RATE_LIMITED",
71
73
  "STATE_UNAVAILABLE",
@@ -158,6 +160,7 @@ export {
158
160
  NoSigningCertificateError,
159
161
  CertChoiceInvalidError,
160
162
  RequestInvalidError,
163
+ QrTokenInvalidError,
161
164
  RETRYABLE_ERROR_CODES,
162
165
  parseRetryAfter,
163
166
  ON_BEHALF_ERROR_CODES,
@@ -81,6 +81,12 @@ declare class CertChoiceInvalidError extends ApiError {
81
81
  /** 400 `REQUEST_INVALID` — хүсэлтийн бие/талбар буруу (ж: linked sign-д `linkedSessionID` дутуу). Програмын алдаа. */
82
82
  declare class RequestInvalidError extends ApiError {
83
83
  }
84
+ /**
85
+ * 404 `QR_TOKEN_INVALID` («Миний QR», `qr.start`) — токен танигдахгүй, 120 с-ийн хугацаа дууссан эсвэл аль хэдийн
86
+ * ашиглагдсан. Иргэнээс шинэ QR гаргуулж дахин скан хийнэ.
87
+ */
88
+ declare class QrTokenInvalidError extends ApiError {
89
+ }
84
90
  /**
85
91
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
86
92
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -164,4 +170,4 @@ declare class AppTransactionTooLargeError extends EidError {
164
170
  declare class DeviceLinkError extends EidError {
165
171
  }
166
172
 
167
- export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
173
+ export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
@@ -81,6 +81,12 @@ declare class CertChoiceInvalidError extends ApiError {
81
81
  /** 400 `REQUEST_INVALID` — хүсэлтийн бие/талбар буруу (ж: linked sign-д `linkedSessionID` дутуу). Програмын алдаа. */
82
82
  declare class RequestInvalidError extends ApiError {
83
83
  }
84
+ /**
85
+ * 404 `QR_TOKEN_INVALID` («Миний QR», `qr.start`) — токен танигдахгүй, 120 с-ийн хугацаа дууссан эсвэл аль хэдийн
86
+ * ашиглагдсан. Иргэнээс шинэ QR гаргуулж дахин скан хийнэ.
87
+ */
88
+ declare class QrTokenInvalidError extends ApiError {
89
+ }
84
90
  /**
85
91
  * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. RATE_LIMITED (429 `/pdf/signatures`, `/token/auth/*`),
86
92
  * STATE_UNAVAILABLE (503 session start, токен, бүртгэл; Retry-After 5), ISSUANCE_PENDING (503 токены үр дүн, 5).
@@ -164,4 +170,4 @@ declare class AppTransactionTooLargeError extends EidError {
164
170
  declare class DeviceLinkError extends EidError {
165
171
  }
166
172
 
167
- export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };
173
+ export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, type OnBehalfErrorCode as O, PDF_REGISTER_ERROR_CODES as P, QrTokenInvalidError as Q, type RetryableErrorCode as R, SessionFailedError as S, ValidationError as V, AppTransactionTooLargeError as a, AuthenticationError as b, NoSigningCertificateError as c, ON_BEHALF_ERROR_CODES as d, type PdfRegisterErrorCode as e, RETRYABLE_ERROR_CODES as f, RequestInvalidError as g, ResponseTooLargeError as h, parseRetryAfter as p };