@tracepanel/js 0.0.0-stage → 0.2.0

package/dist/bun.js

@@ -0,0 +1,114 @@
+// Bun's own server, Bun.serve, doesn't go through node:http: a request's root span comes from here. `serve()` takes
+// Bun.serve's options; `withTracepanel()` wraps any fetch handler (Hono's app.fetch, Elysia's handle).
+//
+//   import { serve } from "@tracepanel/js/bun";
+//   serve({ routes: { "/api/books/:id": (req) => ... }, fetch: (req) => ... });
+//
+// Start the app with `bun --preload @tracepanel/js/register server.ts` so the database driver is hooked as it loads.
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { start } from "./setup.js";
+import { exposedHeaders, inject } from "./widget.js";
+const tracer = trace.getTracer("tracepanel-bun");
+/** What Bun answers an error with when the app has no `error` handler of its own. */
+function internalError(error) {
+    // biome-ignore lint/suspicious/noConsole: printing the error is what Bun does in this case too
+    console.error(error);
+    return new Response("Internal Server Error", { status: 500 });
+}
+/**
+ * The handler, in a server span for each request: its route, status, errors; the badge's headers and script. An
+ * error it throws is answered here, by `onError` (Bun.serve's `error` option) or a 500, so the answer has its trace.
+ */
+export function withTracepanel(handler, route, onError) {
+    const tracepanel = start({ httpServer: false });
+    if (!tracepanel)
+        return handler;
+    const traced = (request, server) => {
+        const url = new URL(request.url);
+        const attributes = {
+            "http.request.method": request.method,
+            "url.path": url.pathname,
+            "http.target": url.pathname + url.search,
+            ...(route ? { "http.route": route } : {}),
+        };
+        const startedMs = performance.now();
+        return tracer.startActiveSpan(`${request.method}`, { kind: SpanKind.SERVER, attributes }, async (span) => {
+            tracepanel.processor.setFramework("Bun.serve");
+            try {
+                let response;
+                try {
+                    response = await handler(request, server);
+                }
+                catch (thrown) {
+                    const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+                    span.recordException(error);
+                    response = await (onError ?? internalError)(error);
+                }
+                span.setAttribute("http.response.status_code", response.status);
+                if (response.status >= 500)
+                    span.setStatus({ code: SpanStatusCode.ERROR });
+                return await marked(tracepanel, request, response, startedMs);
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+    return traced;
+}
+/** The trace's headers on the response, and the widget in an HTML page. */
+async function marked(tracepanel, request, response, startedMs) {
+    const page = (response.headers.get("content-type") ?? "").includes("text/html");
+    const marks = tracepanel.badge({
+        method: request.method,
+        status: response.status,
+        startedMs,
+        page,
+        framework: tracepanel.processor.framework() ?? "Bun.serve",
+    });
+    if (!marks)
+        return response;
+    const headers = new Headers(response.headers);
+    for (const [name, value] of Object.entries(marks.headers))
+        headers.set(name, value);
+    const expose = exposedHeaders(headers.get("access-control-allow-origin") ?? undefined, headers.get("access-control-expose-headers"));
+    if (expose)
+        headers.set("Access-Control-Expose-Headers", expose);
+    if (!marks.script)
+        return new Response(response.body, { status: response.status, headers });
+    headers.delete("content-length");
+    const body = inject(await response.text(), marks.script);
+    return new Response(body, { status: response.status, statusText: response.statusText, headers });
+}
+/** Bun.serve's routes, each handler traced under its pattern: `/api/books/:id`. */
+function tracedRoutes(routes, onError) {
+    const traced = {};
+    for (const [pattern, value] of Object.entries(routes)) {
+        if (typeof value === "function") {
+            traced[pattern] = withTracepanel(value, pattern, onError);
+        }
+        else if (value instanceof Response) {
+            traced[pattern] = value;
+        }
+        else {
+            const methods = {};
+            for (const [method, handler] of Object.entries(value)) {
+                methods[method] = withTracepanel(handler, pattern, onError);
+            }
+            traced[pattern] = methods;
+        }
+    }
+    return traced;
+}
+/** Bun.serve, with every route and the fetch fallback traced. */
+export function serve(options) {
+    const bun = globalThis.Bun;
+    if (!bun)
+        throw new Error("@tracepanel/js/bun's serve() runs on Bun");
+    return bun.serve({
+        ...options,
+        ...(options.routes ? { routes: tracedRoutes(options.routes, options.error) } : {}),
+        ...(options.fetch ? { fetch: withTracepanel(options.fetch, undefined, options.error) } : {}),
+    });
+}
+//# sourceMappingURL=bun.js.map

package/dist/bun.js.map

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

package/dist/calls.d.ts

@@ -0,0 +1,20 @@
+import type { Attrs } from "./model.js";
+/** The URL without its credentials, and with secret query values masked. */
+export declare function safeUrl(raw: string): string;
+/** An outgoing HTTP call: `GET api.example.com/users/42`. */
+export declare function httpCall(attrs: Attrs): {
+    name: string;
+    attrs: Attrs;
+};
+export declare function isRedis(attrs: Attrs): boolean;
+/** A Redis command: `GET post:42:summary`, its key, and where the server is. */
+export declare function redisCall(attrs: Attrs, spanName: string): {
+    name: string;
+    attrs: Attrs;
+};
+export declare function isMongo(attrs: Attrs): boolean;
+/** A MongoDB command: `find users`, its shape with the values as "?", and a hash of the values (duplicates). */
+export declare function mongoCall(attrs: Attrs, spanName: string): {
+    name: string;
+    attrs: Attrs;
+};

package/dist/calls.js

@@ -0,0 +1,145 @@
+// Calls to other systems, as the agent and the other SDKs name them: an outgoing HTTP call (http.client), a Redis
+// command (redis), a MongoDB command (mongodb). OpenTelemetry's instrumentations describe them; these are the
+// Tracepanel spans' names and attributes.
+import { createHash } from "node:crypto";
+function first(attrs, ...keys) {
+    for (const key of keys) {
+        if (attrs[key] !== undefined)
+            return attrs[key];
+    }
+    return undefined;
+}
+// Query parameters whose values are secrets: their values become "***".
+const SECRET = /(token|key|secret|password|passwd|pwd|auth|signature|sig|session|credential)/i;
+/** The URL without its credentials, and with secret query values masked. */
+export function safeUrl(raw) {
+    try {
+        const url = new URL(raw);
+        url.username = "";
+        url.password = "";
+        for (const name of [...url.searchParams.keys()]) {
+            if (SECRET.test(name))
+                url.searchParams.set(name, "***");
+        }
+        return url.toString();
+    }
+    catch {
+        return raw;
+    }
+}
+/** An outgoing HTTP call: `GET api.example.com/users/42`. */
+export function httpCall(attrs) {
+    const method = String(first(attrs, "http.request.method", "http.method") ?? "GET").toUpperCase();
+    const raw = String(first(attrs, "url.full", "http.url") ?? "");
+    let host = String(first(attrs, "server.address", "net.peer.name") ?? "");
+    let path = "/";
+    let port = first(attrs, "server.port", "net.peer.port");
+    let scheme = "http";
+    try {
+        const url = new URL(raw);
+        host = url.hostname;
+        path = url.pathname || "/";
+        scheme = url.protocol.replace(":", "");
+        port = url.port ? Number(url.port) : scheme === "https" ? 443 : 80;
+    }
+    catch {
+        // No full URL: the host and port the instrumentation gave.
+    }
+    const status = first(attrs, "http.response.status_code", "http.status_code");
+    return {
+        name: `${method} ${host}${path}`,
+        attrs: {
+            "http.request.method": method,
+            "url.full": safeUrl(raw),
+            "url.scheme": scheme,
+            "server.address": host,
+            "server.port": port ?? null,
+            ...(status === undefined ? {} : { "http.response.status_code": status }),
+        },
+    };
+}
+export function isRedis(attrs) {
+    return first(attrs, "db.system.name", "db.system") === "redis";
+}
+/** A Redis command: `GET post:42:summary`, its key, and where the server is. */
+export function redisCall(attrs, spanName) {
+    const statement = String(first(attrs, "db.query.text", "db.statement") ?? "");
+    const words = statement.split(/\s+/).filter(Boolean);
+    const command = String(first(attrs, "db.operation.name", "db.operation") ?? words[0] ?? spanName).toUpperCase();
+    const key = words[1] && words[1] !== "?" ? words[1] : null;
+    const namespace = first(attrs, "db.namespace", "db.redis.database_index");
+    return {
+        name: key && command !== "PIPELINE" && command !== "MULTI" ? `${command} ${key}` : command,
+        attrs: {
+            "db.system": "redis",
+            "db.operation": command,
+            "redis.key": key,
+            "redis.alias": namespace === undefined || namespace === null || namespace === 0 ? "redis" : `redis/${namespace}`,
+            "server.address": first(attrs, "server.address", "net.peer.name") ?? null,
+            "server.port": first(attrs, "server.port", "net.peer.port") ?? null,
+        },
+    };
+}
+export function isMongo(attrs) {
+    return first(attrs, "db.system.name", "db.system") === "mongodb";
+}
+// Where a command carries the app's values: they become "?" in its shape, as in the Python SDK.
+const VALUES = new Set(["filter", "query", "documents", "updates", "deletes", "pipeline", "q", "u", "update"]);
+// What the driver adds for itself.
+const NOISE = new Set([
+    "lsid",
+    "$clusterTime",
+    "$db",
+    "txnNumber",
+    "$readPreference",
+    "autocommit",
+    "startTransaction",
+]);
+function shape(value, values) {
+    if (Array.isArray(value)) {
+        if (value.every((item) => item === null || typeof item !== "object")) {
+            values.push(...value);
+            return ["?"];
+        }
+        return value.map((item) => shape(item, values));
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, shape(item, values)]));
+    }
+    values.push(value);
+    return "?";
+}
+/** A MongoDB command: `find users`, its shape with the values as "?", and a hash of the values (duplicates). */
+export function mongoCall(attrs, spanName) {
+    const operation = String(first(attrs, "db.operation.name", "db.operation") ?? spanName.split(".").at(-1) ?? "");
+    const collection = first(attrs, "db.collection.name", "db.mongodb.collection");
+    const raw = String(first(attrs, "db.query.text", "db.statement") ?? "");
+    let statement = raw;
+    let hash = null;
+    try {
+        const command = JSON.parse(raw);
+        const values = [];
+        const shaped = Object.fromEntries(Object.entries(command)
+            .filter(([key]) => !NOISE.has(key))
+            .map(([key, value]) => [key, VALUES.has(key) ? shape(value, values) : value]));
+        statement = JSON.stringify(shaped);
+        hash = createHash("sha1").update(JSON.stringify(values)).digest("hex").slice(0, 12);
+    }
+    catch {
+        // Not JSON: kept as the instrumentation wrote it.
+    }
+    return {
+        name: collection ? `${operation} ${collection}` : operation,
+        attrs: {
+            "db.system": "mongodb",
+            "db.operation": operation,
+            "db.namespace": first(attrs, "db.namespace", "db.name") ?? null,
+            "db.collection.name": collection ?? null,
+            "db.statement": statement.length > 2000 ? `${statement.slice(0, 1999)}…` : statement,
+            "db.params_hash": hash,
+            "server.address": first(attrs, "server.address", "net.peer.name") ?? null,
+            "server.port": first(attrs, "server.port", "net.peer.port") ?? null,
+        },
+    };
+}
+//# sourceMappingURL=calls.js.map

package/dist/calls.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// `tracepanel run <command>`, `tracepanel dev`, `tracepanel mcp`: as the Python package's, for Node apps.
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { loadConfig } from "./config.js";
+const HELP = `usage: tracepanel <command>
+  run <command...>   run a Node command with Tracepanel on (node --import @tracepanel/js/register)
+  dev [--port 8765]  run the agent in the foreground, with the console on http://127.0.0.1:8765/
+  mcp [--values]     an MCP server for AI coding agents, on stdin and stdout`;
+function agentBinary() {
+    return createRequire(import.meta.url)("@tracepanel/agent").binaryPath();
+}
+function exec(command, args, env = process.env) {
+    const child = spawn(command, args, { stdio: "inherit", env });
+    child.on("exit", (code, signal) => {
+        if (signal)
+            process.kill(process.pid, signal);
+        process.exit(code ?? 1);
+    });
+}
+const [command, ...args] = process.argv.slice(2);
+const config = loadConfig();
+if (command === "run" && args.length > 0) {
+    const register = new URL("./register.js", import.meta.url).href;
+    const options = [process.env.NODE_OPTIONS, `--import ${register}`].filter(Boolean).join(" ");
+    exec(args[0], args.slice(1), { ...process.env, NODE_OPTIONS: options, TRACEPANEL_ENABLED: "1" });
+}
+else if (command === "dev") {
+    const port = args[args.indexOf("--port") + 1] && args.includes("--port") ? args[args.indexOf("--port") + 1] : "8765";
+    exec(agentBinary(), ["--dir", config.storeDir, "--serve", `127.0.0.1:${port}`]);
+}
+else if (command === "mcp") {
+    exec(agentBinary(), ["mcp", "--dir", config.storeDir, ...(args.includes("--values") ? ["--values"] : [])]);
+}
+else {
+    process.stdout.write(`${HELP}\n`);
+    process.exit(command ? 2 : 0);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,0GAA0G;AAE1G,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,IAAI,GAAG;;;6EAGgE,CAAC;AAE9E,SAAS,WAAW;IAClB,OAAQ,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAA8B,CAAC,UAAU,EAAE,CAAC;AACxG,CAAC;AAED,SAAS,IAAI,CAAC,OAAe,EAAE,IAAc,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACjD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAE5B,IAAI,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7F,IAAI,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7G,CAAC;KAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrH,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;KAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;IAC7B,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7G,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+/** Where Tracepanel keeps its state and what it calls the app: from TRACEPANEL_* variables and the project. */
+export interface Config {
+    enabled: boolean;
+    /** The project's directory: paths in stacks are relative to it, and the store lives in it. */
+    root: string;
+    /** The store directory the agent uses (.tracepanel), where it leaves its addresses. */
+    storeDir: string;
+    /** The app's name on the service map: TRACEPANEL_SERVICE, package.json's name, or the directory's. */
+    service: string;
+    maxTraces: number;
+    /** The agent's limits for the issues it finds, as the Python SDK names them: TRACEPANEL_SLOW_SQL_MS and so on. */
+    thresholds: Thresholds;
+}
+/** What the agent reports, and from when. Its defaults are these too. */
+export interface Thresholds {
+    /** Repeats of one statement or call in a request that make an N+1. */
+    n_plus_one: number;
+    /** For calls to memory stores (Redis, a cache): an N+1 only once the repeats cost this much together. */
+    n_plus_one_min_ms: number;
+    slow_sql_ms: number;
+    /** Outgoing HTTP calls, and RPC calls. */
+    slow_http_ms: number;
+    long_transaction_ms: number;
+    /** A task that waited this long in its queue. */
+    queue_wait_ms: number;
+    /** A SELECT without a LIMIT that returned this many rows. */
+    large_result_rows: number;
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): Config;

package/dist/config.js

@@ -0,0 +1,48 @@
+import { readFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+const THRESHOLDS = {
+    n_plus_one: ["TRACEPANEL_N_PLUS_ONE_THRESHOLD", 3],
+    n_plus_one_min_ms: ["TRACEPANEL_N_PLUS_ONE_MIN_MS", 5],
+    slow_sql_ms: ["TRACEPANEL_SLOW_SQL_MS", 100],
+    slow_http_ms: ["TRACEPANEL_SLOW_HTTP_MS", 500],
+    long_transaction_ms: ["TRACEPANEL_LONG_TRANSACTION_MS", 500],
+    queue_wait_ms: ["TRACEPANEL_QUEUE_WAIT_MS", 1000],
+    large_result_rows: ["TRACEPANEL_LARGE_RESULT_ROWS", 1000],
+};
+function thresholds(env) {
+    const found = {};
+    for (const [name, [variable, fallback]] of Object.entries(THRESHOLDS)) {
+        const value = Number(env[variable]);
+        found[name] = Number.isFinite(value) && env[variable] !== undefined && env[variable] !== "" ? value : fallback;
+    }
+    return found;
+}
+const OFF = new Set(["0", "false", "no", "off"]);
+/** On in development: unless NODE_ENV is production, or TRACEPANEL_ENABLED turns it off (or on). */
+function enabled(env) {
+    const explicit = env.TRACEPANEL_ENABLED?.toLowerCase();
+    if (explicit !== undefined && explicit !== "")
+        return !OFF.has(explicit);
+    return env.NODE_ENV !== "production";
+}
+function packageName(root) {
+    try {
+        const name = JSON.parse(readFileSync(join(root, "package.json"), "utf8")).name;
+        return typeof name === "string" && name !== "" ? name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function loadConfig(env = process.env) {
+    const root = resolve(env.TRACEPANEL_ROOT ?? process.cwd());
+    return {
+        enabled: enabled(env),
+        root,
+        storeDir: resolve(root, env.TRACEPANEL_DIR ?? ".tracepanel"),
+        service: env.TRACEPANEL_SERVICE || packageName(root) || basename(root),
+        maxTraces: Number(env.TRACEPANEL_MAX_TRACES) || 2000,
+        thresholds: thresholds(env),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpD,MAAM,UAAU,GAA+C;IAC7D,UAAU,EAAE,CAAC,iCAAiC,EAAE,CAAC,CAAC;IAClD,iBAAiB,EAAE,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACtD,WAAW,EAAE,CAAC,wBAAwB,EAAE,GAAG,CAAC;IAC5C,YAAY,EAAE,CAAC,yBAAyB,EAAE,GAAG,CAAC;IAC9C,mBAAmB,EAAE,CAAC,gCAAgC,EAAE,GAAG,CAAC;IAC5D,aAAa,EAAE,CAAC,0BAA0B,EAAE,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,8BAA8B,EAAE,IAAI,CAAC;CAC1D,CAAC;AAEF,SAAS,UAAU,CAAC,GAAsB;IACxC,MAAM,KAAK,GAAG,EAAgB,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAA2C,EAAE,CAAC;QAChH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAEjD,oGAAoG;AACpG,SAAS,OAAO,CAAC,GAAsB;IACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,EAAE,WAAW,EAAE,CAAC;IACvD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;QACrB,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,IAAI,aAAa,CAAC;QAC5D,OAAO,EAAE,GAAG,CAAC,kBAAkB,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC;QACtE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,IAAI;QACpD,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/console.d.ts

@@ -0,0 +1,6 @@
+import type { TracepanelProcessor } from "./processor.js";
+/**
+ * Each of console's methods becomes a property whose value records the call, then runs the method as it is now:
+ * something that replaces it later (Nuxt's dev server puts its own logger there) replaces what runs, not the record.
+ */
+export declare function captureConsole(processor: TracepanelProcessor): void;

package/dist/console.js

@@ -0,0 +1,44 @@
+// console.* calls made during a request go to its trace, then on to the terminal as before.
+import { format } from "node:util";
+const LEVELS = {
+    debug: "debug",
+    log: "info",
+    info: "info",
+    warn: "warning",
+    error: "error",
+};
+const CAPTURED = Symbol.for("tracepanel.console");
+/**
+ * Each of console's methods becomes a property whose value records the call, then runs the method as it is now:
+ * something that replaces it later (Nuxt's dev server puts its own logger there) replaces what runs, not the record.
+ */
+export function captureConsole(processor) {
+    const target = console;
+    if (target[CAPTURED])
+        return;
+    target[CAPTURED] = true;
+    for (const [method, level] of Object.entries(LEVELS)) {
+        let current = target[method];
+        const recorded = (...args) => {
+            const error = args.find((arg) => arg instanceof Error);
+            processor.addLog({
+                time: Date.now() * 1000,
+                level,
+                logger: "console",
+                message: format(...args),
+                exception: error?.stack ?? null,
+                attrs: {},
+            });
+            current.apply(console, args);
+        };
+        Object.defineProperty(console, method, {
+            configurable: true,
+            enumerable: true,
+            get: () => recorded,
+            set: (replacement) => {
+                current = replacement;
+            },
+        });
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,MAAM,MAAM,GAAiC;IAC3C,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA8B;IAC3D,MAAM,MAAM,GAAG,OAAwE,CAAC;IACxF,IAAI,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAiC,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAgB,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;YACrE,SAAS,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;gBACvB,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;gBACxB,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI;gBAC/B,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE;YACrC,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ;YACnB,GAAG,EAAE,CAAC,WAAyC,EAAE,EAAE;gBACjD,OAAO,GAAG,WAAW,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/express.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from "express";
+export declare function tracepanel(): (req: Request, res: Response, next: NextFunction) => void;

package/dist/express.js

@@ -0,0 +1,77 @@
+// `app.use(tracepanel())`: every response gets what the badge reads (Tracepanel-Id, Server-Timing), and HTML pages
+// get widget.min.js. The response is held until the handler ends it: a page or a JSON answer, not a stream.
+import { runtime } from "./runtime.js";
+import { badge, exposedHeaders, inject } from "./widget.js";
+function toBuffer(chunk, encoding) {
+    if (Buffer.isBuffer(chunk))
+        return chunk;
+    if (chunk instanceof Uint8Array)
+        return Buffer.from(chunk);
+    return Buffer.from(String(chunk), encoding);
+}
+export function tracepanel() {
+    const tp = runtime();
+    return function tracepanelMiddleware(req, res, next) {
+        if (!tp) {
+            next();
+            return;
+        }
+        tp.processor.setFramework("Express");
+        const startedMs = performance.now();
+        const chunks = [];
+        const write = res.write.bind(res);
+        const end = res.end.bind(res);
+        let streaming = false;
+        const flushHeld = () => {
+            if (chunks.length > 0)
+                write(Buffer.concat(chunks.splice(0)));
+        };
+        res.write = ((chunk, encoding, callback) => {
+            if (streaming || String(res.getHeader("content-type")).includes("text/event-stream")) {
+                streaming = true;
+                flushHeld();
+                return write(chunk, encoding, callback);
+            }
+            chunks.push(toBuffer(chunk, typeof encoding === "string" ? encoding : undefined));
+            if (typeof encoding === "function")
+                encoding();
+            else if (typeof callback === "function")
+                callback();
+            return true;
+        });
+        res.end = ((chunk, encoding, callback) => {
+            res.write = write;
+            res.end = end;
+            if (typeof chunk === "function")
+                return end(chunk);
+            if (chunk !== undefined && chunk !== null && !streaming) {
+                chunks.push(toBuffer(chunk, typeof encoding === "string" ? encoding : undefined));
+            }
+            else if (streaming && chunk !== undefined && chunk !== null) {
+                return end(chunk, encoding, callback);
+            }
+            if (streaming || res.headersSent) {
+                flushHeld();
+                return end(callback);
+            }
+            let body = Buffer.concat(chunks);
+            const page = String(res.getHeader("content-type") ?? "").includes("text/html");
+            const framework = tp.processor.framework() ?? "Express";
+            const marks = badge(tp, { method: req.method, status: res.statusCode, startedMs, page, framework });
+            if (marks) {
+                for (const [name, value] of Object.entries(marks.headers))
+                    res.setHeader(name, value);
+                const expose = exposedHeaders(res.getHeader("access-control-allow-origin"), res.getHeader("access-control-expose-headers"));
+                if (expose)
+                    res.setHeader("Access-Control-Expose-Headers", expose);
+                if (marks.script)
+                    body = Buffer.from(inject(body.toString("utf8"), marks.script));
+            }
+            if (!res.getHeader("transfer-encoding"))
+                res.setHeader("Content-Length", body.length);
+            return end(body, callback);
+        });
+        next();
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,4GAA4G;AAG5G,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK5D,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAyB;IACzD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IACrB,OAAO,SAAS,oBAAoB,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QAClF,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAU,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAQ,CAAC;QACrC,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC;QAEF,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAc,EAAE,QAAkB,EAAE,QAAkB,EAAE,EAAE;YACtE,IAAI,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACrF,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,KAAc,EAAE,QAAiB,EAAE,QAAiB,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAE,QAA2B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YACtG,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAG,QAAuB,EAAE,CAAC;iBAC1D,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAG,QAAuB,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC,CAAU,CAAC;QAEZ,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAe,EAAE,QAAkB,EAAE,QAAkB,EAAE,EAAE;YACrE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YAClB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YACd,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,OAAO,GAAG,CAAC,KAAmB,CAAC,CAAC;YACjE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAE,QAA2B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YACxG,CAAC;iBAAM,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC9D,OAAO,GAAG,CAAC,KAAc,EAAE,QAAiB,EAAE,QAAiB,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,SAAS,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACjC,SAAS,EAAE,CAAC;gBACZ,OAAO,GAAG,CAAC,QAAiB,CAAC,CAAC;YAChC,CAAC;YACD,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC/E,MAAM,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,SAAS,CAAC;YACxD,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACpG,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;oBAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtF,MAAM,MAAM,GAAG,cAAc,CAC3B,GAAG,CAAC,SAAS,CAAC,6BAA6B,CAAC,EAC5C,GAAG,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAC/C,CAAC;gBACF,IAAI,MAAM;oBAAE,GAAG,CAAC,SAAS,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC;gBACnE,IAAI,KAAK,CAAC,MAAM;oBAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YACpF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC;gBAAE,GAAG,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACtF,OAAO,GAAG,CAAC,IAAI,EAAE,QAAiB,CAAC,CAAC;QACtC,CAAC,CAAQ,CAAC;QAEV,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/frameworks.d.ts

@@ -0,0 +1,2 @@
+/** "Express" as "Express 5.3.0", or with `parts` of the version only ("Express 5.3"); as it is when unknown. */
+export declare function withVersion(framework: string, parts?: number): string;

package/dist/frameworks.js

@@ -0,0 +1,39 @@
+// A framework's version, from its package.json in the project's node_modules: "Next.js 16.4", as the Python SDK says
+// "Django 6.1". Read once per framework.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const PACKAGES = {
+    Express: "express",
+    NestJS: "@nestjs/core",
+    "Next.js": "next",
+    Nuxt: "nuxt",
+};
+const versions = new Map();
+function installed(name) {
+    let folder = process.cwd();
+    for (;;) {
+        try {
+            const version = JSON.parse(readFileSync(join(folder, "node_modules", name, "package.json"), "utf8")).version;
+            return typeof version === "string" ? version : null;
+        }
+        catch {
+            const parent = dirname(folder);
+            if (parent === folder)
+                return null;
+            folder = parent;
+        }
+    }
+}
+/** "Express" as "Express 5.3.0", or with `parts` of the version only ("Express 5.3"); as it is when unknown. */
+export function withVersion(framework, parts) {
+    const name = PACKAGES[framework];
+    if (!name)
+        return framework;
+    if (!versions.has(name))
+        versions.set(name, installed(name));
+    const version = versions.get(name);
+    if (!version)
+        return framework;
+    return `${framework} ${parts ? version.split(".").slice(0, parts).join(".") : version}`;
+}
+//# sourceMappingURL=frameworks.js.map

package/dist/frameworks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.js","sourceRoot":"","sources":["../src/frameworks.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,yCAAyC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,QAAQ,GAA2B;IACvC,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CACjC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACzE,CAAC,OAAO,CAAC;YACV,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,GAAG,MAAM,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,KAAc;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,GAAG,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1F,CAAC"}

package/dist/headers.d.ts

@@ -0,0 +1,2 @@
+import type { Runtime } from "./runtime.js";
+export declare function headersOnResponses(tracepanel: Runtime, framework: string): void;