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

package/dist/{browser-CSZjH9Xs.d.ts → browser-BZ3hvv6-.d.ts}

@@ -1,3 +1,5 @@
+import './errors-Z7SgLVTr.js';
+
 /** Сертификатын баталгаажуулалтын түвшин (eIDAS LoA). QUALIFIED — хууль ёсны гарын үсэгт. */
 type CertificateLevel = "ADVANCED" | "QUALIFIED" | "QSCD";
 /** Гарын үсгийн протокол: auth → ACSP_V2, sign → RAW_DIGEST_SIGNATURE (Smart-ID v3). */
@@ -177,11 +179,6 @@ interface SessionResult {
      * RP энэ талбарыг л итгэж уншина (клиентийн сонголтод биш). docs/ORG_LOGIN.md.
      */
     onBehalfOf: OrgResult | null;
-    /**
-     * PAdES (`POST /pdf/sign/prepare`) session-ий `pdf` блок — PDF урсгал биш бол null (талбар алга = хуучин SDK-аар
-     * угсарсан объект). {@link PdfSessionBlock}.
-     */
-    pdf?: PdfSessionBlock | null;
     /**
      * COMPLETE+OK auth session-ий `person` блок (CA бүртгэлээс: кирилл нэр, төрсөн огноо, хүйс — гэрчилгээнд байдаггүй).
      * Зөвхөн session эзэмшигч RP-д; CA иргэнийг олоогүй бол null. ГАРЫН ҮСЭГТ ОРДОГГҮЙ — validateAuth-ийн дараа
@@ -223,35 +220,6 @@ interface TokenCertSessionBlock {
     authSerialHex?: string;
     signSerialHex?: string;
 }
-/** PDF баримтын төлөв: PENDING → READY (эсвэл FAILED / EXPIRED). */
-type PdfDocumentStatus = "PENDING" | "READY" | "FAILED" | "EXPIRED";
-/** PAdES гаралтын гарын үсэг зурагч. */
-interface PdfSigner {
-    etsi: string;
-    certSerial: string;
-    /** Байгууллагын нэрийн өмнөөс бол байгууллагын ETSI (`NTRMN-…`) — баримтад бичигдсэн утга. */
-    onBehalfOf?: string;
-    /** CMS signer-attributes-v2-д бичигдсэн мэдүүлсэн үүрэг: «<албан тушаал>, <нэр> (NTRMN-…)». */
-    claimedRole?: string;
-}
-/** GET /session/{id}-ийн `pdf` объект (PAdES, CA угсарна). */
-interface PdfSessionBlock {
-    docID: string;
-    documentStatus: PdfDocumentStatus | string;
-    /** FAILED үед — ж: `REPRESENTATION_REVOKED` (prepare-ээс хойш эрх хасагдсан, баримт үүсээгүй). */
-    errorCode?: string;
-    /** Гарын үсэгтэй PDF-ийн SHA-256 (hex) — татсан файлтай тулгана. */
-    outSha256?: string;
-    size?: number;
-    expiresAt?: string;
-    signatureLevel?: string;
-    signer?: PdfSigner;
-    validation?: {
-        indication: string;
-        ltv: boolean;
-        signatures: number;
-    };
-}
 /** Иргэний төлөөлж чадах нэг байгууллага (GET /organization/representations/etsi/{personEtsi}). */
 interface Representation {
     /** `NTRMN-<бүртгэл>` — `onBehalfOf`-д өгөх утга. */
@@ -275,6 +243,11 @@ interface Representation {
     source: "REGISTRY" | "MANUAL" | string;
     /** Эх үүсвэрийн хүнд харуулах нэр (REGISTRY → «Улсын бүртгэл», MANUAL → «Захирал нэмсэн»; хэл нь `roleLabel`-тэй ижил). Хуучин CA-д байхгүй. */
     sourceLabel?: string;
+    /**
+     * CMS signer-attributes-v2-д бичих мэдүүлсэн үүрэг («<албан тушаал>, <нэр> (NTRMN-…)») — клиент талын PAdES-д
+     * `pades.prepare({claimedRole})`-д ЯГ ХЭВЭЭР өгнө (CA бүртгэлд дахин тооцож тулгана). Хуучин CA-д байхгүй.
+     */
+    claimedRole?: string;
     /** ISO 8601. */
     validFrom: string;
     /** ISO 8601; байхгүй = хугацаагүй. */
@@ -360,152 +333,4 @@ interface OpenOrShowQROptions {
  */
 declare function openOrShowQR(session: DeviceLinkInput, opts: OpenOrShowQROptions): "opened" | "qr";
 
-/** Бүх 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 { type AcspContext as A, type SessionState as B, type CertificateLevel as C, type DeviceLinkSession as D, EidError as E, type FlowType as F, type SignContext as G, type HashAlgorithm as H, type Interaction as I, type SignatureAlgorithmParameters as J, type SignatureProtocol as K, type TokenCertStatus as L, deviceLink as M, type NotificationSession as N, ON_BEHALF_ERROR_CODES as O, type PersonBlock as P, isMobileUserAgent as Q, type RpCredentials as R, type SignatureAlgorithm as S, type TokenCertSessionBlock as T, openOrShowQR as U, ValidationError as V, parseExpiresAt as W, parseRetryAfter as X, sessionExpiry as Y, startExpiry as Z, type SessionResult as a, type PdfSessionBlock as b, type RepresentationsResponse as c, ApiError as d, AuthenticationError as e, CertChoiceInvalidError as f, DEFAULT_SIGN_SESSION_TTL_MS as g, DeviceLinkError as h, type DeviceLinkInput as i, type EndResult as j, ForbiddenError as k, type HttpErrorInit as l, type NavigatorLike as m, NetworkError as n, NoSigningCertificateError as o, type OnBehalfErrorCode as p, type OpenOrShowQROptions as q, type OrgResult as r, type PdfDocumentStatus as s, type PdfSigner as t, RETRYABLE_ERROR_CODES as u, type Representation as v, RequestInvalidError as w, ResponseTooLargeError as x, type RetryableErrorCode as y, SessionFailedError as z };
+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

@@ -1 +1,2 @@
-export { h as DeviceLinkError, i as DeviceLinkInput, D as DeviceLinkSession, E as EidError, m as NavigatorLike, q as OpenOrShowQROptions, M as deviceLink, Q as isMobileUserAgent, U as openOrShowQR } from './browser-CSZjH9Xs.cjs';
+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';
+export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.cjs';

package/dist/browser.d.ts

@@ -1 +1,2 @@
-export { h as DeviceLinkError, i as DeviceLinkInput, D as DeviceLinkSession, E as EidError, m as NavigatorLike, q as OpenOrShowQROptions, M as deviceLink, Q as isMobileUserAgent, U as openOrShowQR } from './browser-CSZjH9Xs.js';
+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';
+export { D as DeviceLinkError, E as EidError } from './errors-Z7SgLVTr.js';

package/dist/browser.js

@@ -1,10 +1,12 @@
 import {
-  DeviceLinkError,
-  EidError,
   deviceLink,
   isMobileUserAgent,
   openOrShowQR
-} from "./chunk-DXVHOZO7.js";
+} from "./chunk-REWNE7PO.js";
+import {
+  DeviceLinkError,
+  EidError
+} from "./chunk-TB2KQH3W.js";
 export {
   DeviceLinkError,
   EidError,

package/dist/chunk-REWNE7PO.js

@@ -0,0 +1,51 @@
+import {
+  DeviceLinkError
+} from "./chunk-TB2KQH3W.js";
+
+// 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 {
+  deviceLink,
+  isMobileUserAgent,
+  openOrShowQR
+};

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 };