electron-incremental-update 0.8.0 → 0.8.2

package/README.md

@@ -1,22 +1,20 @@
 ## electron incremental updater
 
-provider a vite plugin and useful functions to generate updater and split entry file and real app
+This project provide a vite plugin, `Updater` class and some useful functions to generate incremental update.
 
-### principle
+There will be two asar in production, `app.asar` and `main.asar` (if "main" is your app's name).
 
-using two asar, `app.asar` and `main.asar` (if "main" is your app's name)
+The `app.asar` is used to load `main.asar` and initialize the `updater`. Also, all the **native modules**, which are set as `dependencies` in `package.json`, will be packaged into `app.asar` by `electron-builder`, [see usage](#use-native-modules).
 
-the `app.asar` is used to load `main.asar` and initialize the updater
-
-using RSA + Signature to sign the new `main.asar` downloaded from remote and replace the old one when verified
+The new `main.asar` downloaded from remote will be verified by presigned RSA + Signature. When pass the check and restart, the old `main.asar` will be replaced by the new one. Hooks like `beforeDoUpdate` are provided.
 
 - inspired by Obsidian's update strategy
 
 ### notice
 
-develop with [vite-plugin-electron](https://github.com/electron-vite/vite-plugin-electron), and may be effect in other electron vite frameworks
-
-**all options are documented in the jsdoc**
+- this plugin is developed with [vite-plugin-electron](https://github.com/electron-vite/vite-plugin-electron), and may be effect in other electron vite frameworks
+- **all options are documented in the jsdoc**
+- entry file's EOL will force to `\n`
 
 ## install
 
@@ -33,7 +31,7 @@ yarn add electron-incremental-update
 pnpm add electron-incremental-update
 ```
 
-## usage
+## setup
 
 base on [electron-vite-vue](https://github.com/electron-vite/electron-vite-vue)
 
@@ -52,7 +50,6 @@ src
 
 ### setup app
 
-
 ```ts
 // electron/app.ts
 import { getGithubReleaseCdnGroup, initApp, parseGithubCdnURL } from 'electron-incremental-update'
@@ -74,80 +71,11 @@ initApp({ onStart: console.log })
   })
 ```
 
-### usage in main process
-
-To utilize the electron `net` module for requesting update information, the `checkUpdate` and `download` functions must be called after the app is ready by default.
-
-However, you have the option to customize the download function when creating the updater.
-
-**NOTE: There can only be one function and should be default export in the entry file**
-
-```ts
-// electron/main/index.ts
-import type { StartupWithUpdater, Updater } from 'electron-incremental-update'
-import { getEntryVersion, getProductAsarPath, getProductVersion } from 'electron-incremental-update'
-import { app } from 'electron'
-import { name } from '../../package.json'
-
-const startup: StartupWithUpdater = (updater: Updater) => {
-  await app.whenReady()
-  console.log('\ncurrent:')
-  console.log(`\tasar path: ${getProductAsarPath(name)}`)
-  console.log(`\tentry:     ${getEntryVersion()}`)
-  console.log(`\tapp:       ${getProductVersion(name)}`)
-  updater.onDownloading = ({ percent }) => {
-    console.log(percent)
-  }
-  updater.logger = console
-  updater.checkUpdate().then(async (result) => {
-    if (result === undefined) {
-      console.log('Update Unavailable')
-    } else if (result instanceof Error) {
-      console.error(result)
-    } else {
-      console.log('new version: ', result.version)
-      const { response } = await dialog.showMessageBox({
-        type: 'info',
-        buttons: ['Download', 'Later'],
-        message: 'Application update available!',
-      })
-      response === 0 && console.log(await updater.download())
-    }
-  })
-}
-export default startup
-```
-
-### use native modules
-
-```ts
-// db.ts
-import { requireNative } from 'electron-incremental-update'
-
-const Database = requireNative<typeof import('better-sqlite3')>('better-sqlite3')
-const db = new Database(':memory:')
-db.exec(
-  'DROP TABLE IF EXISTS employees; '
-    + 'CREATE TABLE IF NOT EXISTS employees (name TEXT, salary INTEGER)',
-)
-
-db.prepare('INSERT INTO employees VALUES (:n, :s)').run({
-  n: 'James',
-  s: 50000,
-})
-
-const r = db.prepare('SELECT * from employees').all()
-console.log(r)
-// [ { name: 'James', salary: 50000 } ]
-
-db.close()
-```
-
 ### setup vite.config.ts
 
-make sure the plugin is set in the **last** build task plugin option
+make sure the plugin is set in the **last** build task
 
-- set it to preload task plugin, as the end of build task
+- for `vite-plugin-electron`, set it to `preload` (the second object in the plugin option array)
 
 ```ts
 // vite.config.ts
@@ -177,10 +105,14 @@ export default defineConfig(({ command }) => {
             // ...
           }
         },
+        // when using vite-plugin-electron-renderer
+        {
+          // ...
+        }
       ]),
-      // ... other plugins
+      //...
     ],
