traceperf 0.2.0 → 1.3.0

package/dist/esm/core/explain.js

@@ -0,0 +1,232 @@
+/**
+ * Plain-English explanations of finished trees: what made a call slow.
+ *
+ *   const findings = explain(roots);
+ *   console.log(formatFindings(findings));
+ *
+ * Works on records from onComplete / a trace recorder, or on files via
+ * `traceperf explain <file>`. Every finding is a heuristic with the numbers
+ * that triggered it, so it can be checked against the tree.
+ */
+const fmt = (ms) => (ms >= 1000 ? `${(ms / 1000).toFixed(2)} s` : `${ms.toFixed(ms < 10 ? 1 : 0)} ms`);
+const pct = (part, whole) => `${Math.round((part / Math.max(whole, 1e-9)) * 100)}%`;
+function syncOf(node) {
+    if (typeof node.syncDuration === 'number')
+        return node.syncDuration;
+    return node.async ? 0 : node.duration;
+}
+/** Deepest records whose synchronous part is long: the code that actually blocked */
+function collectBlockers(node, rootIndex, threshold, out) {
+    let childBlocked = 0;
+    for (const child of node.children) {
+        if (collectBlockers(child, rootIndex, threshold, out))
+            childBlocked += syncOf(child);
+    }
+    const sync = syncOf(node);
+    // Attribute to this node only the blocking its blocking children do not explain
+    if (sync >= threshold && sync - childBlocked >= threshold) {
+        out.push({ label: node.label, root: rootIndex, start: node.startTime, end: node.startTime + sync });
+        return true;
+    }
+    return childBlocked > 0;
+}
+function overlap(aStart, aEnd, bStart, bEnd) {
+    return Math.max(0, Math.min(aEnd, bEnd) - Math.max(aStart, bStart));
+}
+function walk(node, visit) {
+    visit(node);
+    node.children.forEach(c => walk(c, visit));
+}
+export function explain(roots, options = {}) {
+    var _a, _b, _c, _d, _e;
+    const blockingMs = (_a = options.blockingMs) !== null && _a !== void 0 ? _a : 10;
+    const minMs = (_b = options.minMs) !== null && _b !== void 0 ? _b : 5;
+    const dominantShare = (_c = options.dominantShare) !== null && _c !== void 0 ? _c : 0.6;
+    const repeatCount = (_d = options.repeatCount) !== null && _d !== void 0 ? _d : 5;
+    const findings = [];
+    const blockers = [];
+    roots.forEach((root, i) => collectBlockers(root, i, blockingMs, blockers));
+    roots.forEach((root, i) => {
+        var _a;
+        const rootLabel = root.label;
+        const rootEnd = root.startTime + root.duration;
+        // 1. Delayed by blocking code in other top-level calls
+        const byLabel = new Map();
+        for (const b of blockers) {
+            if (b.root === i)
+                continue;
+            const ms = overlap(root.startTime, rootEnd, b.start, b.end);
+            if (ms <= 0)
+                continue;
+            const entry = (_a = byLabel.get(b.label)) !== null && _a !== void 0 ? _a : { ms: 0, roots: new Set() };
+            entry.ms += ms;
+            entry.roots.add(roots[b.root].label);
+            byLabel.set(b.label, entry);
+        }
+        let blockedTotal = 0;
+        byLabel.forEach(({ ms, roots: from }, label) => {
+            blockedTotal += ms;
+            if (ms < minMs)
+                return;
+            const where = [...from].slice(0, 3).join(', ') + (from.size > 3 ? ` and ${from.size - 3} more` : '');
+            findings.push({
+                kind: 'blocked',
+                root: rootLabel,
+                ms,
+                message: `${rootLabel} waited ~${fmt(ms)} (${pct(ms, root.duration)} of its ${fmt(root.duration)}) while ${label} in ${where} blocked the event loop`,
+            });
+        });
+        // 2. Blocking code inside this call
+        for (const b of blockers) {
+            if (b.root !== i)
+                continue;
+            const ms = b.end - b.start;
+            if (ms < minMs)
+                continue;
+            findings.push({
+                kind: 'blocking',
+                root: rootLabel,
+                ms,
+                message: `${b.label} ran ${fmt(ms)} of synchronous code, blocking everything else in the process for that long`,
+            });
+        }
+        walk(root, node => {
+            var _a;
+            const kids = node.children;
+            if (kids.length === 0)
+                return;
+            // 3. Awaited one after another although they could overlap
+            const asyncKids = kids.filter(k => k.async && k.duration >= 1).sort((a, b) => a.startTime - b.startTime);
+            let run = [];
+            const flush = () => {
+                if (run.length >= 2) {
+                    const total = run.reduce((s, k) => s + k.duration, 0);
+                    const saving = total - Math.max(...run.map(k => k.duration));
+                    if (saving >= minMs) {
+                        const names = run.map(k => k.label);
+                        const shown = names.length > 4 ? `${names.slice(0, 4).join(', ')}, ...` : names.join(', ');
+                        findings.push({
+                            kind: 'sequential',
+                            root: rootLabel,
+                            ms: saving,
+                            message: `${node.label} awaited ${run.length} calls one after another (${shown}: ${fmt(total)}); if they are independent, Promise.all could save up to ~${fmt(saving)}`,
+                        });
+                    }
+                }
+                run = [];
+            };
+            for (const k of asyncKids) {
+                const prev = run[run.length - 1];
+                // "One after another": starts after the previous one ended (small gap allowed)
+                if (prev && k.startTime >= prev.startTime + prev.duration - 0.05)
+                    run.push(k);
+                else {
+                    flush();
+                    run = [k];
+                }
+            }
+            flush();
+            // 4. Same call repeated many times (N+1 queries)
+            const counts = new Map();
+            for (const k of kids) {
+                const c = (_a = counts.get(k.label)) !== null && _a !== void 0 ? _a : { n: 0, ms: 0 };
+                c.n++;
+                c.ms += k.duration;
+                counts.set(k.label, c);
+            }
+            counts.forEach(({ n, ms }, label) => {
+                if (n >= repeatCount && ms >= minMs) {
+                    findings.push({
+                        kind: 'repeated',
+                        root: rootLabel,
+                        ms,
+                        message: `${node.label} called ${label} ${n} times (${fmt(ms)} total); batching them into one call may help (N+1 pattern)`,
+                    });
+                }
+            });
+        });
+        // 5. One child dominates the top-level call
+        for (const k of root.children) {
+            if (k.duration >= minMs && k.duration >= dominantShare * root.duration) {
+                const waited = blockers
+                    .filter(b => b.root !== i)
+                    .reduce((sum, b) => sum + overlap(k.startTime, k.startTime + k.duration, b.start, b.end), 0);
+                const note = waited >= minMs && waited >= 0.3 * k.duration
+                    ? `, but ~${fmt(waited)} of that was waiting for blocking code elsewhere`
+                    : '';
+                findings.push({
+                    kind: 'dominant',
+                    root: rootLabel,
+                    ms: k.duration - waited,
+                    message: `${k.label} took ${pct(k.duration, root.duration)} of ${rootLabel} (${fmt(k.duration)} of ${fmt(root.duration)})${note}`,
+                });
+            }
+        }
+        // Large own time not explained by children or blocking
+        const own = root.selfDuration - blockedTotal;
+        if (root.children.length > 0 && own >= minMs && own >= dominantShare * root.duration) {
+            findings.push({
+                kind: 'dominant',
+                root: rootLabel,
+                ms: own,
+                message: `${pct(own, root.duration)} of ${rootLabel} (${fmt(own)}) is outside any tracked call; track the code inside it to see where`,
+            });
+        }
+        // 6. Failures
+        walk(root, node => {
+            if (node.error === undefined || node.error === null)
+                return;
+            // Report each error once, at the deepest record that has it
+            if (node.children.some(c => c.error !== undefined && c.error !== null))
+                return;
+            const msg = node.error instanceof Error ? node.error.message : String(node.error);
+            findings.push({
+                kind: 'error',
+                root: rootLabel,
+                ms: node.duration,
+                message: `${node === root ? node.label : `${node.label} in ${rootLabel}`} failed after ${fmt(node.duration)}: ${msg}`,
+            });
+        });
+    });
+    // Same finding for many identical roots (e.g. 1000 requests): keep the largest, count the rest
+    // Blocking by the same function is grouped across top-level calls too
+    const grouped = new Map();
+    for (const f of findings) {
+        const scope = f.kind === 'blocking' ? '' : f.root;
+        const key = `${f.kind}|${scope}|${f.message.replace(/[0-9.]+ ?(ms|s|%)/g, '')}`;
+        const g = grouped.get(key);
+        if (!g)
+            grouped.set(key, { ...f, times: 1, roots: new Set([f.root]) });
+        else {
+            g.times++;
+            g.roots.add(f.root);
+            if (f.ms > g.ms)
+                Object.assign(g, { ms: f.ms, message: f.message });
+        }
+    }
+    const order = { error: 0, blocked: 1, blocking: 2, repeated: 3, sequential: 4, dominant: 5 };
+    return [...grouped.values()]
+        .sort((a, b) => b.ms * b.times - a.ms * a.times || order[a.kind] - order[b.kind])
+        .slice(0, (_e = options.max) !== null && _e !== void 0 ? _e : 20)
+        .map(({ times, roots: seenIn, ...f }) => {
+        const where = [...seenIn];
+        const label = where.length > 3 ? `${where.slice(0, 3).join(', ')} and ${where.length - 3} more` : where.join(', ');
+        if (f.kind === 'blocking') {
+            const self = where.length === 1 && where[0] === f.message.split(' ran ')[0];
+            const count = times > where.length ? `${times} times` : '';
+            const note = self ? count : [`in ${label}`, count].filter(Boolean).join(', ');
+            return { ...f, message: note ? `${f.message} (${note})` : f.message };
+        }
+        return times > 1 ? { ...f, message: `${f.message} (seen ${times} times, worst shown)` } : f;
+    });
+}
+const ICON = {
+    error: '✖', blocked: '⏳', blocking: '🔥', repeated: '🔁', sequential: '⇉', dominant: '●',
+};
+/** Render findings as text, one per line */
+export function formatFindings(findings) {
+    if (findings.length === 0)
+        return 'No issues found: nothing blocked, repeated, or ran sequentially in a way worth changing.';
+    return findings.map(f => `${ICON[f.kind]} ${f.message}`).join('\n');
+}
+//# sourceMappingURL=explain.js.map

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

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

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

