@tracepanel/js 0.0.0-stage → 0.2.0

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,57 @@
+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;

package/dist/model.js

@@ -0,0 +1,18 @@
+// 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);
+}
+//# 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"}

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

package/dist/nuxt-plugin.js

@@ -0,0 +1,39 @@
+// The Nitro plugin @tracepanel/js/nuxt adds in development. Nitro bundles it into the server: it reads the process's
+// Tracepanel from globalThis and brings no OpenTelemetry of its own.
+import { captureConsole } from "./console.js";
+import { headersOnResponses } from "./headers.js";
+const KEY = Symbol.for("tracepanel.runtime");
+export default function tracepanelPlugin(nitroApp) {
+    const tracepanel = globalThis[KEY];
+    if (!tracepanel)
+        return;
+    headersOnResponses(tracepanel, "Nuxt");
+    // Nuxt's dev server replaced console with its own logger after --import wrapped it.
+    captureConsole(tracepanel.processor);
+    // h3 answers a thrown error with a 500 and records it nowhere: the request's trace gets it here.
+    // createError({ statusCode: 404 }) and the like are answers, not errors.
+    nitroApp.hooks.hook("error", (error) => {
+        const status = error.statusCode ?? 500;
+        if (status >= 500)
+            tracepanel.processor.addError(error);
+    });
+    nitroApp.hooks.hook("request", () => tracepanel.processor.setFramework("Nuxt"));
+    // The route is matched by then. The renderer's catch-all (/**) serves every page: its path names a page better.
+    nitroApp.hooks.hook("beforeResponse", (event) => {
+        const route = event.context.matchedRoute?.path;
+        if (route && !route.includes("**"))
+            tracepanel.processor.setRoute(route);
+    });
+    nitroApp.hooks.hook("render:html", (html, { event }) => {
+        const marks = tracepanel.badge({
+            method: event.method ?? "GET",
+            status: 200,
+            startedMs: performance.now(),
+            page: true,
+            framework: tracepanel.processor.framework() ?? "Nuxt",
+        });
+        if (marks?.script)
+            html.head.unshift(marks.script);
+    });
+}
+//# sourceMappingURL=nuxt-plugin.js.map

package/dist/nuxt-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-plugin.js","sourceRoot":"","sources":["../src/nuxt-plugin.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,qEAAqE;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAgB7C,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,QAAkB;IACzD,MAAM,UAAU,GAAI,UAAkC,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvC,oFAAoF;IACpF,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC,iGAAiG;IACjG,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACrC,MAAM,MAAM,GAAI,KAAiC,CAAC,UAAU,IAAI,GAAG,CAAC;QACpE,IAAI,MAAM,IAAI,GAAG;YAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,gHAAgH;IAChH,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;QAC/C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;YAC7B,MAAM,EAAE,GAAG;YACX,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,MAAM;SACtD,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/nuxt.d.ts

@@ -0,0 +1,10 @@
+interface Nuxt {
+    options: {
+        dev: boolean;
+        nitro: {
+            plugins?: string[];
+        };
+    };
+}
+export default function tracepanelModule(_options: unknown, nuxt: Nuxt): void;
+export {};

package/dist/nuxt.js

@@ -0,0 +1,16 @@
+// `modules: ["@tracepanel/js/nuxt"]` in nuxt.config: a Nitro plugin that names each request by its route, puts the badge
+// on server-rendered pages and the trace's id on every response. OpenTelemetry itself goes in before Nitro, with
+// `NODE_OPTIONS=--import=@tracepanel/js/register nuxt dev`, so it can hook the database driver as Nitro loads it.
+import { fileURLToPath } from "node:url";
+export default function tracepanelModule(_options, nuxt) {
+    if (!nuxt.options.dev)
+        return;
+    nuxt.options.nitro.plugins = [
+        ...(nuxt.options.nitro.plugins ?? []),
+        fileURLToPath(new URL("./nuxt-plugin.js", import.meta.url)),
+    ];
+}
+Object.assign(tracepanelModule, {
+    getMeta: () => Promise.resolve({ name: "tracepanel", configKey: "tracepanel" }),
+});
+//# sourceMappingURL=nuxt.js.map

package/dist/nuxt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt.js","sourceRoot":"","sources":["../src/nuxt.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,iHAAiH;AACjH,kHAAkH;AAElH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,QAAiB,EAAE,IAAU;IACpE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;QAAE,OAAO;IAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG;QAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,aAAa,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;CAChF,CAAC,CAAC"}

