fmode-app/scripts/copy-pdf-worker.mjs

#!/usr/bin/env node
/**
 * 把 pdf.js 的 worker 复制到 public/。
 *
 * ## 为什么要这一步
 *
 * pdf.js 需要 worker 文件从**同源**加载（`/pdf.worker.js`），
 * 但它只有新版 `.min.mjs`，而开发服务器对 `public/` 下的 `.mjs` 不解析，
 * 因此复制成 `.js`。
 *
 * ## 为什么不进 git
 *
 * 1.3 MB 的构建产物，随 pdfjs 版本变化，没理由占仓库空间。
 * 由 `postinstall` 自动生成，克隆后 `npm install` 即得。
 */
import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';

const here = dirname(fileURLToPath(import.meta.url));
const root = resolve(here, '..');
const src = resolve(root, 'node_modules/pdfjs-dist/build/pdf.worker.min.mjs');
const dest = resolve(root, 'public/pdf.worker.js');

if (!existsSync(src)) {
  // 未安装 pdfjs-dist（如只装了部分依赖）时静默跳过，不阻塞 npm install
  console.log('[copy-pdf-worker] 跳过：未找到 pdfjs-dist');
  process.exit(0);
}

mkdirSync(dirname(dest), { recursive: true });
copyFileSync(src, dest);

/*
 * 🔴 复制后**必须校验**（2026-11-15 真机事故后新增）
 *
 * ## 为什么
 *
 * 这个坑已经踩了**两次**：
 *   ① 2026-11-13：降级 pdfjs 后没重跑本脚本 → 线上是 6.4 的 worker
 *   ② 2026-11-15：同样的事又从真机 App 上冒出来 ——
 *      主包 4.10.38，而 APK 里的 worker 是旧版 6.4.299（1,264,342 字节，
 *      正确值应为 1,375,838），pdfjs 的 fake-worker fallback 失败后
 *      `getDocument().promise` **既不 resolve 也不 reject**，
 *      用户看到的是「一直转圈，永远加载不出来」。
 *
 * ## 本脚本只在 postinstall 跑
 *
 * 而 `npm run build` / `npx cap sync` 不会重跑它，只是把 public/ 下的
 * **旧文件**一路拷进 APK。所以「文件存在但内容过期」是常态而非意外。
 *
 * 现在：复制完立刻比对大小，不一致就报错退出，把问题挡在构建期，
 * 而不是等用户装完 App 发现打不开 PDF。
 */
const srcSize = statSync(src).size;
const destSize = statSync(dest).size;
if (srcSize !== destSize) {
  console.error(
    `[copy-pdf-worker] 🔴 复制结果不一致：src=${srcSize} dest=${destSize}\n` +
      `  这会导致 pdfjs 主包与 worker 版本不匹配，PDF 永远转圈。`,
  );
  process.exit(1);
}
console.log(`[copy-pdf-worker] 已生成 public/pdf.worker.js（${destSize} 字节，已校验）`);

/*
 * 同时生成 pdfjs 版本常量（2026-11-13）。
 *
 * ## 为什么需要
 *
 * `pdf-preview.ts` 用版本号做 worker 的缓存键。之前是手写常量，
 * pdfjs 从 6.4 降到 4.10 时忘了改 → 浏览器命中缓存的旧 worker
 * → 主包与 worker 版本不匹配 → PDF 永远卡在「正在加载」。
 *
 * 现在由本脚本把 `node_modules/pdfjs-dist/package.json` 的 version 写进源码，
 * 依赖一变缓存键就变，不可能再忘。
 */
const versionFile = resolve(root, 'src/app/components/preview/pdf-preview/pdfjs-version.generated.ts');
const pkgPath = resolve(root, 'node_modules/pdfjs-dist/package.json');
if (existsSync(pkgPath)) {
  const { version } = JSON.parse(readFileSync(pkgPath, 'utf8'));
  writeFileSync(
    versionFile,
    `/* 由 scripts/copy-pdf-worker.mjs 自动生成，请勿手改。 */\n` +
      `export const PDFJS_VERSION = '${version}';\n`,
    'utf8',
  );
  console.log(`[copy-pdf-worker] 已生成 pdfjs 版本常量：${version}`);
}