renovate-log-parser 0.1.0 → 0.1.2

package/README.md

@@ -31,7 +31,7 @@ npx renovate-log-parser detect-errors path/to/renovate.jsonl --out report.json
 # Emit token-efficient stats for an AI coding agent
 npx renovate-log-parser analyze path/to/renovate.jsonl
 
-# Explore a log interactively in the Nuxt-based web UI
+# Explore a log interactively in the web UI
 npx renovate-log-parser web path/to/renovate.jsonl
 ```
 
@@ -205,9 +205,11 @@ when non-interactive, or a write failure).
 
 ### `web`
 
-Starts the bundled [Nuxt](https://nuxt.com) web UI (with [Nuxt UI](https://ui.nuxt.com)
-and Nuxt's built-in Nitro server) for interactive, filtered log exploration. Pass
-an optional log path to open it automatically; otherwise use the in-app file
+Starts the bundled web UI for interactive, filtered log exploration: a
+statically-rendered [Nuxt](https://nuxt.com) SPA (with
+[Nuxt UI](https://ui.nuxt.com)) served by a small
+[Express](https://expressjs.com) server that also exposes the `/api` endpoints.
+Pass an optional log path to open it automatically; otherwise use the in-app file
 picker. The server keeps the parsed log in memory (SQLite-backed) and streams
 paged rows to the client.
 
@@ -248,8 +250,8 @@ collapsible JSON tree of the full entry.
 
 ## Development
 
-This repository is an npm workspace: the publishable CLI lives at the root and
-the Nuxt app lives in [`web/`](./web).
+This repository is an npm workspace: the publishable CLI and the Express web
+server live at the root (`src/`), the Nuxt frontend lives in [`web/`](./web).
 
 ```bash
 # Install all workspace dependencies
@@ -259,10 +261,12 @@ npm install
 npm run dev:cli -- detect-errors path/to/renovate.jsonl
 npm run dev:cli -- web
 
-# Run the Nuxt app in dev mode (HMR) directly
-npm run dev:web
+# Run the web UI in dev mode: two processes, in two terminals.
+# The Nuxt dev server (HMR) proxies /api to the Express server on port 3001.
+npm run dev:api   # Express API on :3001 (tsx watch)
+npm run dev:web   # Nuxt dev server on :3000
 
-# Build everything (Nuxt .output + compiled CLI)
+# Build everything (static SPA in web/.output/public + compiled CLI)
 npm run build
 
 # Run the compiled CLI
@@ -304,15 +308,15 @@ Three suites, each catching a different failure class:
 - **Packaging E2E tests** (`e2e/pack-install.e2e.ts`) — build, `npm pack`,
   install the tarball into an empty throwaway project, then drive the installed
   `renovate-log-parser` binary against a fixture. This is the only suite that
-  can catch a missing `package.json#files` entry, a dropped Nuxt `.output`
-  symlink, or a `dist/` import that only resolved because `src/` sat next to it.
+  can catch a missing `package.json#files` entry or a `dist/` import that only
+  resolved because `src/` sat next to it.
   Set `SKIP_E2E=1` to skip.
 
   Its nested `web UI` block starts the installed `web` command and drives the
   real UI in a headless Chromium, using the `playwright-core` _library_ — there
   is no second test runner or config file, these are plain `node:test` cases in
   the same file. Because they run against the installed tarball, they assert
-  that the shipped Nuxt bundle actually boots and serves, not merely that its
+  that the shipped server actually boots and serves the SPA, not merely that its
   files are present. Chromium must be installed once with
   `npx playwright-core install chromium`; when a browser test fails, a
   screenshot, an HTML dump and the captured console/server output are written to
@@ -367,34 +371,42 @@ npm run format:check  # Prettier check (no writes — useful in CI)
 ### How it's built
 
 - **CLI** — TypeScript compiled with `tsc` to ESM in `dist/`. Uses
