@gerege-systems/eid-mongolia-sdk 0.29.2 → 0.30.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/README.md CHANGED
@@ -557,7 +557,7 @@ DSS-д), Adobe / EU DSS-д «LTV enabled», баталгаажуулах (QR) х
557
557
 
558
558
  | Функц | Хаана | Тайлбар |
559
559
  |---|---|---|
560
- | `prepare(pdf, { signerCert, claimedRole?, verifyPage?, fileName?, lang?, docId?, appearance?, … })` | браузер / Node | `{ dtbs, digest, docId, state, placement? }` — сүлжээгүй |
560
+ | `prepare(pdf, { signerCert, claimedRole?, verifyPage?, verifyPagePosition?, fileName?, lang?, docId?, appearance?, … })` | браузер / Node | `{ dtbs, digest, docId, state, placement? }` — сүлжээгүй |
561
561
  | `suggestPlacement(pdf, appearance)` | браузер / Node | гарын үсэггүйгээр тэмдгийн байршил + хуудасны хэмжээ (урьдчилан харах, 0.29.0+) — сүлжээгүй |
562
562
  | `eid.signPdfDigest({ dtbs, fileName, signer, flow?, onBehalfOf? })` | RP backend | DTBS-д гарын үсгийн session (push эсвэл device-link) |
563
563
  | `complete(state, signature)` | браузер / Node | TSA + OCSP/CRL → `{ pdf, cms, docId, outSha256, inSha256, hasPage, pageSha256, … }` |
@@ -674,6 +674,17 @@ const p = await prepare(pdfBytes, { signerCert, verifyPage: true, fileName: "Г
674
674
  appearance: { page, x, y, width: s.width, height: s.height, exact: true } });
675
675
  ```
676
676
 
677
+ **Баталгаажуулах хуудсыг эхэнд (0.30.0+).** `verifyPagePosition: "first"` — QR хуудас баримтын 1-р хуудас болно (анхдагч
678
+ `"last"` — төгсгөлд, өмнөхтэй байт-ижил; бусад утга `REQUEST_INVALID`). Хуудас нэмэгдэх үед л (гарын үсэггүй баримт,
679
+ `verifyPage: true`) нөлөөтэй. `appearance.page`, `suggestPlacement`, `placement.page` үргэлж **оролтын** PDF-ийн хуудсаар
680
+ тоологдоно — нэмэгдсэн хуудсыг тоолохгүй, тиймээс preview-ийн хуудасны дугаарыг шууд өгнө. Дүрэм: `PAGE_SPEC.md` §8a,
681
+ `PLACEMENT_SPEC.md` §1b.
682
+
683
+ ```ts
684
+ const p = await prepare(pdfBytes, { signerCert, verifyPage: true, verifyPagePosition: "first", fileName: "Гэрээ №12.pdf",
685
+ appearance: { page: 2, x: 340, y: 36, width: 220, height: 64, exact: true } }); // гаралтын 3-р хуудсан дээр
686
+ ```
687
+
677
688
  ### Зөвхөн Node (backend бүгдийг хийнэ)
678
689
 
679
690
  ```ts
@@ -1991,7 +1991,7 @@ function streamObj(extra, data) {
1991
1991
  stream
1992
1992
  `), data, latin1("\nendstream")]);
1993
1993
  }
1994
- function appendVerifyPage(base, p) {
1994
+ function appendVerifyPage(base, p, first = false) {
1995
1995
  const [reg, bld] = loadFonts();
1996
1996
  const { content, links } = pageContent(p);
1997
1997
  const inc = new Incremental(base);
@@ -2028,8 +2028,14 @@ function appendVerifyPage(base, p) {
2028
2028
  const kids = pages.key("Kids");
2029
2029
  const kp = kids.ptr;
2030
2030
  pn += " /Kids [";
2031
- for (let i = 0; i < kids.len(); i++) pn += serialize(kids.index(i), kp.id, 0) + " ";
2032
- pn += `${pageID} 0 R] /Count ${count + 1} >>`;
2031
+ if (first) {
2032
+ pn += `${pageID} 0 R`;
2033
+ for (let i = 0; i < kids.len(); i++) pn += " " + serialize(kids.index(i), kp.id, 0);
2034
+ pn += `] /Count ${count + 1} >>`;
2035
+ } else {
2036
+ for (let i = 0; i < kids.len(); i++) pn += serialize(kids.index(i), kp.id, 0) + " ";
2037
+ pn += `${pageID} 0 R] /Count ${count + 1} >>`;
2038
+ }
2033
2039
  inc.writeObject(pp.id, pn, pp.gen);
2034
2040
  return inc.finish(rp.id);
2035
2041
  }
package/dist/pades.cjs CHANGED
@@ -3250,7 +3250,7 @@ function streamObj(extra, data) {
3250
3250
  stream
3251
3251
  `), data, latin1("\nendstream")]);
3252
3252
  }
