@flotrace/runtime 2.0.0 → 2.2.1

package/dist/index.js

@@ -579,6 +579,19 @@ function safeTrackerOp(name, op) {
     console.error(`[FloTrace] ${name}:`, error);
   }
 }
+function deriveWebAppName() {
+  if (typeof document !== "undefined") {
+    const metaName = document.querySelector('meta[name="application-name"]')?.getAttribute("content")?.trim();
+    if (metaName) return metaName;
+    const title = document.title?.trim();
+    if (title) return title;
+  }
+  if (typeof location !== "undefined" && location.hostname) return location.hostname;
+  return import_runtime_core3.DEFAULT_CONFIG.appName;
+}
+function deriveWebAppId() {
+  return typeof location !== "undefined" && location.origin ? location.origin : "web-app";
+}
 var FloTraceContext = (0, import_react.createContext)(null);
 function useFloTrace() {
   return (0, import_react.useContext)(FloTraceContext);
@@ -590,13 +603,20 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
     );
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
   }
+  const framework = (0, import_runtime_core3.detectWebFramework)();
   const mergedConfig = {
     ...import_runtime_core3.DEFAULT_CONFIG,
     // Web default: expose the current page URL as the `appUrl` in runtime:ready.
     // Runtime-core defaults this to undefined so it stays platform-agnostic.
     getAppUrl: () => typeof window !== "undefined" ? window.location.href : void 0,
     platform: "web",
-    ...config
+    ...config,
+    // Derived values fill in only when the user didn't supply a static one.
+    // Placed AFTER `...config` so explicit user values still win via `??`.
+    appName: config.appName ?? deriveWebAppName(),
+    appId: config.appId ?? deriveWebAppId(),
+    frameworkName: config.frameworkName ?? framework.frameworkName,
+    frameworkVersion: config.frameworkVersion ?? framework.frameworkVersion
   };
   const [connected, setConnected] = import_react.default.useState(false);
   const trackingOptionsRef = (0, import_react.useRef)({});
@@ -631,8 +651,12 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
     const unsubMessage = client3.onMessage((message) => {
       try {
         switch (message.type) {
+          // Heartbeat liveness is handled by the dedicated `runtime:pong` path
+          // in websocketClient. We intentionally do NOT re-send `runtime:ready`
+          // on every `ext:ping` — a truncated ready (only appName, no appId /
+          // platform / versions) would clobber the server's client registry
+          // metadata on every 5s tick. The initial `onopen` ready is authoritative.
           case "ext:ping":
-            client3.sendImmediate({ type: "runtime:ready", appName: mergedConfig.appName });
             break;
           case "ext:startTracking":
             trackingOptionsRef.current = message.options || {};
@@ -730,6 +754,37 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
             }
             break;
           }
+          // Value Lineage — resolve the origin chain for a prop or hook value.
+          case "ext:traceValue": {
+            try {
+              const trace = (0, import_runtime_core3.resolveValueTrace)({
+                nodeId: message.nodeId,
+                propPath: message.propPath,
+                hookPath: message.hookPath
+              });
+              client3.sendImmediate({
+                type: "runtime:valueTrace",
+                trace: { requestId: message.requestId, ...trace },
+                timestamp: Date.now()
+              });
+            } catch (error) {
+              console.error("[FloTrace] resolveValueTrace threw:", error);
+              client3.sendImmediate({
+                type: "runtime:valueTrace",
+                trace: {
+                  requestId: message.requestId,
+                  rootNodeId: message.nodeId,
+                  rootPropPath: message.propPath,
+                  rootHookPath: message.hookPath,
+                  steps: [],
+                  resolvedAtMs: Date.now(),
+                  error: "value-not-found"
+                },
+                timestamp: Date.now()
+              });
+            }
+            break;
+          }
           case "ext:startNetworkCapture":
             safeTrackerOp("Network capture start", () => installNetworkTracker(client3));
             break;

package/dist/index.mjs

@@ -25,7 +25,9 @@ import {
   uninstallTanStackQueryTracker,
   installTimelineTracker,
   uninstallTimelineTracker,
-  getTimeline
+  getTimeline,
+  detectWebFramework,
+  resolveValueTrace
 } from "@flotrace/runtime-core";
 
 // src/routerTracker.ts
@@ -566,6 +568,19 @@ function safeTrackerOp(name, op) {
     console.error(`[FloTrace] ${name}:`, error);
   }
 }
+function deriveWebAppName() {
+  if (typeof document !== "undefined") {
+    const metaName = document.querySelector('meta[name="application-name"]')?.getAttribute("content")?.trim();
+    if (metaName) return metaName;
+    const title = document.title?.trim();
+    if (title) return title;
+  }
+  if (typeof location !== "undefined" && location.hostname) return location.hostname;
+  return DEFAULT_CONFIG.appName;
+}
+function deriveWebAppId() {
+  return typeof location !== "undefined" && location.origin ? location.origin : "web-app";
+}
 var FloTraceContext = createContext(null);
 function useFloTrace() {
   return useContext(FloTraceContext);
@@ -577,13 +592,20 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
     );
     return /* @__PURE__ */ jsx(Fragment, { children });
   }
