@modusensus/dsh-mneme 0.8.14 → 0.8.16

package/test/helpers/runtime-source.js

@@ -1,60 +1,60 @@
-// test/helpers/runtime-source.js
-// 共享的「可收编源」夹具：CLI（scripts/mneme-runtime.mjs 的 adopt）与面板服务层
-// （src/runtime/adopt-service.js）两处的测试要造同一棵树。放这里是为了不让两份漂移 ——
-// 尤其是闭包必须能解出 onnxruntime-node / sharp，否则测的就不是「收编」这件事了。
-
-import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-/** 结构检查点名到「平台 + 架构」，所以夹具必须用本机平台，否则 CI 上必挂。 */
-function writeNativeDir(nm) {
-  mkdirSync(join(nm, "onnxruntime-node", "bin", "napi-v6", process.platform, process.arch), { recursive: true });
-}
-
-/**
- * 造一个最小可收编的 `<tmp>/node_modules`。
- *
- * transformers 必须把 onnxruntime-node / sharp 声明成自己的依赖，闭包计划才会收它们；
- * 否则 payload 里不会有这两个包，结构检查会因为「缺必需包」失败，测的就不是收编了。
- *
- * `withMissingDep: true` 时再声明一个装不上的必需依赖：planClosure 会记一条 gap，
- * 而 describePayload 只看那三个必需包 —— 这正是「结构说通过、闭包其实缺件」的场景。
- * @param {{withMissingDep?: boolean}} [opts] - 选项。
- * @returns {{base: string, nm: string, runtimeDir: string}} 临时根、源 node_modules、空白目标目录。
- */
-export function makeSourceModules({ withMissingDep = false } = {}) {
-  const base = mkdtempSync(join(tmpdir(), "mneme-src-"));
-  const nm = join(base, "node_modules");
-  const write = (rel, body) => {
-    const full = join(nm, rel);
-    mkdirSync(join(full, ".."), { recursive: true });
-    writeFileSync(full, body);
-  };
-  const dependencies = {
-    "onnxruntime-node": "^1.24.3",
-    sharp: "^0.34.5",
-    ...(withMissingDep ? { "definitely-not-installed-pkg": "^1.0.0" } : {})
-  };
-  write(
-    "@huggingface/transformers/package.json",
-    JSON.stringify({ name: "@huggingface/transformers", version: "4.2.0", dependencies })
-  );
-  write("@huggingface/transformers/dist/transformers.node.mjs", "export const x = 1;\n");
-  write("onnxruntime-node/package.json", JSON.stringify({ name: "onnxruntime-node", version: "1.24.3" }));
-  write("sharp/package.json", JSON.stringify({ name: "sharp", version: "0.34.5" }));
-  writeNativeDir(nm);
-  return { base, nm, runtimeDir: mkdtempSync(join(tmpdir(), "mneme-dst-")) };
-}
-
-/**
- * 空源：连 transformers 都没有。这是「profile 里根本没装」或 `--from` 指错目录时的真实输入，
- * 也是曾经抛 TypeError 的那条路径。
- * @returns {{base: string, nm: string, runtimeDir: string}}
- */
-export function makeEmptyModules() {
-  const base = mkdtempSync(join(tmpdir(), "mneme-empty-"));
-  const nm = join(base, "node_modules");
-  mkdirSync(nm, { recursive: true });
-  return { base, nm, runtimeDir: mkdtempSync(join(tmpdir(), "mneme-dst-")) };
-}
+// test/helpers/runtime-source.js
+// 共享的「可收编源」夹具：CLI（scripts/mneme-runtime.mjs 的 adopt）与面板服务层
+// （src/runtime/adopt-service.js）两处的测试要造同一棵树。放这里是为了不让两份漂移 ——
+// 尤其是闭包必须能解出 onnxruntime-node / sharp，否则测的就不是「收编」这件事了。
+
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+/** 结构检查点名到「平台 + 架构」，所以夹具必须用本机平台，否则 CI 上必挂。 */
+function writeNativeDir(nm) {
+  mkdirSync(join(nm, "onnxruntime-node", "bin", "napi-v6", process.platform, process.arch), { recursive: true });
+}
+
+/**
+ * 造一个最小可收编的 `<tmp>/node_modules`。
+ *
+ * transformers 必须把 onnxruntime-node / sharp 声明成自己的依赖，闭包计划才会收它们；
+ * 否则 payload 里不会有这两个包，结构检查会因为「缺必需包」失败，测的就不是收编了。
+ *
+ * `withMissingDep: true` 时再声明一个装不上的必需依赖：planClosure 会记一条 gap，
+ * 而 describePayload 只看那三个必需包 —— 这正是「结构说通过、闭包其实缺件」的场景。
+ * @param {{withMissingDep?: boolean}} [opts] - 选项。
+ * @returns {{base: string, nm: string, runtimeDir: string}} 临时根、源 node_modules、空白目标目录。
+ */
+export function makeSourceModules({ withMissingDep = false } = {}) {
+  const base = mkdtempSync(join(tmpdir(), "mneme-src-"));
+  const nm = join(base, "node_modules");
+  const write = (rel, body) => {
+    const full = join(nm, rel);
+    mkdirSync(join(full, ".."), { recursive: true });
+    writeFileSync(full, body);
+  };
+  const dependencies = {
+    "onnxruntime-node": "^1.24.3",
+    sharp: "^0.34.5",
+    ...(withMissingDep ? { "definitely-not-installed-pkg": "^1.0.0" } : {})
+  };
+  write(
+    "@huggingface/transformers/package.json",
+    JSON.stringify({ name: "@huggingface/transformers", version: "4.2.0", dependencies })
+  );
+  write("@huggingface/transformers/dist/transformers.node.mjs", "export const x = 1;\n");
+  write("onnxruntime-node/package.json", JSON.stringify({ name: "onnxruntime-node", version: "1.24.3" }));
+  write("sharp/package.json", JSON.stringify({ name: "sharp", version: "0.34.5" }));
+  writeNativeDir(nm);
+  return { base, nm, runtimeDir: mkdtempSync(join(tmpdir(), "mneme-dst-")) };
+}
+
+/**
+ * 空源：连 transformers 都没有。这是「profile 里根本没装」或 `--from` 指错目录时的真实输入，
+ * 也是曾经抛 TypeError 的那条路径。
+ * @returns {{base: string, nm: string, runtimeDir: string}}
+ */
+export function makeEmptyModules() {
+  const base = mkdtempSync(join(tmpdir(), "mneme-empty-"));
+  const nm = join(base, "node_modules");
+  mkdirSync(nm, { recursive: true });
+  return { base, nm, runtimeDir: mkdtempSync(join(tmpdir(), "mneme-dst-")) };
+}