3253
- function appendVerifyPage(base, p) {
3253
+ function appendVerifyPage(base, p, first = false) {
3254
3254
  const [reg, bld] = loadFonts();
3255
3255
  const { content, links } = pageContent(p);
3256
3256
  const inc = new Incremental(base);
@@ -3287,8 +3287,14 @@ function appendVerifyPage(base, p) {
3287
3287
  const kids = pages.key("Kids");
3288
3288
  const kp = kids.ptr;
3289
3289
  pn += " /Kids [";
3290
- for (let i = 0; i < kids.len(); i++) pn += serialize(kids.index(i), kp.id, 0) + " ";
3291
- pn += `${pageID} 0 R] /Count ${count + 1} >>`;
3290
+ if (first) {
3291
+ pn += `${pageID} 0 R`;
3292
+ for (let i = 0; i < kids.len(); i++) pn += " " + serialize(kids.index(i), kp.id, 0);
3293
+ pn += `] /Count ${count + 1} >>`;
3294
+ } else {
3295
+ for (let i = 0; i < kids.len(); i++) pn += serialize(kids.index(i), kp.id, 0) + " ";
3296
+ pn += `${pageID} 0 R] /Count ${count + 1} >>`;
3297
+ }
3292
3298
  inc.writeObject(pp.id, pn, pp.gen);
3293
3299
  return inc.finish(rp.id);
3294
3300
  }
@@ -5185,6 +5191,11 @@ async function prepare(pdf, opts) {
5185
5191
  if (opts.lang !== void 0 && opts.lang !== "" && opts.lang !== "mn" && opts.lang !== "en") {
5186
5192
  throw new PadesError("REQUEST_INVALID", "lang: mn | en");
5187
5193
  }
5194
+ const pos = opts.verifyPagePosition;
5195
+ if (pos !== void 0 && pos !== "" && pos !== "last" && pos !== "first") {
5196
+ throw new PadesError("REQUEST_INVALID", "verifyPagePosition: last | first");
5197
+ }
5198
+ const first = pos === "first";
5188
5199
  checkAppearance(opts);
5189
5200
  const now = opts.signingTime ?? /* @__PURE__ */ new Date();
5190
5201
  if (Number.isNaN(now.getTime())) throw new PadesError("REQUEST_INVALID", "signingTime \u0431\u0443\u0440\u0443\u0443 Date");
@@ -5224,7 +5235,7 @@ async function prepare(pdf, opts) {
5224
5235
  tsaName: PAGE_TSA_NAME,
5225
5236
  provider: PAGE_PROVIDER,
5226
5237
  lang: opts.lang ?? ""
5227
- });
5238
+ }, first);
5228
5239
  } catch (e) {
5229
5240
  throw new PadesError("PDF_INVALID", "PDF \u0437\u0430\u0434\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439 (\u0445\u0443\u0443\u0434\u0430\u0441 \u043D\u044D\u043C\u0436 \u0447\u0430\u0434\u0441\u0430\u043D\u0433\u04AF\u0439)", { cause: e });
5230
5241
  }
