main-lifecycle.js

'use strict';

/**
 * main-lifecycle.js — жизненный цикл приложения: единственный экземпляр,
 * старт (восстановление, первое окно, трей), выход.
 *
 * Здесь ничего не создаётся «про запас»: модули уже собраны точкой входа, а
 * этот модуль решает, КОГДА что звать. Порядок старта несущий и записан в
 * комментариях ниже — накопитель читается до окон, восстановление до панели.
 *
 * Модуль не требует electron: app, Menu, powerMonitor и
 * nativeImage передаёт точка входа.
 */

const path = require('path');
const { FULLSCREEN_EXIT_TIMEOUT_MS } = require('./main-window-closing');

/**
 * @param {object} deps
 * @param {object} deps.app
 * @param {object} deps.Menu
 * @param {object} deps.powerMonitor
 * @param {object} deps.nativeImage
 * @param {object} deps.log
 * @param {typeof import('./utils.js').safelySendToWindow} deps.safelySendToWindow
 * @param {() => object} deps.getSession — electron.session, берётся в момент вызова
 * @param {() => void} deps.registerProtocol — обработчик схемы app:// (SEC-12)
 * @param {() => Promise<{dispose: Function}>} deps.prepareStorage — перенос
 *        localStorage file:// → app:// (main-storage-migration.js)
 * @param {object} deps.windows — реестр окон (main-state.js)
 * @param {object} deps.flags — флаги приложения (main-state.js)
 * @param {object} deps.timer — main-timer.js
 * @param {object} deps.recoverySnapshot — main-recovery.js
 * @param {object} deps.events — main-event-overrun.js
 * @param {{loadOnStart: Function, flush: Function}} deps.relayStore — память
 *        ретрансляторов в файле (relay-store.js)
 * @param {object} deps.creators — main-windows.js
 * @param {object} deps.tray — main-tray.js
 * @param {boolean} deps.inTestMode
 * @param {boolean} deps.screenshotMode
 * @param {number} deps.startupT0 — метка начала процесса (perf)
 * @param {string} [deps.platform] - process.platform (подменяется в тестах)
 */