+  const framework = detectWebFramework();
   const mergedConfig = {
     ...DEFAULT_CONFIG,
     // Web default: expose the current page URL as the `appUrl` in runtime:ready.
     // Runtime-core defaults this to undefined so it stays platform-agnostic.
     getAppUrl: () => typeof window !== "undefined" ? window.location.href : void 0,
     platform: "web",
-    ...config
+    ...config,
+    // Derived values fill in only when the user didn't supply a static one.
+    // Placed AFTER `...config` so explicit user values still win via `??`.
+    appName: config.appName ?? deriveWebAppName(),
+    appId: config.appId ?? deriveWebAppId(),
+    frameworkName: config.frameworkName ?? framework.frameworkName,
+    frameworkVersion: config.frameworkVersion ?? framework.frameworkVersion
   };
   const [connected, setConnected] = React.useState(false);
   const trackingOptionsRef = useRef({});
@@ -618,8 +640,12 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
     const unsubMessage = client3.onMessage((message) => {
       try {
         switch (message.type) {
+          // Heartbeat liveness is handled by the dedicated `runtime:pong` path
+          // in websocketClient. We intentionally do NOT re-send `runtime:ready`
+          // on every `ext:ping` — a truncated ready (only appName, no appId /
+          // platform / versions) would clobber the server's client registry
+          // metadata on every 5s tick. The initial `onopen` ready is authoritative.
           case "ext:ping":
-            client3.sendImmediate({ type: "runtime:ready", appName: mergedConfig.appName });
             break;
           case "ext:startTracking":
             trackingOptionsRef.current = message.options || {};
@@ -717,6 +743,37 @@ function FloTraceProvider({ children, config = {}, stores, reduxStore, queryClie
             }
             break;
           }
+          // Value Lineage — resolve the origin chain for a prop or hook value.
+          case "ext:traceValue": {
+            try {
+              const trace = resolveValueTrace({
+                nodeId: message.nodeId,
+                propPath: message.propPath,
+                hookPath: message.hookPath
+              });
+              client3.sendImmediate({
+                type: "runtime:valueTrace",
+                trace: { requestId: message.requestId, ...trace },
+                timestamp: Date.now()
+              });
+            } catch (error) {
+              console.error("[FloTrace] resolveValueTrace threw:", error);
+              client3.sendImmediate({
+                type: "runtime:valueTrace",
+                trace: {
+                  requestId: message.requestId,
+                  rootNodeId: message.nodeId,
+                  rootPropPath: message.propPath,
+                  rootHookPath: message.hookPath,
+                  steps: [],
+                  resolvedAtMs: Date.now(),
+                  error: "value-not-found"
+                },
+                timestamp: Date.now()
+              });
+            }
+            break;
+          }
           case "ext:startNetworkCapture":
             safeTrackerOp("Network capture start", () => installNetworkTracker(client3));
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flotrace/runtime",
-  "version": "2.0.0",
+  "version": "2.2.1",
   "description": "Runtime package for FloTrace - enables real-time render tracking in your React app",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -26,7 +26,7 @@
     "release:major": "npm version major && npm publish"
   },
   "dependencies": {
-    "@flotrace/runtime-core": "2.0.0"
+    "@flotrace/runtime-core": "2.2.1"
   },
   "peerDependencies": {
     "react": ">=16.9.0",