apex-auditor 0.1.3 → 0.1.5

package/dist/cli.js

@@ -34,8 +34,8 @@ export async function runAuditCli(argv) {
 }
 function buildMarkdown(results) {
     const header = [
-        "| Label | Path | Device | P | A | BP | SEO | LCP (s) | FCP (s) | TBT (ms) | CLS | Top issues |",
-        "|-------|------|--------|---|---|----|-----|---------|---------|----------|-----|-----------|",
+        "| Label | Path | Device | P | A | BP | SEO | LCP (s) | FCP (s) | TBT (ms) | CLS | Error | Top issues |",
+        "|-------|------|--------|---|---|----|-----|---------|---------|----------|-----|-------|-----------|",
     ].join("\n");
     const lines = results.map((result) => buildRow(result));
     return `${header}\n${lines.join("\n")}`;
@@ -48,7 +48,8 @@ function buildRow(result) {
     const tbtMs = metrics.tbtMs !== undefined ? Math.round(metrics.tbtMs).toString() : "-";
     const cls = metrics.cls !== undefined ? metrics.cls.toFixed(3) : "-";
     const issues = formatTopIssues(result.opportunities);
-    return `| ${result.label} | ${result.path} | ${result.device} | ${scores.performance ?? "-"} | ${scores.accessibility ?? "-"} | ${scores.bestPractices ?? "-"} | ${scores.seo ?? "-"} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${issues} |`;
+    const error = result.runtimeErrorCode ?? (result.runtimeErrorMessage !== undefined ? result.runtimeErrorMessage : "");
+    return `| ${result.label} | ${result.path} | ${result.device} | ${scores.performance ?? "-"} | ${scores.accessibility ?? "-"} | ${scores.bestPractices ?? "-"} | ${scores.seo ?? "-"} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${error} | ${issues} |`;
 }
 function formatTopIssues(opportunities) {
     if (opportunities.length === 0) {

package/dist/config.js

@@ -27,11 +27,16 @@ function normaliseConfig(input, absolutePath) {
     const query = typeof maybeConfig.query === "string" ? maybeConfig.query : undefined;
     const chromePort = typeof maybeConfig.chromePort === "number" ? maybeConfig.chromePort : undefined;
     const runs = typeof maybeConfig.runs === "number" && maybeConfig.runs > 0 ? maybeConfig.runs : undefined;
+    const rawLogLevel = maybeConfig.logLevel;
+    const logLevel = rawLogLevel === "silent" || rawLogLevel === "error" || rawLogLevel === "info" || rawLogLevel === "verbose"
+        ? rawLogLevel
+        : undefined;
     return {
         baseUrl,
         query,
         chromePort,
         runs,
+        logLevel,
         pages,
     };
 }

package/dist/lighthouse-runner.js

@@ -1,3 +1,5 @@
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
 import lighthouse from "lighthouse";
 import { launch as launchChrome } from "chrome-launcher";
 async function createChromeSession(chromePort) {
@@ -19,16 +21,53 @@ async function createChromeSession(chromePort) {
     return {
         port: chrome.port,
         close: async () => {
-            await chrome.kill();
+            try {
+                await chrome.kill();
+            }
+            catch {
+                return;
+            }
         },
     };
 }
+async function ensureUrlReachable(url) {
+    const parsed = new URL(url);
+    const client = parsed.protocol === "https:" ? httpsRequest : httpRequest;
+    await new Promise((resolve, reject) => {
+        const request = client({
+            hostname: parsed.hostname,
+            port: parsed.port ? Number(parsed.port) : parsed.protocol === "https:" ? 443 : 80,
+            path: `${parsed.pathname}${parsed.search}`,
+            method: "GET",
+        }, (response) => {
+            const statusCode = response.statusCode ?? 0;
+            response.resume();
+            if (statusCode >= 200 && statusCode < 400) {
+                resolve();
+            }
+            else {
+                reject(new Error(`HTTP ${statusCode}`));
+            }
+        });
+        request.on("error", (error) => {
+            reject(error);
+        });
+        request.end();
+    }).catch((error) => {
+        // eslint-disable-next-line no-console
+        console.error(`Could not reach ${url}. Is your dev server running?`, error);
+        throw error instanceof Error ? error : new Error(`URL not reachable: ${url}`);
+    });
+}
 /**
  * Run audits for all pages defined in the config and return a structured summary.
  */
 export async function runAuditsForConfig({ config, configPath, }) {
     const runs = config.runs ?? 1;
     const results = [];
+    const firstPage = config.pages[0];
+    const healthCheckUrl = buildUrl({ baseUrl: config.baseUrl, path: firstPage.path, query: config.query });
+    await ensureUrlReachable(healthCheckUrl);
     const session = await createChromeSession(config.chromePort);
     try {
         for (const page of config.pages) {
@@ -42,6 +81,7 @@ export async function runAuditsForConfig({ config, configPath, }) {
                         label: page.label,
                         device,
                         port: session.port,
+                        logLevel: config.logLevel ?? "error",
                     });
                     summaries.push(summary);
                 }
@@ -66,7 +106,7 @@ async function runSingleAudit(params) {
     const options = {
         port: params.port,
         output: "json",
-        logLevel: "error",
+        logLevel: params.logLevel,
         onlyCategories: ["performance", "accessibility", "best-practices", "seo"],
         emulatedFormFactor: params.device,
     };
@@ -87,6 +127,8 @@ async function runSingleAudit(params) {
         scores,
         metrics,
         opportunities,
+        runtimeErrorCode: typeof lhr.runtimeError?.code === "string" ? lhr.runtimeError.code : undefined,
+        runtimeErrorMessage: typeof lhr.runtimeError?.message === "string" ? lhr.runtimeError.message : undefined,
     };
 }
 function extractScores(lhr) {
@@ -168,6 +210,8 @@ function aggregateSummaries(summaries) {
         scores: aggregateScores,
         metrics: aggregateMetrics,
         opportunities,
+        runtimeErrorCode: base.runtimeErrorCode,
+        runtimeErrorMessage: base.runtimeErrorMessage,
     };
 }
 function averageOf(values) {

package/dist/wizard-cli.js

@@ -246,7 +246,8 @@ async function selectDetectedRoutes(routes) {
         type: "multiselect",
         name: "indexes",
         message: "Select routes to include",
-        instructions: false,
+        instructions: true,
+        hint: "Use Space to toggle, ↑/↓ to move, and Enter to confirm.",
         min: 1,
         choices: buildRouteChoices(routes),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apex-auditor",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "private": false,
   "description": "CLI to run structured Lighthouse audits (Performance, Accessibility, Best Practices, SEO) across routes.",
   "type": "module",