@gerege-systems/eid-mongolia-sdk 0.46.1 → 0.47.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.js CHANGED
@@ -14,6 +14,11 @@ import {
14
14
  import {
15
15
  ApiError,
16
16
  AppTransactionTooLargeError,
17
+ AuthSessionAlreadyUsedError,
18
+ AuthSessionNotCompletedError,
19
+ AuthSessionNotFoundError,
20
+ AuthSessionTooOldError,
21
+ AuthSessionWrongFlowError,
17
22
  AuthenticationError,
18
23
  CertChoiceInvalidError,
19
24
  DeviceLinkError,
@@ -28,12 +33,18 @@ import {
28
33
  RETRYABLE_ERROR_CODES,
29
34
  RequestInvalidError,
30
35
  ResponseTooLargeError,
36
+ RpNotActiveError,
37
+ RpPermissionsFullError,
31
38
  SEAL_ERROR_CODES,
39
+ SEAL_GRANT_ERROR_CODES,
32
40
  SealApproverUnavailableError,
33
41
  SealCertExpiredError,
34
42
  SealCertNotYetValidError,
35
43
  SealCertRevokedError,
36
44
  SealCertificateRequestError,
45
+ SealGrantAlreadyApprovedError,
46
+ SealGrantNotFoundError,
47
+ SealGrantRequestError,
37
48
  SealKeyUnavailableError,
38
49
  SealNotIssuedError,
39
50
  SealRequestNotFoundError,
@@ -42,7 +53,7 @@ import {
42
53
  ValidationError,
43
54
  maskPath,
44
55
  parseRetryAfter
45
- } from "./chunk-6AGWRTZG.js";
56
+ } from "./chunk-J4BEQDT3.js";
46
57
 
47
58
  // src/http.ts
48
59
  var TYPED_API_ERRORS = /* @__PURE__ */ new Map([
@@ -58,7 +69,16 @@ var TYPED_API_ERRORS = /* @__PURE__ */ new Map([
58
69
  ["SEAL_CERT_NOT_YET_VALID", SealCertNotYetValidError],
59
70
  ["SEAL_APPROVER_UNAVAILABLE", SealApproverUnavailableError],
60
71
  ["SEAL_REQUEST_NOT_FOUND", SealRequestNotFoundError],
61
- ["SEAL_SERVICE_DISABLED", SealServiceDisabledError]
72
+ ["SEAL_SERVICE_DISABLED", SealServiceDisabledError],
73
+ ["AUTH_SESSION_WRONG_FLOW", AuthSessionWrongFlowError],
74
+ ["AUTH_SESSION_NOT_COMPLETED", AuthSessionNotCompletedError],
75
+ ["AUTH_SESSION_TOO_OLD", AuthSessionTooOldError],
76
+ ["AUTH_SESSION_ALREADY_USED", AuthSessionAlreadyUsedError],
77
+ ["AUTH_SESSION_NOT_FOUND", AuthSessionNotFoundError],
78
+ ["SEAL_GRANT_ALREADY_APPROVED", SealGrantAlreadyApprovedError],
79
+ ["SEAL_GRANT_NOT_FOUND", SealGrantNotFoundError],
80
+ ["RP_NOT_ACTIVE", RpNotActiveError],
81
+ ["RP_PERMISSIONS_FULL", RpPermissionsFullError]
62
82
  ]);
63
83
  var DEFAULT_TIMEOUT_MS = 15e3;
64
84
  var MAX_JSON_BYTES = 4 << 20;
@@ -189,6 +209,8 @@ var RP_ROUTES = {
189
209
  certChoiceDeviceLink: { method: "POST", path: "/signature/certificate-choice/device-link/anonymous" },
190
210
  certChoiceEtsi: { method: "POST", path: "/signature/certificate-choice/notification/etsi/{semanticsIdentifier}" },
191
211
  orgRepresentations: { method: "GET", path: "/organization/representations/etsi/{personEtsi}" },
212
+ /** Иргэн улсын бүртгэлээр Гүйцэтгэх захирал байгаа байгууллага бүрийн RP тамганы эрхүүд (PKI_READ; CA V156). */
213
+ orgSealGrants: { method: "GET", path: "/organization/seal-grants/etsi/{personEtsi}" },
192
214
  session: { method: "GET", path: "/session/{sessionId}" },
193
215
  personCertificates: { method: "GET", path: "/certificates/etsi/{personEtsi}" },
194
216
  personDevices: { method: "GET", path: "/devices/etsi/{personEtsi}" },
@@ -209,6 +231,10 @@ var RP_ROUTES = {
209
231
  sealCertificateRequest: { method: "POST", path: "/seal/certificate/{orgEtsi}" },
210
232
  /** Тамганы гэрчилгээний хүсэлтийн төлөв (CA !483, ORG_ONBOARDING §4.3) — ISSUED үед `certificate`-тэй. */
211
233
  sealCertificateRequestStatus: { method: "GET", path: "/seal/certificate/{orgEtsi}/requests/{requestId}" },
234
+ /** RP-ийн санаачилсан тамганы эрхийн хүсэлт (CA V156): `{orgEtsi, sessionId}` → 202 `{grantId, orgEtsi, status, expiresAt}`. */
235
+ sealGrantRequest: { method: "POST", path: "/seal/grants" },
236
+ /** Тамганы эрхийн хүсэлтийн төлөв (зөвхөн хүсэлтийн эзэн RP). */
237
+ sealGrantStatus: { method: "GET", path: "/seal/grants/{grantId}" },
212
238
  /** Байгууллагын тамга (CA `dto.SealRequest` `{digest, hashType}` → `dto.SealResponse`). */
213
239
  seal: { method: "POST", path: "/seal/{orgEtsi}" }
214
240
  };
@@ -229,6 +255,7 @@ var PDF_SIGNATURE_REGISTER_FIELDS = [
229
255
  "signerEtsi"
230
256
  ];
231
257
  var SEAL_REQUEST_FIELDS = ["digest", "hashType"];
258
+ var SEAL_GRANT_REQUEST_FIELDS = ["orgEtsi", "sessionId"];
232
259
  var SHARE_FORM_FIELDS = ["file", "filename", "to", "subject", "message", "lang"];
233
260
  function routePath(route, ...args) {
234
261
  let i = 0;
@@ -951,6 +978,17 @@ var OrganizationApi = class {
951
978
  const list = Array.isArray(raw.representations) ? raw.representations : [];
952
979
  return { personEtsi: String(raw.personEtsi ?? personEtsi), representations: list, raw };
953
980
  }
981
+ /**
982
+ * GET /organization/seal-grants/etsi/{personEtsi} — иргэн улсын бүртгэлээр баталгаажсан Гүйцэтгэх захирал байгаа байгууллага
983
+ * бүр ба түүний APPROVED / PENDING RP тамганы эрхүүд (захирлын «миний байгууллагын тамгыг хэн ашиглаж байна» харагдац).
984
+ * PKI_READ эрх шаардана; иргэн сүүлийн 24 цагт танай RP-ээр нэвтэрсэн байх ёстой (үгүй бол 403). Энгийн RP зөвхөн өөрийн
985
+ * эрхийг харна. Зөвхөн унших — эрх цуцлах нь eID аппаас.
986
+ */
987
+ async sealGrants(personEtsi) {
988
+ const raw = await this.http.get(routePath(RP_ROUTES.orgSealGrants, personEtsi));
989
+ const list = Array.isArray(raw.organizations) ? raw.organizations : [];
990
+ return { personEtsi: String(raw.personEtsi ?? personEtsi), organizations: list.map((o) => ({ ...o, grants: Array.isArray(o.grants) ? o.grants : [] })), raw };
991
+ }
954
992
  };
955
993
 
956
994
  // src/seal.ts
@@ -1819,6 +1857,22 @@ function parseSealRequest(raw, orgEtsi) {
1819
1857
  raw
1820
1858
  };
1821
1859
  }
1860
+ function parseSealGrant(raw, orgEtsi) {
1861
+ const r = rec3(raw);
1862
+ if (typeof r.grantId !== "string" || r.grantId === "" || typeof r.status !== "string" || r.status === "") {
1863
+ throw new ValidationError("seal: \u044D\u0440\u0445\u0438\u0439\u043D \u0445\u04AF\u0441\u044D\u043B\u0442\u0438\u0439\u043D \u0445\u0430\u0440\u0438\u0443\u043D\u0434 grantId/status \u0430\u043B\u0433\u0430");
1864
+ }
1865
+ return {
1866
+ grantId: r.grantId,
1867
+ orgEtsi: String(r.orgEtsi ?? orgEtsi ?? ""),
1868
+ status: r.status,
1869
+ expiresAt: String(r.expiresAt ?? ""),
1870
+ ...typeof r.approvedAt === "string" ? { approvedAt: r.approvedAt } : {},
1871
+ ...typeof r.revokedAt === "string" ? { revokedAt: r.revokedAt } : {},
1872
+ ...typeof r.failure === "string" && r.failure ? { failure: r.failure } : {},
1873
+ raw
1874
+ };
1875
+ }
1822
1876
  function sleep(ms2, signal) {
1823
1877
  return new Promise((resolve, reject) => {
1824
1878
  if (signal?.aborted) return reject(signal.reason);
@@ -1896,6 +1950,59 @@ var SealApi = class {
1896
1950
  await sleep(Math.min(wait, left), opts.signal);
1897
1951
  }
1898
1952
  }
1953
+ /**
1954
+ * `POST /seal/grants` `{orgEtsi, sessionId}` — тамганы эрх (`SEAL:<orgEtsi>`)-ийг RP өөрөө хүсэх (202, `status:
1955
+ * "PENDING"`). `sessionId` — танай RP-ийн эхлүүлсэн, сүүлийн 5 минутад OK-оор дууссан AUTHENTICATION session; түүний хүн
1956
+ * байгууллагын улсын бүртгэлээр баталгаажсан Гүйцэтгэх захирал байх ёстой — push зөвхөн түүн рүү очиж PIN2-оор
1957
+ * зөвшөөрнө. Нэг session — нэг хүсэлт; ижил session-ээр дахин дуудвал ижил PENDING хүсэлтийг буцаана. SEAL эрх шаардахгүй,
1958
+ * биллинг тооцохгүй. Төлөвийг {@link waitForGrant} / {@link grantStatus}-ээр асууна. Алдаа: 400 {@link
1959
+ * RequestInvalidError}; 403 `ForbiddenError` (`RP_NOT_REGISTERED` | `NOT_ORG_CEO`); 404 {@link AuthSessionNotFoundError} |
1960
+ * `ORG_NOT_FOUND`; 409 {@link AuthSessionWrongFlowError} | {@link AuthSessionNotCompletedError} | {@link
1961
+ * AuthSessionTooOldError} | {@link AuthSessionAlreadyUsedError} | {@link OrgNotActiveError} | {@link RpNotActiveError} |
1962
+ * {@link SealGrantAlreadyApprovedError} | {@link RpPermissionsFullError} | {@link SealApproverUnavailableError}; 429
1963
+ * `RATE_LIMITED` (`retryAfterMs`).
1964
+ */
1965
+ async requestGrant(orgEtsi, sessionId) {
1966
+ if (typeof orgEtsi !== "string" || orgEtsi.trim() === "" || orgEtsi.length > 64) throw new ValidationError("seal: orgEtsi \u0445\u043E\u043E\u0441\u043E\u043D \u044D\u0441\u0432\u044D\u043B 64 \u0442\u044D\u043C\u0434\u044D\u0433\u0442\u044D\u044D\u0441 \u0443\u0440\u0442");
1967
+ if (typeof sessionId !== "string" || sessionId.trim() === "" || sessionId.length > 64) throw new ValidationError("seal: sessionId \u0445\u043E\u043E\u0441\u043E\u043D \u044D\u0441\u0432\u044D\u043B 64 \u0442\u044D\u043C\u0434\u044D\u0433\u0442\u044D\u044D\u0441 \u0443\u0440\u0442");
1968
+ const body = { orgEtsi: orgEtsi.trim(), sessionId: sessionId.trim() };
1969
+ return parseSealGrant(await this.http.post(RP_ROUTES.sealGrantRequest.path, body), body.orgEtsi);
1970
+ }
1971
+ /**
1972
+ * `GET /seal/grants/{grantId}` — хүсэлтийн төлөв. Зөвхөн хүсэлтийн эзэн RP; бусад RP-д / олдоогүй → {@link
1973
+ * SealGrantNotFoundError} 404. `APPROVED` нь эрх цуцлагдтал хэвээр (`REVOKED` болтол).
1974
+ */
1975
+ async grantStatus(grantId) {
1976
+ if (typeof grantId !== "string" || grantId === "") throw new ValidationError("seal: grantId \u0445\u043E\u043E\u0441\u043E\u043D");
1977
+ return parseSealGrant(await this.http.get(routePath(RP_ROUTES.sealGrantStatus, grantId)));
1978
+ }
1979
+ /**
1980
+ * Хүсэлт APPROVED болтол `intervalMs` тутамд асууж зөвшөөрсөн хүсэлтийг буцаана. REJECTED / EXPIRED / FAILED / REVOKED →
1981
+ * {@link SealGrantRequestError} (`outcome`, `failure`; шинэ хүсэлт хэрэгтэй); `timeoutMs` дуусвал `outcome: "TIMEOUT"`
1982
+ * (хүсэлт серверт PENDING хэвээр — ижил `grantId`-аар дахин хүлээж болно). Түр алдаа (`ApiError.retryable`) — Retry-After-ийг
1983
+ * хүлээгээд үргэлжилнэ; бусад алдаа шууд шидэгдэнэ. Хүлээх хугацаа, зайн анхдагч нь {@link waitForCertificate}-тэй ижил.
1984
+ */
1985
+ async waitForGrant(grantId, opts = {}) {
1986
+ const interval = opts.intervalMs !== void 0 && opts.intervalMs > 0 ? opts.intervalMs : DEFAULT_SEAL_POLL_INTERVAL_MS;
1987
+ const deadline = Date.now() + (opts.timeoutMs !== void 0 && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_SEAL_WAIT_TIMEOUT_MS);
1988
+ for (; ; ) {
1989
+ if (opts.signal?.aborted) throw opts.signal.reason;
1990
+ let wait = interval;
1991
+ try {
1992
+ const g = await this.grantStatus(grantId);
1993
+ if (g.status === "APPROVED") return g;
1994
+ if (g.status === "REJECTED" || g.status === "EXPIRED" || g.status === "FAILED" || g.status === "REVOKED") {
1995
+ throw new SealGrantRequestError(g.status, g.grantId, g.failure);
1996
+ }
1997
+ } catch (e) {
1998
+ if (!(e instanceof ApiError && e.retryable)) throw e;
1999
+ wait = Math.max(interval, e.retryAfterMs ?? 0);
2000
+ }
2001
+ const left = deadline - Date.now();
2002
+ if (left <= 0) throw new SealGrantRequestError("TIMEOUT", grantId);
2003
+ await sleep(Math.min(wait, left), opts.signal);
2004
+ }
2005
+ }
1899
2006
  /**
1900
2007
  * `POST /seal/{orgEtsi}` — digest-ийг байгууллагын тамгаар тамгална. `hashAlgorithm`: SHA-256 (анхдагч) | SHA-384 |
1901
2008
  * SHA-512; digest-ийн урт таарахгүй бол сүлжээнд гарахгүй. Хариуны гарын үсгийг хариуны гэрчилгээгээр digest дээр
@@ -3543,6 +3650,11 @@ export {
3543
3650
  ApiError,
3544
3651
  AppTransactionTooLargeError,
3545
3652
  AuthApi,
3653
+ AuthSessionAlreadyUsedError,
3654
+ AuthSessionNotCompletedError,
3655
+ AuthSessionNotFoundError,
3656
+ AuthSessionTooOldError,
3657
+ AuthSessionWrongFlowError,
3546
3658
  AuthenticationError,
3547
3659
  CITIZEN_INTERMEDIATES_PEM,
3548
3660
  CITIZEN_ISSUING_CA_SKI,
@@ -3587,7 +3699,11 @@ export {
3587
3699
  RequestInvalidError,
3588
3700
  ResponseTooLargeError,
3589
3701
  ResponseValidator,
3702
+ RpNotActiveError,
3703
+ RpPermissionsFullError,
3590
3704
  SEAL_ERROR_CODES,
3705
+ SEAL_GRANT_ERROR_CODES,
3706
+ SEAL_GRANT_REQUEST_FIELDS,
3591
3707
  SEAL_REQUEST_FIELDS,
3592
3708
  SHARE_ERROR_CODES,
3593
3709
  SHARE_FORM_FIELDS,
@@ -3597,6 +3713,9 @@ export {
3597
3713
  SealCertNotYetValidError,
3598
3714
  SealCertRevokedError,
3599
3715
  SealCertificateRequestError,
3716
+ SealGrantAlreadyApprovedError,
3717
+ SealGrantNotFoundError,
3718
+ SealGrantRequestError,
3600
3719
  SealKeyUnavailableError,
3601
3720
  SealNotIssuedError,
3602
3721
  SealRequestNotFoundError,
package/dist/pades.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-yzUBuWFg.cjs';
1
+ import { E as EidError } from './errors-BekL912E.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
package/dist/pades.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-yzUBuWFg.js';
1
+ import { E as EidError } from './errors-BekL912E.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  /** Олгогчийн гарын үсэгтэй «revoked» хариу (OCSP эсвэл CRL) — complete-д дахин оролдохгүй хатуу алдаа (Go ErrCertificateRevoked). */
package/dist/pades.js CHANGED
@@ -59,7 +59,7 @@ import {
59
59
  } from "./chunk-BTT7P7GB.js";
60
60
  import {
61
61
  EidError
62
- } from "./chunk-6AGWRTZG.js";
62
+ } from "./chunk-J4BEQDT3.js";
63
63
 
64
64
  // src/pades/limits.ts
65
65
  var MAX_INPUT_BYTES = (10 << 20) - (256 << 10);
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-yzUBuWFg.cjs';
1
+ import { E as EidError } from './errors-BekL912E.cjs';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.cjs';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
@@ -1,4 +1,4 @@
1
- import { E as EidError } from './errors-yzUBuWFg.js';
1
+ import { E as EidError } from './errors-BekL912E.js';
2
2
  import { F as FetchFn } from './fetch-BjfH46q9.js';
3
3
 
4
4
  type Indication = "valid" | "invalid" | "indeterminate";
package/dist/validate.js CHANGED
@@ -65,7 +65,7 @@ import {
65
65
  } from "./chunk-BTT7P7GB.js";
66
66
  import {
67
67
  EidError
68
- } from "./chunk-6AGWRTZG.js";
68
+ } from "./chunk-J4BEQDT3.js";
69
69
 
70
70
  // src/pades/validate/evaluate.ts
71
71
  var PROBLEMS = {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gerege-systems/eid-mongolia-sdk",
3
- "version": "0.46.1",
3
+ "version": "0.47.0",
4
4
  "description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -49,7 +49,7 @@
49
49
  },
50
50
  "scripts": {
51
51
  "build": "tsup src/index.ts src/browser.ts src/pades.ts src/validate.ts --format esm,cjs --dts --clean && tsup src/button.ts --format esm,cjs --dts --tsconfig tsconfig.button.json && tsup src/convert.ts --format esm --dts --tsconfig tsconfig.button.json",
52
- "test": "npm run build && node --test --experimental-strip-types test/sdk.test.ts test/portal-gaps.test.ts test/chain.test.ts test/qr.test.ts test/myqr.test.ts test/login.test.ts test/button.test.ts test/sign-gaps.test.ts test/session-start.test.ts test/pades-session.test.ts test/pades-golden.test.ts test/pades-placement.test.ts test/pades-unit.test.ts test/convert.test.ts test/share.test.ts test/validate-golden.test.ts test/validate-revisions.test.ts test/validate-env.test.ts test/pades-revocation.test.ts test/pades-ltv-order.test.ts test/pades-encrypt.test.ts test/pades-objstm.test.ts test/pades-objstm-encrypt.test.ts test/validate-fuzz.test.ts test/pades-lexer-loop.test.ts test/seal.test.ts",
52
+ "test": "npm run build && node --test --experimental-strip-types test/sdk.test.ts test/portal-gaps.test.ts test/chain.test.ts test/qr.test.ts test/myqr.test.ts test/login.test.ts test/button.test.ts test/sign-gaps.test.ts test/session-start.test.ts test/pades-session.test.ts test/pades-golden.test.ts test/pades-placement.test.ts test/pades-unit.test.ts test/convert.test.ts test/share.test.ts test/validate-golden.test.ts test/validate-revisions.test.ts test/validate-env.test.ts test/pades-revocation.test.ts test/pades-ltv-order.test.ts test/pades-encrypt.test.ts test/pades-objstm.test.ts test/pades-objstm-encrypt.test.ts test/validate-fuzz.test.ts test/pades-lexer-loop.test.ts test/seal.test.ts test/seal-grant.test.ts",
53
53
  "test:contract": "npm run build && node --experimental-strip-types test/contract.test.ts",
54
54
  "lint": "tsc --noEmit && tsc --noEmit -p tsconfig.button.json",
55
55
  "golden:check": "node scripts/sync-pades-golden.mjs --check",