@tracepanel/js 0.0.0-stage → 0.3.0

package/dist/explain.js

@@ -0,0 +1,145 @@
+// EXPLAIN for the agent's console: the agent writes the statement and sends it down the connection the traces go up
+// (agent.ts); this runs it on the app's database and answers with the rows, which the agent reads as a plan.
+//
+// The app's databases are the ones its queries ran on: each pg or mysql2 connection that queries is remembered by
+// its settings (the password among them), and EXPLAIN opens one of its own with them, so it never runs inside the
+// app's transaction. Whatever EXPLAIN ANALYZE does is rolled back.
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from "@opentelemetry/instrumentation";
+const DATABASES = new Map();
+function remember(database) {
+    const key = `${database.vendor} ${database.server}:${database.port}/${database.database}`;
+    if (!DATABASES.has(key))
+        DATABASES.set(key, database);
+}
+/** The database a span's query ran on: by vendor, server, port and name; the only one of that vendor otherwise. */
+function databaseFor(request) {
+    const vendor = request.vendor === "mariadb" ? "mysql" : request.vendor;
+    const candidates = [...DATABASES.values()].filter((database) => database.vendor === vendor);
+    const exact = candidates.find((database) => (request.server == null || database.server === request.server) &&
+        (request.port == null || database.port === Number(request.port)) &&
+        (request.database == null || database.database === request.database));
+    return exact ?? (candidates.length === 1 ? candidates[0] : undefined);
+}
+export async function explain(request) {
+    const database = databaseFor(request);
+    if (!database)
+        throw new Error(`The app has queried no ${request.vendor} database it can run EXPLAIN on.`);
+    const session = await database.open();
+    try {
+        await session.run("BEGIN", []);
+        return await session.run(request.sql, request.params);
+    }
+    finally {
+        await session.run("ROLLBACK", []).catch(() => undefined);
+        await session.close();
+    }
+}
+const MARK = Symbol.for("tracepanel.explain");
+/** Records pg's and mysql2's connections as they query: where they are, and their settings. */
+export class DatabasesInstrumentation extends InstrumentationBase {
+    constructor() {
+        super("tracepanel-databases", "1.0.0", {});
+    }
+    init() {
+        return [
+            new InstrumentationNodeModuleDefinition("pg", [">=8"], (exports) => {
+                this.watch(exports.Client?.prototype, (client) => rememberPg(client));
+                return exports;
+            }),
+            new InstrumentationNodeModuleDefinition("mysql2", [">=3"], (exports) => {
+                this.watch(exports.Connection?.prototype, (client) => rememberMysql(client, exports));
+                return exports;
+            }),
+        ];
+    }
+    /**
+     * `query` on `proto` notes the connection first. The OpenTelemetry instrumentation wraps it too, so a wrapper of
+     * its own is told by a mark, not by isWrapped.
+     */
+    watch(proto, note) {
+        if (!proto || typeof proto.query !== "function" || proto.query[MARK])
+            return;
+        const original = proto.query;
+        const watched = function (...args) {
+            try {
+                note(this);
+            }
+            catch {
+                // Never in the way of the app's query.
+            }
+            return original.apply(this, args);
+        };
+        Object.defineProperty(watched, MARK, { value: true });
+        proto.query = watched;
+    }
+}
+function rememberPg(client) {
+    const params = client?.connectionParameters;
+    const Client = client?.constructor;
+    if (!params || typeof Client !== "function")
+        return;
+    remember({
+        vendor: "postgresql",
+        server: String(params.host ?? "localhost"),
+        port: Number(params.port ?? 5432),
+        database: String(params.database ?? ""),
+        async open() {
+            // Field by field: pg keeps the password a property the spread leaves out.
+            const session = new Client({
+                user: params.user,
+                password: params.password,
+                host: params.host,
+                port: params.port,
+                database: params.database,
+                ssl: params.ssl,
+            });
+            await session.connect();
+            return {
+                async run(sql, values) {
+                    const result = await session.query({ text: sql, values, rowMode: "array" });
+                    return { columns: (result.fields ?? []).map((field) => String(field.name)), rows: result.rows ?? [] };
+                },
+                close: () => session.end(),
+            };
+        },
+    });
+}
+function rememberMysql(connection, mysql2) {
+    const config = connection?.config;
+    if (!config || typeof mysql2.createConnection !== "function")
+        return;
+    const settings = {
+        host: config.host,
+        port: config.port,
+        user: config.user,
+        password: config.password,
+        database: config.database,
+        socketPath: config.socketPath,
+        ssl: config.ssl,
+    };
+    remember({
+        vendor: "mysql",
+        server: String(config.host ?? "localhost"),
+        port: Number(config.port ?? 3306),
+        database: String(config.database ?? ""),
+        async open() {
+            const session = mysql2.createConnection(settings);
+            const query = (sql, values) => new Promise((resolve, reject) => {
+                session.query({ sql, rowsAsArray: true }, values, (error, rows, fields) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve({
+                            columns: (fields ?? []).map((field) => String(field.name)),
+                            rows: Array.isArray(rows) ? rows : [],
+                        });
+                });
+            });
+            return {
+                run: query,
+                close: () => new Promise((resolve) => session.end(() => resolve())),
+            };
+        },
+    });
+}
+//# sourceMappingURL=explain.js.map

