@easyrn/erpush-cli 0.0.1-alpha

package/src/exitsig.js

@@ -0,0 +1,96 @@
+/**
+ * 代码
+ * https://github.com/tapjs/signal-exit
+ * 
+ * The ISC License
+ * Copyright (c) 2015-2022 Benjamin Coe, Isaac Z. Schlueter, and Contributors
+ * 
+ * 为了降低与 ReactNative 依赖模块的版本冲突, 这里参照 signal-exit 写一个简易的监听函数
+ */
+const EE = require('events');
+const signals = [];
+const emitter = new EE();
+let processOk = isWin = processBound = null;
+
+function checkProcess(){
+  if (null === processOk) {
+    processOk = (process && typeof process === 'object' 
+      && typeof process.platform === 'string'
+      && typeof process.on === 'function'
+      && typeof process.kill === 'function'
+      && typeof process.removeListener === 'function');
+  }
+  return processOk;
+}
+
+function initSignals(){
+  if (signals.length) {
+    return;
+  }
+  signals.push('SIGINT', 'SIGHUP', 'SIGABRT', 'SIGALRM', 'SIGTERM');
+  if (process.platform !== 'win32') {
+    signals.push('SIGVTALRM', 'SIGXCPU', 'SIGXFSZ', 'SIGUSR2', 'SIGTRAP', 'SIGSYS', 'SIGQUIT', 'SIGIOT')
+  }
+  if (process.platform === 'linux') {
+    signals.push('SIGIO', 'SIGPOLL', 'SIGPWR', 'SIGSTKFLT', 'SIGUNUSED')
+  }
+}
+
+function bindListeners(){
+  if (processBound !== null) {
+    return;
+  }
+  if (null === isWin) {
+    isWin = /^win/i.test(process.platform);
+  }
+  processBound = {};
+  const bindOn = (ev, cb) => {
+    process.on(ev, cb)
+    processBound[ev] = cb
+  };
+  bindOn('exit', (code) => {
+    emitter.emit('exit', code, null);
+    unbindListeners();
+  });
+  initSignals();
+  signals.forEach(sig => {
+    try {
+      bindOn(sig, () => {
+        emitter.emit('exit', null, sig);
+        unbindListeners();
+        if (isWin && sig === 'SIGHUP') {
+          sig = 'SIGINT'
+        }
+        process.kill(process.pid, sig)
+      }) 
+    } catch {}
+  });
+}
+
+function unbindListeners(){
+  if (!processBound) {
+    return;
+  }
+  for (let ev in processBound) {
+    process.removeListener(ev, processBound[ev])
+  }
+  processBound = null;
+}
+
+function onProcessExit(cb){
+  if (!checkProcess()) {
+    return () => {};
+  }
+  bindListeners();
+  const ev = 'exit';
+  const remove = function () {
+    emitter.removeListener(ev, cb)
+    if (emitter.listeners('exit').length === 0) {
+      unbindListeners();
+    }
+  }
+  emitter.on(ev, cb)
+  return remove;
+}
+
+module.exports = onProcessExit;

package/src/pack.js

