@gerege-systems/eid-mongolia-sdk 0.14.1 → 0.15.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 +140 -46
- package/dist/{browser-CuMH5IVG.d.cts → browser-8k_VDSP8.d.cts} +19 -169
- package/dist/{browser-CuMH5IVG.d.ts → browser-BZ3hvv6-.d.ts} +19 -169
- package/dist/browser.d.cts +2 -1
- package/dist/browser.d.ts +2 -1
- package/dist/browser.js +5 -3
- package/dist/chunk-REWNE7PO.js +51 -0
- package/dist/{chunk-QPJDZLHR.js → chunk-TB2KQH3W.js} +10 -46
- package/dist/errors-Z7SgLVTr.d.cts +149 -0
- package/dist/errors-Z7SgLVTr.d.ts +149 -0
- package/dist/index.cjs +268 -256
- package/dist/index.d.cts +147 -156
- package/dist/index.d.ts +147 -156
- package/dist/index.js +247 -241
- package/dist/pades.cjs +3520 -0
- package/dist/pades.d.cts +128 -0
- package/dist/pades.d.ts +128 -0
- package/dist/pades.js +3484 -0
- package/package.json +16 -6
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import './errors-Z7SgLVTr.js';
|
|
2
|
+
|
|
1
3
|
/** Сертификатын баталгаажуулалтын түвшин (eIDAS LoA). QUALIFIED — хууль ёсны гарын үсэгт. */
|
|
2
4
|
type CertificateLevel = "ADVANCED" | "QUALIFIED" | "QSCD";
|
|
3
5
|
/** Гарын үсгийн протокол: auth → ACSP_V2, sign → RAW_DIGEST_SIGNATURE (Smart-ID v3). */
|
|
@@ -94,8 +96,9 @@ interface SignContext {
|
|
|
94
96
|
}
|
|
95
97
|
/**
|
|
96
98
|
* CA-ийн SIGNATURE ба CERTIFICATE_CHOICE session-ий анхдагч хүчинтэй хугацаа (мс; `EID_SIGN_SESSION_TTL_SECONDS` = 600).
|
|
97
|
-
* CA-ийн админ «Системийн тохиргоо»-нд 60–1800 секундэд өөрчилж
|
|
98
|
-
* (
|
|
99
|
+
* CA-ийн админ «Системийн тохиргоо»-нд 60–1800 секундэд өөрчилж болно. CA 2026-10-14-өөс session start хариунд
|
|
100
|
+
* `expiresAt` (RFC 3339) буцаадаг — SDK түүнийг ашиглана; хуучин CA (талбаргүй) үед л `ClientConfig.signSessionTtlMs`-ээр
|
|
101
|
+
* тооцоолно ({@link startExpiry}).
|
|
99
102
|
*/
|
|
100
103
|
declare const DEFAULT_SIGN_SESSION_TTL_MS = 600000;
|
|
101
104
|
/**
|
|
@@ -104,6 +107,10 @@ declare const DEFAULT_SIGN_SESSION_TTL_MS = 600000;
|
|
|
104
107
|
* эхлүүлэх» шийдвэрт л — эцсийн үнэн нь `GET /session` (`TIMEOUT`).
|
|
105
108
|
*/
|
|
106
109
|
declare function sessionExpiry(sentAtMs: number, ttlMs?: number): number;
|
|
110
|
+
/** CA-ийн `expiresAt` (RFC 3339) → ms epoch; байхгүй / задрахгүй бол undefined. */
|
|
111
|
+
declare function parseExpiresAt(v: unknown): number | undefined;
|
|
112
|
+
/** Session start-ын дуусах мөч: CA-ийн `expiresAt` байвал түүнийг, үгүй бол {@link sessionExpiry} (тооцоолол). */
|
|
113
|
+
declare function startExpiry(raw: unknown, sentAtMs: number, ttlMs?: number): number;
|
|
107
114
|
/**
|
|
108
115
|
* Device-link (QR/Web2App/App2App) session. Иргэн QR уншиж эсвэл товч дарж нэгдэнэ.
|
|
109
116
|
* `sessionToken`, `sessionSecret`-ийг ЗӨВХӨН backend-д хадгална — браузер руу бүү гарга.
|
|
@@ -136,7 +143,10 @@ interface DeviceLinkSession {
|
|
|
136
143
|
sign?: SignContext;
|
|
137
144
|
/** Certificate-choice session-ий хүсэлтэд илгээсэн нэр (cert холбоосын authCode-д). */
|
|
138
145
|
relyingPartyName?: string;
|
|
139
|
-
/**
|
|
146
|
+
/**
|
|
147
|
+
* Session дуусах мөч (ms epoch): CA-ийн start хариуны `expiresAt`; хуучин CA-д sign / certificate-choice-д тооцоолсон
|
|
148
|
+
* ({@link startExpiry}), auth-д undefined.
|
|
149
|
+
*/
|
|
140
150
|
expiresAt?: number;
|
|
141
151
|
}
|
|
142
152
|
/** Session poll-ийн нэгтгэсэн үр дүн (validator-т орох түүхий материал). */
|
|
@@ -169,11 +179,6 @@ interface SessionResult {
|
|
|
169
179
|
* RP энэ талбарыг л итгэж уншина (клиентийн сонголтод биш). docs/ORG_LOGIN.md.
|
|
170
180
|
*/
|
|
171
181
|
onBehalfOf: OrgResult | null;
|
|
172
|
-
/**
|
|
173
|
-
* PAdES (`POST /pdf/sign/prepare`) session-ий `pdf` блок — PDF урсгал биш бол null (талбар алга = хуучин SDK-аар
|
|
174
|
-
* угсарсан объект). {@link PdfSessionBlock}.
|
|
175
|
-
*/
|
|
176
|
-
pdf?: PdfSessionBlock | null;
|
|
177
182
|
/**
|
|
178
183
|
* COMPLETE+OK auth session-ий `person` блок (CA бүртгэлээс: кирилл нэр, төрсөн огноо, хүйс — гэрчилгээнд байдаггүй).
|
|
179
184
|
* Зөвхөн session эзэмшигч RP-д; CA иргэнийг олоогүй бол null. ГАРЫН ҮСЭГТ ОРДОГГҮЙ — validateAuth-ийн дараа
|
|
@@ -215,35 +220,6 @@ interface TokenCertSessionBlock {
|
|
|
215
220
|
authSerialHex?: string;
|
|
216
221
|
signSerialHex?: string;
|
|
217
222
|
}
|
|
218
|
-
/** PDF баримтын төлөв: PENDING → READY (эсвэл FAILED / EXPIRED). */
|
|
219
|
-
type PdfDocumentStatus = "PENDING" | "READY" | "FAILED" | "EXPIRED";
|
|
220
|
-
/** PAdES гаралтын гарын үсэг зурагч. */
|
|
221
|
-
interface PdfSigner {
|
|
222
|
-
etsi: string;
|
|
223
|
-
certSerial: string;
|
|
224
|
-
/** Байгууллагын нэрийн өмнөөс бол байгууллагын ETSI (`NTRMN-…`) — баримтад бичигдсэн утга. */
|
|
225
|
-
onBehalfOf?: string;
|
|
226
|
-
/** CMS signer-attributes-v2-д бичигдсэн мэдүүлсэн үүрэг: «<албан тушаал>, <нэр> (NTRMN-…)». */
|
|
227
|
-
claimedRole?: string;
|
|
228
|
-
}
|
|
229
|
-
/** GET /session/{id}-ийн `pdf` объект (PAdES, CA угсарна). */
|
|
230
|
-
interface PdfSessionBlock {
|
|
231
|
-
docID: string;
|
|
232
|
-
documentStatus: PdfDocumentStatus | string;
|
|
233
|
-
/** FAILED үед — ж: `REPRESENTATION_REVOKED` (prepare-ээс хойш эрх хасагдсан, баримт үүсээгүй). */
|
|
234
|
-
errorCode?: string;
|
|
235
|
-
/** Гарын үсэгтэй PDF-ийн SHA-256 (hex) — татсан файлтай тулгана. */
|
|
236
|
-
outSha256?: string;
|
|
237
|
-
size?: number;
|
|
238
|
-
expiresAt?: string;
|
|
239
|
-
signatureLevel?: string;
|
|
240
|
-
signer?: PdfSigner;
|
|
241
|
-
validation?: {
|
|
242
|
-
indication: string;
|
|
243
|
-
ltv: boolean;
|
|
244
|
-
signatures: number;
|
|
245
|
-
};
|
|
246
|
-
}
|
|
247
223
|
/** Иргэний төлөөлж чадах нэг байгууллага (GET /organization/representations/etsi/{personEtsi}). */
|
|
248
224
|
interface Representation {
|
|
249
225
|
/** `NTRMN-<бүртгэл>` — `onBehalfOf`-д өгөх утга. */
|
|
@@ -267,6 +243,11 @@ interface Representation {
|
|
|
267
243
|
source: "REGISTRY" | "MANUAL" | string;
|
|
268
244
|
/** Эх үүсвэрийн хүнд харуулах нэр (REGISTRY → «Улсын бүртгэл», MANUAL → «Захирал нэмсэн»; хэл нь `roleLabel`-тэй ижил). Хуучин CA-д байхгүй. */
|
|
269
245
|
sourceLabel?: string;
|
|
246
|
+
/**
|
|
247
|
+
* CMS signer-attributes-v2-д бичих мэдүүлсэн үүрэг («<албан тушаал>, <нэр> (NTRMN-…)») — клиент талын PAdES-д
|
|
248
|
+
* `pades.prepare({claimedRole})`-д ЯГ ХЭВЭЭР өгнө (CA бүртгэлд дахин тооцож тулгана). Хуучин CA-д байхгүй.
|
|
249
|
+
*/
|
|
250
|
+
claimedRole?: string;
|
|
270
251
|
/** ISO 8601. */
|
|
271
252
|
validFrom: string;
|
|
272
253
|
/** ISO 8601; байхгүй = хугацаагүй. */
|
|
@@ -352,135 +333,4 @@ interface OpenOrShowQROptions {
|
|
|
352
333
|
*/
|
|
353
334
|
declare function openOrShowQR(session: DeviceLinkInput, opts: OpenOrShowQROptions): "opened" | "qr";
|
|
354
335
|
|
|
355
|
-
|
|
356
|
-
declare class EidError extends Error {
|
|
357
|
-
constructor(message: string);
|
|
358
|
-
}
|
|
359
|
-
/** HTTP хариуны нэмэлт мэдээлэл (алдааны төрлүүдэд). */
|
|
360
|
-
interface HttpErrorInit {
|
|
361
|
-
/** Хариуны header-ууд. */
|
|
362
|
-
headers?: Headers;
|
|
363
|
-
/** Retry-After (секунд эсвэл HTTP-огноо задалсан), мс; байхгүй/буруу бол undefined. */
|
|
364
|
-
retryAfterMs?: number;
|
|
365
|
-
}
|
|
366
|
-
/**
|
|
367
|
-
* HTTP 401 — API secret буруу/байхгүй. Тохиргооны (RP secret) алдаа. CA-ийн өөрийн 401 нь JSON `{"error"[,"code"]}` —
|
|
368
|
-
* `serverMessage` (ба байвал `code`) бөглөгдөнө; JSON биш (proxy / nginx) бол хоёул undefined — үүгээр CA-ийн 401-ийг
|
|
369
|
-
* proxy-ийнхоос ялгана.
|
|
370
|
-
*/
|
|
371
|
-
declare class AuthenticationError extends EidError {
|
|
372
|
-
/** Серверийн `{"code"}`; байхгүй / JSON биш (proxy) бол undefined. */
|
|
373
|
-
readonly code?: string;
|
|
374
|
-
/** Серверийн `{"error"}` текст (логт); JSON биш (proxy) бол undefined. */
|
|
375
|
-
readonly serverMessage?: string;
|
|
376
|
-
/** Хариуны бие (таслагдаагүй текст). */
|
|
377
|
-
readonly body?: string;
|
|
378
|
-
readonly headers?: Headers;
|
|
379
|
-
constructor(message: string, init?: {
|
|
380
|
-
code?: string;
|
|
381
|
-
serverMessage?: string;
|
|
382
|
-
body?: string;
|
|
383
|
-
headers?: Headers;
|
|
384
|
-
});
|
|
385
|
-
}
|
|
386
|
-
/**
|
|
387
|
-
* HTTP 403 — IP allowlist/mTLS зөвшөөрөөгүй, RP-д эрх алга, эсвэл onBehalfOf-ийн төлөөлөл татгалзсан.
|
|
388
|
-
* Сервер `{"error","code"}` буцаасан бол `code` (ж: `REPRESENTATION_DENIED`) — салааллыг үүгээр хийнэ.
|
|
389
|
-
*/
|
|
390
|
-
declare class ForbiddenError extends EidError {
|
|
391
|
-
/** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
|
|
392
|
-
readonly code?: string | undefined;
|
|
393
|
-
readonly headers?: Headers;
|
|
394
|
-
/** Retry-After (мс), байхгүй бол undefined. */
|
|
395
|
-
readonly retryAfterMs?: number;
|
|
396
|
-
constructor(message: string,
|
|
397
|
-
/** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
|
|
398
|
-
code?: string | undefined, init?: HttpErrorInit);
|
|
399
|
-
}
|
|
400
|
-
/** RP-API-аас ирсэн бусад HTTP алдаа (4xx/5xx). status ба хариуны биеийг агуулна. */
|
|
401
|
-
declare class ApiError extends EidError {
|
|
402
|
-
readonly status: number;
|
|
403
|
-
readonly body: string;
|
|
404
|
-
/** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
|
|
405
|
-
readonly code?: string | undefined;
|
|
406
|
-
readonly headers?: Headers;
|
|
407
|
-
/**
|
|
408
|
-
* Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
|
|
409
|
-
* PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
|
|
410
|
-
*/
|
|
411
|
-
readonly retryAfterMs?: number;
|
|
412
|
-
constructor(status: number, body: string,
|
|
413
|
-
/** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
|
|
414
|
-
code?: string | undefined, init?: HttpErrorInit);
|
|
415
|
-
/**
|
|
416
|
-
* CA-ийн түр алдаа ({@link RETRYABLE_ERROR_CODES}-ийн нэг, эсвэл 429/503 + Retry-After): `retryAfterMs`-ийн дараа
|
|
417
|
-
* ижил хүсэлтийг давтаж болно.
|
|
418
|
-
*/
|
|
419
|
-
get retryable(): boolean;
|
|
420
|
-
}
|
|
421
|
-
/**
|
|
422
|
-
* CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
|
|
423
|
-
* DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
|
|
424
|
-
* STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
|
|
425
|
-
*/
|
|
426
|
-
type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
|
|
427
|
-
/** {@link RetryableErrorCode}-ийн бүх утга. */
|
|
428
|
-
declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
|
|
429
|
-
/** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
|
|
430
|
-
declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
|
|
431
|
-
/**
|
|
432
|
-
* Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
|
|
433
|
-
* `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
|
|
434
|
-
* баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
|
|
435
|
-
* session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
|
|
436
|
-
* баримт үүсээгүй).
|
|
437
|
-
*/
|
|
438
|
-
type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
|
|
439
|
-
/** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
|
|
440
|
-
declare const ON_BEHALF_ERROR_CODES: readonly OnBehalfErrorCode[];
|
|
441
|
-
/**
|
|
442
|
-
* Сүлжээ/timeout — upstream хариу өгсөнгүй. Мессеж ба `op`-д хувь хүний таних тэмдэг ОРОХГҮЙ (замын `/etsi/{…}`,
|
|
443
|
-
* `/document/{…}` → `…`) — шууд лог руу бичиж болно.
|
|
444
|
-
*/
|
|
445
|
-
declare class NetworkError extends EidError {
|
|
446
|
-
/** "GET /session/…" (таних тэмдэг хасагдсан зам). */
|
|
447
|
-
readonly op?: string;
|
|
448
|
-
/** Хүсэлт хугацаа хэтэрсэн. */
|
|
449
|
-
readonly timeout?: boolean;
|
|
450
|
-
constructor(message: string, init?: {
|
|
451
|
-
op?: string;
|
|
452
|
-
timeout?: boolean;
|
|
453
|
-
});
|
|
454
|
-
}
|
|
455
|
-
/**
|
|
456
|
-
* Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
|
|
457
|
-
* таних тэмдэггүй зам.
|
|
458
|
-
*/
|
|
459
|
-
declare class ResponseTooLargeError extends EidError {
|
|
460
|
-
readonly op: string;
|
|
461
|
-
readonly limit: number;
|
|
462
|
-
constructor(op: string, limit: number);
|
|
463
|
-
}
|
|
464
|
-
/**
|
|
465
|
-
* Session амжилтгүй дууссан (endResult ≠ OK): TIMEOUT, USER_REFUSED*, DOCUMENT_UNUSABLE гм.
|
|
466
|
-
* endResult-оор салгаж RP UI-д тохирох мессеж харуулна.
|
|
467
|
-
*/
|
|
468
|
-
declare class SessionFailedError extends EidError {
|
|
469
|
-
readonly endResult: string;
|
|
470
|
-
constructor(endResult: string);
|
|
471
|
-
}
|
|
472
|
-
/**
|
|
473
|
-
* Хариуны баталгаажуулалт бүтэлгүйтсэн — cert chain итгэлцэлгүй, signature challenge-тэй
|
|
474
|
-
* таарсангүй, эсвэл certLevel хүрэлцээгүй. ЭНЭ алдаа гарвал хариунд ИТГЭХГҮЙ
|
|
475
|
-
* (хуурамч/proxy хийгдсэн байж болзошгүй).
|
|
476
|
-
*/
|
|
477
|
-
declare class ValidationError extends EidError {
|
|
478
|
-
}
|
|
479
|
-
/**
|
|
480
|
-
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
|
|
481
|
-
* эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
|
|
482
|
-
*/
|
|
483
|
-
declare class DeviceLinkError extends EidError {
|
|
484
|
-
}
|
|
485
|
-
|
|
486
|
-
export { type AcspContext as A, type SignatureProtocol as B, type CertificateLevel as C, type DeviceLinkSession as D, EidError as E, type FlowType as F, type TokenCertStatus as G, type HashAlgorithm as H, type Interaction as I, deviceLink as J, isMobileUserAgent as K, openOrShowQR as L, parseRetryAfter as M, type NotificationSession as N, ON_BEHALF_ERROR_CODES as O, type PersonBlock as P, sessionExpiry as Q, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, ValidationError as V, type SessionResult as a, type PdfSessionBlock as b, type RepresentationsResponse as c, ApiError as d, AuthenticationError as e, DEFAULT_SIGN_SESSION_TTL_MS as f, DeviceLinkError as g, type DeviceLinkInput as h, type EndResult as i, ForbiddenError as j, type HttpErrorInit as k, type NavigatorLike as l, NetworkError as m, type OnBehalfErrorCode as n, type OpenOrShowQROptions as o, type OrgResult as p, type PdfDocumentStatus as q, type PdfSigner as r, RETRYABLE_ERROR_CODES as s, type Representation as t, ResponseTooLargeError as u, type RetryableErrorCode as v, SessionFailedError as w, type SessionState as x, type SignContext as y, type SignatureAlgorithmParameters as z };
|
|
336
|
+
export { type AcspContext as A, type CertificateLevel as C, type DeviceLinkSession as D, type EndResult as E, type FlowType as F, type HashAlgorithm as H, type Interaction as I, type NotificationSession as N, type OpenOrShowQROptions as O, type PersonBlock as P, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, type SessionResult as a, type RepresentationsResponse as b, DEFAULT_SIGN_SESSION_TTL_MS as c, type DeviceLinkInput as d, type NavigatorLike as e, type OrgResult as f, type Representation as g, type SessionState as h, type SignContext as i, type SignatureAlgorithmParameters as j, type SignatureProtocol as k, type TokenCertStatus as l, deviceLink as m, isMobileUserAgent as n, openOrShowQR as o, parseExpiresAt as p, startExpiry as q, sessionExpiry as s };
|
package/dist/browser.d.cts
CHANGED
|
@@ -1 +1,2 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { d as DeviceLinkInput, D as DeviceLinkSession, e as NavigatorLike, O as OpenOrShowQROptions, m as deviceLink, n as isMobileUserAgent, o as openOrShowQR } from './browser-8k_VDSP8.cjs';
|
|
2
|
+
export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.cjs';
|
package/dist/browser.d.ts
CHANGED
|
@@ -1 +1,2 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { d as DeviceLinkInput, D as DeviceLinkSession, e as NavigatorLike, O as OpenOrShowQROptions, m as deviceLink, n as isMobileUserAgent, o as openOrShowQR } from './browser-BZ3hvv6-.js';
|
|
2
|
+
export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.js';
|
package/dist/browser.js
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import {
|
|
2
|
-
DeviceLinkError,
|
|
3
|
-
EidError,
|
|
4
2
|
deviceLink,
|
|
5
3
|
isMobileUserAgent,
|
|
6
4
|
openOrShowQR
|
|
7
|
-
} from "./chunk-
|
|
5
|
+
} from "./chunk-REWNE7PO.js";
|
|
6
|
+
import {
|
|
7
|
+
DeviceLinkError,
|
|
8
|
+
EidError
|
|
9
|
+
} from "./chunk-TB2KQH3W.js";
|
|
8
10
|
export {
|
|
9
11
|
DeviceLinkError,
|
|
10
12
|
EidError,
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import {
|
|
2
|
+
DeviceLinkError
|
|
3
|
+
} from "./chunk-TB2KQH3W.js";
|
|
4
|
+
|
|
5
|
+
// src/devicelink.ts
|
|
6
|
+
var SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
|
|
7
|
+
var VC_RE = /^[0-9]{5}$/;
|
|
8
|
+
function deviceLink(session) {
|
|
9
|
+
const base = session.deviceLinkBase?.trim();
|
|
10
|
+
if (!base) throw new DeviceLinkError("deviceLink: \u0445\u0430\u0440\u0438\u0443\u043D\u0434 deviceLinkBase \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 device-link session \u044D\u0441\u044D\u0445\u0438\u0439\u0433 \u0448\u0430\u043B\u0433\u0430");
|
|
11
|
+
let u;
|
|
12
|
+
try {
|
|
13
|
+
u = new URL(base);
|
|
14
|
+
} catch {
|
|
15
|
+
throw new DeviceLinkError(`deviceLink: deviceLinkBase \u0431\u0443\u0440\u0443\u0443 URL: ${base}`);
|
|
16
|
+
}
|
|
17
|
+
if (u.protocol !== "https:" && u.protocol !== "http:") {
|
|
18
|
+
throw new DeviceLinkError(`deviceLink: deviceLinkBase https URL \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439: ${u.protocol}`);
|
|
19
|
+
}
|
|
20
|
+
if (!SESSION_ID_RE.test(session.sessionId)) throw new DeviceLinkError("deviceLink: sessionId UUID (lowercase) \u0431\u0438\u0448");
|
|
21
|
+
if (session.vc == null || !VC_RE.test(session.vc)) throw new DeviceLinkError("deviceLink: vc 5 \u043E\u0440\u043E\u043D\u0442\u043E\u0439 \u0442\u043E\u043E \u0431\u0438\u0448");
|
|
22
|
+
u.searchParams.set("sessionId", session.sessionId);
|
|
23
|
+
u.searchParams.set("vc", session.vc);
|
|
24
|
+
return u.toString();
|
|
25
|
+
}
|
|
26
|
+
function isMobileUserAgent(nav) {
|
|
27
|
+
const n = nav ?? globalThis.navigator;
|
|
28
|
+
if (!n) return false;
|
|
29
|
+
if (n.userAgentData?.mobile === true) return true;
|
|
30
|
+
const ua = n.userAgent ?? "";
|
|
31
|
+
if (/Android|iPhone|iPod|iPad/i.test(ua)) return true;
|
|
32
|
+
return /Macintosh/.test(ua) && (n.maxTouchPoints ?? 0) > 1;
|
|
33
|
+
}
|
|
34
|
+
function openOrShowQR(session, opts) {
|
|
35
|
+
const link = deviceLink(session);
|
|
36
|
+
const mobile = typeof opts.isMobile === "function" ? opts.isMobile() : opts.isMobile ?? isMobileUserAgent();
|
|
37
|
+
if (mobile) {
|
|
38
|
+
const loc = globalThis.location;
|
|
39
|
+
if (!loc) throw new DeviceLinkError("openOrShowQR: location \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 \u0437\u04E9\u0432\u0445\u04E9\u043D \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0442");
|
|
40
|
+
loc.assign(link);
|
|
41
|
+
return "opened";
|
|
42
|
+
}
|
|
43
|
+
opts.showQR(link);
|
|
44
|
+
return "qr";
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export {
|
|
48
|
+
deviceLink,
|
|
49
|
+
isMobileUserAgent,
|
|
50
|
+
openOrShowQR
|
|
51
|
+
};
|
|
@@ -60,6 +60,12 @@ var ApiError = class extends EidError {
|
|
|
60
60
|
return (this.status === 429 || this.status === 503) && (this.retryAfterMs ?? 0) > 0;
|
|
61
61
|
}
|
|
62
62
|
};
|
|
63
|
+
var NoSigningCertificateError = class extends ApiError {
|
|
64
|
+
};
|
|
65
|
+
var CertChoiceInvalidError = class extends ApiError {
|
|
66
|
+
};
|
|
67
|
+
var RequestInvalidError = class extends ApiError {
|
|
68
|
+
};
|
|
63
69
|
var RETRYABLE_ERROR_CODES = [
|
|
64
70
|
"PDF_PREPARE_BUSY",
|
|
65
71
|
"DOCUMENT_PENDING",
|
|
@@ -123,53 +129,14 @@ var ValidationError = class extends EidError {
|
|
|
123
129
|
var DeviceLinkError = class extends EidError {
|
|
124
130
|
};
|
|
125
131
|
|
|
126
|
-
// src/devicelink.ts
|
|
127
|
-
var SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
|
|
128
|
-
var VC_RE = /^[0-9]{5}$/;
|
|
129
|
-
function deviceLink(session) {
|
|
130
|
-
const base = session.deviceLinkBase?.trim();
|
|
131
|
-
if (!base) throw new DeviceLinkError("deviceLink: \u0445\u0430\u0440\u0438\u0443\u043D\u0434 deviceLinkBase \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 device-link session \u044D\u0441\u044D\u0445\u0438\u0439\u0433 \u0448\u0430\u043B\u0433\u0430");
|
|
132
|
-
let u;
|
|
133
|
-
try {
|
|
134
|
-
u = new URL(base);
|
|
135
|
-
} catch {
|
|
136
|
-
throw new DeviceLinkError(`deviceLink: deviceLinkBase \u0431\u0443\u0440\u0443\u0443 URL: ${base}`);
|
|
137
|
-
}
|
|
138
|
-
if (u.protocol !== "https:" && u.protocol !== "http:") {
|
|
139
|
-
throw new DeviceLinkError(`deviceLink: deviceLinkBase https URL \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439: ${u.protocol}`);
|
|
140
|
-
}
|
|
141
|
-
if (!SESSION_ID_RE.test(session.sessionId)) throw new DeviceLinkError("deviceLink: sessionId UUID (lowercase) \u0431\u0438\u0448");
|
|
142
|
-
if (session.vc == null || !VC_RE.test(session.vc)) throw new DeviceLinkError("deviceLink: vc 5 \u043E\u0440\u043E\u043D\u0442\u043E\u0439 \u0442\u043E\u043E \u0431\u0438\u0448");
|
|
143
|
-
u.searchParams.set("sessionId", session.sessionId);
|
|
144
|
-
u.searchParams.set("vc", session.vc);
|
|
145
|
-
return u.toString();
|
|
146
|
-
}
|
|
147
|
-
function isMobileUserAgent(nav) {
|
|
148
|
-
const n = nav ?? globalThis.navigator;
|
|
149
|
-
if (!n) return false;
|
|
150
|
-
if (n.userAgentData?.mobile === true) return true;
|
|
151
|
-
const ua = n.userAgent ?? "";
|
|
152
|
-
if (/Android|iPhone|iPod|iPad/i.test(ua)) return true;
|
|
153
|
-
return /Macintosh/.test(ua) && (n.maxTouchPoints ?? 0) > 1;
|
|
154
|
-
}
|
|
155
|
-
function openOrShowQR(session, opts) {
|
|
156
|
-
const link = deviceLink(session);
|
|
157
|
-
const mobile = typeof opts.isMobile === "function" ? opts.isMobile() : opts.isMobile ?? isMobileUserAgent();
|
|
158
|
-
if (mobile) {
|
|
159
|
-
const loc = globalThis.location;
|
|
160
|
-
if (!loc) throw new DeviceLinkError("openOrShowQR: location \u0431\u0430\u0439\u0445\u0433\u04AF\u0439 \u2014 \u0437\u04E9\u0432\u0445\u04E9\u043D \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0442");
|
|
161
|
-
loc.assign(link);
|
|
162
|
-
return "opened";
|
|
163
|
-
}
|
|
164
|
-
opts.showQR(link);
|
|
165
|
-
return "qr";
|
|
166
|
-
}
|
|
167
|
-
|
|
168
132
|
export {
|
|
169
133
|
EidError,
|
|
170
134
|
AuthenticationError,
|
|
171
135
|
ForbiddenError,
|
|
172
136
|
ApiError,
|
|
137
|
+
NoSigningCertificateError,
|
|
138
|
+
CertChoiceInvalidError,
|
|
139
|
+
RequestInvalidError,
|
|
173
140
|
RETRYABLE_ERROR_CODES,
|
|
174
141
|
parseRetryAfter,
|
|
175
142
|
ON_BEHALF_ERROR_CODES,
|
|
@@ -178,8 +145,5 @@ export {
|
|
|
178
145
|
maskPath,
|
|
179
146
|
SessionFailedError,
|
|
180
147
|
ValidationError,
|
|
181
|
-
DeviceLinkError
|
|
182
|
-
deviceLink,
|
|
183
|
-
isMobileUserAgent,
|
|
184
|
-
openOrShowQR
|
|
148
|
+
DeviceLinkError
|
|
185
149
|
};
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
/** Бүх SDK алдааны суурь. */
|
|
2
|
+
declare class EidError extends Error {
|
|
3
|
+
constructor(message: string);
|
|
4
|
+
}
|
|
5
|
+
/** HTTP хариуны нэмэлт мэдээлэл (алдааны төрлүүдэд). */
|
|
6
|
+
interface HttpErrorInit {
|
|
7
|
+
/** Хариуны header-ууд. */
|
|
8
|
+
headers?: Headers;
|
|
9
|
+
/** Retry-After (секунд эсвэл HTTP-огноо задалсан), мс; байхгүй/буруу бол undefined. */
|
|
10
|
+
retryAfterMs?: number;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* HTTP 401 — API secret буруу/байхгүй. Тохиргооны (RP secret) алдаа. CA-ийн өөрийн 401 нь JSON `{"error"[,"code"]}` —
|
|
14
|
+
* `serverMessage` (ба байвал `code`) бөглөгдөнө; JSON биш (proxy / nginx) бол хоёул undefined — үүгээр CA-ийн 401-ийг
|
|
15
|
+
* proxy-ийнхоос ялгана.
|
|
16
|
+
*/
|
|
17
|
+
declare class AuthenticationError extends EidError {
|
|
18
|
+
/** Серверийн `{"code"}`; байхгүй / JSON биш (proxy) бол undefined. */
|
|
19
|
+
readonly code?: string;
|
|
20
|
+
/** Серверийн `{"error"}` текст (логт); JSON биш (proxy) бол undefined. */
|
|
21
|
+
readonly serverMessage?: string;
|
|
22
|
+
/** Хариуны бие (таслагдаагүй текст). */
|
|
23
|
+
readonly body?: string;
|
|
24
|
+
readonly headers?: Headers;
|
|
25
|
+
constructor(message: string, init?: {
|
|
26
|
+
code?: string;
|
|
27
|
+
serverMessage?: string;
|
|
28
|
+
body?: string;
|
|
29
|
+
headers?: Headers;
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* HTTP 403 — IP allowlist/mTLS зөвшөөрөөгүй, RP-д эрх алга, эсвэл onBehalfOf-ийн төлөөлөл татгалзсан.
|
|
34
|
+
* Сервер `{"error","code"}` буцаасан бол `code` (ж: `REPRESENTATION_DENIED`) — салааллыг үүгээр хийнэ.
|
|
35
|
+
*/
|
|
36
|
+
declare class ForbiddenError extends EidError {
|
|
37
|
+
/** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
|
|
38
|
+
readonly code?: string | undefined;
|
|
39
|
+
readonly headers?: Headers;
|
|
40
|
+
/** Retry-After (мс), байхгүй бол undefined. */
|
|
41
|
+
readonly retryAfterMs?: number;
|
|
42
|
+
constructor(message: string,
|
|
43
|
+
/** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
|
|
44
|
+
code?: string | undefined, init?: HttpErrorInit);
|
|
45
|
+
}
|
|
46
|
+
/** RP-API-аас ирсэн бусад HTTP алдаа (4xx/5xx). status ба хариуны биеийг агуулна. */
|
|
47
|
+
declare class ApiError extends EidError {
|
|
48
|
+
readonly status: number;
|
|
49
|
+
readonly body: string;
|
|
50
|
+
/** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
|
|
51
|
+
readonly code?: string | undefined;
|
|
52
|
+
readonly headers?: Headers;
|
|
53
|
+
/**
|
|
54
|
+
* Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
|
|
55
|
+
* PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
|
|
56
|
+
*/
|
|
57
|
+
readonly retryAfterMs?: number;
|
|
58
|
+
constructor(status: number, body: string,
|
|
59
|
+
/** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
|
|
60
|
+
code?: string | undefined, init?: HttpErrorInit);
|
|
61
|
+
/**
|
|
62
|
+
* CA-ийн түр алдаа ({@link RETRYABLE_ERROR_CODES}-ийн нэг, эсвэл 429/503 + Retry-After): `retryAfterMs`-ийн дараа
|
|
63
|
+
* ижил хүсэлтийг давтаж болно.
|
|
64
|
+
*/
|
|
65
|
+
get retryable(): boolean;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 409 `NO_SIGNING_CERTIFICATE` — иргэнд (баримтад) идэвхтэй төхөөрөмж / SIGN credential / хүчинтэй гарын үсгийн
|
|
69
|
+
* гэрчилгээ алга: sign ба certificate-choice session start, `/pdf/sign/prepare`. Session үүсээгүй. Танихгүй
|
|
70
|
+
* лавлагаанд ч ижил хариу (бүртгэл задлахгүй) — хэрэглэгчид «eID гарын үсгийн гэрчилгээгүй» гэж харуулна.
|
|
71
|
+
*/
|
|
72
|
+
declare class NoSigningCertificateError extends ApiError {
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй: өөр RP, COMPLETE+OK биш,
|
|
76
|
+
* өөр documentNumber, 5 минутаас хуучин, гэрчилгээ солигдсон, эсвэл аль хэдийн ашиглагдсан. Certificate-choice-ийг
|
|
77
|
+
* дахин эхлүүлнэ.
|
|
78
|
+
*/
|
|
79
|
+
declare class CertChoiceInvalidError extends ApiError {
|
|
80
|
+
}
|
|
81
|
+
/** 400 `REQUEST_INVALID` — хүсэлтийн бие/талбар буруу (ж: linked sign-д `linkedSessionID` дутуу). Програмын алдаа. */
|
|
82
|
+
declare class RequestInvalidError extends ApiError {
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
|
|
86
|
+
* DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
|
|
87
|
+
* STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
|
|
88
|
+
*/
|
|
89
|
+
type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
|
|
90
|
+
/** {@link RetryableErrorCode}-ийн бүх утга. */
|
|
91
|
+
declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
|
|
92
|
+
/** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
|
|
93
|
+
declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
|
|
94
|
+
/**
|
|
95
|
+
* Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
|
|
96
|
+
* `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
|
|
97
|
+
* баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
|
|
98
|
+
* session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
|
|
99
|
+
* баримт үүсээгүй).
|
|
100
|
+
*/
|
|
101
|
+
type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
|
|
102
|
+
/** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
|
|
103
|
+
declare const ON_BEHALF_ERROR_CODES: readonly OnBehalfErrorCode[];
|
|
104
|
+
/**
|
|
105
|
+
* Сүлжээ/timeout — upstream хариу өгсөнгүй. Мессеж ба `op`-д хувь хүний таних тэмдэг ОРОХГҮЙ (замын `/etsi/{…}`,
|
|
106
|
+
* `/document/{…}` → `…`) — шууд лог руу бичиж болно.
|
|
107
|
+
*/
|
|
108
|
+
declare class NetworkError extends EidError {
|
|
109
|
+
/** "GET /session/…" (таних тэмдэг хасагдсан зам). */
|
|
110
|
+
readonly op?: string;
|
|
111
|
+
/** Хүсэлт хугацаа хэтэрсэн. */
|
|
112
|
+
readonly timeout?: boolean;
|
|
113
|
+
constructor(message: string, init?: {
|
|
114
|
+
op?: string;
|
|
115
|
+
timeout?: boolean;
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
|
|
120
|
+
* таних тэмдэггүй зам.
|
|
121
|
+
*/
|
|
122
|
+
declare class ResponseTooLargeError extends EidError {
|
|
123
|
+
readonly op: string;
|
|
124
|
+
readonly limit: number;
|
|
125
|
+
constructor(op: string, limit: number);
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* Session амжилтгүй дууссан (endResult ≠ OK): TIMEOUT, USER_REFUSED*, DOCUMENT_UNUSABLE гм.
|
|
129
|
+
* endResult-оор салгаж RP UI-д тохирох мессеж харуулна.
|
|
130
|
+
*/
|
|
131
|
+
declare class SessionFailedError extends EidError {
|
|
132
|
+
readonly endResult: string;
|
|
133
|
+
constructor(endResult: string);
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* Хариуны баталгаажуулалт бүтэлгүйтсэн — cert chain итгэлцэлгүй, signature challenge-тэй
|
|
137
|
+
* таарсангүй, эсвэл certLevel хүрэлцээгүй. ЭНЭ алдаа гарвал хариунд ИТГЭХГҮЙ
|
|
138
|
+
* (хуурамч/proxy хийгдсэн байж болзошгүй).
|
|
139
|
+
*/
|
|
140
|
+
declare class ValidationError extends EidError {
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Device-link (App2App/Web2App) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
|
|
144
|
+
* эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
|
|
145
|
+
*/
|
|
146
|
+
declare class DeviceLinkError extends EidError {
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
export { ApiError as A, CertChoiceInvalidError as C, DeviceLinkError as D, EidError as E, ForbiddenError as F, type HttpErrorInit as H, NetworkError as N, ON_BEHALF_ERROR_CODES as O, RETRYABLE_ERROR_CODES as R, SessionFailedError as S, ValidationError as V, AuthenticationError as a, NoSigningCertificateError as b, type OnBehalfErrorCode as c, RequestInvalidError as d, ResponseTooLargeError as e, type RetryableErrorCode as f, parseRetryAfter as p };
|