electron-incremental-update 3.0.0-beta.5 → 3.0.0

package/dist/index.cjs

@@ -1,12 +1,13 @@
-const require_version = require('./version-aPrLuz_-.cjs');
-const require_electron = require('./electron-C-qmVhAt.cjs');
-let electron = require("electron");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_crypto = require("./crypto-BSky88mL.cjs");
+const require_local = require("./local-DbXBG1D9.cjs");
+const require_electron = require("./electron-CaS0I3S2.cjs");
 let node_fs = require("node:fs");
-node_fs = require_version.__toESM(node_fs);
+node_fs = require_crypto.__toESM(node_fs, 1);
 let node_path = require("node:path");
-node_path = require_version.__toESM(node_path);
+node_path = require_crypto.__toESM(node_path, 1);
+let electron = require("electron");
 let node_events = require("node:events");
-
 //#region src/entry/types.ts
 var UpdaterError = class extends Error {
 	code;
@@ -15,12 +16,12 @@ var UpdaterError = class extends Error {
 		this.code = code;
 	}
 };
-
 //#endregion
 //#region src/entry/updater.ts
 var Updater = class extends node_events.EventEmitter {
 	CERT;
 	controller;
+	getCurrentAppVersion;
 	info;
 	tmpFilePath;
 	processing = false;
@@ -47,6 +48,7 @@ var Updater = class extends node_events.EventEmitter {
 		this.receiveBeta = options.receiveBeta;
 		this.CERT = options.SIGNATURE_CERT || __EIU_SIGNATURE_CERT__;
 		this.logger = options.logger;
+		this.getCurrentAppVersion = options.getAppVersion ?? require_electron.getAppVersion;
 		this.controller = new AbortController();
 		if (require_electron.isDev && !this.logger) {
 			this.logger = {
@@ -57,10 +59,9 @@ var Updater = class extends node_events.EventEmitter {
 			};
 			this.logger.info("No logger set, enable dev-only logger");
 		}
-		if (!this.provider) this.logger?.debug("WARN: No update provider");
 	}
 	async fetch(format, data) {
-		if (typeof data === "object") if (format === "json" && require_version.isUpdateJSON(data) || format === "buffer" && Buffer.isBuffer(data)) return data;
+		if (typeof data === "object") if (format === "json" && require_crypto.isUpdateJSON(data) || format === "buffer" && Buffer.isBuffer(data)) return data;
 		else {
 			this.err("Invalid type", "ERR_PARAM", `Invalid type at format '${format}': ${JSON.stringify(data)}`);
 			return;
@@ -90,9 +91,12 @@ var Updater = class extends node_events.EventEmitter {
 		const err = new UpdaterError(code, errorInfo);
 		this.logger?.error(`[${code}] ${msg}`, err);
 		this.cleanup();
-		this.emit("error", err);
+		if (this.listenerCount("error") > 0) this.emit("error", err);
 	}
-	async checkForUpdates(data) {
+	/**
+	* Check update info using default options
+	*/
+	async checkForUpdates() {
 		const emitUnavailable = (msg, code, info) => {
 			this.logger?.info(`[${code}] ${msg}`);
 			this.logger?.debug("Check update end");
@@ -100,18 +104,18 @@ var Updater = class extends node_events.EventEmitter {
 			this.emit("update-not-available", code, msg, info);
 			return false;
 		};
+		if (!this.provider) {
+			const msg = "No update json or provider";
+			this.err("Check update failed", "ERR_PARAM", msg);
+			return emitUnavailable(msg, "UNAVAILABLE_ERROR");
+		}
 		if (this.processing) {
 			this.logger?.info("Updater is already processing, skip check update");
 			return false;
 		}
 		this.processing = true;
 		this.logger?.debug("Check update start");
-		if (!data && !this.provider) {
-			const msg = "No update json or provider";
-			this.err("Check update failed", "ERR_PARAM", msg);
-			return emitUnavailable(msg, "UNAVAILABLE_ERROR");
-		}
-		const _data = await this.fetch("json", data);
+		const _data = await this.fetch("json");
 		if (!_data) return emitUnavailable("Failed to get update info", "UNAVAILABLE_ERROR");
 		const { signature, version, minimumVersion, url, ...rest } = this.receiveBeta ? _data.beta : _data;
 		const info = {
@@ -124,12 +128,12 @@ var Updater = class extends node_events.EventEmitter {
 			signature,
 			minimumVersion,
 			version,
-			appVersion: require_electron.getAppVersion(),
+			appVersion: this.getCurrentAppVersion(),
 			entryVersion: require_electron.getEntryVersion(),
 			...rest
 		};
 		this.logger?.debug(`Checked update, version: ${version}, signature: ${signature}`);
-		if (require_electron.isDev && !this.forceUpdate && !data) return emitUnavailable("Skip check update in dev mode. To force update, set `updater.forceUpdate` to true or call checkUpdate with UpdateJSON", "UNAVAILABLE_DEV");
+		if (require_electron.isDev && !this.forceUpdate) return emitUnavailable("Skip check update in dev mode. To force update, set `updater.forceUpdate` to `true`", "UNAVAILABLE_DEV");
 		const isLowerVersion = this.provider.isLowerVersion;
 		try {
 			if (isLowerVersion(extraVersionInfo.entryVersion, minimumVersion)) return emitUnavailable(`Entry Version (${extraVersionInfo.entryVersion}) < MinimumVersion (${minimumVersion})`, "UNAVAILABLE_VERSION", extraVersionInfo);
@@ -147,32 +151,39 @@ var Updater = class extends node_events.EventEmitter {
 			return emitUnavailable(msg, "UNAVAILABLE_ERROR", extraVersionInfo);
 		}
 	}
-	async downloadUpdate(data, info) {
+	/**
+	* Download update using default options
+	*/
+	async downloadUpdate() {
 		const emitError = (code, errorInfo) => {
 			this.err(`Download update failed`, code, errorInfo);
 			this.logger?.debug("Download update end");
 			this.processing = false;
 			return false;
 		};
+		if (!this.provider) return emitError("ERR_PARAM", "No update asar buffer and provider");
 		if (this.processing) {
 			this.logger?.info("Updater is already processing, skip download update");
 			return false;
 		}
 		this.processing = true;
 		this.logger?.debug("Download update start");
-		const _sig = info?.signature ?? this.info?.signature;
-		const _version = info?.version ?? this.info?.version;
-		if (!_sig || !_version) return emitError("ERR_PARAM", "No update signature, please call `checkUpdate` first or manually setup params");
-		if (!data && !this.provider) return emitError("ERR_PARAM", "No update asar buffer and provider");
-		const buffer = await this.fetch("buffer", data ? Buffer.from(data) : void 0);
-		if (!buffer) return emitError("ERR_PARAM", "No update asar file buffer");
+		const _sig = this.info?.signature;
+		const _version = this.info?.version;
+		if (!_sig || !_version) return emitError("ERR_PARAM", "No update signature, please call `checkUpdate` first");
+		const buffer = await this.fetch("buffer");
+		if (!buffer) {
+			this.logger?.debug("Download update end");
+			this.processing = false;
+			return false;
+		}
 		this.logger?.debug("Validation start");
-		if (!await this.provider.verifySignaure(buffer, _version, _sig, this.CERT)) return emitError("ERR_VALIDATE", "Invalid update asar file");
+		if (!await this.provider.verifySignature(buffer, _version, _sig, this.CERT)) return emitError("ERR_VALIDATE", "Invalid update asar file");
 		this.logger?.debug("Validation end");
 		try {
 			this.tmpFilePath = `${require_electron.getPathFromAppNameAsar()}.tmp`;
 			this.logger?.debug(`Install to ${this.tmpFilePath}`);
-			node_fs.default.writeFileSync(this.tmpFilePath, await this.provider.unzipFile(buffer));
+			node_fs.default.writeFileSync(this.tmpFilePath, await this.provider.decompressFile(buffer));
 			this.logger?.info(`Download success, version: ${_version}`);
 			this.info = void 0;
 			this.emit("update-downloaded");
@@ -206,7 +217,6 @@ var Updater = class extends node_events.EventEmitter {
 async function autoUpdate(updater) {
 	if (await updater.checkForUpdates() && await updater.downloadUpdate()) updater.quitAndInstall();
 }
-
 //#endregion
 //#region src/entry/core.ts
 /**
@@ -231,6 +241,25 @@ const defaultOnInstall = (install, _, __, logger) => {
 	install();
 	logger?.info(`update success!`);
 };
+function readDevAsarVersion() {
+	try {
+		return node_fs.default.readFileSync(require_electron.getPathFromAppNameAsar("version"), "utf-8").trim();
+	} catch {
+		return electron.app.getVersion();
+	}
+}
+function resolveUpdaterOption(updater) {
+	if (!require_electron.isDev || !__EIU_LOCAL_DEV_UPDATE__ || updater?.provider) return updater;
+	return {
+		...updater,
+		provider: new require_local.LocalDevProvider({
+			baseDir: __EIU_LOCAL_DEV_UPDATE_DIR__,
+			chunkDelay: __EIU_LOCAL_DEV_UPDATE_CHUNK_DELAY__,
+			chunkSize: __EIU_LOCAL_DEV_UPDATE_CHUNK_SIZE__
+		}),
+		getAppVersion: updater?.getAppVersion ?? readDevAsarVersion
+	};
+}
 /**
 * Initialize Electron with updater
 * @example
@@ -249,7 +278,9 @@ const defaultOnInstall = (install, _, __, logger) => {
 async function createElectronApp(appOptions = {}) {
 	const appNameAsarPath = require_electron.getPathFromAppNameAsar();
 	const { mainPath = require_electron.isDev ? node_path.default.join(electron.app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "main", __EIU_MAIN_FILE__) : node_path.default.join(node_path.default.dirname(electron.app.getAppPath()), __EIU_ASAR_BASE_NAME__, "main", __EIU_MAIN_FILE__), updater, onInstall = defaultOnInstall, beforeStart, onStartError } = appOptions;
-	const updaterInstance = typeof updater === "object" || !updater ? new Updater(updater) : await updater();
+	const useAutoLocalDevProvider = require_electron.isDev && __EIU_LOCAL_DEV_UPDATE__ && typeof updater !== "function";
+	const updaterInstance = typeof updater === "object" || !updater ? new Updater(resolveUpdaterOption(updater)) : await updater();
+	if (useAutoLocalDevProvider && updaterInstance.provider?.name === "LocalDevProvider") updaterInstance.forceUpdate = true;
 	const logger = updaterInstance.logger;
 	try {
 		const tempAsarPath = `${appNameAsarPath}.tmp`;
@@ -258,8 +289,10 @@ async function createElectronApp(appOptions = {}) {
 			await onInstall(() => node_fs.default.renameSync(tempAsarPath, appNameAsarPath), tempAsarPath, appNameAsarPath, logger);
 		}
 		await beforeStart?.(mainPath, logger);
-		if (__EIU_IS_ESM__) runWithDefaultExport(await import(`file://${mainPath}`), updaterInstance);
-		else runWithDefaultExport(require(mainPath), updaterInstance);
+		if (__EIU_IS_ESM__) {
+			const { pathToFileURL } = await import("node:url");
+			runWithDefaultExport(await import(pathToFileURL(mainPath).href), updaterInstance);
+		} else runWithDefaultExport(require(mainPath), updaterInstance);
 	} catch (error) {
 		logger?.error("Fail to startup", error);
 		onStartError?.(error, logger);
@@ -270,11 +303,10 @@ async function createElectronApp(appOptions = {}) {
 * @deprecated Use {@link createElectronApp} instead
 */
 const initApp = createElectronApp;
-
 //#endregion
 exports.Updater = Updater;
 exports.UpdaterError = UpdaterError;
 exports.autoUpdate = autoUpdate;
 exports.createElectronApp = createElectronApp;
 exports.initApp = initApp;
-exports.startupWithUpdater = startupWithUpdater;
+exports.startupWithUpdater = startupWithUpdater;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as UpdateJSONWithURL, m as Promisable, n as IProvider, o as UpdateInfo, s as UpdateJSON, t as DownloadingInfo } from "./types-BM9Jfu7q.cjs";
+import { m as Promisable, n as IProvider, o as UpdateInfo, t as DownloadingInfo } from "./types-q78spjKB.cjs";
 import { EventEmitter } from "node:events";
 
 //#region src/entry/types.d.ts
@@ -34,6 +34,13 @@ interface UpdaterOption {
   * Updater logger
   */
   logger?: Logger;
+  /**
+  * Override current app version source.
+  *
+  * This is mainly used by dev tooling where the installed asar version differs
+  * from Electron's package version.
+  */
+  getAppVersion?: () => string;
 }
 /**
 * Update info with current app version and entry version
@@ -60,6 +67,7 @@ declare class Updater<T extends UpdateInfoWithExtraVersion = UpdateInfoWithExtra
 }> {
   private CERT;
   private controller;
+  private getCurrentAppVersion;
   private info?;
   private tmpFilePath?;
   private processing;
@@ -107,21 +115,10 @@ declare class Updater<T extends UpdateInfoWithExtraVersion = UpdateInfoWithExtra
   */
   checkForUpdates(): Promise<boolean>;
   /**
-  * Check update info using existing update json
-  * @param data existing update json
-  */
-  checkForUpdates(data: UpdateJSON | UpdateJSONWithURL): Promise<boolean>;
-  /**
   * Download update using default options
   */
   downloadUpdate(): Promise<boolean>;
   /**
-  * Download update using existing `asar.gz` buffer and signature
-  * @param data existing `asar.gz` buffer
-  * @param info update info
-  */
-  downloadUpdate(data: Uint8Array, info: Omit<UpdateInfo, "minimumVersion">): Promise<boolean>;
-  /**
   * quit App and install
   */
   quitAndInstall(): void;
@@ -141,7 +138,7 @@ declare function autoUpdate(updater: Updater): Promise<void>;
 * @param logger logger
 * @default install(); logger.info('update success!')
 */
-type OnInstallFunction = (install: VoidFunction, tempAsarPath: string, appNameAsarPath: string, logger?: Logger) => Promisable<void>;
+type OnInstallFunction = (install: () => void, tempAsarPath: string, appNameAsarPath: string, logger?: Logger) => Promisable<void>;
 interface AppOption {
   /**
   * Path to index file that make {@link startupWithUpdater} as default export

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as UpdateJSONWithURL, m as Promisable, n as IProvider, o as UpdateInfo, s as UpdateJSON, t as DownloadingInfo } from "./types-DASqEPXE.mjs";
+import { m as Promisable, n as IProvider, o as UpdateInfo, t as DownloadingInfo } from "./types-q78spjKB.mjs";
 import { EventEmitter } from "node:events";
 
 //#region src/entry/types.d.ts
@@ -34,6 +34,13 @@ interface UpdaterOption {
   * Updater logger
   */
   logger?: Logger;
+  /**
+  * Override current app version source.
+  *
+  * This is mainly used by dev tooling where the installed asar version differs
+  * from Electron's package version.
+  */
+  getAppVersion?: () => string;
 }
 /**
 * Update info with current app version and entry version
@@ -60,6 +67,7 @@ declare class Updater<T extends UpdateInfoWithExtraVersion = UpdateInfoWithExtra
 }> {
   private CERT;
   private controller;
+  private getCurrentAppVersion;
   private info?;
   private tmpFilePath?;
   private processing;
@@ -107,21 +115,10 @@ declare class Updater<T extends UpdateInfoWithExtraVersion = UpdateInfoWithExtra
   */
   checkForUpdates(): Promise<boolean>;
   /**
-  * Check update info using existing update json
-  * @param data existing update json
-  */
-  checkForUpdates(data: UpdateJSON | UpdateJSONWithURL): Promise<boolean>;
-  /**
   * Download update using default options
   */
   downloadUpdate(): Promise<boolean>;
   /**
-  * Download update using existing `asar.gz` buffer and signature
-  * @param data existing `asar.gz` buffer
-  * @param info update info
-  */
-  downloadUpdate(data: Uint8Array, info: Omit<UpdateInfo, "minimumVersion">): Promise<boolean>;
-  /**
   * quit App and install
   */
   quitAndInstall(): void;
@@ -141,7 +138,7 @@ declare function autoUpdate(updater: Updater): Promise<void>;
 * @param logger logger
 * @default install(); logger.info('update success!')
 */
-type OnInstallFunction = (install: VoidFunction, tempAsarPath: string, appNameAsarPath: string, logger?: Logger) => Promisable<void>;
+type OnInstallFunction = (install: () => void, tempAsarPath: string, appNameAsarPath: string, logger?: Logger) => Promisable<void>;
 interface AppOption {
   /**
   * Path to index file that make {@link startupWithUpdater} as default export

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import { a as getPathFromAppNameAsar, f as isDev, i as getEntryVersion, r as getAppVersion, y as restartApp } from "./electron-BJCk7uxG.mjs";
-import { r as isUpdateJSON } from "./version--eVB2A7n.mjs";
-import { BrowserWindow, app } from "electron";
+import { u as isUpdateJSON } from "./crypto-DZzMmoz2.mjs";
+import { t as LocalDevProvider } from "./local-C5jw-7o5.mjs";
+import { a as getPathFromAppNameAsar, f as isDev, i as getEntryVersion, r as getAppVersion, y as restartApp } from "./electron-BrIF1urZ.mjs";
 import fs from "node:fs";
 import path from "node:path";
+import { BrowserWindow, app } from "electron";
 import { EventEmitter } from "node:events";
-
 //#region src/entry/types.ts
 var UpdaterError = class extends Error {
 	code;
@@ -13,12 +13,12 @@ var UpdaterError = class extends Error {
 		this.code = code;
 	}
 };
-
 //#endregion
 //#region src/entry/updater.ts
 var Updater = class extends EventEmitter {
 	CERT;
 	controller;
+	getCurrentAppVersion;
 	info;
 	tmpFilePath;
 	processing = false;
@@ -45,6 +45,7 @@ var Updater = class extends EventEmitter {
 		this.receiveBeta = options.receiveBeta;
 		this.CERT = options.SIGNATURE_CERT || __EIU_SIGNATURE_CERT__;
 		this.logger = options.logger;
+		this.getCurrentAppVersion = options.getAppVersion ?? getAppVersion;
 		this.controller = new AbortController();
 		if (isDev && !this.logger) {
 			this.logger = {
@@ -55,7 +56,6 @@ var Updater = class extends EventEmitter {
 			};
 			this.logger.info("No logger set, enable dev-only logger");
 		}
-		if (!this.provider) this.logger?.debug("WARN: No update provider");
 	}
 	async fetch(format, data) {
 		if (typeof data === "object") if (format === "json" && isUpdateJSON(data) || format === "buffer" && Buffer.isBuffer(data)) return data;
@@ -88,9 +88,12 @@ var Updater = class extends EventEmitter {
 		const err = new UpdaterError(code, errorInfo);
 		this.logger?.error(`[${code}] ${msg}`, err);
 		this.cleanup();
-		this.emit("error", err);
+		if (this.listenerCount("error") > 0) this.emit("error", err);
 	}
-	async checkForUpdates(data) {
+	/**
+	* Check update info using default options
+	*/
+	async checkForUpdates() {
 		const emitUnavailable = (msg, code, info) => {
 			this.logger?.info(`[${code}] ${msg}`);
 			this.logger?.debug("Check update end");
@@ -98,18 +101,18 @@ var Updater = class extends EventEmitter {
 			this.emit("update-not-available", code, msg, info);
 			return false;
 		};
+		if (!this.provider) {
+			const msg = "No update json or provider";
+			this.err("Check update failed", "ERR_PARAM", msg);
+			return emitUnavailable(msg, "UNAVAILABLE_ERROR");
+		}
 		if (this.processing) {
 			this.logger?.info("Updater is already processing, skip check update");
 			return false;
 		}
 		this.processing = true;
 		this.logger?.debug("Check update start");
-		if (!data && !this.provider) {
-			const msg = "No update json or provider";
-			this.err("Check update failed", "ERR_PARAM", msg);
-			return emitUnavailable(msg, "UNAVAILABLE_ERROR");
-		}
-		const _data = await this.fetch("json", data);
+		const _data = await this.fetch("json");
 		if (!_data) return emitUnavailable("Failed to get update info", "UNAVAILABLE_ERROR");
 		const { signature, version, minimumVersion, url, ...rest } = this.receiveBeta ? _data.beta : _data;
 		const info = {
@@ -122,12 +125,12 @@ var Updater = class extends EventEmitter {
 			signature,
 			minimumVersion,
 			version,
-			appVersion: getAppVersion(),
+			appVersion: this.getCurrentAppVersion(),
 			entryVersion: getEntryVersion(),
 			...rest
 		};
 		this.logger?.debug(`Checked update, version: ${version}, signature: ${signature}`);
-		if (isDev && !this.forceUpdate && !data) return emitUnavailable("Skip check update in dev mode. To force update, set `updater.forceUpdate` to true or call checkUpdate with UpdateJSON", "UNAVAILABLE_DEV");
+		if (isDev && !this.forceUpdate) return emitUnavailable("Skip check update in dev mode. To force update, set `updater.forceUpdate` to `true`", "UNAVAILABLE_DEV");
 		const isLowerVersion = this.provider.isLowerVersion;
 		try {
 			if (isLowerVersion(extraVersionInfo.entryVersion, minimumVersion)) return emitUnavailable(`Entry Version (${extraVersionInfo.entryVersion}) < MinimumVersion (${minimumVersion})`, "UNAVAILABLE_VERSION", extraVersionInfo);
@@ -145,32 +148,39 @@ var Updater = class extends EventEmitter {
 			return emitUnavailable(msg, "UNAVAILABLE_ERROR", extraVersionInfo);
 		}
 	}
-	async downloadUpdate(data, info) {
+	/**
+	* Download update using default options
+	*/
+	async downloadUpdate() {
 		const emitError = (code, errorInfo) => {
 			this.err(`Download update failed`, code, errorInfo);
 			this.logger?.debug("Download update end");
 			this.processing = false;
 			return false;
 		};
+		if (!this.provider) return emitError("ERR_PARAM", "No update asar buffer and provider");
 		if (this.processing) {
 			this.logger?.info("Updater is already processing, skip download update");
 			return false;
 		}
 		this.processing = true;
 		this.logger?.debug("Download update start");
-		const _sig = info?.signature ?? this.info?.signature;
-		const _version = info?.version ?? this.info?.version;
-		if (!_sig || !_version) return emitError("ERR_PARAM", "No update signature, please call `checkUpdate` first or manually setup params");
-		if (!data && !this.provider) return emitError("ERR_PARAM", "No update asar buffer and provider");
-		const buffer = await this.fetch("buffer", data ? Buffer.from(data) : void 0);
-		if (!buffer) return emitError("ERR_PARAM", "No update asar file buffer");
+		const _sig = this.info?.signature;
+		const _version = this.info?.version;
+		if (!_sig || !_version) return emitError("ERR_PARAM", "No update signature, please call `checkUpdate` first");
+		const buffer = await this.fetch("buffer");
+		if (!buffer) {
+			this.logger?.debug("Download update end");
+			this.processing = false;
+			return false;
+		}
 		this.logger?.debug("Validation start");
-		if (!await this.provider.verifySignaure(buffer, _version, _sig, this.CERT)) return emitError("ERR_VALIDATE", "Invalid update asar file");
+		if (!await this.provider.verifySignature(buffer, _version, _sig, this.CERT)) return emitError("ERR_VALIDATE", "Invalid update asar file");
 		this.logger?.debug("Validation end");
 		try {
 			this.tmpFilePath = `${getPathFromAppNameAsar()}.tmp`;
 			this.logger?.debug(`Install to ${this.tmpFilePath}`);
-			fs.writeFileSync(this.tmpFilePath, await this.provider.unzipFile(buffer));
+			fs.writeFileSync(this.tmpFilePath, await this.provider.decompressFile(buffer));
 			this.logger?.info(`Download success, version: ${_version}`);
 			this.info = void 0;
 			this.emit("update-downloaded");
@@ -204,7 +214,6 @@ var Updater = class extends EventEmitter {
 async function autoUpdate(updater) {
 	if (await updater.checkForUpdates() && await updater.downloadUpdate()) updater.quitAndInstall();
 }
-
 //#endregion
 //#region src/entry/core.ts
 /**
@@ -229,6 +238,25 @@ const defaultOnInstall = (install, _, __, logger) => {
 	install();
 	logger?.info(`update success!`);
 };
+function readDevAsarVersion() {
+	try {
+		return fs.readFileSync(getPathFromAppNameAsar("version"), "utf-8").trim();
+	} catch {
+		return app.getVersion();
+	}
+}
+function resolveUpdaterOption(updater) {
+	if (!isDev || !__EIU_LOCAL_DEV_UPDATE__ || updater?.provider) return updater;
+	return {
+		...updater,
+		provider: new LocalDevProvider({
+			baseDir: __EIU_LOCAL_DEV_UPDATE_DIR__,
+			chunkDelay: __EIU_LOCAL_DEV_UPDATE_CHUNK_DELAY__,
+			chunkSize: __EIU_LOCAL_DEV_UPDATE_CHUNK_SIZE__
+		}),
+		getAppVersion: updater?.getAppVersion ?? readDevAsarVersion
+	};
+}
 /**
 * Initialize Electron with updater
 * @example
@@ -247,7 +275,9 @@ const defaultOnInstall = (install, _, __, logger) => {
 async function createElectronApp(appOptions = {}) {
 	const appNameAsarPath = getPathFromAppNameAsar();
 	const { mainPath = isDev ? path.join(app.getAppPath(), __EIU_ELECTRON_DIST_PATH__, "main", __EIU_MAIN_FILE__) : path.join(path.dirname(app.getAppPath()), __EIU_ASAR_BASE_NAME__, "main", __EIU_MAIN_FILE__), updater, onInstall = defaultOnInstall, beforeStart, onStartError } = appOptions;
-	const updaterInstance = typeof updater === "object" || !updater ? new Updater(updater) : await updater();
+	const useAutoLocalDevProvider = isDev && __EIU_LOCAL_DEV_UPDATE__ && typeof updater !== "function";
+	const updaterInstance = typeof updater === "object" || !updater ? new Updater(resolveUpdaterOption(updater)) : await updater();
+	if (useAutoLocalDevProvider && updaterInstance.provider?.name === "LocalDevProvider") updaterInstance.forceUpdate = true;
 	const logger = updaterInstance.logger;
 	try {
 		const tempAsarPath = `${appNameAsarPath}.tmp`;
@@ -256,8 +286,10 @@ async function createElectronApp(appOptions = {}) {
 			await onInstall(() => fs.renameSync(tempAsarPath, appNameAsarPath), tempAsarPath, appNameAsarPath, logger);
 		}
 		await beforeStart?.(mainPath, logger);
-		if (__EIU_IS_ESM__) runWithDefaultExport(await import(`file://${mainPath}`), updaterInstance);
-		else runWithDefaultExport(require(mainPath), updaterInstance);
+		if (__EIU_IS_ESM__) {
+			const { pathToFileURL } = await import("node:url");
+			runWithDefaultExport(await import(pathToFileURL(mainPath).href), updaterInstance);
+		} else runWithDefaultExport(require(mainPath), updaterInstance);
 	} catch (error) {
 		logger?.error("Fail to startup", error);
 		onStartError?.(error, logger);
@@ -268,6 +300,5 @@ async function createElectronApp(appOptions = {}) {
 * @deprecated Use {@link createElectronApp} instead
 */
 const initApp = createElectronApp;
-
 //#endregion
-export { Updater, UpdaterError, autoUpdate, createElectronApp, initApp, startupWithUpdater };
+export { Updater, UpdaterError, autoUpdate, createElectronApp, initApp, startupWithUpdater };

package/dist/local-C5jw-7o5.mjs

@@ -0,0 +1,105 @@
+import { c as defaultIsLowerVersion, i as defaultVerifySignature, s as defaultDecompressFile, u as isUpdateJSON } from "./crypto-DZzMmoz2.mjs";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region src/provider/base.ts
+var BaseProvider = class {
+	name = "BaseProvider";
+	/**
+	* @inheritdoc
+	*/
+	isLowerVersion = defaultIsLowerVersion;
+	/**
+	* @inheritdoc
+	*/
+	verifySignature = defaultVerifySignature;
+	/**
+	* @inheritdoc
+	*/
+	decompressFile = defaultDecompressFile;
+};
+//#endregion
+//#region src/provider/local.ts
+/**
+* Update Provider for local development
+* - download update json from `{baseDir}/{versionPath}`
+* - download update asar from `{baseDir}/{name}-{version}.asar.br`
+*
+* This provider is useful for testing updates during development without
+* needing to deploy to a remote server.
+* @param options provider options
+*/
+var LocalDevProvider = class extends BaseProvider {
+	name = "LocalDevProvider";
+	verifySignature;
+	options;
+	constructor(options) {
+		super();
+		const resolvedOptions = {
+			chunkSize: 64 * 1024,
+			chunkDelay: 30,
+			...options
+		};
+		if (resolvedOptions.chunkSize <= 0) throw new Error("localDevUpdate.chunkSize must be greater than 0");
+		if (resolvedOptions.chunkDelay < 0) throw new Error("localDevUpdate.chunkDelay must be greater than or equal to 0");
+		this.options = resolvedOptions;
+		this.verifySignature = async function verifySignature() {
+			return true;
+		};
+	}
+	/**
+	* @inheritdoc
+	*/
+	async downloadJSON(name, versionPath, signal) {
+		signal.throwIfAborted();
+		const { beta, version, ...info } = await this.readJSON(versionPath);
+		const getURL = (ver) => path.join(this.options.baseDir, `${name}-${ver}.asar.br`);
+		return {
+			...info,
+			version,
+			url: getURL(version),
+			beta: {
+				...beta,
+				url: getURL(beta.version)
+			}
+		};
+	}
+	/**
+	* @inheritdoc
+	*/
+	async downloadAsar(info, signal, onDownloading) {
+		signal.throwIfAborted();
+		const fileBuffer = await fs.readFile(info.url);
+		await this.emitProgress(fileBuffer, signal, onDownloading);
+		return fileBuffer;
+	}
+	async readJSON(versionPath) {
+		const fullPath = path.join(this.options.baseDir, versionPath);
+		const content = await fs.readFile(fullPath, "utf-8");
+		const json = JSON.parse(content);
+		if (!isUpdateJSON(json)) throw new Error(`Invalid update json: ${content}`);
+		return json;
+	}
+	async emitProgress(fileBuffer, signal, onDownloading) {
+		if (!onDownloading) return;
+		const total = fileBuffer.length;
+		let transferred = 0;
+		let lastTime = Date.now();
+		while (transferred < total) {
+			signal.throwIfAborted();
+			const currentTime = Date.now();
+			const delta = Math.min(this.options.chunkSize, total - transferred);
+			transferred += delta;
+			onDownloading({
+				delta,
+				percent: Math.round(transferred / total * 100),
+				total,
+				transferred,
+				bps: Math.round(delta / Math.max(currentTime - lastTime, 1) * 1e3)
+			});
+			lastTime = currentTime;
+			if (transferred < total && this.options.chunkDelay > 0) await new Promise((resolve) => setTimeout(resolve, this.options.chunkDelay));
+		}
+	}
+};
+//#endregion
+export { BaseProvider as n, LocalDevProvider as t };