renovate-log-parser 0.1.1 → 0.2.0

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>;

package/dist/server/log-registry.js

@@ -0,0 +1,157 @@
+/**
+ * Stateful, process-wide log registry for the web backend.
+ *
+ * The `web` command runs a single long-lived Express process for one user, so we
+ * keep every loaded log's open {@link Parser} (and its SQLite handle) in memory
+ * keyed by content md5, plus a `current` pointer. A successful load sets
+ * `current`; the GET routes always operate on `current` — there is no per-request
+ * `md5` override. Loading a new file simply moves the pointer (the previous
+ * handle stays cached for cheap re-selection).
+ */
+import { createHash } from "node:crypto";
+import { existsSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { Parser } from "../core/parser.js";
+import { extractExpr } from "../core/filters.js";
+import { ErrorDetector } from "../core/error-detector.js";
+import { createError } from "./http-error.js";
+/** md5 -> loaded log. Persists for the lifetime of the server process. */
+const registry = new Map();
+/** The md5 of the log the GET routes currently operate on. */
+let current = null;
+/** Prefix for uploaded-file temp copies (distinct from Parser's cache files). */
+const UPLOAD_PREFIX = "renovate-log-parser-upload-";
+const UPLOAD_SUFFIX = ".jsonl";
+/**
+ * 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 function loadLogFromPath(rawPath) {
+    if (typeof rawPath !== "string" || rawPath.length === 0) {
+        throw createError({
+            statusCode: 400,
+            statusMessage: 'A "path" is required.',
+        });
+    }
+    if (!isAbsolute(rawPath)) {
+        throw createError({
+            statusCode: 400,
+            statusMessage: `Path must be absolute: ${rawPath}`,
+        });
+    }
+    if (!existsSync(rawPath)) {
+        throw createError({
+            statusCode: 400,
+            statusMessage: `Log file not found: ${rawPath}`,
+        });
+    }
+    return loadInto(rawPath);
+}
+/**
+ * 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 function loadLogFromBytes(bytes) {
+    if (bytes.length === 0) {
+        throw createError({
+            statusCode: 400,
+            statusMessage: "Uploaded file is empty.",
+        });
+    }
+    const md5 = createHash("md5").update(bytes).digest("hex");
+    const tempPath = join(tmpdir(), `${UPLOAD_PREFIX}${md5}${UPLOAD_SUFFIX}`);
+    if (!existsSync(tempPath)) {
+        writeFileSync(tempPath, bytes);
+    }
+    return loadInto(tempPath);
+}
+/** Shared load path: reuse the cached parser if present, else parse fresh. */
+function loadInto(absolutePath) {
+    let md5;
+    let parser;
+    // Reuse an already-open parser whose source path matches (cheap re-select).
+    const existing = [...registry.values()].find((e) => e.path === absolutePath);
+    if (existing) {
+        parser = existing.parser;
+        md5 = parser.loaded.md5;
+    }
+    else {
+        parser = new Parser();
+        let result;
+        try {
+            result = parser.load(absolutePath);
+        }
+        catch (err) {
+            parser.close();
+            throw createError({
+                statusCode: 400,
+                statusMessage: err instanceof Error ? err.message : "Failed to parse log file.",
+            });
+        }
+        md5 = result.md5;
+        registry.set(md5, { path: absolutePath, parser });
+    }
+    current = md5;
+    const info = parser.loaded;
+    return {
+        md5,
+        path: info.path,
+        totalLines: info.totalLines,
+        levelCounts: computeLevelCounts(parser),
+    };
+}
+/**
+ * Return the parser for the current log, or throw a 409 when none is loaded.
+ * The GET routes call this first.
+ */
+export function requireCurrentParser() {
+    return requireCurrentEntry().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 function requireCurrentFindings() {
+    const entry = requireCurrentEntry();
+    if (!entry.report) {
+        entry.report = new ErrorDetector(entry.parser).run();
+    }
+    return entry.report;
+}
+/** Resolve the current registry entry, or throw a 409 when none is loaded. */
+function requireCurrentEntry() {
+    if (current === null) {
+        throw createError({
+            statusCode: 409,
+            statusMessage: "No log is loaded. POST a log to /api/log/path first.",
+        });
+    }
+    const entry = registry.get(current);
+    if (!entry) {
+        // Defensive: pointer without an entry should never happen.
+        current = null;
+        throw createError({ statusCode: 409, statusMessage: "No log is loaded." });
+    }
+    return entry;
+}
+/** Count entries per numeric `level` via a single grouped SQL scan. */
+export function computeLevelCounts(parser) {
+    const levelExpr = extractExpr("level");
+    const rows = parser.query(`SELECT ${levelExpr} AS level, COUNT(*) AS n FROM logs GROUP BY ${levelExpr}`);
+    const counts = {};
+    for (const { level, n } of rows) {
+        if (typeof level === "number")
+            counts[String(level)] = n;
+    }
+    // Re-key in ascending numeric level order for a stable, readable response.
+    const sorted = {};
+    for (const key of Object.keys(counts).sort((a, b) => Number(a) - Number(b))) {
+        sorted[key] = counts[key];
+    }
+    return sorted;
+}
+//# sourceMappingURL=log-registry.js.map

package/dist/server/log-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-registry.js","sourceRoot":"","sources":["../../src/server/log-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAwB9C,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,8DAA8D;AAC9D,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,iFAAiF;AACjF,MAAM,aAAa,GAAG,6BAA6B,CAAC;AACpD,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,uBAAuB;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,0BAA0B,OAAO,EAAE;SACnD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,uBAAuB,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,yBAAyB;SACzC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,aAAa,GAAG,GAAG,GAAG,aAAa,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,SAAS,QAAQ,CAAC,YAAoB;IACpC,IAAI,GAAW,CAAC;IAChB,IAAI,MAAc,CAAC;IAEnB,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAC7E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACzB,GAAG,GAAG,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC;gBAChB,UAAU,EAAE,GAAG;gBACf,aAAa,EACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;aACnE,CAAC,CAAC;QACL,CAAC;QACD,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACjB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,GAAG,GAAG,CAAC;IACd,MAAM,IAAI,GAAG,MAAM,CAAC,MAAO,CAAC;IAC5B,OAAO;QACL,GAAG;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,EAAE,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,SAAS,mBAAmB;IAC1B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,sDAAsD;SACtE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,2DAA2D;QAC3D,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CACvB,UAAU,SAAS,+CAA+C,SAAS,EAAE,CAC9E,CAAC;IACF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IACD,2EAA2E;IAC3E,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/server-main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/server-main.js

@@ -0,0 +1,31 @@
+/**
+ * Entry point of the web server process.
+ *
+ * The `web` CLI command spawns this file as a child process with `PORT`/`HOST`
+ * in the environment. It is also the dev-mode entry (`npm run dev:api`), in
+ * which case the Nuxt dev server proxies `/api` here and the static SPA
+ * directory is simply absent.
+ *
+ * Configuration: `--port` / `--host` flags win over the `PORT` / `HOST`
+ * environment variables (flags keep the dev script platform-independent).
+ */
+import { startServer } from "./index.js";
+/** Read a `--name value` / `--name=value` flag from argv. */
+function flag(name) {
+    const argv = process.argv.slice(2);
+    const index = argv.indexOf(`--${name}`);
+    if (index !== -1)
+        return argv[index + 1];
+    const inline = argv.find((a) => a.startsWith(`--${name}=`));
+    return inline?.slice(name.length + 3);
+}
+const port = Number.parseInt(flag("port") ?? process.env.PORT ?? "3000", 10);
+const host = flag("host") ?? process.env.HOST ?? "localhost";
+startServer({
+    port: Number.isNaN(port) ? 3000 : port,
+    host,
+}).catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=server-main.js.map

package/dist/server/server-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-main.js","sourceRoot":"","sources":["../../src/server/server-main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,6DAA6D;AAC7D,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC;AAE7D,WAAW,CAAC;IACV,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;IACtC,IAAI;CACL,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/server/translate-filters.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Translate the web UI's reactive filter object (the `filters` wire format) into
+ * the shared {@link Filter} model that the {@link buildQuery} query builder
+ * understands.
+ *
+ * Wire shape (all keys optional):
+ * ```jsonc
+ * {
+ *   "levels": [20, 30, 40],
+ *   "repositories": { "mode": "include"|"exclude", "values": [...], "independent": true },
+ *   "ignoredFields": ["v", "time", ...],          // response projection, NOT a WHERE clause
+ *   "search": { "field": "msg", "pattern": "*abort*" },
+ *   "pills": [ { "id": "…", "enabled": true, "filter": { …core Filter… } } ]
+ * }
+ * ```
+ * Disabled pills are dropped. `ignoredFields` is returned separately because it
+ * shapes the row projection rather than row matching.
+ */
+import type { Filter } from "../core/filters.js";
+/** Repository include/exclude selection. */
+interface RepositoriesSelection {
+    mode?: "include" | "exclude";
+    values?: unknown;
+    independent?: unknown;
+}
+/** A single dynamic pill wrapping a core Filter with an enable toggle. */
+interface Pill {
+    id?: string;
+    enabled?: boolean;
+    filter?: Filter;
+}
+/** The full reactive filter object sent by the client. */
+export interface FilterWire {
+    levels?: unknown;
+    repositories?: RepositoriesSelection;
+    ignoredFields?: unknown;
+    search?: {
+        field?: unknown;
+        pattern?: unknown;
+        scope?: unknown;
+    };
+    pills?: Pill[];
+}
+/** Result of translating the wire object. */
+export interface TranslatedFilters {
+    filters: Filter[];
+    /** Root keys to strip from each row (`msg` is never strippable). */
+    ignoredFields: string[];
+}
+/**
+ * Parse the JSON-encoded `filters` query parameter into a {@link FilterWire}.
+ * Returns an empty object for a missing/blank value so an unfiltered request
+ * still works; malformed JSON is a 400.
+ */
+export declare function parseFilterWire(raw: string | undefined): FilterWire;
+/** Translate the wire object into concrete filters + the projection list. */
+export declare function translateFilters(wire: FilterWire): TranslatedFilters;
+export {};