Function event

main.js:318–354

(clientId, category, action, options = {})

const DEBUG = false; // Set to true for development/debugging
const PING_INTERVAL = 30000; // 30 seconds

function debugLog(...args) {
  if (DEBUG) {
    console.log(...args);
  }
}

// Server mode detection
const isServerMode = process.argv.includes('--server');
let httpServer = null;
let httpServerEpoch = 0;
let http80Server = null;
let electronUiServer = null;
let electronUiPort = null;
let wss = null; // WebSocket server
let wsClients = null; // WebSocket clients Set
let letsEncryptRenewInFlight = false;

// Store pending context menu actions for server mode (browser access)
const pendingContextMenus = new Map();
let contextMenuRequestIdCounter = 0;

// Handler registry for WebSocket IPC calls in server mode
// This allows us to directly invoke handlers without going through the renderer
const ipcHandlerRegistry = new Map();

// Auto-register every ipcMain.handle into the WebSocket registry.
// Without this, Docker/server-mode falls back to executeJavaScript on the hidden
// window for unregistered channels (e.g. getThumbnail) — which hangs/times out.
const _ipcMainHandle = ipcMain.handle.bind(ipcMain);
ipcMain.handle = (channel, handler) => {
  ipcHandlerRegistry.set(channel, handler);
  return _ipcMainHandle(channel, handler);
};

// Helper function to register IPC handlers and add them to the registry
function registerIpcHandler(channel, handler) {
  ipcMain.handle(channel, handler);
}