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

package/README.md

@@ -61,6 +61,7 @@ export const eidLogin = createEidLogin({
   callbackUrl: "https://bank.example.mn/auth/eid/callback", // host нь RP-ийн callbackHosts-д; утасны урсгалд заавал
   async onSuccess(id) {
     // id.etsi (PNOMN-…) — хэрэглэгчийг ҮҮГЭЭР таньна; id.givenName/surname (латин), id.person (кирилл, байвал)
+    // id.sessionId, id.documentNumber, id.certificateDerB64 — дараагийн алхамд (гарын үсэг, гэрчилгээ холбох)
     const user = await users.findOrCreateByEtsi(id.etsi);
     const sid = await sessions.create(user.id); // ШИНЭ session (session fixation)
     return {
@@ -70,6 +71,7 @@ export const eidLogin = createEidLogin({
   },
   // store: redisStore,            // олон instance / serverless бол (анхдагч — процессын санах ой)
   // rateLimit: (key) => redisLimiter.allow(key), // "start:<ip>", "push:<idCode>"; анхдагч push 3/мин нэг дугаарт
+  trustProxy: 1, // handle(Request)-д клиент IP: nginx/LB нэг hop бол 1 (доор «Клиент IP»)
 });
 ```
 
@@ -82,6 +84,18 @@ export const GET = (req: Request) => eidLogin.handle(req);
 export const POST = (req: Request) => eidLogin.handle(req);
 ```
 
+**Клиент IP** (`start:<ip>` хязгаар). Web-standard `Request`-д IP байдаггүй — `handle(req)` ашиглаж байвал аль нэгийг өг:
+
+- `trustProxy: n` — итгэмжит reverse proxy-ийн ард: `X-Forwarded-For`-ийн **баруунаас n** дахь утга (n = таны proxy-ийн тоо),
+  XFF байхгүй бол `X-Real-IP`. `true` = XFF-ийн зүүн утга (proxy нь клиентийн XFF-ийг дарж бичдэг үед л). Proxy-гүй
+  үед бүү асаа — header-ийг клиент хуурамчаар илгээнэ.
+- `getClientIp: (req) => …` — платформын IP (Bun `server.requestIP(req)?.address`, Deno `info.remoteAddr.hostname`,
+  Vercel `req.headers.get("x-real-ip")`). `trustProxy`-оос давуу.
+
+Аль нь ч үгүй бол IP-ээр хязгаарлахгүй (эхний хүсэлтэд `onError`-оор нэг удаа анхааруулна). `handleRequest`-д `req.ip`
+(Express `req.ip`, `app.set("trust proxy", …)`-тэй) шууд хэрэглэгдэнэ. Анхдагч `rateLimit` зөвхөн `push:`-ийг хязгаарладаг —
+`start:<ip>`-ийг өөрийн `rateLimit`-ээр (Redis г.м.) хязгаарлана. Go: `eidlogin.Config.ClientIP` (`eidlogin.ForwardedClientIP(n)`) — ижил дүрэм.
+
 Express:
 
 ```ts
@@ -103,11 +117,37 @@ app.use("/auth/eid", express.json(), async (req, res) => {
 </script>
 ```
 
-эсвэл `mountEidLoginButton(el, { startUrl, statusUrl, lang: "en", successUrl, onSuccess, onError })`.
-Атрибут: `lang` (`mn` | `en`), `mode` (`auto` анхдагч — утас → Web2App, бусад → QR цонх; `qr`; `app`), `success-url`.
+эсвэл `mountEidLoginButton(el, { startUrl, statusUrl, lang: "en", theme: "auto", successUrl, onSuccess, onError })`.
+Атрибут: `lang` (`mn` | `en`), `mode` (`auto` анхдагч — утас → Web2App, бусад → QR цонх; `qr`; `app`),
+`theme` (`auto` анхдагч | `light` | `dark`), `success-url`.
 Үйл явдал: `eid-login-success`, `eid-login-error` (`detail.error`: `USER_REFUSED…`, `VALIDATION`, `EXPIRED` …).
-Дизайн нь eID нэвтрэх хуудсынх (лого, өнгө, light/dark); `--eid-accent`, `--eid-bg` г.м. CSS хувьсагчаар, `::part(button)`-оор
-тохируулна. Гадны хамааралгүй (QR encoder дотроо), цонх нь focus trap, Esc, `aria-live` төлөвтэй.
+Гадны хамааралгүй (QR encoder дотроо), цонх нь focus trap, Esc, `aria-live` төлөвтэй.
+
+**Дизайн, theme.** Дизайн нь eID нэвтрэх хуудсынх (лого, өнгө). Фонт нь хуудаснаас өвлөгдөнө (товч, цонх, input бүгд).
+`theme="auto"` үед дараалал: хуудасны `html[data-theme="dark|light"]` → `html.dark` / `html.light` → OS
+(`prefers-color-scheme`); хуудас theme солиход (MutationObserver) шууд дагана. `theme="light|dark"` нь хуудсыг давна.
+Өнгө, радиусыг CSS хувьсагчаар (элемент дээр — shadow-ийн `:host`-оос давуу) дарна:
+
+```css
+eid-login-button {
+  --eid-accent: #0b5cff; --eid-accent-fg: #fff;   /* үндсэн товч, QR-ийн алхмын тоо (--eid-accent-subtle, --eid-accent-subtle-fg) */
+  --eid-bg: #fff; --eid-bg-subtle: …; --eid-bg-muted: …;  /* цонх, hover */
+  --eid-fg: …; --eid-fg-muted: …; --eid-fg-subtle: …;     /* текст */
+  --eid-border: …; --eid-border-strong: …; --eid-ring: …; /* хүрээ, focus */
+  --eid-warning-bg: …; --eid-warning-border: …; --eid-warning-fg: …; --eid-danger-fg: …;
+  --eid-radius: 6px; --eid-radius-lg: 8px;
+}
+html[data-theme="dark"] eid-login-button { --eid-accent: …; } /* dark-д өөр өнгө бол */
+eid-login-button::part(button) { width: 100%; }               /* part: button, backdrop, dialog */
+```
+
+**eID аппын доод хувилбар.** `flowType` бэхлэлт (device link v3) ба Web2App-ийн `userChallengeVerifier` нь
+**iOS 2.2.3 (build 59)**, **Android 2.2.3 (versionCode 60)**-аас эхэлсэн. eID сервер 2026-10-07-оос legacy холбоосыг
+бүрэн хассан (v3-гүй session-д утас `DEVICE_LINK_REQUIRED`) бөгөөд доод хувилбарыг `/mobile/app-config`-оор албадан
+шинэчлүүлдэг: Android 2026-10-07-оос ≥ 70 (төхөөрөмжийн баталгаатай), 2026-10-14-ний байдлаар iOS ≥ 2.2.7,
+Android ≥ 83 (`curl https://ca.eidmongolia.mn/mobile/app-config`). Иймд гарын үсэг зурж чадах бүх апп эдгээрийг дэмжинэ —
+RP талд нэмэлт шалгалт хэрэггүй. Эх сурвалж: eID CA-ийн `docs/DEVICE_LINK_V3.md` §5, §7; changelog
+`2026-10-02-ios-min-version-2-2-3`, `2026-10-07-android-min-70`.
 
 **Аюулгүй байдал.**
 
@@ -120,6 +160,33 @@ app.use("/auth/eid", express.json(), async (req, res) => {
   (store-ийн `delete` атомар байх ёстой — Redis `DEL`).
 - `onSuccess`-ийн `data` хөтөчид очно — нууц бүү оруул. Иргэний бүртгэлтэй эсэхийг push алдаагаар задлахгүй (`eid_unavailable`).
 - Олон instance / serverless (Vercel г.м.) дээр анхдагч санах ойн store ажиллахгүй — `EidLoginStore` (`get`/`set`/`delete`)-ийг Redis-ээр.
+- `onSuccess` дуудагдахаас ӨМНӨ tx store-оос атомар устгагдана (нэг удаагийн баталгаа) — `onSuccess` дотор store-оос бүү
+  унш; хэрэгтэй бүхэн `identity`-д (`sessionId`, `documentNumber`, `certificateDerB64`, …).
+
+**Redis store** (SDK нэмэлт хамааралгүй — жишээ нь `ioredis`):
+
+```ts
+import Redis from "ioredis";
+import type { EidLoginStore, EidLoginTx } from "@gerege-systems/eid-mongolia-sdk";
+
+const redis = new Redis(process.env.REDIS_URL!);
+const key = (sid: string) => `eid:login:${sid}`;
+
+export const redisStore: EidLoginStore = {
+  async get(sid) {
+    const v = await redis.get(key(sid));
+    return v ? (JSON.parse(v) as EidLoginTx) : undefined;
+  },
+  async set(sid, tx, ttlMs) {
+    await redis.set(key(sid), JSON.stringify(tx), "PX", ttlMs);
+  },
+  async delete(sid) {
+    return (await redis.del(key(sid))) === 1; // DEL атомар — зэрэг хоёр status-ийн зөвхөн нэг нь onSuccess дуудна
+  },
+};
+```
+
+Tx-д `sessionSecret` (QR угсрах материал) байдаг — Redis-ийг сүлжээнээс хаалттай, TLS/AUTH-тай ашигла.
 
 ## 2. Нэвтрэлт (push)
 
@@ -201,6 +268,46 @@ eid.validator.validateSign(result, digest384, { hashAlgorithm: "SHA-384", expect
 
 RAW_DIGEST_SIGNATURE-д `flowType` гарын үсэгт ордоггүй (зөвхөн digest зурагдана) — энэ нь RP-API хариуны тулгалт.
 
+**QR / Web2App / App2App** — `eid.sign.deviceLinkByEtsi` / `deviceLinkByDocument` (`callbackUrl`-тай бол Web2App/App2App);
+холбоосыг backend-д `buildDeviceLink(deviceLinkInput(s, "QR", "mon"))` (auth/cert session-д ч мөн). `s.sign`
+(`SignContext`: digest, hash, алгоритм, interactions, callback)-ийг session-тэй хамт серверт хадгал.
+
+**`expiresAt`** (ms epoch) — session дуусах мөч: CA-ийн session start хариуны `expiresAt` (RFC 3339; auth / sign /
+certificate-choice бүгдэд, 2026-10-14-өөс). Хуучин CA (талбаргүй) үед sign / certificate-choice-д SDK тооцоолно — CA-ийн
+анхдагч 600с (`DEFAULT_SIGN_SESSION_TTL_MS`; CA админ 60–1800с болгож болно → `signSessionTtlMs`), auth-д undefined.
+Эцсийн үнэн нь `GET /session` (`TIMEOUT`).
+
+**Session эхлэх алдаа** (`ApiError`-ийн дэд анги, `.code`-той): `NoSigningCertificateError` — 409
+`NO_SIGNING_CERTIFICATE` (sign / certificate-choice start, `/pdf/sign/prepare`: иргэнд идэвхтэй төхөөрөмж / хүчинтэй
+гарын үсгийн гэрчилгээ алга, session үүсээгүй); `CertChoiceInvalidError` — 409 `CERT_CHOICE_INVALID` (linked sign-ийн
+certificate-choice хүчингүй / хуучирсан / ашиглагдсан → cert-choice-ийг дахин эхлүүл); `RequestInvalidError` — 400
+`REQUEST_INVALID` (ж: linked-д `linkedSessionID` дутуу).
+
+### 3.1. Гэрчилгээг урьдчилж мэдэх (client-side PAdES / CMS)
+
+Гэрчилгээ DTBS-д (`signingCertificateV2`) ордог тул эхлээд certificate-choice, дараа нь digest-ийг **яг тэр төхөөрөмж
+рүү (`documentNumber`)** зуруулна. Олон утастай иргэнд etsi-ээр эхлүүлбэл өөр утас зурж, гарын үсэг гэрчилгээтэйгээ
+таарахгүй.
+
+```ts
+const cc = await eid.sign.certificateChoiceByEtsi("PNOMN-12345678"); // эсвэл certificateChoiceDeviceLink() (зөвхөн QR)
+const signer = eid.validator.validateCertificateChoice(await eid.session.waitForResult(cc.sessionId), cc.sessionId);
+const dtbs = buildDtbs(signer.certificate); // 32 байт SHA-256, стандарт base64
+const s = await eid.sign.digestForSigner(signer, dtbs, ix, { fileName: "Гэрээ.pdf" }); // linked/{documentNumber}
+// QR / Web2App: eid.sign.deviceLinkForSigner(signer, dtbs, ix, { callbackUrl })
+const r = await eid.session.waitForResult(s.sessionId);
+const sig = eid.validator.validateSign(r, s.sign!.digest, {
+  hashAlgorithm: s.sign!.hashAlgorithm,
+  expectedFlowType: "Notification",
+  expectedAlgorithm: s.sign!.signatureAlgorithm, // sha256WithRSAEncryption — PSS хариуг татгалзана
+  expectedCertificate: signer.certificate,       // өөр гэрчилгээгээр зурсан бол татгалзана
+});
+```
+
+`digestForSigner` / `deviceLinkForSigner`-ийн анхдагч: `sha256WithRSAEncryption` + `SHA-256` (CA SplitKey RSA нь хүссэн
+алгоритмаар, PKCS#1 v1.5; хуучин threshold-ECDSA credential нь үргэлж `ecdsa-with-SHA256` — `expectedAlgorithm` үүнийг
+зөвхөн EC P-256 гэрчилгээтэй үед зөвшөөрнө). Digest-ийн урт hash-тай таарахгүй бол хүсэлт явахгүй.
+
 ## 3a. Байгууллагын нэрийн өмнөөс гарын үсэг (onBehalfOf)
 
 Иргэн **өөрийн PIN2 гэрчилгээгээр** зурна; тухайн мөчид байгууллагыг төлөөлөх эрхтэйг eID **өөрийн бүртгэлээр**
@@ -421,6 +528,9 @@ OK ирж болзошгүй. Иймд `ResponseValidator`:
 | `ForbiddenError` | 403 — IP allowlist / mTLS / RP-ийн эрх; onBehalfOf татгалзвал `.code` (`OnBehalfErrorCode`) |
 | `SessionFailedError` | endResult ≠ OK (TIMEOUT, USER_REFUSED…) — `.endResult`-оор салга |
 | `ValidationError` | cert chain/signature/level шалгалт бүтэлгүйтсэн |
+| `NoSigningCertificateError` | 409 `NO_SIGNING_CERTIFICATE` — гарын үсгийн гэрчилгээ / төхөөрөмж алга (sign, cert-choice start, PDF prepare); `ApiError`-ийн дэд анги |
+| `CertChoiceInvalidError` | 409 `CERT_CHOICE_INVALID` — linked sign-ийн certificate-choice хүчингүй; `ApiError`-ийн дэд анги |
+| `RequestInvalidError` | 400 `REQUEST_INVALID` — хүсэлт буруу (ж: `linkedSessionID` дутуу); `ApiError`-ийн дэд анги |
 | `ApiError` | бусад HTTP алдаа (`.status`, `.body`, серверийн `.code`, `.retryAfterMs`, `.headers`, `.retryable` — ж: 404 `ORG_NOT_FOUND`) |
 | `ResponseTooLargeError` | хариу SDK-ийн хязгаараас их (JSON 4 MiB, PDF `pdfMaxBytes`) — `.op`, `.limit` |
 | `NetworkError` | timeout/сүлжээ (`.op` — таних тэмдэггүй зам, `.timeout`) |

package/dist/{browser-C6JHm0lR.d.cts → browser-CSZjH9Xs.d.cts}

@@ -72,7 +72,43 @@ interface NotificationSession {
     rpChallenge: string;
     /** Auth session-д validator-т өгөх контекст (sign session-д undefined). */
     acsp?: AcspContext;
+    /** Sign session-ий хүсэлтэд илгээсэн утгууд ({@link SignContext}); auth / certificate-choice-д undefined. */
+    sign?: SignContext;
+    /** Sign / certificate-choice session-ий ТООЦООЛСОН дуусах мөч (ms epoch) — {@link sessionExpiry}; auth-д undefined. */
+    expiresAt?: number;
 }
+/**
+ * Sign session-ий хүсэлтэд илгээсэн утгууд ЯГ ХЭВЭЭР: `validateSign` (digest, hashAlgorithm, signatureAlgorithm) ба
+ * device link (`buildDeviceLink`: digest, relyingPartyName, interactions, initialCallbackUrl)-д. RP session-тэй хамт
+ * серверт хадгална.
+ */
+interface SignContext {
+    /** Илгээсэн digest (стандарт base64, ЯГ ХЭВЭЭР — device link-ийн authCode-д ордог). */
+    digest: string;
+    hashAlgorithm: HashAlgorithm;
+    signatureAlgorithm: SignatureAlgorithm;
+    relyingPartyName: string;
+    /** Илгээсэн interactions-ийн base64 МӨР. */
+    interactions: string;
+    initialCallbackUrl: string;
+}
+/**
+ * CA-ийн SIGNATURE ба CERTIFICATE_CHOICE session-ий анхдагч хүчинтэй хугацаа (мс; `EID_SIGN_SESSION_TTL_SECONDS` = 600).
+ * CA-ийн админ «Системийн тохиргоо»-нд 60–1800 секундэд өөрчилж болно. CA 2026-10-14-өөс session start хариунд
+ * `expiresAt` (RFC 3339) буцаадаг — SDK түүнийг ашиглана; хуучин CA (талбаргүй) үед л `ClientConfig.signSessionTtlMs`-ээр
+ * тооцоолно ({@link startExpiry}).
+ */
+declare const DEFAULT_SIGN_SESSION_TTL_MS = 600000;
+/**
+ * Session start-ын хариунаас тооцоолох дуусах мөч (ms epoch): хүсэлт илгээхээс ӨМНӨХ цаг + ttl. CA ExpiresAt-ийг өөрийн
+ * хүлээн авсан мөчөөс тооцдог тул энэ утга CA-ийнхаас ХЭЗЭЭ Ч хойно биш (консерватив). RP UI-ийн тоолуур / «дахин
+ * эхлүүлэх» шийдвэрт л — эцсийн үнэн нь `GET /session` (`TIMEOUT`).
+ */
+declare function sessionExpiry(sentAtMs: number, ttlMs?: number): number;
+/** CA-ийн `expiresAt` (RFC 3339) → ms epoch; байхгүй / задрахгүй бол undefined. */
+declare function parseExpiresAt(v: unknown): number | undefined;
+/** Session start-ын дуусах мөч: CA-ийн `expiresAt` байвал түүнийг, үгүй бол {@link sessionExpiry} (тооцоолол). */
+declare function startExpiry(raw: unknown, sentAtMs: number, ttlMs?: number): number;
 /**
  * Device-link (QR/Web2App/App2App) session. Иргэн QR уншиж эсвэл товч дарж нэгдэнэ.
  * `sessionToken`, `sessionSecret`-ийг ЗӨВХӨН backend-д хадгална — браузер руу бүү гарга.
@@ -99,6 +135,17 @@ interface DeviceLinkSession {
      * ЗӨВХӨН backend-д хадгална.
      */
     receivedAt: number;
+    /** auth | sign | cert ({@link deviceLinkInput}-д). Хуучин хадгалсан session-д undefined = auth. */
+    sessionType?: "auth" | "sign" | "cert";
+    /** Sign session-д ({@link deviceLinkInput}, `validateSign`); бусад үед undefined. */
+    sign?: SignContext;
+    /** Certificate-choice session-ий хүсэлтэд илгээсэн нэр (cert холбоосын authCode-д). */
+    relyingPartyName?: string;
+    /**
+     * Session дуусах мөч (ms epoch): CA-ийн start хариуны `expiresAt`; хуучин CA-д sign / certificate-choice-д тооцоолсон
+     * ({@link startExpiry}), auth-д undefined.
+     */
+    expiresAt?: number;
 }
 /** Session poll-ийн нэгтгэсэн үр дүн (validator-т орох түүхий материал). */
 interface SessionResult {
@@ -379,6 +426,23 @@ declare class ApiError extends EidError {
      */
     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 токен),
@@ -444,4 +508,4 @@ declare class ValidationError extends EidError {
 declare class DeviceLinkError extends EidError {
 }
 
-export { type AcspContext as A, deviceLink as B, type CertificateLevel as C, type DeviceLinkSession as D, EidError as E, type FlowType as F, isMobileUserAgent as G, type HashAlgorithm as H, type Interaction as I, openOrShowQR as J, parseRetryAfter as K, type NotificationSession as N, ON_BEHALF_ERROR_CODES as O, type PersonBlock as P, 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, DeviceLinkError as f, type DeviceLinkInput as g, type EndResult as h, ForbiddenError as i, type HttpErrorInit as j, type NavigatorLike as k, NetworkError as l, type OnBehalfErrorCode as m, type OpenOrShowQROptions as n, type OrgResult as o, type PdfDocumentStatus as p, type PdfSigner as q, RETRYABLE_ERROR_CODES as r, type Representation as s, ResponseTooLargeError as t, type RetryableErrorCode as u, SessionFailedError as v, type SessionState as w, type SignatureAlgorithmParameters as x, type SignatureProtocol as y, type TokenCertStatus as z };
+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 };

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

@@ -72,7 +72,43 @@ interface NotificationSession {
     rpChallenge: string;
     /** Auth session-д validator-т өгөх контекст (sign session-д undefined). */
     acsp?: AcspContext;
+    /** Sign session-ий хүсэлтэд илгээсэн утгууд ({@link SignContext}); auth / certificate-choice-д undefined. */
+    sign?: SignContext;
+    /** Sign / certificate-choice session-ий ТООЦООЛСОН дуусах мөч (ms epoch) — {@link sessionExpiry}; auth-д undefined. */
+    expiresAt?: number;
 }
+/**
+ * Sign session-ий хүсэлтэд илгээсэн утгууд ЯГ ХЭВЭЭР: `validateSign` (digest, hashAlgorithm, signatureAlgorithm) ба
+ * device link (`buildDeviceLink`: digest, relyingPartyName, interactions, initialCallbackUrl)-д. RP session-тэй хамт
+ * серверт хадгална.
+ */
+interface SignContext {
+    /** Илгээсэн digest (стандарт base64, ЯГ ХЭВЭЭР — device link-ийн authCode-д ордог). */
+    digest: string;
+    hashAlgorithm: HashAlgorithm;
+    signatureAlgorithm: SignatureAlgorithm;
+    relyingPartyName: string;
+    /** Илгээсэн interactions-ийн base64 МӨР. */
+    interactions: string;
+    initialCallbackUrl: string;
+}
+/**
+ * CA-ийн SIGNATURE ба CERTIFICATE_CHOICE session-ий анхдагч хүчинтэй хугацаа (мс; `EID_SIGN_SESSION_TTL_SECONDS` = 600).
+ * CA-ийн админ «Системийн тохиргоо»-нд 60–1800 секундэд өөрчилж болно. CA 2026-10-14-өөс session start хариунд
+ * `expiresAt` (RFC 3339) буцаадаг — SDK түүнийг ашиглана; хуучин CA (талбаргүй) үед л `ClientConfig.signSessionTtlMs`-ээр
+ * тооцоолно ({@link startExpiry}).
+ */
+declare const DEFAULT_SIGN_SESSION_TTL_MS = 600000;
+/**
+ * Session start-ын хариунаас тооцоолох дуусах мөч (ms epoch): хүсэлт илгээхээс ӨМНӨХ цаг + ttl. CA ExpiresAt-ийг өөрийн
+ * хүлээн авсан мөчөөс тооцдог тул энэ утга CA-ийнхаас ХЭЗЭЭ Ч хойно биш (консерватив). RP UI-ийн тоолуур / «дахин
+ * эхлүүлэх» шийдвэрт л — эцсийн үнэн нь `GET /session` (`TIMEOUT`).
+ */
+declare function sessionExpiry(sentAtMs: number, ttlMs?: number): number;
+/** CA-ийн `expiresAt` (RFC 3339) → ms epoch; байхгүй / задрахгүй бол undefined. */
+declare function parseExpiresAt(v: unknown): number | undefined;
+/** Session start-ын дуусах мөч: CA-ийн `expiresAt` байвал түүнийг, үгүй бол {@link sessionExpiry} (тооцоолол). */
+declare function startExpiry(raw: unknown, sentAtMs: number, ttlMs?: number): number;
 /**
  * Device-link (QR/Web2App/App2App) session. Иргэн QR уншиж эсвэл товч дарж нэгдэнэ.
  * `sessionToken`, `sessionSecret`-ийг ЗӨВХӨН backend-д хадгална — браузер руу бүү гарга.
@@ -99,6 +135,17 @@ interface DeviceLinkSession {
      * ЗӨВХӨН backend-д хадгална.
      */
     receivedAt: number;
+    /** auth | sign | cert ({@link deviceLinkInput}-д). Хуучин хадгалсан session-д undefined = auth. */
+    sessionType?: "auth" | "sign" | "cert";
+    /** Sign session-д ({@link deviceLinkInput}, `validateSign`); бусад үед undefined. */
+    sign?: SignContext;
+    /** Certificate-choice session-ий хүсэлтэд илгээсэн нэр (cert холбоосын authCode-д). */
+    relyingPartyName?: string;
+    /**
+     * Session дуусах мөч (ms epoch): CA-ийн start хариуны `expiresAt`; хуучин CA-д sign / certificate-choice-д тооцоолсон
+     * ({@link startExpiry}), auth-д undefined.
+     */
+    expiresAt?: number;
 }
 /** Session poll-ийн нэгтгэсэн үр дүн (validator-т орох түүхий материал). */
 interface SessionResult {
@@ -379,6 +426,23 @@ declare class ApiError extends EidError {
      */
     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 токен),
@@ -444,4 +508,4 @@ declare class ValidationError extends EidError {
 declare class DeviceLinkError extends EidError {
 }
 
-export { type AcspContext as A, deviceLink as B, type CertificateLevel as C, type DeviceLinkSession as D, EidError as E, type FlowType as F, isMobileUserAgent as G, type HashAlgorithm as H, type Interaction as I, openOrShowQR as J, parseRetryAfter as K, type NotificationSession as N, ON_BEHALF_ERROR_CODES as O, type PersonBlock as P, 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, DeviceLinkError as f, type DeviceLinkInput as g, type EndResult as h, ForbiddenError as i, type HttpErrorInit as j, type NavigatorLike as k, NetworkError as l, type OnBehalfErrorCode as m, type OpenOrShowQROptions as n, type OrgResult as o, type PdfDocumentStatus as p, type PdfSigner as q, RETRYABLE_ERROR_CODES as r, type Representation as s, ResponseTooLargeError as t, type RetryableErrorCode as u, SessionFailedError as v, type SessionState as w, type SignatureAlgorithmParameters as x, type SignatureProtocol as y, type TokenCertStatus as z };
+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 };

package/dist/browser.d.cts

@@ -1 +1 @@
-export { f as DeviceLinkError, g as DeviceLinkInput, D as DeviceLinkSession, E as EidError, k as NavigatorLike, n as OpenOrShowQROptions, B as deviceLink, G as isMobileUserAgent, J as openOrShowQR } from './browser-C6JHm0lR.cjs';
+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';

package/dist/browser.d.ts

@@ -1 +1 @@
-export { f as DeviceLinkError, g as DeviceLinkInput, D as DeviceLinkSession, E as EidError, k as NavigatorLike, n as OpenOrShowQROptions, B as deviceLink, G as isMobileUserAgent, J as openOrShowQR } from './browser-C6JHm0lR.js';
+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';

package/dist/browser.js

@@ -4,7 +4,7 @@ import {
   deviceLink,
   isMobileUserAgent,
   openOrShowQR
-} from "./chunk-QPJDZLHR.js";
+} from "./chunk-DXVHOZO7.js";
 export {
   DeviceLinkError,
   EidError,

package/dist/button.cjs

@@ -22,7 +22,8 @@ var button_exports = {};
 __export(button_exports, {
   EidLoginButton: () => EidLoginButton,
   defineEidLoginButton: () => defineEidLoginButton,
-  mountEidLoginButton: () => mountEidLoginButton
+  mountEidLoginButton: () => mountEidLoginButton,
+  resolveEidTheme: () => resolveEidTheme
 });
 module.exports = __toCommonJS(button_exports);
 
@@ -464,7 +465,7 @@ var T = {
     minute: "1 minute left"
   }
 };
-var CSS = `
+var CSS_BASE = `
 :host { display: inline-block;
   --eid-bg: hsl(0 0% 100%); --eid-bg-subtle: hsl(210 40% 98%); --eid-bg-muted: hsl(210 40% 96%);
   --eid-fg: hsl(222 47% 11%); --eid-fg-muted: hsl(215 19% 35%); --eid-fg-subtle: hsl(215 16% 45%);
@@ -472,22 +473,26 @@ var CSS = `
   --eid-accent: oklch(0.534 0.2 259); --eid-accent-fg: #fff; --eid-accent-subtle: oklch(0.97 0.03 259);
   --eid-accent-subtle-fg: oklch(0.474 0.19 259); --eid-ring: oklch(0.604 0.2 259);
   --eid-warning-bg: hsl(48 100% 96%); --eid-warning-border: hsl(45 95% 78%); --eid-warning-fg: hsl(23 75% 33%);
-  --eid-danger-fg: hsl(0 74% 42%); --eid-radius: 6px; --eid-radius-lg: 8px; font-family: inherit; }
-@media (prefers-color-scheme: dark) { :host {
+  --eid-danger-fg: hsl(0 74% 42%); --eid-radius: 6px; --eid-radius-lg: 8px; font-family: inherit; color-scheme: light; }
+button, input { font-family: inherit; }
+`;
+var DARK_CSS = `:host { color-scheme: dark;
   --eid-bg: hsl(229 50% 6%); --eid-bg-subtle: hsl(222 47% 9%); --eid-bg-muted: hsl(217 33% 13%);
   --eid-fg: hsl(210 40% 98%); --eid-fg-muted: hsl(213 27% 84%); --eid-fg-subtle: hsl(215 20% 65%);
   --eid-border: hsl(217 33% 17%); --eid-border-strong: hsl(215 25% 27%);
   --eid-accent: oklch(0.64 0.15 259); --eid-accent-fg: hsl(229 50% 6%); --eid-accent-subtle: oklch(0.24 0.06 259);
   --eid-accent-subtle-fg: oklch(0.82 0.1 259); --eid-ring: oklch(0.68 0.15 259);
   --eid-warning-bg: hsl(20 60% 10%); --eid-warning-border: hsl(22 70% 26%); --eid-warning-fg: hsl(40 92% 65%);
-  --eid-danger-fg: hsl(0 91% 71%); } }
+  --eid-danger-fg: hsl(0 91% 71%); }
+`;
+var CSS_REST = `
 *, *::before, *::after { box-sizing: border-box; }
 [hidden] { display: none !important; }
 h2, p, ol { margin: 0; }
 :focus-visible { outline: 2px solid var(--eid-ring); outline-offset: 2px; }
 .sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0; }
 .btn { display: inline-flex; width: 100%; align-items: center; justify-content: center; gap: 8px; min-height: 44px; padding: 0 20px;
-  border-radius: var(--eid-radius); font: 500 1rem/1.25 inherit; text-decoration: none; border: 1px solid transparent; cursor: pointer;
+  border-radius: var(--eid-radius); font-family: inherit; font-weight: 500; font-size: 1rem; line-height: 1.25; text-decoration: none; border: 1px solid transparent; cursor: pointer;
   transition: background-color 160ms cubic-bezier(0,0,0.2,1); }
 .btn:disabled { opacity: 0.6; cursor: progress; }
 .btn-primary { background: var(--eid-accent); color: var(--eid-accent-fg); }
@@ -524,7 +529,7 @@ h2, p, ol { margin: 0; }
 .field { display: grid; gap: 8px; }
 .field label { font-weight: 500; }
 .field input { width: 100%; height: 44px; padding: 0 12px; border: 1px solid var(--eid-border-strong); border-radius: var(--eid-radius);
-  background: var(--eid-bg); color: var(--eid-fg); font: 1rem/1.5rem inherit; letter-spacing: 0.02em; text-transform: uppercase; }
+  background: var(--eid-bg); color: var(--eid-fg); font-family: inherit; font-size: 1rem; line-height: 1.5rem; letter-spacing: 0.02em; text-transform: uppercase; }
 .field input::placeholder { color: var(--eid-fg-subtle); text-transform: none; }
 .field input[aria-invalid="true"] { border-color: var(--eid-danger-fg); }
 .hint { font-size: 0.8125rem; color: var(--eid-fg-subtle); }
@@ -544,6 +549,17 @@ h2, p, ol { margin: 0; }
 @media (prefers-reduced-motion: reduce) { *, *::before, *::after { transition: none !important; }
   .spinner { animation: none; border-right-color: currentColor; opacity: 0.6; } }
 `;
+var CSS = CSS_BASE + CSS_REST;
+function resolveEidTheme(theme, doc = document) {
+  if (theme === "light" || theme === "dark") return theme;
+  const html = doc.documentElement;
+  const dt = html?.getAttribute("data-theme");
+  if (dt === "dark" || dt === "light") return dt;
+  if (html?.classList.contains("dark")) return "dark";
+  if (html?.classList.contains("light")) return "light";
+  const mq = doc.defaultView?.matchMedia?.("(prefers-color-scheme: dark)");
+  return mq?.matches ? "dark" : "light";
+}
 var ID_RE = /^([А-ЯЁӨҮ]{2}[0-9]{8}|[0-9]{8,14})$/;
 var FOCUSABLE = 'button:not([disabled]), input:not([disabled]), a[href], [tabindex]:not([tabindex="-1"])';
 function el(tag, attrs = {}, text) {
@@ -555,7 +571,7 @@ function el(tag, attrs = {}, text) {
 var Base = typeof HTMLElement === "undefined" ? class {
 } : HTMLElement;
 var EidLoginButton = class extends Base {
-  static observedAttributes = ["lang"];
+  static observedAttributes = ["lang", "theme"];
   /** Тест/дотоод: гар утас эсэхийг дарж бичих. */
   isMobile = () => isMobileUserAgent();
   /** Тест/дотоод: шилжилт (location.assign). */
@@ -572,6 +588,10 @@ var EidLoginButton = class extends Base {
   gen = 0;
   // цонх нээх бүрд нэмэгдэнэ — хуучин fetch-ийн хариуг үл тооно
   lastFocus = null;
+  darkStyle;
+  themeObs = null;
+  mq = null;
+  onScheme = () => this.applyTheme();
   get t() {
     return T[this.getAttribute("lang") === "en" ? "en" : "mn"];
   }
@@ -579,21 +599,52 @@ var EidLoginButton = class extends Base {
     return this.getAttribute(name) ?? def;
   }
   connectedCallback() {
-    if (this.root) return;
-    this.root = this.attachShadow({ mode: "open" });
-    const style = el("style");
-    style.textContent = CSS;
-    this.trigger = el("button", { type: "button", class: "btn btn-outline trigger", part: "button", "aria-haspopup": "dialog" });
-    this.trigger.append(el("img", { src: EID_LOGO_DATA_URI, alt: "", width: "20", height: "20" }), el("span", {}, this.t.button));
-    this.trigger.addEventListener("click", () => this.start());
-    this.root.append(style, this.trigger);
-  }
-  attributeChangedCallback() {
+    if (!this.root) {
+      this.root = this.attachShadow({ mode: "open" });
+      const style = el("style");
+      style.textContent = CSS;
+      this.darkStyle = el("style", { "data-eid-theme": "dark" });
+      this.trigger = el("button", { type: "button", class: "btn btn-outline trigger", part: "button", "aria-haspopup": "dialog" });
+      this.trigger.append(el("img", { src: EID_LOGO_DATA_URI, alt: "", width: "20", height: "20" }), el("span", {}, this.t.button));
+      this.trigger.addEventListener("click", () => this.start());
+      this.root.append(style, this.darkStyle, this.trigger);
+    }
+    this.watchTheme();
+    this.applyTheme();
+  }
+  attributeChangedCallback(name) {
+    if (name === "theme") {
+      if (this.root) this.applyTheme();
+      return;
+    }
     const label = this.trigger?.querySelector("span");
     if (label) label.textContent = this.t.button;
   }
   disconnectedCallback() {
     this.close();
+    this.themeObs?.disconnect();
+    this.themeObs = null;
+    this.mq?.removeEventListener?.("change", this.onScheme);
+    this.mq = null;
+  }
+  /** Одоогийн бодит схем (`theme` + auto үед хуудас/OS). */
+  get scheme() {
+    return resolveEidTheme(this.getAttribute("theme"));
+  }
+  applyTheme() {
+    const css = this.scheme === "dark" ? DARK_CSS : "";
+    if (this.darkStyle.textContent !== css) this.darkStyle.textContent = css;
+  }
+  /** auto үед хуудасны html[data-theme]/class ба OS-ийн схемийн өөрчлөлтийг дагана. */
+  watchTheme() {
+    if (!this.themeObs && typeof MutationObserver !== "undefined" && document.documentElement) {
+      this.themeObs = new MutationObserver(this.onScheme);
+      this.themeObs.observe(document.documentElement, { attributes: true, attributeFilter: ["data-theme", "class"] });
+    }
+    if (!this.mq && typeof matchMedia === "function") {
+      this.mq = matchMedia("(prefers-color-scheme: dark)");
+      this.mq.addEventListener?.("change", this.onScheme);
+    }
   }
   /** Товчны үйлдэл (программаар ч дуудаж болно). */
   start() {
@@ -937,6 +988,7 @@ function mountEidLoginButton(target, opts) {
   b.setAttribute("status-url", opts.statusUrl);
   b.setAttribute("lang", opts.lang ?? "mn");
   if (opts.mode) b.setAttribute("mode", opts.mode);
+  if (opts.theme) b.setAttribute("theme", opts.theme);
   if (opts.successUrl) b.setAttribute("success-url", opts.successUrl);
   if (opts.onSuccess) b.addEventListener("eid-login-success", (e) => opts.onSuccess(e.detail));
   if (opts.onError) b.addEventListener("eid-login-error", (e) => opts.onError(e.detail.error));
@@ -948,5 +1000,6 @@ defineEidLoginButton();
 0 && (module.exports = {
   EidLoginButton,
   defineEidLoginButton,
-  mountEidLoginButton
+  mountEidLoginButton,
+  resolveEidTheme
 });

package/dist/button.d.cts

@@ -17,13 +17,18 @@ interface EidLoginButtonOptions {
     lang?: Lang;
     /** auto (анхдагч: утас → Web2App, бусад → QR цонх) | qr | app. */
     mode?: "auto" | "qr" | "app";
+    /** auto (анхдагч: html[data-theme] / html.dark / prefers-color-scheme-ийг дагана) | light | dark. */
+    theme?: "auto" | "light" | "dark";
     /** Амжилтын дараа (backend redirect өгөөгүй бол) шилжих URL. */
     successUrl?: string;
     onSuccess?: (s: EidLoginStatus) => void;
     onError?: (error: string) => void;
 }
+type Scheme = "light" | "dark";
+/** `theme` атрибутын утгыг (light | dark | auto) бодит схем болгоно. auto: html[data-theme] → html.dark/.light → OS. */
+declare function resolveEidTheme(theme: string | null, doc?: Document): Scheme;
 declare const Base: typeof HTMLElement;
-/** `<eid-login-button>` — атрибут: start-url, status-url, lang (mn|en), mode (auto|qr|app), success-url. */
+/** `<eid-login-button>` — атрибут: start-url, status-url, lang (mn|en), mode (auto|qr|app), theme (auto|light|dark), success-url. */
 declare class EidLoginButton extends Base {
     static readonly observedAttributes: string[];
     /** Тест/дотоод: гар утас эсэхийг дарж бичих. */
@@ -41,11 +46,20 @@ declare class EidLoginButton extends Base {
     private fails;
     private gen;
     private lastFocus;
+    private darkStyle;
+    private themeObs;
+    private mq;
+    private readonly onScheme;
     private get t();
     private attr;
     connectedCallback(): void;
-    attributeChangedCallback(): void;
+    attributeChangedCallback(name: string): void;
     disconnectedCallback(): void;
+    /** Одоогийн бодит схем (`theme` + auto үед хуудас/OS). */
+    get scheme(): Scheme;
+    private applyTheme;
+    /** auto үед хуудасны html[data-theme]/class ба OS-ийн схемийн өөрчлөлтийг дагана. */
+    private watchTheme;
     /** Товчны үйлдэл (программаар ч дуудаж болно). */
     start(): void;
     private open;
@@ -76,4 +90,4 @@ declare function defineEidLoginButton(tag?: string): void;
 /** Элементэд товч нэмнэ (framework-гүй хуудас, React/Vue-ийн ref). Үүссэн элементийг буцаана. */
 declare function mountEidLoginButton(target: Element, opts: EidLoginButtonOptions): EidLoginButton;
 
-export { EidLoginButton, type EidLoginButtonOptions, type EidLoginStatus, defineEidLoginButton, mountEidLoginButton };
+export { EidLoginButton, type EidLoginButtonOptions, type EidLoginStatus, defineEidLoginButton, mountEidLoginButton, resolveEidTheme };