@@ -0,0 +1,111 @@
+/**
+ * Exporters: get traceperf data out of the process.
+ *
+ * - Chrome Trace Event / Perfetto JSON (open in chrome://tracing,
+ *   https://ui.perfetto.dev or the DevTools Performance panel)
+ * - OpenTelemetry spans (bring your own @opentelemetry/api)
+ * - JSON lines
+ */
+import { ExecutionRecord, TracePerfPlugin } from './records.js';
+/** A single Trace Event Format "complete" event */
+export interface ChromeTraceEvent {
+    name: string;
+    cat: string;
+    ph: 'X' | 'M';
+    ts: number;
+    dur?: number;
+    pid: number;
+    tid: number;
+    args?: Record<string, unknown>;
+}
+/** Trace Event Format document */
+export interface ChromeTrace {
+    traceEvents: ChromeTraceEvent[];
+    displayTimeUnit: 'ms';
+}
+/**
+ * Convert finished execution trees to Trace Event Format.
+ *
+ * Complete ("X") events must nest strictly within a thread, so calls that
+ * overlap without nesting (concurrent async work) are placed on extra lanes.
+ */
+export declare function toChromeTrace(roots: ExecutionRecord[]): ChromeTrace;
+/** Collects finished trees in memory; `stop()` returns a Chrome trace */
+export interface TraceRecorder extends TracePerfPlugin {
+    /** Trees recorded so far */
+    readonly roots: ExecutionRecord[];
+    /** Stop recording and return the trace (also unsubscribes, when attached via startTrace) */
+    stop(): ChromeTrace;
+}
+/**
+ * Create a plugin that records finished trees for a Chrome/Perfetto trace.
+ * Keeps at most `maxRoots` top-level calls (oldest dropped first).
+ */
+export declare function createTraceRecorder(options?: {
+    maxRoots?: number;
+    onStop?: () => void;
+}): TraceRecorder;
+/**
+ * Minimal structural types for the parts of @opentelemetry/api used here,
+ * so traceperf needs no dependency on it.
+ */
+export interface OtelSpanLike {
+    setAttribute(key: string, value: string | number | boolean): unknown;
+    recordException(exception: unknown): unknown;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): unknown;
+    end(endTime?: number): unknown;
+    updateName?(name: string): unknown;
+}
+export interface OtelTracerLike {
+    startSpan(name: string, options?: {
+        startTime?: number;
+    }, context?: unknown): OtelSpanLike;
+}
+export interface OtelApiLike {
+    trace: {
+        getTracer(name: string, version?: string): OtelTracerLike;
+        setSpan(context: unknown, span: OtelSpanLike): unknown;
+    };
+    context: {
+        active(): unknown;
+        /** Needed for live mode */
+        with?<R>(context: unknown, fn: () => R): R;
+    };
+}
+export interface OpenTelemetryExporterOptions {
+    /** Tracer name (default "traceperf") */
+    tracerName?: string;
+    /** Use this tracer instead of api.trace.getTracer() */
+    tracer?: OtelTracerLike;
+    /**
+     * Live mode: open each span when the call starts and make it the active
+     * OpenTelemetry context while the call runs, so spans created by other
+     * instrumentation (HTTP clients, database drivers) nest under it.
+     * Requires a context manager to be registered (as any OTel SDK setup does).
+     */
+    live?: boolean;
+}
+/**
+ * Export tracked calls as OpenTelemetry spans.
+ *
+ *   import * as otel from '@opentelemetry/api';
+ *   tp.use(openTelemetryExporter(otel));                 // spans created when the tree finishes
+ *   tp.use(openTelemetryExporter(otel, { live: true })); // spans active while the call runs
+ *
+ * Default mode creates spans when the top-level call finishes, with the
+ * real start/end times, parented to the OpenTelemetry context that was
+ * active when the call started. Live mode opens each span when the call
+ * starts and makes it the active context, so other instrumentation's spans
+ * become its children.
+ */
+export declare function openTelemetryExporter(api: OtelApiLike, options?: OpenTelemetryExporterOptions): TracePerfPlugin;
+/** JSON-serialisable view of a record (errors become messages) */
+export declare function recordToJSON(record: ExecutionRecord): Record<string, unknown>;
+/**
+ * Write one JSON line per finished top-level call (the whole tree).
+ * Defaults to stdout in Node and console.log elsewhere.
+ */
+export declare function jsonLinesExporter(write?: (line: string) => void): TracePerfPlugin;