-    // ... other config
+    // ...
   }
 })
 ```
@@ -194,7 +126,7 @@ export default defineConfig(({ command }) => {
 }
 ```
 
-### electron-builder config
+### config electron-builder
 
 ```js
 const { name } = require('./package.json')
@@ -225,7 +157,78 @@ module.exports = {
   extraResources: [
     { from: `release/${target}`, to: target }, // <- asar file
   ],
-  publish: null,
+  publish: null, // <- disable publish
   // ...
 }
-```
+```
+
+## Usage
+
+### use in main process
+
+To use electron's `net` module for updating, the `checkUpdate` and `download` functions must be called after the app is ready by default.
+
+However, you have the option to customize the download function when creating the updater.
+
+**NOTE: There can only be one function and should be default export in the entry file**
+
+```ts
+// electron/main/index.ts
+import type { StartupWithUpdater, Updater } from 'electron-incremental-update'
+import { getEntryVersion, getProductAsarPath, getProductVersion } from 'electron-incremental-update'
+import { app } from 'electron'
+import { name } from '../../package.json'
+
+const startup: StartupWithUpdater = (updater: Updater) => {
+  await app.whenReady()
+  console.log('\ncurrent:')
+  console.log(`\tasar path: ${getProductAsarPath(name)}`)
+  console.log(`\tentry:     ${getEntryVersion()}`)
+  console.log(`\tapp:       ${getProductVersion(name)}`)
+  updater.onDownloading = ({ percent }) => {
+    console.log(percent)
+  }
+  updater.logger = console
+  updater.checkUpdate().then(async (result) => {
+    if (result === undefined) {
+      console.log('Update Unavailable')
+    } else if (result instanceof Error) {
+      console.error(result)
+    } else {
+      console.log('new version: ', result.version)
+      const { response } = await dialog.showMessageBox({
+        type: 'info',
+        buttons: ['Download', 'Later'],
+        message: 'Application update available!',
+      })
+      response === 0 && console.log(await updater.download())
+    }
+  })
+}
+export default startup
+```
+
+### use native modules
+
+```ts
+// db.ts
+import { requireNative } from 'electron-incremental-update'
+
+const Database = requireNative<typeof import('better-sqlite3')>('better-sqlite3')
+const db = new Database(':memory:')
+db.exec(
+  'DROP TABLE IF EXISTS employees; '
+    + 'CREATE TABLE IF NOT EXISTS employees (name TEXT, salary INTEGER)',
+)
+
+db.prepare('INSERT INTO employees VALUES (:n, :s)').run({
+  n: 'James',
+  s: 50000,
+})
+
+const r = db.prepare('SELECT * from employees').all()
+console.log(r)
+// [ { name: 'James', salary: 50000 } ]
+
+db.close()
+```

package/dist/{chunk-Q2K52LOG.mjs → chunk-GXZSAUBR.mjs}

@@ -1,6 +1,5 @@
 // src/crypto.ts
 import { createCipheriv, createDecipheriv, createHash, createPrivateKey, createSign, createVerify } from "node:crypto";
-import { Buffer } from "node:buffer";
 function encrypt(plainText, key2, iv) {
   const cipher = createCipheriv("aes-256-cbc", key2, iv);
   let encrypted = cipher.update(plainText, "utf8", "base64url");

package/dist/{chunk-4TION32M.mjs → chunk-WM2PHOMB.mjs}

@@ -140,7 +140,7 @@ function parseVersion(version) {
     ret.stage = stage;
     ret.stageVersion = Number(_v) || -1;
   }
-  if (isNaN(major) || isNaN(minor) || isNaN(patch) || isNaN(ret.stageVersion)) {
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
     throw new TypeError(`invalid version: ${version}`);
   }
   return ret;

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { Buffer } from 'node:buffer';
 import { UpdateJSON } from './updateJson.mjs';
 
 declare class MinimumVersionError extends Error {
@@ -14,31 +13,6 @@ declare class VerifyFailedError extends Error {
 declare class DownloadError extends Error {
     constructor(msg: string);
 }
-declare class IncrementalUpdater implements Updater {
-    private info?;
-    private option;
-    private asarPath;
-    private gzipPath;
-    private tmpFilePath;
-    logger?: Logger;
-    onDownloading?: (progress: DownloadingInfo) => void;
-    get productName(): string;
-    set productName(name: string);
-    get receiveBeta(): boolean;
-    set receiveBeta(receiveBeta: boolean);
-    constructor(option: UpdaterOption);
-    private needUpdate;
-    private parseData;
-    checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
-    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
-}
-/**
- * create updater instance
- * @param option updater option
- * @returns updater
- */
-declare function createUpdater(option: UpdaterOption): IncrementalUpdater;
-
 type CheckResultError = MinimumVersionError | DownloadError | TypeError | Error;
 type DownloadResultError = DownloadError | VerifyFailedError | TypeError | Error;
 type CheckResultType = {
@@ -67,7 +41,13 @@ type Logger = {
     error: (msg: string, e?: Error) => void;
 };
 interface Updater {
+    /**
+     * the name of the product, also the basename of the asar
+     */
     productName: string;
+    /**
+     * whether receive beta version
+     */
     receiveBeta: boolean;
     /**
      * check update info
@@ -94,6 +74,11 @@ interface Updater {
      * @param data log info
      */
     logger?: Logger;
+    /**
+     * download progress function
+     * @param progress download progress info
+     * @returns void
+     */
     onDownloading?: (progress: DownloadingInfo) => void;
 }
 type UpdaterOverrideFunctions = {
@@ -115,7 +100,6 @@ type UpdaterOverrideFunctions = {
     /**
      * custom download JSON function
      * @param url download url
-     * @param updater updater, to trigger events
      * @param header download header
      * @returns `UpdateJSON`
      */
@@ -123,8 +107,9 @@ type UpdaterOverrideFunctions = {
     /**
      * custom download buffer function
      * @param url download url
-     * @param updater updater, to trigger events
-     * @param header download header
+     * @param headers download header
+     * @param total precaculated file total size
+     * @param onDownloading on downloading callback
      * @returns `Buffer`
      */
     downloadBuffer?: (url: string, headers: Record<string, any>, total: number, onDownloading?: (progress: DownloadingInfo) => void) => Promise<Buffer>;
@@ -190,6 +175,32 @@ interface UpdaterOption {
     downloadConfig?: UpdaterDownloadConfig;
 }
 
+declare class IncrementalUpdater implements Updater {
+    private info?;
+    private option;
+    private asarPath;
+    private gzipPath;
+    private tmpFilePath;
+    logger?: Logger;
+    onDownloading?: (progress: DownloadingInfo) => void;
+    get productName(): string;
+    set productName(name: string);
+    get receiveBeta(): boolean;
+    set receiveBeta(receiveBeta: boolean);
+    constructor(option: UpdaterOption);
+    private needUpdate;
+    private parseData;
+    checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
+    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
+}
+/**
+ * create updater instance
+ * @param option updater option
+ * @returns updater
+ */
+declare function createUpdater(option: UpdaterOption): IncrementalUpdater;
+
+type Promisable<T> = T | Promise<T>;
 type AppOption = {
     /**
      * path of electron output dist when in development
@@ -204,12 +215,15 @@ type AppOption = {
     hooks?: {
         /**
          * hooks before replace the old asar is replaced by the new asar
+         *
+         * @param oldAsarPath old asar path
+         * @param updateTempAsarPath new asar path, end with .tmp
          */
-        beforeDoUpdate?: (updateTempAsarPath: string) => void | Promise<void>;
+        beforeDoUpdate?: (oldAsarPath: string, updateTempAsarPath: string) => Promisable<void>;
         /**
-         * hooks on start up
+         * hooks before start up
          */
-        onStart?: (productAsarPath: string) => void;
+        beforeStart?: (productAsarPath: string) => Promisable<void>;
         /**
          * hooks on start up error
          */
@@ -221,7 +235,7 @@ type SetUpdater = {
     /**
      * set updater option or create function
      */
-    setUpdater: (updater: (() => Updater | Promise<Updater>) | UpdaterOption) => void;
+    setUpdater: (updater: (() => Promisable<Updater>) | UpdaterOption) => void;
 };
 /**
  * initialize app
@@ -247,4 +261,4 @@ type SetUpdater = {
  */
 declare function initApp(appOptions?: AppOption): SetUpdater;
 
-export { AppOption, DownloadError, IncrementalUpdater, MinimumVersionError, StartupWithUpdater, Updater, UpdaterOption, VerifyFailedError, createUpdater, initApp };
+export { AppOption, IncrementalUpdater, StartupWithUpdater, Updater, UpdaterOption, createUpdater, initApp };

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { Buffer } from 'node:buffer';
 import { UpdateJSON } from './updateJson.js';
 
 declare class MinimumVersionError extends Error {
@@ -14,31 +13,6 @@ declare class VerifyFailedError extends Error {
 declare class DownloadError extends Error {
     constructor(msg: string);
 }
-declare class IncrementalUpdater implements Updater {
-    private info?;
-    private option;
-    private asarPath;
-    private gzipPath;
-    private tmpFilePath;
-    logger?: Logger;
-    onDownloading?: (progress: DownloadingInfo) => void;
-    get productName(): string;
-    set productName(name: string);
-    get receiveBeta(): boolean;
-    set receiveBeta(receiveBeta: boolean);
-    constructor(option: UpdaterOption);
-    private needUpdate;
-    private parseData;
-    checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
-    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
-}
-/**
- * create updater instance
- * @param option updater option
- * @returns updater
- */
-declare function createUpdater(option: UpdaterOption): IncrementalUpdater;
-
 type CheckResultError = MinimumVersionError | DownloadError | TypeError | Error;
 type DownloadResultError = DownloadError | VerifyFailedError | TypeError | Error;
 type CheckResultType = {
@@ -67,7 +41,13 @@ type Logger = {
     error: (msg: string, e?: Error) => void;
 };
 interface Updater {
+    /**
+     * the name of the product, also the basename of the asar
+     */
     productName: string;
+    /**
+     * whether receive beta version
+     */
     receiveBeta: boolean;
     /**
      * check update info
@@ -94,6 +74,11 @@ interface Updater {
      * @param data log info
      */
     logger?: Logger;
+    /**
+     * download progress function
+     * @param progress download progress info
+     * @returns void
+     */
     onDownloading?: (progress: DownloadingInfo) => void;
 }
 type UpdaterOverrideFunctions = {
@@ -115,7 +100,6 @@ type UpdaterOverrideFunctions = {
     /**
      * custom download JSON function
      * @param url download url
-     * @param updater updater, to trigger events
      * @param header download header
      * @returns `UpdateJSON`
      */
@@ -123,8 +107,9 @@ type UpdaterOverrideFunctions = {
     /**
      * custom download buffer function
      * @param url download url
-     * @param updater updater, to trigger events
-     * @param header download header
+     * @param headers download header
+     * @param total precaculated file total size
+     * @param onDownloading on downloading callback
      * @returns `Buffer`
      */
     downloadBuffer?: (url: string, headers: Record<string, any>, total: number, onDownloading?: (progress: DownloadingInfo) => void) => Promise<Buffer>;
@@ -190,6 +175,32 @@ interface UpdaterOption {
     downloadConfig?: UpdaterDownloadConfig;
 }
 
+declare class IncrementalUpdater implements Updater {
+    private info?;
+    private option;
+    private asarPath;
+    private gzipPath;
+    private tmpFilePath;
+    logger?: Logger;
+    onDownloading?: (progress: DownloadingInfo) => void;
+    get productName(): string;
+    set productName(name: string);
+    get receiveBeta(): boolean;
+    set receiveBeta(receiveBeta: boolean);
+    constructor(option: UpdaterOption);
+    private needUpdate;
+    private parseData;
+    checkUpdate(data?: string | UpdateJSON): Promise<CheckResultType>;
+    download(data?: string | Buffer, sig?: string): Promise<DownloadResult>;
+}
+/**
+ * create updater instance
+ * @param option updater option
+ * @returns updater
+ */
+declare function createUpdater(option: UpdaterOption): IncrementalUpdater;
+
+type Promisable<T> = T | Promise<T>;
 type AppOption = {
     /**
      * path of electron output dist when in development
@@ -204,12 +215,15 @@ type AppOption = {
     hooks?: {
         /**
          * hooks before replace the old asar is replaced by the new asar
+         *
+         * @param oldAsarPath old asar path
+         * @param updateTempAsarPath new asar path, end with .tmp
          */
-        beforeDoUpdate?: (updateTempAsarPath: string) => void | Promise<void>;
+        beforeDoUpdate?: (oldAsarPath: string, updateTempAsarPath: string) => Promisable<void>;
         /**
-         * hooks on start up
+         * hooks before start up
          */
-        onStart?: (productAsarPath: string) => void;
+        beforeStart?: (productAsarPath: string) => Promisable<void>;
         /**
          * hooks on start up error
          */
@@ -221,7 +235,7 @@ type SetUpdater = {
     /**
      * set updater option or create function
      */
-    setUpdater: (updater: (() => Updater | Promise<Updater>) | UpdaterOption) => void;
+    setUpdater: (updater: (() => Promisable<Updater>) | UpdaterOption) => void;
 };
 /**
  * initialize app
@@ -247,4 +261,4 @@ type SetUpdater = {
  */
 declare function initApp(appOptions?: AppOption): SetUpdater;
 
-export { AppOption, DownloadError, IncrementalUpdater, MinimumVersionError, StartupWithUpdater, Updater, UpdaterOption, VerifyFailedError, createUpdater, initApp };
+export { AppOption, IncrementalUpdater, StartupWithUpdater, Updater, UpdaterOption, createUpdater, initApp };

package/dist/index.js

@@ -20,10 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  DownloadError: () => DownloadError,
   IncrementalUpdater: () => IncrementalUpdater,
-  MinimumVersionError: () => MinimumVersionError,
-  VerifyFailedError: () => VerifyFailedError,
   createUpdater: () => createUpdater,
   initApp: () => initApp
 });
@@ -34,7 +31,6 @@ var import_electron3 = require("electron");
 
 // src/updater/index.ts
 var import_node_fs2 = require("fs");
-var import_node_buffer3 = require("buffer");
 var import_promises = require("fs/promises");
 
 // src/utils.ts
@@ -97,7 +93,7 @@ function parseVersion(version) {
     ret.stage = stage;
     ret.stageVersion = Number(_v) || -1;
   }
-  if (isNaN(major) || isNaN(minor) || isNaN(patch) || isNaN(ret.stageVersion)) {
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
     throw new TypeError(`invalid version: ${version}`);
   }
   return ret;
@@ -105,7 +101,6 @@ function parseVersion(version) {
 
 // src/crypto.ts
 var import_node_crypto = require("crypto");
-var import_node_buffer = require("buffer");
 function decrypt(encryptedText, key2, iv) {
   const decipher = (0, import_node_crypto.createDecipheriv)("aes-256-cbc", key2, iv);
   let decrypted = decipher.update(encryptedText, "base64url", "utf8");
@@ -114,7 +109,7 @@ function decrypt(encryptedText, key2, iv) {
 }
 function key(data, length) {
   const hash = (0, import_node_crypto.createHash)("SHA256").update(data).digest("binary");
-  return import_node_buffer.Buffer.from(hash).subarray(0, length);
+  return Buffer.from(hash).subarray(0, length);
 }
 var verify = (buffer, signature, cert) => {
   try {
@@ -132,8 +127,32 @@ function isUpdateJSON(json) {
   return is(json) && "beta" in json && is(json.beta);
 }
 
+// src/updater/types.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;
+  }
+};
+var DownloadError = class extends Error {
+  constructor(msg) {
+    super(`download update error, ${msg}`);
+  }
+};
+
 // src/updater/defaultFunctions.ts
-var import_node_buffer2 = require("buffer");
 var import_electron2 = require("electron");
 var downloadJSONDefault = async (url, headers) => {
   await waitAppReady();
@@ -192,7 +211,7 @@ var downloadBufferDefault = async (url, headers, total, onDownloading) => {
         data.push(chunk);
       });
       res.on("end", () => {
-        resolve2(import_node_buffer2.Buffer.concat(data));
+        resolve2(Buffer.concat(data));
       });
     }).on("error", (e) => {
       reject(e);
@@ -222,29 +241,6 @@ var compareVersionDefault = (version1, version2) => {
 };
 
 // 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;
-  }
-};
-var DownloadError = class extends Error {
-  constructor(msg) {
-    super(`download update error, ${msg}`);
-  }
-};
 var IncrementalUpdater = class {
   info;
   option;
@@ -293,7 +289,7 @@ var IncrementalUpdater = class {
     if (!["string", "object", "undefined"].includes(typeof data)) {
       throw new TypeError(`invalid type at format '${format}': ${data}`);
     }
-    if (typeof data === "object" && (format === "json" && isUpdateJSON(data) || format === "buffer" && import_node_buffer3.Buffer.isBuffer(data))) {
+    if (typeof data === "object" && (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer.isBuffer(data))) {
       return data;
     }
     if (typeof data === "object") {
@@ -405,7 +401,7 @@ function initApp(appOptions) {
   } = appOptions || {};
   const {
     beforeDoUpdate,
-    onStart,
+    beforeStart,
     onStartError
   } = hooks || {};
   function handleError(msg) {
@@ -415,13 +411,14 @@ function initApp(appOptions) {
   async function startup(updater) {
     try {
       const asarPath = getProductAsarPath(updater.productName);
-      if ((0, import_node_fs3.existsSync)(`${asarPath}.tmp`)) {
-        await beforeDoUpdate?.(asarPath);
-        (0, import_node_fs3.renameSync)(`${asarPath}.tmp`, asarPath);
+      const updateAsarPath = `${asarPath}.tmp`;
+      if ((0, import_node_fs3.existsSync)(updateAsarPath)) {
+        await beforeDoUpdate?.(asarPath, updateAsarPath);
+        (0, import_node_fs3.renameSync)(updateAsarPath, asarPath);
       }
       const mainDir = import_electron3.app.isPackaged ? asarPath : electronDevDistPath;
       const entry = (0, import_node_path2.resolve)(__dirname, mainDir, mainPath);
-      onStart?.(entry);
+      await beforeStart?.(entry);
       require(entry)(updater);
     } catch (error) {
       handleError(`failed to start app, ${error}`);
@@ -445,10 +442,7 @@ function initApp(appOptions) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  DownloadError,
   IncrementalUpdater,
-  MinimumVersionError,
-  VerifyFailedError,
   createUpdater,
   initApp
 });

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   verify
-} from "./chunk-Q2K52LOG.mjs";
+} from "./chunk-GXZSAUBR.mjs";
 import {
   getEntryVersion,
   getProductAsarPath,
@@ -8,7 +8,7 @@ import {
   parseVersion,
   unzipFile,
   waitAppReady
-} from "./chunk-4TION32M.mjs";
+} from "./chunk-WM2PHOMB.mjs";
 import {
   isUpdateJSON
 } from "./chunk-2JVXVTC5.mjs";
@@ -23,11 +23,34 @@ import { app } from "electron";
 
 // src/updater/index.ts
 import { existsSync } from "node:fs";
-import { Buffer as Buffer2 } from "node:buffer";
 import { rm, writeFile } from "node:fs/promises";
 
+// src/updater/types.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;
+  }
+};
+var DownloadError = class extends Error {
+  constructor(msg) {
+    super(`download update error, ${msg}`);
+  }
+};
+
 // src/updater/defaultFunctions.ts
-import { Buffer } from "node:buffer";
 import { net } from "electron";
 var downloadJSONDefault = async (url, headers) => {
   await waitAppReady();
@@ -116,29 +139,6 @@ var compareVersionDefault = (version1, version2) => {
 };
 
 // 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;
-  }
-};
-var DownloadError = class extends Error {
-  constructor(msg) {
-    super(`download update error, ${msg}`);
-  }
-};
 var IncrementalUpdater = class {
   info;
   option;
@@ -187,7 +187,7 @@ var IncrementalUpdater = class {
     if (!["string", "object", "undefined"].includes(typeof data)) {
       throw new TypeError(`invalid type at format '${format}': ${data}`);
     }
-    if (typeof data === "object" && (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer2.isBuffer(data))) {
+    if (typeof data === "object" && (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer.isBuffer(data))) {
       return data;
     }
     if (typeof data === "object") {
@@ -299,7 +299,7 @@ function initApp(appOptions) {
   } = appOptions || {};
   const {
     beforeDoUpdate,
-    onStart,
+    beforeStart,
     onStartError
   } = hooks || {};
   function handleError(msg) {
@@ -309,13 +309,14 @@ function initApp(appOptions) {
   async function startup(updater) {
     try {
       const asarPath = getProductAsarPath(updater.productName);
-      if (existsSync2(`${asarPath}.tmp`)) {
-        await beforeDoUpdate?.(asarPath);
-        renameSync(`${asarPath}.tmp`, asarPath);
+      const updateAsarPath = `${asarPath}.tmp`;
+      if (existsSync2(updateAsarPath)) {
+        await beforeDoUpdate?.(asarPath, updateAsarPath);
+        renameSync(updateAsarPath, asarPath);
       }
       const mainDir = app.isPackaged ? asarPath : electronDevDistPath;
       const entry = resolve(__dirname, mainDir, mainPath);
-      onStart?.(entry);
+      await beforeStart?.(entry);
       __require(entry)(updater);
     } catch (error) {
       handleError(`failed to start app, ${error}`);
@@ -338,10 +339,7 @@ function initApp(appOptions) {
   };
 }
 export {
-  DownloadError,
   IncrementalUpdater,
-  MinimumVersionError,
-  VerifyFailedError,
   createUpdater,
   initApp
 };

package/dist/utils.d.mts

@@ -1,6 +1,7 @@
 /**
  * get the application asar absolute path
  * @param name The name of the application
+ * @todo support v8 bytecode
  */
 declare function getProductAsarPath(name: string): string;
 /**

package/dist/utils.d.ts

@@ -1,6 +1,7 @@
 /**
  * get the application asar absolute path
  * @param name The name of the application
+ * @todo support v8 bytecode
  */
 declare function getProductAsarPath(name: string): string;
 /**

package/dist/utils.js

@@ -173,7 +173,7 @@ function parseVersion(version) {
     ret.stage = stage;
     ret.stageVersion = Number(_v) || -1;
   }
-  if (isNaN(major) || isNaN(minor) || isNaN(patch) || isNaN(ret.stageVersion)) {
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
     throw new TypeError(`invalid version: ${version}`);
   }
   return ret;

package/dist/utils.mjs

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

package/dist/vite.d.mts

@@ -1,5 +1,4 @@
 import { Plugin } from 'vite';
-import { Buffer } from 'node:buffer';
 import { UpdateJSON } from './updateJson.mjs';
 
 type DistinguishedName = {

package/dist/vite.d.ts

@@ -1,5 +1,4 @@
 import { Plugin } from 'vite';
-import { Buffer } from 'node:buffer';
 import { UpdateJSON } from './updateJson.js';
 
 type DistinguishedName = {

package/dist/vite.js

@@ -33,7 +33,6 @@ var import_esbuild = require("esbuild");
 
 // src/crypto.ts
 var import_node_crypto = require("crypto");
-var import_node_buffer = require("buffer");
 function encrypt(plainText, key2, iv) {
   const cipher = (0, import_node_crypto.createCipheriv)("aes-256-cbc", key2, iv);
   let encrypted = cipher.update(plainText, "utf8", "base64url");
@@ -42,7 +41,7 @@ function encrypt(plainText, key2, iv) {
 }
 function key(data, length) {
   const hash = (0, import_node_crypto.createHash)("SHA256").update(data).digest("binary");
-  return import_node_buffer.Buffer.from(hash).subarray(0, length);
+  return Buffer.from(hash).subarray(0, length);
 }
 var signature = (buffer, privateKey, cert, version) => {
   const sig = (0, import_node_crypto.createSign)("RSA-SHA256").update(buffer).sign((0, import_node_crypto.createPrivateKey)(privateKey), "base64");
@@ -88,7 +87,7 @@ function parseVersion(version) {
     ret.stage = stage;
     ret.stageVersion = Number(_v) || -1;
   }
-  if (isNaN(major) || isNaN(minor) || isNaN(patch) || isNaN(ret.stageVersion)) {
+  if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch) || Number.isNaN(ret.stageVersion)) {
     throw new TypeError(`invalid version: ${version}`);
   }
   return ret;
@@ -203,7 +202,7 @@ function generateKeyPair(keyLength, subject, days, privateKeyPath, certPath) {
 }
 function writeCertToMain(entryPath, cert) {
   const file = (0, import_node_fs3.readFileSync)(entryPath, "utf-8");
-  const regex = /const SIGNATURE_CERT = ['`][\s\S]*?['`]/;
+  const regex = /const SIGNATURE_CERT\s*=\s*['"`][\s\S]*?['"`]/;
   const replacement = `const SIGNATURE_CERT = \`${cert}\``;
   let replaced = file;
   const signaturePubExists = regex.test(file);

package/dist/vite.mjs

@@ -1,10 +1,10 @@
 import {
   signature
-} from "./chunk-Q2K52LOG.mjs";
+} from "./chunk-GXZSAUBR.mjs";
 import {
   parseVersion,
   zipFile
-} from "./chunk-4TION32M.mjs";
+} from "./chunk-WM2PHOMB.mjs";
 import {
   isUpdateJSON
 } from "./chunk-2JVXVTC5.mjs";
