electron-incremental-update 0.7.8 → 0.7.9

package/dist/index.mjs

@@ -1,16 +1,20 @@
 import {
-  isUpdateJSON,
   verify
-} from "./chunk-2XHZMWRR.mjs";
+} from "./chunk-Q2K52LOG.mjs";
 import {
-  __require,
   getEntryVersion,
   getProductAsarPath,
   getProductVersion,
   parseVersion,
   unzipFile,
   waitAppReady
-} from "./chunk-SWXNCK6H.mjs";
+} from "./chunk-4TION32M.mjs";
+import {
+  isUpdateJSON
+} from "./chunk-2JVXVTC5.mjs";
+import {
+  __require
+} from "./chunk-ZFXKCRJC.mjs";
 
 // src/index.ts
 import { resolve } from "node:path";
@@ -18,15 +22,14 @@ import { existsSync as existsSync2, renameSync } from "node:fs";
 import { app } from "electron";
 
 // src/updater/index.ts
-import { EventEmitter } from "node:events";
-import { Buffer as Buffer2 } from "node:buffer";
 import { existsSync } from "node:fs";
+import { Buffer as Buffer2 } from "node:buffer";
 import { rm, writeFile } from "node:fs/promises";
 
 // src/updater/defaultFunctions.ts
 import { Buffer } from "node:buffer";
 import { net } from "electron";
