Lifecycle hooks and utilities

// Triggers when Electron has finished booting (app.whenReady())
lynxApi.onAppReady(callback: () => Promise<void>): void;

// Triggers when the main BrowserWindow is ready to show
lynxApi.onReadyToShow(callback: () => void): void;

// Registers custom IPC channels (on/handle listeners)
lynxApi.listenForChannels(callback: () => void): void;

import {MenuItemConstructorOptions} from 'electron';

lynxApi.trayMenu_AddItem(callback: () => {
  item: MenuItemConstructorOptions;
  index: number;
}): void;

lynxApi.trayMenu_AddItem(() => {
  return {
    item: {
      label: 'Restart LynxHub Backend',
      click: async () => {
        const appManager = await utils.getAppManager();
        appManager.restart();
      },
    },
    index: 2, // Index position inside the dropdown menu list
  };
});

const scope = lynxApi.initNodeSentry('https://your-sentry-dsn@sentry.io/project');
scope.setTag('backend_extension', 'active');

const ptyProcess = utils.nodePty.spawn('python', ['-m', 'venv', 'venv-dir'], {
  name: 'xterm-color',
  cols: 80,
  rows: 24,
  cwd: '/project-dir',
  env: process.env,
});

const appManager = await utils.getAppManager();

// Retrieve window objects
const win = appManager.getMainWindow(); // Returns BrowserWindow
const web = appManager.getWebContent(); // Returns WebContents

// Send raw IPC events to the frontend
appManager.sendMessage('custom-channel', {status: 'updated'});

// Relaunch the application
appManager.restart();

const moduleManager = await utils.getModuleManager();

// Retrieve methods registered by card modules
const methods = moduleManager.getMethodsById(cardId);

// Uninstall card modules
await moduleManager.uninstallCardByID(cardId);