@@ -5234,7 +5245,7 @@ async function prepare(pdf, opts) {
5234
5245
  const vis = opts.appearance ? visibleSpec(doc, opts, name, now, docId, pc.revIndex) : void 0;
5235
5246
  let prep;
5236
5247
  try {
5237
- prep = await prepareSignature(base, now, name, opts.reason ?? "", vis);
5248
+ prep = await prepareSignature(base, now, name, opts.reason ?? "", vis && hasPage && first ? { ...vis, page: vis.page + 1 } : vis);
5238
5249
  } catch (e) {
5239
5250
  if (e instanceof AppearanceError) throw new PadesError("REQUEST_INVALID", `appearance: ${e.message}`, { cause: e });
5240
5251
  throw new PadesError("PDF_INVALID", "PDF-\u0434 \u0433\u0430\u0440\u044B\u043D \u04AF\u0441\u0433\u0438\u0439\u043D revision \u0431\u0438\u0447\u0438\u0436 \u0447\u0430\u0434\u0441\u0430\u043D\u0433\u04AF\u0439", { cause: e });
package/dist/pades.d.cts CHANGED
@@ -46,6 +46,12 @@ interface PadesPrepareOptions {
46
46
  docId?: string;
47
47
  /** Баталгаажуулах (QR) хуудас нэмэх — зөвхөн гарын үсэггүй баримтын эхний гарын үсэгт. */
48
48
  verifyPage?: boolean;
49
+ /**
50
+ * Where the verify page goes when it is added (`verifyPage` on an unsigned document): `"last"` (default) or `"first"`
51
+ * (it becomes page 1). `appearance.page`, {@link suggestPlacement} and `placement.page` always count the pages of the
52
+ * input PDF as given — never the added page (PAGE_SPEC.md §8a, PLACEMENT_SPEC.md §1b). Other values → REQUEST_INVALID.
53
+ */
54
+ verifyPagePosition?: "last" | "first";
49
55
  /** Хуудасны хэл: `mn` (анхдагч) | `en`. */
50
56
  lang?: "mn" | "en";
51
57
  /** Баримтын нэр — `verifyPage` үед заавал (≤ 120 тэмдэгт). */
package/dist/pades.d.ts CHANGED
@@ -46,6 +46,12 @@ interface PadesPrepareOptions {
46
46
  docId?: string;
47
47
  /** Баталгаажуулах (QR) хуудас нэмэх — зөвхөн гарын үсэггүй баримтын эхний гарын үсэгт. */
48
48
  verifyPage?: boolean;
49
+ /**
50
+ * Where the verify page goes when it is added (`verifyPage` on an unsigned document): `"last"` (default) or `"first"`
51
+ * (it becomes page 1). `appearance.page`, {@link suggestPlacement} and `placement.page` always count the pages of the
52
+ * input PDF as given — never the added page (PAGE_SPEC.md §8a, PLACEMENT_SPEC.md §1b). Other values → REQUEST_INVALID.
53
+ */
54
+ verifyPagePosition?: "last" | "first";
49
55
  /** Хуудасны хэл: `mn` (анхдагч) | `en`. */
50
56
  lang?: "mn" | "en";
51
57
  /** Баримтын нэр — `verifyPage` үед заавал (≤ 120 тэмдэгт). */
package/dist/pades.js CHANGED
@@ -23,7 +23,7 @@ import {
23
23
  visibleRect,
24
24
  visibleWidget,
25
25
  zlibInflateStrict
26
- } from "./chunk-P65FCDR5.js";
26
+ } from "./chunk-73HYZNOY.js";
27
27
  import {
28
28
  CLAIMED_ROLE_MAX_RUNES,
29
29
  CertificateRevokedError,
@@ -1656,6 +1656,11 @@ async function prepare(pdf, opts) {
1656
1656
  if (opts.lang !== void 0 && opts.lang !== "" && opts.lang !== "mn" && opts.lang !== "en") {
1657
1657
  throw new PadesError("REQUEST_INVALID", "lang: mn | en");
1658
1658
  }
1659
+ const pos = opts.verifyPagePosition;
1660
+ if (pos !== void 0 && pos !== "" && pos !== "last" && pos !== "first") {
1661
+ throw new PadesError("REQUEST_INVALID", "verifyPagePosition: last | first");
1662
+ }
1663
+ const first = pos === "first";
1659
1664
  checkAppearance(opts);
1660
1665
  const now = opts.signingTime ?? /* @__PURE__ */ new Date();
1661
1666
  if (Number.isNaN(now.getTime())) throw new PadesError("REQUEST_INVALID", "signingTime \u0431\u0443\u0440\u0443\u0443 Date");
@@ -1695,7 +1700,7 @@ async function prepare(pdf, opts) {
1695
1700
  tsaName: PAGE_TSA_NAME,
1696
1701
  provider: PAGE_PROVIDER,
1697
1702
  lang: opts.lang ?? ""
1698
- });
1703
+ }, first);
1699
1704
  } catch (e) {
1700
1705
  throw new PadesError("PDF_INVALID", "PDF \u0437\u0430\u0434\u0430\u0440\u0441\u0430\u043D\u0433\u04AF\u0439 (\u0445\u0443\u0443\u0434\u0430\u0441 \u043D\u044D\u043C\u0436 \u0447\u0430\u0434\u0441\u0430\u043D\u0433\u04AF\u0439)", { cause: e });
1701
1706
  }
@@ -1705,7 +1710,7 @@ async function prepare(pdf, opts) {
1705
1710
  const vis = opts.appearance ? visibleSpec(doc, opts, name, now, docId, pc.revIndex) : void 0;
1706
1711
  let prep;
1707
1712
  try {
1708
- prep = await prepareSignature(base, now, name, opts.reason ?? "", vis);
1713
+ prep = await prepareSignature(base, now, name, opts.reason ?? "", vis && hasPage && first ? { ...vis, page: vis.page + 1 } : vis);
1709
1714
  } catch (e) {
1710
1715
  if (e instanceof AppearanceError) throw new PadesError("REQUEST_INVALID", `appearance: ${e.message}`, { cause: e });
1711
1716
  throw new PadesError("PDF_INVALID", "PDF-\u0434 \u0433\u0430\u0440\u044B\u043D \u04AF\u0441\u0433\u0438\u0439\u043D revision \u0431\u0438\u0447\u0438\u0436 \u0447\u0430\u0434\u0441\u0430\u043D\u0433\u04AF\u0439", { cause: e });
package/dist/validate.js CHANGED
@@ -11,7 +11,7 @@ import {
11
11
  isBrowser,
12
12
  round100,
13
13
  visibleWidget
14
- } from "./chunk-P65FCDR5.js";
14
+ } from "./chunk-73HYZNOY.js";
15
15
  import {
16
16
  EID_ISSUERS,
17
17
  INTERMEDIATES,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gerege-systems/eid-mongolia-sdk",
3
- "version": "0.29.2",
3
+ "version": "0.30.0",
4
4
  "description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
5
5
  "license": "MIT",
6
6
  "type": "module",