@gerege-systems/eid-mongolia-sdk 0.33.0 → 0.35.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/dist/index.d.cts CHANGED
@@ -1,9 +1,8 @@
1
- import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, b as PersonBlock, c as RepresentationsResponse, E as EidImage, A as AcspContext, F as FlowType } from './types-Cf3GT4wh.cjs';
2
- export { d as DEFAULT_SIGN_SESSION_TTL_MS, e as EndResult, O as OrgResult, P as PdfImage, f as Representation, g as SessionPresentation, h as SessionState, i as SignContext, j as SignatureAlgorithmParameters, k as SignatureProtocol, T as TokenCertSessionBlock, l as TokenCertStatus, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './types-Cf3GT4wh.cjs';
3
- import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-mcDbKiz_.cjs';
4
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-mcDbKiz_.cjs';
1
+ import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, P as PersonBlock, b as RepresentationsResponse, A as AcspContext, F as FlowType } from './browser-w1Ca6FdZ.cjs';
2
+ export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-w1Ca6FdZ.cjs';
3
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-CgJcEjrZ.cjs';
4
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CgJcEjrZ.cjs';
5
5
  import { X509Certificate, KeyObject } from 'node:crypto';
6
- export { NavigatorLike, isMobileUserAgent } from './browser.cjs';
7
6
 
