@tracepanel/js 0.5.0 → 0.7.0

package/dist/fastify.js

@@ -0,0 +1,100 @@
+// `await app.register(tracepanel())`, before the routes: a Fastify plugin. Each route's handler is a span of its own,
+// named by its route (`/books/:id`) and the app's line that added it; the request's trace is named by the route too.
+// Every response gets what the badge reads (Tracepanel-Id, Server-Timing), and an HTML page the widget's script: one
+// sent whole has it put into its body, a stream as it passes. What the request carried goes into its trace as the
+// response goes out: its headers, query, cookies, the body Fastify parsed, the session (`request.session`), and the
+// response's headers. An error the handler throws is the request's unless Fastify answers it below 500.
+//
+// Fastify's own OpenTelemetry instrumentation is deprecated, and @fastify/otel is a plugin to register too, with a span
+// for every hook: this plugin needs nothing but Fastify's hooks.
+import { hasBody, parsedBody, requestAttrs, responseHeaders, searchOf } from "./request.js";
+import { runtime } from "./runtime.js";
+import { expressSession } from "./session.js";
+import { madeAt } from "./stack.js";
+import { inView, statusOf, wasRecorded } from "./view.js";
+import { inject, responseMarks, streamablePage, streamWith } from "./widget.js";
+const TRACED = Symbol.for("tracepanel.fastify.handler");
+const FRAMEWORK = "Fastify";
+function isStream(payload) {
+    return payload !== null && typeof payload === "object" && typeof payload.pipe === "function";
+}
+/** What the request carried, the body Fastify parsed, the session as the handler left it, the response's headers. */
+function carried(request, reply) {
+    const { headers } = request;
+    const body = hasBody(headers) ? parsedBody({ contentType: headers["content-type"] ?? "", body: request.body }) : {};
+    return {
+        ...requestAttrs(headers, searchOf(request.url)),
+        ...body,
+        ...expressSession(request.session),
+        ...responseHeaders(Object.entries(reply.getHeaders())),
+    };
+}
+export function tracepanel() {
+    const plugin = async (app) => {
+        const tp = runtime();
+        if (!tp)
+            return;
+        const started = new WeakMap();
+        app.addHook("onRoute", (route) => {
+            const handler = route.handler;
+            if (handler[TRACED])
+                return;
+            // The app's line that added the route: where its handler is, most often.
+            const origin = madeAt(tp.config.root).origin;
+            const name = route.url;
+            const traced = function (request, reply) {
+                return inView(name, origin, () => handler.call(this, request, reply));
+            };
+            traced[TRACED] = true;
+            route.handler = traced;
+        });
+        app.addHook("onRequest", async (request) => {
+            started.set(request, performance.now());
+            tp.processor.setFramework(FRAMEWORK);
+            const route = request.routeOptions.url;
+            if (route)
+                tp.processor.setRoute(route);
+        });
+        // One a hook threw, or one the handler's span didn't see (a validation error is below 500, and not one).
+        app.addHook("onError", async (_request, _reply, error) => {
+            if (statusOf(error) >= 500 && !wasRecorded(error))
+                tp.processor.addError(error);
+        });
+        app.addHook("onSend", async (request, reply, payload) => {
+            if (tp.config.captureRequest)
+                tp.processor.setTraceAttrs(carried(request, reply));
+            const header = (name) => reply.getHeader(name);
+            const html = String(header("content-type") ?? "").includes("text/html") && header("content-encoding") == null;
+            const whole = typeof payload === "string" || Buffer.isBuffer(payload);
+            const page = html && (whole || (isStream(payload) && streamablePage(header)));
+            const marks = responseMarks(tp, {
+                method: request.method,
+                status: reply.statusCode,
+                startedMs: started.get(request) ?? performance.now(),
+                page,
+                framework: tp.processor.framework() ?? FRAMEWORK,
+            }, request.headers, header);
+            if (!marks)
+                return payload;
+            reply.headers(marks.headers);
+            // Fastify keeps each Set-Cookie it is given.
+            if (marks.cookie)
+                reply.header("set-cookie", marks.cookie);
+            if (!page || !marks.script)
+                return payload;
+            if (isStream(payload))
+                return streamWith(payload, marks.script);
+            const body = inject(Buffer.isBuffer(payload) ? payload.toString("utf8") : payload, marks.script);
+            if (header("content-length") !== undefined)
+                reply.header("content-length", Buffer.byteLength(body));
+            return body;
+        });
+    };
+    // Not encapsulated, as fastify-plugin would leave it: its hooks are the app's, for the routes added after it.
+    Object.assign(plugin, {
+        [Symbol.for("skip-override")]: true,
+        [Symbol.for("fastify.display-name")]: "tracepanel",
+    });
+    return plugin;
+}
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

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