-async function downloadJSONDefault(url, updater, headers) {
+var downloadJSONDefault = async (url, headers) => {
   await waitAppReady();
   return new Promise((resolve2, reject) => {
     const request = net.request({
@@ -58,10 +61,10 @@ async function downloadJSONDefault(url, updater, headers) {
     });
     request.end();
   });
-}
-async function downloadBufferDefault(url, updater, headers) {
+};
+var downloadBufferDefault = async (url, headers, total, onDownloading) => {
   await waitAppReady();
-  let progress = 0;
+  let current = 0;
   return new Promise((resolve2, reject) => {
     const request = net.request({
       url,
@@ -74,8 +77,12 @@ async function downloadBufferDefault(url, updater, headers) {
     request.on("response", (res) => {
       let data = [];
       res.on("data", (chunk) => {
-        progress += chunk.length;
-        updater.emit("downloading", progress);
+        current += chunk.length;
+        onDownloading?.({
+          percent: `${+(current / total).toFixed(2) * 100}%`,
+          total,
+          current
+        });
         data.push(chunk);
       });
       res.on("end", () => {
@@ -86,15 +93,24 @@ async function downloadBufferDefault(url, updater, headers) {
     });
     request.end();
   });
-}
-var compareVersionDefault = (oldVersion, newVersion) => {
-  const oldV = parseVersion(oldVersion);
-  const newV = parseVersion(newVersion);
-  if (oldV.major < newV.major || oldV.major === newV.major && oldV.minor < newV.minor || oldV.major === newV.major && oldV.minor === newV.minor && oldV.patch < newV.patch) {
-    return true;
+};
+var compareVersionDefault = (version1, version2) => {
+  const oldV = parseVersion(version1);
+  const newV = parseVersion(version2);
+  function compareStrings(str1, str2) {
+    if (str1 === "") {
+      return str2 !== "";
+    } else if (str2 === "") {
+      return true;
+    }
+    return str1 < str2;
   }
-  if (oldV.stage < newV.stage || !newV.stage && oldV.stage) {
-    return true;
+  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;
 };
@@ -118,158 +134,151 @@ var VerifyFailedError = class extends Error {
     this.cert = cert;
   }
 };
-function createUpdater(updaterOptions) {
-  const {
-    SIGNATURE_CERT,
-    repository,
-    productName,
-    releaseAsarURL: _release,
-    updateJsonURL: _update,
-    debug = false,
-    receiveBeta = false,
-    downloadConfig: { extraHeader, userAgent } = {},
-    overrideFunctions: {
-      compareVersion,
-      verifySignaure,
-      downloadBuffer,
-      downloadJSON
-    } = {}
-  } = updaterOptions;
-  const updater = new EventEmitter();
-  let signature;
-  let version;
-  const asarPath = getProductAsarPath(productName);
-  const gzipPath = `${asarPath}.gz`;
-  const tmpFilePath = `${asarPath}.tmp`;
-  function log(msg) {
-    debug && updater.emit("debug", msg);
+var IncrementalUpdater = class {
+  info;
+  option;
+  asarPath;
+  gzipPath;
+  tmpFilePath;
+  logger;
+  onDownloading;
+  get productName() {
+    return this.option.productName;
+  }
+  set productName(name) {
+    this.option.productName = name;
+  }
+  get receiveBeta() {
+    return !!this.option.receiveBeta;
+  }
+  set receiveBeta(receiveBeta) {
+    this.option.receiveBeta = receiveBeta;
   }
-  async function needUpdate(version2, minVersion) {
-    const compare = compareVersion ?? compareVersionDefault;
-    const productVersion = getProductVersion(productName);
+  constructor(option) {
+    this.option = option;
+    this.asarPath = getProductAsarPath(this.productName);
+    this.gzipPath = `${this.asarPath}.gz`;
+    this.tmpFilePath = `${this.asarPath}.tmp`;
+  }
+  async needUpdate(version, minVersion) {
+    const compare = this.option.overrideFunctions?.compareVersion ?? compareVersionDefault;
+    const productVersion = getProductVersion(this.option.productName);
     const entryVersion = getEntryVersion();
     if (await compare(entryVersion, minVersion)) {
       throw new MinimumVersionError(entryVersion, minVersion);
     }
-    log(`check update: current version is ${productVersion}, new version is ${version2}`);
-    return await compare(productVersion, version2);
+    this.logger?.info(`check update: current version is ${productVersion}, new version is ${version}`);
+    return await compare(productVersion, version);
   }
-  async function parseData(format, data, version2) {
-    if (existsSync(tmpFilePath)) {
-      log(`remove tmp file: ${tmpFilePath}`);
-      await rm(tmpFilePath);
+  async parseData(format, data) {
+    if (existsSync(this.tmpFilePath)) {
+      this.logger?.warn(`remove tmp file: ${this.tmpFilePath}`);
+      await rm(this.tmpFilePath);
+    }
+    if (existsSync(this.gzipPath)) {
+      this.logger?.warn(`remove .gz file: ${this.gzipPath}`);
+      await rm(this.gzipPath);
+    }
+    if (!["string", "object", "undefined"].includes(typeof data)) {
+      throw new TypeError(`invalid type at format '${format}': ${data}`);
     }
-    if (existsSync(gzipPath)) {
-      log(`remove .gz file: ${gzipPath}`);
-      await rm(gzipPath);
+    if (typeof data === "object" && (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer2.isBuffer(data))) {
+      return data;
     }
     if (typeof data === "object") {
-      if (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer2.isBuffer(data)) {
-        return data;
-      } else {
-        throw new TypeError(`invalid type at format '${format}': ${data}`);
-      }
-    } else if (["string", "undefined"].includes(typeof data)) {
-      const ua = userAgent || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36";
-      const headers = {
-        Accept: `application/${format === "json" ? "json" : "octet-stream"}`,
-        UserAgent: ua,
-        ...extraHeader
-      };
-      log(`download headers: ${JSON.stringify(headers, null, 2)}`);
-      const info = format === "json" ? {
-        name: "updateJsonURL",
-        url: _update,
-        repoFallback: `${repository.replace("github.com", "raw.githubusercontent.com")}/master/version.json`,
-        fn: downloadJSON ?? downloadJSONDefault
-      } : {
-        name: "releaseAsarURL",
-        url: _release,
-        repoFallback: `${repository}/releases/download/v${version2}/${productName}-${version2}.asar.gz`,
-        fn: downloadBuffer ?? downloadBufferDefault
-      };
-      data ??= info.url;
-      if (!data) {
-        log(`no ${info.name}, fallback to use repository`);
-        if (!repository) {
-          throw new Error(`${info.name} or repository are not set`);
-        }
-        if (format === "buffer" && !version2) {
-          throw new Error("version are not set");
-        }
-        data = info.repoFallback;
+      throw new TypeError(`invalid type at format '${format}': ${data}`);
+    }
+    const ua = this.option.downloadConfig?.userAgent || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36";
+    const headers = {
+      Accept: `application/${format === "json" ? "json" : "octet-stream"}`,
+      UserAgent: ua,
+      ...this.option.downloadConfig?.extraHeader
+    };
+    this.logger?.info(`download headers: ${JSON.stringify(headers, null, 2)}`);
+    const config = format === "json" ? {
+      name: "updateJsonURL",
+      url: this.option.updateJsonURL,
+      repoFallback: `${this.option.repository.replace("github.com", "raw.githubusercontent.com")}/master/version.json`,
+      fn: this.option.overrideFunctions?.downloadJSON ?? downloadJSONDefault
+    } : {
+      name: "releaseAsarURL",
+      url: this.option.releaseAsarURL,
+      repoFallback: `${this.option.repository}/releases/download/v${this.info?.version}/${this.productName}-${this.info?.version}.asar.gz`,
+      fn: this.option.overrideFunctions?.downloadBuffer ?? downloadBufferDefault
+    };
+    data ??= config.url;
+    if (!data) {
+      this.logger?.debug(`no ${config.name}, fallback to use repository`);
+      if (!this.option.repository) {
+        throw new Error(`${config.name} or repository are not set`);
       }
-      log(`download ${format} from ${data}`);
-      const ret = await info.fn(data, updater, headers);
-      log(`download ${format} success${format === "buffer" ? `, file size: ${ret.length}` : ""}`);
-      if (format === "buffer") {
-        updater.emit("downloadBuffer", ret);
+      if (format === "buffer" && !this.info?.version) {
+        throw new Error("version are not set");
       }
-      return ret;
-    } else {
-      throw new TypeError(`invalid type at format '${format}': ${data}`);
+      data = config.repoFallback;
     }
+    this.logger?.info(`download ${format} from ${data}`);
+    const ret = format === "json" ? await config.fn(data, headers) : await config.fn(data, headers, this.info.size, this.onDownloading);
+    this.logger?.info(`download ${format} success${format === "buffer" ? `, file size: ${ret.length}` : ""}`);
+    return ret;
   }
-  updater.productName = productName;
-  updater.debug = debug;
-  updater.receiveBeta = receiveBeta;
-  updater.checkUpdate = async (data) => {
+  async checkUpdate(data) {
     try {
-      let {
-        signature: _sig,
-        size,
-        version: _ver,
-        minimumVersion,
-        beta
-      } = await parseData("json", data);
-      if (receiveBeta) {
-        _ver = beta.version;
-        _sig = beta.signature;
+      let { signature, size, version, minimumVersion, beta } = await this.parseData("json", data);
+      if (this.receiveBeta) {
+        version = beta.version;
+        signature = beta.signature;
         minimumVersion = beta.minimumVersion;
         size = beta.size;
       }
-      log(`checked version: ${_ver}, size: ${size}, signature: ${_sig}`);
-      if (!await needUpdate(_ver, minimumVersion)) {
-        log(`update unavailable: ${_ver}`);
+      this.logger?.info(`checked version: ${version}, size: ${size}, signature: ${signature}`);
+      if (!await this.needUpdate(version, minimumVersion)) {
+        this.logger?.info(`update unavailable: ${version} is the latest version`);
         return void 0;
       } else {
-        log(`update available: ${_ver}`);
-        signature = _sig;
-        version = _ver;
-        return { size, version: _ver };
+        this.logger?.info(`update available: ${version}`);
+        this.info = {
+          signature,
+          minimumVersion,
+          version,
+          size
+        };
+        return { size, version };
       }
     } catch (error) {
-      log(error);
+      this.logger?.error("check update failed", error);
       return error;
     }
-  };
-  updater.download = async (data, sig) => {
+  }
+  async download(data, sig) {
     try {
-      const _sig = sig ?? signature;
+      const _sig = sig ?? this.info?.signature;
       if (!_sig) {
         throw new Error("signature are not set, please checkUpdate first or set the second parameter");
       }
-      const buffer = await parseData("buffer", data, version);
-      log("verify start");
-      const _verify = verifySignaure ?? verify;
-      const _ver = await _verify(buffer, _sig, SIGNATURE_CERT);
+      const buffer = await this.parseData("buffer", data);
+      this.logger?.info("verify start");
+      const _verify = this.option.overrideFunctions?.verifySignaure ?? verify;
+      const _ver = await _verify(buffer, _sig, this.option.SIGNATURE_CERT);
       if (!_ver) {
-        throw new VerifyFailedError(_sig, SIGNATURE_CERT);
+        throw new VerifyFailedError(_sig, this.option.SIGNATURE_CERT);
       }
-      log("verify success");
-      log(`write to ${gzipPath}`);
-      await writeFile(gzipPath, buffer);
-      log(`extract to ${tmpFilePath}`);
-      await unzipFile(gzipPath, tmpFilePath);
-      log(`download success, version: ${_ver}`);
-      signature = "";
+      this.logger?.info("verify success");
+      this.logger?.info(`write to ${this.gzipPath}`);
+      await writeFile(this.gzipPath, buffer);
+      this.logger?.info(`extract to ${this.tmpFilePath}`);
+      await unzipFile(this.gzipPath, this.tmpFilePath);
+      this.logger?.info(`download success${typeof _ver === "string" ? `, version: ${_ver}` : ""}`);
+      this.info = void 0;
       return true;
     } catch (error) {
-      log(error);
+      this.logger?.error("download asar failed", error);
       return error;
     }
-  };
-  return updater;
+  }
+};
+function createUpdater(option) {
+  return new IncrementalUpdater(option);
 }
 
 // src/index.ts
@@ -315,6 +324,7 @@ function initApp(appOptions) {
   };
 }
 export {
+  IncrementalUpdater,
   MinimumVersionError,
   VerifyFailedError,
   createUpdater,

package/dist/{updateJson-7e45d9e1.d.ts → updateJson.d.mts}

@@ -7,5 +7,6 @@ type UpdateInfo = {
 type UpdateJSON = UpdateInfo & {
     beta: UpdateInfo;
 };
+declare function isUpdateJSON(json: any): json is UpdateJSON;
 
-export { UpdateJSON as U };
+export { UpdateInfo, UpdateJSON, isUpdateJSON };

package/dist/updateJson.d.ts

@@ -0,0 +1,12 @@
+type UpdateInfo = {
+    signature: string;
+    minimumVersion: string;
+    version: string;
+    size: number;
+};
+type UpdateJSON = UpdateInfo & {
+    beta: UpdateInfo;
+};
+declare function isUpdateJSON(json: any): json is UpdateJSON;
+
+export { UpdateInfo, UpdateJSON, isUpdateJSON };

package/dist/updateJson.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/updateJson.ts
+var updateJson_exports = {};
+__export(updateJson_exports, {
+  isUpdateJSON: () => isUpdateJSON
+});
+module.exports = __toCommonJS(updateJson_exports);
+function isUpdateJSON(json) {
+  const is = (j) => "signature" in j && "version" in j && "size" in j && "minimumVersion" in j;
+  return is(json) && "beta" in json && is(json.beta);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isUpdateJSON
+});

package/dist/updateJson.mjs

@@ -0,0 +1,7 @@
+import {
+  isUpdateJSON
+} from "./chunk-2JVXVTC5.mjs";
+import "./chunk-ZFXKCRJC.mjs";
+export {
+  isUpdateJSON
+};

package/dist/utils.d.mts

@@ -9,6 +9,8 @@ declare function getProductAsarPath(name: string): string;
 declare function getEntryVersion(): string;
 /**
  * get the version of application (name.asar)
+ *
+ * if is dev, return {@link getEntryVersion}
  * @param name - The name of the application
  */
 declare function getProductVersion(name: string): string;
@@ -23,11 +25,11 @@ declare class NoSuchNativeModuleError extends Error {
  */
 declare function requireNative<T = any>(packageName: string): T;
 /**
- * get github version.json CDN URL for accelerating the speed of downloading version info
+ * parse Github CDN URL for accelerating the speed of downloading
  */
 declare function parseGithubCdnURL(repository: string, cdnPrefix: string, relativeFilePath: string): string;
 /**
- * get group of github file CDN prefix for accelerating the speed of downloading release
+ * get group of Github file CDN prefix for accelerating the speed of downloading project files
  */
 declare function getGithubFileCdnGroup(): {
     cdnPrefix: string;
@@ -40,16 +42,24 @@ declare function getGithubReleaseCdnGroup(): {
     cdnPrefix: string;
     source: string;
 }[];
+/**
+ * Restarts the Electron app.
+ */
 declare function restartApp(): void;
-declare function waitAppReady(duration?: number): Promise<unknown>;
-declare function unzipFile(gzipPath: string, targetFilePath: string): Promise<unknown>;
+/**
+ * ensure app is ready.
+ */
+declare function waitAppReady(duration?: number): Promise<void>;
+declare function unzipFile(gzipPath: string, targetFilePath?: string): Promise<unknown>;
 declare function zipFile(filePath: string, targetFilePath?: string): Promise<unknown>;
 declare function handleUnexpectedErrors(callback: (err: Error) => void): void;
-declare function parseVersion(version: string): {
+interface Version {
     major: number;
     minor: number;
     patch: number;
     stage: string;
-};
+    stageVersion: number;
+}
+declare function parseVersion(version: string): Version;
 
-export { NoSuchNativeModuleError, getEntryVersion, getGithubFileCdnGroup, getGithubReleaseCdnGroup, getProductAsarPath, getProductVersion, handleUnexpectedErrors, parseGithubCdnURL, parseVersion, requireNative, restartApp, unzipFile, waitAppReady, zipFile };
+export { NoSuchNativeModuleError, Version, getEntryVersion, getGithubFileCdnGroup, getGithubReleaseCdnGroup, getProductAsarPath, getProductVersion, handleUnexpectedErrors, parseGithubCdnURL, parseVersion, requireNative, restartApp, unzipFile, waitAppReady, zipFile };

package/dist/utils.d.ts

@@ -9,6 +9,8 @@ declare function getProductAsarPath(name: string): string;
 declare function getEntryVersion(): string;
 /**
  * get the version of application (name.asar)
+ *
+ * if is dev, return {@link getEntryVersion}
  * @param name - The name of the application
  */
 declare function getProductVersion(name: string): string;
@@ -23,11 +25,11 @@ declare class NoSuchNativeModuleError extends Error {
  */
 declare function requireNative<T = any>(packageName: string): T;
 /**
- * get github version.json CDN URL for accelerating the speed of downloading version info
+ * parse Github CDN URL for accelerating the speed of downloading
  */
 declare function parseGithubCdnURL(repository: string, cdnPrefix: string, relativeFilePath: string): string;
 /**
- * get group of github file CDN prefix for accelerating the speed of downloading release
+ * get group of Github file CDN prefix for accelerating the speed of downloading project files
  */
 declare function getGithubFileCdnGroup(): {
     cdnPrefix: string;
@@ -40,16 +42,24 @@ declare function getGithubReleaseCdnGroup(): {
     cdnPrefix: string;
     source: string;
 }[];
+/**
+ * Restarts the Electron app.
+ */
 declare function restartApp(): void;
-declare function waitAppReady(duration?: number): Promise<unknown>;
-declare function unzipFile(gzipPath: string, targetFilePath: string): Promise<unknown>;
+/**
+ * ensure app is ready.
+ */
+declare function waitAppReady(duration?: number): Promise<void>;
+declare function unzipFile(gzipPath: string, targetFilePath?: string): Promise<unknown>;
 declare function zipFile(filePath: string, targetFilePath?: string): Promise<unknown>;
 declare function handleUnexpectedErrors(callback: (err: Error) => void): void;
-declare function parseVersion(version: string): {
+interface Version {
     major: number;
     minor: number;
     patch: number;
     stage: string;
-};
+    stageVersion: number;
+}
+declare function parseVersion(version: string): Version;
 
-export { NoSuchNativeModuleError, getEntryVersion, getGithubFileCdnGroup, getGithubReleaseCdnGroup, getProductAsarPath, getProductVersion, handleUnexpectedErrors, parseGithubCdnURL, parseVersion, requireNative, restartApp, unzipFile, waitAppReady, zipFile };
+export { NoSuchNativeModuleError, Version, getEntryVersion, getGithubFileCdnGroup, getGithubReleaseCdnGroup, getProductAsarPath, getProductVersion, handleUnexpectedErrors, parseGithubCdnURL, parseVersion, requireNative, restartApp, unzipFile, waitAppReady, zipFile };

package/dist/utils.js

@@ -111,11 +111,11 @@ function waitAppReady(duration = 1e3) {
     }, duration);
     import_electron.app.whenReady().then(() => {
       clearTimeout(timeout);
-      resolve(null);
+      resolve();
     });
   });
 }
-async function unzipFile(gzipPath, targetFilePath) {
+async function unzipFile(gzipPath, targetFilePath = gzipPath.slice(0, -3)) {
   if (!(0, import_node_fs.existsSync)(gzipPath)) {
     throw new Error(`path to zipped file not exist: ${gzipPath}`);
   }
@@ -161,10 +161,22 @@ function parseVersion(version) {
     throw new TypeError(`invalid version: ${version}`);
   }
   const [major, minor, patch] = match.slice(1, 4).map(Number);
-  if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+  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 (isNaN(major) || isNaN(minor) || isNaN(patch) || isNaN(ret.stageVersion)) {
     throw new TypeError(`invalid version: ${version}`);
   }
-  return { major, minor, patch, stage: match[4] };
+  return ret;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/utils.mjs

@@ -13,7 +13,8 @@ import {
   unzipFile,
   waitAppReady,
   zipFile
-} from "./chunk-SWXNCK6H.mjs";
+} from "./chunk-4TION32M.mjs";
+import "./chunk-ZFXKCRJC.mjs";
 export {
   NoSuchNativeModuleError,
   getEntryVersion,

package/dist/vite.d.mts

@@ -1,6 +1,6 @@
 import { Plugin } from 'vite';
 import { Buffer } from 'node:buffer';
-import { U as UpdateJSON } from './updateJson-7e45d9e1.js';
+import { UpdateJSON } from './updateJson.mjs';
 
 type DistinguishedName = {
     countryName?: string;
@@ -15,8 +15,26 @@ type DistinguishedName = {
     businessCategory?: string;
     emailAddress?: string;
 };
-type FunctionGenerateSignature = (buffer: Buffer, privateKey: string, cert: string, version: string) => string | Promise<string>;
-type FunctionGenerateVersionJson = (existingJson: UpdateJSON, buffer: Buffer, signature: string, version: string, minVersion: string) => UpdateJSON | Promise<UpdateJSON>;
+type GeneratorOverrideFunctions = {
+    /**
+     * custom signature generate function
+     * @param buffer file buffer
+     * @param privateKey private key
+     * @param cert certificate string, **EOL must be '\n'**
+     * @param version current version
+     */
+    generateSignature?: (buffer: Buffer, privateKey: string, cert: string, version: string) => string | Promise<string>;
+    /**
+     * custom generate version 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, buffer: Buffer, signature: string, version: string, minVersion: string) => UpdateJSON | Promise<UpdateJSON>;
+};
 type Options = {
     /**
      * whether is in build mode
@@ -123,22 +141,7 @@ type Options = {
              */
             days?: number;
         };
-        overrideFunctions?: {
-            /**
-             * custom signature generate function {@link FunctionGenerateSignature}
-             * @param buffer file buffer
-             * @param privateKey private key
-             * @param cert certificate
-             */
-            generateSignature?: FunctionGenerateSignature;
-            /**
-             * custom signature generate function {@link FunctionGenerateVersionJson}
-             * @param signature generated signature
-             * @param version currentVersion
-             * @param cert certificate
-             */
-            generateVersionJson?: FunctionGenerateVersionJson;
-        };
+        overrideFunctions?: GeneratorOverrideFunctions;
     };
 };