@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/README.md +46 -0
- package/dist/browser.d.cts +18 -2
- package/dist/browser.d.ts +18 -2
- package/dist/browser.js +1 -1
- package/dist/{chunk-R73IR6OH.js → chunk-TNXO4QLU.js} +3 -0
- package/dist/{errors-3JEfE-FW.d.ts → errors-mcDbKiz_.d.cts} +7 -1
- package/dist/{errors-3JEfE-FW.d.cts → errors-mcDbKiz_.d.ts} +7 -1
- package/dist/index.cjs +393 -20
- package/dist/index.d.cts +166 -5
- package/dist/index.d.ts +166 -5
- package/dist/index.js +369 -10
- package/dist/pades.d.cts +4 -25
- package/dist/pades.d.ts +4 -25
- package/dist/pades.js +1 -1
- package/dist/{browser-B3cWNpRM.d.cts → types-Cf3GT4wh.d.cts} +60 -17
- package/dist/{browser-X_HjiWxc.d.ts → types-Cf3GT4wh.d.ts} +60 -17
- 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
|
@@ -684,7 +684,17 @@ const p = await prepare(pdfBytes, { signerCert, verifyPage: true, fileName: "Г
|
|
|
684
684
|
`width·height` байт, `sha256` жижиг hex) бол `REQUEST_INVALID`. Зургийн sha256 `complete().images` →
|
|
685
685
|
`registrationFromCompleted` → `images` болж CA-д очно. Дүрэм: `APPEARANCE_SPEC.md` §6, `PLACEMENT_SPEC.md` §6c.
|
|
686
686
|
|
|
687
|
+
Зургийг RP backend-ээс (0.32.0+): `eid.person.signatureImage(personEtsi)` → `GET /person/etsi/{personEtsi}/signature-image`
|
|
688
|
+
(**SIGN** эрх + иргэн сүүлийн 24 цагт нэвтэрсэн; зураг хадгалаагүй бол `null`, 403 → `ForbiddenError`) →
|
|
689
|
+
`EidImage { png, sha256, width, height, updatedAt, pdfImage }`; тамга — `organization.getRepresentations()`-ийн
|
|
690
|
+
`representations[].stampImage` (`stampImageSet` — бий эсэх; зураг зөвхөн SIGN эрхтэй RP-д). `pdfImage`-ийг хэвээр дамжуулна:
|
|
691
|
+
|
|
687
692
|
```ts
|
|
693
|
+
// backend
|
|
694
|
+
const sig = await eid.person.signatureImage(signerEtsi); // EidImage | null
|
|
695
|
+
const rep = (await eid.organization.getRepresentations(signerEtsi)).representations.find((r) => r.orgEtsi === orgEtsi);
|
|
696
|
+
const signatureImage = sig?.pdfImage, stampImage = rep?.stampImage?.pdfImage;
|
|
697
|
+
// клиент (/pades)
|
|
688
698
|
const p = await prepare(pdfBytes, { signerCert, claimedRole, verifyPage: true, fileName: "Гэрээ №12.pdf",
|
|
689
699
|
appearance: { x: 340, y: 36, width: 0, height: 0, signatureImage, stampImage } }); // 240 × 147.5
|
|
690
700
|
```
|
|
@@ -937,6 +947,42 @@ try {
|
|
|
937
947
|
ч тогтооно). `session_id`, `doc_id`, `on_behalf_of_*` нь CA-ийн бүртгэлээс — локал тайланд байхгүй.
|
|
938
948
|
- Хөтчийн bundle (минифай): ~253 KB, gzip ~137 KB (`npm run size:validate`, хязгаар 300 KB).
|
|
939
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
|
+
|
|
940
986
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
941
987
|
|
|
942
988
|
Иргэн өөр төхөөрөмжийн дэлгэц дээрх **QR**-ийг утсаараа уншина, эсвэл RP-ийн сайт/аппыг eID апптай **ижил
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,18 @@
|
|
|
1
|
-
export { D as
|
|
2
|
-
export { D as
|
|
1
|
+
export { D as DeviceLinkError, E as EidError } from './errors-mcDbKiz_.cjs';
|
|
2
|
+
export { D as DeviceLinkSession } from './types-Cf3GT4wh.cjs';
|
|
3
|
+
|
|
4
|
+
/** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
|
|
5
|
+
interface NavigatorLike {
|
|
6
|
+
userAgent?: string;
|
|
7
|
+
maxTouchPoints?: number;
|
|
8
|
+
userAgentData?: {
|
|
9
|
+
mobile?: boolean;
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
|
|
14
|
+
* илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
|
|
15
|
+
*/
|
|
16
|
+
declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
|
|
17
|
+
|
|
18
|
+
export { type NavigatorLike, isMobileUserAgent };
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,2 +1,18 @@
|
|
|
1
|
-
export { D as
|
|
2
|
-
export { D as
|
|
1
|
+
export { D as DeviceLinkError, E as EidError } from './errors-mcDbKiz_.js';
|
|
2
|
+
export { D as DeviceLinkSession } from './types-Cf3GT4wh.js';
|
|
3
|
+
|
|
4
|
+
/** isMobileUserAgent-ийн уншдаг navigator-ийн хэсэг (тестэд орлуулна). */
|
|
5
|
+
interface NavigatorLike {
|
|
6
|
+
userAgent?: string;
|
|
7
|
+
maxTouchPoints?: number;
|
|
8
|
+
userAgentData?: {
|
|
9
|
+
mobile?: boolean;
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Анхдагч гар утас/таблет илрүүлэгч: Android, iPhone/iPod/iPad, UA-CH `mobile`, мөн desktop UA
|
|
14
|
+
* илгээдэг iPadOS (Macintosh + мэдрэгч дэлгэц, maxTouchPoints > 1).
|
|
15
|
+
*/
|
|
16
|
+
declare function isMobileUserAgent(nav?: NavigatorLike): boolean;
|
|
17
|
+
|
|
18
|
+
export { type NavigatorLike, isMobileUserAgent };
|
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 };
|