8
7
  interface HttpConfig {
9
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -220,18 +219,6 @@ interface RegisterSignatureInput {
220
219
  onBehalfOf?: string;
221
220
  /** Заавал биш (`PNOMN-…`): ирвэл CMS-ийн зурагчийн SERIALNUMBER-тэй тэнцүү (эс бөгөөс 409 `SIGNER_MISMATCH`). */
222
221
  signerEtsi?: string;
223
- /**
224
- * `complete().images` (0.31.0+) — харагдах дүрслэлд шигтгэсэн зураг бүрийн `{kind, sha256}` (pades APPEARANCE_SPEC.md
225
- * §6.6): CA зурагчийн/байгууллагын хадгалсан PNG-тэй тулгана. Зураггүй бол илгээхгүй.
226
- */
227
- images?: PdfSignatureImage[];
228
- }
229
- /** {@link RegisterSignatureInput.images}-ийн нэг мөр (Go `eid.PDFSignatureImage`). */
230
- interface PdfSignatureImage {
231
- /** `signature` — иргэний гарын үсгийн зураг; `stamp` — байгууллагын тамганы зураг. */
232
- kind: "signature" | "stamp";
233
- /** CA-ийн хадгалсан PNG-ийн SHA-256 (64 жижиг hex). */
234
- sha256: string;
235
222
  }
236
223
  /** Өмнөх нэг гарын үсгийн хоёр түлхүүр ({@link RegisterSignatureInput.priorSignatures}). */
237
224
  interface PriorSignature {
@@ -255,8 +242,6 @@ interface CompletedForRegistration {
255
242
  priorRevisionSha256?: string[];
256
243
  /** `complete().claimedRole` (0.27.0+) — хоосон биш бол `onBehalfOf` заавал. */
257
244
  claimedRole?: string;
258
- /** `complete().images` (0.31.0+) — байвал `images` болж илгээгдэнэ. */
259
- images?: PdfSignatureImage[];
260
245
  }
261
246
  /**
262
247
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
@@ -578,12 +563,6 @@ declare class PersonApi {
578
563
  summary(personEtsi: string): Promise<PersonSummary>;
579
564
  /** Асран хамгаалж буй хүүхдүүд (зөвхөн унших). */
580
565
  children(personEtsi: string): Promise<PersonChildren>;
581
- /**
582
- * GET /person/etsi/{personEtsi}/signature-image — иргэний гарын үсгийн зураг (харагдах гарын үсэгт:
583
- * `appearance.signatureImage = img.pdfImage`). PKI_READ биш, **SIGN** эрх; иргэн сүүлийн 24 цагт танай RP-ээр
584
- * нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Иргэн зураг хадгалаагүй (404) бол `null`.
585
- */
586
- signatureImage(personEtsi: string): Promise<EidImage | null>;
587
566
  }
588
567
 
589
568
  /** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
@@ -1159,8 +1138,10 @@ declare const QR_CLOCK_SKEW_MS = 60000;
1159
1138
  * - `QR_ATTRIBUTES_INVALID` — аттрибут хоосон / каталогид алга / давхардсан (клиент талын, CA руу явахгүй)
1160
1139
  * - `QR_PRESENTATION_INVALID` — JWS шалгалт унасан — хариунд ИТГЭХГҮЙ
1161
1140
  * - `QR_JWKS_UNAVAILABLE` — CA-ийн JWKS татагдсангүй (түр; дахин оролдож болно)
1141
+ * - `QR_PENDING` — `qr.result`-ийн хүлээх хугацаа (`maxWaitMs`) дууссан ч иргэн хараахан хариулаагүй (CA-ийн session
1142
+ * идэвхтэй хэвээр) — дахин `result` / `check` дуудаж болно. CA-ийн жинхэнэ хугацаа дуусалт = SessionFailedError TIMEOUT.
1162
1143
  */
1163
- declare const QR_ERROR_CODES: readonly ["QR_FORMAT_INVALID", "QR_TOKEN_INVALID", "QR_ATTRIBUTES_INVALID", "QR_PRESENTATION_INVALID", "QR_JWKS_UNAVAILABLE"];
1144
+ declare const QR_ERROR_CODES: readonly ["QR_FORMAT_INVALID", "QR_TOKEN_INVALID", "QR_ATTRIBUTES_INVALID", "QR_PRESENTATION_INVALID", "QR_JWKS_UNAVAILABLE", "QR_PENDING"];
1164
1145
  type QrErrorCode = (typeof QR_ERROR_CODES)[number];
1165
1146
  /** «Миний QR»-ийн клиент талын алдаа. */
1166
1147
  declare class QrError extends EidError {
@@ -1220,6 +1201,13 @@ interface QrPresentation {
1220
1201
  /** Түүхий compact JWS (аудитад хадгалж болно). */
1221
1202
  jws: string;
1222
1203
  }
1204
+ /** `qr.check`-ийн хариу: иргэн хараахан хариулаагүй, эсвэл шалгагдсан presentation. */
1205
+ type QrCheck = {
1206
+ state: "RUNNING";
1207
+ } | {
1208
+ state: "COMPLETE";
1209
+ presentation: QrPresentation;
1210
+ };
1223
1211
  interface QrExpect {
1224
1212
  issuer?: string;
1225
1213
  /** RP UUID. */
@@ -1283,6 +1271,15 @@ declare class QrApi {
1283
1271
  maxWaitMs?: number;
1284
1272
  serverPollMs?: number;
1285
1273
  }): Promise<QrPresentation>;
1274
+ /**
1275
+ * Нэг удаагийн шалгалт (polling UI-д): `GET /session/{id}` (`serverPollMs` хүртэл, анхдагч 1000 мс) — иргэн хараахан
1276
+ * хариулаагүй бол `{ state: "RUNNING" }`, зөвшөөрсөн бол JWS/JWKS-ээр шалгасан `{ state: "COMPLETE", presentation }`.
1277
+ * Татгалзсан / CA-ийн хугацаа дууссан бол SessionFailedError; бусад алдаа {@link result}-тэй ижил.
1278
+ */
1279
+ check(session: QrSession, opts?: {
1280
+ serverPollMs?: number;
1281
+ }): Promise<QrCheck>;
1282
+ private finish;
1286
1283
  /** Хадгалсан presentation JWS-ийг QrSession-тэй тулгаж шалгана (JWKS кэш; танихгүй kid → нэг удаа дахин татна). */
1287
1284
  verify(jws: string, session: QrSession): Promise<QrPresentation>;
1288
1285
  private keys;
@@ -1452,11 +1449,10 @@ declare class EidClient {
1452
1449
 
1453
1450
  /**
1454
1451
  * `POST /pdf/signatures`-ийн биеийн талбарууд — CA `server/internal/dto/pdf.go` `PDFSignatureRegisterRequest`-ийн JSON
1455
- * tag (CA main d948fdd4, !355; `images` — APPEARANCE_SPEC §6.6, Go SDK #44, CA талд нэмэгдэж буй). CA `DisallowUnknownFields`
1456
- * тул SDK зөвхөн эдгээрийг илгээнэ. Live discovery-ийн
1452
+ * tag (CA main d948fdd4, !355). CA `DisallowUnknownFields` тул SDK зөвхөн эдгээрийг илгээнэ. Live discovery-ийн
1457
1453
  * `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
1458
1454
  */
1459
- declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi", "images"];
1455
+ declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
1460
1456
  /**
1461
1457
  * `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
1462
1458
  * 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
@@ -1841,4 +1837,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1841
1837
  */
1842
1838
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1843
1839
 
1844
- export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, DEFAULT_PDF_TIMEOUT_MS, DEFAULT_QR_ISSUER, DEFAULT_QR_JWKS_CACHE_TTL_MS, DEFAULT_QR_JWKS_URL, DEFAULT_QR_MAX_AGE_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, EidImage, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, type Jwk, type Jwks, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PdfSignatureImage, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, QR_ATTRIBUTES, QR_CLOCK_SKEW_MS, QR_ERROR_CODES, QR_PREFIX, QrApi, type QrAttribute, type QrAttrs, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrFullName, type QrPresentation, type QrSession, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, certificateLevelOf, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifyTokenCertificates, withReturnHint };
1840
+ export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, DEFAULT_PDF_TIMEOUT_MS, DEFAULT_QR_ISSUER, DEFAULT_QR_JWKS_CACHE_TTL_MS, DEFAULT_QR_JWKS_URL, DEFAULT_QR_MAX_AGE_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, type Jwk, type Jwks, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, QR_ATTRIBUTES, QR_CLOCK_SKEW_MS, QR_ERROR_CODES, QR_PREFIX, QrApi, type QrAttribute, type QrAttrs, type QrCheck, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrFullName, type QrPresentation, type QrSession, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, certificateLevelOf, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifyTokenCertificates, withReturnHint };
package/dist/index.d.ts CHANGED
@@ -1,9 +1,8 @@
1
- import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, b as PersonBlock, c as RepresentationsResponse, E as EidImage, A as AcspContext, F as FlowType } from './types-Cf3GT4wh.js';
2
- export { d as DEFAULT_SIGN_SESSION_TTL_MS, e as EndResult, O as OrgResult, P as PdfImage, f as Representation, g as SessionPresentation, h as SessionState, i as SignContext, j as SignatureAlgorithmParameters, k as SignatureProtocol, T as TokenCertSessionBlock, l as TokenCertStatus, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './types-Cf3GT4wh.js';
3
- import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-mcDbKiz_.js';
4
- export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-mcDbKiz_.js';
1
+ import { R as RpCredentials, C as CertificateLevel, I as Interaction, S as SignatureAlgorithm, H as HashAlgorithm, N as NotificationSession, D as DeviceLinkSession, a as SessionResult, P as PersonBlock, b as RepresentationsResponse, A as AcspContext, F as FlowType } from './browser-CCP--VGv.js';
2
+ export { c as DEFAULT_SIGN_SESSION_TTL_MS, E as EndResult, d as NavigatorLike, O as OrgResult, e as Representation, f as SessionPresentation, g as SessionState, h as SignContext, i as SignatureAlgorithmParameters, j as SignatureProtocol, T as TokenCertSessionBlock, k as TokenCertStatus, l as isMobileUserAgent, p as parseExpiresAt, s as sessionExpiry, m as startExpiry } from './browser-CCP--VGv.js';
3
+ import { O as OnBehalfErrorCode, R as RetryableErrorCode, E as EidError, A as ApiError, H as HttpErrorInit } from './errors-CgJcEjrZ.js';
4
+ export { a as AppTransactionTooLargeError, b as AuthenticationError, C as CertChoiceInvalidError, D as DeviceLinkError, F as ForbiddenError, N as NetworkError, c as NoSigningCertificateError, d as ON_BEHALF_ERROR_CODES, P as PDF_REGISTER_ERROR_CODES, e as PdfRegisterErrorCode, Q as QrTokenInvalidError, f as RETRYABLE_ERROR_CODES, g as RequestInvalidError, h as ResponseTooLargeError, S as SessionFailedError, V as ValidationError, p as parseRetryAfter } from './errors-CgJcEjrZ.js';
5
5
  import { X509Certificate, KeyObject } from 'node:crypto';
6
- export { NavigatorLike, isMobileUserAgent } from './browser.js';
7
6
 
8
7
  interface HttpConfig {
9
8
  /** RP-API-ийн бүтэн суурь URL. Ж: https://rp.eidmongolia.mn */
@@ -220,18 +219,6 @@ interface RegisterSignatureInput {
220
219
  onBehalfOf?: string;
221
220
  /** Заавал биш (`PNOMN-…`): ирвэл CMS-ийн зурагчийн SERIALNUMBER-тэй тэнцүү (эс бөгөөс 409 `SIGNER_MISMATCH`). */
222
221
  signerEtsi?: string;
223
- /**
224
- * `complete().images` (0.31.0+) — харагдах дүрслэлд шигтгэсэн зураг бүрийн `{kind, sha256}` (pades APPEARANCE_SPEC.md
225
- * §6.6): CA зурагчийн/байгууллагын хадгалсан PNG-тэй тулгана. Зураггүй бол илгээхгүй.
226
- */
227
- images?: PdfSignatureImage[];
228
- }
229
- /** {@link RegisterSignatureInput.images}-ийн нэг мөр (Go `eid.PDFSignatureImage`). */
230
- interface PdfSignatureImage {
231
- /** `signature` — иргэний гарын үсгийн зураг; `stamp` — байгууллагын тамганы зураг. */
232
- kind: "signature" | "stamp";
233
- /** CA-ийн хадгалсан PNG-ийн SHA-256 (64 жижиг hex). */
234
- sha256: string;
235
222
  }
236
223
  /** Өмнөх нэг гарын үсгийн хоёр түлхүүр ({@link RegisterSignatureInput.priorSignatures}). */
237
224
  interface PriorSignature {
@@ -255,8 +242,6 @@ interface CompletedForRegistration {
255
242
  priorRevisionSha256?: string[];
256
243
  /** `complete().claimedRole` (0.27.0+) — хоосон биш бол `onBehalfOf` заавал. */
257
244
  claimedRole?: string;
258
- /** `complete().images` (0.31.0+) — байвал `images` болж илгээгдэнэ. */
259
- images?: PdfSignatureImage[];
260
245
  }
261
246
  /**
262
247
  * `pades.complete()`-ийн үр дүнгээс `registerSignature`-ийн биеийг бөглөнө (`hasPage`-ийг илгээхгүй — CA `revIndex`-ээс
@@ -578,12 +563,6 @@ declare class PersonApi {
578
563
  summary(personEtsi: string): Promise<PersonSummary>;
579
564
  /** Асран хамгаалж буй хүүхдүүд (зөвхөн унших). */
580
565
  children(personEtsi: string): Promise<PersonChildren>;
581
- /**
582
- * GET /person/etsi/{personEtsi}/signature-image — иргэний гарын үсгийн зураг (харагдах гарын үсэгт:
583
- * `appearance.signatureImage = img.pdfImage`). PKI_READ биш, **SIGN** эрх; иргэн сүүлийн 24 цагт танай RP-ээр
584
- * нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Иргэн зураг хадгалаагүй (404) бол `null`.
585
- */
586
- signatureImage(personEtsi: string): Promise<EidImage | null>;
587
566
  }
588
567
 
589
568
  /** Задалсан subject. Cert-д байхгүй талбар — undefined. Давхардсан OID-ийн эхнийх нь. */
@@ -1159,8 +1138,10 @@ declare const QR_CLOCK_SKEW_MS = 60000;
1159
1138
  * - `QR_ATTRIBUTES_INVALID` — аттрибут хоосон / каталогид алга / давхардсан (клиент талын, CA руу явахгүй)
1160
1139
  * - `QR_PRESENTATION_INVALID` — JWS шалгалт унасан — хариунд ИТГЭХГҮЙ
1161
1140
  * - `QR_JWKS_UNAVAILABLE` — CA-ийн JWKS татагдсангүй (түр; дахин оролдож болно)
1141
+ * - `QR_PENDING` — `qr.result`-ийн хүлээх хугацаа (`maxWaitMs`) дууссан ч иргэн хараахан хариулаагүй (CA-ийн session
1142
+ * идэвхтэй хэвээр) — дахин `result` / `check` дуудаж болно. CA-ийн жинхэнэ хугацаа дуусалт = SessionFailedError TIMEOUT.
1162
1143
  */
1163
- declare const QR_ERROR_CODES: readonly ["QR_FORMAT_INVALID", "QR_TOKEN_INVALID", "QR_ATTRIBUTES_INVALID", "QR_PRESENTATION_INVALID", "QR_JWKS_UNAVAILABLE"];
1144
+ declare const QR_ERROR_CODES: readonly ["QR_FORMAT_INVALID", "QR_TOKEN_INVALID", "QR_ATTRIBUTES_INVALID", "QR_PRESENTATION_INVALID", "QR_JWKS_UNAVAILABLE", "QR_PENDING"];
1164
1145
  type QrErrorCode = (typeof QR_ERROR_CODES)[number];
1165
1146
  /** «Миний QR»-ийн клиент талын алдаа. */
1166
1147
  declare class QrError extends EidError {
@@ -1220,6 +1201,13 @@ interface QrPresentation {
1220
1201
  /** Түүхий compact JWS (аудитад хадгалж болно). */
1221
1202
  jws: string;
1222
1203
  }
1204
+ /** `qr.check`-ийн хариу: иргэн хараахан хариулаагүй, эсвэл шалгагдсан presentation. */
1205
+ type QrCheck = {
1206
+ state: "RUNNING";
1207
+ } | {
1208
+ state: "COMPLETE";
1209
+ presentation: QrPresentation;
1210
+ };
1223
1211
  interface QrExpect {
1224
1212
  issuer?: string;
1225
1213
  /** RP UUID. */
@@ -1283,6 +1271,15 @@ declare class QrApi {
1283
1271
  maxWaitMs?: number;
1284
1272
  serverPollMs?: number;
1285
1273
  }): Promise<QrPresentation>;
1274
+ /**
1275
+ * Нэг удаагийн шалгалт (polling UI-д): `GET /session/{id}` (`serverPollMs` хүртэл, анхдагч 1000 мс) — иргэн хараахан
1276
+ * хариулаагүй бол `{ state: "RUNNING" }`, зөвшөөрсөн бол JWS/JWKS-ээр шалгасан `{ state: "COMPLETE", presentation }`.
1277
+ * Татгалзсан / CA-ийн хугацаа дууссан бол SessionFailedError; бусад алдаа {@link result}-тэй ижил.
1278
+ */
1279
+ check(session: QrSession, opts?: {
1280
+ serverPollMs?: number;
1281
+ }): Promise<QrCheck>;
1282
+ private finish;
1286
1283
  /** Хадгалсан presentation JWS-ийг QrSession-тэй тулгаж шалгана (JWKS кэш; танихгүй kid → нэг удаа дахин татна). */
1287
1284
  verify(jws: string, session: QrSession): Promise<QrPresentation>;
1288
1285
  private keys;
@@ -1452,11 +1449,10 @@ declare class EidClient {
1452
1449
 
1453
1450
  /**
1454
1451
  * `POST /pdf/signatures`-ийн биеийн талбарууд — CA `server/internal/dto/pdf.go` `PDFSignatureRegisterRequest`-ийн JSON
1455
- * tag (CA main d948fdd4, !355; `images` — APPEARANCE_SPEC §6.6, Go SDK #44, CA талд нэмэгдэж буй). CA `DisallowUnknownFields`
1456
- * тул SDK зөвхөн эдгээрийг илгээнэ. Live discovery-ийн
1452
+ * tag (CA main d948fdd4, !355). CA `DisallowUnknownFields` тул SDK зөвхөн эдгээрийг илгээнэ. Live discovery-ийн
1457
1453
  * `endpoints.pdf.signatures` тайлбартай гэрээний тест тулгана.
1458
1454
  */
1459
- declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi", "images"];
1455
+ declare const PDF_SIGNATURE_REGISTER_FIELDS: readonly ["docID", "revIndex", "medium", "sessionID", "cms", "fileName", "inSha256", "pageSha256", "sigRevSha256", "outSha256", "priorCmsSha256", "priorRevisionSha256", "onBehalfOf", "signerEtsi"];
1460
1456
  /**
1461
1457
  * `POST /share`-ийн multipart талбарууд — CA `server/internal/httpapi/handlers_share.go` `parseShareRequest` (CA main
1462
1458
  * 0329ef95, !371). CA үл мэдэгдэх талбарыг 400 REQUEST_INVALID-аар татгалздаг. Live discovery-ийн `endpoints.share`
@@ -1841,4 +1837,4 @@ declare function withReturnHint(callbackUrl: string, userAgent: string): string;
1841
1837
  */
1842
1838
  declare function createEidLogin(opts: EidLoginOptions): EidLogin;
1843
1839
 
1844
- export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, DEFAULT_PDF_TIMEOUT_MS, DEFAULT_QR_ISSUER, DEFAULT_QR_JWKS_CACHE_TTL_MS, DEFAULT_QR_JWKS_URL, DEFAULT_QR_MAX_AGE_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, EidImage, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, type Jwk, type Jwks, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PdfSignatureImage, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, QR_ATTRIBUTES, QR_CLOCK_SKEW_MS, QR_ERROR_CODES, QR_PREFIX, QrApi, type QrAttribute, type QrAttrs, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrFullName, type QrPresentation, type QrSession, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, certificateLevelOf, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifyTokenCertificates, withReturnHint };
1840
+ export { APP_ATTESTATION_INVALID, AcspContext, type AcspV2Params, type ActivityCounts, type ActivityItem, type ActivityQuery, ApiError, AuthApi, type AuthDefaults, type AuthOptions, type BuildDeviceLinkInput, CITIZEN_INTERMEDIATES_PEM, CITIZEN_ISSUING_CA_SKI, CSR_KEY_REUSED, type CertChoiceOptions, type CertCounts, type CertSubject, CertificateLevel, type ClientConfig, type CompletedForRegistration, DEFAULT_BASE_URL, DEFAULT_MAX_WAIT_MS, DEFAULT_PDF_TIMEOUT_MS, DEFAULT_QR_ISSUER, DEFAULT_QR_JWKS_CACHE_TTL_MS, DEFAULT_QR_JWKS_URL, DEFAULT_QR_MAX_AGE_MS, DEFAULT_SHARE_TIMEOUT_MS, DeviceLinkSession, type DeviceLinkSessionType, type DeviceLinkType, EidClient, EidError, type EidLogin, type EidLoginContext, type EidLoginEvent, type EidLoginEventKind, type EidLoginIdentity, type EidLoginMode, type EidLoginOptions, type EidLoginRateLimitFn, type EidLoginRateLimits, type EidLoginRateRule, type EidLoginRequest, type EidLoginResponse, type EidLoginStore, type EidLoginSuccess, type EidLoginTx, FlowType, HashAlgorithm, Http, type HttpConfig, HttpErrorInit, Interaction, type Jwk, type Jwks, KYC_INCOMPLETE, LoginStoreFullError, MAX_APP_TRANSACTION_BYTES, MEMORY_LOGIN_STORE_MAX, NATIONAL_ROOT_CA_PEM, NO_ACTIVE_DEVICE, NotificationSession, type OcspCheckerOptions, OnBehalfErrorCode, OrganizationApi, PDF_SIGNATURE_REGISTER_FIELDS, type PdfDigestInput, type PdfDigestSession, type PdfDigestSigner, type PersonActivity, PersonApi, PersonBlock, type PersonCertificate, type PersonCertificates, type PersonChild, type PersonChildren, type PersonDevice, type PersonDevices, type PersonSummary, type PriorSignature, QR_ATTRIBUTES, QR_CLOCK_SKEW_MS, QR_ERROR_CODES, QR_PREFIX, QrApi, type QrAttribute, type QrAttrs, type QrCheck, type QrConfig, type QrDeviceLinkTickerOptions, QrError, type QrErrorCode, type QrExpect, type QrFullName, type QrPresentation, type QrSession, type QrStartInput, type RegisterSignatureInput, type RegisterSignatureResult, RepresentationsResponse, ResponseValidator, RetryableErrorCode, type RevocationChecker, type RevocationOutcome, type RevocationStatus, RpCredentials, SHARE_ERROR_CODES, SHARE_FORM_FIELDS, SessionApi, SessionResult, type SessionTtl, ShareError, type ShareErrorCode, type ShareInfo, type ShareInput, type ShareNotSignedReason, type ShareResult, SignApi, type SignDefaults, type SignOptions, SignatureAlgorithm, type Signer, type SignerRef, TOKEN_CONFLICT_CODES, TOKEN_ERROR_CODES, TOKEN_ISSUANCE_PENDING, TokenApi, type TokenAuthChallenge, type TokenAuthResult, type TokenCertInfo, type TokenCertInput, type TokenCertItem, type TokenCertPreview, type TokenCertResult, type TokenCertStart, type TokenConflictCode, type TokenErrorCode, type TokenIdentity, type TokenLimit, type TokenOrganization, type TrustConfig, type ValidateAuthOptions, type ValidateSignOptions, type VerifiedIdentity, type VerifiedSignature, WAIT_GRACE_MS, acspV2Digest, buildAcspV2Payload, buildDeviceLink, buildRegisterBody, certificateLevelOf, createEidLogin, defaultRateLimit, deviceLinkInput, forwardedClientIp, interactionsToBase64, memoryLoginStore, ocspRevocationChecker, parseQr, parseSessionResult, parseSubject, personMatchesCertificate, qrDeviceLinkTicker, randomChallenge, registrationFromCompleted, resolveBaseUrl, sha256Base64, tokenAuthDigest, tokenLimitOf, userChallengeOf, verifyPayloadSignature, verifyPrehashedSignature, verifyQrPresentation, verifyTokenCertificates, withReturnHint };
package/dist/index.js CHANGED
@@ -31,7 +31,7 @@ import {
31
31
  ValidationError,
32
32
  maskPath,
33
33
  parseRetryAfter
34
- } from "./chunk-TNXO4QLU.js";
34
+ } from "./chunk-PWFTN52X.js";
35
35
 
36
36
  // src/http.ts
37
37
  var DEFAULT_TIMEOUT_MS = 15e3;
@@ -169,7 +169,6 @@ var RP_ROUTES = {
169
169
  personActivity: { method: "GET", path: "/rp/activity/etsi/{personEtsi}" },
170
170
  personSummary: { method: "GET", path: "/person/summary/etsi/{personEtsi}" },
171
171
  personChildren: { method: "GET", path: "/person/children/etsi/{personEtsi}" },
172
- personSignatureImage: { method: "GET", path: "/person/etsi/{personEtsi}/signature-image" },
173
172
  tokenCertificate: { method: "POST", path: "/token/certificate" },
174
173
  tokenCertificateResult: { method: "GET", path: "/token/certificate/{sessionID}" },
175
174
  pdfSignatures: { method: "POST", path: "/pdf/signatures" },
@@ -193,8 +192,7 @@ var PDF_SIGNATURE_REGISTER_FIELDS = [
193
192
  "priorCmsSha256",
194
193
  "priorRevisionSha256",
195
194
  "onBehalfOf",
196
- "signerEtsi",
197
- "images"
195
+ "signerEtsi"
198
196
  ];
199
197
  var SHARE_FORM_FIELDS = ["file", "filename", "to", "subject", "message", "lang"];
200
198
  function routePath(route, ...args) {
@@ -402,7 +400,6 @@ function registrationFromCompleted(done, extra) {
402
400
  }
403
401
  if (extra.onBehalfOf) out.onBehalfOf = extra.onBehalfOf;
404
402
  if (extra.signerEtsi) out.signerEtsi = extra.signerEtsi;
405
- if (done.images?.length) out.images = done.images.map((x) => ({ kind: x.kind, sha256: x.sha256 }));
406
403
  return out;
407
404
  }
408
405
  function priorSplits(n) {
@@ -464,12 +461,6 @@ function buildRegisterBody(input) {
464
461
  if (priorRev.length) body.priorRevisionSha256 = priorRev;
465
462
  if (input.onBehalfOf?.trim()) body.onBehalfOf = input.onBehalfOf.trim();
466
463
  if (input.signerEtsi?.trim()) body.signerEtsi = input.signerEtsi.trim();
467
- if (input.images?.length) {
468
- body.images = input.images.map((x, i) => {
469
- if (x?.kind !== "signature" && x?.kind !== "stamp") fail2(`images[${i}].kind: signature | stamp`);
470
- return { kind: x.kind, sha256: hex(`images[${i}].sha256`, x.sha256) };
471
- });
472
- }
473
464
  for (const k of Object.keys(body)) if (!PDF_SIGNATURE_REGISTER_FIELDS.includes(k)) fail2(`\u0434\u043E\u0442\u043E\u043E\u0434: \u04AF\u043B \u043C\u044D\u0434\u044D\u0433\u0434\u044D\u0445 \u0442\u0430\u043B\u0431\u0430\u0440 ${k}`);
474
465
  return body;
475
466
  }
@@ -949,19 +940,6 @@ var PersonApi = class {
949
940
  children(personEtsi) {
950
941
  return this.get(routePath(RP_ROUTES.personChildren, personEtsi));
951
942
  }
952
- /**
953
- * GET /person/etsi/{personEtsi}/signature-image — иргэний гарын үсгийн зураг (харагдах гарын үсэгт:
954
- * `appearance.signatureImage = img.pdfImage`). PKI_READ биш, **SIGN** эрх; иргэн сүүлийн 24 цагт танай RP-ээр
955
- * нэвтэрсэн байх ёстой (эс бөгөөс `ForbiddenError`). Иргэн зураг хадгалаагүй (404) бол `null`.
956
- */
957
- async signatureImage(personEtsi) {
958
- try {
959
- return rec3(await this.http.get(routePath(RP_ROUTES.personSignatureImage, personEtsi)));
960
- } catch (e) {
961
- if (e instanceof ApiError && e.status === 404) return null;
962
- throw e;
963
- }
964
- }
965
943
  };
966
944
 
967
945
  // src/token.ts
@@ -2056,7 +2034,8 @@ var QR_ERROR_CODES = [
2056
2034
  "QR_TOKEN_INVALID",
2057
2035
  "QR_ATTRIBUTES_INVALID",
2058
2036
  "QR_PRESENTATION_INVALID",
2059
- "QR_JWKS_UNAVAILABLE"
2037
+ "QR_JWKS_UNAVAILABLE",
2038
+ "QR_PENDING"
2060
2039
  ];
2061
2040
  var QrError = class extends EidError {
2062
2041
  constructor(code, reason) {
@@ -2269,7 +2248,21 @@ var QrApi = class {
2269
2248
  async result(session, opts) {
2270
2249
  if (!session?.sessionId) throw new EidError("qr.result: QrSession \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
2271
2250
  const r = await this.d.session.waitForResult(session.sessionId, { expiresAt: session.expiresAt, ...opts });
2272
- if (r.state !== "COMPLETE") throw new SessionFailedError("TIMEOUT");
2251
+ if (r.state !== "COMPLETE") throw new QrError("QR_PENDING", "\u0438\u0440\u0433\u044D\u043D \u0445\u0430\u0440\u0430\u0430\u0445\u0430\u043D \u0445\u0430\u0440\u0438\u0443\u043B\u0430\u0430\u0433\u04AF\u0439");
2252
+ return this.finish(r, session);
2253
+ }
2254
+ /**
2255
+ * Нэг удаагийн шалгалт (polling UI-д): `GET /session/{id}` (`serverPollMs` хүртэл, анхдагч 1000 мс) — иргэн хараахан
2256
+ * хариулаагүй бол `{ state: "RUNNING" }`, зөвшөөрсөн бол JWS/JWKS-ээр шалгасан `{ state: "COMPLETE", presentation }`.
2257
+ * Татгалзсан / CA-ийн хугацаа дууссан бол SessionFailedError; бусад алдаа {@link result}-тэй ижил.
2258
+ */
2259
+ async check(session, opts) {
2260
+ if (!session?.sessionId) throw new EidError("qr.check: QrSession \u0448\u0430\u0430\u0440\u0434\u043B\u0430\u0433\u0430\u0442\u0430\u0439");
2261
+ const r = await this.d.session.poll(session.sessionId, opts?.serverPollMs ?? 1e3);
2262
+ if (r.state !== "COMPLETE") return { state: "RUNNING" };
2263
+ return { state: "COMPLETE", presentation: await this.finish(r, session) };
2264
+ }
2265
+ finish(r, session) {
2273
2266
  if (r.endResult !== "OK") throw new SessionFailedError(r.endResult ?? "UNKNOWN");
2274
2267
  const jws = r.presentation?.jws;
2275
2268
  if (!jws) throw bad("\u0445\u0430\u0440\u0438\u0443\u043D\u0434 presentation \u0430\u043B\u0433\u0430");