Electron Updater

// main.ts
import { app, BrowserWindow } from 'electron';
import * as path from 'path';
import {
  ElectronUpdater,
  setupIPCHandlers,
  setupEventForwarding,
} from '@capgo/electron-updater';

const updater = new ElectronUpdater({
  appId: 'com.example.app',
  autoUpdate: true,
});

app.whenReady().then(async () => {
  const mainWindow = new BrowserWindow({
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
    },
  });

  // Initialize updater with window and builtin path
  const builtinPath = path.join(__dirname, 'www/index.html');
  await updater.initialize(mainWindow, builtinPath);

  // Setup IPC communication
  setupIPCHandlers(updater);
  setupEventForwarding(updater, mainWindow);

  // Load the current bundle (either builtin or downloaded)
  await mainWindow.loadFile(updater.getCurrentBundlePath());
});

// preload.ts
import { exposeUpdaterAPI } from '@capgo/electron-updater/preload';

exposeUpdaterAPI();

// renderer.ts
import { requireUpdater } from '@capgo/electron-updater/renderer';

const updater = requireUpdater();

// IMPORTANT: Call this on every app launch!
await updater.notifyAppReady();

// Check for updates manually
const latest = await updater.getLatest();
if (latest.url && !latest.error) {
  // Download the update
  const bundle = await updater.download({
    url: latest.url,
    version: latest.version,
    checksum: latest.checksum,
  });

  // Queue for next restart
  await updater.next({ id: bundle.id });
}

// Listen for events
updater.addListener('download', (event) => {
  console.log(`Download progress: ${event.percent}%`);
});

updater.addListener('updateFailed', (event) => {
  console.error('Update failed:', event.bundle.version);
});

const updater = new ElectronUpdater({
  // Core
  appId: 'com.example.app',
  version: '1.0.0', // Override builtin version
  autoUpdate: true, // Enable auto-updates (default: true)
  appReadyTimeout: 10000, // MS before rollback (default: 10000)

  // Server URLs
  updateUrl: 'https://plugin.capgo.app/updates',
  channelUrl: 'https://plugin.capgo.app/channel_self',
  statsUrl: 'https://plugin.capgo.app/stats',

  // Security
  publicKey: '...', // For E2E encryption

  // Channels
  defaultChannel: 'production',

  // Behavior
  autoDeleteFailed: true, // Delete failed bundles
  autoDeletePrevious: true, // Delete old bundles
  resetWhenUpdate: true, // Reset on native update

  // Direct Update
  directUpdate: false, // 'atInstall' | 'onLaunch' | 'always' | false

  // Dynamic Config
  allowModifyUrl: false, // Allow runtime URL changes
  allowModifyAppId: false, // Allow runtime App ID changes
  persistCustomId: false, // Persist custom ID
  persistModifyUrl: false, // Persist URL changes

  // Debug
  debugMenu: false, // Enable debug menu (Ctrl+Shift+D)
  disableJSLogging: false, // Disable console logs

  // Periodic Updates
  periodCheckDelay: 0, // Seconds between checks (0 = disabled, min 600)
});

const updater = new ElectronUpdater({
  debugMenu: true,
});