traceperf 0.2.0 → 1.3.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,0CAEC;AAdD,iDAAiD;AACjD,wFAAkG;AAkBzF,4GAlBA,2DAA2B,OAkBA;AACV,6FAnBY,6CAAa,OAmBb;AAjBtC,sDAAwC;AAExC,4BAA4B;AAC5B,MAAM,SAAS,GAAG,IAAI,2DAA2B,EAAE,CAAC;AAEpD,sDAAsD;AACtD,kBAAe,SAAS,CAAC;AAEzB,uDAAuD;AACvD,SAAgB,eAAe,CAAC,SAAoC,EAAE;IACpE,OAAO,IAAI,2DAA2B,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,8CAA8C;AAC9C,0CAAwB;AACxB,yCAAuB;AAIvB,6BAA6B;AAC7B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;IACpD,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QACxC,OAAO,EAAE,SAAS;QAClB,eAAe;QACf,2BAA2B,EAA3B,2DAA2B;QAC3B,YAAY,EAAE,6CAAa;QAC3B,kBAAkB;QAClB,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAeA,0CAEC;AAKD,wBAIC;AA1BD,iDAAiD;AACjD,wFAAkG;AAkCzF,4GAlCA,2DAA2B,OAkCA;AACV,6FAnCY,6CAAa,OAmCb;AAhCtC,2EAA2E;AAC3E,mEAAmE;AACnE,8DAA8D;AAC9D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AACvD,MAAM,MAAM,GAAG,UAAiB,CAAC;AACjC,MAAM,SAAS,GAAgC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,2DAA2B,EAAE,CAAC,CAAC;AAEhI,sDAAsD;AACtD,kBAAe,SAAS,CAAC;AAEzB,uDAAuD;AACvD,SAAgB,eAAe,CAAC,SAA2B,EAAE;IAC3D,OAAO,IAAI,2DAA2B,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,UAAwB,EAAE;IAC/C,yEAAyE;IACzE,+DAA+D;IAC/D,OAAO,2DAA2B,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,8CAA8C;AAC9C,0CAAwB;AACxB,yCAAuB;AACvB,iDAA+B;AAC/B,+CAA6B;AAC7B,4CAA0B;AAC1B,yCAAuB;AAIvB,eAAe;AACf,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;IACpD,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE;QACxD,OAAO,EAAE,SAAS;QAClB,eAAe;QACf,MAAM;QACN,2BAA2B,EAA3B,2DAA2B;QAC3B,YAAY,EAAE,6CAAa;KAC5B,CAAC,CAAC;AACL,CAAC;AACD,gBAAgB"}

