electron-incremental-update 3.0.0-beta.4 → 3.0.0-beta.6

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 "./zip-DUK3opmV.mjs";
+import { t as LocalDevProvider } from "./local-s1cw_vwb.mjs";
+import { a as getPathFromAppNameAsar, f as isDev, i as getEntryVersion, r as getAppVersion, y as restartApp } from "./electron-BInvFJ-W.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,25 +148,32 @@ 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");
 		this.logger?.debug("Validation end");
@@ -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-Daf8naRn.cjs

@@ -0,0 +1,118 @@
+const require_zip = require("./zip-D1dbBzw4.cjs");
+let node_path = require("node:path");
+node_path = require_zip.__toESM(node_path, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_zip.__toESM(node_fs_promises, 1);
+//#region src/provider/base.ts
+var BaseProvider = class {
+	name = "BaseProvider";
+	/**
+	* @inheritdoc
+	*/
+	isLowerVersion = require_zip.defaultIsLowerVersion;
+	/**
+	* @inheritdoc
+	*/
+	verifySignaure = require_zip.defaultVerifySignature;
+	/**
+	* @inheritdoc
+	*/
+	unzipFile = require_zip.defaultUnzipFile;
+};
+//#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.gz`
+*
+* 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";
+	verifySignaure;
+	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.verifySignaure = async function verifySignaure() {
+			return true;
+		};
+	}
+	/**
+	* @inheritdoc
+	*/
+	async downloadJSON(name, versionPath, signal) {
+		signal.throwIfAborted();
+		const { beta, version, ...info } = await this.readJSON(versionPath);
+		const getURL = (ver) => node_path.default.join(this.options.baseDir, `${name}-${ver}.asar.gz`);
+		return {
+			...info,
+			version,
+			url: getURL(version),
+			beta: {
+				...beta,
+				url: getURL(beta.version)
+			}
+		};
+	}
+	/**
+	* @inheritdoc
+	*/
+	async downloadAsar(info, signal, onDownloading) {
+		signal.throwIfAborted();
+		const fileBuffer = await node_fs_promises.default.readFile(info.url);
+		await this.emitProgress(fileBuffer, signal, onDownloading);
+		return fileBuffer;
+	}
+	async readJSON(versionPath) {
+		const fullPath = node_path.default.join(this.options.baseDir, versionPath);
+		const content = await node_fs_promises.default.readFile(fullPath, "utf-8");
+		const json = JSON.parse(content);
+		if (!require_zip.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
+Object.defineProperty(exports, "BaseProvider", {
+	enumerable: true,
+	get: function() {
+		return BaseProvider;
+	}
+});
+Object.defineProperty(exports, "LocalDevProvider", {
+	enumerable: true,
+	get: function() {
+		return LocalDevProvider;
+	}
+});

package/dist/local-s1cw_vwb.mjs

@@ -0,0 +1,105 @@
+import { c as defaultIsLowerVersion, o as defaultVerifySignature, t as defaultUnzipFile, u as isUpdateJSON } from "./zip-DUK3opmV.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
+	*/
+	verifySignaure = defaultVerifySignature;
+	/**
+	* @inheritdoc
+	*/
+	unzipFile = defaultUnzipFile;
+};
+//#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.gz`
+*
+* 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";
+	verifySignaure;
+	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.verifySignaure = async function verifySignaure() {
+			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.gz`);
+		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 };

package/dist/provider.cjs

@@ -1,27 +1,10 @@
-const require_version = require('./version-aPrLuz_-.cjs');
-const require_zip = require('./zip-BCC7FAQ_.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_local = require("./local-Daf8naRn.cjs");
+const require_download = require("./download-BYnkme_X.cjs");
 let node_url = require("node:url");
-
-//#region src/provider/base.ts
-var BaseProvider = class {
-	name = "BaseProvider";
-	/**
-	* @inheritdoc
-	*/
-	isLowerVersion = require_version.defaultIsLowerVersion;
-	/**
-	* @inheritdoc
-	*/
-	verifySignaure = require_zip.defaultVerifySignature;
-	/**
-	* @inheritdoc
-	*/
-	unzipFile = require_zip.defaultUnzipFile;
-};
-
-//#endregion
 //#region src/provider/github/base.ts
-var BaseGitHubProvider = class extends BaseProvider {
+var BaseGitHubProvider = class extends require_local.BaseProvider {
+	options;
 	constructor(options) {
 		super();
 		this.options = options;
@@ -32,12 +15,12 @@ var BaseGitHubProvider = class extends BaseProvider {
 	set urlHandler(handler) {
 		this.options.urlHandler = handler;
 	}
-	async parseURL(extraPath) {
-		const url = new node_url.URL(`/${this.options.user}/${this.options.repo}/${extraPath}`, "https://github.com");
+	async parseURL(pathOrURL) {
+		const url = node_url.URL.canParse(pathOrURL) ? new node_url.URL(pathOrURL) : new node_url.URL(`/${this.options.user}/${this.options.repo}/${pathOrURL}`, "https://github.com");
 		return (await this.urlHandler?.(url) || url).toString();
 	}
 	async downloadJSON(name, versionPath, signal) {
-		const { beta, version, ...info } = await require_zip.defaultDownloadUpdateJSON(await this.parseURL(await this.getVersionURL(versionPath, signal)), this.getHeaders("json"), signal);
+		const { beta, version, ...info } = await require_download.defaultDownloadUpdateJSON(await this.parseURL(await this.getVersionURL(versionPath, signal)), this.getHeaders("json"), signal);
 		const getURL = (ver) => this.parseURL(`releases/download/v${ver}/${name}-${ver}.asar.gz`);
 		return {
 			...info,
@@ -53,10 +36,9 @@ var BaseGitHubProvider = class extends BaseProvider {
 	* @inheritdoc
 	*/
 	async downloadAsar(info, signal, onDownloading) {
-		return await require_zip.defaultDownloadAsar(info.url, this.getHeaders("octet-stream"), signal, onDownloading);
+		return await require_download.defaultDownloadAsar(info.url, this.getHeaders("octet-stream"), signal, onDownloading);
 	}
 };
-
 //#endregion
 //#region src/provider/github/api.ts
 const ERROR_MSG = "Cannot find UpdateJSON in latest release";
@@ -83,13 +65,12 @@ var GitHubApiProvider = class extends BaseGitHubProvider {
 	*/
 	async getVersionURL(versionPath, signal) {
 		const basename = versionPath.slice(versionPath.lastIndexOf("/") + 1);
-		const data = await require_zip.defaultDownloadText(await this.parseURL(`https://api.github.com/repos/${this.options.user}/${this.options.repo}/releases?per_page=1`), this.getHeaders("vnd.github.v3+json"), signal, require_zip.resolveJson);
+		const data = await require_download.defaultDownloadText(await this.parseURL(`https://api.github.com/repos/${this.options.user}/${this.options.repo}/releases?per_page=1`), this.getHeaders("vnd.github.v3+json"), signal, require_download.resolveJson);
 		const versionAssets = data[0]?.assets.find((asset) => asset.name === basename);
 		if (!versionAssets) throw new Error(`${ERROR_MSG}, ${"message" in data ? data.message : "please check the release assets"}`);
 		return versionAssets.browser_download_url;
 	}
 };
