@dimensional-innovations/electron-background 2.2.1 → 2.2.3

package/dist/AutoStart.d.ts

@@ -1,12 +1,14 @@
-import { BrowserWindowInitContext, InitPlugin, NonBrowserWindowInitContext } from './init';
+import { BrowserWindowInitContext, NonBrowserWindowInitContext, InitPlugin } from './init';
 export interface AutoStartOptions {
     /** Delay in seconds before initialization on boot launches (0 = no delay). Default: 30 */
     startupDelay?: number;
 }
 /**
  * Registers the application as a login item for automatic startup and optionally
- * delays initialization on boot. The delay only applies when the app was auto-started
- * at system boot (detected via the `--autostart` process argument on Windows).
+ * delays window creation on boot. The delay runs in `afterReady` — before the
+ * BrowserWindow is created — giving the GPU and display time to initialize after
+ * a system reboot. The delay only applies when the app was auto-started at system
+ * boot (detected via the `--autostart` process argument on Windows).
  *
  * On macOS/Linux, boot detection is not reliably possible, so the delay is always
  * skipped — the app launches instantly regardless of how it was started.
@@ -21,6 +23,6 @@ export declare class AutoStart implements InitPlugin {
     constructor(enabled?: boolean, options?: AutoStartOptions);
     /** Returns true when the app was launched by the OS login item (Windows only). */
     private isAutoStartLaunch;
-    beforeReady(context: NonBrowserWindowInitContext): Promise<void>;
+    afterReady(context: NonBrowserWindowInitContext): Promise<void>;
     afterLoad(context: BrowserWindowInitContext): Promise<void>;
 }

package/dist/AutoStart.js

@@ -15,8 +15,10 @@ const electron_1 = require("electron");
 const AUTOSTART_ARG = '--autostart';
 /**
  * Registers the application as a login item for automatic startup and optionally
- * delays initialization on boot. The delay only applies when the app was auto-started
- * at system boot (detected via the `--autostart` process argument on Windows).
+ * delays window creation on boot. The delay runs in `afterReady` — before the
+ * BrowserWindow is created — giving the GPU and display time to initialize after
+ * a system reboot. The delay only applies when the app was auto-started at system
+ * boot (detected via the `--autostart` process argument on Windows).
  *
  * On macOS/Linux, boot detection is not reliably possible, so the delay is always
  * skipped — the app launches instantly regardless of how it was started.
@@ -35,12 +37,12 @@ class AutoStart {
     isAutoStartLaunch() {
         return process.platform === 'win32' && process.argv.includes(AUTOSTART_ARG);
     }
-    beforeReady(context) {
+    afterReady(context) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.enabled)
                 return;
             if (this.startupDelay > 0 && this.isAutoStartLaunch()) {
-                context.log.info(`[AutoStart] Boot launch detected — delaying ${this.startupDelay}s before initialization`);
+                context.log.info(`[AutoStart] Boot launch detected — delaying ${this.startupDelay}s before window creation`);
                 yield new Promise(resolve => setTimeout(resolve, this.startupDelay * 1000));
             }
             else if (this.startupDelay > 0) {

package/dist/init.js

@@ -39,6 +39,25 @@ class InitContext {
     }
 }
 exports.InitContext = InitContext;
+function getPluginName(plugin) {
+    var _a;
+    return ((_a = plugin.constructor) === null || _a === void 0 ? void 0 : _a.name) || 'UnknownPlugin';
+}
+function runPluginPhase(plugins, phase, context, logger) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const plugin of plugins) {
+            const method = plugin[phase];
+            if (method) {
+                try {
+                    yield method.call(plugin, context);
+                }
+                catch (err) {
+                    logger.error(`[init] Plugin "${getPluginName(plugin)}" threw during ${phase}:`, err);
+                }
+            }
+        }
+    });
+}
 /**
  * Initializes the application, creating a browser window, and loads the provided app url.
  *
@@ -55,29 +74,21 @@ function init({ appUrl, browserWindowOptions = { height: 1920, width: 1080, back
         });
         process.on('SIGTERM', electron_1.app.quit);
         const context = new InitContext(appUrl, browserWindowOptions, electron_log_1.default);
-        for (const plugin of plugins) {
-            if (plugin.beforeReady) {
-                yield plugin.beforeReady(context);
-            }
-        }
+        yield runPluginPhase(plugins, 'beforeReady', context, electron_log_1.default);
         yield electron_1.app.whenReady();
-        for (const plugin of plugins) {
-            if (plugin.afterReady) {
-                yield plugin.afterReady(context);
-            }
-        }
+        yield runPluginPhase(plugins, 'afterReady', context, electron_log_1.default);
         context.browserWindow = new electron_1.BrowserWindow(context.browserWindowOptions);
-        for (const plugin of plugins) {
-            if (plugin.beforeLoad) {
-                yield plugin.beforeLoad(context);
-            }
+        yield runPluginPhase(plugins, 'beforeLoad', context, electron_log_1.default);
+        try {
+            yield context.browserWindow.loadURL(context.appUrl);
         }
-        yield context.browserWindow.loadURL(context.appUrl);
-        for (const plugin of plugins) {
-            if (plugin.afterLoad) {
-                yield plugin.afterLoad(context);
-            }
+        catch (err) {
+            electron_log_1.default.error('[init] Failed to load app URL:', err);
+        }
+        if (context.browserWindow && !context.browserWindow.isDestroyed() && !context.browserWindow.isVisible()) {
+            context.browserWindow.show();
         }
+        yield runPluginPhase(plugins, 'afterLoad', context, electron_log_1.default);
         context.browserWindow.on('closed', () => context.browserWindow = undefined);
         return context;
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimensional-innovations/electron-background",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "description": "the background script for electron apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",