@electron-memory/monitor 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -481,6 +481,12 @@ declare class ElectronMemoryMonitor extends EventEmitter {
     private mergeConfig;
 }
 
+/**
+ * 必须在 app.on('ready') 之前调用（与 new ElectronMemoryMonitor 同文件顶部或更早）。
+ * 由 ElectronMemoryMonitor 在启用时于构造函数内调用。
+ */
+declare function registerDashboardSchemePrivileged(): void;
+
 /**
  * IPC 通道常量定义
  * 所有通道以 'emm:' 为前缀，避免与业务 IPC 冲突
@@ -507,4 +513,4 @@ declare const IPC_CHANNELS: {
     readonly RENDERER_REQUEST: "emm:renderer:request";
 };
 
-export { type AnomalyCategory, type AnomalyEvent, type AnomalyRule, type AnomalySeverity, type CompareReport, ElectronMemoryMonitor, type EventMark, type GCResult, IPC_CHANNELS, type Improvement, type MemorySnapshot, type MetricDiff, type MetricSummary, type MonitorConfig, type ProcessMemoryInfo, type Regression, type RendererV8Detail, type SessionIndex, type SessionReport, type Suggestion, type SystemMemoryInfo, type TestSession, type TrendInfo, type V8HeapDetailStats, type V8HeapSpaceInfo, type V8HeapStats };
+export { type AnomalyCategory, type AnomalyEvent, type AnomalyRule, type AnomalySeverity, type CompareReport, ElectronMemoryMonitor, type EventMark, type GCResult, IPC_CHANNELS, type Improvement, type MemorySnapshot, type MetricDiff, type MetricSummary, type MonitorConfig, type ProcessMemoryInfo, type Regression, type RendererV8Detail, type SessionIndex, type SessionReport, type Suggestion, type SystemMemoryInfo, type TestSession, type TrendInfo, type V8HeapDetailStats, type V8HeapSpaceInfo, type V8HeapStats, registerDashboardSchemePrivileged };

package/dist/index.d.ts

@@ -481,6 +481,12 @@ declare class ElectronMemoryMonitor extends EventEmitter {
     private mergeConfig;
 }
 
+/**
+ * 必须在 app.on('ready') 之前调用（与 new ElectronMemoryMonitor 同文件顶部或更早）。
+ * 由 ElectronMemoryMonitor 在启用时于构造函数内调用。
+ */
+declare function registerDashboardSchemePrivileged(): void;
+
 /**
  * IPC 通道常量定义
  * 所有通道以 'emm:' 为前缀，避免与业务 IPC 冲突
@@ -507,4 +513,4 @@ declare const IPC_CHANNELS: {
     readonly RENDERER_REQUEST: "emm:renderer:request";
 };
 
-export { type AnomalyCategory, type AnomalyEvent, type AnomalyRule, type AnomalySeverity, type CompareReport, ElectronMemoryMonitor, type EventMark, type GCResult, IPC_CHANNELS, type Improvement, type MemorySnapshot, type MetricDiff, type MetricSummary, type MonitorConfig, type ProcessMemoryInfo, type Regression, type RendererV8Detail, type SessionIndex, type SessionReport, type Suggestion, type SystemMemoryInfo, type TestSession, type TrendInfo, type V8HeapDetailStats, type V8HeapSpaceInfo, type V8HeapStats };
+export { type AnomalyCategory, type AnomalyEvent, type AnomalyRule, type AnomalySeverity, type CompareReport, ElectronMemoryMonitor, type EventMark, type GCResult, IPC_CHANNELS, type Improvement, type MemorySnapshot, type MetricDiff, type MetricSummary, type MonitorConfig, type ProcessMemoryInfo, type Regression, type RendererV8Detail, type SessionIndex, type SessionReport, type Suggestion, type SystemMemoryInfo, type TestSession, type TrendInfo, type V8HeapDetailStats, type V8HeapSpaceInfo, type V8HeapStats, registerDashboardSchemePrivileged };

package/dist/index.js

@@ -31,13 +31,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   ElectronMemoryMonitor: () => ElectronMemoryMonitor,
-  IPC_CHANNELS: () => IPC_CHANNELS
+  IPC_CHANNELS: () => IPC_CHANNELS,
+  registerDashboardSchemePrivileged: () => registerDashboardSchemePrivileged
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/core/monitor.ts
-var import_electron4 = require("electron");
-var path3 = __toESM(require("path"));
+var import_electron5 = require("electron");
+var path4 = __toESM(require("path"));
 var v82 = __toESM(require("v8"));
 var import_events3 = require("events");
 
@@ -1106,8 +1107,76 @@ var Analyzer = class {
 };
 
 // src/core/dashboard.ts
+var import_electron3 = require("electron");
+var path3 = __toESM(require("path"));
+
+// src/core/dashboard-protocol.ts
 var import_electron2 = require("electron");
 var path2 = __toESM(require("path"));
+var import_node_url = require("url");
+var SCHEME = "emm-dashboard";
+var privilegedRegistered = false;
+var handlerRegistered = false;
+function isPathInsideRoot(filePath, root) {
+  const f = path2.resolve(filePath);
+  const r = path2.resolve(root);
+  if (f === r) {
+    return true;
+  }
+  const sep2 = r.endsWith(path2.sep) ? r : `${r}${path2.sep}`;
+  return f.startsWith(sep2);
+}
+function registerDashboardSchemePrivileged() {
+  if (privilegedRegistered) {
+    return;
+  }
+  privilegedRegistered = true;
+  import_electron2.protocol.registerSchemesAsPrivileged([
+    {
+      scheme: SCHEME,
+      privileges: {
+        standard: true,
+        secure: true,
+        supportFetchAPI: true,
+        corsEnabled: true,
+        stream: true
+      }
+    }
+  ]);
+}
+function ensureDashboardProtocolHandler(uiRoot) {
+  if (handlerRegistered) {
+    return;
+  }
+  if (!import_electron2.app.isReady()) {
+    throw new Error(
+      "[@electron-memory/monitor] ensureDashboardProtocolHandler: app must be ready before opening dashboard"
+    );
+  }
+  handlerRegistered = true;
+  const base = path2.resolve(uiRoot);
+  import_electron2.protocol.handle(SCHEME, (request) => {
+    try {
+      const { pathname } = new URL(request.url);
+      let rel = pathname.startsWith("/") ? pathname.slice(1) : pathname;
+      if (!rel) {
+        rel = "index.html";
+      }
+      const filePath = path2.resolve(path2.join(base, rel));
+      if (!isPathInsideRoot(filePath, base)) {
+        return new Response("Forbidden", { status: 403 });
+      }
+      return import_electron2.net.fetch((0, import_node_url.pathToFileURL)(filePath).href);
+    } catch {
+      return new Response("Bad Request", { status: 400 });
+    }
+  });
+}
+function getDashboardPageURL() {
+  return `${SCHEME}://electron/index.html`;
+}
+
+// src/core/dashboard.ts
 var DashboardManager = class {
   constructor(config) {
     this.window = null;
@@ -1130,8 +1199,8 @@ var DashboardManager = class {
       this.window.focus();
       return;
     }
-    const preloadPath = path2.join(__dirname, "dashboard-preload.js");
-    this.window = new import_electron2.BrowserWindow({
+    const preloadPath = path3.join(__dirname, "dashboard-preload.js");
+    this.window = new import_electron3.BrowserWindow({
       width: this.config.dashboard.width,
       height: this.config.dashboard.height,
       title: "Electron Memory Monitor",
@@ -1142,8 +1211,9 @@ var DashboardManager = class {
         nodeIntegration: false
       }
     });
-    const uiPath = path2.join(__dirname, "ui", "index.html");
-    this.window.loadFile(uiPath);
+    const uiRoot = path3.join(__dirname, "ui");
+    ensureDashboardProtocolHandler(uiRoot);
+    this.window.loadURL(getDashboardPageURL());
     this.window.on("closed", () => {
       this.window = null;
     });
@@ -1165,7 +1235,7 @@ var DashboardManager = class {
 };
 
 // src/ipc/main-handler.ts
-var import_electron3 = require("electron");
+var import_electron4 = require("electron");
 
 // src/ipc/channels.ts
 var IPC_CHANNELS = {
@@ -1203,49 +1273,49 @@ var IPCMainHandler = class {
   }
   /** 注册所有 IPC handlers */
   register() {
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_START, (_event, args) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_START, (_event, args) => {
       return this.monitor.startSession(args.label, args.description);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_STOP, async () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_STOP, async () => {
       return this.monitor.stopSession();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_LIST, async () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_LIST, async () => {
       return this.monitor.getSessions();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_REPORT, async (_event, sessionId) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_REPORT, async (_event, sessionId) => {
       return this.monitor.getSessionReport(sessionId);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_COMPARE, async (_event, args) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_COMPARE, async (_event, args) => {
       return this.monitor.compareSessions(args.baseId, args.targetId);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_SNAPSHOTS, async (_event, args) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_SNAPSHOTS, async (_event, args) => {
       return this.monitor.getSessionSnapshots(args.sessionId, args.startTime, args.endTime, args.maxPoints);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.TRIGGER_GC, async () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.TRIGGER_GC, async () => {
       return this.monitor.triggerGC();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.HEAP_SNAPSHOT, async (_event, filePath) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.HEAP_SNAPSHOT, async (_event, filePath) => {
       return this.monitor.takeHeapSnapshot(filePath);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.MARK, (_event, args) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.MARK, (_event, args) => {
       this.monitor.mark(args.label, args.metadata);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.GET_CONFIG, () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.GET_CONFIG, () => {
       return this.monitor.getConfig();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.GET_SESSIONS, async () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.GET_SESSIONS, async () => {
       return this.monitor.getSessions();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_EXPORT, async (_event, sessionId) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_EXPORT, async (_event, sessionId) => {
       return this.monitor.exportSession(sessionId);
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_IMPORT, async () => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_IMPORT, async () => {
       return this.monitor.importSession();
     });
-    import_electron3.ipcMain.handle(IPC_CHANNELS.SESSION_DELETE, async (_event, sessionId) => {
+    import_electron4.ipcMain.handle(IPC_CHANNELS.SESSION_DELETE, async (_event, sessionId) => {
       return this.monitor.deleteSession(sessionId);
     });
-    import_electron3.ipcMain.on(IPC_CHANNELS.RENDERER_REPORT, (_event, detail) => {
+    import_electron4.ipcMain.on(IPC_CHANNELS.RENDERER_REPORT, (_event, detail) => {
       this.monitor.updateRendererDetail(detail);
     });
   }
@@ -1265,8 +1335,8 @@ var IPCMainHandler = class {
   unregister() {
     const channels = Object.values(IPC_CHANNELS);
     for (const channel of channels) {
-      import_electron3.ipcMain.removeHandler(channel);
-      import_electron3.ipcMain.removeAllListeners(channel);
+      import_electron4.ipcMain.removeHandler(channel);
+      import_electron4.ipcMain.removeAllListeners(channel);
     }
   }
 };
@@ -1313,6 +1383,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
       this.dashboard = null;
       return;
     }
+    registerDashboardSchemePrivileged();
     this.collector = new MemoryCollector(this.config);
     this.anomalyDetector = new AnomalyDetector(this.config);
     this.analyzer = new Analyzer();
@@ -1325,10 +1396,10 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
   /** 启动监控 */
   async start() {
     if (!this.config.enabled || this.started) return;
-    if (!import_electron4.app.isReady()) {
-      await import_electron4.app.whenReady();
+    if (!import_electron5.app.isReady()) {
+      await import_electron5.app.whenReady();
     }
-    const storageDir = this.config.storage.directory || path3.join(import_electron4.app.getPath("userData"), "memory-monitor");
+    const storageDir = this.config.storage.directory || path4.join(import_electron5.app.getPath("userData"), "memory-monitor");
     this.persister = new DataPersister(this.config, storageDir);
     this.sessionManager = new SessionManager(this.persister);
     this.ipcHandler = new IPCMainHandler(this);
@@ -1400,7 +1471,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
       anomalies,
       completedSession.dataFile
     );
-    const reportPath = path3.join(this.persister.getStorageDir(), completedSession.id, "report.json");
+    const reportPath = path4.join(this.persister.getStorageDir(), completedSession.id, "report.json");
     const fs2 = await import("fs");
     fs2.writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf-8");
     this.emit("session-end", report);
@@ -1430,7 +1501,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
   /** 获取指定会话报告 */
   async getSessionReport(sessionId) {
     const fs2 = await import("fs");
-    const reportPath = path3.join(this.persister.getStorageDir(), sessionId, "report.json");
+    const reportPath = path4.join(this.persister.getStorageDir(), sessionId, "report.json");
     try {
       const content = fs2.readFileSync(reportPath, "utf-8");
       return JSON.parse(content);
@@ -1561,7 +1632,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
       } catch {
       }
     }
-    await new Promise((resolve) => setTimeout(resolve, 100));
+    await new Promise((resolve2) => setTimeout(resolve2, 100));
     const afterMem = process.memoryUsage();
     const freed = beforeMem.heapUsed - afterMem.heapUsed;
     return {
@@ -1574,7 +1645,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
   }
   /** 导出堆快照 */
   async takeHeapSnapshot(filePath) {
-    const snapshotPath = filePath || path3.join(
+    const snapshotPath = filePath || path4.join(
       this.persister.getStorageDir(),
       `heap-${Date.now()}.heapsnapshot`
     );
@@ -1635,6 +1706,7 @@ var ElectronMemoryMonitor = class extends import_events3.EventEmitter {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ElectronMemoryMonitor,
-  IPC_CHANNELS
+  IPC_CHANNELS,
+  registerDashboardSchemePrivileged
 });
 //# sourceMappingURL=index.js.map