traceperf 0.2.0 → 1.3.0

package/dist/esm/core/timeline.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Show tracked calls in the browser DevTools Performance panel (and in any
+ * User Timing consumer) via performance.measure().
+ */
+import { TracePerfPlugin } from './records.js';
+export interface PerformanceTimelineOptions {
+    /** DevTools track name (default "traceperf") */
+    track?: string;
+    /** Optional DevTools track group */
+    trackGroup?: string;
+    /**
+     * Keep the entries in the performance timeline (default false). DevTools
+     * recordings and PerformanceObservers see every entry either way; keeping
+     * them makes performance.getEntriesByType('measure') return them but grows
+     * memory in long-running pages.
+     */
+    keep?: boolean;
+}
+/**
+ * Emit a performance.measure() for every finished tracked call.
+ *
+ *   tp.use(performanceTimeline());
+ *
+ * In Chrome 129+ the entries appear on a custom "traceperf" track in the
+ * Performance panel (errors in red, details in the tooltip); elsewhere they
+ * appear in the Timings track / User Timing API.
+ */
+export declare function performanceTimeline(options?: PerformanceTimelineOptions): TracePerfPlugin;

package/dist/esm/core/timeline.js

@@ -0,0 +1,62 @@
+/**
+ * Show tracked calls in the browser DevTools Performance panel (and in any
+ * User Timing consumer) via performance.measure().
+ */
+import { walkRecords } from './records.js';
+/**
+ * Emit a performance.measure() for every finished tracked call.
+ *
+ *   tp.use(performanceTimeline());
+ *
+ * In Chrome 129+ the entries appear on a custom "traceperf" track in the
+ * Performance panel (errors in red, details in the tooltip); elsewhere they
+ * appear in the Timings track / User Timing API.
+ */
+export function performanceTimeline(options = {}) {
+    var _a;
+    const perf = typeof performance !== 'undefined' ? performance : undefined;
+    const supported = !!perf && typeof perf.measure === 'function';
+    const track = (_a = options.track) !== null && _a !== void 0 ? _a : 'traceperf';
+    return {
+        name: 'performance-timeline',
+        onComplete(root) {
+            if (!supported)
+                return;
+            walkRecords(root, record => {
+                const failed = record.error !== undefined && record.error !== null;
+                const properties = [
+                    ['duration', `${record.duration.toFixed(3)} ms`],
+                    ['self', `${record.selfDuration.toFixed(3)} ms`],
+                ];
+                if (record.async)
+                    properties.push(['sync', `${record.syncDuration.toFixed(3)} ms`]);
+                if (record.memoryDelta !== undefined)
+                    properties.push(['heap Δ', `${(record.memoryDelta / 1024).toFixed(2)} KB`]);
+                if (failed)
+                    properties.push(['error', record.error instanceof Error ? record.error.message : String(record.error)]);
+                try {
+                    perf.measure(record.label, {
+                        start: record.startTime,
+                        duration: record.duration,
+                        detail: {
+                            devtools: {
+                                dataType: 'track-entry',
+                                track,
+                                ...(options.trackGroup ? { trackGroup: options.trackGroup } : {}),
+                                color: failed ? 'error' : 'primary',
+                                properties,
+                                tooltipText: `${record.label}: ${record.duration.toFixed(2)} ms`,
+                            },
+                        },
+                    });
+                    if (!options.keep && typeof perf.clearMeasures === 'function')
+                        perf.clearMeasures(record.label);
+                }
+                catch (_a) {
+                    // Older engines without measure(name, options): skip silently
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/esm/core/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/core/timeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAoC,WAAW,EAAE,MAAM,WAAW,CAAC;AAgB1E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;;IAC1E,MAAM,IAAI,GAAQ,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,KAAK,mCAAI,WAAW,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,UAAU,CAAC,IAAqB;YAC9B,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;gBACzB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;gBACnE,MAAM,UAAU,GAA4B;oBAC1C,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;oBAChD,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;iBACjD,CAAC;gBACF,IAAI,MAAM,CAAC,KAAK;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClH,IAAI,MAAM;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpH,IAAI,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE;wBACzB,KAAK,EAAE,MAAM,CAAC,SAAS;wBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,MAAM,EAAE;4BACN,QAAQ,EAAE;gCACR,QAAQ,EAAE,aAAa;gCACvB,KAAK;gCACL,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACjE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gCACnC,UAAU;gCACV,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;6BACjE;yBACF;qBACF,CAAC,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU;wBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClG,CAAC;gBAAC,WAAM,CAAC;oBACP,8DAA8D;gBAChE,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/drivers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Ready-made instrumentation for popular database and cloud clients.
+ *
+ * Each helper takes the library module (or client) you already import, so
+ * traceperf has no dependency on any of them, patches it in place, is
+ * idempotent, and returns an uninstall function.
+ */
+import type { OptimizedPerformanceMonitor } from './core/optimized-performance-monitor.js';
+import type { TrackOptions } from './types/options.js';
+import type { Uninstall } from './instrument.js';
+export type DriverOptions = Omit<TrackOptions, 'label'>;
+/**
+ * "SELECT users", "INSERT orders", "UPDATE accounts", "BEGIN": the SQL verb
+ * and the first table it touches, without values (labels stay low-cardinality).
+ */
+export declare function sqlLabel(sql: unknown): string;
+/**
+ * node-postgres: tracks every query ("pg SELECT users"), including those
+ * made through Pool.query (it delegates to Client.query).
+ *
+ *   instrumentPg(tp, require('pg'));
+ */
+export declare function instrumentPg(tp: OptimizedPerformanceMonitor, pg: any, options?: DriverOptions): Uninstall;
+/**
+ * mysql2 (callback and promise APIs, connections and pools):
+ *
+ *   instrumentMysql2(tp, require('mysql2'));
+ */
+export declare function instrumentMysql2(tp: OptimizedPerformanceMonitor, mysql2: any, options?: DriverOptions): Uninstall;
+/**
+ * MongoDB Node driver, and therefore Mongoose: "mongo insertOne users",
+ * "mongo find users" (cursor reads are tracked when the results are fetched).
+ *
+ *   instrumentMongo(tp, require('mongodb'));
+ *   instrumentMongo(tp, require('mongoose').mongo);   // Mongoose's bundled driver
+ */
+export declare function instrumentMongo(tp: OptimizedPerformanceMonitor, mongodb: any, options?: DriverOptions): Uninstall;
+/**
+ * ioredis: every command, "redis GET", "redis HSET" (pipelines and
+ * transactions show their individual commands).
+ *
+ *   instrumentRedis(tp, require('ioredis'));
+ */
+export declare function instrumentRedis(tp: OptimizedPerformanceMonitor, Redis: any, options?: DriverOptions): Uninstall;
+/**
+ * AWS SDK v3 clients: "aws S3.GetObject", "aws DynamoDB.Query".
+ * Adds a middleware to the given client instance.
+ *
+ *   instrumentAwsClient(tp, new S3Client({}));
+ */
+export declare function instrumentAwsClient(tp: OptimizedPerformanceMonitor, client: any, options?: DriverOptions): Uninstall;

package/dist/esm/drivers.js

@@ -0,0 +1,197 @@
+const PATCHED = Symbol.for('traceperf.instrumented');
+const isPromiseLike = (value) => value !== null && (typeof value === 'object' || typeof value === 'function') && typeof value.then === 'function';
+const isCommandObject = (value) => value !== null && typeof value === 'object' && !(value instanceof Promise) &&
+    typeof value.once === 'function' && typeof value.on === 'function' &&
+    typeof value.emit === 'function';
+/**
+ * Run one driver call as a tracked span, whether it reports completion via
+ * a callback (last argument), a returned promise, or synchronously.
+ */
+function trackCall(tp, label, options, thisArg, original, args, callbackIndex = args.length - 1) {
+    const span = tp.start(label, options);
+    let ended = false;
+    const end = (error) => {
+        if (ended)
+            return;
+        ended = true;
+        span.end(error);
+    };
+    const cb = callbackIndex >= 0 ? args[callbackIndex] : undefined;
+    if (typeof cb === 'function') {
+        const wrappedArgs = args.slice();
+        wrappedArgs[callbackIndex] = function (error, ...rest) {
+            end(error || undefined);
+            return cb.call(this, error, ...rest);
+        };
+        try {
+            return span.run(() => original.apply(thisArg, wrappedArgs));
+        }
+        catch (error) {
+            end(error);
+            throw error;
+        }
+    }
+    let result;
+    try {
+        result = span.run(() => original.apply(thisArg, args));
+    }
+    catch (error) {
+        end(error);
+        throw error;
+    }
+    // Command objects (mysql2 Query, pg Query) are event emitters; some, like
+    // mysql2's, have a .then() that throws. Finish on their completion
+    // callback or 'end' event instead of treating them as promises.
+    if (isCommandObject(result)) {
+        const command = result;
+        if (typeof command.onResult === 'function') {
+            const onResult = command.onResult;
+            command.onResult = function (error, ...rest) {
+                end(error || undefined);
+                return onResult.call(this, error, ...rest);
+            };
+        }
+        command.once('end', () => end());
+        return result;
+    }
+    if (isPromiseLike(result)) {
+        result.then(() => end(), error => end(error));
+        return result;
+    }
+    end();
+    return result;
+}
+function patchMethod(target, name, makePatched, restores) {
+    if (!target)
+        return;
+    const original = target[name];
+    if (typeof original !== 'function' || original[PATCHED])
+        return;
+    const patched = makePatched(original);
+    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];
+    });
+}
+/**
+ * "SELECT users", "INSERT orders", "UPDATE accounts", "BEGIN": the SQL verb
+ * and the first table it touches, without values (labels stay low-cardinality).
+ */
+export function sqlLabel(sql) {
+    const text = typeof sql === 'string' ? sql : sql && typeof sql.text === 'string' ? sql.text
+        : sql && typeof sql.sql === 'string' ? sql.sql : '';
+    const cleaned = text.replace(/--[^\n]*|\/\*[\s\S]*?\*\//g, ' ').trim();
+    const verb = (cleaned.split(/\s+/)[0] || 'query').toUpperCase();
+    const table = /\b(?:from|into|update|join|table)\s+("?[\w.]+"?)/i.exec(cleaned);
+    return table ? `${verb} ${table[1].replace(/"/g, '')}` : verb;
+}
+/**
+ * node-postgres: tracks every query ("pg SELECT users"), including those
+ * made through Pool.query (it delegates to Client.query).
+ *
+ *   instrumentPg(tp, require('pg'));
+ */
+export function instrumentPg(tp, pg, options = {}) {
+    const restores = [];
+    patchMethod(pg && pg.Client && pg.Client.prototype, 'query', original => function (...args) {
+        return trackCall(tp, `pg ${sqlLabel(args[0])}`, options, this, original, args);
+    }, restores);
+    return () => restores.forEach(r => r());
+}
+/**
+ * mysql2 (callback and promise APIs, connections and pools):
+ *
+ *   instrumentMysql2(tp, require('mysql2'));
+ */
+export function instrumentMysql2(tp, mysql2, options = {}) {
+    const restores = [];
+    const proto = mysql2 && mysql2.Connection && mysql2.Connection.prototype;
+    for (const method of ['query', 'execute']) {
+        patchMethod(proto, method, original => function (...args) {
+            return trackCall(tp, `mysql ${sqlLabel(args[0])}`, options, this, original, args);
+        }, restores);
+    }
+    return () => restores.forEach(r => r());
+}
+const MONGO_COLLECTION_METHODS = [
+    'insertOne', 'insertMany', 'findOne', 'updateOne', 'updateMany', 'replaceOne', 'deleteOne', 'deleteMany',
+    'countDocuments', 'estimatedDocumentCount', 'distinct', 'findOneAndUpdate', 'findOneAndDelete',
+    'findOneAndReplace', 'bulkWrite', 'createIndex',
+];
+/**
+ * MongoDB Node driver, and therefore Mongoose: "mongo insertOne users",
+ * "mongo find users" (cursor reads are tracked when the results are fetched).
+ *
+ *   instrumentMongo(tp, require('mongodb'));
+ *   instrumentMongo(tp, require('mongoose').mongo);   // Mongoose's bundled driver
+ */
+export function instrumentMongo(tp, mongodb, options = {}) {
+    const restores = [];
+    const collection = mongodb && mongodb.Collection && mongodb.Collection.prototype;
+    for (const method of MONGO_COLLECTION_METHODS) {
+        patchMethod(collection, method, original => function (...args) {
+            // Modern driver methods are promise-only; never treat a filter as a callback
+            return trackCall(tp, `mongo ${method} ${this && this.collectionName}`, options, this, original, args, -1);
+        }, restores);
+    }
+    const cursorName = (cursor) => {
+        const ns = cursor && cursor.namespace;
+        return (ns && (ns.collection || ns.coll)) || '';
+    };
+    for (const [className, op] of [['FindCursor', 'find'], ['AggregationCursor', 'aggregate']]) {
+        const proto = mongodb && mongodb[className] && mongodb[className].prototype;
+        patchMethod(proto, 'toArray', original => function (...args) {
+            return trackCall(tp, `mongo ${op} ${cursorName(this)}`, options, this, original, args, -1);
+        }, restores);
+    }
+    return () => restores.forEach(r => r());
+}
+/**
+ * ioredis: every command, "redis GET", "redis HSET" (pipelines and
+ * transactions show their individual commands).
+ *
+ *   instrumentRedis(tp, require('ioredis'));
+ */
+export function instrumentRedis(tp, Redis, options = {}) {
+    const restores = [];
+    const RedisClass = Redis && (Redis.default || Redis.Redis || Redis);
+    patchMethod(RedisClass && RedisClass.prototype, 'sendCommand', original => function (command, ...rest) {
+        const name = command && command.name ? String(command.name).toUpperCase() : 'COMMAND';
+        return trackCall(tp, `redis ${name}`, options, this, original, [command, ...rest], -1);
+    }, restores);
+    return () => restores.forEach(r => r());
+}
+/**
+ * AWS SDK v3 clients: "aws S3.GetObject", "aws DynamoDB.Query".
+ * Adds a middleware to the given client instance.
+ *
+ *   instrumentAwsClient(tp, new S3Client({}));
+ */
+export function instrumentAwsClient(tp, client, options = {}) {
+    const stack = client && client.middlewareStack;
+    if (!stack || typeof stack.add !== 'function')
+        return () => undefined;
+    const name = 'traceperfMiddleware';
+    if (client[PATCHED])
+        return () => undefined;
+    const service = (context) => { var _a; return String((context && context.clientName) || ((_a = client.constructor) === null || _a === void 0 ? void 0 : _a.name) || 'AWS').replace(/Client$/, ''); };
+    stack.add((next, context) => (args) => tp.track(() => next(args), {
+        ...options,
+        label: `aws ${service(context)}.${String((context && context.commandName) || 'Command').replace(/Command$/, '')}`,
+    }), { step: 'initialize', name, priority: 'high' });
+    client[PATCHED] = true;
+    return () => {
+        stack.remove(name);
+        delete client[PATCHED];
+    };
+}
+//# sourceMappingURL=drivers.js.map

package/dist/esm/drivers.js.map

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

package/dist/esm/index.d.ts

@@ -1,9 +1,17 @@
-import { OptimizedPerformanceMonitor, TrackingModes } from './core/optimized-performance-monitor';
-import { ITracePerfConfig } from './types';
+import { OptimizedPerformanceMonitor, TrackingModes } from './core/optimized-performance-monitor.js';
+import { ITracePerfConfig, TrackOptions } from './types/index.js';
 declare const tracePerf: OptimizedPerformanceMonitor;
 export default tracePerf;
-export declare function createTracePerf(config?: Partial<ITracePerfConfig>): OptimizedPerformanceMonitor;
-export * from './types';
-export * from './core';
+export declare function createTracePerf(config?: ITracePerfConfig): OptimizedPerformanceMonitor;
+/**
+ * Method decorator bound to the default instance, see `OptimizedPerformanceMonitor.traced`.
+ */
+export declare function traced(options?: TrackOptions): import("./core/index.js").TracedDecorator;
+export * from './types/index.js';
+export * from './core/index.js';
+export * from './integrations.js';
+export * from './instrument.js';
+export * from './drivers.js';
+export * from './auto.js';
 export { OptimizedPerformanceMonitor };
 export { TrackingModes as TrackingMode };

package/dist/esm/index.js

@@ -1,28 +1,32 @@
 // Import optimized performance monitor from core
-import { OptimizedPerformanceMonitor, TrackingModes } from './core/optimized-performance-monitor';
-import * as typesExports from './types';
-// Create singleton instance
-const tracePerf = new OptimizedPerformanceMonitor();
+import { OptimizedPerformanceMonitor, TrackingModes } from './core/optimized-performance-monitor.js';
+// Create singleton instance, shared by the CommonJS and ESM builds of this
+// major version (so `--require traceperf/auto` and `import tp from
+// 'traceperf'` see the same instance and the same call trees)
+const DEFAULT_KEY = Symbol.for('traceperf.default.v1');
+const shared = globalThis;
+const tracePerf = shared[DEFAULT_KEY] || (shared[DEFAULT_KEY] = new OptimizedPerformanceMonitor());
 // Export the singleton instance as the default export
 export default tracePerf;
 // Export a function to create a new tracePerf instance
 export function createTracePerf(config = {}) {
     return new OptimizedPerformanceMonitor(config);
 }
+/**
+ * Method decorator bound to the default instance, see `OptimizedPerformanceMonitor.traced`.
+ */
+export function traced(options = {}) {
+    // Call the prototype method: in CommonJS this function is also installed
+    // as tracePerf.traced, so tracePerf.traced(...) would recurse.
+    return OptimizedPerformanceMonitor.prototype.traced.call(tracePerf, options);
+}
 // Export types and classes for advanced usage
-export * from './types';
-export * from './core';
+export * from './types/index.js';
+export * from './core/index.js';
+export * from './integrations.js';
+export * from './instrument.js';
+export * from './drivers.js';
+export * from './auto.js';
 export { OptimizedPerformanceMonitor };
 export { TrackingModes as TrackingMode };
-// Add CommonJS compatibility
-if (typeof module !== 'undefined' && module.exports) {
-    module.exports = Object.assign(tracePerf, {
-        default: tracePerf,
-        createTracePerf,
-        OptimizedPerformanceMonitor,
-        TrackingMode: TrackingModes,
-        // Re-export types
-        ...typesExports
-    });
-}
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAElG,OAAO,KAAK,YAAY,MAAM,SAAS,CAAC;AAExC,4BAA4B;AAC5B,MAAM,SAAS,GAAG,IAAI,2BAA2B,EAAE,CAAC;AAEpD,sDAAsD;AACtD,eAAe,SAAS,CAAC;AAEzB,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,SAAoC,EAAE;IACpE,OAAO,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,8CAA8C;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC;AAEzC,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;QAC3B,YAAY,EAAE,aAAa;QAC3B,kBAAkB;QAClB,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGlG,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,2BAA2B,EAAE,CAAC,CAAC;AAEhI,sDAAsD;AACtD,eAAe,SAAS,CAAC;AAEzB,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,SAA2B,EAAE;IAC3D,OAAO,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,UAAwB,EAAE;IAC/C,yEAAyE;IACzE,+DAA+D;IAC/D,OAAO,2BAA2B,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,8CAA8C;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC;AAEzC,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;QAC3B,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAC;AACL,CAAC;AACD,gBAAgB"}

package/dist/esm/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.js';
+import type { TrackOptions } from './types/options.js';
+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;