package/dist/explain.js.map

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

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":"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"}

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;

package/dist/headers.js

@@ -0,0 +1,42 @@
+// For frameworks that answer from their own server (Next.js, Nuxt): every response of a traced request gets what the
+// widget and the badge read, Tracepanel-Id, Tracepanel-Url and Server-Timing, as its headers go out.
+import { ServerResponse } from "node:http";
+import { exposedHeaders } from "./widget.js";
+const PATCHED = Symbol.for("tracepanel.headers");
+export function headersOnResponses(tracepanel, framework) {
+    const prototype = ServerResponse.prototype;
+    if (prototype[PATCHED])
+        return;
+    prototype[PATCHED] = true;
+    const writeHead = prototype.writeHead;
+    prototype.writeHead = function (...args) {
+        if (!this.headersSent) {
+            const marks = tracepanel.badge({
+                method: this.req?.method ?? "GET",
+                url: this.req?.url ?? "/",
+                status: typeof args[0] === "number" ? args[0] : this.statusCode,
+                startedMs: performance.now(),
+                page: false,
+                framework: tracepanel.processor.framework() ?? framework,
+            });
+            for (const [name, value] of Object.entries(marks?.headers ?? {})) {
+                if (!this.hasHeader(name))
+                    this.setHeader(name, value);
+            }
+            // Headers passed to writeHead itself (an object) count too: CORS middleware often sets them there.
+            const given = [args[1], args[2]].find((arg) => arg !== null && typeof arg === "object" && !Array.isArray(arg));
+            const passed = (given ?? {});
+            const lower = Object.fromEntries(Object.entries(passed ?? {}).map(([name, value]) => [name.toLowerCase(), value]));
+            const expose = marks
+                ? exposedHeaders(this.getHeader("access-control-allow-origin") ?? lower["access-control-allow-origin"], this.getHeader("access-control-expose-headers") ?? lower["access-control-expose-headers"])
+                : undefined;
+            if (expose) {
+                this.setHeader("Access-Control-Expose-Headers", expose);
+                delete passed["access-control-expose-headers"];
+                delete passed["Access-Control-Expose-Headers"];
+            }
+        }
+        return writeHead.apply(this, args);
+    };
+}
+//# sourceMappingURL=headers.js.map

