apex-auditor 0.2.9 → 0.3.3

package/dist/ui/render-table.js

@@ -0,0 +1,61 @@
+const BOX = {
+    topLeft: "┌",
+    topRight: "┐",
+    bottomLeft: "└",
+    bottomRight: "┘",
+    horizontal: "─",
+    vertical: "│",
+    junctionTop: "┬",
+    junctionMid: "┼",
+    junctionBottom: "┴",
+    junctionLeft: "├",
+    junctionRight: "┤",
+};
+function stripAnsi(value) {
+    return value.replace(/\u001b\[[0-9;]*m/g, "");
+}
+function visibleLength(value) {
+    return stripAnsi(value).length;
+}
+function repeatChar(char, count) {
+    return new Array(Math.max(0, count)).fill(char).join("");
+}
+function padCell(value, width) {
+    const len = visibleLength(value);
+    if (len >= width) {
+        return value;
+    }
+    return `${value}${repeatChar(" ", width - len)}`;
+}
+function computeWidths(params) {
+    const columnCount = Math.max(params.headers.length, ...params.rows.map((r) => r.length));
+    const widths = new Array(columnCount).fill(1);
+    for (let i = 0; i < columnCount; i += 1) {
+        const header = params.headers[i] ?? "";
+        widths[i] = Math.max(widths[i] ?? 1, visibleLength(header));
+    }
+    for (const row of params.rows) {
+        for (let i = 0; i < columnCount; i += 1) {
+            const cell = row[i] ?? "";
+            widths[i] = Math.max(widths[i] ?? 1, visibleLength(cell));
+        }
+    }
+    return widths;
+}
+function joinBorder(widths, left, mid, right) {
+    const parts = widths.map((w) => repeatChar(BOX.horizontal, w + 2));
+    return `${left}${parts.join(mid)}${right}`;
+}
+function renderRow(cells, widths) {
+    const padded = widths.map((w, i) => ` ${padCell(cells[i] ?? "", w)} `);
+    return `${BOX.vertical}${padded.join(BOX.vertical)}${BOX.vertical}`;
+}
+export function renderTable(params) {
+    const widths = computeWidths(params);
+    const top = joinBorder(widths, BOX.topLeft, BOX.junctionTop, BOX.topRight);
+    const header = renderRow(params.headers, widths);
+    const mid = joinBorder(widths, BOX.junctionLeft, BOX.junctionMid, BOX.junctionRight);
+    const body = params.rows.map((r) => renderRow(r, widths));
+    const bottom = joinBorder(widths, BOX.bottomLeft, BOX.junctionBottom, BOX.bottomRight);
+    return [top, header, mid, ...body, bottom].join("\n");
+}

package/dist/ui/ui-theme.js

@@ -0,0 +1,47 @@
+const COLOR_MAP = {
+    reset: "\u001b[0m",
+    bold: "\u001b[1m",
+    dim: "\u001b[2m",
+    cyan: "\u001b[36m",
+    magenta: "\u001b[35m",
+    yellow: "\u001b[33m",
+    green: "\u001b[32m",
+    red: "\u001b[31m",
+};
+/**
+ * Terminal theme helper that supports NO_COLOR/CI fallbacks.
+ */
+export class UiTheme {
+    noColor;
+    constructor(params) {
+        this.noColor = params.noColor;
+    }
+    apply(token, value) {
+        if (this.noColor) {
+            return value;
+        }
+        const open = COLOR_MAP[token];
+        return `${open}${value}${COLOR_MAP.reset}`;
+    }
+    bold(value) {
+        return this.apply("bold", value);
+    }
+    dim(value) {
+        return this.apply("dim", value);
+    }
+    cyan(value) {
+        return this.apply("cyan", value);
+    }
+    magenta(value) {
+        return this.apply("magenta", value);
+    }
+    yellow(value) {
+        return this.apply("yellow", value);
+    }
+    green(value) {
+        return this.apply("green", value);
+    }
+    red(value) {
+        return this.apply("red", value);
+    }
+}

package/dist/url.js

@@ -0,0 +1,6 @@
+export function buildUrl(params) {
+    const cleanBase = params.baseUrl.replace(/\/$/, "");
+    const cleanPath = params.path.startsWith("/") ? params.path : `/${params.path}`;
+    const queryPart = params.query && params.query.length > 0 ? params.query : "";
+    return `${cleanBase}${cleanPath}${queryPart}`;
+}

package/dist/webhooks.js

@@ -0,0 +1,29 @@
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+export async function postJsonWebhook(params) {
+    const { url, payload, timeoutMs } = params;
+    const target = new URL(url);
+    const body = JSON.stringify(payload);
+    const isHttps = target.protocol === "https:";
+    const requestFn = isHttps ? httpsRequest : httpRequest;
+    await new Promise((resolve, reject) => {
+        const req = requestFn({
+            method: "POST",
+            hostname: target.hostname,
+            path: `${target.pathname}${target.search}`,
+            port: target.port || (isHttps ? 443 : 80),
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(body),
+            },
+            timeout: timeoutMs ?? 5000,
+        }, (res) => {
+            // Consume response to free socket
+            res.resume();
+            resolve();
+        });
+        req.on("error", (error) => reject(error));
+        req.write(body);
+        req.end();
+    });
+}

