electron-incremental-update 2.2.1 → 2.2.3

package/dist/utils.cjs

@@ -1,18 +1,18 @@
 'use strict';
 
+var crypto = require('crypto');
+var electron2 = require('electron');
 var fs = require('fs');
 var path = require('path');
-var electron = require('electron');
 var zlib = require('zlib');
-var crypto = require('crypto');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
+var crypto__default = /*#__PURE__*/_interopDefault(crypto);
+var electron2__default = /*#__PURE__*/_interopDefault(electron2);
 var fs__default = /*#__PURE__*/_interopDefault(fs);
 var path__default = /*#__PURE__*/_interopDefault(path);
-var electron__default = /*#__PURE__*/_interopDefault(electron);
 var zlib__default = /*#__PURE__*/_interopDefault(zlib);
-var crypto__default = /*#__PURE__*/_interopDefault(crypto);
 
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
@@ -20,18 +20,200 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
+function hashBuffer(data, length) {
+  const hash = crypto__default.default.createHash("SHA256").update(data).digest("binary");
+  return Buffer.from(hash).subarray(0, length);
+}
+function aesEncrypt(plainText, key, iv) {
+  const cipher = crypto__default.default.createCipheriv("aes-256-cbc", key, iv);
+  return cipher.update(plainText, "utf8", "base64url") + cipher.final("base64url");
+}
+function defaultSignature(buffer, privateKey, cert, version) {
+  const sig = crypto__default.default.createSign("RSA-SHA256").update(buffer).sign(crypto__default.default.createPrivateKey(privateKey), "base64");
+  return aesEncrypt(`${sig}%${version}`, hashBuffer(cert, 32), hashBuffer(buffer, 16));
+}
+function aesDecrypt(encryptedText, key, iv) {
+  const decipher = crypto__default.default.createDecipheriv("aes-256-cbc", key, iv);
+  return decipher.update(encryptedText, "base64url", "utf8") + decipher.final("utf8");
+}
+function defaultVerifySignature(buffer, version, signature, cert) {
+  try {
+    const [sig, ver] = aesDecrypt(signature, hashBuffer(cert, 32), hashBuffer(buffer, 16)).split("%");
+    if (ver !== version) {
+      return false;
+    }
+    return crypto__default.default.createVerify("RSA-SHA256").update(buffer).verify(cert, sig, "base64");
+  } catch {
+    return false;
+  }
+}
+
+// src/utils/version.ts
+function parseVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:-([a-z0-9.-]+))?/i.exec(version);
+  if (!match) {
+    throw new TypeError(`invalid version: ${version}`);
+  }
+  const [major, minor, patch] = match.slice(1, 4).map(Number);
+  const ret = {
+    major,
+    minor,
+    patch,
+    stage: "",
+    stageVersion: -1
+  };
+  if (match[4]) {
+    let [stage, _v] = match[4].split(".");
+    ret.stage = stage;
+    ret.stageVersion = Number(_v) || -1;
+  }
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
+    throw new TypeError(`Invalid version: ${version}`);
+  }
+  return ret;
+}
+function compareStrings(str1, str2) {
+  if (str1 === "") {
+    return str2 !== "";
+  } else if (str2 === "") {
+    return true;
+  }
+  return str1 < str2;
+}
+function defaultIsLowerVersion(oldVer, newVer) {
+  const oldV = parseVersion(oldVer);
+  const newV = parseVersion(newVer);
+  for (let key of Object.keys(oldV)) {
+    if (key === "stage" && compareStrings(oldV[key], newV[key])) {
+      return true;
+    } else if (oldV[key] !== newV[key]) {
+      return oldV[key] < newV[key];
+    }
+  }
+  return false;
+}
+var is = (j) => !!(j && j.minimumVersion && j.signature && j.version);
+function isUpdateJSON(json) {
+  return is(json) && is(json?.beta);
+}
+function defaultVersionJsonGenerator(existingJson, signature, version, minimumVersion) {
+  existingJson.beta = {
+    version,
+    minimumVersion,
+    signature
+  };
+  if (!parseVersion(version).stage) {
+    existingJson.version = version;
+    existingJson.minimumVersion = minimumVersion;
+    existingJson.signature = signature;
+  }
+  return existingJson;
+}
+
+// src/utils/download.ts
+function getHeader(headers, key) {
+  const value = headers[key];
+  if (Array.isArray(value)) {
+    return value.length === 0 ? null : value[value.length - 1];
+  } else {
+    return value;
+  }
+}
+async function downloadUtil(url, headers, signal, onResponse) {
+  await electron2__default.default.app.whenReady();
+  return new Promise((resolve, reject) => {
+    const request = electron2__default.default.net.request({ url, method: "GET", redirect: "follow", headers, cache: "no-cache" });
+    signal.addEventListener("abort", () => request.abort(), { once: true });
+    request.on("response", (resp) => {
+      resp.on("aborted", () => reject(new Error("aborted")));
+      resp.on("error", () => reject(new Error("download error")));
+      onResponse(resp, resolve, reject);
+    });
+    request.on("error", reject);
+    request.end();
+  });
+}
+function trimData(data) {
+  return data.trim().slice(0, 5e3).replace(/\s+/g, " ");
+}
+var defaultResolveDataFn = (data, resolve, reject) => {
+  try {
+    resolve(JSON.parse(data));
+  } catch {
+    reject(new Error(`Invalid json, "${trimData(data)}"`));
+  }
+};
+async function defaultDownloadJSON(url, headers, signal, resolveData = defaultResolveDataFn) {
+  return await downloadUtil(
+    url,
+    headers,
+    signal,
+    (resp, resolve, reject) => {
+      let data = "";
+      resp.on("data", (chunk) => data += chunk);
+      resp.on("end", () => resolveData(data, resolve, reject));
+    }
+  );
+}
+async function defaultDownloadUpdateJSON(url, headers, signal) {
+  return await defaultDownloadJSON(
+    url,
+    headers,
+    signal,
+    (data, resolve, reject) => {
+      try {
+        const json = JSON.parse(data);
+        if (isUpdateJSON(json)) {
+          resolve(json);
+        } else {
+          throw Error;
+        }
+      } catch {
+        reject(new Error(`Invalid update json, "${trimData(data)}"`));
+      }
+    }
+  );
+}
+async function defaultDownloadAsar(url, headers, signal, onDownloading) {
+  let transferred = 0;
+  let time = Date.now();
+  return await downloadUtil(
+    url,
+    headers,
+    signal,
+    (resp, resolve) => {
+      const total = +getHeader(resp.headers, "content-length") || -1;
+      const data = [];
+      resp.on("data", (chunk) => {
+        const delta = chunk.length;
+        transferred += delta;
+        const current = Date.now();
+        onDownloading?.({
+          percent: total > 0 ? +(transferred / total).toFixed(2) * 100 : -1,
+          total,
+          transferred,
+          delta,
+          bps: delta / (current - time)
+        });
+        time = current;
+        data.push(chunk);
+      });
+      resp.on("end", () => resolve(Buffer.concat(data)));
+    }
+  );
+}
 var isDev = __EIU_IS_DEV__;
 var isWin = process.platform === "win32";
 var isMac = process.platform === "darwin";
 var isLinux = process.platform === "linux";
 function getPathFromAppNameAsar(...paths) {
-  return isDev ? "DEV.asar" : path__default.default.join(path__default.default.dirname(electron__default.default.app.getAppPath()), `${electron__default.default.app.name}.asar`, ...paths);
+  return isDev ? "DEV.asar" : path__default.default.join(path__default.default.dirname(electron2__default.default.app.getAppPath()), `${electron2__default.default.app.name}.asar`, ...paths);
 }
 function getAppVersion() {
   return isDev ? getEntryVersion() : fs__default.default.readFileSync(getPathFromAppNameAsar("version"), "utf-8");
 }
 function getEntryVersion() {
-  return electron__default.default.app.getVersion();
+  return electron2__default.default.app.getVersion();
 }
 function requireNative(moduleName) {
   const m = getPathFromEntryAsar(moduleName);
@@ -48,21 +230,21 @@ async function importNative(moduleName) {
   return await import(`file://${m}.js`);
 }
 function restartApp() {
-  electron__default.default.app.relaunch();
-  electron__default.default.app.quit();
+  electron2__default.default.app.relaunch();
+  electron2__default.default.app.quit();
 }
 function setAppUserModelId(id) {
   if (isWin) {
-    electron__default.default.app.setAppUserModelId(id ?? `org.${electron__default.default.app.name}`);
+    electron2__default.default.app.setAppUserModelId(id ?? `org.${electron2__default.default.app.name}`);
   }
 }
 function disableHWAccForWin7() {
   if (!__EIU_IS_ESM__ && __require("os").release().startsWith("6.1")) {
-    electron__default.default.app.disableHardwareAcceleration();
+    electron2__default.default.app.disableHardwareAcceleration();
   }
 }
 function singleInstance(window) {
-  electron__default.default.app.on("second-instance", () => {
+  electron2__default.default.app.on("second-instance", () => {
     if (window) {
       window.show();
       if (window.isMinimized()) {
@@ -73,11 +255,11 @@ function singleInstance(window) {
   });
 }
 function setPortableAppDataPath(dirName = "data") {
-  const portablePath = path__default.default.join(path__default.default.dirname(electron__default.default.app.getPath("exe")), dirName);
+  const portablePath = path__default.default.join(path__default.default.dirname(electron2__default.default.app.getPath("exe")), dirName);
   if (!fs__default.default.existsSync(portablePath)) {
     fs__default.default.mkdirSync(portablePath);
   }
-  electron__default.default.app.setPath("appData", portablePath);
+  electron2__default.default.app.setPath("appData", portablePath);
 }
 function loadPage(win, htmlFilePath = "index.html") {
   if (isDev) {
@@ -98,21 +280,32 @@ function beautifyDevTools(win, options) {
   });
 }
 function getPathFromMain(...paths) {
-  return isDev ? path__default.default.join(electron__default.default.app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "main", ...paths) : getPathFromAppNameAsar("main", ...paths);
+  return isDev ? path__default.default.join(electron2__default.default.app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "main", ...paths) : getPathFromAppNameAsar("main", ...paths);
 }
 function getPathFromPreload(...paths) {
-  return isDev ? path__default.default.join(electron__default.default.app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "preload", ...paths) : getPathFromAppNameAsar("preload", ...paths);
+  return isDev ? path__default.default.join(electron2__default.default.app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "preload", ...paths) : getPathFromAppNameAsar("preload", ...paths);
 }
 function getPathFromPublic(...paths) {
-  return isDev ? path__default.default.join(electron__default.default.app.getAppPath(), "public", ...paths) : getPathFromAppNameAsar("renderer", ...paths);
+  return isDev ? path__default.default.join(electron2__default.default.app.getAppPath(), "public", ...paths) : getPathFromAppNameAsar("renderer", ...paths);
 }
 function getPathFromEntryAsar(...paths) {
-  return path__default.default.join(electron__default.default.app.getAppPath(), __EIU_ENTRY_DIST_PATH__, ...paths);
+  return path__default.default.join(electron2__default.default.app.getAppPath(), __EIU_ENTRY_DIST_PATH__, ...paths);
 }
 function handleUnexpectedErrors(callback) {
   process.on("uncaughtException", callback);
   process.on("unhandledRejection", callback);
 }
+function reloadOnPreloadScriptChanged() {
+  if (isDev) {
+    process.on("message", (msg) => {
+      if (msg === "electron-vite&type=hot-reload") {
+        for (const window of electron2__default.default.BrowserWindow.getAllWindows()) {
+          window.reload();
+        }
+      }
+    });
+  }
+}
 async function defaultZipFile(buffer) {
   return new Promise((resolve, reject) => {
     zlib__default.default.brotliCompress(buffer, (err, buffer2) => err ? reject(err) : resolve(buffer2));
@@ -124,98 +317,12 @@ async function defaultUnzipFile(buffer) {
   });
 }
 
-// src/utils/version.ts
-function parseVersion(version) {
-  const match = /^(\d+)\.(\d+)\.(\d+)(?:-([a-z0-9.-]+))?/i.exec(version);
-  if (!match) {
-    throw new TypeError(`invalid version: ${version}`);
-  }
-  const [major, minor, patch] = match.slice(1, 4).map(Number);
-  const ret = {
-    major,
-    minor,
-    patch,
-    stage: "",
-    stageVersion: -1
-  };
-  if (match[4]) {
-    let [stage, _v] = match[4].split(".");
-    ret.stage = stage;
-    ret.stageVersion = Number(_v) || -1;
-  }
-  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
-    throw new TypeError(`Invalid version: ${version}`);
-  }
-  return ret;
-}
-function compareStrings(str1, str2) {
-  if (str1 === "") {
-    return str2 !== "";
-  } else if (str2 === "") {
-    return true;
-  }
-  return str1 < str2;
-}
-function defaultIsLowerVersion(oldVer, newVer) {
-  const oldV = parseVersion(oldVer);
-  const newV = parseVersion(newVer);
-  for (let key of Object.keys(oldV)) {
-    if (key === "stage" && compareStrings(oldV[key], newV[key])) {
-      return true;
-    } else if (oldV[key] !== newV[key]) {
-      return oldV[key] < newV[key];
-    }
-  }
-  return false;
-}
-var is = (j) => !!(j && j.minimumVersion && j.signature && j.version);
-function isUpdateJSON(json) {
-  return is(json) && is(json?.beta);
-}
-function defaultVersionJsonGenerator(existingJson, signature, version, minimumVersion) {
-  existingJson.beta = {
-    version,
-    minimumVersion,
-    signature
-  };
-  if (!parseVersion(version).stage) {
-    existingJson.version = version;
-    existingJson.minimumVersion = minimumVersion;
-    existingJson.signature = signature;
-  }
-  return existingJson;
-}
-function hashBuffer(data, length) {
-  const hash = crypto__default.default.createHash("SHA256").update(data).digest("binary");
-  return Buffer.from(hash).subarray(0, length);
-}
-function aesEncrypt(plainText, key, iv) {
-  const cipher = crypto__default.default.createCipheriv("aes-256-cbc", key, iv);
-  return cipher.update(plainText, "utf8", "base64url") + cipher.final("base64url");
-}
-function defaultSignature(buffer, privateKey, cert, version) {
-  const sig = crypto__default.default.createSign("RSA-SHA256").update(buffer).sign(crypto__default.default.createPrivateKey(privateKey), "base64");
-  return aesEncrypt(`${sig}%${version}`, hashBuffer(cert, 32), hashBuffer(buffer, 16));
-}
-function aesDecrypt(encryptedText, key, iv) {
-  const decipher = crypto__default.default.createDecipheriv("aes-256-cbc", key, iv);
-  return decipher.update(encryptedText, "base64url", "utf8") + decipher.final("utf8");
-}
-function defaultVerifySignature(buffer, version, signature, cert) {
-  try {
-    const [sig, ver] = aesDecrypt(signature, hashBuffer(cert, 32), hashBuffer(buffer, 16)).split("%");
-    if (ver !== version) {
-      return false;
-    }
-    return crypto__default.default.createVerify("RSA-SHA256").update(buffer).verify(cert, sig, "base64");
-  } catch {
-    return false;
-  }
-}
-
 exports.aesDecrypt = aesDecrypt;
 exports.aesEncrypt = aesEncrypt;
 exports.beautifyDevTools = beautifyDevTools;
+exports.defaultDownloadAsar = defaultDownloadAsar;
+exports.defaultDownloadJSON = defaultDownloadJSON;
+exports.defaultDownloadUpdateJSON = defaultDownloadUpdateJSON;
 exports.defaultIsLowerVersion = defaultIsLowerVersion;
 exports.defaultSignature = defaultSignature;
 exports.defaultUnzipFile = defaultUnzipFile;
@@ -223,8 +330,10 @@ exports.defaultVerifySignature = defaultVerifySignature;
 exports.defaultVersionJsonGenerator = defaultVersionJsonGenerator;
 exports.defaultZipFile = defaultZipFile;
 exports.disableHWAccForWin7 = disableHWAccForWin7;
+exports.downloadUtil = downloadUtil;
 exports.getAppVersion = getAppVersion;
 exports.getEntryVersion = getEntryVersion;
+exports.getHeader = getHeader;
 exports.getPathFromAppNameAsar = getPathFromAppNameAsar;
 exports.getPathFromEntryAsar = getPathFromEntryAsar;
 exports.getPathFromMain = getPathFromMain;
@@ -240,6 +349,7 @@ exports.isUpdateJSON = isUpdateJSON;
 exports.isWin = isWin;
 exports.loadPage = loadPage;
 exports.parseVersion = parseVersion;
+exports.reloadOnPreloadScriptChanged = reloadOnPreloadScriptChanged;
 exports.requireNative = requireNative;
 exports.restartApp = restartApp;
 exports.setAppUserModelId = setAppUserModelId;

package/dist/utils.d.cts

@@ -1,6 +1,8 @@
+export { b as aesDecrypt, a as aesEncrypt, j as defaultDownloadAsar, f as defaultDownloadJSON, i as defaultDownloadUpdateJSON, d as defaultSignature, l as defaultUnzipFile, c as defaultVerifySignature, k as defaultZipFile, e as downloadUtil, g as getHeader, h as hashBuffer } from './zip-BQS8qbGA.cjs';
 import { BrowserWindow } from 'electron';
-export { e as aesDecrypt, b as aesEncrypt, c as defaultSignature, a as defaultUnzipFile, f as defaultVerifySignature, d as defaultZipFile, h as hashBuffer } from './crypto-Zynscwmj.cjs';
-export { U as UpdateInfo, a as UpdateJSON, V as Version, d as defaultIsLowerVersion, b as defaultVersionJsonGenerator, i as isUpdateJSON, p as parseVersion } from './version-BYVQ367i.cjs';
+export { U as UpdateInfo, a as UpdateJSON, V as Version, d as defaultIsLowerVersion, c as defaultVersionJsonGenerator, i as isUpdateJSON, p as parseVersion } from './types-C5M2xRjF.cjs';
+import '@subframe7536/type-utils';
+import 'node:url';
 
 /**
  * Compile time dev check
@@ -115,5 +117,6 @@ declare function getPathFromEntryAsar(...paths: string[]): string;
  * @param callback callback function
  */
 declare function handleUnexpectedErrors(callback: (err: unknown) => void): void;
+declare function reloadOnPreloadScriptChanged(): void;
 
-export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance };
+export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, reloadOnPreloadScriptChanged, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance };

package/dist/utils.d.ts

@@ -1,6 +1,8 @@
+export { b as aesDecrypt, a as aesEncrypt, j as defaultDownloadAsar, f as defaultDownloadJSON, i as defaultDownloadUpdateJSON, d as defaultSignature, l as defaultUnzipFile, c as defaultVerifySignature, k as defaultZipFile, e as downloadUtil, g as getHeader, h as hashBuffer } from './zip-DbfskMQi.js';
 import { BrowserWindow } from 'electron';
-export { e as aesDecrypt, b as aesEncrypt, c as defaultSignature, a as defaultUnzipFile, f as defaultVerifySignature, d as defaultZipFile, h as hashBuffer } from './crypto-Zynscwmj.js';
-export { U as UpdateInfo, a as UpdateJSON, V as Version, d as defaultIsLowerVersion, b as defaultVersionJsonGenerator, i as isUpdateJSON, p as parseVersion } from './version-BYVQ367i.js';
+export { U as UpdateInfo, a as UpdateJSON, V as Version, d as defaultIsLowerVersion, c as defaultVersionJsonGenerator, i as isUpdateJSON, p as parseVersion } from './types-C5M2xRjF.js';
+import '@subframe7536/type-utils';
+import 'node:url';
 
 /**
  * Compile time dev check
@@ -115,5 +117,6 @@ declare function getPathFromEntryAsar(...paths: string[]): string;
  * @param callback callback function
  */
 declare function handleUnexpectedErrors(callback: (err: unknown) => void): void;
+declare function reloadOnPreloadScriptChanged(): void;
 
-export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance };
+export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, reloadOnPreloadScriptChanged, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance };

package/dist/utils.js

@@ -1,3 +1,3 @@
-export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance } from './chunk-JI27JWJN.js';
-export { aesDecrypt, aesEncrypt, defaultSignature, defaultUnzipFile, defaultVerifySignature, defaultZipFile, hashBuffer } from './chunk-PUVBFHOK.js';
+export { beautifyDevTools, disableHWAccForWin7, getAppVersion, getEntryVersion, getPathFromAppNameAsar, getPathFromEntryAsar, getPathFromMain, getPathFromPreload, getPathFromPublic, handleUnexpectedErrors, importNative, isDev, isLinux, isMac, isWin, loadPage, reloadOnPreloadScriptChanged, requireNative, restartApp, setAppUserModelId, setPortableAppDataPath, singleInstance } from './chunk-YZGE4RFY.js';
+export { aesDecrypt, aesEncrypt, defaultDownloadAsar, defaultDownloadJSON, defaultDownloadUpdateJSON, defaultSignature, defaultUnzipFile, defaultVerifySignature, defaultZipFile, downloadUtil, getHeader, hashBuffer } from './chunk-D7NXTCQW.js';
 export { defaultIsLowerVersion, defaultVersionJsonGenerator, isUpdateJSON, parseVersion } from './chunk-AAAM44NW.js';

package/dist/vite.d.ts

@@ -4,18 +4,48 @@ import { Promisable } from '@subframe7536/type-utils';
 export { isCI } from 'ci-info';
 export { getPackageInfo, getPackageInfoSync, loadPackageJSON, resolveModule } from 'local-pkg';
 
+interface BytecodeOptions {
+    enable: boolean;
+    /**
+     * Enable in preload script. Remember to set `sandbox: false` when creating window
+     */
+    preload?: boolean;
+    /**
+     * Custom electron binary path
+     */
+    electronPath?: string;
+    /**
+     * Before transformed code compile function. If return `Falsy` value, it will be ignored
+     * @param code transformed code
+     * @param id file path
+     */
+    beforeCompile?: (code: string, id: string) => Promisable<string | null | undefined | void>;
+}
+
 /**
  * Update info json
  */
 type UpdateInfo = {
+    /**
+     * Update Asar signature
+     */
     signature: string;
+    /**
+     * Minimum version
+     */
     minimumVersion: string;
+    /**
+     * Target version
+     */
     version: string;
 };
 /**
  * {@link UpdateInfo} with beta
  */
 type UpdateJSON = UpdateInfo & {
+    /**
+     * Beta update info
+     */
     beta: UpdateInfo;
 };
 
@@ -140,20 +170,19 @@ interface GeneratorOverrideFunctions {
      * Custom signature generate function
      * @param buffer file buffer
      * @param privateKey private key
-     * @param cert certificate string, **EOL must be '\n'**
+     * @param cert certificate string, **EOL must be `\n`**
      * @param version current version
      */
     generateSignature?: (buffer: Buffer, privateKey: string, cert: string, version: string) => Promisable<string>;
     /**
-     * Custom generate version json function
+     * Custom generate update json function
      * @param existingJson The existing JSON object.
      * @param buffer file buffer
      * @param signature generated signature
      * @param version current version
      * @param minVersion The minimum version
-     * @returns The updated version json
      */
-    generateVersionJson?: (existingJson: UpdateJSON, signature: string, version: string, minVersion: string) => Promisable<UpdateJSON>;
+    generateUpdateJson?: (existingJson: UpdateJSON, signature: string, version: string, minVersion: string) => Promisable<UpdateJSON>;
     /**
      * Custom generate zip file buffer
      * @param buffer source buffer
@@ -248,24 +277,6 @@ interface ElectronUpdaterOptions {
     overrideGenerator?: GeneratorOverrideFunctions;
 }
 
-interface BytecodeOptions {
-    enable: boolean;
-    /**
-     * Enable in preload script. Remember to set `sandbox: false` when creating window
-     */
-    preload?: boolean;
-    /**
-     * Custom electron binary path
-     */
-    electronPath?: string;
-    /**
-     * Before transformed code compile function. If return `Falsy` value, it will be ignored
-     * @param code transformed code
-     * @param id file path
-     */
-    beforeCompile?: (code: string, id: string) => Promisable<string | null | undefined | void>;
-}
-
 /**
  * Obfuscate string
  * @param code source code
@@ -284,8 +295,9 @@ type ReplaceKey<T, Key extends keyof T, NewKey extends string> = Omit<T, Key> &
     [P in NewKey]: T[Key];
 };
 type MakeRequiredAndReplaceKey<T, K extends keyof T, NewKey extends string> = MakeRequired<ReplaceKey<T, K, NewKey>, NewKey>;
+type StartupFn = Exclude<Exclude<ElectronSimpleOptions['preload'], undefined>['onstart'], undefined>;
 /**
- * startup function for debug (see {@link https://github.com/electron-vite/electron-vite-vue/blob/main/vite.config.ts electron-vite-vue template})
+ * Startup function for debug (see {@link https://github.com/electron-vite/electron-vite-vue/blob/main/vite.config.ts electron-vite-vue template})
  * @example
  * import { debugStartup, buildElectronPluginOptions } from 'electron-incremental-update/vite'
  * const options = buildElectronPluginOptions({
@@ -296,10 +308,20 @@ type MakeRequiredAndReplaceKey<T, K extends keyof T, NewKey extends string> = Ma
  *   },
  * })
  */
-declare function debugStartup(args: {
-    startup: (argv?: string[]) => Promise<void>;
-    reload: () => void;
-}): void;
+declare const debugStartup: StartupFn;
+/**
+ * Startup function util to fix Windows terminal charset
+ * @example
+ * import { debugStartup, fixWinCharEncoding, buildElectronPluginOptions } from 'electron-incremental-update/vite'
+ * const options = buildElectronPluginOptions({
+ *   // ...
+ *   main: {
+ *     // ...
+ *     startup: fixWinCharEncoding(debugStartup)
+ *   },
+ * })
+ */
+declare function fixWinCharEncoding(fn: StartupFn): StartupFn;
 type ExcludeOutputDirOptions = {
     vite?: {
         build?: {
@@ -432,4 +454,4 @@ interface ElectronWithUpdaterOptions {
  */
 declare function electronWithUpdater(options: ElectronWithUpdaterOptions): Promise<PluginOption[] | undefined>;
 
-export { type ElectronWithUpdaterOptions, convertLiteral, debugStartup, electronWithUpdater as default, electronWithUpdater };
+export { type ElectronWithUpdaterOptions, convertLiteral, debugStartup, electronWithUpdater as default, electronWithUpdater, fixWinCharEncoding };