perfgraph 0.1.0

package/dist/normalize/trace-ir.js

@@ -0,0 +1,224 @@
+/**
+ * PerformanceIR builder from trace and performance raw data.
+ *
+ * Converts CDP trace events and performance metrics into a normalized
+ * PerformanceIR structure with all timestamps in ms relative to
+ * navigationStart.
+ */
+import { toRelativeMs } from './clock.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Runtime type guard: check if value is a number */
+function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+/** Safely access a nested property from trace event args */
+function getArg(args, path) {
+    let current = args;
+    for (const key of path) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/** Trace event names the PerformanceIR builder cares about */
+const EVENT_NAMES = new Set([
+    'firstContentfulPaint',
+    'LargestContentfulPaint::Candidate',
+    'MarkDOMContent',
+    'MarkLoad',
+    'LayoutShift',
+    'LongTask',
+]);
+// ---------------------------------------------------------------------------
+// Navigation builder
+// ---------------------------------------------------------------------------
+/**
+ * Build the PerformanceNavigation part from trace events.
+ *
+ * MarkDOMContent → domContentLoaded
+ * MarkLoad → loadEventStart
+ */
+function buildNavigation(events, anchor) {
+    let domContentLoaded = 0;
+    let loadEventStart = 0;
+    for (const ev of events) {
+        if (ev.name === 'MarkDOMContent') {
+            domContentLoaded = toRelativeMs(ev.ts, 'cdp-monotonic-us', anchor);
+        }
+        if (ev.name === 'MarkLoad') {
+            loadEventStart = toRelativeMs(ev.ts, 'cdp-monotonic-us', anchor);
+        }
+    }
+    return {
+        url: '',
+        navigationStart: 0,
+        domContentLoaded,
+        domContentLoadedEventEnd: domContentLoaded,
+        loadEventStart,
+        loadEventEnd: loadEventStart,
+        domInteractive: domContentLoaded,
+    };
+}
+// ---------------------------------------------------------------------------
+// Core Web Vitals builder
+// ---------------------------------------------------------------------------
+/**
+ * Build CoreWebVitals from trace events.
+ *
+ * - FCP: firstContentfulPaint trace event ts → relative ms
+ * - LCP: LargestContentfulPaint::Candidate trace event ts → relative ms
+ * - CLS: sum of LayoutShift events args.data.cumulative_score
+ * - TBT: sum of (LongTask event dur - 50) in ms
+ */
+function buildCoreWebVitals(events, anchor) {
+    let fcp;
+    let lcp;
+    let cls = 0;
+    let tbt = 0;
+    for (const ev of events) {
+        switch (ev.name) {
+            case 'firstContentfulPaint': {
+                fcp = toRelativeMs(ev.ts, 'cdp-monotonic-us', anchor);
+                break;
+            }
+            case 'LargestContentfulPaint::Candidate': {
+                lcp = toRelativeMs(ev.ts, 'cdp-monotonic-us', anchor);
+                break;
+            }
+            case 'LayoutShift': {
+                const score = getArg(ev.args, ['data', 'cumulative_score']);
+                if (isNumber(score)) {
+                    cls += score;
+                }
+                break;
+            }
+            case 'LongTask': {
+                const dur = ev.dur;
+                if (isNumber(dur)) {
+                    const blocking = dur - 50; // tasks over 50ms are "long"
+                    if (blocking > 0) {
+                        tbt += blocking / 1000; // dur is in microseconds, convert to ms
+                    }
+                }
+                break;
+            }
+        }
+    }
+    return {
+        fcp: fcp ?? undefined,
+        lcp: lcp ?? undefined,
+        cls: cls > 0 ? cls : undefined,
+        tbt: tbt > 0 ? tbt : undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// Trace summary builder
+// ---------------------------------------------------------------------------
+/**
+ * Build TraceSummary from all trace events.
+ *
+ * - totalDuration: difference between last and first event timestamps
+ *   (converted to relative ms)
+ * - eventCount: total events
+ * - categories: count of events per top-level category
+ *   (cat field split by "," — take the first segment)
+ * - threadActivity: per-tid duration sums + main thread identification
+ */
+function buildTraceSummary(events, anchor) {
+    if (events.length === 0) {
+        return {
+            totalDuration: 0,
+            eventCount: 0,
+            categories: {},
+            threadActivity: { totalMs: 0, byCategory: {} },
+        };
+    }
+    const firstTs = events[0]?.ts ?? 0;
+    const lastTs = events[events.length - 1]?.ts ?? 0;
+    const totalDuration = toRelativeMs(lastTs, 'cdp-monotonic-us', anchor) - toRelativeMs(firstTs, 'cdp-monotonic-us', anchor);
+    // Count events per top-level category
+    const categories = {};
+    for (const ev of events) {
+        const topCat = ev.cat.split(',')[0] ?? 'unknown';
+        categories[topCat] = (categories[topCat] ?? 0) + 1;
+    }
+    // Group by thread ID, sum durations
+    const threadDurations = new Map();
+    for (const ev of events) {
+        if (isNumber(ev.dur)) {
+            const tid = ev.tid;
+            const currentDur = threadDurations.get(tid) ?? 0;
+            threadDurations.set(tid, currentDur + ev.dur);
+        }
+    }
+    // Identify main thread: the one with the most events
+    const threadCounts = new Map();
+    for (const ev of events) {
+        threadCounts.set(ev.tid, (threadCounts.get(ev.tid) ?? 0) + 1);
+    }
+    let mainTid = 0;
+    let maxCount = 0;
+    for (const [tid, count] of threadCounts) {
+        if (count > maxCount) {
+            mainTid = tid;
+            maxCount = count;
+        }
+    }
+    // Per-category thread activity (on main thread only)
+    const byCategory = {};
+    for (const ev of events) {
+        if (ev.tid === mainTid && isNumber(ev.dur)) {
+            const topCat = ev.cat.split(',')[0] ?? 'unknown';
+            byCategory[topCat] = (byCategory[topCat] ?? 0) + ev.dur / 1000;
+        }
+    }
+    const mainThreadTotalMs = (threadDurations.get(mainTid) ?? 0) / 1000;
+    return {
+        totalDuration: Math.max(0, totalDuration),
+        eventCount: events.length,
+        categories,
+        threadActivity: {
+            totalMs: mainThreadTotalMs,
+            byCategory,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Main builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a complete PerformanceIR from trace and performance raw data.
+ *
+ * @param trace - Raw trace events from the TraceCollector
+ * @param perf  - Raw performance metrics from the PerformanceCollector
+ * @param anchor - ClockAnchor with navigationStart time
+ * @returns A fully-constructed PerformanceIR
+ */
+export function buildPerformanceIR(trace, perf, anchor) {
+    const events = trace.events ?? [];
+    const eventCount = events.length;
+    // Extract performance metrics as a lookup map
+    const metrics = new Map();
+    for (const m of perf.metrics ?? []) {
+        metrics.set(m.name, m.value);
+    }
+    const navigation = buildNavigation(events, anchor);
+    const coreWebVitals = buildCoreWebVitals(events, anchor);
+    const traceSummary = buildTraceSummary(events, anchor);
+    // mainThreadBusyness = main thread activity / total trace duration
+    const mainThreadBusyness = traceSummary.totalDuration > 0 && traceSummary.threadActivity.totalMs > 0
+        ? Math.min(1, traceSummary.threadActivity.totalMs / traceSummary.totalDuration)
+        : 0;
+    const result = {
+        navigation,
+        coreWebVitals,
+        traceSummary,
+        mainThreadBusyness,
+    };
+    return result;
+}
+//# sourceMappingURL=trace-ir.js.map

package/dist/normalize/trace-ir.js.map

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