package/dist/wizard-cli.js

@@ -13,7 +13,6 @@ const PROFILE_TO_DETECTOR = {
     custom: undefined,
 };
 const DEFAULT_BASE_URL = "http://localhost:3000";
-const DEFAULT_RUNS = 1;
 const DEFAULT_PROJECT_ROOT = ".";
 const DEFAULT_PRESELECT_COUNT = 5;
 const DEFAULT_DEVICES = ["mobile", "desktop"];
@@ -51,13 +50,6 @@ const baseQuestions = [
         message: "Query string appended to every route (optional)",
         initial: "",
     },
-    {
-        type: "number",
-        name: "runs",
-        message: "Number of Lighthouse runs per page/device",
-        initial: DEFAULT_RUNS,
-        min: 1,
-    },
 ];
 const pageQuestions = [
     {
@@ -95,12 +87,6 @@ const addMorePagesQuestion = {
     message: "Add another page to audit?",
     initial: false,
 };
-const detectRoutesQuestion = {
-    type: "confirm",
-    name: "value",
-    message: "Attempt to auto-detect routes from your project?",
-    initial: true,
-};
 const projectRootQuestion = {
     type: "text",
     name: "projectRoot",
@@ -128,6 +114,13 @@ async function ask(question) {
     const answers = await prompts(question, PROMPT_OPTIONS);
     return answers;
 }
+async function collectBaseAnswers() {
+    const answers = await ask(baseQuestions);
+    return {
+        baseUrl: answers.baseUrl,
+        query: answers.query,
+    };
+}
 function parseArgs(argv) {
     let configPath;
     for (let index = 2; index < argv.length; index += 1) {
@@ -159,12 +152,11 @@ async function ensureWritable(path) {
     console.log("Aborted. Existing config preserved.");
     process.exit(0);
 }
-async function collectBaseAnswers() {
-    const answers = await ask(baseQuestions);
+function buildBaseConfig(answers) {
     return {
         baseUrl: answers.baseUrl.trim(),
         query: answers.query && answers.query.length > 0 ? answers.query : undefined,
-        runs: answers.runs,
+        runs: 1,
     };
 }
 async function confirmAddPage(hasPages) {
@@ -179,6 +171,10 @@ async function collectSinglePage() {
 }
 async function collectPages(initialPages) {
     const pages = [...initialPages];
+    // If we already detected pages, return them immediately for speed.
+    if (pages.length > 0) {
+        return pages;
+    }
     while (true) {
         const shouldAdd = await confirmAddPage(pages.length > 0);
         if (!shouldAdd) {
@@ -192,10 +188,6 @@ async function collectPages(initialPages) {
     }
 }
 async function maybeDetectPages(profile) {
-    const shouldDetect = await ask(detectRoutesQuestion);
-    if (!shouldDetect.value) {
-        return [];
-    }
     const preferredDetector = await selectDetector(profile);
     const projectRootAnswer = await ask(projectRootQuestion);
     const repoRoot = resolve(projectRootAnswer.projectRoot);
@@ -278,12 +270,13 @@ function convertRouteToPage(route) {
 async function buildConfig() {
     const profileAnswer = await ask(profileQuestion);
     const baseAnswers = await collectBaseAnswers();
+    console.log("Tip: parallel workers auto-tune from CPU/memory. Override later with --parallel <n> or inspect with --show-parallel.");
     const detectedPages = await maybeDetectPages(profileAnswer.profile);
     const pages = await collectPages(detectedPages);
     return {
         baseUrl: baseAnswers.baseUrl,
         query: baseAnswers.query,
-        runs: baseAnswers.runs,
+        runs: 1,
         pages,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apex-auditor",
-  "version": "0.2.9",
+  "version": "0.3.3",
   "private": false,
   "description": "CLI to run structured Lighthouse audits (Performance, Accessibility, Best Practices, SEO) across routes.",
   "type": "module",
@@ -20,13 +20,15 @@
   "dependencies": {
     "chrome-launcher": "^1.2.1",
     "lighthouse": "^13.0.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
     "@types/node": "^22.0.0",
     "@types/prompts": "^2.4.9",
+    "@types/ws": "^8.5.14",
     "vitest": "^4.0.14"
   }
 }