@@ -0,0 +1,325 @@
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const {execSync} = require("child_process");
+const {
+  CInfo, CError, errMsg, 
+  fileExist, ensureDirSync, emptyDirSync,
+  packIpa, packZip, getRNVersion, execCommand
+} = require('./utils');
+
+// Hermes 平台类型
+function getHermesOSBin() {
+  const plat = os.platform();
+  switch (plat) {
+    case 'win32':
+      return 'win64-bin';
+    case 'darwin':
+      return 'osx-bin';
+    case 'linux':
+      return 'linux64-bin';
+    default:
+      return null;
+  }
+}
+
+// 获取 Android gradle project.ext.react 配置
+function gradleConfig(cwd) {
+  const gradleStr = fs.readFileSync(path.join(cwd, 'android/app/build.gradle')).toString();
+  const match = gradleStr.replace(
+    /\/\*[\s\S]*?\*\/|\/\/.*/g, ''
+  ).match(
+    /project\.ext\.react\s*=\s*\[([^\]]*)\]/
+  );
+  return match ? match[1].split(',') : [];
+}
+
+// 确认是否启用了 Hermes 引擎
+function isHermesEnable(cwd, platform) {
+  try {
+    if ('android' === platform) {
+      return gradleConfig(cwd).some(
+        line => /\benableHermes\s*:\s*true/.test(line)
+      );
+    } else if (platform === 'ios') {
+      const podPath = path.join(cwd, 'ios', 'Podfile');
+      const podStr = fileExist(podPath) ? fs.readFileSync(podPath).toString() : null;
+      return podStr && /\n[^#]*:?\bhermes_enabled\s*(=>|:)\s*true/.test(podStr);
+    }
+  } catch (e) {}
+  return false;
+}
+
+// 获取自定义的 Hermes 引擎
+function getGradleHermes(cwd, platform) {
+  if (platform && platform !== 'android') {
+    return null;
+  }
+  let hermesCommand;
+  gradleConfig(cwd).some(line => {
+    const match = line.match(/\bhermesCommand\s*:\s*['|"](.*)['|"]/);
+    if (!match) {
+      return false;
+    }
+    hermesCommand = match[1];
+    return true;
+  });
+  if (!hermesCommand || hermesCommand.indexOf('%OS-BIN%') < 0) {
+    return null;
+  }
+  return hermesCommand;
+}
+
+// 获取 Hermes 执行文件位置, 参考 react 的代码逻辑
+// @see https://github.com/facebook/react-native/blob/master/react.gradle
+function getHermesCommond(cwd, platform) {
+  try {
+    const bin = getHermesOSBin();
+    if (!bin) {
+      return null;
+    }
+    const ext = 'win64-bin' === bin ? '.exe' : '';
+    // 自定义
+    const gradleHermes = getGradleHermes(cwd, platform);
+    if (gradleHermes) {
+      return path.join(cwd, 'android/app/', gradleHermes.replaceAll("%OS-BIN%", bin) + ext);
+    }
+    // react-native >= 0.69
+    let hermesPath = path.join(
+      cwd, "node_modules", "react-native", "sdks", "hermesc", bin, 'hermesc' + ext
+    );
+    if (fileExist(hermesPath)) {
+      return hermesPath;
+    }
+    // react-native >= 0.63
+    hermesPath = path.join(cwd, "node_modules", "hermes-engine", bin, 'hermesc' + ext);
+    if (fileExist(hermesPath)) {
+      return hermesPath;
+    }
+    // react-native >= 0.2
+    hermesPath = path.join(cwd, "node_modules", "hermes-engine", bin, 'hermes' + ext);
+    if (fileExist(hermesPath)) {
+      return hermesPath;
+    }
+    // react-native old
+    hermesPath = path.join(cwd, "node_modules", "hermesvm", bin, 'hermes' + ext);
+    if (fileExist(hermesPath)) {
+      return hermesPath;
+    }
+    return null
+  } catch(e) {}
+  return null;
+}
+
+/**
+  生成 android release apk
+  cwd: 运行目录
+  options: {target:"release", output:"filePath"}
+           target: 可指定编译类型
+           output: 相对于 cwd 的输出路径, 应包括 .apk 文件名
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+*/
+async function makeApk(cwd, options, stdout, stderr) {
+  try {
+    const androidDir = path.join(cwd, 'android');
+    const gradlew = path.join(
+      androidDir,
+      process && process.platform && process.platform.startsWith('win') ? 'gradlew.bat' : './gradlew'
+    );
+    const {target='release', output} = options||{};
+    const args = ['assemble' + target.charAt(0).toUpperCase() + target.slice(1)];
+    await execCommand(gradlew, args, {
+      cwd:androidDir,
+      stdio:['pipe', stdout, stderr]
+    });
+    let apkFile = path.join(androidDir, `app/build/outputs/apk/${target}/app-${target}.apk`);
+    if(output) {
+      const destFile = path.join(cwd, output);
+      ensureDirSync(path.dirname(destFile));
+      fs.copyFileSync(apkFile, destFile);
+      apkFile = destFile;
+    }
+    stdout.write(CInfo + `saved to: ${apkFile}\n`);
+    return apkFile;
+  } catch(e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+/**
+  生成 ios release ipa
+  cwd: 运行目录
+  options: {target:"release", output:"filePath"}
+           target: 可指定编译类型
+           output: 相对于 cwd 的输出路径, 应包括 .ipa 文件名
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+*/
+async function makeIpa(cwd, options, stdout, stderr) {
+  try {
+    const iosDir = path.join(cwd, 'ios');
+    const iosFiles = fs.readdirSync(iosDir);
+    let buildFile, isWorkspace;
+    for (let i = iosFiles.length - 1; i >= 0; i--) {
+      const fileName = iosFiles[i];
+      const ext = path.extname(fileName);
+      if (ext === '.xcworkspace') {
+        buildFile = fileName;
+        isWorkspace = true;
+        break;
+      }
+      if (ext === '.xcodeproj') {
+        buildFile = fileName;
+        isWorkspace = false;
+      }
+    }
+    if (!buildFile) {
+      throw new Error(`Could not find Xcode project files in "${iosDir}" folder`);
+    }
+    const {target='release', output='build/output/app-'+target+'.ipa'} = options||{};
+    const scheme = path.basename(buildFile, path.extname(buildFile));
+    const buildArgs = [
+      'build',
+      isWorkspace ? '-workspace' : '-project',
+      buildFile,
+      '-configuration',
+      target.charAt(0).toUpperCase() + target.slice(1),
+      '-scheme',
+      scheme,
+      '-sdk',
+      `iphoneos`,
+    ];
+    // 获取 .app 文件的保存路径
+    let buildTargetPath;
+    const buildSettings = execSync(
+      'xcodebuild ' + buildArgs.concat(['-showBuildSettings', '-json']).join(' '),
+      {cwd:iosDir, encoding: 'utf8'}
+    );
+    const settings = JSON.parse(buildSettings);
+    for (const i in settings) {
+      const wrapperExtension = settings[i].buildSettings.WRAPPER_EXTENSION;
+      if (wrapperExtension === 'app') {
+        buildTargetPath = settings[i].buildSettings.TARGET_BUILD_DIR + 
+                '/' + settings[i].buildSettings.EXECUTABLE_FOLDER_PATH;
+        break;
+      }
+    }
+    if (!buildTargetPath) {
+      throw new Error('Failed to get the target build directory.');
+    }
+    await execCommand('xcodebuild', buildArgs, {
+      cwd: iosDir,
+      stdio:['pipe', stdout, stderr]
+    });
+    const releaseIpa = path.join(cwd, output);
+    ensureDirSync(path.dirname(releaseIpa));
+    await packIpa(buildTargetPath, releaseIpa);
+    stdout.write(CInfo + `saved to: ${releaseIpa}\n`);
+    return releaseIpa;
+  } catch(e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+/**
+  生成全量的 jsBundle
+  cwd: 运行目录
+  options: 与 react-native bundle 命令参数相同, 如
+          {platform:"android", output:"dirPath", "entry-file":"index.js", ...}
+          支持参数可参见: https://github.com/react-native-community/cli/blob/main/docs/commands.md#bundle
+          但此处对支持参数有所修改
+          1. 新增 output 参数, 设置相对于 cwd 的目录的输出目录
+             不能使用 bundle-output, assets-dest 参数了, 使用 output 统一指定目录
+          2. 新增 save-name 参数, 用于指定最终输出的文件名
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+*/
+async function makeBundle(cwd, options, stdout, stderr) {
+  try {
+    if (!options.platform) {
+      throw new Error('platform unspecified');
+    }
+    if (!options['output']) {
+      options['output'] = 'build';
+    }
+    if (!options['entry-file']) {
+      options['entry-file'] = 'index.js'
+    }
+    if (!('dev' in options)) {
+      options['dev'] = false;
+    }
+    if (!('reset-cache' in options)) {
+      options['reset-cache'] = true;
+    }
+
+    let saveName = options['save-name'];
+    if (saveName) {
+      delete options['save-name'];
+    } else {
+      saveName = `${options.platform}.${Date.now()}.ppk`;
+    }
+    const output = options['output'];
+    const bundleName = 'index.bundlejs';
+    const outputFolder = path.join(output, 'bundle', options.platform);
+    delete options['output'];
+
+    options['assets-dest'] = outputFolder;
+    options['bundle-output'] = path.join(outputFolder, bundleName);
+    emptyDirSync(path.resolve(cwd, outputFolder));
+  
+    // 准备生成 bundle 的参数
+    const version = getRNVersion(cwd).version;
+    const args = [
+      path.join("node_modules", "react-native", "local-cli", "cli.js"), 
+      "bundle"
+    ];
+    if ('_' in options) {
+      args.push(...options._);
+      delete options._;
+    }
+    for (let k in options) {
+      args.push('--'+k, options[k])
+    }
+    stdout.write("Bundling with React Native version: " + version + "\n");
+    stdout.write('Running bundle command: node ' + args.join(' ') + "\n");
+
+    // 编译 bundle 并根据配置编译为 hermes 字节码
+    const stdio = ['pipe', stdout, stderr];
+    await execCommand('node', args, {cwd, stdio});
+    if (isHermesEnable(cwd, options.platform)) {
+      const hermesCommond = getHermesCommond(cwd, options.platform);
+      if (!hermesCommond) {
+        stderr.write(CError + "Hermes enabled, but not find hermes-engine\n");
+      } else {
+        stdout.write(CInfo + "Hermes enabled, now compiling to hermes bytecode\n");
+        const jsFile = options['bundle-output'];
+        const commandArgs = ['-emit-binary', '-out', jsFile, jsFile, '-O'];
+        if ('win32' === os.platform()) {
+          commandArgs.unshift('/c');
+        }
+        await execCommand(hermesCommond, commandArgs, {cwd, stdio})
+      }
+    }
+
+    // 打包为 zip 格式的 ppk 文件
+    const ppkDir = path.resolve(cwd, output, 'output');
+    const ppkFile = path.join(ppkDir, saveName);
+    stdout.write(CInfo + "make bundle success, packing\n");
+    ensureDirSync(ppkDir);
+    await packZip(options['assets-dest'], ppkFile);
+    stdout.write(CInfo + `saved to: ${ppkFile}\n`);
+    return ppkFile;
+  } catch(e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+module.exports = {
+  makeApk,
+  makeIpa,
+  makeBundle
+};

package/src/patch.js

@@ -0,0 +1,288 @@
+const fs = require('fs');
+const path = require('path');
+const {ZipFile} = require('yazl');
+const {
+  CInfo, CError, errMsg, fileExist, ensureDirSync, 
+  getDiff, enumZipEntries, readZipEntireBuffer, saveZipFile
+} = require('./utils');
+
+function basename(file) {
+  const m = /^(.+\/)[^\/]+\/?$/.exec(file);
+  return m && m[1];
+}
+
+function transformIosPath(file) {
+  const match = /^Payload\/[^/]+\/(.+)$/.exec(file);
+  return match && match[1];
+}
+
+// 处理命令行输入参数
+function resolveOption(cwd, options, commond) {
+  let originName = 'origin_file', nextName = 'new_bundle';
+  switch(commond) {
+    case 'diffapk':
+      originName = 'origin_apk';
+      break;
+    case 'diffipa':
+      originName = 'origin_ipa';
+      break;
+    case 'diffbundle':
+      originName = 'origin_bundle';
+      break;
+    default:
+      nextName = 'new_file';
+      break;  
+  }
+  let {origin, next, output, cmd} = options;
+  if (!origin || !next) {
+    const err = cmd ? `erpush ${commond} <${originName}> <${nextName}> [--output save_name]` : 'Argumets error';
+    throw err;
+  }
+  next = path.resolve(cwd, next);
+  origin = path.resolve(cwd, origin);
+  if (!fileExist(origin)) {
+    throw originName + ' file not exist';
+  }
+  if (!fileExist(next)) {
+    throw nextName + ' file not exist';
+  }
+  if (!output) {
+    if (commond === 'diff') {
+      output = 'build/diff/diff-'+Date.now()+'.patch';
+    } else {
+      output = 'build/output/diff-'+Date.now()+'.'+(commond === 'diff' ? 'diff' : (commond == 'diffipa' ? 'ipa' : 'apk'))+'-patch';
+    }
+  }
+  output = path.resolve(cwd, output);
+  return {origin, next, output}
+}
+
+/**
+  工具函数, 生成两个文件的 diff 补丁包, 文件路径为相对于 cwd 的路径
+  cwd: 运行目录
+  options: {origin:"原始文件路径", next:"新文件路径", output:"patch生成路径"}
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+*/
+async function diff(cwd, options, stdout, stderr) {
+  try {
+    const {origin, next, output} = resolveOption(cwd, options, 'diff');
+    ensureDirSync(path.dirname(output));
+    fs.writeFileSync(output, getDiff(
+      fs.readFileSync(origin),
+      fs.readFileSync(next)
+    ));
+    stdout.write(CInfo + `saved to: ${output}\n`);
+    return output;
+  } catch (e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+/**
+  生成 bundle 相对于 apk/ipa 的全量更新包, 文件路径为相对于 cwd 的路径
+  cwd: 运行目录
+  options: {origin:"apk|ipa 路径", next:"新 bundle 路径", output:"patch保存路径"}
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+  ios: 是否为 ios
+  客户端更新流程: 解压全量更新包 -> 根据 __diff.json 中的 copies 字段, 从安装包复制相关文件
+*/
+async function diffPackage(cwd, options, stdout, stderr, ios) {
+  try {
+    const originBundleName = ios ? 'main.jsbundle' : 'assets/index.android.bundle';
+    const {origin, next, output} = resolveOption(cwd, options, ios ? 'diffipa' : 'diffapk');
+
+    // 读取 apk 或 ipa 文件
+    let originSource;
+    const originMap = {};
+    const originEntries = {};
+    await enumZipEntries(origin, (entry, zip) => {
+      if (!entry.isDirectory) {
+        const file = ios ? transformIosPath(entry.fileName) : entry.fileName;
+        if (!file) {
+          return;
+        }
+        // isFile
+        originEntries[file] = entry.hash;
+        originMap[entry.hash] = file;
+        // js bundle file
+        if (file === originBundleName) {
+          return readZipEntireBuffer(entry, zip).then(v => (originSource = v));
+        }
+      }
+    });
+    originSource = originSource || Buffer.alloc(0);
+
+    // 读取 ppk 文件, 提取与 apk|ipa 的不同
+    const copies = {};
+    const zipfile = new ZipFile();
+    await enumZipEntries(next, (entry, nextZipfile) => {
+      // Directory
+      if (entry.isDirectory) {
+        zipfile.addEmptyDirectory(entry.fileName);
+        return;
+      }
+      // Bundle file
+      if (entry.fileName === 'index.bundlejs') {
+        stdout.write(CInfo + "Found bundle\n");
+        return readZipEntireBuffer(entry, nextZipfile).then(newSource => {
+          zipfile.addBuffer(getDiff(originSource, newSource), 'index.bundlejs.patch');
+          stdout.write(CInfo + "Make diff bundle success\n");
+        });
+      }
+      // 该文件在 apk|ipa 中存在 && 路径一致, 无需打包, 标记为 copy, 从安装包中复制
+      if (originEntries[entry.fileName] === entry.hash) {
+        copies[entry.fileName] = '';
+        return;
+      }
+      // 该文件在 apk|ipa 中存在 && 路径不一致, 无需打包, 标记 copy 文件在安装包的原路径
+      if (originMap[entry.hash]) {
+        copies[entry.fileName] = originMap[entry.hash];
+        return;
+      }
+      // 新增的文件
+      return new Promise((resolve, reject) => {
+        nextZipfile.openReadStream(entry, function(err, readStream) {
+          if (err) {
+            return reject(err);
+          }
+          zipfile.addReadStream(readStream, entry.fileName);
+          resolve();
+        });
+      });
+    });
+    zipfile.addBuffer(Buffer.from(JSON.stringify({copies})), '__diff.json');
+    zipfile.end();
+
+    // save patch
+    ensureDirSync(path.dirname(output));
+    await saveZipFile(zipfile, output)
+    stdout.write(CInfo + `saved to: ${output}\n`);
+    return output;
+  } catch (e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+/**
+  生 新bundle 相对于 旧bundle 的增量更新包, 文件路径为相对于 cwd 的路径
+  cwd: 运行目录
+  options: {origin:"旧 bundle 路径", next:"新 bundle 路径", output:"patch保存路径"}
+  stdout: 信息输出的 stream
+  stderr: 异常输出的 stream
+  客户端更新时: 根据 copies 复制文件 -> 复制上一个除 deletes 之外的文件 -> 将新版本合并进去
+*/
+async function diffBundle(cwd, options, stdout, stderr) {
+  try {
+    const {origin, next, output} = resolveOption(cwd, options, 'diff');
+
+    // 读取 旧bundle 文件
+    let originSource;
+    const originMap = {};
+    const originEntries = {};
+    stdout.write(CInfo + `Read origin bundle: ${options.origin}\n`);
+    await enumZipEntries(origin, (entry, zipFile) => {
+      originEntries[entry.fileName] = entry;
+      if (entry.isDirectory) {
+        return;
+      }
+      originMap[entry.hash] = entry.fileName;
+      // js bundle file
+      if (entry.fileName === 'index.bundlejs') {
+        return readZipEntireBuffer(entry, zipFile).then(v => (originSource = v));
+      }
+    });
+    originSource = originSource || Buffer.alloc(0);
+
+    // 读取 新Bundle 文件, 提取与 旧bundle 的不同
+    const copies = {};
+    const addedEntry = {};
+    const newEntries = {};
+    const dirsAdded = [];
+    const zipfile = new ZipFile();
+    const addEntry = (file) => {
+      if (!file || addedEntry[file]) {
+        return;
+      }
+      const base = basename(file);
+      if (base) {
+        addEntry(base);
+      }
+      if (!dirsAdded.includes(file)) {
+        zipfile.addEmptyDirectory(file);
+      }
+    };
+    stdout.write(CInfo + `Read next bundle: ${options.next}\n`);
+    await enumZipEntries(next, (entry, nextZipfile) => {
+      newEntries[entry.fileName] = entry;
+      // Directory
+      if (entry.isDirectory) {
+        if (!originEntries[entry.fileName]) {
+          addEntry(entry.fileName);
+        }
+        return;
+      }
+      // Bundle file
+      if (entry.fileName === 'index.bundlejs') {
+        stdout.write(CInfo + "Found bundle\n");
+        return readZipEntireBuffer(entry, nextZipfile).then(newSource => {
+          zipfile.addBuffer(getDiff(originSource, newSource), 'index.bundlejs.patch');
+          stdout.write(CInfo + "Make diff bundle success\n");
+        });
+      }
+      const originEntry = originEntries[entry.fileName];
+      // 旧版存在相同 hash 文件, 且路径相同, 跳过
+      if (originEntry && originEntry.hash === entry.hash) {
+        return;
+      }
+      // 旧版存在相同 hash 文件, 但路径不同, 需复制
+      if (originMap[entry.hash]) {
+        const base = basename(entry.fileName);
+        if (!originEntries[base]) {
+          addEntry(base);
+        }
+        copies[entry.fileName] = originMap[entry.hash];
+        return;
+      }
+      // 新增的文件, 先添加文件夹, 再添加文件
+      addEntry(basename(entry.fileName));
+      return new Promise((resolve, reject) => {
+        nextZipfile.openReadStream(entry, function(err, readStream) {
+          if (err) {
+            return reject(err);
+          }
+          zipfile.addReadStream(readStream, entry.fileName);
+          resolve();
+        });
+      });
+    });
+
+    // 在 旧bundle 中存在, 而 新Bundel 中不存在的文件标记为 deletes
+    const deletes = {};
+    for (var k in originEntries) {
+      if (!newEntries[k]) {
+        deletes[k] = 1;
+      }
+    }
+    zipfile.addBuffer(Buffer.from(JSON.stringify({ copies, deletes })), '__diff.json');
+    zipfile.end();
+
+    // save patch
+    ensureDirSync(path.dirname(output));
+    await saveZipFile(zipfile, output)
+    stdout.write(CInfo + `saved to: ${output}\n`);
+    return output;
+  } catch (e) {
+    stderr.write(CError + errMsg(e) + "\n");
+  }
+  return false;
+}
+
+module.exports = {
+  diff,
+  diffPackage,
+  diffBundle,
+};