package/dist/processor.d.ts

@@ -0,0 +1,105 @@
+import { type Context } from "@opentelemetry/api";
+import type { ReadableSpan, Span as SdkSpan, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { Config } from "./config.js";
+import { type Log, micros, type Trace } from "./model.js";
+/** Where a trace goes once its request ends. */
+export interface Sink {
+    submit(trace: Trace): void;
+}
+/** One request's trace while its spans end. */
+interface Building {
+    trace: Trace;
+    /** OTel span id: the Tracepanel span id it is, or its nearest kept ancestor's when it is left out. */
+    ids: Map<string, string | null>;
+    origins: Map<string, string | null>;
+    queries: number;
+    dbTime: number;
+    framework: string;
+    /** performance.now() as the request's root span started. */
+    startedMs: number;
+    /** OTel span id of the request's root span here: its parent, if any, is in another process. */
+    rootSpanId: string;
+    /** The route pattern a framework named (Nitro's /api/books/:id), for a root span that has none. */
+    route: string | null;
+    /** The request as its root span started: method and target, to find it from a response sent outside its context. */
+    request: string;
+    /** Whether a response's headers have taken this trace's id already. */
+    answered: boolean;
+    /** Tracepanel ids of Nest controller spans: the exceptions they record may be HTTP answers, not errors. */
+    nestViews: Set<string>;
+    /** OTel span id: the Tracepanel id of the span's parent when it started. */
+    parents: Map<string, string | null>;
+    /** Express's anonymous route handlers that a Nest controller's span stands in for: left out, children and all. */
+    replaced: Set<string>;
+    /** OTel span id: the Express route handlers' ones, so a Nest span under one can take its place. */
+    expressHandlers: Set<string>;
+    /**
+     * The app's line behind the latest span that had one. A driver often starts its query span later, from a callback
+     * (pg's pool runs the query once it has a connection), where the stack holds none of the app's code; the
+     * connection checkout before it started right in the app's call.
+     */
+    lastOrigin: string | null;
+}
+export declare class TracepanelProcessor implements SpanProcessor {
+    private readonly config;
+    private readonly sink;
+    /** The traces being built, by their root span's OTel id. */
+    private readonly open;
+    /**
+     * OTel span id → the trace it belongs to. Not the OTel trace id: a request the app makes to itself (fetch to its own
+     * API) carries the caller's trace id, and is a trace of its own all the same.
+     */
+    private readonly owner;
+    constructor(config: Config, sink: Sink);
+    onStart(span: SdkSpan, _parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    /** The trace being built for the active request, with the current span's Tracepanel id. */
+    current(): {
+        building: Building;
+        spanId: string | null;
+    } | undefined;
+    /** What the widget shows before the request's span ends: its id, its queries so far and their time. */
+    timing(request?: {
+        method: string;
+        url: string;
+    }): Timing | undefined;
+    private dropAbandoned;
+    /** The trace is done here: its spans no longer lead to it. */
+    private close;
+    /**
+     * The open trace of a request whose response goes out outside its context (Next.js streams a page from another
+     * async context): the latest one for this method and URL that no response has answered yet.
+     */
+    private waiting;
+    /** An error a framework caught and answered with a 500 itself, without recording it on a span (Nitro). */
+    addError(error: unknown): void;
+    addLog(log: Omit<Log, "span_id">): void;
+    /** The framework the active request runs on, unless a more specific one (Nest on Express) already said so. */
+    setFramework(name: string): void;
+    /** The route pattern the framework matched, when the root span doesn't carry one (Nitro). */
+    setRoute(route: string): void;
+    /** The framework the active request ran on, as the panel shows it. */
+    framework(): string | undefined;
+    private start;
+    /** A span as Tracepanel draws it: the request, a route handler (view), a statement (sql), an outgoing call. */
+    private convert;
+    private sqlAttrs;
+    /** Exceptions the instrumentation recorded on a span: the request's errors, with their frames. */
+    private collectErrors;
+    /** The trace from its root span: name, timing, the request's attributes. */
+    private finish;
+    /** A command (trace()) or a task (a queue's job): named as it was started, its task.* attributes kept. */
+    private finishWork;
+}
+export interface Timing {
+    id: string;
+    queries: number;
+    dbMs: number;
+    /** performance.now() as the request started. */
+    startedMs: number;
+}
+/** `Node 26 · Express`: what the panel shows next to its logo. */
+export declare function runtimeLabel(framework: string): string;
+export { micros };