@@ -120,7 +120,7 @@ function generateKeyPair(keyLength, subject, days, privateKeyPath, certPath) {
 }
 function writeCertToMain(entryPath, cert) {
   const file = readFileSync(entryPath, "utf-8");
-  const regex = /const SIGNATURE_CERT = ['`][\s\S]*?['`]/;
+  const regex = /const SIGNATURE_CERT\s*=\s*['"`][\s\S]*?['"`]/;
   const replacement = `const SIGNATURE_CERT = \`${cert}\``;
   let replaced = file;
   const signaturePubExists = regex.test(file);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "electron-incremental-update",
   "author": "subframe7536",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "electron incremental update tools, powered by vite",
   "scripts": {
     "build": "tsup && node fix-module.js",
@@ -43,19 +43,19 @@
     "updater"
   ],
   "devDependencies": {
-    "@subframe7536/eslint-config": "^0.1.9",
-    "@types/node": "^20.3.2",
+    "@subframe7536/eslint-config": "^0.2.5",
+    "@types/node": "^20.5.1",
     "bumpp": "^9.1.1",
-    "electron": "^25.2.0",
-    "eslint": "^8.43.0",
-    "tsup": "^7.1.0",
-    "typescript": "^5.1.5",
-    "vite": "^4.3.9",
-    "vitest": "^0.32.2"
+    "electron": "^26.0.0",
+    "eslint": "^8.47.0",
+    "tsup": "^7.2.0",
+    "typescript": "^5.1.6",
+    "vitest": "^0.34.2"
   },
   "dependencies": {
     "@electron/asar": "^3.2.4",
     "ci-info": "^3.8.0",
-    "selfsigned": "^2.1.1"
+    "selfsigned": "^2.1.1",
+    "vite": "^4.4.9"
   }
 }