package/dist/esm/core/exporters.js

@@ -0,0 +1,229 @@
+/**
+ * Exporters: get traceperf data out of the process.
+ *
+ * - Chrome Trace Event / Perfetto JSON (open in chrome://tracing,
+ *   https://ui.perfetto.dev or the DevTools Performance panel)
+ * - OpenTelemetry spans (bring your own @opentelemetry/api)
+ * - JSON lines
+ */
+import { walkRecords } from './records.js';
+/**
+ * Convert finished execution trees to Trace Event Format.
+ *
+ * Complete ("X") events must nest strictly within a thread, so calls that
+ * overlap without nesting (concurrent async work) are placed on extra lanes.
+ */
+export function toChromeTrace(roots) {
+    const events = [];
+    // For each lane, the stack of end times of open events
+    const lanes = [];
+    const fits = (lane, start, end) => {
+        while (lane.length > 0 && lane[lane.length - 1] <= start)
+            lane.pop();
+        return lane.length === 0 || end <= lane[lane.length - 1];
+    };
+    const place = (record, preferred) => {
+        const candidates = [preferred, ...lanes.map((_, i) => i).filter(i => i !== preferred)];
+        for (const i of candidates) {
+            if (lanes[i] && fits(lanes[i], record.startTime, record.endTime)) {
+                lanes[i].push(record.endTime);
+                return i;
+            }
+        }
+        lanes.push([record.endTime]);
+        return lanes.length - 1;
+    };
+    const all = [];
+    const sortedRoots = roots.slice().sort((a, b) => a.startTime - b.startTime);
+    const visit = (record, parentLane) => {
+        all.push({ record, parentLane });
+    };
+    sortedRoots.forEach(root => walkRecords(root, r => visit(r, 0)));
+    // Events must be placed in start order (parents before children on ties)
+    all.sort((a, b) => a.record.startTime - b.record.startTime || b.record.duration - a.record.duration);
+    const laneOf = new Map();
+    for (const { record } of all) {
+        const preferred = record.parentId !== null && laneOf.has(record.parentId) ? laneOf.get(record.parentId) : 0;
+        const lane = place(record, preferred);
+        laneOf.set(record.id, lane);
+        const args = { selfMs: record.selfDuration, syncMs: record.syncDuration };
+        if (record.memoryDelta !== undefined)
+            args.memoryDeltaBytes = record.memoryDelta;
+        if (record.args && record.args.length)
+            args.args = record.args;
+        if (record.error !== undefined && record.error !== null) {
+            args.error = record.error instanceof Error ? record.error.message : String(record.error);
+        }
+        events.push({
+            name: record.label,
+            cat: 'traceperf',
+            ph: 'X',
+            ts: Math.round(record.startTime * 1000),
+            dur: Math.max(0, Math.round(record.duration * 1000)),
+            pid: 1,
+            tid: lane + 1,
+            args,
+        });
+    }
+    const meta = [
+        { name: 'process_name', cat: '__metadata', ph: 'M', ts: 0, pid: 1, tid: 0, args: { name: 'traceperf' } },
+        ...lanes.map((_, i) => ({
+            name: 'thread_name', cat: '__metadata', ph: 'M', ts: 0, pid: 1, tid: i + 1,
+            args: { name: i === 0 ? 'main' : `concurrent ${i}` },
+        })),
+    ];
+    return { traceEvents: [...meta, ...events], displayTimeUnit: 'ms' };
+}
+/**
+ * Create a plugin that records finished trees for a Chrome/Perfetto trace.
+ * Keeps at most `maxRoots` top-level calls (oldest dropped first).
+ */
+export function createTraceRecorder(options = {}) {
+    var _a;
+    const maxRoots = Math.max(1, (_a = options.maxRoots) !== null && _a !== void 0 ? _a : 10000);
+    const roots = [];
+    let stopped = false;
+    return {
+        name: 'chrome-trace',
+        roots,
+        onComplete(root) {
+            if (stopped)
+                return;
+            roots.push(root);
+            if (roots.length > maxRoots)
+                roots.shift();
+        },
+        stop() {
+            if (!stopped) {
+                stopped = true;
+                if (options.onStop)
+                    options.onStop();
+            }
+            return toChromeTrace(roots);
+        },
+    };
+}
+/** OpenTelemetry status code for errors (SpanStatusCode.ERROR) */
+const OTEL_STATUS_ERROR = 2;
+function decorateSpan(span, record) {
+    span.setAttribute('traceperf.self_ms', record.selfDuration);
+    span.setAttribute('traceperf.sync_ms', record.syncDuration);
+    span.setAttribute('traceperf.async', record.async);
+    if (record.memoryDelta !== undefined)
+        span.setAttribute('traceperf.memory_delta_bytes', record.memoryDelta);
+    if (record.args && record.args.length)
+        span.setAttribute('traceperf.args', record.args.join(', '));
+    if (record.error !== undefined && record.error !== null) {
+        span.recordException(record.error);
+        span.setStatus({
+            code: OTEL_STATUS_ERROR,
+            message: record.error instanceof Error ? record.error.message : String(record.error),
+        });
+    }
+}
+/**
+ * Export tracked calls as OpenTelemetry spans.
+ *
+ *   import * as otel from '@opentelemetry/api';
+ *   tp.use(openTelemetryExporter(otel));                 // spans created when the tree finishes
+ *   tp.use(openTelemetryExporter(otel, { live: true })); // spans active while the call runs
+ *
+ * Default mode creates spans when the top-level call finishes, with the
+ * real start/end times, parented to the OpenTelemetry context that was
+ * active when the call started. Live mode opens each span when the call
+ * starts and makes it the active context, so other instrumentation's spans
+ * become its children.
+ */
+export function openTelemetryExporter(api, options = {}) {
+    var _a, _b;
+    const tracer = (_a = options.tracer) !== null && _a !== void 0 ? _a : api.trace.getTracer((_b = options.tracerName) !== null && _b !== void 0 ? _b : 'traceperf');
+    if (options.live) {
+        if (typeof api.context.with !== 'function') {
+            throw new Error('openTelemetryExporter: live mode needs api.context.with (pass @opentelemetry/api)');
+        }
+        const spans = new Map();
+        return {
+            name: 'opentelemetry-live',
+            onStart(execution) {
+                // Inside a tracked parent, wrap() has made the parent span active
+                spans.set(execution.id, tracer.startSpan(execution.label, { startTime: execution.startEpochMs }, api.context.active()));
+            },
+            wrap(execution, run) {
+                const span = spans.get(execution.id);
+                if (!span)
+                    return run();
+                return api.context.with(api.trace.setSpan(api.context.active(), span), run);
+            },
+            onComplete(root) {
+                walkRecords(root, record => {
+                    const span = spans.get(record.id);
+                    if (!span)
+                        return;
+                    spans.delete(record.id);
+                    if (span.updateName)
+                        span.updateName(record.label);
+                    decorateSpan(span, record);
+                    span.end(record.startEpochMs + record.duration);
+                });
+            },
+        };
+    }
+    const startContexts = new Map();
+    return {
+        name: 'opentelemetry',
+        onStart(execution) {
+            if (execution.parentId === null)
+                startContexts.set(execution.id, api.context.active());
+        },
+        onComplete(root) {
+            var _a;
+            const parentContext = (_a = startContexts.get(root.id)) !== null && _a !== void 0 ? _a : api.context.active();
+            startContexts.delete(root.id);
+            const emit = (record, ctx) => {
+                const span = tracer.startSpan(record.label, { startTime: record.startEpochMs }, ctx);
+                decorateSpan(span, record);
+                const childCtx = api.trace.setSpan(ctx, span);
+                record.children.forEach(child => emit(child, childCtx));
+                span.end(record.startEpochMs + record.duration);
+            };
+            emit(root, parentContext);
+        },
+    };
+}
+/** JSON-serialisable view of a record (errors become messages) */
+export function recordToJSON(record) {
+    return {
+        label: record.label,
+        start: new Date(record.startEpochMs).toISOString(),
+        durationMs: record.duration,
+        selfMs: record.selfDuration,
+        syncMs: record.syncDuration,
+        async: record.async,
+        ...(record.memoryDelta !== undefined ? { memoryDeltaBytes: record.memoryDelta } : {}),
+        ...(record.args && record.args.length ? { args: record.args } : {}),
+        ...(record.error !== undefined && record.error !== null
+            ? { error: record.error instanceof Error ? record.error.message : String(record.error) }
+            : {}),
+        children: record.children.map(recordToJSON),
+    };
+}
+/**
+ * Write one JSON line per finished top-level call (the whole tree).
+ * Defaults to stdout in Node and console.log elsewhere.
+ */
+export function jsonLinesExporter(write) {
+    const out = write !== null && write !== void 0 ? write : ((line) => {
+        const proc = typeof process !== 'undefined' ? process : undefined;
+        if (proc && proc.stdout && typeof proc.stdout.write === 'function')
+            proc.stdout.write(line + '\n');
+        else
+            console.log(line);
+    });
+    return {
+        name: 'json-lines',
+        onComplete(root) {
+            out(JSON.stringify(recordToJSON(root)));
+        },
+    };
+}
+//# sourceMappingURL=exporters.js.map

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

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

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

@@ -1,4 +1,10 @@
-export * from './config';
-export * from './constants';
-export * from './logger';
-export * from './optimized-performance-monitor';
+export * from './optimized-performance-monitor.js';
+export * from './records.js';
+export * from './stats.js';
+export * from './exporters.js';
+export * from './event-loop.js';
+export * from './timeline.js';
+export * from './prometheus.js';
+export * from './allocations.js';
+export * from './explain.js';
+export * from './cpu-profile.js';

package/dist/esm/core/index.js

@@ -1,5 +1,11 @@
-export * from './config';
-export * from './constants';
-export * from './logger';
-export * from './optimized-performance-monitor';
+export * from './optimized-performance-monitor.js';
+export * from './records.js';
+export * from './stats.js';
+export * from './exporters.js';
+export * from './event-loop.js';
+export * from './timeline.js';
+export * from './prometheus.js';
+export * from './allocations.js';
+export * from './explain.js';
+export * from './cpu-profile.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}