-  [`yargs`](https://yargs.js.org) for command parsing. `yargs` is the only
-  runtime dependency.
-- **Web** — a Nuxt UI app built with `nuxt build`. It shares the CLI's parsing
-  and filtering logic from `src/core/` (aliased into the bundle as
-  `renovate-core`), so the browser and the CLI query the same SQLite-backed
-  model. The `web` command runs the self-contained Nitro server
-  (`web/.output/server/index.mjs`) as a child process; when given a log path it
-  hands it off to the UI via a `?log=` query parameter.
+  [`yargs`](https://yargs.js.org) for command parsing.
+- **Frontend** — a Nuxt UI app built with `nuxt generate` and `ssr: false`, i.e.
+  a purely client-side SPA: `web/.output/public` holds an app shell plus static
+  assets, and nothing of Nitro/h3 is shipped or run. It shares the CLI's
+  filtering model and level metadata from `src/core/` (aliased into the bundle
+  as `renovate-core`), so the browser and the CLI speak about the same
+  SQLite-backed model.
+- **Backend** — a plain Express server in [`src/server/`](./src/server),
+  compiled by the same `tsc` pass as the CLI. It imports `src/core/` through
+  ordinary relative imports (no bundler, no alias), serves the `/api` routes
+  from `api.ts`, and serves the static SPA with an `index.html` fallback so
+  client-side routing works. `log-registry.ts` holds the process-wide "current
+  log" (one open `Parser`/SQLite handle per loaded md5, plus a memoized error
+  report). The `web` command spawns `dist/server/server-main.js` as a child
+  process; when given a log path it hands it off to the UI via a `?log=` query
+  parameter.
 
 ### What gets published
 
 Two `package.json` mechanisms cooperate so that both build outputs ship to npm:
 
-- **`files: ["dist", "web/.output"]`** — an allow-list of what goes into the
+- **`files: ["dist", "web/.output/public"]`** — an allow-list of what goes into the
   published tarball. npm always adds `package.json`, `README`, `LICENSE`, and the
   `bin` target, then includes everything matched here — both directories,
   recursively. This list takes precedence over `.gitignore`, which is why
   `web/.output/` (gitignored as a build artifact) is still published.
 - **`prepublishOnly: "npm run build"`** — a lifecycle hook npm runs automatically
-  before packing on `npm publish`. It builds the Nuxt `.output` and compiles the
-  CLI `dist`, so both directories exist and are current by the time the `files`
-  allow-list is evaluated.
+  before packing on `npm publish`. It generates the static SPA and compiles the
+  CLI + server `dist`, so both directories exist and are current by the time the
+  `files` allow-list is evaluated.
 
 ```
 npm publish
-  └─ prepublishOnly → npm run build → build:web (nuxt build → web/.output/)
-                                    → build:cli (tsc        → dist/)
-  └─ pack tarball using `files`: dist/ + web/.output/ (+ package.json, README, LICENSE)
+  └─ prepublishOnly → npm run build → build:web (nuxt generate → web/.output/public/)
+                                    → build:cli (tsc           → dist/)
+  └─ pack tarball using `files`: dist/ + web/.output/public/ (+ package.json, README, LICENSE)
   └─ upload to registry
 ```
 

package/dist/commands/web.d.ts

@@ -6,7 +6,8 @@ interface WebArgs {
     open: boolean;
 }
 /**
- * `web` — starts the bundled Nuxt (Nitro) production server.
+ * `web` — starts the bundled Express server, which serves the JSON API and the
+ * statically-rendered Nuxt SPA.
  */
 export declare const webCommand: CommandModule<object, WebArgs>;
 export {};

package/dist/commands/web.js

@@ -3,11 +3,18 @@ import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 /**
- * Resolve the prebuilt Nitro server entry that ships inside this package.
- * Layout after `tsc`: dist/commands/web.js  →  ../../web/.output/server/index.mjs
+ * Resolve the Express server entry that ships inside this package.
+ * Layout after `tsc`: dist/commands/web.js  →  ../server/server-main.js
  */
 function resolveServerEntry() {
-    return fileURLToPath(new URL("../../web/.output/server/index.mjs", import.meta.url));
+    return fileURLToPath(new URL("../server/server-main.js", import.meta.url));
+}
+/**
+ * Resolve the statically-rendered SPA that the server serves.
+ * Layout after `tsc`: dist/commands/web.js  →  ../../web/.output/public
+ */
+function resolveSpaIndex() {
+    return fileURLToPath(new URL("../../web/.output/public/index.html", import.meta.url));
 }
 /** Best-effort, dependency-free browser opener. */
 function openBrowser(url) {
@@ -25,11 +32,12 @@ function openBrowser(url) {
     }
 }
 /**
- * `web` — starts the bundled Nuxt (Nitro) production server.
+ * `web` — starts the bundled Express server, which serves the JSON API and the
+ * statically-rendered Nuxt SPA.
  */
 export const webCommand = {
     command: "web [path]",
-    describe: "Start the Nuxt-based web UI",
+    describe: "Start the web UI",
     builder: (yargs) => yargs
         .positional("path", {
         type: "string",
@@ -52,10 +60,16 @@ export const webCommand = {
     }),
     handler: (argv) => {
         const serverEntry = resolveServerEntry();
-        if (!existsSync(serverEntry)) {
+        const spaIndex = resolveSpaIndex();
+        const missing = !existsSync(serverEntry)
+            ? serverEntry
+            : !existsSync(spaIndex)
+                ? spaIndex
+                : null;
+        if (missing) {
             console.error("The web UI has not been built yet.\n" +
-                "Expected server bundle at:\n  " +
-                serverEntry +
+                "Missing:\n  " +
+                missing +
                 '\nRun "npm run build" from the package source before using the "web" command.');
             process.exitCode = 1;
             return;
@@ -81,12 +95,10 @@ export const webCommand = {
                 ...process.env,
                 PORT: String(argv.port),
                 HOST: argv.host,
-                NITRO_PORT: String(argv.port),
-                NITRO_HOST: argv.host,
             },
         });
         if (argv.open) {
-            // Give Nitro a moment to bind before opening the browser.
+            // Give the server a moment to bind before opening the browser.
             setTimeout(() => openBrowser(openUrl), 1000);
         }
         const forward = (signal) => () => {

package/dist/commands/web.js.map

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

package/dist/server/api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `/api` Express router — the whole web backend.
+ *
+ * Every route operates on the process-wide "current log" held by the
+ * {@link ./log-registry.js log registry}; the two POST routes are what make a
+ * log current. Handlers throw {@link HttpError}s, which {@link apiErrorHandler}
+ * renders as JSON.
+ */
+import { Router, type NextFunction, type Request, type Response } from "express";
+/** Build the API router. */
+export declare function createApiRouter(): Router;
+/**
+ * Render errors as JSON. The client composables read `statusMessage` (h3's
+ * shape), so keep that key even though there is no h3 anymore.
+ */
+export declare function apiErrorHandler(err: unknown, _req: Request, res: Response, next: NextFunction): void;

package/dist/server/api.js

@@ -0,0 +1,173 @@
+/**
+ * The `/api` Express router — the whole web backend.
+ *
+ * Every route operates on the process-wide "current log" held by the
+ * {@link ./log-registry.js log registry}; the two POST routes are what make a
+ * log current. Handlers throw {@link HttpError}s, which {@link apiErrorHandler}
+ * renders as JSON.
+ */
+import express, { Router, } from "express";
+import { buildQuery, buildCountQuery } from "../core/query-builder.js";
+import { extractExpr } from "../core/filters.js";
+import { createError, HttpError } from "./http-error.js";
+import { loadLogFromBytes, loadLogFromPath, requireCurrentFindings, requireCurrentParser, } from "./log-registry.js";
+import { parseFilterWire, translateFilters } from "./translate-filters.js";
+/** Default page size for `GET /api/rows` when the client omits a limit. */
+const DEFAULT_LIMIT = 100;
+/** Upload cap for `POST /api/log/contents` — Renovate debug logs get big. */
+const MAX_UPLOAD_SIZE = "2gb";
+/** Build the API router. */
+export function createApiRouter() {
+    const router = Router();
+    /**
+     * GET /api/fields — the distinct set of root-level JSON keys across the
+     * current log. Powers the "ignored fields" checkboxes in the UI. The
+     * synthetic keys the Parser uses for blank / malformed lines are excluded.
+     */
+    router.get("/fields", (_req, res) => {
+        const parser = requireCurrentParser();
+        const rows = parser.query("SELECT DISTINCT je.key AS key FROM logs, json_each(logs.logentry) AS je");
+        const synthetic = new Set(["_blank", "_parseError", "_raw"]);
+        res.json(rows
+            .map((r) => r.key)
+            .filter((key) => !synthetic.has(key))
+            .sort());
+    });
+    /**
+     * GET /api/repositories — the distinct `repository` values across the current
+     * log, excluding git-URL sub-repos (e.g. pre-commit hooks) whose `repository`
+     * is an `https://…` URL rather than an `owner/repo` slug — these aren't real
+     * repos and just clutter the dropdown (mirrors the exclusion in
+     * `analyzer.ts`'s per-repo stats). The UI adds a "Repository-independent"
+     * pseudo-entry for entries with no `repository` — that is not returned here.
+     */
+    router.get("/repositories", (_req, res) => {
+        const parser = requireCurrentParser();
+        const expr = extractExpr("repository");
+        const rows = parser.query(`SELECT DISTINCT ${expr} AS repo FROM logs WHERE ${expr} IS NOT NULL ORDER BY repo`);
+        res.json(rows.map((r) => r.repo).filter((repo) => !repo.startsWith("https://")));
+    });
+    /**
+     * GET /api/findings — the error-detector report for the current log.
+     *
+     * Per-finding `details` are stripped: the Problems panel only needs
+     * category/severity/message/line/repo, and the full entry is already reachable
+     * via `GET /api/rows` + the details slide-over.
+     */
+    router.get("/findings", (_req, res) => {
+        const report = requireCurrentFindings();
+        const findings = report.findings.map(
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars -- drop `details` from the wire payload
+        ({ details, ...rest }) => rest);
+        res.json({
+            summary: report.summary,
+            counts: report.counts,
+            findings,
+        });
+    });
+    /**
+     * GET /api/rows — the paginated, filtered row feed for the current log.
+     * Query params:
+     *   - `filters` : URL-encoded JSON of the reactive filter object (optional)
+     *   - `offset`  : rows to skip (default 0)
+     *   - `limit`   : max rows to return (default 100)
+     *
+     * Returns `{ total, offset, limit, rows }` where each row is a `RowDTO`:
+     * `{ _oL, ...entry }` with the ignored root fields stripped (`msg` is never
+     * stripped). `total` is the count matching the filters, ignoring pagination,
+     * so the client can drive virtualization.
+     */
+    router.get("/rows", (req, res) => {
+        const parser = requireCurrentParser();
+        const wire = parseFilterWire(queryParam(req, "filters"));
+        const { filters, ignoredFields } = translateFilters(wire);
+        const offset = Math.max(0, parseIntParam(queryParam(req, "offset"), 0));
+        const limit = Math.max(0, parseIntParam(queryParam(req, "limit"), DEFAULT_LIMIT));
+        const countQuery = buildCountQuery(filters);
+        const total = parser.query(countQuery.sql, countQuery.params)[0]?.n ?? 0;
+        const dataQuery = buildQuery(filters, { limit, offset }, "line, logentry");
+        const rows = parser
+            .queryEntries(dataQuery.sql, dataQuery.params)
+            .map(({ line, entry }) => projectRow(line, entry, ignoredFields));
+        res.json({ total, offset, limit, rows });
+    });
+    /**
+     * POST /api/log/path — load a log from an absolute local path and make it the
+     * current log. Body: `{ "path": "<absolute>" }`. Blocks until the log is
+     * parsed (or a valid cache is reused). Returns the load metadata.
+     *
+     * This reads any local absolute path unrestricted — the tool is a local,
+     * single-user utility.
+     */
+    router.post("/log/path", express.json(), (req, res) => {
+        const path = req.body?.path;
+        if (typeof path !== "string") {
+            throw createError({
+                statusCode: 400,
+                statusMessage: 'Request body must include a string "path".',
+            });
+        }
+        res.json(loadLogFromPath(path));
+    });
+    /**
+     * POST /api/log/contents — load a log from uploaded bytes (file picker). The
+     * bytes are written to a temp file named by their md5, which becomes the log's
+     * `path`. The file contents are sent as the raw request body.
+     */
+    router.post("/log/contents", express.raw({ type: () => true, limit: MAX_UPLOAD_SIZE }), (req, res) => {
+        const bytes = Buffer.isBuffer(req.body) ? req.body : Buffer.alloc(0);
+        if (bytes.length === 0) {
+            throw createError({
+                statusCode: 400,
+                statusMessage: "Request body was empty.",
+            });
+        }
+        res.json(loadLogFromBytes(bytes));
+    });
+    return router;
+}
+/**
+ * Render errors as JSON. The client composables read `statusMessage` (h3's
+ * shape), so keep that key even though there is no h3 anymore.
+ */
+export function apiErrorHandler(err, _req, res, next) {
+    if (res.headersSent) {
+        next(err);
+        return;
+    }
+    const statusCode = err instanceof HttpError ? err.statusCode : 500;
+    const statusMessage = err instanceof HttpError
+        ? err.statusMessage
+        : err instanceof Error
+            ? err.message
+            : "Internal server error.";
+    if (statusCode >= 500)
+        console.error(err);
+    res
+        .status(statusCode)
+        .json({ statusCode, statusMessage, message: statusMessage });
+}
+/** Build a RowDTO: original line + entry with ignored fields stripped. */
+function projectRow(line, entry, ignoredFields) {
+    const stripped = new Set(ignoredFields.filter((f) => f !== "msg"));
+    const dto = { _oL: line };
+    for (const [key, value] of Object.entries(entry)) {
+        if (stripped.has(key))
+            continue;
+        dto[key] = value;
+    }
+    return dto;
+}
+/** Read a query parameter as a string (repeated/structured params ignored). */
+function queryParam(req, name) {
+    const value = req.query[name];
+    return typeof value === "string" ? value : undefined;
+}
+/** Parse a query-string integer, falling back to a default when absent/NaN. */
+function parseIntParam(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? fallback : parsed;
+}
+//# sourceMappingURL=api.js.map

package/dist/server/api.js.map

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

package/dist/server/http-error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal HTTP error type for the Express API.
+ *
+ * Replaces h3's `createError`: handlers and the log registry throw these, and
+ * the Express error middleware in `api.ts` turns them into a JSON response.
+ * Anything that is not an {@link HttpError} is treated as a 500.
+ */
+/** An error carrying the HTTP status it should be reported with. */
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly statusMessage: string;
+    constructor(statusCode: number, statusMessage: string);
+}
+/** Create an {@link HttpError} (h3-compatible call shape). */
+export declare function createError(options: {
+    statusCode: number;
+    statusMessage: string;
+}): HttpError;

package/dist/server/http-error.js

@@ -0,0 +1,23 @@
+/**
+ * Minimal HTTP error type for the Express API.
+ *
+ * Replaces h3's `createError`: handlers and the log registry throw these, and
+ * the Express error middleware in `api.ts` turns them into a JSON response.
+ * Anything that is not an {@link HttpError} is treated as a 500.
+ */
+/** An error carrying the HTTP status it should be reported with. */
+export class HttpError extends Error {
+    statusCode;
+    statusMessage;
+    constructor(statusCode, statusMessage) {
+        super(statusMessage);
+        this.name = "HttpError";
+        this.statusCode = statusCode;
+        this.statusMessage = statusMessage;
+    }
+}
+/** Create an {@link HttpError} (h3-compatible call shape). */
+export function createError(options) {
+    return new HttpError(options.statusCode, options.statusMessage);
+}
+//# sourceMappingURL=http-error.js.map

package/dist/server/http-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../src/server/http-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,UAAU,CAAS;IACnB,aAAa,CAAS;IAE/B,YAAY,UAAkB,EAAE,aAAqB;QACnD,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,OAG3B;IACC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;AAClE,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The Express application that backs the `web` command.
+ *
+ * It does two things:
+ *   1. serves the JSON API under `/api` (see {@link ./api.js}), and
+ *   2. serves the statically-rendered Nuxt SPA (`web/.output/public`), falling
+ *      back to `index.html` for unknown paths so client-side routing works.
+ *
+ * There is deliberately no server-side rendering: the SPA is a static bundle,
+ * so this process only ever pushes bytes and answers API calls.
+ */
+import { type Express } from "express";
+/** Options for {@link createApp}. */
+export interface AppOptions {
+    /**
+     * Directory holding the built SPA. Defaults to the `web/.output/public`
+     * shipped inside this package. When it does not exist, only `/api` is served.
+     */
+    staticDir?: string;
+}
+/**
+ * Directory of the prebuilt SPA shipped in this package.
+ * Layout after `tsc`: dist/server/index.js → ../../web/.output/public
+ */
+export declare function defaultStaticDir(): string;
+/** Build the Express app (API + static SPA). */
+export declare function createApp(options?: AppOptions): Express;
+/** Options for {@link startServer}. */
+export interface ServeOptions extends AppOptions {
+    port: number;
+    host: string;
+}
+/** Start the HTTP server and resolve once it is listening. */
+export declare function startServer(options: ServeOptions): Promise<void>;

package/dist/server/index.js

@@ -0,0 +1,54 @@
+/**
+ * The Express application that backs the `web` command.
+ *
+ * It does two things:
+ *   1. serves the JSON API under `/api` (see {@link ./api.js}), and
+ *   2. serves the statically-rendered Nuxt SPA (`web/.output/public`), falling
+ *      back to `index.html` for unknown paths so client-side routing works.
+ *
+ * There is deliberately no server-side rendering: the SPA is a static bundle,
+ * so this process only ever pushes bytes and answers API calls.
+ */
+import express from "express";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createApiRouter, apiErrorHandler } from "./api.js";
+/**
+ * Directory of the prebuilt SPA shipped in this package.
+ * Layout after `tsc`: dist/server/index.js → ../../web/.output/public
+ */
+export function defaultStaticDir() {
+    return fileURLToPath(new URL("../../web/.output/public", import.meta.url));
+}
+/** Build the Express app (API + static SPA). */
+export function createApp(options = {}) {
+    const app = express();
+    const staticDir = options.staticDir ?? defaultStaticDir();
+    app.use("/api", createApiRouter());
+    app.use("/api", apiErrorHandler);
+    const indexHtml = join(staticDir, "index.html");
+    if (existsSync(indexHtml)) {
+        app.use(express.static(staticDir));
+        // SPA fallback: anything not matched above (and not an API call) gets the
+        // app shell, which then routes client-side.
+        app.use((req, res, next) => {
+            if (req.method !== "GET" && req.method !== "HEAD")
+                return next();
+            res.sendFile("index.html", { root: staticDir });
+        });
+    }
+    return app;
+}
+/** Start the HTTP server and resolve once it is listening. */
+export function startServer(options) {
+    const app = createApp(options);
+    return new Promise((resolve, reject) => {
+        const server = app.listen(options.port, options.host, () => {
+            console.log(`renovate-log-parser web UI listening on http://${options.host}:${options.port}`);
+            resolve();
+        });
+        server.on("error", reject);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,OAAyB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAW5D;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAC,UAAsB,EAAE;IAChD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,EAAE,CAAC;IAE1D,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACnC,0EAA0E;QAC1E,4CAA4C;QAC5C,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACzB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAO,IAAI,EAAE,CAAC;YACjE,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;YACzD,OAAO,CAAC,GAAG,CACT,kDAAkD,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CACjF,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/log-registry.d.ts

@@ -0,0 +1,34 @@
+import { Parser } from "../core/parser.js";
+import { type DetectionReport } from "../core/error-detector.js";
+/** Public metadata returned to the client after a successful load. */
+export interface LoadedLogInfo {
+    md5: string;
+    path: string;
+    totalLines: number;
+    levelCounts: Record<string, number>;
+}
+/**
+ * Load a log from an absolute filesystem path and make it current.
+ *
+ * @throws {HttpError} when the path is not absolute / missing, or the parse
+ *   fails — the route layer maps these to HTTP responses.
+ */
+export declare function loadLogFromPath(rawPath: string): LoadedLogInfo;
+/**
+ * Persist uploaded bytes to a temp file (named by their md5) and load it. The
+ * temp copy becomes the log's `path`, mirroring the on-disk load path.
+ */
+export declare function loadLogFromBytes(bytes: Uint8Array): LoadedLogInfo;
+/**
+ * Return the parser for the current log, or throw a 409 when none is loaded.
+ * The GET routes call this first.
+ */
+export declare function requireCurrentParser(): Parser;
+/**
+ * Return the error-detector report for the current log, computing (and caching)
+ * it on first request. Runs without ignore rules — the web surfaces every
+ * finding. Throws a 409 when no log is loaded (via {@link requireCurrentEntry}).
+ */
+export declare function requireCurrentFindings(): DetectionReport;
+/** Count entries per numeric `level` via a single grouped SQL scan. */
+export declare function computeLevelCounts(parser: Parser): Record<string, number>;