@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 +9 -4
- package/bin/convert-assets.mjs +55 -3
- package/bin/eid-convert.worker.js +17 -2
- package/dist/convert.d.ts +5 -0
- package/dist/convert.js +12 -3
- package/package.json +1 -1
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
|
|
657
|
-
> `
|
|
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 | `
|
|
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`).
|
package/bin/convert-assets.mjs
CHANGED
|
@@ -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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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" + (
|
|
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.
|
|
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",
|