package/test/helpers/tar-builder.js

@@ -1,80 +1,80 @@
-// test/helpers/tar-builder.js
-// 共享的 tar 造件器：tarball 读取层与取件层的测试都要造归档，放这里免得两份漂移。
-// 只造真东西（POSIX ustar 布局 + 正确的校验和），不引 tar 库 —— 那正是被测代码要回避的依赖。
-
-import { gzipSync } from "node:zlib";
-
-/** 一个 ustar 头块；字段布局照 POSIX，校验和按规范先按空格算再写回。 */
-export function tarHeader({ name = "", prefix = "", size = 0, type = "0" }) {
-  const header = Buffer.alloc(512);
-  header.write(name, 0, 100, "utf8");
-  header.write("0000644\0", 100, 8, "utf8");
-  header.write("0000000\0", 108, 8, "utf8");
-  header.write("0000000\0", 116, 8, "utf8");
-  header.write(`${size.toString(8).padStart(11, "0")}\0`, 124, 12, "utf8");
-  header.write("00000000000\0", 136, 12, "utf8");
-  header.write("        ", 148, 8, "utf8");
-  header.write(type, 156, 1, "utf8");
-  header.write("ustar\0", 257, 6, "utf8");
-  header.write("00", 263, 2, "utf8");
-  header.write(prefix, 345, 155, "utf8");
-  let sum = 0;
-  for (const byte of header) sum += byte;
-  header.write(`${sum.toString(8).padStart(6, "0")}\0 `, 148, 8, "utf8");
-  return header;
-}
-
-/** 普通文件条目（数据按 512 对齐补齐）。 */
-export function tarFile(name, body, { prefix = "" } = {}) {
-  const data = Buffer.from(body, "utf8");
-  const padded = Buffer.alloc(Math.ceil(data.length / 512) * 512);
-  data.copy(padded);
-  return [tarHeader({ name, prefix, size: data.length, type: "0" }), padded];
-}
-
-/** 目录（"5"）/ 符号链接（"2"）等无数据条目。 */
-export function tarMeta(name, type) {
-  return [tarHeader({ name, size: 0, type })];
-}
-
-/** pax 扩展头：载荷是 `长度 path=值\n`。 */
-export function tarPax(path) {
-  const record = Buffer.from(`path=${path}\n`, "utf8");
-  const line = `${record.length + String(record.length).length} path=${path}\n`;
-  return [tarHeader({ name: "PaxHeaders/x", size: Buffer.byteLength(line), type: "x" }), padTo512(Buffer.from(line, "utf8"))];
-}
-
-/** 补齐到 512 的整数倍。 */
-export function padTo512(buffer) {
-  if (buffer.length % 512 === 0) return buffer;
-  const padded = Buffer.alloc(Math.ceil(buffer.length / 512) * 512);
-  buffer.copy(padded);
-  return padded;
-}
-
-/** 两个全零块 = 归档结束。 */
-export const END_BLOCKS = [Buffer.alloc(512), Buffer.alloc(512)];
-
-/**
- * 造一份 .tgz。`entries` 每项：
- *   { path, body }       普通文件（自动加 `package/` 前缀，除非 path 已含它）
- *   { path, type }       目录/符号链接等（type 是 ustar 的 typeflag 字符）
- *   { paxPath }          pax 头，覆盖下一条目的路径
- * @param {Array<object>} entries - 条目。
- * @param {{prefix?: string|null, end?: boolean}} [opts] - 前缀（默认 package/）、是否追加结束块。
- * @returns {Buffer} gzip 后的归档。
- */
-export function makeTgz(entries, { prefix = "package/", end = true } = {}) {
-  const blocks = [];
-  for (const entry of entries) {
-    if (entry.paxPath !== undefined) {
-      blocks.push(...tarPax(prefix === null ? entry.paxPath : `${prefix}${entry.paxPath}`));
-      continue;
-    }
-    const path = prefix === null || entry.path.startsWith(prefix) ? entry.path : `${prefix}${entry.path}`;
-    if (entry.type !== undefined) blocks.push(...tarMeta(path, entry.type));
-    else blocks.push(...tarFile(path, entry.body ?? ""));
-  }
-  if (end) blocks.push(...END_BLOCKS);
-  return gzipSync(Buffer.concat(blocks));
-}
+// test/helpers/tar-builder.js
+// 共享的 tar 造件器：tarball 读取层与取件层的测试都要造归档，放这里免得两份漂移。
+// 只造真东西（POSIX ustar 布局 + 正确的校验和），不引 tar 库 —— 那正是被测代码要回避的依赖。
+
+import { gzipSync } from "node:zlib";
+
+/** 一个 ustar 头块；字段布局照 POSIX，校验和按规范先按空格算再写回。 */
+export function tarHeader({ name = "", prefix = "", size = 0, type = "0" }) {
+  const header = Buffer.alloc(512);
+  header.write(name, 0, 100, "utf8");
+  header.write("0000644\0", 100, 8, "utf8");
+  header.write("0000000\0", 108, 8, "utf8");
+  header.write("0000000\0", 116, 8, "utf8");
+  header.write(`${size.toString(8).padStart(11, "0")}\0`, 124, 12, "utf8");
+  header.write("00000000000\0", 136, 12, "utf8");
+  header.write("        ", 148, 8, "utf8");
+  header.write(type, 156, 1, "utf8");
+  header.write("ustar\0", 257, 6, "utf8");
+  header.write("00", 263, 2, "utf8");
+  header.write(prefix, 345, 155, "utf8");
+  let sum = 0;
+  for (const byte of header) sum += byte;
+  header.write(`${sum.toString(8).padStart(6, "0")}\0 `, 148, 8, "utf8");
+  return header;
+}
+
+/** 普通文件条目（数据按 512 对齐补齐）。 */
+export function tarFile(name, body, { prefix = "" } = {}) {
+  const data = Buffer.from(body, "utf8");
+  const padded = Buffer.alloc(Math.ceil(data.length / 512) * 512);
+  data.copy(padded);
+  return [tarHeader({ name, prefix, size: data.length, type: "0" }), padded];
+}
+
+/** 目录（"5"）/ 符号链接（"2"）等无数据条目。 */
+export function tarMeta(name, type) {
+  return [tarHeader({ name, size: 0, type })];
+}
+
+/** pax 扩展头：载荷是 `长度 path=值\n`。 */
+export function tarPax(path) {
+  const record = Buffer.from(`path=${path}\n`, "utf8");
+  const line = `${record.length + String(record.length).length} path=${path}\n`;
+  return [tarHeader({ name: "PaxHeaders/x", size: Buffer.byteLength(line), type: "x" }), padTo512(Buffer.from(line, "utf8"))];
+}
+
+/** 补齐到 512 的整数倍。 */
+export function padTo512(buffer) {
+  if (buffer.length % 512 === 0) return buffer;
+  const padded = Buffer.alloc(Math.ceil(buffer.length / 512) * 512);
+  buffer.copy(padded);
+  return padded;
+}
+
+/** 两个全零块 = 归档结束。 */
+export const END_BLOCKS = [Buffer.alloc(512), Buffer.alloc(512)];
+
+/**
+ * 造一份 .tgz。`entries` 每项：
+ *   { path, body }       普通文件（自动加 `package/` 前缀，除非 path 已含它）
+ *   { path, type }       目录/符号链接等（type 是 ustar 的 typeflag 字符）
+ *   { paxPath }          pax 头，覆盖下一条目的路径
+ * @param {Array<object>} entries - 条目。
+ * @param {{prefix?: string|null, end?: boolean}} [opts] - 前缀（默认 package/）、是否追加结束块。
+ * @returns {Buffer} gzip 后的归档。
+ */
+export function makeTgz(entries, { prefix = "package/", end = true } = {}) {
+  const blocks = [];
+  for (const entry of entries) {
+    if (entry.paxPath !== undefined) {
+      blocks.push(...tarPax(prefix === null ? entry.paxPath : `${prefix}${entry.paxPath}`));
+      continue;
+    }
+    const path = prefix === null || entry.path.startsWith(prefix) ? entry.path : `${prefix}${entry.path}`;
+    if (entry.type !== undefined) blocks.push(...tarMeta(path, entry.type));
+    else blocks.push(...tarFile(path, entry.body ?? ""));
+  }
+  if (end) blocks.push(...END_BLOCKS);
+  return gzipSync(Buffer.concat(blocks));
+}