package/dist/headers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { TraceOptions } from "./api.js";
+export { span, trace } from "./api.js";
+export type { Config, Thresholds } from "./config.js";
+export { loadConfig } from "./config.js";
+export type { Trace } from "./model.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { span, trace } from "./api.js";
+export { loadConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/logs.d.ts

@@ -0,0 +1,8 @@
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from "@opentelemetry/instrumentation";
+import type { TracepanelProcessor } from "./processor.js";
+/** Nest's ConsoleLogger, which Logger and the app's own loggers use unless replaced. */
+export declare class NestLogs extends InstrumentationBase {
+    private readonly processor;
+    constructor(processor: TracepanelProcessor);
+    protected init(): InstrumentationNodeModuleDefinition;
+}

package/dist/logs.js

@@ -0,0 +1,54 @@
+// Nest's Logger calls go to the request's trace, as console's do (console.ts): Nest writes to the terminal itself.
+import { format } from "node:util";
+import { InstrumentationBase, InstrumentationNodeModuleDefinition, isWrapped } from "@opentelemetry/instrumentation";
+const NEST_LEVELS = {
+    verbose: "debug",
+    debug: "debug",
+    log: "info",
+    warn: "warning",
+    error: "error",
+    fatal: "critical",
+};
+/** `logger.log("created", "BooksService")`: the context is the last string argument, a stack the one before it. */
+function nestRecord(level, message, params) {
+    const context = params.length > 0 && typeof params.at(-1) === "string" ? String(params.at(-1)) : "nest";
+    const stack = level === "error" && params.length > 1 && typeof params[0] === "string" ? params[0] : null;
+    return {
+        time: Date.now() * 1000,
+        level,
+        logger: context,
+        message: message instanceof Error ? message.message : format(message),
+        exception: message instanceof Error ? (message.stack ?? null) : stack,
+        attrs: {},
+    };
+}
+/** Nest's ConsoleLogger, which Logger and the app's own loggers use unless replaced. */
+export class NestLogs extends InstrumentationBase {
+    processor;
+    constructor(processor) {
+        super("tracepanel-nest-logger", "1.0.0", {});
+        this.processor = processor;
+    }
+    init() {
+        return new InstrumentationNodeModuleDefinition("@nestjs/common", [">=8"], (exports) => {
+            const prototype = exports.ConsoleLogger
+                ?.prototype;
+            if (!prototype)
+                return exports;
+            for (const [method, level] of Object.entries(NEST_LEVELS)) {
+                const original = prototype[method];
+                if (typeof original !== "function" || isWrapped(original))
+                    continue;
+                this._wrap(prototype, method, () => {
+                    const processor = this.processor;
+                    return function (message, ...params) {
+                        processor.addLog(nestRecord(level, message, params));
+                        return original.call(this, message, ...params);
+                    };
+                });
+            }
+            return exports;
+        });
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,mHAAmH;AAEnH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,mCAAmC,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAIrH,MAAM,WAAW,GAAiC;IAChD,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,UAAU;CAClB,CAAC;AAIF,mHAAmH;AACnH,SAAS,UAAU,CAAC,KAAmB,EAAE,OAAgB,EAAE,MAAiB;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxG,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzG,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;QACvB,KAAK;QACL,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACrE,SAAS,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK;QACrE,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,OAAO,QAAS,SAAQ,mBAAmB;IAClB,SAAS;IAAtC,YAA6B,SAA8B;QACzD,KAAK,CAAC,wBAAwB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;yBADlB,SAAS;IAEtC,CAAC;IAES,IAAI;QACZ,OAAO,IAAI,mCAAmC,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;YACpF,MAAM,SAAS,GAAI,OAAyE,CAAC,aAAa;gBACxG,EAAE,SAAS,CAAC;YACd,IAAI,CAAC,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC/B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,OAAO,QAAQ,KAAK,UAAU,IAAI,SAAS,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBACpE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;oBACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;oBACjC,OAAO,UAAyB,OAAgB,EAAE,GAAG,MAAiB;wBACpE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;wBACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;oBACjD,CAAC,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/model.d.ts

@@ -0,0 +1,68 @@
+export type Attrs = Record<string, unknown>;
+export interface Span {
+    id: string;
+    parent_id: string | null;
+    kind: string;
+    name: string;
+    start: number;
+    duration: number;
+    status: "ok" | "error";
+    attrs: Attrs;
+}
+export interface Log {
+    span_id: string | null;
+    time: number;
+    level: "debug" | "info" | "warning" | "error" | "critical";
+    logger: string;
+    message: string;
+    exception: string | null;
+    attrs: Attrs;
+}
+export interface Frame {
+    filename: string;
+    module: string;
+    function: string;
+    lineno: number;
+    in_app: boolean;
+    context_start: number | null;
+    context: string[];
+    locals: Record<string, string>;
+}
+export interface TraceError {
+    span_id: string | null;
+    time: number;
+    type: string;
+    message: string;
+    handled: boolean;
+    frames: Frame[];
+    chain: unknown[];
+}
+export interface Trace {
+    id: string;
+    kind: "http" | "task" | "command";
+    name: string;
+    start: number;
+    duration: number;
+    status: "ok" | "error";
+    attrs: Attrs;
+    spans: Span[];
+    logs: Log[];
+    errors: TraceError[];
+    links: unknown[];
+    issues: unknown[];
+}
+/** A ULID: 48 bits of milliseconds, 80 random bits, 26 characters of Crockford base32. */
+export declare function newId(now?: number): string;
+/** Microseconds since the epoch, as the agent stores times. */
+export declare function micros(ms: number): number;
+/** The most spans a trace is sent with, as the agent stores it; the rest are counted (`tracepanel.dropped_spans`). */
+export declare const MAX_SPANS = 2000;
+/** The most log records a trace keeps; the rest are counted (`tracepanel.dropped_logs`). */
+export declare const MAX_LOGS = 1000;
+/** Adds `count` to a trace's tally of what went unrecorded. */
+export declare function countDropped(trace: Trace, key: "tracepanel.dropped_spans" | "tracepanel.dropped_logs", count?: number): void;
+/**
+ * The trace cut to MAX_SPANS: its earliest spans, its roots always. Spans end children first, so a cut as they end
+ * would keep children whose parent went: by start, a parent always comes before its children.
+ */
+export declare function limited(trace: Trace): Trace;

package/dist/model.js

@@ -0,0 +1,41 @@
+// The trace as every Tracepanel SDK sends it to the agent: schema/trace.schema.json in the tracepanel repository.
+import { randomBytes } from "node:crypto";
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+/** A ULID: 48 bits of milliseconds, 80 random bits, 26 characters of Crockford base32. */
+export function newId(now = Date.now()) {
+    let value = (BigInt(now) << 80n) | BigInt(`0x${randomBytes(10).toString("hex")}`);
+    let out = "";
+    for (let i = 0; i < 26; i++) {
+        out = CROCKFORD[Number(value & 31n)] + out;
+        value >>= 5n;
+    }
+    return out;
+}
+/** Microseconds since the epoch, as the agent stores times. */
+export function micros(ms) {
+    return Math.round(ms * 1000);
+}
+/** The most spans a trace is sent with, as the agent stores it; the rest are counted (`tracepanel.dropped_spans`). */
+export const MAX_SPANS = 2000;
+/** The most log records a trace keeps; the rest are counted (`tracepanel.dropped_logs`). */
+export const MAX_LOGS = 1000;
+/** Adds `count` to a trace's tally of what went unrecorded. */
+export function countDropped(trace, key, count = 1) {
+    trace.attrs[key] = Number(trace.attrs[key] ?? 0) + count;
+}
+/**
+ * The trace cut to MAX_SPANS: its earliest spans, its roots always. Spans end children first, so a cut as they end
+ * would keep children whose parent went: by start, a parent always comes before its children.
+ */
+export function limited(trace) {
+    if (trace.spans.length <= MAX_SPANS)
+        return trace;
+    const ranked = trace.spans
+        .map((span, index) => ({ span, index }))
+        .sort((a, b) => Number(a.span.parent_id !== null) - Number(b.span.parent_id !== null) || a.span.start - b.span.start);
+    const kept = new Set(ranked.slice(0, MAX_SPANS).map(({ index }) => index));
+    countDropped(trace, "tracepanel.dropped_spans", trace.spans.length - kept.size);
+    trace.spans = trace.spans.filter((_, index) => kept.has(index));
+    return trace;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAElH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6D1C,MAAM,SAAS,GAAG,kCAAkC,CAAC;AAErD,0FAA0F;AAC1F,MAAM,UAAU,KAAK,CAAC,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IAC5C,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAC3C,KAAK,KAAK,EAAE,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,4FAA4F;AAC5F,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,GAA2D,EAC3D,KAAK,GAAG,CAAC;IAET,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAY;IAClC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK;SACvB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACvC,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAC/G,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,YAAY,CAAC,KAAK,EAAE,0BAA0B,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/next-widget.d.ts

@@ -0,0 +1,3 @@
+import { type ReactElement } from "react";
+/** The widget's script tag for this request's page, or nothing outside development. */
+export declare function Tracepanel(): ReactElement | null;

package/dist/next-widget.js

@@ -0,0 +1,17 @@
+// The badge on a Next.js app's pages: `<Tracepanel />` in the root layout. A server component that reads the active
+// request from the process's Tracepanel; no OpenTelemetry in it, so the layout's bundle stays as it was.
+import { createElement } from "react";
+const KEY = Symbol.for("tracepanel.runtime");
+/** The widget's script tag for this request's page, or nothing outside development. */
+export function Tracepanel() {
+    const tracepanel = globalThis[KEY];
+    const marks = tracepanel?.badge({
+        method: "GET",
+        status: 200,
+        startedMs: performance.now(),
+        page: true,
+        framework: tracepanel.processor.framework() ?? "Next.js",
+    });
+    return marks?.scriptAttrs ? createElement("script", { ...marks.scriptAttrs, async: true }) : null;
+}
+//# sourceMappingURL=next-widget.js.map

package/dist/next-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-widget.js","sourceRoot":"","sources":["../src/next-widget.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,yGAAyG;AAEzG,OAAO,EAAE,aAAa,EAAqB,MAAM,OAAO,CAAC;AAGzD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE7C,uFAAuF;AACvF,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAI,UAAkC,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC;QAC9B,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,SAAS;KACzD,CAAC,CAAC;IACH,OAAO,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpG,CAAC"}

package/dist/next.d.ts

@@ -0,0 +1,2 @@
+/** OpenTelemetry for the app, without Node's HTTP server spans: Next's root span is the request. */
+export declare function register(): void;

package/dist/next.js

@@ -0,0 +1,16 @@
+// Next.js starts its own server, before any `--import` could reach it, and makes the request's root span itself.
+// Tracepanel goes in from the app's instrumentation hook:
+//
+//   // instrumentation.ts
+//   export async function register() {
+//     if (process.env.NEXT_RUNTIME === "nodejs") (await import("@tracepanel/js/next")).register();
+//   }
+import { headersOnResponses } from "./headers.js";
+import { start } from "./setup.js";
+/** OpenTelemetry for the app, without Node's HTTP server spans: Next's root span is the request. */
+export function register() {
+    const tracepanel = start({ httpServer: false });
+    if (tracepanel)
+        headersOnResponses(tracepanel, "Next.js");
+}
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,0DAA0D;AAC1D,EAAE;AACF,0BAA0B;AAC1B,uCAAuC;AACvC,mGAAmG;AACnG,MAAM;AAEN,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,oGAAoG;AACpG,MAAM,UAAU,QAAQ;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,UAAU;QAAE,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/dist/nuxt-plugin.d.ts

@@ -0,0 +1,24 @@
+interface Event {
+    method?: string;
+    path?: string;
+    context: {
+        matchedRoute?: {
+            path?: string;
+        };
+    };
+}
+interface NitroApp {
+    hooks: {
+        hook(name: "request" | "beforeResponse", handler: (event: Event) => void): void;
+        hook(name: "render:html", handler: (html: {
+            head: string[];
+        }, context: {
+            event: Event;
+        }) => void): void;
+        hook(name: "error", handler: (error: unknown, context: {
+            event?: Event;
+        }) => void): void;
+    };
+}
+export default function tracepanelPlugin(nitroApp: NitroApp): void;
+export {};