fix(smartpdf): lazily initialize SmartPdf, stop it only when present, and make evaluateOnPage reliably close pages

changelog.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026-03-09 - 2.0.9 - fix(smartpdf)
+lazily initialize SmartPdf, stop it only when present, and make evaluateOnPage reliably close pages
+
+- Add private ensureSmartPdf() to lazily initialize and start SmartPdf only when PDF methods are called
+- Call ensureSmartPdf() in pdfFromPage() before using smartpdf
+- Stop SmartPdf in stop() only if it was initialized and clear the reference
+- Wrap evaluateOnPage() page operations in try/finally and safely ignore errors from page.close() to avoid resource leaks or uncaught exceptions
+
 ## 2025-01-03 - 2.0.8 - fix(core)
 Ensure consistent browser automation functionality
 

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartbrowser',
-  version: '2.0.8',
+  version: '2.0.9',
   description: 'A simplified Puppeteer wrapper for easy automation and testing tasks.'
 }

ts/index.ts

@@ -14,16 +14,28 @@ export class SmartBrowser {
    */
   public async start() {
     this.headlessBrowser = await plugins.smartpuppeteer.getEnvAwareBrowserInstance();
-    this.smartpdf = new plugins.smartpdf.SmartPdf();
-    await this.smartpdf.start(this.headlessBrowser);
+    // SmartPdf is lazy-initialized only when PDF methods are called
+  }
+
+  /**
+   * ensure SmartPdf is initialized (lazy)
+   */
+  private async ensureSmartPdf() {
+    if (!this.smartpdf) {
+      this.smartpdf = new plugins.smartpdf.SmartPdf();
+      await this.smartpdf.start(this.headlessBrowser);
+    }
   }
 
   /**
    * stop the SmartBrowser instance
    */
   public async stop() {
+    if (this.smartpdf) {
+      await this.smartpdf.stop();
+      this.smartpdf = null;
+    }
     await this.headlessBrowser.close();
-    await this.smartpdf.stop();
   }
 
   /**
@@ -31,6 +43,7 @@ export class SmartBrowser {
    * @param urlArg
    */
   public async pdfFromPage(urlArg: string): Promise<plugins.smartpdf.IPdf> {
+    await this.ensureSmartPdf();
     const result = await this.smartpdf.getFullWebsiteAsSinglePdf(urlArg);
     return result;
   }
@@ -63,12 +76,15 @@ export class SmartBrowser {
    */
   public async evaluateOnPage<T>(urlArg: string, funcArg: () => Promise<T>) {
     const page = await this.headlessBrowser.newPage();
-    await page.goto(urlArg, {
-      waitUntil: 'networkidle2',
-    });
-    const result = await page.evaluate(funcArg);
-    await page.close();
-    return result;
+    try {
+      await page.goto(urlArg, {
+        waitUntil: 'networkidle2',
+      });
+      const result = await page.evaluate(funcArg);
+      return result;
+    } finally {
+      try { await page.close(); } catch (e) { /* page may already be closed */ }
+    }
   }
 }