@gerege-systems/eid-mongolia-sdk 0.18.1 → 0.18.2

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
@@ -618,7 +618,7 @@ if (isWordFile(file)) {
618
618
 
619
619
  | Функц | Тайлбар |
620
620
  |---|---|
621
- | `wordToPdf(file, { assetsBase, onProgress?, signal?, fileName? })` | `{ pdf, pages, warnings }`. Нэг worker-ийг дахин ашиглана, дуудлагууд дараалалд |
621
+ | `wordToPdf(file, { assetsBase, onProgress?, signal?, fileName?, verbose? })` | `{ pdf, pages, warnings }`. Нэг worker-ийг дахин ашиглана, дуудлагууд дараалалд. `verbose: true` — LibreOffice-ийн оношилгооны лог консолд (анхдагч чимээгүй; утга солигдвол worker дахин асна) |
622
622
  | `converterStatus({ assetsBase })` | `{ cached, downloadBytes }` — татахаас өмнө хэмжээг хэлэх (gzip хэмжээ, кэштэй бол 0) |
623
623
  | `isWordFile(file \| name)` | .docx / .doc эсэх (нэр, MIME). Агуулгыг `wordToPdf` эхний байтаар шалгана |
624
624
  | `disposeConverter()` | worker-ийг зогсоож санах ойг чөлөөлнө (кэш үлдэнэ) |
@@ -634,6 +634,11 @@ if (isWordFile(file)) {
634
634
  - Worker-ийн скриптүүдэд (`<assetsBase><хувилбар>/*.js`) **тусдаа CSP**: `default-src 'self'; script-src 'self'
635
635
  'wasm-unsafe-eval' 'unsafe-eval'` (Emscripten-д `eval` хэрэгтэй — зөвхөн worker-т). Хуудасны хатуу CSP (nonce +
636
636
  `'strict-dynamic'`) хэвээр байна; хуудсанд `connect-src 'self'` хангалттай.
637
+ - Консол: LibreOffice хувиргалт бүрд «warn:vcl…», «[LOK C++] …» гэх мэт оношилгооны мөр (алдаа биш) хэвлэдэг.
638
+ `eid-mongolia-convert-assets` (≥ 0.18.2) upstream worker-ийг (`@matbee/libreoffice-converter@2.7.2`-ийн sha256-аар
639
+ баталгаажсан үед л) patch хийж эдгээрийг `verbose: true`-гүй бол гаргахгүй; `manifest.json`-д `"patched": true`. Hash
640
+ таарахгүй бол patch-гүй хуулж анхааруулна — хувиргалт ажиллана, лог л гарна. SDK шинэчилсний дараа asset-ийг дахин
641
+ хуул (`rev` солигдож worker-ийн immutable кэш шинэчлэгдэнэ; soffice.wasm/.data дахин татагдахгүй).
637
642
  - MPL-2.0: `<хувилбар>/NOTICE.txt` (эх код, лицензийн холбоос) asset-уудтай хамт үйлчилгээнд байна — хэрэглэгчийн
638
643
  нүүрэнд (тусламж/лиценз хэсэгт) LibreOffice-ийг дурд.
639
644
 
@@ -653,8 +658,8 @@ Calibri / Cambria / Courier New-ийн Liberation / Carlito / Caladea орлуу
653
658
  Гарын үсэг зурсан PDF-ээ дараагийн гарын үсэг зурагч / хүлээн авагч руу хавсралтаар илгээнэ (`POST /share`). CA файлыг
654
659
  **хадгалахгүй**: eID-ийн хүчинтэй гарын үсэгтэй эсэхийг шалгаад илгээж, хаяна. Хүлээн авагч бүрт тусдаа имэйл.
655
660
 
656
- > CA-ийн туг одоогоор **унтраалттай** (`share.enabled=false` → 503 `SHARE_DISABLED`). Дуудахын өмнө
657
- > `await eid.shareInfo()`-ийн `enabled`-ийг шалга.
661
+ > CA дээр үргэлж асаалттай (2026-10-16-наас туг байхгүй). Хязгаар, квотыг `await eid.shareInfo()`-ээс уншина;
662
+ > `enabled` false бол имэйлийн үйлчилгээ түр тохируулагдаагүй (503).
658
663
 
659
664
  ```ts
660
665
  import { ShareError } from "@gerege-systems/eid-mongolia-sdk";
@@ -688,7 +693,7 @@ if (info.enabled) {
688
693
  | 422 | `FILE_NOT_SIGNED` | `.reason`: `no_signature` \| `invalid` \| `untrusted` |
689
694
  | 429 | `RATE_LIMITED` | квот; `.retryAfterMs`, `.retryable` |
690
695
  | 502 | `MAIL_FAILED` | `.sent`, `.failed`, `.recipients` — зөвхөн `failed`-ийг дахин илгээ |
691
- | 503 | `SHARE_DISABLED`, `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` | туг / тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
696
+ | 503 | `MAIL_UNAVAILABLE`, `VALIDATOR_UNAVAILABLE`, `VALIDATOR_BUSY` (`SHARE_DISABLED` — хуучин CA) | тохиргоо / ачаалал (`VALIDATOR_*` — Retry-After) |
692
697
 
693
698
  401 → `AuthenticationError`, 403 (SIGN эрхгүй, IP/mTLS) → `ForbiddenError`. Квот: RP тутам цагт 30 / өдөрт 200 хүсэлт,
694
699
  хүлээн авагч тутам өдөрт 10 имэйл (бодит утгыг `shareInfo().quota`-аас). Хугацаа анхдагч 150 с (`timeoutMs`).
@@ -7,7 +7,13 @@
7
7
  // <хавтас>/<хувилбар>/eid-convert.worker.js, browser.worker.global.js
8
8
  // <хавтас>/<хувилбар>/LICENSE-MPL-2.0.txt, NOTICE.txt
9
9
  //
10
+ // browser.worker.global.js-ийг (зөвхөн sha256 нь QUIET_PATCH-тай таарвал) чимээгүй болгоно: upstream LibreOffice-ийн
11
+ // stdout/stderr-ийг (print/printErr) үргэлж console.log/console.error руу илгээдэг — хувиргалт бүрд ~28 улаан мөр
12
+ // («warn:vcl…», «[LOK C++] …»). Patch-ийн дараа зөвхөн `wordToPdf({ verbose: true })` үед (worker `?verbose=1`).
13
+ // Hash таарахгүй бол patch-гүй хуулж анхааруулна (build унахгүй) — хувиргалт ажиллана, лог л гарна.
14
+ //
10
15
  // `wordToPdf({ assetsBase: "<URL>/" })` нь <хавтас>-ын URL-ийг авна. Хуучин хувилбарын дэд хавтсыг устгана.
16
+ import { createHash } from "node:crypto";
11
17
  import { createRequire } from "node:module";
12
18
  import { createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, rmSync, statSync, copyFileSync, writeFileSync, readFileSync } from "node:fs";
13
19
  import { join, dirname } from "node:path";
@@ -58,7 +64,44 @@ async function gzipSize(path) {
58
64
  return n;
59
65
  }
60
66
 
67
+ const sha256 = (buf) => createHash("sha256").update(buf).digest("hex");
68
+
69
+ /** Мэдэгдэж буй upstream файл → яг нэг удаа таарах ёстой солилтууд. */
70
+ const QUIET_PATCH = {
71
+ file: "browser.worker.global.js",
72
+ // @matbee/libreoffice-converter@2.7.2 dist/browser.worker.global.js
73
+ sha256: "9401aff2213772d7114fe417e3f34eb359905ae3a4e94a735644d926d593e276",
74
+ replace: [
75
+ ["print:console.log,printErr:console.error}", "print:self.EID_CONVERT_VERBOSE?console.log:()=>{},printErr:self.EID_CONVERT_VERBOSE?console.error:()=>{}}"],
76
+ // Энд (runtime асасны дараа) ENV-д бичих нь LibreOffice-д хүрдэггүй — үйлчлэх утга нь soffice.js-ийн preRun "+WARN"
77
+ // (2026-10-16 Chromium-д хэмжсэн: "-WARN-INFO"-тэй ч «warn:» мөрүүд хэвээр). Консол руу гарахыг printErr зогсооно;
78
+ // "+ALL"-ийг зөвхөн upstream дахин уншдаг болбол бүх лог асахгүйн тулд солино.
79
+ ['a.ENV.SAL_LOG="+ALL"', 'a.ENV.SAL_LOG="-WARN-INFO"'],
80
+ ['console.log("[Worker] Set SAL_LOG to +ALL")', 'console.log("[Worker] Set SAL_LOG to "+a.ENV.SAL_LOG)'],
81
+ ],
82
+ };
83
+
84
+ /** Patch хийсэн агуулга эсвэл null (hash / солилт таарахгүй — шалтгааныг хэвлэнэ). */
85
+ function quiet(buf) {
86
+ const got = sha256(buf);
87
+ if (got !== QUIET_PATCH.sha256) {
88
+ console.warn(`анхааруулга: ${PKG}/dist/${QUIET_PATCH.file} sha256 ${got} — мэдэгдэж буй ${QUIET_PATCH.sha256} биш; лог чимээгүй болгох patch-гүй хуулав (хувиргалт ажиллана, консолд LibreOffice-ийн лог гарна)`);
89
+ return null;
90
+ }
91
+ let s = buf.toString("utf8");
92
+ for (const [from, to] of QUIET_PATCH.replace) {
93
+ if (s.split(from).length !== 2) {
94
+ console.warn(`анхааруулга: ${QUIET_PATCH.file}-д «${from}» яг нэг удаа олдсонгүй — patch-гүй хуулав`);
95
+ return null;
96
+ }
97
+ s = s.replace(from, () => to);
98
+ }
99
+ return Buffer.from(s, "utf8");
100
+ }
101
+
61
102
  const files = {};
103
+ let patched = false;
104
+ const rev = createHash("sha256");
62
105
  for (const [name, rel] of Object.entries(FILES)) {
63
106
  const from = rel === null ? new URL(name, import.meta.url).pathname : join(src, rel);
64
107
  if (!existsSync(from)) {
@@ -66,7 +109,16 @@ for (const [name, rel] of Object.entries(FILES)) {
66
109
  process.exit(1);
67
110
  }
68
111
  const to = join(out, dir, name);
69
- copyFileSync(from, to);
112
+ if (name === QUIET_PATCH.file) {
113
+ const buf = readFileSync(from);
114
+ const q = quiet(buf);
115
+ patched = q !== null;
116
+ writeFileSync(to, q ?? buf);
117
+ } else {
118
+ copyFileSync(from, to);
119
+ }
120
+ // Worker-ийн скриптүүд `<хувилбар>/` дор immutable кэштэй — агуулга солигдвол (patch, SDK шинэчлэл) rev-ээр URL солино.
121
+ if (name.endsWith(".js")) rev.update(name).update("\0").update(readFileSync(to));
70
122
  files[name] = { bytes: statSync(to).size, gzip: await gzipSize(to) };
71
123
  }
72
124
  // MPL-2.0 §3.2: эх кодын байршил ба лиценз дагалдана.
@@ -74,6 +126,6 @@ writeFileSync(join(out, dir, "NOTICE.txt"),
74
126
  `${PKG}@${version} (${license}) — LibreOffice WebAssembly build.\n` +
75
127
  `Source: https://github.com/matbeedotcom/libreoffice-document-converter (tag v${version}); LibreOffice: https://www.libreoffice.org/about-us/source-code/\n` +
76
128
  `License text: https://www.mozilla.org/MPL/2.0/\n`);
77
- writeFileSync(join(out, "manifest.json"), JSON.stringify({ format: 1, converter: PKG, version, dir, files }, null, 2) + "\n");
129
+ writeFileSync(join(out, "manifest.json"), JSON.stringify({ format: 1, converter: PKG, version, dir, rev: rev.digest("hex").slice(0, 16), patched, files }, null, 2) + "\n");
78
130
  const sum = (k) => Object.values(files).reduce((s, f) => s + f[k], 0);
79
- console.log(`${PKG}@${version} → ${join(out, dir)} (${(sum("bytes") / 1e6).toFixed(1)} MB, gzip ${(sum("gzip") / 1e6).toFixed(1)} MB)`);
131
+ console.log(`${PKG}@${version} → ${join(out, dir)} (${(sum("bytes") / 1e6).toFixed(1)} MB, gzip ${(sum("gzip") / 1e6).toFixed(1)} MB)${patched ? ", лог чимээгүй (patch)" : ""}`);
@@ -1,8 +1,20 @@
1
1
  // @gerege-systems/eid-mongolia-sdk/convert — хувиргагчийн worker. `?cache=<нэр>` бол soffice.wasm / soffice.data-г
2
2
  // SDK-ийн урьдчилж татсан Cache Storage-аас өгнө (дахин татахгүй, blob URL-гүй); олдохгүй бол ердийн fetch.
3
+ // `?verbose=1` үгүй бол хувиргагчийн оношилгооны лог (console.log/info/debug, LibreOffice-ийн stdout/stderr) консолд
4
+ // гарахгүй — `wordToPdf({ verbose: true })`. `?v=<rev>` — manifest-ийн rev (immutable кэшийг шинэчлэх).
3
5
  // Дараа нь @matbee/libreoffice-converter-ийн worker-ийг ачаална. CSP: script-src 'self' 'wasm-unsafe-eval' 'unsafe-eval'.
4
6
  (function () {
5
- var name = new URL(self.location.href).searchParams.get("cache");
7
+ var q = new URL(self.location.href).searchParams;
8
+ // browser.worker.global.js (eid-mongolia-convert-assets-ийн patch) print/printErr, SAL_LOG-ийг үүгээр сонгоно.
9
+ self.EID_CONVERT_VERBOSE = q.get("verbose") === "1";
10
+ if (!self.EID_CONVERT_VERBOSE) {
11
+ var off = function () {};
12
+ // console.error/warn үлдэнэ (жинхэнэ алдаа); upstream-ийн «[Worker] …», «[FS OPEN CALL] …» нь console.log.
13
+ self.console.log = off;
14
+ self.console.info = off;
15
+ self.console.debug = off;
16
+ }
17
+ var name = q.get("cache");
6
18
  if (!name || typeof caches === "undefined") return;
7
19
  var orig = self.fetch.bind(self);
8
20
  self.fetch = function (input, init) {
@@ -15,4 +27,7 @@
15
27
  .then(function (hit) { return hit || orig(input, init); });
16
28
  };
17
29
  })();
18
- importScripts("browser.worker.global.js");
30
+ (function () {
31
+ var v = new URL(self.location.href).searchParams.get("v");
32
+ importScripts("browser.worker.global.js" + (v ? "?v=" + encodeURIComponent(v) : ""));
33
+ })();
package/dist/convert.d.ts CHANGED
@@ -68,6 +68,11 @@ interface WordToPdfOptions {
68
68
  signal?: AbortSignal;
69
69
  /** Оролт `Uint8Array` бол өргөтгөл таних нэр (".docx" / ".doc"). `File` бол түүний нэр. */
70
70
  fileName?: string;
71
+ /**
72
+ * Хувиргагчийн (LibreOffice) оношилгооны логийг хөтчийн консолд гаргах — анхдагч false (чимээгүй). Worker асах үед
73
+ * үйлчилнэ: утга солигдвол worker дахин асна. Чимээгүй горим `eid-mongolia-convert-assets` ≥ 0.18.2-оор хуулсан asset шаардана.
74
+ */
75
+ verbose?: boolean;
71
76
  }
72
77
  interface WordToPdfResult {
73
78
  pdf: Uint8Array;
package/dist/convert.js CHANGED
@@ -1207,6 +1207,9 @@ function parseManifest(v) {
1207
1207
  if (!m || m.format !== 1 || m.converter !== CONVERTER_PACKAGE || typeof m.version !== "string" || typeof m.dir !== "string" || !/^(?!\.{1,2}\/$)[A-Za-z0-9._-]+\/$/.test(m.dir) || !m.files) {
1208
1208
  throw new ConvertError("ASSETS_UNAVAILABLE", "manifest.json \u0431\u0443\u0440\u0443\u0443 \u2014 `eid-mongolia-convert-assets`-\u044D\u044D\u0440 \u0434\u0430\u0445\u0438\u043D \u04AF\u04AF\u0441\u0433\u044D");
1209
1209
  }
1210
+ if (m.rev !== void 0 && (typeof m.rev !== "string" || !/^[0-9a-f]{8,64}$/.test(m.rev))) {
1211
+ throw new ConvertError("ASSETS_UNAVAILABLE", "manifest.json-\u0438\u0439\u043D rev \u0431\u0443\u0440\u0443\u0443");
1212
+ }
1210
1213
  for (const a of ASSETS) {
1211
1214
  const f = m.files[a];
1212
1215
  if (!f || !Number.isSafeInteger(f.bytes) || f.bytes <= 0) throw new ConvertError("ASSETS_UNAVAILABLE", `manifest.json-\u0434 ${a} \u0430\u043B\u0433\u0430`);
@@ -1342,7 +1345,8 @@ async function start(opts, signal) {
1342
1345
  const root = base(opts.assetsBase);
1343
1346
  const m = await loadManifest(root, signal);
1344
1347
  const key = root + m.dir;
1345
- if (live && live.key === key) return live;
1348
+ const verbose = opts.verbose === true;
1349
+ if (live && live.key === key && live.verbose === verbose) return live;
1346
1350
  if (live) kill(live);
1347
1351
  let mod;
1348
1352
  try {
@@ -1351,13 +1355,18 @@ async function start(opts, signal) {
1351
1355
  throw new ConvertError("ASSETS_UNAVAILABLE", `${CONVERTER_PACKAGE} \u0441\u0443\u0443\u0433\u0430\u0430\u0433\u04AF\u0439 (optional peerDependency)`, { cause: e });
1352
1356
  }
1353
1357
  const cache = await prefetch(root, m, opts.onProgress, signal);
1354
- const l = { key, conv: null, sink: null };
1358
+ const l = { key, verbose, conv: null, sink: null };
1359
+ const q = new URLSearchParams();
1360
+ if (cache) q.set("cache", cache);
1361
+ if (m.rev) q.set("v", m.rev);
1362
+ if (verbose) q.set("verbose", "1");
1355
1363
  l.conv = new mod.WorkerBrowserConverter({
1356
1364
  sofficeJs: key + "soffice.js",
1357
1365
  sofficeWasm: key + "soffice.wasm",
1358
1366
  sofficeData: key + "soffice.data",
1359
1367
  sofficeWorkerJs: key + "soffice.worker.js",
1360
- browserWorkerJs: key + "eid-convert.worker.js" + (cache ? "?cache=" + encodeURIComponent(cache) : ""),
1368
+ browserWorkerJs: key + "eid-convert.worker.js" + (q.toString() ? "?" + q.toString() : ""),
1369
+ verbose,
1361
1370
  onProgress: (p) => l.sink?.(p)
1362
1371
  });
1363
1372
  live = l;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gerege-systems/eid-mongolia-sdk",
3
- "version": "0.18.1",
3
+ "version": "0.18.2",
4
4
  "description": "e-ID Mongolia Relying Party SDK — иргэнээр утсаар нь нэвтрэлт ба хууль ёсны цахим гарын үсэг (RP-API v3, Smart-ID нийцтэй).",
5
5
  "license": "MIT",
6
6
  "type": "module",