electron-incremental-update 0.7.7 → 0.7.8

package/dist/{chunk-Q2K52LOG.mjs → chunk-2XHZMWRR.mjs}

@@ -31,7 +31,14 @@ var verify = (buffer, signature2, cert) => {
   }
 };
 
+// src/updateJson.ts
+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);
+}
+
 export {
   signature,
-  verify
+  verify,
+  isUpdateJSON
 };

package/dist/{chunk-67MCNA7W.mjs → chunk-SWXNCK6H.mjs}

@@ -20,9 +20,20 @@ function getEntryVersion() {
 function getProductVersion(name) {
   return app.isPackaged ? readFileSync(join(getProductAsarPath(name), "version"), "utf-8") : getEntryVersion();
 }
+var NoSuchNativeModuleError = class extends Error {
+  moduleName;
+  constructor(moduleName) {
+    super(`no such native module: ${moduleName}`);
+    this.moduleName = moduleName;
+  }
+};
 function requireNative(packageName) {
   const path = app.isPackaged ? join(app.getAppPath(), "node_modules", packageName) : packageName;
-  return __require(path);
+  try {
+    return __require(path);
+  } catch (error) {
+    throw new NoSuchNativeModuleError(packageName);
+  }
 }
 function parseGithubCdnURL(repository, cdnPrefix, relativeFilePath) {
   if (!repository.startsWith("https://github.com/")) {
@@ -114,12 +125,25 @@ function handleUnexpectedErrors(callback) {
   process.on("uncaughtException", listener);
   process.on("unhandledRejection", listener);
 }
+function parseVersion(version) {
+  const semver = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9\.-]+))?/i;
+  const match = semver.exec(version);
+  if (!match) {
+    throw new TypeError(`invalid version: ${version}`);
+  }
+  const [major, minor, patch] = match.slice(1, 4).map(Number);
+  if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+    throw new TypeError(`invalid version: ${version}`);
+  }
+  return { major, minor, patch, stage: match[4] };
+}
 
 export {
   __require,
   getProductAsarPath,
   getEntryVersion,
   getProductVersion,
+  NoSuchNativeModuleError,
   requireNative,
   parseGithubCdnURL,
   getGithubFileCdnGroup,
@@ -128,5 +152,6 @@ export {
   waitAppReady,
   unzipFile,
   zipFile,
-  handleUnexpectedErrors
+  handleUnexpectedErrors,
+  parseVersion
 };

package/dist/index.d.mts

@@ -1,33 +1,47 @@
 import { Buffer } from 'node:buffer';
+import { U as UpdateJSON } from './updateJson-7e45d9e1.js';
 
-type CheckResultType = Omit<UpdateJSON, 'signature'> | undefined | Error;
-type InstallResult = true | Error;
+declare class MinimumVersionError extends Error {
+    currentVersion: string;
+    minVersion: string;
+    constructor(version: string, minimumVersion: string);
+}
+declare class VerifyFailedError extends Error {
+    signature: string;
+    cert: string;
+    constructor(signature: string, cert: string);
+}
+/**
+ * Creates an updater based on the provided options
+ */
+declare function createUpdater(updaterOptions: UpdaterOption): Updater;
+
+type CheckResultType = {
+    size: number;
+    version: string;
+} | undefined | Error | MinimumVersionError | TypeError;
+type DownloadResult = true | Error | VerifyFailedError | TypeError;
 type UpdateEvents = {
     downloading: [progress: number];
     downloadBuffer: [buffer: Buffer];
     debug: [msg: string | Error];
 };
-type UpdateJSON = {
-    signature: string;
-    version: string;
-    size: number;
-};
-type MaybeArray<T> = T extends undefined | null | never ? [] : T extends any[] ? T['length'] extends 1 ? [data: T[0]] : T : [data: T];
-interface TypedUpdater<T extends Record<string | symbol, MaybeArray<any>>, Event extends Exclude<keyof T, number> = Exclude<keyof T, number>> {
-    removeAllListeners<E extends Event>(event?: E): this;
-    listeners<E extends Event>(eventName: E): Function[];
-    eventNames(): (Event)[];
-    on<E extends Event>(eventName: E, listener: (...data: MaybeArray<T[E]>) => void): this;
-    once<E extends Event>(eventName: E, listener: (...data: MaybeArray<T[E]>) => void): this;
-    emit<E extends Event>(eventName: E, ...args: MaybeArray<T[E]>): boolean;
-    off<E extends Event>(eventName: E, listener: (...args: MaybeArray<T[E]>) => void): this;
+type Evt = Exclude<keyof UpdateEvents, number>;
+interface Updater {
+    removeAllListeners<E extends Evt>(event?: E): this;
+    listeners<E extends Evt>(eventName: E): Function[];
+    eventNames(): Evt[];
+    on<E extends Evt>(eventName: E, listener: (...data: UpdateEvents[E]) => void): this;
+    once<E extends Evt>(eventName: E, listener: (...data: UpdateEvents[E]) => void): this;
+    emit<E extends Evt>(eventName: E, ...args: UpdateEvents[E]): boolean;
+    off<E extends Evt>(eventName: E, listener: (...args: UpdateEvents[E]) => void): this;
     /**
      * check update info
      * @param data update json url
      * @returns
      * - `{size: number, version: string}`: available
      * - `false`: unavailable
-     * - `Error`: fail
+     * - `Error`: fail ({@link MinimumVersionError} or other)
      */
     checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
     /**
@@ -38,15 +52,60 @@ interface TypedUpdater<T extends Record<string | symbol, MaybeArray<any>>, Event
      * @param sig signature
      * @returns
      * - `true`: success
-     * - `Error`: fail
+     * - `Error`: fail ({@link VerifyFailedError} or other)
      */
-    download(data?: string | Buffer, sig?: string): Promise<InstallResult>;
-    debugMode: boolean;
+    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
+    debug: boolean;
     productName: string;
+    receiveBeta: boolean;
 }
-type FunctionVerifySignature = (buffer: Buffer, signature: string, cert: string) => string | false;
-type FunctionCompareVersion = (oldVersion: string, newVersion: string) => boolean;
-type Updater = TypedUpdater<UpdateEvents>;
+type FunctionVerifySignature = (buffer: Buffer, signature: string, cert: string) => string | false | Promise<string | false>;
+type FunctionCompareVersion = (oldVersion: string, newVersion: string) => boolean | Promise<boolean>;
+type FunctionDownloadBuffer = (url: string, updater: Updater, headers: Record<string, any>) => Promise<Buffer>;
+type FunctionDownloadJSON = (url: string, updater: Updater, headers: Record<string, any>) => Promise<UpdateJSON>;
+type UpdaterOverrideFunctions = {
+    /**
+     * custom version compare function {@link FunctionCompareVersion}
+     * @param oldVersion old version string
+     * @param newVersion new version string
+     * @returns whether oldVersion < newVersion
+     */
+    compareVersion?: FunctionCompareVersion;
+    /**
+     * custom verify signature function {@link FunctionVerifySignature}
+     * @param buffer file buffer
+     * @param signature signature
+     * @param cert certificate
+     */
+    verifySignaure?: FunctionVerifySignature;
+    /**
+     * custom download JSON function
+     * @param url download url
+     * @param updater updater, to trigger events
+     * @param header download header
+     * @returns `UpdateJSON`
+     */
+    downloadJSON?: FunctionDownloadJSON;
+    /**
+     * custom download buffer function
+     * @param url download url
+     * @param updater updater, to trigger events
+     * @param header download header
+     * @returns `Buffer`
+     */
+    downloadBuffer?: FunctionDownloadBuffer;
+};
+type UpdaterDownloadConfig = {
+    /**
+     * download user agent
+     * @default 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36'
+     */
+    userAgent?: string;
+    /**
+     * extra download header, `accept` and `user-agent` is set by default
+     */
+    extraHeader?: Record<string, string>;
+};
 interface UpdaterOption {
     /**
      * public key of signature, which will be auto generated by plugin
@@ -93,56 +152,14 @@ interface UpdaterOption {
      * whether to enable debug listener
      */
     debug?: boolean;
-    overrideFunctions?: {
-        /**
-         * custom version compare function {@link FunctionCompareVersion}
-         * @param oldVersion old version string
-         * @param newVersion new version string
-         * @returns whether oldVersion < newVersion
-         */
-        compareVersion?: FunctionCompareVersion;
-        /**
-         * custom verify signature function {@link FunctionVerifySignature}
-         * @param buffer file buffer
-         * @param signature signature
-         * @param cert certificate
-         */
-        verifySignaure?: FunctionVerifySignature;
-        /**
-         * custom download JSON function
-         * @param url download url
-         * @param updater updater, to trigger events
-         * @param header download header
-         * @returns `UpdateJSON`
-         */
-        downloadJSON?: (url: string, updater: Updater, headers: Record<string, any>) => Promise<UpdateJSON>;
-        /**
-         * custom download buffer function
-         * @param url download url
-         * @param updater updater, to trigger events
-         * @param header download header
-         * @returns `Buffer`
-         */
-        downloadBuffer?: (url: string, updater: Updater, headers: Record<string, any>) => Promise<Buffer>;
-    };
-    downloadConfig?: {
-        /**
-         * download user agent
-         * @default 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36'
-         */
-        userAgent?: string;
-        /**
-         * extra download header, `accept` and `user-agent` is set by default
-         */
-        extraHeader?: Record<string, string>;
-    };
+    /**
+     * whether to receive beta update
+     */
+    receiveBeta?: boolean;
+    overrideFunctions?: UpdaterOverrideFunctions;
+    downloadConfig?: UpdaterDownloadConfig;
 }
 
-/**
- * Creates an updater based on the provided options
- */
-declare function createUpdater(updaterOptions: UpdaterOption): Updater;
-
 type AppOption = {
     /**
      * path of electron output dist when in development
@@ -194,4 +211,4 @@ type SetUpdater = {
  */
 declare function initApp(appOptions?: AppOption): SetUpdater;
 
-export { AppOption, FunctionCompareVersion, FunctionVerifySignature, StartupWithUpdater, UpdateJSON, Updater, UpdaterOption, createUpdater, initApp };
+export { AppOption, FunctionCompareVersion, FunctionVerifySignature, MinimumVersionError, StartupWithUpdater, Updater, UpdaterOption, VerifyFailedError, createUpdater, initApp };

package/dist/index.d.ts

@@ -1,33 +1,47 @@
 import { Buffer } from 'node:buffer';
+import { U as UpdateJSON } from './updateJson-7e45d9e1.js';
 
-type CheckResultType = Omit<UpdateJSON, 'signature'> | undefined | Error;
-type InstallResult = true | Error;
+declare class MinimumVersionError extends Error {
+    currentVersion: string;
+    minVersion: string;
+    constructor(version: string, minimumVersion: string);
+}
+declare class VerifyFailedError extends Error {
+    signature: string;
+    cert: string;
+    constructor(signature: string, cert: string);
+}
+/**
+ * Creates an updater based on the provided options
+ */
+declare function createUpdater(updaterOptions: UpdaterOption): Updater;
+
+type CheckResultType = {
+    size: number;
+    version: string;
+} | undefined | Error | MinimumVersionError | TypeError;
+type DownloadResult = true | Error | VerifyFailedError | TypeError;
 type UpdateEvents = {
     downloading: [progress: number];
     downloadBuffer: [buffer: Buffer];
     debug: [msg: string | Error];
 };
-type UpdateJSON = {
-    signature: string;
-    version: string;
-    size: number;
-};
-type MaybeArray<T> = T extends undefined | null | never ? [] : T extends any[] ? T['length'] extends 1 ? [data: T[0]] : T : [data: T];
-interface TypedUpdater<T extends Record<string | symbol, MaybeArray<any>>, Event extends Exclude<keyof T, number> = Exclude<keyof T, number>> {
-    removeAllListeners<E extends Event>(event?: E): this;
-    listeners<E extends Event>(eventName: E): Function[];
-    eventNames(): (Event)[];
-    on<E extends Event>(eventName: E, listener: (...data: MaybeArray<T[E]>) => void): this;
-    once<E extends Event>(eventName: E, listener: (...data: MaybeArray<T[E]>) => void): this;
-    emit<E extends Event>(eventName: E, ...args: MaybeArray<T[E]>): boolean;
-    off<E extends Event>(eventName: E, listener: (...args: MaybeArray<T[E]>) => void): this;
+type Evt = Exclude<keyof UpdateEvents, number>;
+interface Updater {
+    removeAllListeners<E extends Evt>(event?: E): this;
+    listeners<E extends Evt>(eventName: E): Function[];
+    eventNames(): Evt[];
+    on<E extends Evt>(eventName: E, listener: (...data: UpdateEvents[E]) => void): this;
+    once<E extends Evt>(eventName: E, listener: (...data: UpdateEvents[E]) => void): this;
+    emit<E extends Evt>(eventName: E, ...args: UpdateEvents[E]): boolean;
+    off<E extends Evt>(eventName: E, listener: (...args: UpdateEvents[E]) => void): this;
     /**
      * check update info
      * @param data update json url
      * @returns
      * - `{size: number, version: string}`: available
      * - `false`: unavailable
-     * - `Error`: fail
+     * - `Error`: fail ({@link MinimumVersionError} or other)
      */
     checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
     /**
@@ -38,15 +52,60 @@ interface TypedUpdater<T extends Record<string | symbol, MaybeArray<any>>, Event
      * @param sig signature
      * @returns
      * - `true`: success
-     * - `Error`: fail
+     * - `Error`: fail ({@link VerifyFailedError} or other)
      */
-    download(data?: string | Buffer, sig?: string): Promise<InstallResult>;
-    debugMode: boolean;
+    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
+    debug: boolean;
     productName: string;
+    receiveBeta: boolean;
 }
-type FunctionVerifySignature = (buffer: Buffer, signature: string, cert: string) => string | false;
-type FunctionCompareVersion = (oldVersion: string, newVersion: string) => boolean;
-type Updater = TypedUpdater<UpdateEvents>;
+type FunctionVerifySignature = (buffer: Buffer, signature: string, cert: string) => string | false | Promise<string | false>;
+type FunctionCompareVersion = (oldVersion: string, newVersion: string) => boolean | Promise<boolean>;
+type FunctionDownloadBuffer = (url: string, updater: Updater, headers: Record<string, any>) => Promise<Buffer>;
+type FunctionDownloadJSON = (url: string, updater: Updater, headers: Record<string, any>) => Promise<UpdateJSON>;
+type UpdaterOverrideFunctions = {
+    /**
+     * custom version compare function {@link FunctionCompareVersion}
+     * @param oldVersion old version string
+     * @param newVersion new version string
+     * @returns whether oldVersion < newVersion
+     */
+    compareVersion?: FunctionCompareVersion;
+    /**
+     * custom verify signature function {@link FunctionVerifySignature}
+     * @param buffer file buffer
+     * @param signature signature
+     * @param cert certificate
+     */
+    verifySignaure?: FunctionVerifySignature;
+    /**
+     * custom download JSON function
+     * @param url download url
+     * @param updater updater, to trigger events
+     * @param header download header
+     * @returns `UpdateJSON`
+     */
+    downloadJSON?: FunctionDownloadJSON;
+    /**
+     * custom download buffer function
+     * @param url download url
+     * @param updater updater, to trigger events
+     * @param header download header
+     * @returns `Buffer`
+     */
+    downloadBuffer?: FunctionDownloadBuffer;
+};
+type UpdaterDownloadConfig = {
+    /**
+     * download user agent
+     * @default 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36'
+     */
+    userAgent?: string;
+    /**
+     * extra download header, `accept` and `user-agent` is set by default
+     */
+    extraHeader?: Record<string, string>;
+};
 interface UpdaterOption {
     /**
      * public key of signature, which will be auto generated by plugin
@@ -93,56 +152,14 @@ interface UpdaterOption {
      * whether to enable debug listener
      */
     debug?: boolean;
-    overrideFunctions?: {
-        /**
-         * custom version compare function {@link FunctionCompareVersion}
-         * @param oldVersion old version string
-         * @param newVersion new version string
-         * @returns whether oldVersion < newVersion
-         */
-        compareVersion?: FunctionCompareVersion;
-        /**
-         * custom verify signature function {@link FunctionVerifySignature}
-         * @param buffer file buffer
-         * @param signature signature
-         * @param cert certificate
-         */
-        verifySignaure?: FunctionVerifySignature;
-        /**
-         * custom download JSON function
-         * @param url download url
-         * @param updater updater, to trigger events
-         * @param header download header
-         * @returns `UpdateJSON`
-         */
-        downloadJSON?: (url: string, updater: Updater, headers: Record<string, any>) => Promise<UpdateJSON>;
-        /**
-         * custom download buffer function
-         * @param url download url
-         * @param updater updater, to trigger events
-         * @param header download header
-         * @returns `Buffer`
-         */
-        downloadBuffer?: (url: string, updater: Updater, headers: Record<string, any>) => Promise<Buffer>;
-    };
-    downloadConfig?: {
-        /**
-         * download user agent
-         * @default 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36'
-         */
-        userAgent?: string;
-        /**
-         * extra download header, `accept` and `user-agent` is set by default
-         */
-        extraHeader?: Record<string, string>;
-    };
+    /**
+     * whether to receive beta update
+     */
+    receiveBeta?: boolean;
+    overrideFunctions?: UpdaterOverrideFunctions;
+    downloadConfig?: UpdaterDownloadConfig;
 }
 
-/**
- * Creates an updater based on the provided options
- */
-declare function createUpdater(updaterOptions: UpdaterOption): Updater;
-
 type AppOption = {
     /**
      * path of electron output dist when in development
@@ -194,4 +211,4 @@ type SetUpdater = {
  */
 declare function initApp(appOptions?: AppOption): SetUpdater;
 
-export { AppOption, FunctionCompareVersion, FunctionVerifySignature, StartupWithUpdater, UpdateJSON, Updater, UpdaterOption, createUpdater, initApp };
+export { AppOption, FunctionCompareVersion, FunctionVerifySignature, MinimumVersionError, StartupWithUpdater, Updater, UpdaterOption, VerifyFailedError, createUpdater, initApp };

package/dist/index.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  MinimumVersionError: () => MinimumVersionError,
+  VerifyFailedError: () => VerifyFailedError,
   createUpdater: () => createUpdater,
   initApp: () => initApp
 });
@@ -68,6 +70,9 @@ function getProductAsarPath(name) {
 function getEntryVersion() {
   return import_electron.app.getVersion();
 }
+function getProductVersion(name) {
+  return import_electron.app.isPackaged ? (0, import_node_fs.readFileSync)((0, import_node_path.join)(getProductAsarPath(name), "version"), "utf-8") : getEntryVersion();
+}
 function waitAppReady(duration = 1e3) {
   return new Promise((resolve2, reject) => {
     const timeout = setTimeout(() => {
@@ -95,17 +100,28 @@ async function unzipFile(gzipPath, targetFilePath) {
     });
   });
 }
+function parseVersion(version) {
+  const semver = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9\.-]+))?/i;
+  const match = semver.exec(version);
+  if (!match) {
+    throw new TypeError(`invalid version: ${version}`);
+  }
+  const [major, minor, patch] = match.slice(1, 4).map(Number);
+  if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+    throw new TypeError(`invalid version: ${version}`);
+  }
+  return { major, minor, patch, stage: match[4] };
+}
 
-// src/updater/defaultFunctions.ts
-var import_node_buffer2 = require("buffer");
-var import_electron2 = require("electron");
-
-// src/updater/types.ts
+// src/updateJson.ts
 function isUpdateJSON(json) {
-  return "signature" in json && "version" in json && "size" in 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);
 }
 
 // src/updater/defaultFunctions.ts
