@gerege-systems/eid-mongolia-sdk 0.32.0 → 0.34.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 +40 -0
- package/dist/browser.d.cts +2 -2
- package/dist/browser.d.ts +2 -2
- package/dist/browser.js +1 -1
- package/dist/{chunk-R73IR6OH.js → chunk-TNXO4QLU.js} +3 -0
- package/dist/{errors-3JEfE-FW.d.cts → errors-mcDbKiz_.d.cts} +7 -1
- package/dist/{errors-3JEfE-FW.d.ts → errors-mcDbKiz_.d.ts} +7 -1
- package/dist/index.cjs +394 -20
- package/dist/index.d.cts +177 -5
- package/dist/index.d.ts +177 -5
- package/dist/index.js +370 -10
- package/dist/pades.d.cts +2 -2
- package/dist/pades.d.ts +2 -2
- package/dist/pades.js +1 -1
- package/dist/{types-ByGHVzuP.d.ts → types-Cf3GT4wh.d.cts} +11 -1
- package/dist/{types-ByGHVzuP.d.cts → types-Cf3GT4wh.d.ts} +11 -1
- package/dist/validate.d.cts +1 -1
- package/dist/validate.d.ts +1 -1
- package/dist/validate.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -947,6 +947,46 @@ 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. **Polling UI** (0.34.0+): `eid.qr.check(s)` — нэг удаа шалгана → `{ state: "RUNNING" }` эсвэл `{ state: "COMPLETE",
|
|
984
|
+
presentation }`. `result`-ийн `maxWaitMs` дуусахад иргэн хараахан хариулаагүй бол `QrError` `QR_PENDING` (дахин дуудаж болно);
|
|
985
|
+
CA-ийн жинхэнэ хугацаа дуусалт нь `SessionFailedError` `TIMEOUT`.
|
|
986
|
+
|
|
987
|
+
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-ийг
|
|
988
|
+
сүлжээгүй дахин шалгах: `verifyQrPresentation(jws, jwks, expect)`.
|
|
989
|
+
|
|
950
990
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
951
991
|
|
|
952
992
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
export { D as DeviceLinkError, E as EidError } from './errors-
|
|
2
|
-
export { D as DeviceLinkSession } from './types-
|
|
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-
|
|
2
|
-
export { D as DeviceLinkSession } from './types-
|
|
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
|
@@ -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 };
|