@dimensional-innovations/electron-background 2.2.0 → 2.2.2

package/README.md

@@ -73,7 +73,7 @@ init({
 ```
 
 ### AutoStart
-Registers the application as a login item so it launches automatically at system startup. On Windows, boot-initiated launches are detected via a `--autostart` argument, allowing an optional delay before window creation. On macOS/Linux the delay is skipped since boot detection is not reliable.
+Registers the application as a login item so it launches automatically at system startup. On Windows, boot-initiated launches are detected via a `--autostart` argument, allowing an optional delay before initialization. On macOS/Linux the delay is skipped since boot detection is not reliable.
 
 ```typescript
 // Default: 30-second delay on boot launches

package/dist/AutoStart.d.ts

@@ -1,12 +1,14 @@
-import { InitPlugin, NonBrowserWindowInitContext } from './init';
+import { BrowserWindowInitContext, InitPlugin } from './init';
 export interface AutoStartOptions {
-    /** Delay in seconds before window creation on boot launches (0 = no delay). Default: 30 */
+    /** 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 window creation. The delay only applies when the app was auto-started at
- * system boot (detected via the `--autostart` process argument on Windows).
+ * delays content loading on boot. The delay runs in `beforeLoad` — the window is
+ * already created and visible (black background) while waiting, so it 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,5 +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;
-    afterReady(context: NonBrowserWindowInitContext): Promise<void>;
+    beforeLoad(context: BrowserWindowInitContext): 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 window creation. The delay only applies when the app was auto-started at
- * system boot (detected via the `--autostart` process argument on Windows).
+ * delays content loading on boot. The delay runs in `beforeLoad` — the window is
+ * already created and visible (black background) while waiting, so it 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,14 +37,25 @@ class AutoStart {
     isAutoStartLaunch() {
         return process.platform === 'win32' && process.argv.includes(AUTOSTART_ARG);
     }
-    afterReady(context) {
+    beforeLoad(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 loading content`);
+                yield new Promise(resolve => setTimeout(resolve, this.startupDelay * 1000));
+            }
+            else if (this.startupDelay > 0) {
+                context.log.info('[AutoStart] Manual launch — skipping startup delay');
+            }
+        });
+    }
+    afterLoad(context) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.enabled) {
                 context.log.info('[AutoStart] Disabled (not packaged)');
                 return;
             }
-            // On Windows, include the autostart arg so boot launches can be distinguished
-            // from manual launches. On other platforms, no args needed.
             try {
                 if (process.platform === 'win32') {
                     electron_1.app.setLoginItemSettings({ openAtLogin: true, args: [AUTOSTART_ARG] });
@@ -55,15 +68,6 @@ class AutoStart {
             catch (err) {
                 context.log.error('[AutoStart] Failed to register login item:', err);
             }
-            if (this.startupDelay > 0 && this.isAutoStartLaunch()) {
-                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) {
-                context.log.info('[AutoStart] Manual launch — skipping startup delay');
-            }
         });
     }
 }

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.0",
+  "version": "2.2.2",
   "description": "the background script for electron apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",