package/dist/instrument.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Auto-instrumentation: track common I/O without wrapping each call by hand.
+ *
+ * Every instrument* function patches in place, is idempotent, and returns a
+ * function that removes the patch. Calls made inside a tracked call nest
+ * under it like any other tracked call.
+ */
+import type { OptimizedPerformanceMonitor } from './core/optimized-performance-monitor';
+import type { TrackOptions } from './types/options';
+export interface InstrumentOptions extends Omit<TrackOptions, 'label'> {
+    /** Treat HTTP responses with status >= this as failed (default 500) */
+    errorStatus?: number;
+}
+/** Removes an instrumentation patch */
+export type Uninstall = () => void;
+/**
+ * Track every `fetch()` call: label "fetch GET api.example.com/users".
+ * Timing covers the request until the response headers arrive (reading the
+ * body is not included). Responses with status >= 500 are marked failed.
+ */
+export declare function instrumentFetch(tp: OptimizedPerformanceMonitor, options?: InstrumentOptions): Uninstall;
+/**
+ * Track outgoing Node.js http/https requests (`request` and `get`), which
+ * covers clients built on them such as axios and got. Label:
+ * "http GET api.example.com/users". Timing covers the full response
+ * (until the body has been read). Node.js only.
+ */
+export declare function instrumentHttp(tp: OptimizedPerformanceMonitor, options?: InstrumentOptions): Uninstall;
+export interface InstrumentMethodsOptions extends TrackOptions {
+    /** Label prefix, e.g. "pg." (default: the constructor name of `target` plus ".") */
+    prefix?: string;
+    /** Compute the label per call, e.g. from the SQL text */
+    labelFor?: (method: string, args: unknown[]) => string;
+}
+/**
+ * Patch methods of an object or prototype in place, e.g. a database client:
+ *
+ *   instrumentMethods(tp, pg.Client.prototype, ['query'], {
+ *     labelFor: (_m, [q]) => `pg ${String(q?.text ?? q).trim().split(/\s+/)[0]}`,
+ *   });
+ *
+ * `methods` defaults to every own function property except the constructor.
+ */
+export declare function instrumentMethods(tp: OptimizedPerformanceMonitor, target: object, methods?: string[], options?: InstrumentMethodsOptions): Uninstall;
+/**
+ * Prisma client extension: every model operation becomes a tracked call
+ * labelled "prisma.User.findMany".
+ *
+ *   const prisma = new PrismaClient().$extends(prismaExtension(tp));
+ */
+export declare function prismaExtension(tp: OptimizedPerformanceMonitor, options?: TrackOptions): {
+    name: string;
+    query: {
+        $allModels: {
+            $allOperations(params: {
+                model?: string;
+                operation: string;
+                args: unknown;
+                query: (args: unknown) => Promise<unknown>;
+            }): Promise<unknown>;
+        };
+    };
+};
+/**
+ * Collapse ids in a URL path so labels stay few: /users/42/orders/9f1c... ->
+ * /users/:id/orders/:id. Numbers, UUIDs, long hex and long mixed tokens count as ids.
+ */
+export declare function normalizePath(url: string): string;
+export interface HttpServerInstrumentOptions extends InstrumentOptions {
+    /** Label for a request (default "GET /users/:id", ids collapsed by normalizePath) */
+    labelFor?: (req: {
+        method?: string;
+        url?: string;
+        headers?: Record<string, unknown>;
+    }) => string;
+    /** Skip requests for which this returns true, e.g. health checks */
+    ignore?: (req: {
+        method?: string;
+        url?: string;
+    }) => boolean;
+}
+/**
+ * Track every incoming request of every Node http/https server as a
+ * top-level call, so work done while handling it (queries, fetches, tracked
+ * functions) nests under it, with no framework middleware. Responses with
+ * status >= 500 and connections closed before a response count as failed.
+ */
+export declare function instrumentHttpServer(tp: OptimizedPerformanceMonitor, options?: HttpServerInstrumentOptions): Uninstall;