function startApp(deps) {
    const {
        app, Menu, powerMonitor, nativeImage, log, safelySendToWindow, getSession,
        registerProtocol, prepareStorage,
        windows, flags, timer, recoverySnapshot, events, relayStore, creators, tray
    } = deps;
    const __inTestMode = deps.inTestMode;
    const __screenshotMode = deps.screenshotMode;
    const __startupT0 = deps.startupT0;
    const platform = deps.platform || process.platform;
    const { createControlWindow, createWidgetWindow, createClockWidgetWindow, createDisplayWindow } = creators;

    /**
     * Выход из приложения при открытом полноэкранном дисплее.
     *
     * Та же авария, что и у `closeDisplayWindow`, только вход другой: на выходе
     * окна разрушаются, macOS запускает анимацию выхода из полноэкранного режима и
     * обходит все окна — по освобождённой памяти. В прогоне e2e приложение гасят
     * больше двух сотен раз, и падение выглядело нестабильностью случайного теста.
     *
     * Выход ОТКЛАДЫВАЕТСЯ ровно один раз и не дольше страховки: приложение,
     * которое не закрывается, хуже приложения, которое падает при закрытии.
     * `before-quit` после этого сработает второй раз — оба его действия
     * (`isQuitting`, удаление снимка восстановления) идемпотентны.
     */
    let __leavingFullScreenToQuit = false;

    // Идёт перенос настроек file:// → app:// (до первого окна).
    let __preparingStorage = false;

    // Единственный экземпляр решается ДО обработчиков выхода: второй экземпляр
    // выходит сразу (app.quit() ниже), и его before-quit — тот же обработчик,
    // что у основного. Пустой процесс не вправе трогать общий профиль: он
    // стирал снимок восстановления ЖИВОГО основного (last-state.json) и
    // перезаписывал бы память ретрансляторов пустой.
    const __singleInstance = __inTestMode || __screenshotMode
        || typeof app.requestSingleInstanceLock !== 'function'
        || app.requestSingleInstanceLock();

    app.on('before-quit', (event) => {
        if (!__singleInstance) { flags.isQuitting = true; return; }
        const win = windows.displayWindow;
        if (!__leavingFullScreenToQuit && win && !win.isDestroyed() && win.isFullScreen()) {
            __leavingFullScreenToQuit = true;
            event.preventDefault();
            const again = () => app.quit();
            const fallback = setTimeout(again, FULLSCREEN_EXIT_TIMEOUT_MS);
            win.once('leave-full-screen', () => {
                clearTimeout(fallback);
                setTimeout(again, 120);
            });
            win.setFullScreen(false);
            return;
        }

        flags.isQuitting = true;
        // Живой перелимит — в накопитель до выхода (BUG-04). Снимок
        // восстановления ниже стирается, таймер не вернётся — значит, доклад
        // кончился вместе с приложением.
        events.closeTalkOnQuit();
        // Stop the periodic save BEFORE unlinking, so an in-flight 10s tick can't
        // re-create the recovery file after we delete it.
        recoverySnapshot.stopPeriodicSave();
        recoverySnapshot.clearSavedTimerState();
        // Память ретрансляторов пишется с задержкой-склейкой — отложенное
        // дописывается здесь, иначе последняя правка перед выходом терялась бы.
        relayStore.flush();
    });

    // Посылка, пришедшая уже после before-quit (окна закрываются), — тоже в файл.
    app.on('will-quit', () => {
        if (!__singleInstance) { return; }
        relayStore.flush();
    });

    // Single-instance lock: a tray utility with autostart is easy to launch twice.
    // A duplicate instance would spawn a second tray + timer and race the shared
    // recovery file. Take the primary lock and focus the existing window instead.
    // Показать панель: второй экземпляр и клик по Dock — один путь.
    function revealControlWindow() {
        // Пока идёт перенос настроек, панели ещё нет — и создавать её
        // рано: окно на пустом app:// записало бы умолчания раньше, чем
        // туда придут настройки пользователя. Старт создаст её сам.
        if (__preparingStorage) { return; }
        if (!windows.controlWindow) { createControlWindow(); return; }
        if (windows.controlWindow.isMinimized()) { windows.controlWindow.restore(); }
        if (!windows.controlWindow.isVisible()) { windows.controlWindow.show(); }
        windows.controlWindow.focus();
    }

    if (!__singleInstance) {
        app.quit();
    } else {
        app.on('second-instance', revealControlWindow);
        // Память ретрансляторов — ДО любого окна, синхронно и раньше whenReady:
        // окно, открытое до первой посылки панели (из трея, клавишей), получает
        // снимок из неё (relay-store.js). Второй экземпляр файл не трогает.
        relayStore.loadOnStart();
    }

    app.whenReady().then(async () => {
        // Duplicate instance — we already called app.quit() above; do nothing.
        if (!__singleInstance) { return; }

        // Схема app:// — раньше любого окна: окна и страница миграции грузятся с неё.
        registerProtocol();

        // Меню Electron по умолчанию (File, Edit, View с DevTools, Help) снято.
        // На macOS меню null отнимает и системные клавиши: Cmd+C/V/X/A/Z в
        // полях панели и Cmd+Q/H идут через роли меню приложения (MAIN-10).
        // Поэтому там — ровно appMenu и editMenu: в них нет ни DevTools, ни
        // перезагрузки (это роли viewMenu), и выход по Cmd+Q — тот же
        // app.quit(), что пункт трея «Выход».
        Menu.setApplicationMenu(platform === 'darwin'
            ? Menu.buildFromTemplate([{ role: 'appMenu' }, { role: 'editMenu' }])
            : null);

        // Сон машины — см. bindPowerMonitor в main-timer.js.
        timer.bindPowerMonitor(powerMonitor, log);

        // Deny every renderer permission request (camera/mic/geo/notifications/…).
        // This is a purely offline timer — it never needs any web/device permission.
        // Defense-in-depth on top of sandbox/contextIsolation/CSP/will-navigate.
        //
        // R2/R4 (добивка перед повторной сдачей ПСИ, 2026-09-28): три вызова
        // ниже под `typeof … === 'function'` — сами методы стоят с версии
        // Electron, которая новее подставок старых тестов
        // (`session.defaultSession` там может быть `{}`, см.
        // tests/main-lifecycle-hardening.test.js). Гард — не только «не упасть»:
        // все вызовы стоят в ОДНОМ try, и необработанное исключение от
        // отсутствующего метода обрывало бы try ПОСЛЕ первого брошенного —
        // соседние строки, включая уже существовавший
        // setPermissionRequestHandler, просто не выполнились бы.
        try {
            const session = getSession();
            // Орфография тянет словарь Hunspell по сети (R2) — офлайновому
            // таймеру сеть не нужна ни для чего. Дублирует `spellcheck: false`
            // у каждого окна (main-windows.js) — тот гасит подчёркивание в
            // самом окне, этот — фоновую загрузку словаря сессией.
            if (typeof session.defaultSession.setSpellCheckerEnabled === 'function') {
                session.defaultSession.setSpellCheckerEnabled(false);
            }
            session.defaultSession.setPermissionRequestHandler((_wc, _permission, callback) => callback(false));
            session.defaultSession.setPermissionCheckHandler(() => false);
            // Явный запрет устройств (WebHID/WebUSB/WebSerial/Bluetooth, …) и
            // захвата экрана (getDisplayMedia) — R4. Второй замок над тем же
            // setPermissionRequestHandler: некоторые запросы устройств идут
            // отдельным API мимо обычного permission-потока.
            if (typeof session.defaultSession.setDevicePermissionHandler === 'function') {
                session.defaultSession.setDevicePermissionHandler(() => false);
            }
            if (typeof session.defaultSession.setDisplayMediaRequestHandler === 'function') {
                // callback без источника — отказ getDisplayMedia() без подвешивания промиса вызывающей страницы.
                session.defaultSession.setDisplayMediaRequestHandler((_request, callback) => callback({}));
            }
        } catch (err) {
            log.warn('Permission handler setup failed:', err);
        }

        // Recovery check before UI. Restore the FULL snapshot (remaining/total/preset)
        // so a crash mid-countdown comes back with the in-progress time intact. We never
        // auto-start (isRunning stays false); the timer simply shows where it was paused.
        // Накопитель мероприятия читается ДО открытия окон: гидратация окна
        // дисплея снимает ему уже прочитанное значение.
        events.loadOnStart();

        const saved = recoverySnapshot.loadSavedTimerState();
        const hasRecovery = recoverySnapshot.isRecoveryValid(saved, Date.now());
        if (hasRecovery) {
            log.info(`Recovery candidate found (age ${Math.round((Date.now() - saved.savedAt) / 1000)}s)`);
            timer.restoreState(saved);
            // control window may also offer an explicit resume via timer-recovery-available
        }

        // Живой перелимит, записанный при сбое (BUG-04), — в итог ровно один раз
        // (см. foldPendingOnStart в main-event-overrun.js).
        events.foldPendingOnStart(hasRecovery ? timer.getState().remainingSeconds : null);

        // Настройки пользователя — в новый origin ДО первого окна: панель,
        // открытая на пустом app://, записала бы свои умолчания, и перенос
        // (он не перезаписывает существующее) их бы уже не тронул. Сбой
        // переноса старт не останавливает: приложение без настроек лучше
        // приложения, которое не открывается.
        let storage = { dispose: () => {} };
        __preparingStorage = true;
        try {
            storage = await prepareStorage();
        } catch (err) {
            log.error('[migration] перенос настроек упал:', err && err.message ? err.message : err);
        } finally {
            __preparingStorage = false;
        }

        createControlWindow();
        // Скрытое окно переноса гасится ПОСЛЕ панели: закрытое последнее окно
        // — это window-all-closed, а на нём Windows и Linux выходят.
        storage.dispose();

        if (__screenshotMode) {
            const runner = require('./scripts/screenshot-runner');
            windows.controlWindow.webContents.once('did-finish-load', () => {
                runner.run({
                    app, log, nativeImage,
                    ctx: () => ({
                        control: windows.controlWindow, widget: windows.widgetWindow,
                        clock: windows.clockWidgetWindow, display: windows.displayWindow
                    }),
                    applyTimerState: (s) => timer.emitTimerState(s),
                    openWidget: () => { if (!windows.widgetWindow) { createWidgetWindow(); } },
                    openClock: () => { if (!windows.clockWidgetWindow) { createClockWidgetWindow(); } },
                    openDisplay: () => { if (!windows.displayWindow) { createDisplayWindow('auto'); } },
                    outDir: path.join(__dirname, 'screenshots')
                }).catch((err) => {
                    log.error('[screenshot] sequence failed:', err);
                    app.exit(1);
                });
            });
            return; // skip tray + normal activate hooks in screenshot mode
        }

        tray.createTray();
        // bindTrayBehavior вызывается внутри createControlWindow — здесь повторять
        // нельзя: второй обработчик 'close' навесился бы на то же окно.

        // F-005: broadcast recovery snapshot to control window once it has loaded.
        // Renderer may ignore it for now, but the channel is no longer dead code.
        if (hasRecovery && windows.controlWindow) {
            windows.controlWindow.webContents.once('did-finish-load', () => {
                safelySendToWindow(windows.controlWindow, 'timer-recovery-available', saved);
            });
        }

        log.info(`[perf] app ready in ${Date.now() - __startupT0}ms`);

        // Клик по иконке в Dock (macOS). Панель, закрытая крестиком при трее,
        // СПРЯТАНА (hide), а не закрыта, и в getAllWindows() остаётся — проверка
        // «окон ноль» не давала Dock'у её вернуть, только трей (MAIN-06).
        app.on('activate', revealControlWindow);
    });

    app.on('window-all-closed', () => {
        timer.clearTimerInterval(); // Очищаем интервал таймера при закрытии
        if (platform !== 'darwin') {
            app.quit();
        }
    });
}

module.exports = { startApp };