-
 //#endregion
 //#region src/provider/github/atom.ts
 /**
@@ -113,14 +94,14 @@ var GitHubAtomProvider = class extends BaseGitHubProvider {
 	* @inheritdoc
 	*/
 	async getVersionURL(versionPath, signal) {
-		return `releases/download/v${await require_zip.defaultDownloadText(await this.parseURL(`releases.atom`), this.getHeaders("xml"), signal, (data, resolve, reject) => {
+		const tag = await require_download.defaultDownloadText(await this.parseURL(`releases.atom`), this.getHeaders("xml"), signal, (data, resolve, reject) => {
 			const result = data.match(/<entry>\s*<id>([^<]*\/)?([^/<]+)<\/id>/)?.[2];
 			if (result) resolve(result);
 			else reject("No tag matched");
-		})}/${versionPath}`;
+		});
+		return `releases/download/v${tag.startsWith("v") ? tag.slice(1) : tag}/${versionPath}`;
 	}
 };
-
 //#endregion
 //#region src/provider/github/file.ts
 /**
@@ -147,16 +128,16 @@ var GitHubProvider = class extends BaseGitHubProvider {
 		return `raw/${this.options.branch}/${versionPath}`;
 	}
 };
-
 //#endregion
 exports.BaseGitHubProvider = BaseGitHubProvider;
-exports.BaseProvider = BaseProvider;
+exports.BaseProvider = require_local.BaseProvider;
 exports.GitHubApiProvider = GitHubApiProvider;
 exports.GitHubAtomProvider = GitHubAtomProvider;
 exports.GitHubProvider = GitHubProvider;
-exports.defaultDownloadAsar = require_zip.defaultDownloadAsar;
-exports.defaultDownloadText = require_zip.defaultDownloadText;
-exports.defaultDownloadUpdateJSON = require_zip.defaultDownloadUpdateJSON;
-exports.downloadUtil = require_zip.downloadUtil;
-exports.getHeader = require_zip.getHeader;
-exports.resolveJson = require_zip.resolveJson;
+exports.LocalDevProvider = require_local.LocalDevProvider;
+exports.defaultDownloadAsar = require_download.defaultDownloadAsar;
+exports.defaultDownloadText = require_download.defaultDownloadText;
+exports.defaultDownloadUpdateJSON = require_download.defaultDownloadUpdateJSON;
+exports.downloadUtil = require_download.downloadUtil;
+exports.getHeader = require_download.getHeader;
+exports.resolveJson = require_download.resolveJson;

package/dist/provider.d.cts

@@ -1,5 +1,6 @@
-import { a as UpdateJSONWithURL, i as UpdateInfoWithURL, m as Promisable, n as IProvider, r as URLHandler, t as DownloadingInfo } from "./types-BM9Jfu7q.cjs";
-import { a as getHeader, i as downloadUtil, n as defaultDownloadText, o as resolveJson, r as defaultDownloadUpdateJSON, t as defaultDownloadAsar } from "./download-DO7iuxEJ.cjs";
+import { a as VersionJSON, i as UpdateInfoWithURL, m as Promisable, n as IProvider, r as URLHandler, t as DownloadingInfo } from "./types-BOqQ_r5Q.cjs";
+import { a as getHeader, i as downloadUtil, n as defaultDownloadText, o as resolveJson, r as defaultDownloadUpdateJSON, t as defaultDownloadAsar } from "./download-BjWmHHAu.cjs";
+import { Buffer as Buffer$1 } from "node:buffer";
 
 //#region src/provider/base.d.ts
 declare abstract class BaseProvider implements IProvider {
@@ -19,7 +20,7 @@ declare abstract class BaseProvider implements IProvider {
   /**
   * @inheritdoc
   */
