nuxt-devtools-observatory 0.1.28 → 0.1.31

package/dist/runtime/composables/render-registry.js

@@ -1,14 +1,14 @@
 import { useRuntimeConfig } from "#app";
+import { traceStore } from "../tracing/traceStore.js";
 export function setupRenderRegistry(nuxtApp, options = {}) {
   const entries = /* @__PURE__ */ new Map();
-  const pendingTriggeredRenders = /* @__PURE__ */ new Set();
-  const renderStartTimes = /* @__PURE__ */ new Map();
   let currentRoute = "/";
   const config = useRuntimeConfig().public.observatory;
   const MAX_TIMELINE = config.maxRenderTimeline ?? 100;
   const HIDE_INTERNALS = config.heatmapHideInternals ?? false;
   let dirty = true;
   let cachedSnapshot = "[]";
+  const liveElements = /* @__PURE__ */ new Map();
   function markDirty() {
     dirty = true;
   }
@@ -41,81 +41,26 @@ export function setupRenderRegistry(nuxtApp, options = {}) {
     }
     return entries.get(uid);
   }
-  const dirtyRects = /* @__PURE__ */ new Set();
-  function markRectDirty(uid) {
-    dirtyRects.add(uid);
-    markDirty();
-  }
-  function flushDirtyRects() {
-    if (dirtyRects.size === 0) {
+  function refreshEntryRect(uid) {
+    const entry = entries.get(uid);
+    if (!entry) {
       return;
     }
-    for (const uid of dirtyRects) {
-      const entry = entries.get(uid);
-      if (!entry) {
-        dirtyRects.delete(uid);
-        continue;
-      }
-      const el = _liveElements.get(uid);
-      if (!el) {
-        dirtyRects.delete(uid);
-        continue;
-      }
-      const rect = el.getBoundingClientRect?.();
-      entry.rect = rect ? {
-        x: Math.round(rect.x),
-        y: Math.round(rect.y),
-        width: Math.round(rect.width),
-        height: Math.round(rect.height),
-        top: Math.round(rect.top),
-        left: Math.round(rect.left)
-      } : void 0;
-      dirtyRects.delete(uid);
-    }
-  }
-  const _liveElements = /* @__PURE__ */ new Map();
-  function removeEntry(instance) {
-    const uid = instance.$.uid;
-    entries.delete(uid);
-    markDirty();
-  }
-  function startRenderTimer(uid) {
-    if (typeof performance === "undefined") {
-      return;
-    }
-    renderStartTimes.set(uid, performance.now());
-  }
-  function recordRenderDuration(entry, kind) {
-    if (typeof performance === "undefined") {
+    const el = liveElements.get(uid);
+    if (!el?.getBoundingClientRect) {
       return;
     }
-    const startedAt = renderStartTimes.get(entry.uid);
-    if (startedAt === void 0) {
-      return;
-    }
-    renderStartTimes.delete(entry.uid);
-    const durationMs = Math.max(performance.now() - startedAt, 0);
-    entry.totalMs += durationMs;
-    const totalEvents = (entry.rerenders ?? 0) + Math.max(entry.mountCount, 1);
-    entry.avgMs = Math.round(entry.totalMs / totalEvents * 10) / 10;
-    const lastTrigger = entry.triggers.length > 0 ? entry.triggers[entry.triggers.length - 1] : void 0;
-    const event = {
-      kind,
-      t: startedAt,
-      durationMs: Math.round(durationMs * 10) / 10,
-      triggerKey: kind === "update" && lastTrigger ? `${lastTrigger.type}: ${lastTrigger.key}` : void 0,
-      route: currentRoute
+    const rect = el.getBoundingClientRect();
+    entry.rect = {
+      x: Math.round(rect.x),
+      y: Math.round(rect.y),
+      width: Math.round(rect.width),
+      height: Math.round(rect.height),
+      top: Math.round(rect.top),
+      left: Math.round(rect.left)
     };
-    entry.timeline.push(event);
-    if (entry.timeline.length > MAX_TIMELINE) {
-      entry.timeline.shift();
-    }
-    markDirty();
   }
   function reset() {
-    pendingTriggeredRenders.clear();
-    renderStartTimes.clear();
-    dirtyRects.clear();
     for (const entry of entries.values()) {
       entry.isPersistent = true;
       entry.rerenders = 0;
@@ -126,65 +71,76 @@ export function setupRenderRegistry(nuxtApp, options = {}) {
     }
     markDirty();
   }
+  function aggregateFromComponentSpans() {
+    const componentSpans = traceStore.getAllTraces().flatMap((trace) => trace.spans).filter((span) => span.type === "component");
+    const spansByUid = /* @__PURE__ */ new Map();
+    for (const span of componentSpans) {
+      const uidValue = span.metadata?.uid;
+      const uid = typeof uidValue === "number" ? uidValue : Number(uidValue);
+      if (!Number.isFinite(uid)) {
+        continue;
+      }
+      const list = spansByUid.get(uid) ?? [];
+      list.push(span);
+      spansByUid.set(uid, list);
+    }
+    for (const [uid, entry] of entries.entries()) {
+      const spans = spansByUid.get(uid) ?? [];
+      spans.sort((a, b) => a.startTime - b.startTime);
+      const timeline = spans.slice(-MAX_TIMELINE).map((span) => {
+        const lifecycle = span.metadata?.lifecycle === "mounted" ? "mount" : "update";
+        const routeValue = span.metadata?.route;
+        const route = typeof routeValue === "string" && routeValue.length > 0 ? routeValue : entry.route;
+        return {
+          kind: lifecycle,
+          t: span.startTime,
+          durationMs: Math.round((span.durationMs ?? 0) * 10) / 10,
+          route
+        };
+      });
+      const mountCount = spans.filter((span) => span.metadata?.lifecycle === "mounted").length;
+      const rerenders = spans.filter((span) => span.metadata?.lifecycle !== "mounted").length;
+      const totalMs = spans.reduce((sum, span) => sum + (span.durationMs ?? 0), 0);
+      const eventsCount = Math.max(mountCount + rerenders, 1);
+      entry.mountCount = mountCount;
+      entry.rerenders = rerenders;
+      entry.totalMs = Math.round(totalMs * 10) / 10;
+      entry.avgMs = Math.round(totalMs / eventsCount * 10) / 10;
+      entry.timeline = timeline;
+      entry.triggers = [];
+      refreshEntryRect(uid);
+    }
+  }
   nuxtApp.vueApp.mixin({
-    beforeMount() {
-      startRenderTimer(this.$.uid);
-    },
     mounted() {
       const entry = ensureEntry(this);
       if (!entry) {
         return;
       }
-      entry.mountCount++;
       const isHydration = options.isHydrating?.() ?? false;
-      if (isHydration && entry.mountCount === 1) {
+      if (isHydration && entry.mountCount === 0) {
         entry.isHydrationMount = true;
-      } else if (entry.mountCount > 1) {
-        entry.rerenders++;
-      }
-      _liveElements.set(entry.uid, this.$el);
-      markRectDirty(entry.uid);
-      if (!entry.isPersistent || entry.mountCount === 1) {
-        recordRenderDuration(entry, "mount");
-      } else {
-        renderStartTimes.delete(entry.uid);
       }
+      liveElements.set(entry.uid, this.$el);
+      refreshEntryRect(entry.uid);
       markDirty();
       emit("render:update", { uid: entry.uid, renders: entry.rerenders });
     },
-    beforeUpdate() {
-      startRenderTimer(this.$.uid);
-    },
-    renderTriggered({ key, type }) {
-      const entry = ensureEntry(this);
-      if (!entry) {
-        return;
-      }
-      entry.triggers.push({ key: String(key), type, timestamp: performance.now() });
-      pendingTriggeredRenders.add(entry.uid);
-      if (entry.triggers.length > 50) {
-        entry.triggers.shift();
-      }
-      markDirty();
-    },
     updated() {
       const entry = ensureEntry(this);
       if (!entry) {
         return;
       }
-      pendingTriggeredRenders.delete(entry.uid);
-      entry.rerenders++;
-      markRectDirty(entry.uid);
-      recordRenderDuration(entry, "update");
+      liveElements.set(entry.uid, this.$el);
+      refreshEntryRect(entry.uid);
       emit("render:update", { uid: entry.uid, renders: entry.rerenders });
+      markDirty();
     },
     unmounted() {
       const uid = this.$.uid;
-      pendingTriggeredRenders.delete(uid);
-      renderStartTimes.delete(uid);
-      dirtyRects.delete(uid);
-      _liveElements.delete(uid);
-      removeEntry(this);
+      liveElements.delete(uid);
+      entries.delete(uid);
+      markDirty();
       emit("render:remove", { uid });
     }
   });
@@ -215,14 +171,14 @@ export function setupRenderRegistry(nuxtApp, options = {}) {
     };
   }
   function getAll() {
-    flushDirtyRects();
+    aggregateFromComponentSpans();
     return [...entries.values()].map(sanitize);
   }
   function getSnapshot() {
     if (!dirty) {
       return cachedSnapshot;
     }
-    flushDirtyRects();
+    aggregateFromComponentSpans();
     try {
       cachedSnapshot = JSON.stringify([...entries.values()].map(sanitize)) ?? "[]";
     } catch {

package/dist/runtime/composables/transition-registry.js

@@ -1,65 +1,140 @@
 import { h, defineComponent, getCurrentInstance, onUnmounted, Transition as VueTransition } from "vue";
+import { startSpan } from "../tracing/tracing.js";
+import { traceStore } from "../tracing/traceStore.js";
 const MAX_TRANSITIONS = typeof process !== "undefined" && process.env.OBSERVATORY_MAX_TRANSITIONS ? Number(process.env.OBSERVATORY_MAX_TRANSITIONS) : 500;
 export function setupTransitionRegistry() {
-  const entries = /* @__PURE__ */ new Map();
+  const activeSpans = /* @__PURE__ */ new Map();
+  const entryState = /* @__PURE__ */ new Map();
   let dirty = true;
   let cachedSnapshot = "[]";
   function markDirty() {
     dirty = true;
   }
   function register(entry) {
-    if (entries.size >= MAX_TRANSITIONS) {
-      const oldestKey = entries.keys().next().value;
-      if (oldestKey !== void 0) {
-        entries.delete(oldestKey);
-      }
-    }
-    entries.set(entry.id, entry);
+    const spanHandle = startSpan({
+      name: `transition:${entry.transitionName}`,
+      type: "transition",
+      metadata: {
+        id: entry.id,
+        transitionName: entry.transitionName,
+        parentComponent: entry.parentComponent,
+        direction: entry.direction,
+        phase: entry.phase,
+        cancelled: entry.cancelled,
+        appear: entry.appear,
+        mode: entry.mode
+      },
+      startTime: entry.startTime
+    });
+    activeSpans.set(entry.id, spanHandle);
+    entryState.set(entry.id, {
+      id: entry.id,
+      transitionName: entry.transitionName,
+      parentComponent: entry.parentComponent,
+      direction: entry.direction,
+      phase: entry.phase,
+      startTime: entry.startTime,
+      endTime: entry.endTime,
+      cancelled: entry.cancelled,
+      appear: entry.appear,
+      mode: entry.mode
+    });
     markDirty();
     emit("transition:register", entry);
   }
   function clear() {
-    entries.clear();
+    activeSpans.clear();
+    entryState.clear();
     markDirty();
     emit("transition:clear", {});
   }
   function update(id, patch) {
-    const existing = entries.get(id);
+    const existing = entryState.get(id);
     if (!existing) {
       return;
     }
     const updated = { ...existing, ...patch };
-    if (patch.endTime !== void 0) {
-      updated.durationMs = Math.round((patch.endTime - existing.startTime) * 10) / 10;
+    entryState.set(id, updated);
+    const active = activeSpans.get(id);
+    if (active) {
+      active.span.metadata = {
+        ...active.span.metadata ?? {},
+        id: updated.id,
+        transitionName: updated.transitionName,
+        parentComponent: updated.parentComponent,
+        direction: updated.direction,
+        phase: updated.phase,
+        cancelled: updated.cancelled,
+        appear: updated.appear,
+        mode: updated.mode
+      };
+      if (patch.endTime !== void 0) {
+        active.end({
+          endTime: patch.endTime,
+          status: patch.cancelled === true ? "cancelled" : "ok",
+          metadata: {
+            phase: updated.phase,
+            cancelled: updated.cancelled
+          }
+        });
+        activeSpans.delete(id);
+      }
     }
-    entries.set(id, updated);
     markDirty();
-    emit("transition:update", updated);
+    emit("transition:update", toTransitionEntry(updated, active?.span));
   }
-  function sanitize(entry) {
+  function toTransitionEntry(base, span) {
+    const durationMs = span?.durationMs ?? (base.endTime !== void 0 ? Math.round((base.endTime - base.startTime) * 10) / 10 : void 0);
     return {
-      id: entry.id,
-      transitionName: entry.transitionName,
-      parentComponent: entry.parentComponent,
-      direction: entry.direction,
-      phase: entry.phase,
-      startTime: entry.startTime,
-      endTime: entry.endTime,
-      durationMs: entry.durationMs,
-      cancelled: entry.cancelled,
-      appear: entry.appear,
-      mode: entry.mode
+      id: base.id,
+      transitionName: base.transitionName,
+      parentComponent: base.parentComponent,
+      direction: base.direction,
+      phase: base.phase,
+      startTime: base.startTime,
+      endTime: base.endTime,
+      durationMs,
+      cancelled: base.cancelled,
+      appear: base.appear,
+      mode: base.mode
     };
   }
   function getAll() {
-    return [...entries.values()].map(sanitize);
+    const spans = traceStore.getAllTraces().flatMap((trace) => trace.spans).filter((span) => span.type === "transition").sort((a, b) => a.startTime - b.startTime);
+    const entries = spans.map((span) => {
+      const metadata = span.metadata ?? {};
+      const id = typeof metadata.id === "string" ? metadata.id : span.id;
+      const transitionName = typeof metadata.transitionName === "string" ? metadata.transitionName : "default";
+      const parentComponent = typeof metadata.parentComponent === "string" ? metadata.parentComponent : "unknown";
+      const direction = metadata.direction === "leave" ? "leave" : "enter";
+      const knownPhase = metadata.phase;
+      const phase = knownPhase === "entering" || knownPhase === "entered" || knownPhase === "leaving" || knownPhase === "left" || knownPhase === "enter-cancelled" || knownPhase === "leave-cancelled" || knownPhase === "interrupted" ? knownPhase : span.endTime ? direction === "enter" ? "entered" : "left" : direction === "enter" ? "entering" : "leaving";
+      return {
+        id,
+        transitionName,
+        parentComponent,
+        direction,
+        phase,
+        startTime: span.startTime,
+        endTime: span.endTime,
+        durationMs: span.durationMs,
+        cancelled: metadata.cancelled === true || span.status === "cancelled",
+        appear: metadata.appear === true,
+        mode: typeof metadata.mode === "string" ? metadata.mode : void 0
+      };
+    });
+    const overflow = entries.length - MAX_TRANSITIONS;
+    if (overflow > 0) {
+      return entries.slice(overflow);
+    }
+    return entries;
   }
   function getSnapshot() {
     if (!dirty) {
       return cachedSnapshot;
     }
     try {
-      cachedSnapshot = JSON.stringify([...entries.values()].map(sanitize)) ?? "[]";
+      cachedSnapshot = JSON.stringify(getAll()) ?? "[]";
     } catch {
       cachedSnapshot = "[]";
     }

package/dist/runtime/instrumentation/asyncData.d.ts

@@ -0,0 +1,9 @@
+interface AsyncDataMeta {
+    key: string;
+    file: string;
+    line: number;
+    originalFn?: string;
+}
+type AnyFn = (...args: any[]) => any;
+export declare function useTracedAsyncData<TFn extends AnyFn>(originalFn: TFn, args: unknown[], handlerIndex: number, key: unknown, meta: AsyncDataMeta): ReturnType<TFn>;
+export {};

package/dist/runtime/instrumentation/asyncData.js

@@ -0,0 +1,49 @@
+import { startSpan } from "../tracing/tracing.js";
+function getNormalizedKey(key) {
+  return typeof key === "string" && key.length > 0 ? key : "useAsyncData";
+}
+export function useTracedAsyncData(originalFn, args, handlerIndex, key, meta) {
+  if (!import.meta.dev || !import.meta.client) {
+    return originalFn(...args);
+  }
+  const nextArgs = [...args];
+  const originalHandler = nextArgs[handlerIndex];
+  if (typeof originalHandler !== "function") {
+    return originalFn(...args);
+  }
+  const normalizedKey = getNormalizedKey(key);
+  nextArgs[handlerIndex] = (...handlerArgs) => {
+    const span = startSpan({
+      name: meta.originalFn ?? "useAsyncData",
+      type: "fetch",
+      metadata: {
+        key: normalizedKey,
+        status: "pending",
+        file: meta.file,
+        line: meta.line,
+        source: "async-data"
+      }
+    });
+    return Promise.resolve(originalHandler(...handlerArgs)).then((result) => {
+      span.end({
+        status: "ok",
+        metadata: {
+          key: normalizedKey,
+          status: "ok"
+        }
+      });
+      return result;
+    }).catch((error) => {
+      span.end({
+        status: "error",
+        metadata: {
+          key: normalizedKey,
+          status: "error",
+          errorMessage: error instanceof Error ? error.message : String(error)
+        }
+      });
+      throw error;
+    });
+  };
+  return originalFn(...nextArgs);
+}

package/dist/runtime/instrumentation/component.d.ts

@@ -0,0 +1,2 @@
+import type { NuxtApp } from '#app';
+export declare function setupComponentInstrumentation(nuxtApp: NuxtApp): void;

package/dist/runtime/instrumentation/component.js

@@ -0,0 +1,126 @@
+import { startSpan } from "../tracing/tracing.js";
+const instrumentedApps = /* @__PURE__ */ new WeakSet();
+const renderStartTimes = /* @__PURE__ */ new WeakMap();
+function getComponentFile(instance) {
+  return instance.$.type.__file;
+}
+function getComponentName(instance) {
+  const type = instance.$.type;
+  if (type.__name && type.__name.length > 0) {
+    return type.__name;
+  }
+  if (type.name && type.name.length > 0) {
+    return type.name;
+  }
+  if (type.__file) {
+    const fileName = type.__file.split("/").pop() ?? type.__file;
+    return fileName.replace(/\.[^.]+$/, "");
+  }
+  return "AnonymousComponent";
+}
+function shouldTrack(instance) {
+  const file = getComponentFile(instance);
+  if (!file) {
+    return false;
+  }
+  return !file.includes("node_modules");
+}
+function trackLifecycle(instance, lifecycle) {
+  if (!shouldTrack(instance)) {
+    return;
+  }
+  const componentName = getComponentName(instance);
+  const file = getComponentFile(instance);
+  const uid = instance.$.uid;
+  const route = typeof window !== "undefined" ? window.location.pathname : "/";
+  const span = startSpan({
+    name: `component:${lifecycle}`,
+    type: "component",
+    metadata: {
+      lifecycle,
+      componentName,
+      uid,
+      file,
+      route,
+      status: "ok"
+    }
+  });
+  span.end({
+    status: "ok",
+    metadata: {
+      lifecycle,
+      componentName,
+      uid,
+      file,
+      route,
+      status: "ok"
+    }
+  });
+}
+function trackRender(instance, phase, startTime, endTime) {
+  if (!shouldTrack(instance)) {
+    return;
+  }
+  const componentName = getComponentName(instance);
+  const file = getComponentFile(instance);
+  const uid = instance.$.uid;
+  const route = typeof window !== "undefined" ? window.location.pathname : "/";
+  const span = startSpan({
+    name: "component:render",
+    type: "render",
+    startTime,
+    metadata: {
+      lifecycle: `render:${phase}`,
+      componentName,
+      uid,
+      file,
+      route
+    }
+  });
+  span.end({
+    endTime,
+    status: "ok",
+    metadata: {
+      lifecycle: `render:${phase}`,
+      componentName,
+      uid,
+      file,
+      route
+    }
+  });
+}
+export function setupComponentInstrumentation(nuxtApp) {
+  const app = nuxtApp.vueApp;
+  if (instrumentedApps.has(app)) {
+    return;
+  }
+  instrumentedApps.add(app);
+  app.mixin({
+    beforeMount() {
+      if (shouldTrack(this)) {
+        renderStartTimes.set(this, performance.now());
+      }
+    },
+    mounted() {
+      const startTime = renderStartTimes.get(this);
+      renderStartTimes.delete(this);
+      if (startTime !== void 0) {
+        trackRender(this, "mount", startTime, performance.now());
+      }
+      trackLifecycle(this, "mounted");
+    },
+    beforeUpdate() {
+      if (shouldTrack(this)) {
+        renderStartTimes.set(this, performance.now());
+      }
+    },
+    updated() {
+      const startTime = renderStartTimes.get(this);
+      renderStartTimes.delete(this);
+      if (startTime !== void 0) {
+        trackRender(this, "update", startTime, performance.now());
+      }
+      trackLifecycle(this, "updated");
+    }
+  });
+}

package/dist/runtime/instrumentation/fetch.d.ts

@@ -0,0 +1,2 @@
+import type { NuxtApp } from '#app';
+export declare function setupFetchInstrumentation(nuxtApp: NuxtApp): void;

package/dist/runtime/instrumentation/fetch.js

@@ -0,0 +1,89 @@
+import { startSpan } from "../tracing/tracing.js";
+function resolveUrl(input) {
+  if (typeof input === "string") {
+    return input;
+  }
+  if (input && typeof input === "object" && "url" in input) {
+    const maybeUrl = input.url;
+    return typeof maybeUrl === "string" ? maybeUrl : String(maybeUrl ?? "");
+  }
+  return String(input ?? "");
+}
+function resolveMethod(input, options) {
+  const method = options?.method;
+  if (typeof method === "string" && method.length > 0) {
+    return method.toUpperCase();
+  }
+  if (input && typeof input === "object" && "method" in input) {
+    const requestMethod = input.method;
+    if (typeof requestMethod === "string" && requestMethod.length > 0) {
+      return requestMethod.toUpperCase();
+    }
+  }
+  return "GET";
+}
+function resolveErrorStatus(error) {
+  const target = error;
+  return target?.response?.status ?? target?.statusCode ?? target?.status;
+}
+const WRAPPED_FETCH_FLAG = "__observatory_wrapped_fetch__";
+export function setupFetchInstrumentation(nuxtApp) {
+  const original = nuxtApp.$fetch;
+  if (!original) {
+    return;
+  }
+  if (original[WRAPPED_FETCH_FLAG]) {
+    return;
+  }
+  const wrapped = ((request, options) => {
+    const url = resolveUrl(request);
+    const method = resolveMethod(request, options);
+    const startedAt = performance.now();
+    const span = startSpan({
+      name: "$fetch",
+      type: "fetch",
+      metadata: {
+        source: "$fetch",
+        url,
+        method,
+        status: "pending"
+      }
+    });
+    return Promise.resolve(original(request, options)).then((result) => {
+      const durationMs = Math.max(performance.now() - startedAt, 0);
+      span.end({
+        status: "ok",
+        metadata: {
+          source: "$fetch",
+          url,
+          method,
+          status: "ok",
+          durationMs: Math.round(durationMs * 10) / 10
+        }
+      });
+      return result;
+    }).catch((error) => {
+      const durationMs = Math.max(performance.now() - startedAt, 0);
+      const statusCode = resolveErrorStatus(error);
+      span.end({
+        status: "error",
+        metadata: {
+          source: "$fetch",
+          url,
+          method,
+          status: "error",
+          statusCode,
+          durationMs: Math.round(durationMs * 10) / 10
+        }
+      });
+      throw error;
+    });
+  });
+  Object.assign(wrapped, original);
+  wrapped[WRAPPED_FETCH_FLAG] = true;
+  nuxtApp.$fetch = wrapped;
+  const globalTarget = globalThis;
+  if (typeof globalTarget.$fetch === "function") {
+    globalTarget.$fetch = wrapped;
+  }
+}