@gerege-systems/eid-mongolia-sdk 0.14.2 → 0.15.1

package/dist/{chunk-DXVHOZO7.js → chunk-TB2KQH3W.js}

@@ -129,48 +129,6 @@ var ValidationError = class extends EidError {
 var DeviceLinkError = class extends EidError {
 };
 
-// src/devicelink.ts
-var SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
-var VC_RE = /^[0-9]{5}$/;
-function deviceLink(session) {
-  const base = session.deviceLinkBase?.trim();
-  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");
-  let u;
-  try {
-    u = new URL(base);
-  } catch {
-    throw new DeviceLinkError(`deviceLink: deviceLinkBase \u0431\u0443\u0440\u0443\u0443 URL: ${base}`);
-  }
-  if (u.protocol !== "https:" && u.protocol !== "http:") {
-    throw new DeviceLinkError(`deviceLink: deviceLinkBase https URL \u0431\u0430\u0439\u0445 \u0451\u0441\u0442\u043E\u0439: ${u.protocol}`);
-  }
-  if (!SESSION_ID_RE.test(session.sessionId)) throw new DeviceLinkError("deviceLink: sessionId UUID (lowercase) \u0431\u0438\u0448");
-  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");
-  u.searchParams.set("sessionId", session.sessionId);
-  u.searchParams.set("vc", session.vc);
-  return u.toString();
-}
-function isMobileUserAgent(nav) {
-  const n = nav ?? globalThis.navigator;
-  if (!n) return false;
-  if (n.userAgentData?.mobile === true) return true;
-  const ua = n.userAgent ?? "";
-  if (/Android|iPhone|iPod|iPad/i.test(ua)) return true;
-  return /Macintosh/.test(ua) && (n.maxTouchPoints ?? 0) > 1;
-}
-function openOrShowQR(session, opts) {
-  const link = deviceLink(session);
-  const mobile = typeof opts.isMobile === "function" ? opts.isMobile() : opts.isMobile ?? isMobileUserAgent();
-  if (mobile) {
-    const loc = globalThis.location;
-    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");
-    loc.assign(link);
-    return "opened";
-  }
-  opts.showQR(link);
-  return "qr";
-}
-
 export {
   EidError,
   AuthenticationError,
@@ -187,8 +145,5 @@ export {
   maskPath,
   SessionFailedError,
   ValidationError,
-  DeviceLinkError,
-  deviceLink,
-  isMobileUserAgent,
-  openOrShowQR
+  DeviceLinkError
 };

package/dist/errors-Z7SgLVTr.d.cts

@@ -0,0 +1,149 @@
+/** Бүх SDK алдааны суурь. */
+declare class EidError extends Error {
+    constructor(message: string);
+}
+/** HTTP хариуны нэмэлт мэдээлэл (алдааны төрлүүдэд). */
+interface HttpErrorInit {
+    /** Хариуны header-ууд. */
+    headers?: Headers;
+    /** Retry-After (секунд эсвэл HTTP-огноо задалсан), мс; байхгүй/буруу бол undefined. */
+    retryAfterMs?: number;
+}
+/**
+ * HTTP 401 — API secret буруу/байхгүй. Тохиргооны (RP secret) алдаа. CA-ийн өөрийн 401 нь JSON `{"error"[,"code"]}` —
+ * `serverMessage` (ба байвал `code`) бөглөгдөнө; JSON биш (proxy / nginx) бол хоёул undefined — үүгээр CA-ийн 401-ийг
+ * proxy-ийнхоос ялгана.
+ */
+declare class AuthenticationError extends EidError {
+    /** Серверийн `{"code"}`; байхгүй / JSON биш (proxy) бол undefined. */
+    readonly code?: string;
+    /** Серверийн `{"error"}` текст (логт); JSON биш (proxy) бол undefined. */
+    readonly serverMessage?: string;
+    /** Хариуны бие (таслагдаагүй текст). */
+    readonly body?: string;
+    readonly headers?: Headers;
+    constructor(message: string, init?: {
+        code?: string;
+        serverMessage?: string;
+        body?: string;
+        headers?: Headers;
+    });
+}
+/**
+ * HTTP 403 — IP allowlist/mTLS зөвшөөрөөгүй, RP-д эрх алга, эсвэл onBehalfOf-ийн төлөөлөл татгалзсан.
+ * Сервер `{"error","code"}` буцаасан бол `code` (ж: `REPRESENTATION_DENIED`) — салааллыг үүгээр хийнэ.
+ */
+declare class ForbiddenError extends EidError {
+    /** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
+    readonly code?: string | undefined;
+    readonly headers?: Headers;
+    /** Retry-After (мс), байхгүй бол undefined. */
+    readonly retryAfterMs?: number;
+    constructor(message: string, 
+    /** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
+    code?: string | undefined, init?: HttpErrorInit);
+}
+/** RP-API-аас ирсэн бусад HTTP алдаа (4xx/5xx). status ба хариуны биеийг агуулна. */
+declare class ApiError extends EidError {
+    readonly status: number;
+    readonly body: string;
+    /** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
+    readonly code?: string | undefined;
+    readonly headers?: Headers;
+    /**
+     * Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
+     * PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
+     */
+    readonly retryAfterMs?: number;
+    constructor(status: number, body: string, 
+    /** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
+    code?: string | undefined, init?: HttpErrorInit);
+    /**
+     * CA-ийн түр алдаа ({@link RETRYABLE_ERROR_CODES}-ийн нэг, эсвэл 429/503 + Retry-After): `retryAfterMs`-ийн дараа
+     * ижил хүсэлтийг давтаж болно.
+     */
+    get retryable(): boolean;
+}
+/**
+ * 409 `NO_SIGNING_CERTIFICATE` — иргэнд (баримтад) идэвхтэй төхөөрөмж / SIGN credential / хүчинтэй гарын үсгийн
+ * гэрчилгээ алга: sign ба certificate-choice session start, `/pdf/sign/prepare`. Session үүсээгүй. Танихгүй
+ * лавлагаанд ч ижил хариу (бүртгэл задлахгүй) — хэрэглэгчид «eID гарын үсгийн гэрчилгээгүй» гэж харуулна.
+ */
+declare class NoSigningCertificateError extends ApiError {
+}
+/**
+ * 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй: өөр RP, COMPLETE+OK биш,
+ * өөр documentNumber, 5 минутаас хуучин, гэрчилгээ солигдсон, эсвэл аль хэдийн ашиглагдсан. Certificate-choice-ийг
+ * дахин эхлүүлнэ.
+ */
+declare class CertChoiceInvalidError extends ApiError {
+}
+/** 400 `REQUEST_INVALID` — хүсэлтийн бие/талбар буруу (ж: linked sign-д `linkedSessionID` дутуу). Програмын алдаа. */
+declare class RequestInvalidError extends ApiError {
+}
+/**
+ * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
+ * DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
+ * STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
+ */
+type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
+/** {@link RetryableErrorCode}-ийн бүх утга. */
+declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
+/** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
+/**
+ * Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
+ * `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
+ * баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
+ * session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
+ * баримт үүсээгүй).
+ */
+type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
+/** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
+declare const ON_BEHALF_ERROR_CODES: readonly OnBehalfErrorCode[];
+/**
+ * Сүлжээ/timeout — upstream хариу өгсөнгүй. Мессеж ба `op`-д хувь хүний таних тэмдэг ОРОХГҮЙ (замын `/etsi/{…}`,
+ * `/document/{…}` → `…`) — шууд лог руу бичиж болно.
+ */
+declare class NetworkError extends EidError {
+    /** "GET /session/…" (таних тэмдэг хасагдсан зам). */
+    readonly op?: string;
+    /** Хүсэлт хугацаа хэтэрсэн. */
+    readonly timeout?: boolean;
+    constructor(message: string, init?: {
+        op?: string;
+        timeout?: boolean;
+    });
+}
+/**
+ * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
+ * таних тэмдэггүй зам.
+ */
+declare class ResponseTooLargeError extends EidError {
+    readonly op: string;
+    readonly limit: number;
+    constructor(op: string, limit: number);
+}
+/**
+ * Session амжилтгүй дууссан (endResult ≠ OK): TIMEOUT, USER_REFUSED*, DOCUMENT_UNUSABLE гм.
+ * endResult-оор салгаж RP UI-д тохирох мессеж харуулна.
+ */
+declare class SessionFailedError extends EidError {
+    readonly endResult: string;
+    constructor(endResult: string);
+}
+/**
+ * Хариуны баталгаажуулалт бүтэлгүйтсэн — cert chain итгэлцэлгүй, signature challenge-тэй
+ * таарсангүй, эсвэл certLevel хүрэлцээгүй. ЭНЭ алдаа гарвал хариунд ИТГЭХГҮЙ
+ * (хуурамч/proxy хийгдсэн байж болзошгүй).
+ */
+declare class ValidationError extends EidError {
+}
+/**
+ * Device-link (App2App/Web2App) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
+ * эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
+ */
+declare class DeviceLinkError extends EidError {
+}
+
+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 };

package/dist/errors-Z7SgLVTr.d.ts

@@ -0,0 +1,149 @@
+/** Бүх SDK алдааны суурь. */
+declare class EidError extends Error {
+    constructor(message: string);
+}
+/** HTTP хариуны нэмэлт мэдээлэл (алдааны төрлүүдэд). */
+interface HttpErrorInit {
+    /** Хариуны header-ууд. */
+    headers?: Headers;
+    /** Retry-After (секунд эсвэл HTTP-огноо задалсан), мс; байхгүй/буруу бол undefined. */
+    retryAfterMs?: number;
+}
+/**
+ * HTTP 401 — API secret буруу/байхгүй. Тохиргооны (RP secret) алдаа. CA-ийн өөрийн 401 нь JSON `{"error"[,"code"]}` —
+ * `serverMessage` (ба байвал `code`) бөглөгдөнө; JSON биш (proxy / nginx) бол хоёул undefined — үүгээр CA-ийн 401-ийг
+ * proxy-ийнхоос ялгана.
+ */
+declare class AuthenticationError extends EidError {
+    /** Серверийн `{"code"}`; байхгүй / JSON биш (proxy) бол undefined. */
+    readonly code?: string;
+    /** Серверийн `{"error"}` текст (логт); JSON биш (proxy) бол undefined. */
+    readonly serverMessage?: string;
+    /** Хариуны бие (таслагдаагүй текст). */
+    readonly body?: string;
+    readonly headers?: Headers;
+    constructor(message: string, init?: {
+        code?: string;
+        serverMessage?: string;
+        body?: string;
+        headers?: Headers;
+    });
+}
+/**
+ * HTTP 403 — IP allowlist/mTLS зөвшөөрөөгүй, RP-д эрх алга, эсвэл onBehalfOf-ийн төлөөлөл татгалзсан.
+ * Сервер `{"error","code"}` буцаасан бол `code` (ж: `REPRESENTATION_DENIED`) — салааллыг үүгээр хийнэ.
+ */
+declare class ForbiddenError extends EidError {
+    /** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
+    readonly code?: string | undefined;
+    readonly headers?: Headers;
+    /** Retry-After (мс), байхгүй бол undefined. */
+    readonly retryAfterMs?: number;
+    constructor(message: string, 
+    /** Серверийн тогтвортой алдааны код (`{"code"}`), байхгүй бол undefined. */
+    code?: string | undefined, init?: HttpErrorInit);
+}
+/** RP-API-аас ирсэн бусад HTTP алдаа (4xx/5xx). status ба хариуны биеийг агуулна. */
+declare class ApiError extends EidError {
+    readonly status: number;
+    readonly body: string;
+    /** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
+    readonly code?: string | undefined;
+    readonly headers?: Headers;
+    /**
+     * Retry-After (мс, секунд эсвэл HTTP-огноо задалсан); байхгүй/буруу бол undefined. CA түр алдаанд (429
+     * PDF_PREPARE_BUSY / RATE_LIMITED, 503 DOCUMENT_PENDING / TSA_UNAVAILABLE / LTV_UNAVAILABLE г.м.) тавина.
+     */
+    readonly retryAfterMs?: number;
+    constructor(status: number, body: string, 
+    /** Серверийн тогтвортой алдааны код (`{"error","code"}`-ийн `code`), байхгүй бол undefined. */
+    code?: string | undefined, init?: HttpErrorInit);
+    /**
+     * CA-ийн түр алдаа ({@link RETRYABLE_ERROR_CODES}-ийн нэг, эсвэл 429/503 + Retry-After): `retryAfterMs`-ийн дараа
+     * ижил хүсэлтийг давтаж болно.
+     */
+    get retryable(): boolean;
+}
+/**
+ * 409 `NO_SIGNING_CERTIFICATE` — иргэнд (баримтад) идэвхтэй төхөөрөмж / SIGN credential / хүчинтэй гарын үсгийн
+ * гэрчилгээ алга: sign ба certificate-choice session start, `/pdf/sign/prepare`. Session үүсээгүй. Танихгүй
+ * лавлагаанд ч ижил хариу (бүртгэл задлахгүй) — хэрэглэгчид «eID гарын үсгийн гэрчилгээгүй» гэж харуулна.
+ */
+declare class NoSigningCertificateError extends ApiError {
+}
+/**
+ * 409 `CERT_CHOICE_INVALID` — linked sign-ийн `linkedSessionID` (certificate-choice) хүчингүй: өөр RP, COMPLETE+OK биш,
+ * өөр documentNumber, 5 минутаас хуучин, гэрчилгээ солигдсон, эсвэл аль хэдийн ашиглагдсан. Certificate-choice-ийг
+ * дахин эхлүүлнэ.
+ */
+declare class CertChoiceInvalidError extends ApiError {
+}
+/** 400 `REQUEST_INVALID` — хүсэлтийн бие/талбар буруу (ж: linked sign-д `linkedSessionID` дутуу). Програмын алдаа. */
+declare class RequestInvalidError extends ApiError {
+}
+/**
+ * CA-ийн түр (давтаж болох) алдааны кодууд — `ApiError.code`. PDF_PREPARE_BUSY (429 prepare, Retry-After 5),
+ * DOCUMENT_PENDING (503 document, 5), TSA_UNAVAILABLE (503, 30), LTV_UNAVAILABLE (503, 60), RATE_LIMITED (429 токен),
+ * STATE_UNAVAILABLE (503 токен), ISSUANCE_PENDING (503 токены үр дүн, 5).
+ */
+type RetryableErrorCode = "PDF_PREPARE_BUSY" | "DOCUMENT_PENDING" | "TSA_UNAVAILABLE" | "LTV_UNAVAILABLE" | "RATE_LIMITED" | "STATE_UNAVAILABLE" | "ISSUANCE_PENDING";
+/** {@link RetryableErrorCode}-ийн бүх утга. */
+declare const RETRYABLE_ERROR_CODES: readonly RetryableErrorCode[];
+/** RFC 9110 §10.2.3: delay-seconds эсвэл HTTP-date → мс. Буруу / өнгөрсөн / 24 цагаас их → undefined. */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
+/**
+ * Байгууллагын нэрийн өмнөөс (`onBehalfOf`) урсгалын татгалзлын кодууд — `ForbiddenError.code` /
+ * `ApiError.code`-д ирнэ. 403: REPRESENTATION_DENIED (идэвхтэй төлөөлөгч биш), REPRESENTATION_PENDING (PIN2-оор
+ * баталгаажуулаагүй), REPRESENTATION_EXPIRED (хугацааны гадна), ORG_NOT_ACTIVE, SIGNER_UNIDENTIFIED (anonymous
+ * session); 404: ORG_NOT_FOUND; PDF баримт татахад 403 REPRESENTATION_REVOKED (prepare-ээс хойш эрх хасагдсан —
+ * баримт үүсээгүй).
+ */
+type OnBehalfErrorCode = "REPRESENTATION_DENIED" | "REPRESENTATION_PENDING" | "REPRESENTATION_EXPIRED" | "ORG_NOT_ACTIVE" | "SIGNER_UNIDENTIFIED" | "ORG_NOT_FOUND" | "REPRESENTATION_REVOKED";
+/** {@link OnBehalfErrorCode}-ийн бүх утга (runtime шалгалтад). */
+declare const ON_BEHALF_ERROR_CODES: readonly OnBehalfErrorCode[];
+/**
+ * Сүлжээ/timeout — upstream хариу өгсөнгүй. Мессеж ба `op`-д хувь хүний таних тэмдэг ОРОХГҮЙ (замын `/etsi/{…}`,
+ * `/document/{…}` → `…`) — шууд лог руу бичиж болно.
+ */
+declare class NetworkError extends EidError {
+    /** "GET /session/…" (таних тэмдэг хасагдсан зам). */
+    readonly op?: string;
+    /** Хүсэлт хугацаа хэтэрсэн. */
+    readonly timeout?: boolean;
+    constructor(message: string, init?: {
+        op?: string;
+        timeout?: boolean;
+    });
+}
+/**
+ * Хариуны бие SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — бие таслагдаж задлагдахгүй. `op` — method +
+ * таних тэмдэггүй зам.
+ */
+declare class ResponseTooLargeError extends EidError {
+    readonly op: string;
+    readonly limit: number;
+    constructor(op: string, limit: number);
+}
+/**
+ * Session амжилтгүй дууссан (endResult ≠ OK): TIMEOUT, USER_REFUSED*, DOCUMENT_UNUSABLE гм.
+ * endResult-оор салгаж RP UI-д тохирох мессеж харуулна.
+ */
+declare class SessionFailedError extends EidError {
+    readonly endResult: string;
+    constructor(endResult: string);
+}
+/**
+ * Хариуны баталгаажуулалт бүтэлгүйтсэн — cert chain итгэлцэлгүй, signature challenge-тэй
+ * таарсангүй, эсвэл certLevel хүрэлцээгүй. ЭНЭ алдаа гарвал хариунд ИТГЭХГҮЙ
+ * (хуурамч/proxy хийгдсэн байж болзошгүй).
+ */
+declare class ValidationError extends EidError {
+}
+/**
+ * Device-link (App2App/Web2App) холбоос угсрах боломжгүй — хариунд `deviceLinkBase` байхгүй,
+ * эсвэл sessionId/vc/суурь URL хэлбэр буруу. Session-ийг дахин эхлүүлнэ; холбоосыг таахгүй.
+ */
+declare class DeviceLinkError extends EidError {
+}
+
+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 };