+var import_node_buffer2 = require("buffer");
+var import_electron2 = require("electron");
 async function downloadJSONDefault(url, updater, headers) {
   await waitAppReady();
   return new Promise((resolve2, reject) => {
@@ -168,20 +184,6 @@ async function downloadBufferDefault(url, updater, headers) {
   });
 }
 var compareVersionDefault = (oldVersion, newVersion) => {
-  if (!oldVersion || !newVersion || typeof oldVersion !== "string" || typeof newVersion !== "string") {
-    throw new TypeError("invalid version");
-  }
-  const parseVersion = (version) => {
-    const [versionNumber, stage] = version.split("-", 2);
-    if (!versionNumber || !versionNumber.includes(".")) {
-      throw new TypeError("invalid version");
-    }
-    const [major, minor, patch] = versionNumber.split(".").map(Number);
-    if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
-      throw new TypeError("invalid version");
-    }
-    return { major, minor, patch, stage };
-  };
   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) {
@@ -194,6 +196,24 @@ var compareVersionDefault = (oldVersion, newVersion) => {
 };
 
 // src/updater/index.ts
+var MinimumVersionError = class extends Error {
+  currentVersion;
+  minVersion;
+  constructor(version, minimumVersion) {
+    super(`current entry version is ${version}, less than the minimumVersion ${minimumVersion}`);
+    this.currentVersion = version;
+    this.minVersion = minimumVersion;
+  }
+};
+var VerifyFailedError = class extends Error {
+  signature;
+  cert;
+  constructor(signature, cert) {
+    super("verify failed, invalid signature or certificate");
+    this.signature = signature;
+    this.cert = cert;
+  }
+};
 function createUpdater(updaterOptions) {
   const {
     SIGNATURE_CERT,
@@ -202,6 +222,7 @@ function createUpdater(updaterOptions) {
     releaseAsarURL: _release,
     updateJsonURL: _update,
     debug = false,
+    receiveBeta = false,
     downloadConfig: { extraHeader, userAgent } = {},
     overrideFunctions: {
       compareVersion,
@@ -219,11 +240,15 @@ function createUpdater(updaterOptions) {
   function log(msg) {
     debug && updater.emit("debug", msg);
   }
-  function needUpdate(version2) {
-    const currentVersion = getEntryVersion();
-    log(`check update: current version is ${currentVersion}, new version is ${version2}`);
-    const _compare = compareVersion ?? compareVersionDefault;
-    return _compare(currentVersion, version2);
+  async function needUpdate(version2, minVersion) {
+    const compare = compareVersion ?? compareVersionDefault;
+    const productVersion = getProductVersion(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);
   }
   async function parseData(format, data, version2) {
     if ((0, import_node_fs2.existsSync)(tmpFilePath)) {
@@ -238,7 +263,7 @@ function createUpdater(updaterOptions) {
       if (format === "json" && isUpdateJSON(data) || format === "buffer" && import_node_buffer3.Buffer.isBuffer(data)) {
         return data;
       } else {
-        throw new Error(`invalid type at format '${format}': ${data}`);
+        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";
@@ -278,16 +303,29 @@ function createUpdater(updaterOptions) {
       }
       return ret;
     } else {
-      throw new Error(`invalid type at format '${format}': ${data}`);
+      throw new TypeError(`invalid type at format '${format}': ${data}`);
     }
   }
   updater.productName = productName;
-  updater.debugMode = debug;
+  updater.debug = debug;
+  updater.receiveBeta = receiveBeta;
   updater.checkUpdate = async (data) => {
     try {
-      const { signature: _sig, size, version: _ver } = await parseData("json", data);
+      let {
+        signature: _sig,
+        size,
+        version: _ver,
+        minimumVersion,
+        beta
+      } = await parseData("json", data);
+      if (receiveBeta) {
+        _ver = beta.version;
+        _sig = beta.signature;
+        minimumVersion = beta.minimumVersion;
+        size = beta.size;
+      }
       log(`checked version: ${_ver}, size: ${size}, signature: ${_sig}`);
-      if (!needUpdate(_ver)) {
+      if (!await needUpdate(_ver, minimumVersion)) {
         log(`update unavailable: ${_ver}`);
         return void 0;
       } else {
@@ -310,9 +348,9 @@ function createUpdater(updaterOptions) {
       const buffer = await parseData("buffer", data, version);
       log("verify start");
       const _verify = verifySignaure ?? verify;
-      const _ver = _verify(buffer, _sig, SIGNATURE_CERT);
+      const _ver = await _verify(buffer, _sig, SIGNATURE_CERT);
       if (!_ver) {
-        throw new Error("verify failed, invalid signature");
+        throw new VerifyFailedError(_sig, SIGNATURE_CERT);
       }
       log("verify success");
       log(`write to ${gzipPath}`);
@@ -374,6 +412,8 @@ function initApp(appOptions) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  MinimumVersionError,
+  VerifyFailedError,
   createUpdater,
   initApp
 });