package/dist/instrument.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentFetch = instrumentFetch;
+exports.instrumentHttp = instrumentHttp;
+exports.instrumentMethods = instrumentMethods;
+exports.prismaExtension = prismaExtension;
+exports.normalizePath = normalizePath;
+exports.instrumentHttpServer = instrumentHttpServer;
+const env_1 = require("./core/env");
+const PATCHED = Symbol.for('traceperf.instrumented');
+function describeUrl(input) {
+    try {
+        if (typeof input === 'string' || input instanceof URL) {
+            const url = new URL(String(input), 'http://localhost');
+            return { host: url.host, path: url.pathname };
+        }
+        if (input && typeof input.url === 'string') {
+            const url = new URL(input.url, 'http://localhost');
+            return { method: input.method, host: url.host, path: url.pathname };
+        }
+    }
+    catch (_a) {
+        // fall through
+    }
+    return { host: 'unknown', path: '' };
+}
+/**
+ * Track every `fetch()` call: label "fetch GET api.example.com/users".
+ * Timing covers the request until the response headers arrive (reading the
+ * body is not included). Responses with status >= 500 are marked failed.
+ */
+function instrumentFetch(tp, options = {}) {
+    const g = typeof globalThis !== 'undefined' ? globalThis : undefined;
+    if (!g || typeof g.fetch !== 'function')
+        return () => undefined;
+    if (g.fetch[PATCHED])
+        return () => undefined;
+    const { errorStatus = 500, ...trackOptions } = options;
+    const original = g.fetch;
+    const patched = function fetch(input, init) {
+        const { method: inputMethod, host, path } = describeUrl(input);
+        const method = (init && init.method) || inputMethod || 'GET';
+        const span = tp.start(`fetch ${method.toUpperCase()} ${host}${path}`, trackOptions);
+        let promise;
+        try {
+            promise = span.run(() => original.call(this, input, init));
+        }
+        catch (error) {
+            span.end(error);
+            throw error;
+        }
+        return Promise.resolve(promise).then(response => {
+            span.end(response && response.status >= errorStatus ? new Error(`HTTP ${response.status}`) : undefined);
+            return response;
+        }, error => {
+            span.end(error);
+            throw error;
+        });
+    };
+    patched[PATCHED] = original;
+    g.fetch = patched;
+    return () => {
+        if (g.fetch === patched)
+            g.fetch = original;
+    };
+}
+/**
+ * Track outgoing Node.js http/https requests (`request` and `get`), which
+ * covers clients built on them such as axios and got. Label:
+ * "http GET api.example.com/users". Timing covers the full response
+ * (until the body has been read). Node.js only.
+ */
+function instrumentHttp(tp, options = {}) {
+    const { errorStatus = 500, ...trackOptions } = options;
+    const restores = [];
+    for (const moduleName of ['http', 'https']) {
+        const mod = (0, env_1.loadNodeBuiltin)(moduleName);
+        if (!mod)
+            continue;
+        for (const fnName of ['request', 'get']) {
+            const original = mod[fnName];
+            if (typeof original !== 'function' || original[PATCHED])
+                continue;
+            const patched = function (...args) {
+                const span = tp.start(`${moduleName} request`, trackOptions);
+                let req;
+                try {
+                    req = span.run(() => original.apply(this, args));
+                }
+                catch (error) {
+                    span.end(error);
+                    throw error;
+                }
+                // The Host header includes a non-default port; req.host does not
+                const host = (typeof req.getHeader === 'function' && req.getHeader('host')) || req.host || 'unknown';
+                span.setLabel(`${moduleName} ${req.method || 'GET'} ${host}${String(req.path || '').split('?')[0]}`);
+                let ended = false;
+                let statusError;
+                // Whichever of res 'end' / res 'close' / req 'close' comes first ends
+                // the span (their order differs between Node versions)
+                const end = (error = statusError) => {
+                    if (ended)
+                        return;
+                    ended = true;
+                    span.end(error);
+                };
+                req.once('response', (res) => {
+                    statusError = res.statusCode >= errorStatus ? new Error(`HTTP ${res.statusCode}`) : undefined;
+                    res.once('end', () => end());
+                    res.once('close', () => end());
+                });
+                req.once('error', (error) => end(error));
+                req.once('close', () => end());
+                return req;
+            };
+            patched[PATCHED] = original;
+            mod[fnName] = patched;
+            restores.push(() => {
+                if (mod[fnName] === patched)
+                    mod[fnName] = original;
+            });
+        }
+    }
+    return () => restores.forEach(restore => restore());
+}
+/**
+ * Patch methods of an object or prototype in place, e.g. a database client:
+ *
+ *   instrumentMethods(tp, pg.Client.prototype, ['query'], {
+ *     labelFor: (_m, [q]) => `pg ${String(q?.text ?? q).trim().split(/\s+/)[0]}`,
+ *   });
+ *
+ * `methods` defaults to every own function property except the constructor.
+ */
+function instrumentMethods(tp, target, methods, options = {}) {
+    const { prefix, labelFor, ...trackOptions } = options;
+    const ctor = target.constructor;
+    const ownerName = typeof target === 'function' ? target.name
+        : ctor && ctor.prototype === target ? ctor.name
+            : ctor && ctor !== Object ? ctor.name : '';
+    const labelPrefix = prefix !== null && prefix !== void 0 ? prefix : (ownerName ? `${ownerName}.` : '');
+    const names = methods !== null && methods !== void 0 ? methods : Object.getOwnPropertyNames(target).filter(name => {
+        if (name === 'constructor')
+            return false;
+        const descriptor = Object.getOwnPropertyDescriptor(target, name);
+        return !!descriptor && typeof descriptor.value === 'function';
+    });
+    const restores = [];
+    for (const name of names) {
+        const original = target[name];
+        if (typeof original !== 'function' || original[PATCHED])
+            continue;
+        const patched = function (...args) {
+            const label = labelFor ? labelFor(name, args) : `${labelPrefix}${name}`;
+            return tp.track(() => original.apply(this, args), { ...trackOptions, label });
+        };
+        Object.defineProperty(patched, 'name', { value: original.name, configurable: true });
+        Object.defineProperty(patched, 'length', { value: original.length, configurable: true });
+        patched[PATCHED] = original;
+        const hadOwn = Object.prototype.hasOwnProperty.call(target, name);
+        target[name] = patched;
+        restores.push(() => {
+            if (target[name] !== patched)
+                return;
+            if (hadOwn)
+                target[name] = original;
+            else
+                delete target[name];
+        });
+    }
+    return () => restores.forEach(restore => restore());
+}
+/**
+ * Prisma client extension: every model operation becomes a tracked call
+ * labelled "prisma.User.findMany".
+ *
+ *   const prisma = new PrismaClient().$extends(prismaExtension(tp));
+ */
+function prismaExtension(tp, options = {}) {
+    return {
+        name: 'traceperf',
+        query: {
+            $allModels: {
+                $allOperations(params) {
+                    var _a, _b;
+                    const label = (_a = options.label) !== null && _a !== void 0 ? _a : `prisma.${(_b = params.model) !== null && _b !== void 0 ? _b : 'raw'}.${params.operation}`;
+                    return tp.track(() => params.query(params.args), { ...options, label });
+                },
+            },
+        },
+    };
+}
+/**
+ * Collapse ids in a URL path so labels stay few: /users/42/orders/9f1c... ->
+ * /users/:id/orders/:id. Numbers, UUIDs, long hex and long mixed tokens count as ids.
+ */
+function normalizePath(url) {
+    let path = String(url || '/');
+    const q = path.search(/[?#]/);
+    if (q !== -1)
+        path = path.slice(0, q);
+    if (!path)
+        return '/';
+    // Fast path: ids always contain a digit
+    if (!/\d/.test(path))
+        return path;
+    const segments = path.split('/');
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (seg && /\d/.test(seg) && isIdSegment(seg))
+            segments[i] = ':id';
+    }
+    return segments.join('/');
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isIdSegment(seg) {
+    if (/^\d+$/.test(seg))
+        return true;
+    if (seg.length === 36 && UUID.test(seg))
+        return true;
+    if (seg.length >= 16 && /^[0-9a-f]+$/i.test(seg))
+        return true;
+    return seg.length >= 20 && /^[A-Za-z0-9_-]+$/.test(seg);
+}
+/**
+ * Track every incoming request of every Node http/https server as a
+ * top-level call, so work done while handling it (queries, fetches, tracked
+ * functions) nests under it, with no framework middleware. Responses with
+ * status >= 500 and connections closed before a response count as failed.
+ */
+function instrumentHttpServer(tp, options = {}) {
+    const { errorStatus = 500, labelFor, ignore, ...trackOptions } = options;
+    const restores = [];
+    for (const moduleName of ['http', 'https']) {
+        const mod = (0, env_1.loadNodeBuiltin)(moduleName);
+        const proto = mod && mod.Server && mod.Server.prototype;
+        if (!proto)
+            continue;
+        const original = proto.emit;
+        if (typeof original !== 'function' || original[PATCHED])
+            continue;
+        const hadOwn = Object.prototype.hasOwnProperty.call(proto, 'emit');
+        const patched = function (event, req, res, ...rest) {
+            if (event !== 'request' || !req || !res || typeof res.once !== 'function' || (ignore && ignore(req))) {
+                return original.call(this, event, req, res, ...rest);
+            }
+            const label = labelFor ? labelFor(req) : `${req.method || 'GET'} ${normalizePath(req.url)}`;
+            const span = tp.start(label, trackOptions);
+            // Disabled or sampled out: nothing to finish
+            if (!span.id)
+                return original.call(this, event, req, res, ...rest);
+            let ended = false;
+            const end = (error) => {
+                if (ended)
+                    return;
+                ended = true;
+                span.end(error);
+            };
+            res.once('finish', () => end(res.statusCode >= errorStatus ? new Error(`HTTP ${res.statusCode}`) : undefined));
+            res.once('close', () => end(res.writableFinished ? undefined : new Error('connection closed before the response was sent')));
+            try {
+                return span.run(() => original.call(this, event, req, res, ...rest));
+            }
+            catch (error) {
+                end(error);
+                throw error;
+            }
+        };
+        patched[PATCHED] = original;
+        proto.emit = patched;
+        restores.push(() => {
+            if (proto.emit !== patched)
+                return;
+            if (hadOwn)
+                proto.emit = original;
+            else
+                delete proto.emit;
+        });
+    }
+    return () => restores.forEach(restore => restore());
+}
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map

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

package/dist/integrations.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Framework integrations: one top-level execution per HTTP request, with
+ * tracked calls made while handling the request nested under it.
+ *
+ * Every helper takes the traceperf instance to record into, so they work
+ * with the default instance and with createTracePerf() instances alike.
+ */
+import type { OptimizedPerformanceMonitor } from './core/optimized-performance-monitor';
+import type { TrackOptions } from './types/options';
+/** What a label function gets to work with */
+export interface RequestInfo {
+    method: string;
+    /** Route pattern when the framework knows it, e.g. "/users/:id" */
+    route?: string;
+    /** Path without the query string */
+    path: string;
+}
+export interface HttpTracingOptions extends Omit<TrackOptions, 'label'> {
+    /** Build the label; default "METHOD /route/pattern" (falls back to the path) */
+    label?: (request: RequestInfo) => string;
+    /** Treat responses with status >= this as failed (default 500) */
+    errorStatus?: number;
+}
+/**
+ * Express / Connect middleware. Register it before your routes:
+ *
+ *   app.use(expressMiddleware(tp));
+ */
+export declare function expressMiddleware(tp: OptimizedPerformanceMonitor, options?: HttpTracingOptions): (req: any, res: any, next: (err?: unknown) => void) => void;
+/**
+ * Fastify plugin (applies to every route, no fastify-plugin needed):
+ *
+ *   await app.register(fastifyPlugin(tp));
+ */
+export declare function fastifyPlugin(tp: OptimizedPerformanceMonitor, options?: HttpTracingOptions): (fastify: any, _opts: unknown, done: () => void) => void;
+/**
+ * Hono middleware:
+ *
+ *   app.use('*', honoMiddleware(tp));
+ */
+export declare function honoMiddleware(tp: OptimizedPerformanceMonitor, options?: HttpTracingOptions): (c: any, next: () => Promise<void>) => Promise<void>;
+/**
+ * Wrap any request handler, e.g. a Next.js route handler:
+ *
+ *   export const GET = withTracing(tp, async (request) => { ... });
+ *
+ * When the first argument looks like a Request, the label defaults to
+ * "METHOD /path"; otherwise the function name.
+ */
+export declare function withTracing<T extends (...args: any[]) => any>(tp: OptimizedPerformanceMonitor, handler: T, options?: Omit<HttpTracingOptions, 'errorStatus'>): (...args: Parameters<T>) => ReturnType<T>;
+/**
+ * Koa middleware. Register it first:
+ *
+ *   app.use(koaMiddleware(tp));
+ *
+ * Labels use the matched route when @koa/router sets ctx._matchedRoute.
+ */
+export declare function koaMiddleware(tp: OptimizedPerformanceMonitor, options?: HttpTracingOptions): (ctx: any, next: () => Promise<unknown>) => Promise<void>;
+/**
+ * NestJS interceptor (works without importing Nest or rxjs into traceperf):
+ *
+ *   app.useGlobalInterceptors(nestInterceptor(tp));
+ *
+ * Label: "GET /users/:id" for HTTP, otherwise "Controller.handler".
+ */
+export declare function nestInterceptor(tp: OptimizedPerformanceMonitor, options?: HttpTracingOptions): {
+    intercept(context: any, next: {
+        handle(): any;
+    }): any;
+};

package/dist/integrations.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expressMiddleware = expressMiddleware;
+exports.fastifyPlugin = fastifyPlugin;
+exports.honoMiddleware = honoMiddleware;
+exports.withTracing = withTracing;
+exports.koaMiddleware = koaMiddleware;
+exports.nestInterceptor = nestInterceptor;
+const stripQuery = (url) => {
+    if (!url)
+        return '/';
+    const q = url.indexOf('?');
+    return q === -1 ? url : url.slice(0, q);
+};
+const defaultLabel = (r) => `${r.method} ${r.route || r.path}`;
+const statusError = (status, errorStatus) => status !== undefined && status >= errorStatus ? new Error(`HTTP ${status}`) : undefined;
+function splitOptions(options) {
+    const { label = defaultLabel, errorStatus = 500, ...trackOptions } = options;
+    return { label, errorStatus, trackOptions };
+}
+/**
+ * Express / Connect middleware. Register it before your routes:
+ *
+ *   app.use(expressMiddleware(tp));
+ */
+function expressMiddleware(tp, options = {}) {
+    const { label, errorStatus, trackOptions } = splitOptions(options);
+    return function traceperfExpress(req, res, next) {
+        const path = stripQuery(req.originalUrl || req.url);
+        const span = tp.start(label({ method: req.method, path }), trackOptions);
+        let finished = false;
+        const finish = () => {
+            if (finished)
+                return;
+            finished = true;
+            const route = req.route && req.route.path ? `${req.baseUrl || ''}${req.route.path}` : undefined;
+            span.setLabel(label({ method: req.method, route, path }));
+            span.end(statusError(res.statusCode, errorStatus));
+        };
+        res.once('finish', finish);
+        res.once('close', finish);
+        span.run(() => next());
+    };
+}
+/**
+ * Fastify plugin (applies to every route, no fastify-plugin needed):
+ *
+ *   await app.register(fastifyPlugin(tp));
+ */
+function fastifyPlugin(tp, options = {}) {
+    const { label, errorStatus, trackOptions } = splitOptions(options);
+    const spanKey = Symbol('traceperf.span');
+    const plugin = function traceperfFastify(fastify, _opts, done) {
+        fastify.addHook('onRequest', (request, _reply, hookDone) => {
+            const span = tp.start(label({ method: request.method, path: stripQuery(request.url) }), trackOptions);
+            request[spanKey] = span;
+            span.run(() => hookDone());
+        });
+        fastify.addHook('onResponse', (request, reply, hookDone) => {
+            const span = request[spanKey];
+            if (span) {
+                const route = (request.routeOptions && request.routeOptions.url) || request.routerPath;
+                span.setLabel(label({ method: request.method, route, path: stripQuery(request.url) }));
+                span.end(statusError(reply.statusCode, errorStatus));
+            }
+            hookDone();
+        });
+        done();
+    };
+    // Same effect as wrapping with fastify-plugin: hooks apply to the whole app
+    plugin[Symbol.for('skip-override')] = true;
+    plugin[Symbol.for('fastify.display-name')] = 'traceperf';
+    return plugin;
+}
+/**
+ * Hono middleware:
+ *
+ *   app.use('*', honoMiddleware(tp));
+ */
+function honoMiddleware(tp, options = {}) {
+    const { label, errorStatus, trackOptions } = splitOptions(options);
+    return async function traceperfHono(c, next) {
+        var _a;
+        const path = c.req.path;
+        const span = tp.start(label({ method: c.req.method, path }), trackOptions);
+        let thrown;
+        try {
+            await span.run(() => next());
+        }
+        catch (error) {
+            thrown = error;
+            throw error;
+        }
+        finally {
+            const route = typeof c.req.routePath === 'string' && c.req.routePath !== '/*' && c.req.routePath !== '*'
+                ? c.req.routePath : undefined;
+            span.setLabel(label({ method: c.req.method, route, path }));
+            span.end((_a = thrown !== null && thrown !== void 0 ? thrown : c.error) !== null && _a !== void 0 ? _a : statusError(c.res && c.res.status, errorStatus));
+        }
+    };
+}
+/**
+ * Wrap any request handler, e.g. a Next.js route handler:
+ *
+ *   export const GET = withTracing(tp, async (request) => { ... });
+ *
+ * When the first argument looks like a Request, the label defaults to
+ * "METHOD /path"; otherwise the function name.
+ */
+function withTracing(tp, handler, options = {}) {
+    const { label, trackOptions } = splitOptions(options);
+    const wrapped = function (...args) {
+        const request = args[0];
+        let name = handler.name || 'handler';
+        if (request && typeof request.method === 'string' && typeof request.url === 'string') {
+            let path = stripQuery(request.url);
+            try {
+                path = new URL(request.url, 'http://localhost').pathname;
+            }
+            catch (_a) {
+                // keep the raw path
+            }
+            name = label({ method: request.method, path });
+        }
+        return tp.track(() => handler.apply(this, args), { ...trackOptions, label: name });
+    };
+    Object.defineProperty(wrapped, 'name', { value: handler.name, configurable: true });
+    Object.defineProperty(wrapped, 'length', { value: handler.length, configurable: true });
+    return wrapped;
+}
+/**
+ * Koa middleware. Register it first:
+ *
+ *   app.use(koaMiddleware(tp));
+ *
+ * Labels use the matched route when @koa/router sets ctx._matchedRoute.
+ */
+function koaMiddleware(tp, options = {}) {
+    const { label, errorStatus, trackOptions } = splitOptions(options);
+    return async function traceperfKoa(ctx, next) {
+        const path = stripQuery(ctx.path || ctx.url);
+        const span = tp.start(label({ method: ctx.method, path }), trackOptions);
+        let thrown;
+        try {
+            await span.run(() => next());
+        }
+        catch (error) {
+            thrown = error;
+            throw error;
+        }
+        finally {
+            const route = typeof ctx._matchedRoute === 'string' ? ctx._matchedRoute : undefined;
+            span.setLabel(label({ method: ctx.method, route, path }));
+            const status = thrown ? (thrown.status || thrown.statusCode || 500) : ctx.status;
+            span.end(thrown && status >= errorStatus ? thrown : statusError(status, errorStatus));
+        }
+    };
+}
+/**
+ * NestJS interceptor (works without importing Nest or rxjs into traceperf):
+ *
+ *   app.useGlobalInterceptors(nestInterceptor(tp));
+ *
+ * Label: "GET /users/:id" for HTTP, otherwise "Controller.handler".
+ */
+function nestInterceptor(tp, options = {}) {
+    const { label, errorStatus, trackOptions } = splitOptions(options);
+    return {
+        intercept(context, next) {
+            var _a, _b, _c, _d;
+            const type = typeof context.getType === 'function' ? context.getType() : 'http';
+            const request = type === 'http' ? context.switchToHttp().getRequest() : undefined;
+            const response = type === 'http' ? context.switchToHttp().getResponse() : undefined;
+            const handlerName = `${(_b = (_a = context.getClass) === null || _a === void 0 ? void 0 : _a.call(context).name) !== null && _b !== void 0 ? _b : 'Controller'}.${(_d = (_c = context.getHandler) === null || _c === void 0 ? void 0 : _c.call(context).name) !== null && _d !== void 0 ? _d : 'handler'}`;
+            const route = request && request.route && request.route.path
+                ? `${request.baseUrl || ''}${request.route.path}` : request && request.routeOptions && request.routeOptions.url;
+            const name = request
+                ? label({ method: request.method, route, path: stripQuery(request.originalUrl || request.url) })
+                : handlerName;
+            const span = tp.start(name, trackOptions);
+            const source = span.run(() => next.handle());
+            const Observable = source.constructor;
+            return new Observable((subscriber) => {
+                const subscription = span.run(() => source.subscribe({
+                    next: (value) => subscriber.next(value),
+                    error: (error) => {
+                        span.end(error);
+                        subscriber.error(error);
+                    },
+                    complete: () => {
+                        var _a;
+                        const status = response && ((_a = response.statusCode) !== null && _a !== void 0 ? _a : (typeof response.status === 'number' ? response.status : undefined));
+                        span.end(statusError(status, errorStatus));
+                        subscriber.complete();
+                    },
+                }));
+                return () => {
+                    subscription.unsubscribe();
+                    span.end();
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=integrations.js.map