-  abstract downloadJSON(name: string, versionPath: string, signal: AbortSignal): Promise<UpdateJSONWithURL>;
+  abstract downloadJSON(name: string, versionPath: string, signal: AbortSignal): Promise<VersionJSON>;
   /**
   * @inheritdoc
   */
@@ -56,10 +57,10 @@ declare abstract class BaseGitHubProvider<T extends BaseGitHubProviderOptions =
   constructor(options: T);
   get urlHandler(): URLHandler | undefined;
   set urlHandler(handler: URLHandler);
-  protected parseURL(extraPath: string): Promise<string>;
+  protected parseURL(pathOrURL: string): Promise<string>;
   protected abstract getHeaders(accept: string): Record<string, string>;
   protected abstract getVersionURL(versionPath: string, signal: AbortSignal): Promisable<string>;
-  downloadJSON(name: string, versionPath: string, signal: AbortSignal): Promise<UpdateJSONWithURL>;
+  downloadJSON(name: string, versionPath: string, signal: AbortSignal): Promise<VersionJSON>;
   /**
   * @inheritdoc
   */
@@ -80,7 +81,7 @@ interface GitHubApiProviderOptions extends BaseGitHubProviderOptions {
 * @param options provider options
 */
 declare class GitHubApiProvider extends BaseGitHubProvider<GitHubApiProviderOptions> {
-  name: string;
+  override name: string;
   protected getHeaders(accept: string): Record<string, string>;
   /**
   * @inheritdoc
@@ -99,7 +100,7 @@ declare class GitHubApiProvider extends BaseGitHubProvider<GitHubApiProviderOpti
 * @param options provider options
 */
 declare class GitHubAtomProvider extends BaseGitHubProvider {
-  name: string;
+  override name: string;
   protected getHeaders(accept: string): Record<string, string>;
   /**
   * @inheritdoc
@@ -124,10 +125,53 @@ interface GitHubProviderOptions extends BaseGitHubProviderOptions {
 * @param options provider options
 */
 declare class GitHubProvider extends BaseGitHubProvider<GitHubProviderOptions> {
-  name: string;
+  override name: string;
   constructor(options: GitHubProviderOptions);
   protected getHeaders(accept: string): Record<string, string>;
   protected getVersionURL(versionPath: string): string;
 }
 //#endregion
-export { BaseGitHubProvider, BaseGitHubProviderOptions, BaseProvider, DownloadingInfo, GitHubApiProvider, GitHubApiProviderOptions, GitHubAtomProvider, GitHubProvider, GitHubProviderOptions, IProvider, URLHandler, UpdateInfoWithURL, UpdateJSONWithURL, defaultDownloadAsar, defaultDownloadText, defaultDownloadUpdateJSON, downloadUtil, getHeader, resolveJson };
+//#region src/provider/local.d.ts
+interface LocalDevProviderOptions {
+  /**
+  * Base directory for update files
+  */
+  baseDir: string;
+  /**
+  * Local read chunk size for simulated download progress
+  * @default 64 * 1024
+  */
+  chunkSize?: number;
+  /**
+  * Delay between chunks in milliseconds
+  * @default 30
+  */
+  chunkDelay?: number;
+}
+/**
+* Update Provider for local development
+* - download update json from `{baseDir}/{versionPath}`
+* - download update asar from `{baseDir}/{name}-{version}.asar.gz`
+*
+* This provider is useful for testing updates during development without
+* needing to deploy to a remote server.
+* @param options provider options
+*/
+declare class LocalDevProvider extends BaseProvider {
+  override name: string;
+  override verifySignaure: IProvider["verifySignaure"];
+  private readonly options;
+  constructor(options: LocalDevProviderOptions);
+  /**
+  * @inheritdoc
+  */
+  downloadJSON(name: string, versionPath: string, signal: AbortSignal): Promise<VersionJSON>;
+  /**
+  * @inheritdoc
+  */
+  downloadAsar(info: UpdateInfoWithURL, signal: AbortSignal, onDownloading?: (info: DownloadingInfo) => void): Promise<Buffer$1>;
+  private readJSON;
+  private emitProgress;
+}
+//#endregion
+export { BaseGitHubProvider, BaseGitHubProviderOptions, BaseProvider, DownloadingInfo, GitHubApiProvider, GitHubApiProviderOptions, GitHubAtomProvider, GitHubProvider, GitHubProviderOptions, IProvider, LocalDevProvider, LocalDevProviderOptions, URLHandler, UpdateInfoWithURL, VersionJSON, defaultDownloadAsar, defaultDownloadText, defaultDownloadUpdateJSON, downloadUtil, getHeader, resolveJson };