package/dist/frameworks.js

@@ -4,6 +4,9 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 const PACKAGES = {
     Express: "express",
+    Fastify: "fastify",
+    Hono: "hono",
+    Koa: "koa",
     NestJS: "@nestjs/core",
     "Next.js": "next",
     Nuxt: "nuxt",

package/dist/frameworks.js.map

@@ -1 +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"}
+{"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,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,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/graphql.d.ts

@@ -0,0 +1,39 @@
+/** What tells the processor a span is GraphQL's: an operation (it has graphql.library), `parse` or `validate`. */
+export declare const GRAPHQL = "graphql";
+/** What tells the processor a span is a resolver of the app's. */
+export declare const RESOLVER = "graphql.resolver";
+/** A Yoga plugin's hooks this one has: Yoga's own types are the app's, not a dependency of the SDK. */
+type Hook = (payload: any) => any;
+export interface YogaPlugin {
+    instrumentation: {
+        operation: (payload: unknown, wrapped: () => unknown) => unknown;
+    };
+    onSchemaChange: Hook;
+    onParams: Hook;
+    onParse: Hook;
+    onValidate: Hook;
+    onExecute: Hook;
+    onExecutionResult: Hook;
+}
+/**
+ * GraphQL Yoga's plugin: `createYoga({ schema, plugins: [tracepanelYogaPlugin()] })`. Each operation is a span named after
+ * it, and so is the request's trace; its parse and validate phases and the app's resolvers are spans under it.
+ */
+export declare function tracepanelYogaPlugin(): YogaPlugin;
+export interface ApolloPlugin {
+    serverWillStart: (service: {
+        schema: unknown;
+    }) => Promise<{
+        schemaDidLoadOrUpdate: (schemaContext: {
+            apiSchema: unknown;
+        }) => void;
+    }>;
+    requestDidStart: (requestContext: any) => Promise<object | undefined>;
+}
+/**
+ * Apollo Server's plugin: `new ApolloServer({ typeDefs, resolvers, plugins: [tracepanelApolloPlugin()] })`. Each
+ * operation is a span named after it, and so is the request's trace; its parse and validate phases and the app's
+ * resolvers are spans under it.
+ */
+export declare function tracepanelApolloPlugin(): ApolloPlugin;
+export {};

package/dist/graphql.js

@@ -0,0 +1,337 @@
+// GraphQL servers: GraphQL Yoga (`plugins: [tracepanelYogaPlugin()]`) and Apollo Server (`plugins: [tracepanelApolloPlugin()]`).
+// Their traces look like the Python SDK's of Strawberry and Graphene, so the console shows every server's the same
+// way: the request is named after its operation (`GraphQL query Books`, `GraphQL query { books, authors }` when
+// unnamed), so traffic groups by operation instead of `POST /graphql`; the operation is a span holding `parse` and
+// `validate`; each of the app's own resolvers is a `function` span (`Book.author`, its path `books.3.author`), and
+// what it does (a fetch(), a query) is under it. Fields without a resolver of the app's, which only read a property,
+// are left out: a list of 500 objects would otherwise add thousands of spans. An exception a resolver throws comes
+// back to the client in `errors` with a 200: it is the trace's error all the same. A document that didn't parse is no
+// operation (`syntax error`); one that failed validation keeps its operation's name. The variables are in the
+// request's body, as the app read it, their secrets masked like the rest of a body.
+import { context, createContextKey, SpanStatusCode, trace } from "@opentelemetry/api";
+import { runtime } from "./runtime.js";
+/** What tells the processor a span is GraphQL's: an operation (it has graphql.library), `parse` or `validate`. */
+export const GRAPHQL = "graphql";
+/** What tells the processor a span is a resolver of the app's. */
+export const RESOLVER = "graphql.resolver";
+const MAX_DOCUMENT = 2000;
+const MAX_ROOT_FIELDS = 3;
+/** What a document that didn't parse is named: it has no operation, so it groups apart from the anonymous queries. */
+const SYNTAX_ERROR = "syntax error";
+const tracer = trace.getTracer("tracepanel-graphql");
+/** The operation running in this context: Yoga runs its phases and resolvers in it. */
+const OPERATION = createContextKey("tracepanel.graphql.operation");
+/** Apollo's operations by their context value: it runs the resolvers outside the operation's context. */
+const byContextValue = new WeakMap();
+/** Errors a resolver's span recorded already: the operation leaves them be. */
+const recorded = new WeakSet();
+const WRAPPED = Symbol.for("tracepanel.graphql.resolver");
+function begin(library) {
+    const span = tracer.startSpan("graphql operation", { attributes: { "tracepanel.span_kind": GRAPHQL } });
+    return {
+        span,
+        context: trace.setSpan(context.active(), span),
+        library,
+        query: undefined,
+        operationName: undefined,
+        document: undefined,
+        errors: [],
+    };
+}
+/** `parse` or `validate`, a span under the operation. */
+function phase(operation, name) {
+    return tracer.startSpan(name, { attributes: { "tracepanel.span_kind": GRAPHQL } }, operation.context);
+}
+function documentText(query) {
+    if (!query)
+        return null;
+    const text = query.replace(/\s+/g, " ").trim();
+    return text.length <= MAX_DOCUMENT ? text : `${text.slice(0, MAX_DOCUMENT)}…`;
+}
+/** `{ books, authors }`: what an unnamed operation asks for, so `{ books { id } }` isn't only "anonymous". */
+function rootFields(document) {
+    const operation = document.definitions.find((node) => node.kind === "OperationDefinition" && !node.name);
+    const fields = (operation?.selectionSet?.selections ?? [])
+        .filter((node) => node.kind === "Field")
+        .map((node) => node.name?.value ?? "");
+    if (fields.length === 0)
+        return null;
+    const more = fields.length - MAX_ROOT_FIELDS;
+    return `{ ${fields.slice(0, MAX_ROOT_FIELDS).join(", ")}${more > 0 ? `, +${more}` : ""} }`;
+}
+/** The operation the document runs: the one named, else its only one. */
+function operationOf(document, name) {
+    const operations = document.definitions.filter((node) => node.kind === "OperationDefinition");
+    if (name)
+        return operations.find((node) => node.name?.value === name);
+    return operations.length === 1 ? operations[0] : undefined;
+}
+/**
+ * A GraphQL error made on purpose: one the server made of the client's mistake (a syntax or validation error), or
+ * one a resolver threw as its answer (`throw new GraphQLError("not found")`). Not the app's failure.
+ */
+function answer(error) {
+    for (let proto = Object.getPrototypeOf(error ?? {}); proto; proto = Object.getPrototypeOf(proto)) {
+        if (proto.constructor?.name === "GraphQLError")
+            return true;
+    }
+    return false;
+}
+/** What a resolver threw, under the GraphQLError (or two: a masked one) the server wrapped it in; else undefined. */
+function thrown(error) {
+    let at = error;
+    for (let depth = 0; depth < 4 && at instanceof Error; depth++) {
+        if (!answer(at))
+            return recorded.has(at) ? undefined : at;
+        at = at.originalError;
+    }
+    return undefined;
+}
+/** Names the operation's span and the request after it; the exceptions resolvers threw are the trace's errors. */
+function finish(operation) {
+    const { span, document } = operation;
+    let kind = null;
+    let name = null;
+    let label = SYNTAX_ERROR;
+    if (document) {
+        // Not an operation of any type until it parses: the operationName the client sent names none either.
+        const node = operationOf(document, operation.operationName);
+        kind = node?.operation ?? "query";
+        name = operation.operationName ?? node?.name?.value ?? null;
+        label = `${kind} ${name ?? rootFields(document) ?? "anonymous"}`;
+    }
+    const attrs = {
+        "graphql.operation.type": kind,
+        "graphql.operation.name": name,
+        "graphql.document": documentText(operation.query),
+        "graphql.errors": operation.errors.length,
+        "graphql.library": operation.library,
+    };
+    span.updateName(label);
+    for (const [key, value] of Object.entries(attrs))
+        if (value !== null)
+            span.setAttribute(key, value);
+    for (const error of operation.errors) {
+        // A syntax or validation error wraps nothing: the client's mistake, not the app's.
+        const original = thrown(error);
+        if (!original)
+            continue;
+        recorded.add(original);
+        span.recordException(original);
+    }
+    // The request is this operation: named and grouped after it.
+    runtime()?.processor.setTraceAttrs({ ...attrs, "graphql.operation": label });
+    span.end();
+}
+function pathOf(info) {
+    const keys = [];
+    for (let at = info.path; at; at = at.prev)
+        keys.push(String(at.key));
+    return keys.reverse().join(".");
+}
+function failed(span, error) {
+    if (error instanceof Error && !answer(error)) {
+        recorded.add(error);
+        span.recordException(error);
+    }
+    span.setStatus({ code: SpanStatusCode.ERROR });
+}
+/** A resolver of the app's, run in a span of its own: what it calls (fetch(), a query) goes under it. */
+function traced(field, resolve) {
+    const wrapped = function (source, args, contextValue, info) {
+        const operation = (contextValue !== null && typeof contextValue === "object" ? byContextValue.get(contextValue) : undefined) ??
+            context.active().getValue(OPERATION);
+        if (!operation)
+            return resolve.call(this, source, args, contextValue, info);
+        const name = `${info.parentType.name}.${info.fieldName}`;
+        const attributes = {
+            "tracepanel.span_kind": RESOLVER,
+            "graphql.field": name,
+            "graphql.path": pathOf(info),
+            "code.function": name,
+        };
+        const span = tracer.startSpan(name, { attributes }, operation.context);
+        let result;
+        try {
+            result = context.with(trace.setSpan(operation.context, span), () => resolve.call(this, source, args, contextValue, info));
+        }
+        catch (error) {
+            failed(span, error);
+            span.end();
+            throw error;
+        }
+        if (result !== null && typeof result?.then === "function") {
+            return Promise.resolve(result).then((value) => {
+                span.end();
+                return value;
+            }, (error) => {
+                failed(span, error);
+                span.end();
+                throw error;
+            });
+        }
+        span.end();
+        return result;
+    };
+    wrapped[WRAPPED] = true;
+    Object.defineProperty(wrapped, "name", { value: field });
+    return wrapped;
+}
+const instrumented = new WeakSet();
+/** The app's resolvers in the schema, each in a span; once per schema. */
+function instrument(schema) {
+    if (schema === null || typeof schema !== "object" || instrumented.has(schema))
+        return;
+    instrumented.add(schema);
+    for (const type of Object.values(schema.getTypeMap())) {
+        if (type.name.startsWith("__") || typeof type.getFields !== "function")
+            continue;
+        for (const [name, field] of Object.entries(type.getFields())) {
+            // A field without a resolver of the app's reads a property: left out.
+            if (typeof field.resolve !== "function" || field.resolve[WRAPPED])
+                continue;
+            field.resolve = traced(`${type.name}.${name}`, field.resolve);
+        }
+    }
+}
+/** Runs `wrapped` in the operation's context, and finishes the operation when it is done, however it ends. */
+function within(operation, wrapped) {
+    const ctx = operation.context.setValue(OPERATION, operation);
+    operation.context = ctx;
+    let result;
+    try {
+        result = context.with(ctx, wrapped);
+    }
+    catch (error) {
+        finish(operation);
+        throw error;
+    }
+    if (result !== null && typeof result?.then === "function") {
+        return Promise.resolve(result).then((value) => {
+            finish(operation);
+            return value;
+        }, (error) => {
+            // The server threw what didn't parse or validate: its answer has them as errors.
+            if (operation.errors.length === 0)
+                operation.errors = [error].flat();
+            finish(operation);
+            throw error;
+        });
+    }
+    finish(operation);
+    return result;
+}
+function current() {
+    return context.active().getValue(OPERATION);
+}
+/**
+ * GraphQL Yoga's plugin: `createYoga({ schema, plugins: [tracepanelYogaPlugin()] })`. Each operation is a span named after
+ * it, and so is the request's trace; its parse and validate phases and the app's resolvers are spans under it.
+ */
+export function tracepanelYogaPlugin() {
+    return {
+        instrumentation: {
+            operation: (_payload, wrapped) => {
+                // Outside a request's trace (production, or Tracepanel off): Yoga as it is.
+                if (!runtime() || !trace.getActiveSpan())
+                    return wrapped();
+                return within(begin("graphql-yoga"), wrapped);
+            },
+        },
+        onSchemaChange: ({ schema }) => instrument(schema),
+        onParams: ({ params }) => {
+            const operation = current();
+            if (!operation)
+                return;
+            operation.query = params.query;
+            operation.operationName = params.operationName ?? undefined;
+        },
+        onParse: () => {
+            const operation = current();
+            if (!operation)
+                return undefined;
+            const span = phase(operation, "parse");
+            return ({ result }) => {
+                if (result instanceof Error)
+                    operation.errors = [result];
+                else
+                    operation.document = result;
+                span.end();
+            };
+        },
+        onValidate: () => {
+            const operation = current();
+            if (!operation)
+                return undefined;
+            const span = phase(operation, "validate");
+            return ({ valid, result }) => {
+                if (!valid)
+                    operation.errors = result;
+                span.end();
+            };
+        },
+        onExecute: ({ args }) => {
+            // A schema set before this plugin was: its resolvers are instrumented as it first runs.
+            instrument(args.schema);
+            const operation = current();
+            if (!operation)
+                return;
+            operation.document = args.document;
+            operation.operationName = args.operationName ?? operation.operationName;
+        },
+        onExecutionResult: ({ result }) => {
+            const operation = current();
+            // A stream's result (@defer, a subscription) is its pieces: their errors come with them, not counted here.
+            if (!operation || result === null || typeof result !== "object" || Array.isArray(result))
+                return;
+            const errors = result.errors;
+            if (errors)
+                operation.errors = errors;
+        },
+    };
+}
+/**
+ * Apollo Server's plugin: `new ApolloServer({ typeDefs, resolvers, plugins: [tracepanelApolloPlugin()] })`. Each
+ * operation is a span named after it, and so is the request's trace; its parse and validate phases and the app's
+ * resolvers are spans under it.
+ */
+export function tracepanelApolloPlugin() {
+    return {
+        serverWillStart: async ({ schema }) => {
+            instrument(schema);
+            return { schemaDidLoadOrUpdate: ({ apiSchema }) => instrument(apiSchema) };
+        },
+        requestDidStart: async (requestContext) => {
+            if (!runtime() || !trace.getActiveSpan())
+                return undefined;
+            instrument(requestContext.schema);
+            const operation = begin("apollo-server");
+            operation.context = operation.context.setValue(OPERATION, operation);
+            operation.query = requestContext.request.query;
+            operation.operationName = requestContext.request.operationName ?? undefined;
+            const { contextValue } = requestContext;
+            if (contextValue !== null && typeof contextValue === "object")
+                byContextValue.set(contextValue, operation);
+            return {
+                parsingDidStart: async () => {
+                    const span = phase(operation, "parse");
+                    return async () => span.end();
+                },
+                validationDidStart: async () => {
+                    const span = phase(operation, "validate");
+                    return async () => span.end();
+                },
+                didResolveOperation: async (resolved) => {
+                    operation.operationName = resolved.operationName ?? operation.operationName;
+                },
+                willSendResponse: async (done) => {
+                    operation.document = done.document;
+                    const body = done.response?.body;
+                    operation.errors = done.errors ?? (body?.kind === "single" ? body.singleResult?.errors : undefined) ?? [];
+                    finish(operation);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=graphql.js.map

package/dist/graphql.js.map

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

package/dist/hono.d.ts

@@ -0,0 +1,2 @@
+import type { MiddlewareHandler } from "hono";
+export declare function tracepanel(): MiddlewareHandler;

package/dist/hono.js

@@ -0,0 +1,63 @@
+// `app.use(tracepanel())`, first: Hono middleware, for Hono on Node (@hono/node-server) and on Bun. The route's handler
+// is a span of its own, named by its route (`/books/:id`), and so is the request's trace. On Node every response gets
+// what the badge reads (Tracepanel-Id, Server-Timing) and an HTML page the widget's script, put into its body as it
+// streams; what the request carried goes into its trace: its headers, query, cookies, its body as far as the handler
+// read it, and the response's headers. On Bun, `withTracepanel(app.fetch)` does that, and this middleware names the
+// route and its handler under it. An error is the request's unless the app answers it below 500 (an HTTPException, or
+// what app.onError answers).
+//
+// Hono matches a request before its middleware run: the handler is the last of the routes it matched that is not
+// middleware, and its span holds what runs after this middleware (the others the route has, then the handler).
+import { matchedRoutes } from "hono/route";
+import { tapRequest } from "./body.js";
+import { MARKED, marked } from "./respond.js";
+import { runtime } from "./runtime.js";
+import { inView, recordError, wasRecorded } from "./view.js";
+const FRAMEWORK = "Hono";
+/** The route that answers the request: the last one matched that isn't middleware (`app.use()`'s, `next` taken). */
+function handlerRoute(c) {
+    const routes = matchedRoutes(c);
+    for (let at = routes.length - 1; at > c.req.routeIndex; at--) {
+        const route = routes[at];
+        if (route && (route.method !== "ALL" || route.handler.length < 2))
+            return route.path;
+    }
+    return undefined;
+}
+export function tracepanel() {
+    const tp = runtime();
+    return async function tracepanelMiddleware(c, next) {
+        if (!tp) {
+            await next();
+            return;
+        }
+        tp.processor.setFramework(FRAMEWORK);
+        const startedMs = performance.now();
+        const request = c.req.raw;
+        const marking = !request[MARKED];
+        const body = marking && tp.config.captureRequest ? tapRequest(request) : undefined;
+        const route = handlerRoute(c);
+        if (route) {
+            tp.processor.setRoute(route);
+            // Hono catches what the handler throws, for app.onError: the error is the context's then.
+            await inView(route, null, async (span) => {
+                await next();
+                if (c.error)
+                    recordError(span, c.error, c.res.status);
+            });
+        }
+        else {
+            await next();
+        }
+        // Thrown in middleware, before the handler or without one.
+        if (c.error && c.res.status >= 500 && !wasRecorded(c.error))
+            tp.processor.addError(c.error);
+        if (!marking)
+            return;
+        const answer = await marked(tp, request, c.res, startedMs, FRAMEWORK, body);
+        // Set over the response, the new one would get the old one's headers back (its Content-Length among them).
+        c.res = undefined;
+        c.res = answer.response;
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/hono.js.map

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

package/dist/koa.d.ts

@@ -0,0 +1,2 @@
+import type { Middleware } from "koa";
+export declare function tracepanel(): Middleware;