electron-updater-for-render 1.1.3 → 2.0.0-beta.1

package/dist/bin/cli.cjs

@@ -50,7 +50,8 @@ async function createUpdatePackage(options) {
     packageJsonPath,
     privateKeyPath,
     releaseNotesPath,
-    forceUpdate
+    forceUpdate,
+    rolloutRule
   } = options;
   if (!import_fs.default.existsSync(outDir)) {
     throw new Error(`Output directory not found at ${outDir}`);
@@ -100,7 +101,8 @@ async function createUpdatePackage(options) {
     ...signature ? { signature } : {},
     date: (/* @__PURE__ */ new Date()).toISOString(),
     releaseNotes: releaseNotesContent,
-    ...forceUpdate ? { forceUpdate } : {}
+    ...forceUpdate ? { forceUpdate } : {},
+    ...rolloutRule ? { rolloutRule } : {}
   };
   const jsonPath = import_path.default.join(updatesDir, "latest.json");
   import_fs.default.writeFileSync(jsonPath, JSON.stringify(updateInfo, null, 2));

package/dist/bin/cli.js

@@ -23,7 +23,8 @@ async function createUpdatePackage(options) {
     packageJsonPath,
     privateKeyPath,
     releaseNotesPath,
-    forceUpdate
+    forceUpdate,
+    rolloutRule
   } = options;
   if (!fs.existsSync(outDir)) {
     throw new Error(`Output directory not found at ${outDir}`);
@@ -73,7 +74,8 @@ async function createUpdatePackage(options) {
     ...signature ? { signature } : {},
     date: (/* @__PURE__ */ new Date()).toISOString(),
     releaseNotes: releaseNotesContent,
-    ...forceUpdate ? { forceUpdate } : {}
+    ...forceUpdate ? { forceUpdate } : {},
+    ...rolloutRule ? { rolloutRule } : {}
   };
   const jsonPath = path.join(updatesDir, "latest.json");
   fs.writeFileSync(jsonPath, JSON.stringify(updateInfo, null, 2));

package/dist/builder/index.cjs

@@ -52,7 +52,8 @@ async function createUpdatePackage(options) {
     packageJsonPath,
     privateKeyPath,
     releaseNotesPath,
-    forceUpdate
+    forceUpdate,
+    rolloutRule
   } = options;
   if (!import_fs.default.existsSync(outDir)) {
     throw new Error(`Output directory not found at ${outDir}`);
@@ -102,7 +103,8 @@ async function createUpdatePackage(options) {
     ...signature ? { signature } : {},
     date: (/* @__PURE__ */ new Date()).toISOString(),
     releaseNotes: releaseNotesContent,
-    ...forceUpdate ? { forceUpdate } : {}
+    ...forceUpdate ? { forceUpdate } : {},
+    ...rolloutRule ? { rolloutRule } : {}
   };
   const jsonPath = import_path.default.join(updatesDir, "latest.json");
   import_fs.default.writeFileSync(jsonPath, JSON.stringify(updateInfo, null, 2));

package/dist/builder/index.js

@@ -17,7 +17,8 @@ async function createUpdatePackage(options) {
     packageJsonPath,
     privateKeyPath,
     releaseNotesPath,
-    forceUpdate
+    forceUpdate,
+    rolloutRule
   } = options;
   if (!fs.existsSync(outDir)) {
     throw new Error(`Output directory not found at ${outDir}`);
@@ -67,7 +68,8 @@ async function createUpdatePackage(options) {
     ...signature ? { signature } : {},
     date: (/* @__PURE__ */ new Date()).toISOString(),
     releaseNotes: releaseNotesContent,
-    ...forceUpdate ? { forceUpdate } : {}
+    ...forceUpdate ? { forceUpdate } : {},
+    ...rolloutRule ? { rolloutRule } : {}
   };
   const jsonPath = path.join(updatesDir, "latest.json");
   fs.writeFileSync(jsonPath, JSON.stringify(updateInfo, null, 2));

package/dist/main/index.cjs

@@ -30,7 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main/index.ts
 var main_exports = {};
 __export(main_exports, {
-  RenderUpdater: () => RenderUpdater
+  RenderUpdater: () => RenderUpdater,
+  setupUpdaterIPC: () => setupUpdaterIPC
 });
 module.exports = __toCommonJS(main_exports);
 var import_path2 = __toESM(require("path"), 1);
@@ -195,6 +196,7 @@ function verifyFileStream(filePath, info, publicKey) {
 }
 
 // src/main/index.ts
+var import_electron3 = require("electron");
 var fsPromises = import_original_fs.default.promises;
 var RenderUpdater = class {
   versionsDir;
@@ -217,6 +219,9 @@ var RenderUpdater = class {
   onStatusChanged;
   onError;
   onBeforeRestart;
+  identity;
+  allowPrerelease;
+  requestOptions;
   constructor(options) {
     console.log("[RenderUpdater] Initializing with versionsDir:", options.versionsDir);
     this.versionsDir = options.versionsDir;
@@ -234,6 +239,9 @@ var RenderUpdater = class {
     this.onBeforeRestart = options.onBeforeRestart;
     this.routerMode = options.routerMode ?? "hash";
     this.protocolName = options.protocol ?? "app";
+    this.identity = options.identity;
+    this.allowPrerelease = options.allowPrerelease ?? false;
+    this.requestOptions = options.requestOptions;
     this.download = this.download.bind(this);
     this.check = this.check.bind(this);
     this.checkForUpdatesAndNotify = this.checkForUpdatesAndNotify.bind(this);
@@ -333,7 +341,18 @@ var RenderUpdater = class {
   async check() {
     let remoteInfo = null;
     try {
-      const response = await fetch(`${this.baseUrl}/latest.json?t=${Date.now()}`);
+      const fetchUrl = new URL(`${this.baseUrl}/latest.json`);
+      fetchUrl.searchParams.append("t", Date.now().toString());
+      if (this.requestOptions?.query) {
+        for (const [k, v] of Object.entries(this.requestOptions.query)) {
+          fetchUrl.searchParams.append(k, v);
+        }
+      }
+      const fetchOpts = {};
+      if (this.requestOptions?.headers) {
+        fetchOpts.headers = this.requestOptions.headers;
+      }
+      const response = await fetch(fetchUrl.toString(), fetchOpts);
       if (response.ok) {
         remoteInfo = await response.json();
       }
@@ -343,7 +362,16 @@ var RenderUpdater = class {
     const runningVersion = this._activeVersion || "0.0.0";
     const pendingVersion = this._diskVersion || "0.0.0";
     if (remoteInfo && remoteInfo.version && import_semver.default.valid(remoteInfo.version)) {
-      if (import_semver.default.gt(remoteInfo.version, pendingVersion)) {
+      let allowUpdate = true;
+      if (remoteInfo.rolloutRule?.deviceIds) {
+        if (!this.identity?.deviceId || !remoteInfo.rolloutRule.deviceIds.includes(this.identity.deviceId)) {
+          allowUpdate = false;
+        }
+      }
+      if (allowUpdate && !this.allowPrerelease && import_semver.default.prerelease(remoteInfo.version)) {
+        allowUpdate = false;
+      }
+      if (allowUpdate && import_semver.default.gt(remoteInfo.version, pendingVersion, { includePrerelease: this.allowPrerelease })) {
         return { updateAvailable: true, version: remoteInfo.version, info: remoteInfo, status: "available" };
       }
     }
@@ -368,7 +396,24 @@ var RenderUpdater = class {
     this.isDownloading = true;
     try {
       console.log("[RenderUpdater] download() entry. current this.versionsDir:", this.versionsDir);
-      const infoToUse = providedInfo || await (await fetch(`${this.baseUrl}/latest.json?t=${Date.now()}`)).json();
+      let infoToUse;
+      if (providedInfo) {
+        infoToUse = providedInfo;
+      } else {
+        const fetchUrl = new URL(`${this.baseUrl}/latest.json`);
+        fetchUrl.searchParams.append("t", Date.now().toString());
+        if (this.requestOptions?.query) {
+          for (const [k, v] of Object.entries(this.requestOptions.query)) {
+            fetchUrl.searchParams.append(k, v);
+          }
+        }
+        const fetchOpts = {};
+        if (this.requestOptions?.headers) {
+          fetchOpts.headers = this.requestOptions.headers;
+        }
+        const res = await fetch(fetchUrl.toString(), fetchOpts);
+        infoToUse = await res.json();
+      }
       if (!this.versionsDir) throw new Error("[RenderUpdater] CRITICAL: this.versionsDir lost in download.");
       if (!infoToUse || !infoToUse.version) throw new Error(`[RenderUpdater] CRITICAL: infoToUse or version missing. info: ${JSON.stringify(infoToUse)}`);
       const versionDir = import_path2.default.join(this.versionsDir, infoToUse.version);
@@ -385,11 +430,12 @@ var RenderUpdater = class {
         const stats = await fsPromises.stat(tmpAsarPath);
         downloadedBytes = stats.size;
       }
-      const fetchOptions = {};
+      const fetchOptions = { headers: {} };
+      if (this.requestOptions?.headers) {
+        Object.assign(fetchOptions.headers, this.requestOptions.headers);
+      }
       if (downloadedBytes > 0) {
-        fetchOptions.headers = {
-          Range: `bytes=${downloadedBytes}-`
-        };
+        fetchOptions.headers["Range"] = `bytes=${downloadedBytes}-`;
       }
       const downloadUrl = infoToUse.path ? `${this.baseUrl.replace(/\/$/, "")}/${infoToUse.path}` : infoToUse.url;
       if (!downloadUrl) throw new Error("[RenderUpdater] Cannot determine download URL: info.path and info.url are both missing.");
@@ -580,7 +626,32 @@ ${info.releaseNotes || "\u65E0\u8BE6\u7EC6\u8BB0\u5F55\u3002"}`,
     return 0;
   }
 };
+function setupUpdaterIPC(updater) {
+  import_electron3.ipcMain.handle("updater:check", () => updater.check());
+  import_electron3.ipcMain.handle("updater:download", () => updater.download());
+  import_electron3.ipcMain.handle("updater:installAndRestart", () => updater.installAndRestart());
+  import_electron3.ipcMain.on("updater:useVersion", (_, version) => updater.useVersion(version));
+  updater.onDownloadProgress = (percent) => {
+    const { webContents } = require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onDownloadProgress", percent);
+    });
+  };
+  updater.onStatusChanged = (status) => {
+    const { webContents } = require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onStatusChanged", status);
+    });
+  };
+  updater.onBeforeRestart = () => {
+    const { webContents } = require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onBeforeRestart");
+    });
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  RenderUpdater
+  RenderUpdater,
+  setupUpdaterIPC
 });

package/dist/main/index.d.ts

@@ -21,6 +21,9 @@ export declare class RenderUpdater {
     }) => void;
     onError?: (error: Error) => void;
     onBeforeRestart?: () => void | Promise<void>;
+    private identity?;
+    private allowPrerelease;
+    private requestOptions?;
     constructor(options: UpdaterOptions);
     private readCurrentVersionFromFileSync;
     private cleanOldVersions;
@@ -49,3 +52,4 @@ export declare class RenderUpdater {
     private showNewUpdateDialog;
     private showDownloadCompleteDialog;
 }
+export declare function setupUpdaterIPC(updater: RenderUpdater): void;

package/dist/main/index.js

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/main/index.ts
 import path2 from "path";
 import fs2 from "original-fs";
@@ -161,6 +168,7 @@ function verifyFileStream(filePath, info, publicKey) {
 }
 
 // src/main/index.ts
+import { ipcMain } from "electron";
 var fsPromises = fs2.promises;
 var RenderUpdater = class {
   versionsDir;
@@ -183,6 +191,9 @@ var RenderUpdater = class {
   onStatusChanged;
   onError;
   onBeforeRestart;
+  identity;
+  allowPrerelease;
+  requestOptions;
   constructor(options) {
     console.log("[RenderUpdater] Initializing with versionsDir:", options.versionsDir);
     this.versionsDir = options.versionsDir;
@@ -200,6 +211,9 @@ var RenderUpdater = class {
     this.onBeforeRestart = options.onBeforeRestart;
     this.routerMode = options.routerMode ?? "hash";
     this.protocolName = options.protocol ?? "app";
+    this.identity = options.identity;
+    this.allowPrerelease = options.allowPrerelease ?? false;
+    this.requestOptions = options.requestOptions;
     this.download = this.download.bind(this);
     this.check = this.check.bind(this);
     this.checkForUpdatesAndNotify = this.checkForUpdatesAndNotify.bind(this);
@@ -299,7 +313,18 @@ var RenderUpdater = class {
   async check() {
     let remoteInfo = null;
     try {
-      const response = await fetch(`${this.baseUrl}/latest.json?t=${Date.now()}`);
+      const fetchUrl = new URL(`${this.baseUrl}/latest.json`);
+      fetchUrl.searchParams.append("t", Date.now().toString());
+      if (this.requestOptions?.query) {
+        for (const [k, v] of Object.entries(this.requestOptions.query)) {
+          fetchUrl.searchParams.append(k, v);
+        }
+      }
+      const fetchOpts = {};
+      if (this.requestOptions?.headers) {
+        fetchOpts.headers = this.requestOptions.headers;
+      }
+      const response = await fetch(fetchUrl.toString(), fetchOpts);
       if (response.ok) {
         remoteInfo = await response.json();
       }
@@ -309,7 +334,16 @@ var RenderUpdater = class {
     const runningVersion = this._activeVersion || "0.0.0";
     const pendingVersion = this._diskVersion || "0.0.0";
     if (remoteInfo && remoteInfo.version && semver.valid(remoteInfo.version)) {
-      if (semver.gt(remoteInfo.version, pendingVersion)) {
+      let allowUpdate = true;
+      if (remoteInfo.rolloutRule?.deviceIds) {
+        if (!this.identity?.deviceId || !remoteInfo.rolloutRule.deviceIds.includes(this.identity.deviceId)) {
+          allowUpdate = false;
+        }
+      }
+      if (allowUpdate && !this.allowPrerelease && semver.prerelease(remoteInfo.version)) {
+        allowUpdate = false;
+      }
+      if (allowUpdate && semver.gt(remoteInfo.version, pendingVersion, { includePrerelease: this.allowPrerelease })) {
         return { updateAvailable: true, version: remoteInfo.version, info: remoteInfo, status: "available" };
       }
     }
@@ -334,7 +368,24 @@ var RenderUpdater = class {
     this.isDownloading = true;
     try {
       console.log("[RenderUpdater] download() entry. current this.versionsDir:", this.versionsDir);
-      const infoToUse = providedInfo || await (await fetch(`${this.baseUrl}/latest.json?t=${Date.now()}`)).json();
+      let infoToUse;
+      if (providedInfo) {
+        infoToUse = providedInfo;
+      } else {
+        const fetchUrl = new URL(`${this.baseUrl}/latest.json`);
+        fetchUrl.searchParams.append("t", Date.now().toString());
+        if (this.requestOptions?.query) {
+          for (const [k, v] of Object.entries(this.requestOptions.query)) {
+            fetchUrl.searchParams.append(k, v);
+          }
+        }
+        const fetchOpts = {};
+        if (this.requestOptions?.headers) {
+          fetchOpts.headers = this.requestOptions.headers;
+        }
+        const res = await fetch(fetchUrl.toString(), fetchOpts);
+        infoToUse = await res.json();
+      }
       if (!this.versionsDir) throw new Error("[RenderUpdater] CRITICAL: this.versionsDir lost in download.");
       if (!infoToUse || !infoToUse.version) throw new Error(`[RenderUpdater] CRITICAL: infoToUse or version missing. info: ${JSON.stringify(infoToUse)}`);
       const versionDir = path2.join(this.versionsDir, infoToUse.version);
@@ -351,11 +402,12 @@ var RenderUpdater = class {
         const stats = await fsPromises.stat(tmpAsarPath);
         downloadedBytes = stats.size;
       }
-      const fetchOptions = {};
+      const fetchOptions = { headers: {} };
+      if (this.requestOptions?.headers) {
+        Object.assign(fetchOptions.headers, this.requestOptions.headers);
+      }
       if (downloadedBytes > 0) {
-        fetchOptions.headers = {
-          Range: `bytes=${downloadedBytes}-`
-        };
+        fetchOptions.headers["Range"] = `bytes=${downloadedBytes}-`;
       }
       const downloadUrl = infoToUse.path ? `${this.baseUrl.replace(/\/$/, "")}/${infoToUse.path}` : infoToUse.url;
       if (!downloadUrl) throw new Error("[RenderUpdater] Cannot determine download URL: info.path and info.url are both missing.");
@@ -546,6 +598,31 @@ ${info.releaseNotes || "\u65E0\u8BE6\u7EC6\u8BB0\u5F55\u3002"}`,
     return 0;
   }
 };
+function setupUpdaterIPC(updater) {
+  ipcMain.handle("updater:check", () => updater.check());
+  ipcMain.handle("updater:download", () => updater.download());
+  ipcMain.handle("updater:installAndRestart", () => updater.installAndRestart());
+  ipcMain.on("updater:useVersion", (_, version) => updater.useVersion(version));
+  updater.onDownloadProgress = (percent) => {
+    const { webContents } = __require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onDownloadProgress", percent);
+    });
+  };
+  updater.onStatusChanged = (status) => {
+    const { webContents } = __require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onStatusChanged", status);
+    });
+  };
+  updater.onBeforeRestart = () => {
+    const { webContents } = __require("electron");
+    webContents.getAllWebContents().forEach((wc) => {
+      wc.send("updater:onBeforeRestart");
+    });
+  };
+}
 export {
-  RenderUpdater
+  RenderUpdater,
+  setupUpdaterIPC
 };

package/dist/preload/index.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/preload/index.ts
+var preload_exports = {};
+__export(preload_exports, {
+  exposeUpdaterPreload: () => exposeUpdaterPreload
+});
+module.exports = __toCommonJS(preload_exports);
+function exposeUpdaterPreload(ipcRenderer) {
+  return {
+    check: () => ipcRenderer.invoke("updater:check"),
+    download: () => ipcRenderer.invoke("updater:download"),
+    installAndRestart: () => ipcRenderer.invoke("updater:installAndRestart"),
+    useVersion: (version) => ipcRenderer.send("updater:useVersion", version),
+    // 监听事件
+    onDownloadProgress: (callback) => {
+      ipcRenderer.on("updater:onDownloadProgress", (_, percent) => callback(percent));
+    },
+    onStatusChanged: (callback) => {
+      ipcRenderer.on("updater:onStatusChanged", (_, data) => callback(data));
+    },
+    onBeforeRestart: (callback) => {
+      ipcRenderer.on("updater:onBeforeRestart", () => callback());
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  exposeUpdaterPreload
+});

package/dist/preload/index.d.ts

@@ -0,0 +1,13 @@
+import type { IpcRenderer } from 'electron';
+export declare function exposeUpdaterPreload(ipcRenderer: IpcRenderer): {
+    check: () => Promise<any>;
+    download: () => Promise<any>;
+    installAndRestart: () => Promise<any>;
+    useVersion: (version: string) => void;
+    onDownloadProgress: (callback: (percent: number) => void) => void;
+    onStatusChanged: (callback: (data: {
+        status: "ready" | "available" | "idle";
+        version: string;
+    }) => void) => void;
+    onBeforeRestart: (callback: () => void) => void;
+};

package/dist/preload/index.js

@@ -0,0 +1,22 @@
+// src/preload/index.ts
+function exposeUpdaterPreload(ipcRenderer) {
+  return {
+    check: () => ipcRenderer.invoke("updater:check"),
+    download: () => ipcRenderer.invoke("updater:download"),
+    installAndRestart: () => ipcRenderer.invoke("updater:installAndRestart"),
+    useVersion: (version) => ipcRenderer.send("updater:useVersion", version),
+    // 监听事件
+    onDownloadProgress: (callback) => {
+      ipcRenderer.on("updater:onDownloadProgress", (_, percent) => callback(percent));
+    },
+    onStatusChanged: (callback) => {
+      ipcRenderer.on("updater:onStatusChanged", (_, data) => callback(data));
+    },
+    onBeforeRestart: (callback) => {
+      ipcRenderer.on("updater:onBeforeRestart", () => callback());
+    }
+  };
+}
+export {
+  exposeUpdaterPreload
+};

package/dist/renderer/index.cjs

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/renderer/index.ts
+var renderer_exports = {};
+__export(renderer_exports, {
+  getUpdater: () => getUpdater
+});
+module.exports = __toCommonJS(renderer_exports);
+function getUpdater(namespace = "updaterAPI") {
+  if (typeof window === "undefined") {
+    throw new Error("[RenderUpdater] getUpdater() can only be called in a Browser/Renderer context.");
+  }
+  const api = window[namespace];
+  if (!api) {
+    throw new Error(`[RenderUpdater] Cannot find window.${namespace}. Did you forget to call exposeUpdaterPreload in your preload script?`);
+  }
+  return api;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getUpdater
+});

package/dist/renderer/index.d.ts

@@ -0,0 +1,23 @@
+import type { UpdateInfo } from '../types';
+export interface UpdaterClientAPI {
+    check(): Promise<{
+        updateAvailable: boolean;
+        version?: string;
+        info?: UpdateInfo;
+        status: 'idle' | 'available' | 'ready';
+    }>;
+    download(): Promise<void>;
+    installAndRestart(): Promise<void>;
+    useVersion(version: string): void;
+    onDownloadProgress(callback: (percent: number) => void): void;
+    onStatusChanged(callback: (data: {
+        status: 'ready' | 'available' | 'idle';
+        version: string;
+    }) => void): void;
+    onBeforeRestart(callback: () => void): void;
+}
+/**
+ * Ensures the updater preload API is accessible and typed.
+ * This should only be used in the renderer process (e.g. standard Vue/React contexts).
+ */
+export declare function getUpdater(namespace?: string): UpdaterClientAPI;

package/dist/renderer/index.js

@@ -0,0 +1,14 @@
+// src/renderer/index.ts
+function getUpdater(namespace = "updaterAPI") {
+  if (typeof window === "undefined") {
+    throw new Error("[RenderUpdater] getUpdater() can only be called in a Browser/Renderer context.");
+  }
+  const api = window[namespace];
+  if (!api) {
+    throw new Error(`[RenderUpdater] Cannot find window.${namespace}. Did you forget to call exposeUpdaterPreload in your preload script?`);
+  }
+  return api;
+}
+export {
+  getUpdater
+};

package/dist/types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/types.d.ts

@@ -12,6 +12,13 @@ export interface UpdateInfo {
      * 'silent' - downloads and restarts invisibly on the background.
      */
     forceUpdate?: 'prompt' | 'silent';
+    /**
+     * Defines targeted rollout rules.
+     * If not empty, only clients matching the rules will be allowed to update.
+     */
+    rolloutRule?: {
+        deviceIds?: string[];
+    };
 }
 export interface UpdaterOptions {
     /**
@@ -23,6 +30,24 @@ export interface UpdaterOptions {
      * (e.g. app.getPath('userData') + '/versions')
      */
     versionsDir: string;
+    /**
+     * Client identity details for targeted rollouts (e.g. gray release).
+     */
+    identity?: {
+        deviceId?: string;
+    };
+    /**
+     * If true, will allow semver engine to pull prerelease versions (like beta or rc).
+     * Default: false
+     */
+    allowPrerelease?: boolean;
+    /**
+     * Custom HTTP headers and query params for the check & download requests (useful for auth).
+     */
+    requestOptions?: {
+        headers?: Record<string, string>;
+        query?: Record<string, string>;
+    };
     /**
      * Public key string (PEM format) to verify the RSA signature
      */
@@ -122,4 +147,10 @@ export interface BuilderOptions {
      * 'silent': Stealthily apply it in the background.
      */
     forceUpdate?: 'prompt' | 'silent';
+    /**
+     * Rollout whitelist rule for precise targeting during build packing.
+     */
+    rolloutRule?: {
+        deviceIds?: string[];
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-updater-for-render",
-  "version": "1.1.3",
+  "version": "2.0.0-beta.1",
   "description": "A lightweight incremental updater for Electron renderer processes",
   "type": "module",
   "bin": {
@@ -15,6 +15,26 @@
       "import": "./dist/main/index.js",
       "require": "./dist/main/index.cjs"
     },
+    "./main": {
+      "types": "./dist/main/index.d.ts",
+      "import": "./dist/main/index.js",
+      "require": "./dist/main/index.cjs"
+    },
+    "./preload": {
+      "types": "./dist/preload/index.d.ts",
+      "import": "./dist/preload/index.js",
+      "require": "./dist/preload/index.cjs"
+    },
+    "./renderer": {
+      "types": "./dist/renderer/index.d.ts",
+      "import": "./dist/renderer/index.js",
+      "require": "./dist/renderer/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    },
     "./builder": {
       "types": "./dist/builder/index.d.ts",
       "import": "./dist/builder/index.js",