pw-automation-framework 2.0.1

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export declare class Logger {
+    private executionId;
+    private context;
+    constructor(context: string, executionId?: string);
+    private log;
+    debug(msg: string, ctx?: Record<string, any>): void;
+    info(msg: string, ctx?: Record<string, any>): void;
+    warn(msg: string, ctx?: Record<string, any>): void;
+    error(msg: string, ctx?: Record<string, any>): void;
+    child(context: string): Logger;
+    static create(context: string, executionId?: string): Logger;
+}

package/dist/utils/logger.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const COLORS = {
+    DEBUG: "\x1b[36m", // cyan
+    INFO: "\x1b[32m", // green
+    WARN: "\x1b[33m", // yellow
+    ERROR: "\x1b[31m", // red
+};
+const RESET = "\x1b[0m";
+class Logger {
+    constructor(context, executionId = "global") {
+        this.context = context;
+        this.executionId = executionId;
+    }
+    log(level, message, extra) {
+        const ts = new Date().toISOString();
+        const color = COLORS[level];
+        const tag = `[${level}][${this.context}]`;
+        const extra_str = extra ? ` ${JSON.stringify(extra)}` : "";
+        console.log(`${color}${ts} ${tag}${RESET} ${message}${extra_str}`);
+    }
+    debug(msg, ctx) { this.log("DEBUG", msg, ctx); }
+    info(msg, ctx) { this.log("INFO", msg, ctx); }
+    warn(msg, ctx) { this.log("WARN", msg, ctx); }
+    error(msg, ctx) { this.log("ERROR", msg, ctx); }
+    child(context) {
+        return new Logger(`${this.context}:${context}`, this.executionId);
+    }
+    static create(context, executionId) {
+        return new Logger(context, executionId);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAEA,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,UAAU,EAAG,OAAO;IAC3B,IAAI,EAAG,UAAU,EAAG,QAAQ;IAC5B,IAAI,EAAG,UAAU,EAAG,SAAS;IAC7B,KAAK,EAAE,UAAU,EAAG,MAAM;CAC3B,CAAC;AACF,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,MAAa,MAAM;IAIjB,YAAY,OAAe,EAAE,cAAsB,QAAQ;QACzD,IAAI,CAAC,OAAO,GAAO,OAAO,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,KAA2B;QACvE,MAAM,EAAE,GAAM,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAK,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,EAAE,IAAI,GAAG,GAAG,KAAK,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,GAAyB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAE,GAAW,EAAE,GAAyB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAE,GAAW,EAAE,GAAyB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9E,KAAK,CAAC,GAAW,EAAE,GAAyB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAE9E,KAAK,CAAC,OAAe;QACnB,OAAO,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,WAAoB;QACjD,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;CACF;AA7BD,wBA6BC"}

package/dist/utils/response.d.ts

@@ -0,0 +1,4 @@
+import { ActionResponse } from "../types/types";
+export declare function pass(comments: string, screenshot?: string, data?: any): ActionResponse;
+export declare function fail(comments: string, errorDetail?: string, screenshot?: string, data?: any): ActionResponse;
+export declare function failElementNotFound(displayLabel: string, screenshot?: string, extraData?: Record<string, any>): ActionResponse;

package/dist/utils/response.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pass = pass;
+exports.fail = fail;
+exports.failElementNotFound = failElementNotFound;
+function pass(comments, screenshot, data) {
+    return { status: "Pass", comments, screenshot, data };
+}
+function fail(comments, errorDetail, screenshot, data) {
+    const message = errorDetail ? `${comments} — ${errorDetail}` : comments;
+    return { status: "Fail", comments: message, screenshot, data };
+}
+function failElementNotFound(displayLabel, screenshot, extraData) {
+    return {
+        status: "Fail",
+        comments: `"${displayLabel}" not found`,
+        screenshot,
+        data: {
+            expected_result: `"${displayLabel}" found and interacted with`,
+            failure_type: "ELEMENT_NOT_FOUND",
+            ...extraData,
+        },
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":";;AAEA,oBAEC;AAED,oBAGC;AACD,kDAeC;AAvBD,SAAgB,IAAI,CAAC,QAAgB,EAAE,UAAmB,EAAE,IAAU;IACpE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,SAAgB,IAAI,CAAC,QAAgB,EAAE,WAAoB,EAAE,UAAmB,EAAE,IAAU;IAC1F,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACjE,CAAC;AACD,SAAgB,mBAAmB,CACjC,YAAoB,EACpB,UAAmB,EACnB,SAA+B;IAE/B,OAAO;QACL,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,IAAI,YAAY,aAAa;QACvC,UAAU;QACV,IAAI,EAAE;YACJ,eAAe,EAAE,IAAI,YAAY,6BAA6B;YAC9D,YAAY,EAAE,mBAAmB;YACjC,GAAG,SAAS;SACb;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/responseFormatter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * responseFormatter.ts
+ * ====================
+ * Converts internal framework types → the standard API response format
+ * that matches what the main application expects.
+ *
+ * Standard format example:
+ * {
+ *   "status": "fail",
+ *   "results": [
+ *     {
+ *       "test_script_uid": "...",
+ *       "app_id": "...",
+ *       "status": "fail",
+ *       "results": [
+ *         {
+ *           "uid": null,
+ *           "obj_uid": "...",
+ *           "step_name": "...",
+ *           "page_uid": null,
+ *           "comments": "...",
+ *           "screenshot": "base64...",
+ *           "duration": "8 seconds",
+ *           "start_time": "2026-04-04 20:25:34",
+ *           "expected_result": "...",
+ *           "status": "pass"
+ *         }
+ *       ],
+ *       "duration": "42 seconds",
+ *       "script_start_time": "2026-04-04 20:25:34"
+ *     }
+ *   ]
+ * }
+ */
+import { ExecutionResult, ScriptResult, StepResult } from "../types/types";
+export interface FormattedStepResult {
+    uid: string | null;
+    obj_uid: string | null;
+    step_name: string;
+    step_script?: string;
+    page_uid: string | null;
+    comments: string;
+    screenshot?: string;
+    duration: string;
+    start_time: string;
+    expected_result: string;
+    status: "pass" | "fail" | "skip";
+    comparison_code?: any;
+}
+export interface FormattedScriptResult {
+    test_script_uid: string;
+    app_id: string | undefined;
+    status: "pass" | "fail";
+    results: FormattedStepResult[];
+    duration: string;
+    script_start_time: string;
+    comparison_code?: any;
+}
+export interface FormattedExecutionResponse {
+    status: "pass" | "fail";
+    executionId: string;
+    results: FormattedScriptResult[];
+    total_scripts: number;
+    passed_scripts: number;
+    failed_scripts: number;
+    total_duration: string;
+}
+/**
+ * Format milliseconds → "X seconds" or "less than 1 second"
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format ISO timestamp → "YYYY-MM-DD HH:MM:SS"
+ */
+export declare function formatDateTime(isoString: string): string;
+export declare function formatStepResult(step: StepResult): FormattedStepResult;
+export declare function formatScriptResult(script: ScriptResult): FormattedScriptResult;
+export declare function formatExecutionResult(result: ExecutionResult): FormattedExecutionResponse;

package/dist/utils/responseFormatter.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * responseFormatter.ts
+ * ====================
+ * Converts internal framework types → the standard API response format
+ * that matches what the main application expects.
+ *
+ * Standard format example:
+ * {
+ *   "status": "fail",
+ *   "results": [
+ *     {
+ *       "test_script_uid": "...",
+ *       "app_id": "...",
+ *       "status": "fail",
+ *       "results": [
+ *         {
+ *           "uid": null,
+ *           "obj_uid": "...",
+ *           "step_name": "...",
+ *           "page_uid": null,
+ *           "comments": "...",
+ *           "screenshot": "base64...",
+ *           "duration": "8 seconds",
+ *           "start_time": "2026-04-04 20:25:34",
+ *           "expected_result": "...",
+ *           "status": "pass"
+ *         }
+ *       ],
+ *       "duration": "42 seconds",
+ *       "script_start_time": "2026-04-04 20:25:34"
+ *     }
+ *   ]
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDuration = formatDuration;
+exports.formatDateTime = formatDateTime;
+exports.formatStepResult = formatStepResult;
+exports.formatScriptResult = formatScriptResult;
+exports.formatExecutionResult = formatExecutionResult;
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Format milliseconds → "X seconds" or "less than 1 second"
+ */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return "less than 1 second";
+    const secs = Math.round(ms / 1000);
+    return `${secs} second${secs !== 1 ? "s" : ""}`;
+}
+/**
+ * Format ISO timestamp → "YYYY-MM-DD HH:MM:SS"
+ */
+function formatDateTime(isoString) {
+    try {
+        const d = new Date(isoString);
+        const pad = (n) => String(n).padStart(2, "0");
+        return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+            `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`);
+    }
+    catch {
+        return isoString;
+    }
+}
+/**
+ * Map internal StepStatus to lowercase API status
+ */
+function mapStepStatus(status) {
+    switch (status?.toUpperCase()) {
+        case "PASS": return "pass";
+        case "FAIL": return "fail";
+        case "SKIP":
+        case "RUNNING":
+        case "PENDING": return "skip";
+        default: return "skip";
+    }
+}
+// ─── Formatters ──────────────────────────────────────────────────────────────
+function formatStepResult(step) {
+    return {
+        uid: step.uid ?? null,
+        obj_uid: step.obj_uid ?? null,
+        step_name: step.step_name,
+        step_script: step.step_script,
+        page_uid: step.page_uid ?? null,
+        comments: step.skip_reason
+            ? `Skipped — ${step.skip_reason}`
+            : (step.comments || ""),
+        screenshot: step.screenshot,
+        duration: formatDuration(step.duration_ms),
+        start_time: formatDateTime(step.start_time),
+        expected_result: step.expected_result || "",
+        status: mapStepStatus(step.status),
+        //  comparison_code: step.comparison_code,
+    };
+}
+function formatScriptResult(script) {
+    const failedStep = script.step_results.find(s => s.comparison_code); // ← this line
+    return {
+        test_script_uid: script.test_script_uid,
+        app_id: script.app_id,
+        status: script.overall_status === "PASS" ? "pass" : "fail",
+        results: script.step_results.map(formatStepResult),
+        duration: formatDuration(script.duration_ms),
+        script_start_time: formatDateTime(script.start_time),
+        comparison_code: failedStep?.comparison_code,
+    };
+}
+function formatExecutionResult(result) {
+    const formattedResults = result.results.map(formatScriptResult);
+    const overallPass = formattedResults.every(r => r.status === "pass");
+    return {
+        status: overallPass ? "pass" : "fail",
+        executionId: result.executionId,
+        results: formattedResults,
+        total_scripts: result.total_scripts,
+        passed_scripts: result.passed,
+        failed_scripts: result.failed,
+        total_duration: formatDuration(result.duration_ms),
+    };
+}
+//# sourceMappingURL=responseFormatter.js.map

package/dist/utils/responseFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseFormatter.js","sourceRoot":"","sources":["../../src/utils/responseFormatter.ts"],"names":[],"mappings":"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"}

package/dist/utils/sseManager.d.ts

@@ -0,0 +1,32 @@
+import { Response } from "express";
+import { SSEEvent, SSEEventType } from "../types/types";
+/**
+ * SSEManager — v2 with Event Replay Buffer
+ * =========================================
+ * ROOT CAUSE FIX:
+ * The dashboard opens AFTER POST /api/run-test returns. Since execution is
+ * now non-blocking, it often completes before the browser even renders the
+ * dashboard page and the SSE connection is established. This means the
+ * dashboard misses all events and shows "Waiting for execution to begin..."
+ * even though the run is already done.
+ *
+ * FIX: Store every emitted event in a per-execution replay buffer.
+ * When a new SSE client connects, immediately replay all past events.
+ * This way late-connecting dashboards see the full execution history.
+ */
+export declare class SSEManager {
+    private clients;
+    private eventBuffer;
+    private readonly MAX_BUFFER;
+    private readonly BUFFER_TTL;
+    addClient(executionId: string, res: Response): void;
+    emit(executionId: string, type: SSEEventType, data: any): void;
+    /** Broadcast to ALL connections (e.g. queue updates, global health) */
+    broadcast(type: SSEEventType, data: any): void;
+    /** Replay buffer for a given executionId (used by status endpoint) */
+    getBuffer(executionId: string): SSEEvent[];
+    hasClients(executionId: string): boolean;
+    private sendToOne;
+    private removeClient;
+}
+export declare const sseManager: SSEManager;

package/dist/utils/sseManager.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sseManager = exports.SSEManager = void 0;
+const logger_1 = require("./logger");
+const log = logger_1.Logger.create("SSEManager");
+/**
+ * SSEManager — v2 with Event Replay Buffer
+ * =========================================
+ * ROOT CAUSE FIX:
+ * The dashboard opens AFTER POST /api/run-test returns. Since execution is
+ * now non-blocking, it often completes before the browser even renders the
+ * dashboard page and the SSE connection is established. This means the
+ * dashboard misses all events and shows "Waiting for execution to begin..."
+ * even though the run is already done.
+ *
+ * FIX: Store every emitted event in a per-execution replay buffer.
+ * When a new SSE client connects, immediately replay all past events.
+ * This way late-connecting dashboards see the full execution history.
+ */
+class SSEManager {
+    constructor() {
+        this.clients = new Map();
+        // ✅ Replay buffer — stores all events per execution
+        this.eventBuffer = new Map();
+        // Max events to buffer per execution (prevents memory leak)
+        this.MAX_BUFFER = 500;
+        // How long to keep buffer after execution completes (ms)
+        this.BUFFER_TTL = 2 * 60 * 60 * 1000; // 2 hours
+    }
+    addClient(executionId, res) {
+        res.setHeader("Content-Type", "text/event-stream");
+        res.setHeader("Cache-Control", "no-cache");
+        res.setHeader("Connection", "keep-alive");
+        res.setHeader("X-Accel-Buffering", "no");
+        res.flushHeaders();
+        if (!this.clients.has(executionId))
+            this.clients.set(executionId, new Set());
+        this.clients.get(executionId).add(res);
+        log.info(`SSE client connected: ${executionId}`);
+        // ✅ REPLAY: Send all past events immediately to this late-joining client
+        const pastEvents = this.eventBuffer.get(executionId) ?? [];
+        if (pastEvents.length > 0) {
+            log.info(`Replaying ${pastEvents.length} past events to late client: ${executionId}`);
+            pastEvents.forEach((ev) => this.sendToOne(res, ev));
+        }
+        else {
+            // Only send connect message if no replay (otherwise connect msg mid-replay is confusing)
+            this.sendToOne(res, {
+                type: "log", executionId,
+                timestamp: new Date().toISOString(),
+                data: { message: "Connected to execution stream" },
+            });
+        }
+        // Heartbeat
+        const hb = setInterval(() => {
+            if (!res.writableEnded)
+                res.write(": heartbeat\n\n");
+            else
+                clearInterval(hb);
+        }, 20000);
+        res.on("close", () => {
+            clearInterval(hb);
+            this.removeClient(executionId, res);
+        });
+    }
+    emit(executionId, type, data) {
+        const event = {
+            type, executionId,
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        // ✅ Buffer event for replay
+        if (!this.eventBuffer.has(executionId)) {
+            this.eventBuffer.set(executionId, []);
+        }
+        const buf = this.eventBuffer.get(executionId);
+        if (buf.length < this.MAX_BUFFER)
+            buf.push(event);
+        // Broadcast to all currently connected clients
+        const clients = this.clients.get(executionId);
+        if (clients && clients.size > 0) {
+            clients.forEach((res) => this.sendToOne(res, event));
+        }
+        if (type === "execution_complete") {
+            // Clean up connections, keep buffer for replay
+            setTimeout(() => this.clients.delete(executionId), 5000);
+            // Clean up buffer after TTL
+            setTimeout(() => this.eventBuffer.delete(executionId), this.BUFFER_TTL);
+        }
+    }
+    /** Broadcast to ALL connections (e.g. queue updates, global health) */
+    broadcast(type, data) {
+        const event = {
+            type, executionId: "global",
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        this.clients.forEach((clients) => clients.forEach((res) => this.sendToOne(res, event)));
+    }
+    /** Replay buffer for a given executionId (used by status endpoint) */
+    getBuffer(executionId) {
+        return this.eventBuffer.get(executionId) ?? [];
+    }
+    hasClients(executionId) {
+        return (this.clients.get(executionId)?.size ?? 0) > 0;
+    }
+    sendToOne(res, event) {
+        try {
+            if (!res.writableEnded)
+                res.write(`data: ${JSON.stringify(event)}\n\n`);
+        }
+        catch { /* client gone */ }
+    }
+    removeClient(executionId, res) {
+        this.clients.get(executionId)?.delete(res);
+        if (this.clients.get(executionId)?.size === 0)
+            this.clients.delete(executionId);
+    }
+}
+exports.SSEManager = SSEManager;
+exports.sseManager = new SSEManager();
+//# sourceMappingURL=sseManager.js.map

package/dist/utils/sseManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseManager.js","sourceRoot":"","sources":["../../src/utils/sseManager.ts"],"names":[],"mappings":"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"}

package/npmignore

@@ -0,0 +1,5 @@
+src/
+dist/
+node_modules/
+.git/
+*.ts

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "pw-automation-framework",
+  "version": "2.0.1",
+  "description": "Enterprise Playwright Automation Framework — Parallel, Non-blocking, Self-installing",
+  "main": "dist/server.js",
+  "bin": {
+    "lexxit-automation-framework": "./bin/lexxit-automation-framework.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "ts-node-dev --respawn --transpile-only src/server.ts",
+    "install:browsers": "npx playwright install chromium firefox webkit",
+    "clean": "rimraf dist",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "open": "^9.1.0",
+    "p-limit": "^4.0.0",
+    "playwright": "^1.40.0",
+    "say": "^0.16.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^9.0.7",
+    "rimraf": "^5.0.5",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.3.2"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.js
+ * Runs automatically after: npm install -g lexxit-automation-framework
+ * Installs Playwright Chromium silently.
+ */
+
+const { execSync } = require("child_process");
+
+const COLORS = {
+  reset: "\x1b[0m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+};
+
+function log(color, prefix, msg) {
+  console.log(`${color}${prefix}${COLORS.reset} ${msg}`);
+}
+
+console.log(`
+${COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  lexxit-automation-framework — Post Install Setup
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${COLORS.reset}
+`);
+
+// ─── INSTALL PLAYWRIGHT CHROMIUM ─────────────────────────────────────────────
+
+log(COLORS.cyan, "[1/1]", "Installing Playwright Chromium browser...");
+
+try {
+  execSync("npx playwright install chromium", {
+    stdio: "inherit",
+    timeout: 120000, // 2 minutes
+  });
+
+  log(COLORS.green, "✔", "Playwright Chromium installed successfully.\n");
+} catch (err) {
+  log(
+    COLORS.yellow,
+    "⚠",
+    "Playwright Chromium install failed. You can run it manually:"
+  );
+  console.log("    npx playwright install chromium\n");
+  // Don't exit(1) — don't block the npm install itself
+}
+
+console.log(`${COLORS.green}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+console.log(`  Setup complete. Run: lexxit-automation-framework start`);
+console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${COLORS.reset}\n`);

package/src/app.ts

@@ -0,0 +1,27 @@
+import express from "express";
+import cors from "cors";
+import path from "path";
+import apiRoutes from "./routes/api.routes";
+
+const app = express();
+
+app.use(cors({ origin: "*" }));
+app.use(express.json({ limit: "20mb" }));
+app.use(express.urlencoded({ extended: true }));
+app.use(express.static(path.join(__dirname, "public")));
+
+// Live dashboard — serves the HTML shell; JS reads executionId from URL
+app.get("/dashboard/:executionId", (_req, res) => {
+  res.sendFile(path.join(__dirname, "public", "dashboard.html"));
+});
+
+// Multi-execution queue monitor
+app.get("/queue-monitor", (_req, res) => {
+  res.sendFile(path.join(__dirname, "public", "queue-monitor.html"));
+});
+
+app.use("/api", apiRoutes);
+
+app.use((_req, res) => res.status(404).json({ error: "Not found" }));
+
+export default app;