@osdk/react-devtools 0.5.0

package/build/esm/store/MonitorStore.js

@@ -0,0 +1,288 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { createClient } from "@osdk/client";
+import { createObservableClient } from "@osdk/client/observable";
+
+/**
+ * Configuration for creating a monitored OSDK client.
+ */
+
+import { onCommitFiberRoot } from "../fiber/DevtoolsHook.js";
+import { discoverOsdkComponentsFromRoot } from "../fiber/HookStateInspector.js";
+import { createClickToInspect } from "../inspector/createClickToInspect.js";
+import { MockManager } from "../mocking/MockManager.js";
+import { PrototypeOverrideStore } from "../prototyping/PrototypeOverrideStore.js";
+import { DEFAULT_MONITOR_CONFIG } from "../types/index.js";
+import { componentContextCapture } from "../utils/ComponentContextCapture.js";
+import { ComponentPrimitiveDiscovery } from "../utils/ComponentPrimitiveDiscovery.js";
+import { ComponentQueryRegistry } from "../utils/ComponentQueryRegistry.js";
+import { ComputeMonitor } from "../utils/ComputeMonitor.js";
+import { EventTimeline } from "../utils/EventTimeline.js";
+import { LinkTraversalTracker } from "../utils/LinkTraversalTracker.js";
+import { createMonitorLogger } from "../utils/logger.js";
+import { ObservableClientMonitor } from "../utils/ObservableClientMonitor.js";
+import { PerformanceRecommendationEngine } from "../utils/PerformanceRecommendationEngine.js";
+import { PropertyAccessTracker } from "../utils/PropertyAccessTracker.js";
+import { ComputeStore } from "./ComputeStore.js";
+import { ConsoleLogStore } from "./ConsoleLogStore.js";
+import { MetricsStore } from "./MetricsStore.js";
+import { WindowErrorStore } from "./WindowErrorStore.js";
+const monitorStoreMap = new WeakMap();
+export function getMonitorStore(client) {
+  return monitorStoreMap.get(client);
+}
+export class MonitorStore {
+  monitor = null;
+  originalGlobalFetch = null;
+  interceptedGlobalFetch = null;
+  unsubscribeFiberCommit = null;
+  constructor(config = {}) {
+    this.config = {
+      ...DEFAULT_MONITOR_CONFIG,
+      ...config
+    };
+    this.logger = config.logger ?? createMonitorLogger();
+    this.metricsStore = new MetricsStore(this.config.maxOperations, this.config.timeSeriesSize);
+    this.computeStore = new ComputeStore();
+    this.componentRegistry = new ComponentQueryRegistry();
+    this.linkTraversalTracker = new LinkTraversalTracker();
+    this.propertyAccessTracker = new PropertyAccessTracker();
+    this.eventTimeline = new EventTimeline(10000);
+    this.computeMonitor = new ComputeMonitor(this.computeStore, this.logger, undefined, this.eventTimeline);
+    this.primitiveDiscovery = new ComponentPrimitiveDiscovery(this.componentRegistry);
+    this.clickToInspect = createClickToInspect({
+      onSelect: component => {
+        const fiber = component.fiber.deref();
+        if (!fiber) {
+          return;
+        }
+        const primitives = this.primitiveDiscovery.discoverPrimitives(fiber);
+        window.dispatchEvent(new CustomEvent("primitives-discovered", {
+          detail: {
+            componentId: primitives.componentId,
+            primitives
+          }
+        }));
+      },
+      onDeactivate: () => {
+        window.dispatchEvent(new CustomEvent("inspector-deactivated"));
+      }
+    });
+    this.mockManager = new MockManager();
+    this.prototypeOverrideStore = new PrototypeOverrideStore();
+    this.consoleLogStore = new ConsoleLogStore(1000);
+    this.consoleLogStore.install();
+    this.windowErrorStore = new WindowErrorStore(1000);
+    this.windowErrorStore.install();
+    this.recommendationEngine = new PerformanceRecommendationEngine(this.metricsStore, this.componentRegistry, this.eventTimeline);
+    this.propertyAccessTracker.setEventTimeline(this.eventTimeline);
+    this.linkTraversalTracker.setEventTimeline(this.eventTimeline);
+    this.installGlobalFetchInterceptor();
+    if (typeof window !== "undefined") {
+      window.__OSDK_MONITOR__ = {
+        componentRegistry: this.componentRegistry,
+        componentContextCapture,
+        prototypeOverrideStore: this.prototypeOverrideStore
+      };
+    }
+    this.unsubscribeFiberCommit = onCommitFiberRoot((_rendererId, root) => {
+      const discovered = discoverOsdkComponentsFromRoot(root);
+      if (discovered.size > 0) {
+        this.componentRegistry.updateFromFiberDiscovery(discovered);
+      }
+    });
+  }
+  createMonitoredClient(config) {
+    const interceptedFetch = this.computeMonitor.createInterceptedFetch();
+    const client = createClient(config.baseUrl, config.ontologyRid, config.auth, {
+      logger: config.logger,
+      UNSTABLE_DO_NOT_USE_BRANCH: config.branch
+    }, interceptedFetch);
+    const observableClient = createObservableClient(client);
+    const fullyWrappedClient = this.wrapWithMonitoring(observableClient);
+    return {
+      client,
+      observableClient: fullyWrappedClient
+    };
+  }
+  wrapExistingClient(client) {
+    this.installGlobalFetchInterceptor();
+    const fullyWrappedClient = this.wrapWithMonitoring(client);
+    monitorStoreMap.set(fullyWrappedClient, this);
+    return fullyWrappedClient;
+  }
+  wrapWithMonitoring(client) {
+    if (!this.monitor) {
+      this.monitor = new ObservableClientMonitor({
+        metricsStore: this.metricsStore,
+        componentRegistry: this.componentRegistry,
+        linkTraversalTracker: this.linkTraversalTracker,
+        propertyAccessTracker: this.propertyAccessTracker,
+        eventTimeline: this.eventTimeline,
+        captureComponentContext: true,
+        captureQueryParams: true,
+        cleanupIntervalMs: this.config.cleanupIntervalMs,
+        cacheThresholdMs: this.config.cacheDetectionThresholdMs,
+        mockManager: this.mockManager
+      });
+    }
+    return this.monitor.wrapClient(client);
+  }
+  installGlobalFetchInterceptor() {
+    if (this.originalGlobalFetch != null) {
+      return;
+    }
+    this.originalGlobalFetch = globalThis.fetch;
+    const interceptedFetch = this.computeMonitor.createInterceptedFetch();
+    this.interceptedGlobalFetch = interceptedFetch;
+    globalThis.fetch = interceptedFetch;
+  }
+  uninstallGlobalFetchInterceptor() {
+    if (this.originalGlobalFetch == null) {
+      return;
+    }
+    if (globalThis.fetch === this.interceptedGlobalFetch) {
+      globalThis.fetch = this.originalGlobalFetch;
+    }
+    this.originalGlobalFetch = null;
+    this.interceptedGlobalFetch = null;
+  }
+  getMetricsStore() {
+    return this.metricsStore;
+  }
+  getComputeStore() {
+    return this.computeStore;
+  }
+  getComponentRegistry() {
+    return this.componentRegistry;
+  }
+  getLinkTraversalTracker() {
+    return this.linkTraversalTracker;
+  }
+  getPropertyAccessTracker() {
+    return this.propertyAccessTracker;
+  }
+  getMonitor() {
+    return this.monitor;
+  }
+  getEventTimeline() {
+    return this.eventTimeline;
+  }
+  getPrimitiveDiscovery() {
+    return this.primitiveDiscovery;
+  }
+  getClickToInspectSystem() {
+    return this.clickToInspect;
+  }
+  getMockManager() {
+    return this.mockManager;
+  }
+  getRecommendationEngine() {
+    return this.recommendationEngine;
+  }
+  getPrototypeOverrideStore() {
+    return this.prototypeOverrideStore;
+  }
+  getConsoleLogStore() {
+    return this.consoleLogStore;
+  }
+  getWindowErrorStore() {
+    return this.windowErrorStore;
+  }
+  dispose() {
+    this.unsubscribeFiberCommit?.();
+    this.unsubscribeFiberCommit = null;
+    this.uninstallGlobalFetchInterceptor();
+    if (typeof window !== "undefined") {
+      delete window.__OSDK_MONITOR__;
+    }
+    this.metricsStore.dispose();
+    this.computeStore.dispose();
+    this.componentRegistry.clear();
+    this.linkTraversalTracker.clear();
+    this.propertyAccessTracker.clear();
+    this.eventTimeline.clear();
+    this.clickToInspect.dispose();
+    this.consoleLogStore.dispose();
+    this.windowErrorStore.dispose();
+    this.mockManager.clear();
+    this.prototypeOverrideStore.clearAll();
+    this.monitor?.dispose();
+    this.monitor = null;
+  }
+  async loadCacheEntries() {
+    if (!this.monitor) {
+      return [];
+    }
+    try {
+      const snapshot = await this.monitor.getCacheSnapshot();
+      return snapshot.entries;
+    } catch {
+      return [];
+    }
+  }
+
+  /** @deprecated Use `loadCacheEntries()` — name was misleading because the method is async. */
+  getCacheEntries() {
+    return this.loadCacheEntries();
+  }
+  async getCacheSnapshot() {
+    if (!this.monitor) {
+      return {
+        entries: [],
+        stats: {
+          totalEntries: 0,
+          totalSize: 0,
+          totalHits: 0
+        }
+      };
+    }
+    try {
+      return await this.monitor.getCacheSnapshot();
+    } catch {
+      return {
+        entries: [],
+        stats: {
+          totalEntries: 0,
+          totalSize: 0,
+          totalHits: 0
+        }
+      };
+    }
+  }
+  async invalidateCacheEntry(entry) {
+    if (!this.monitor) {
+      return;
+    }
+    try {
+      if (entry.type === "object" && entry.data) {
+        await this.monitor.invalidateObjects(entry.data);
+      } else {
+        await this.monitor.invalidateObjectType(entry.objectType);
+      }
+    } catch {}
+  }
+  async clearCache() {
+    if (!this.monitor) {
+      return;
+    }
+    try {
+      await this.monitor.invalidateAll();
+    } catch {}
+  }
+}
+//# sourceMappingURL=MonitorStore.js.map

package/build/esm/store/MonitorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitorStore.js","names":["createClient","createObservableClient","onCommitFiberRoot","discoverOsdkComponentsFromRoot","createClickToInspect","MockManager","PrototypeOverrideStore","DEFAULT_MONITOR_CONFIG","componentContextCapture","ComponentPrimitiveDiscovery","ComponentQueryRegistry","ComputeMonitor","EventTimeline","LinkTraversalTracker","createMonitorLogger","ObservableClientMonitor","PerformanceRecommendationEngine","PropertyAccessTracker","ComputeStore","ConsoleLogStore","MetricsStore","WindowErrorStore","monitorStoreMap","WeakMap","getMonitorStore","client","get","MonitorStore","monitor","originalGlobalFetch","interceptedGlobalFetch","unsubscribeFiberCommit","constructor","config","logger","metricsStore","maxOperations","timeSeriesSize","computeStore","componentRegistry","linkTraversalTracker","propertyAccessTracker","eventTimeline","computeMonitor","undefined","primitiveDiscovery","clickToInspect","onSelect","component","fiber","deref","primitives","discoverPrimitives","window","dispatchEvent","CustomEvent","detail","componentId","onDeactivate","mockManager","prototypeOverrideStore","consoleLogStore","install","windowErrorStore","recommendationEngine","setEventTimeline","installGlobalFetchInterceptor","__OSDK_MONITOR__","_rendererId","root","discovered","size","updateFromFiberDiscovery","createMonitoredClient","interceptedFetch","createInterceptedFetch","baseUrl","ontologyRid","auth","UNSTABLE_DO_NOT_USE_BRANCH","branch","observableClient","fullyWrappedClient","wrapWithMonitoring","wrapExistingClient","set","captureComponentContext","captureQueryParams","cleanupIntervalMs","cacheThresholdMs","cacheDetectionThresholdMs","wrapClient","globalThis","fetch","uninstallGlobalFetchInterceptor","getMetricsStore","getComputeStore","getComponentRegistry","getLinkTraversalTracker","getPropertyAccessTracker","getMonitor","getEventTimeline","getPrimitiveDiscovery","getClickToInspectSystem","getMockManager","getRecommendationEngine","getPrototypeOverrideStore","getConsoleLogStore","getWindowErrorStore","dispose","clear","clearAll","loadCacheEntries","snapshot","getCacheSnapshot","entries","getCacheEntries","stats","totalEntries","totalSize","totalHits","invalidateCacheEntry","entry","type","data","invalidateObjects","invalidateObjectType","objectType","clearCache","invalidateAll"],"sources":["MonitorStore.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Logger } from \"@osdk/api\";\nimport { type Client, createClient } from \"@osdk/client\";\nimport {\n  type CacheEntry,\n  type CacheSnapshot,\n  createObservableClient,\n  type ObservableClient,\n} from \"@osdk/client/observable\";\n\n/**\n * Configuration for creating a monitored OSDK client.\n */\ninterface ClientConfig {\n  baseUrl: string;\n  ontologyRid: string | Promise<string>;\n  auth: () => Promise<string>;\n  logger?: Logger;\n  branch?: string;\n}\nimport { onCommitFiberRoot } from \"../fiber/DevtoolsHook.js\";\nimport { discoverOsdkComponentsFromRoot } from \"../fiber/HookStateInspector.js\";\nimport type { ClickToInspectSystem } from \"../inspector/ClickToInspectSystem.js\";\nimport { createClickToInspect } from \"../inspector/createClickToInspect.js\";\nimport { MockManager } from \"../mocking/MockManager.js\";\nimport { PrototypeOverrideStore } from \"../prototyping/PrototypeOverrideStore.js\";\nimport {\n  DEFAULT_MONITOR_CONFIG,\n  type MonitoringConfig,\n} from \"../types/index.js\";\nimport { componentContextCapture } from \"../utils/ComponentContextCapture.js\";\nimport { ComponentPrimitiveDiscovery } from \"../utils/ComponentPrimitiveDiscovery.js\";\nimport { ComponentQueryRegistry } from \"../utils/ComponentQueryRegistry.js\";\nimport { ComputeMonitor } from \"../utils/ComputeMonitor.js\";\nimport { EventTimeline } from \"../utils/EventTimeline.js\";\nimport { LinkTraversalTracker } from \"../utils/LinkTraversalTracker.js\";\nimport { createMonitorLogger } from \"../utils/logger.js\";\nimport { ObservableClientMonitor } from \"../utils/ObservableClientMonitor.js\";\nimport { PerformanceRecommendationEngine } from \"../utils/PerformanceRecommendationEngine.js\";\nimport { PropertyAccessTracker } from \"../utils/PropertyAccessTracker.js\";\nimport { ComputeStore } from \"./ComputeStore.js\";\nimport { ConsoleLogStore } from \"./ConsoleLogStore.js\";\nimport { MetricsStore } from \"./MetricsStore.js\";\nimport { WindowErrorStore } from \"./WindowErrorStore.js\";\n\nconst monitorStoreMap = new WeakMap<object, MonitorStore>();\n\nexport function getMonitorStore(client: object): MonitorStore | undefined {\n  return monitorStoreMap.get(client);\n}\n\nexport class MonitorStore {\n  private readonly config: MonitoringConfig;\n  private readonly logger: Logger;\n  private readonly metricsStore: MetricsStore;\n  private readonly computeStore: ComputeStore;\n  private readonly computeMonitor: ComputeMonitor;\n  private readonly componentRegistry: ComponentQueryRegistry;\n  private readonly linkTraversalTracker: LinkTraversalTracker;\n  private readonly propertyAccessTracker: PropertyAccessTracker;\n  private readonly eventTimeline: EventTimeline;\n  private readonly primitiveDiscovery: ComponentPrimitiveDiscovery;\n  private readonly clickToInspect: ClickToInspectSystem;\n  private readonly mockManager: MockManager;\n  private readonly recommendationEngine: PerformanceRecommendationEngine;\n  private readonly prototypeOverrideStore: PrototypeOverrideStore;\n  private readonly consoleLogStore: ConsoleLogStore;\n  private readonly windowErrorStore: WindowErrorStore;\n  private monitor: ObservableClientMonitor | null = null;\n  private originalGlobalFetch: typeof globalThis.fetch | null = null;\n  private interceptedGlobalFetch: typeof globalThis.fetch | null = null;\n  private unsubscribeFiberCommit: (() => void) | null = null;\n\n  constructor(config: Partial<MonitoringConfig> = {}) {\n    this.config = { ...DEFAULT_MONITOR_CONFIG, ...config };\n    this.logger = config.logger ?? createMonitorLogger();\n    this.metricsStore = new MetricsStore(\n      this.config.maxOperations,\n      this.config.timeSeriesSize,\n    );\n    this.computeStore = new ComputeStore();\n    this.componentRegistry = new ComponentQueryRegistry();\n    this.linkTraversalTracker = new LinkTraversalTracker();\n    this.propertyAccessTracker = new PropertyAccessTracker();\n    this.eventTimeline = new EventTimeline(10000);\n    this.computeMonitor = new ComputeMonitor(\n      this.computeStore,\n      this.logger,\n      undefined,\n      this.eventTimeline,\n    );\n    this.primitiveDiscovery = new ComponentPrimitiveDiscovery(\n      this.componentRegistry,\n    );\n    this.clickToInspect = createClickToInspect({\n      onSelect: (component) => {\n        const fiber = component.fiber.deref();\n        if (!fiber) {\n          return;\n        }\n        const primitives = this.primitiveDiscovery.discoverPrimitives(fiber);\n        window.dispatchEvent(\n          new CustomEvent(\"primitives-discovered\", {\n            detail: {\n              componentId: primitives.componentId,\n              primitives,\n            },\n          }),\n        );\n      },\n      onDeactivate: () => {\n        window.dispatchEvent(new CustomEvent(\"inspector-deactivated\"));\n      },\n    });\n    this.mockManager = new MockManager();\n    this.prototypeOverrideStore = new PrototypeOverrideStore();\n    this.consoleLogStore = new ConsoleLogStore(1000);\n    this.consoleLogStore.install();\n    this.windowErrorStore = new WindowErrorStore(1000);\n    this.windowErrorStore.install();\n    this.recommendationEngine = new PerformanceRecommendationEngine(\n      this.metricsStore,\n      this.componentRegistry,\n      this.eventTimeline,\n    );\n\n    this.propertyAccessTracker.setEventTimeline(this.eventTimeline);\n    this.linkTraversalTracker.setEventTimeline(this.eventTimeline);\n    this.installGlobalFetchInterceptor();\n\n    if (typeof window !== \"undefined\") {\n      window.__OSDK_MONITOR__ = {\n        componentRegistry: this.componentRegistry,\n        componentContextCapture,\n        prototypeOverrideStore: this.prototypeOverrideStore,\n      };\n    }\n\n    this.unsubscribeFiberCommit = onCommitFiberRoot((_rendererId, root) => {\n      const discovered = discoverOsdkComponentsFromRoot(root);\n      if (discovered.size > 0) {\n        this.componentRegistry.updateFromFiberDiscovery(discovered);\n      }\n    });\n  }\n\n  createMonitoredClient(config: ClientConfig): {\n    client: Client;\n    observableClient: ObservableClient;\n  } {\n    const interceptedFetch = this.computeMonitor.createInterceptedFetch();\n\n    const client = createClient(\n      config.baseUrl,\n      config.ontologyRid,\n      config.auth,\n      {\n        logger: config.logger,\n        UNSTABLE_DO_NOT_USE_BRANCH: config.branch,\n      },\n      interceptedFetch,\n    );\n\n    const observableClient: ObservableClient = createObservableClient(\n      client,\n    );\n\n    const fullyWrappedClient = this.wrapWithMonitoring(observableClient);\n\n    return {\n      client,\n      observableClient: fullyWrappedClient,\n    };\n  }\n\n  wrapExistingClient(client: ObservableClient): ObservableClient {\n    this.installGlobalFetchInterceptor();\n\n    const fullyWrappedClient = this.wrapWithMonitoring(client);\n    monitorStoreMap.set(fullyWrappedClient, this);\n\n    return fullyWrappedClient;\n  }\n\n  private wrapWithMonitoring(client: ObservableClient): ObservableClient {\n    if (!this.monitor) {\n      this.monitor = new ObservableClientMonitor({\n        metricsStore: this.metricsStore,\n        componentRegistry: this.componentRegistry,\n        linkTraversalTracker: this.linkTraversalTracker,\n        propertyAccessTracker: this.propertyAccessTracker,\n        eventTimeline: this.eventTimeline,\n        captureComponentContext: true,\n        captureQueryParams: true,\n        cleanupIntervalMs: this.config.cleanupIntervalMs,\n        cacheThresholdMs: this.config.cacheDetectionThresholdMs,\n        mockManager: this.mockManager,\n      });\n    }\n    return this.monitor.wrapClient(client);\n  }\n\n  installGlobalFetchInterceptor(): void {\n    if (this.originalGlobalFetch != null) {\n      return;\n    }\n\n    this.originalGlobalFetch = globalThis.fetch;\n    const interceptedFetch = this.computeMonitor.createInterceptedFetch();\n    this.interceptedGlobalFetch = interceptedFetch;\n    globalThis.fetch = interceptedFetch;\n  }\n\n  private uninstallGlobalFetchInterceptor(): void {\n    if (this.originalGlobalFetch == null) {\n      return;\n    }\n\n    if (globalThis.fetch === this.interceptedGlobalFetch) {\n      globalThis.fetch = this.originalGlobalFetch;\n    }\n\n    this.originalGlobalFetch = null;\n    this.interceptedGlobalFetch = null;\n  }\n\n  getMetricsStore(): MetricsStore {\n    return this.metricsStore;\n  }\n\n  getComputeStore(): ComputeStore {\n    return this.computeStore;\n  }\n\n  getComponentRegistry(): ComponentQueryRegistry {\n    return this.componentRegistry;\n  }\n\n  getLinkTraversalTracker(): LinkTraversalTracker {\n    return this.linkTraversalTracker;\n  }\n\n  getPropertyAccessTracker(): PropertyAccessTracker {\n    return this.propertyAccessTracker;\n  }\n\n  getMonitor(): ObservableClientMonitor | null {\n    return this.monitor;\n  }\n\n  getEventTimeline(): EventTimeline {\n    return this.eventTimeline;\n  }\n\n  getPrimitiveDiscovery(): ComponentPrimitiveDiscovery {\n    return this.primitiveDiscovery;\n  }\n\n  getClickToInspectSystem(): ClickToInspectSystem {\n    return this.clickToInspect;\n  }\n\n  getMockManager(): MockManager {\n    return this.mockManager;\n  }\n\n  getRecommendationEngine(): PerformanceRecommendationEngine {\n    return this.recommendationEngine;\n  }\n\n  getPrototypeOverrideStore(): PrototypeOverrideStore {\n    return this.prototypeOverrideStore;\n  }\n\n  getConsoleLogStore(): ConsoleLogStore {\n    return this.consoleLogStore;\n  }\n\n  getWindowErrorStore(): WindowErrorStore {\n    return this.windowErrorStore;\n  }\n\n  dispose(): void {\n    this.unsubscribeFiberCommit?.();\n    this.unsubscribeFiberCommit = null;\n    this.uninstallGlobalFetchInterceptor();\n    if (typeof window !== \"undefined\") {\n      delete (window as unknown as Record<string, unknown>).__OSDK_MONITOR__;\n    }\n    this.metricsStore.dispose();\n    this.computeStore.dispose();\n    this.componentRegistry.clear();\n    this.linkTraversalTracker.clear();\n    this.propertyAccessTracker.clear();\n    this.eventTimeline.clear();\n    this.clickToInspect.dispose();\n    this.consoleLogStore.dispose();\n    this.windowErrorStore.dispose();\n    this.mockManager.clear();\n    this.prototypeOverrideStore.clearAll();\n    this.monitor?.dispose();\n    this.monitor = null;\n  }\n\n  async loadCacheEntries(): Promise<CacheEntry[]> {\n    if (!this.monitor) {\n      return [];\n    }\n\n    try {\n      const snapshot = await this.monitor.getCacheSnapshot();\n      return snapshot.entries;\n    } catch {\n      return [];\n    }\n  }\n\n  /** @deprecated Use `loadCacheEntries()` — name was misleading because the method is async. */\n  getCacheEntries(): Promise<CacheEntry[]> {\n    return this.loadCacheEntries();\n  }\n\n  async getCacheSnapshot(): Promise<CacheSnapshot> {\n    if (!this.monitor) {\n      return {\n        entries: [],\n        stats: { totalEntries: 0, totalSize: 0, totalHits: 0 },\n      };\n    }\n\n    try {\n      return await this.monitor.getCacheSnapshot();\n    } catch {\n      return {\n        entries: [],\n        stats: { totalEntries: 0, totalSize: 0, totalHits: 0 },\n      };\n    }\n  }\n\n  async invalidateCacheEntry(entry: {\n    type: \"object\" | \"list\" | \"link\" | \"objectSet\";\n    objectType: string;\n    data?: unknown;\n  }): Promise<void> {\n    if (!this.monitor) {\n      return;\n    }\n\n    try {\n      if (entry.type === \"object\" && entry.data) {\n        await this.monitor.invalidateObjects(entry.data);\n      } else {\n        await this.monitor.invalidateObjectType(entry.objectType);\n      }\n    } catch {\n    }\n  }\n\n  async clearCache(): Promise<void> {\n    if (!this.monitor) {\n      return;\n    }\n\n    try {\n      await this.monitor.invalidateAll();\n    } catch {\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/store/SubscribableStore.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export class SubscribableStore {
+  subscribers = new Set();
+  subscribe(callback) {
+    this.subscribers.add(callback);
+    return () => {
+      this.subscribers.delete(callback);
+    };
+  }
+  notifySubscribers() {
+    for (const callback of this.subscribers) {
+      try {
+        callback();
+      } catch {
+        // don't let a bad subscriber break others
+      }
+    }
+  }
+  clearSubscribers() {
+    this.subscribers.clear();
+  }
+}
+//# sourceMappingURL=SubscribableStore.js.map

package/build/esm/store/SubscribableStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscribableStore.js","names":["SubscribableStore","subscribers","Set","subscribe","callback","add","delete","notifySubscribers","clearSubscribers","clear"],"sources":["SubscribableStore.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport abstract class SubscribableStore {\n  private readonly subscribers = new Set<() => void>();\n\n  subscribe(callback: () => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  protected notifySubscribers(): void {\n    for (const callback of this.subscribers) {\n      try {\n        callback();\n      } catch {\n        // don't let a bad subscriber break others\n      }\n    }\n  }\n\n  protected clearSubscribers(): void {\n    this.subscribers.clear();\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAeA,iBAAiB,CAAC;EACrBC,WAAW,GAAG,IAAIC,GAAG,CAAa,CAAC;EAEpDC,SAASA,CAACC,QAAoB,EAAc;IAC1C,IAAI,CAACH,WAAW,CAACI,GAAG,CAACD,QAAQ,CAAC;IAC9B,OAAO,MAAM;MACX,IAAI,CAACH,WAAW,CAACK,MAAM,CAACF,QAAQ,CAAC;IACnC,CAAC;EACH;EAEUG,iBAAiBA,CAAA,EAAS;IAClC,KAAK,MAAMH,QAAQ,IAAI,IAAI,CAACH,WAAW,EAAE;MACvC,IAAI;QACFG,QAAQ,CAAC,CAAC;MACZ,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF;EAEUI,gBAAgBA,CAAA,EAAS;IACjC,IAAI,CAACP,WAAW,CAACQ,KAAK,CAAC,CAAC;EAC1B;AACF","ignoreList":[]}

package/build/esm/store/WindowErrorStore.js

@@ -0,0 +1,195 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Captures global JS errors (uncaught throws) and unhandled promise rejections
+// from the host page. React's dev-mode render errors are captured separately
+// via console.error in ConsoleLogStore, so we don't ship a dedicated error
+// boundary alongside this.
+
+import { CircularBuffer } from "../utils/CircularBuffer.js";
+import { SubscribableStore } from "./SubscribableStore.js";
+let entryCounter = 0;
+function nextId() {
+  return `windowError-${++entryCounter}-${Date.now()}`;
+}
+function describeRejectionReason(reason) {
+  if (reason instanceof Error) {
+    return {
+      message: reason.message,
+      stack: reason.stack
+    };
+  }
+  if (typeof reason === "string") {
+    return {
+      message: reason
+    };
+  }
+  try {
+    return {
+      message: JSON.stringify(reason)
+    };
+  } catch {
+    return {
+      message: String(reason)
+    };
+  }
+}
+export class WindowErrorStore extends SubscribableStore {
+  cachedEntries = null;
+  installed = false;
+  suppressed = false;
+  notifyScheduled = false;
+  errorListener = null;
+  rejectionListener = null;
+  constructor(capacity = 1000) {
+    super();
+    this.entries = new CircularBuffer(capacity);
+  }
+  install() {
+    if (this.installed) {
+      return;
+    }
+    if (typeof window === "undefined") {
+      return;
+    }
+    this.errorListener = event => {
+      if (this.suppressed) {
+        return;
+      }
+      const message = event.message || (event.error instanceof Error ? event.error.message : "Error");
+      const stack = event.error instanceof Error ? event.error.stack : undefined;
+      const entry = {
+        id: nextId(),
+        kind: "error",
+        message,
+        ...(stack !== undefined ? {
+          stack
+        } : {}),
+        ...(event.filename ? {
+          filename: event.filename
+        } : {}),
+        ...(typeof event.lineno === "number" ? {
+          lineno: event.lineno
+        } : {}),
+        ...(typeof event.colno === "number" ? {
+          colno: event.colno
+        } : {}),
+        timestamp: Date.now()
+      };
+      this.entries.push(entry);
+      this.cachedEntries = null;
+      this.scheduleNotify();
+    };
+    this.rejectionListener = event => {
+      if (this.suppressed) {
+        return;
+      }
+      const {
+        message,
+        stack
+      } = describeRejectionReason(event.reason);
+      const entry = {
+        id: nextId(),
+        kind: "unhandledrejection",
+        message,
+        ...(stack !== undefined ? {
+          stack
+        } : {}),
+        timestamp: Date.now()
+      };
+      this.entries.push(entry);
+      this.cachedEntries = null;
+      this.scheduleNotify();
+    };
+    window.addEventListener("error", this.errorListener);
+    window.addEventListener("unhandledrejection", this.rejectionListener);
+    this.installed = true;
+  }
+  uninstall() {
+    if (!this.installed) {
+      return;
+    }
+    if (typeof window !== "undefined") {
+      if (this.errorListener) {
+        window.removeEventListener("error", this.errorListener);
+      }
+      if (this.rejectionListener) {
+        window.removeEventListener("unhandledrejection", this.rejectionListener);
+      }
+    }
+    this.errorListener = null;
+    this.rejectionListener = null;
+    this.installed = false;
+  }
+  suppress() {
+    this.suppressed = true;
+  }
+  unsuppress() {
+    this.suppressed = false;
+  }
+  recordError(error, source) {
+    if (this.suppressed) {
+      return;
+    }
+    const entry = {
+      id: nextId(),
+      kind: "error",
+      message: error.message,
+      ...(error.stack !== undefined ? {
+        stack: error.stack
+      } : {}),
+      ...(source !== undefined ? {
+        filename: source
+      } : {}),
+      timestamp: Date.now()
+    };
+    this.entries.push(entry);
+    this.cachedEntries = null;
+    this.scheduleNotify();
+  }
+  getEntries() {
+    if (this.cachedEntries != null) {
+      return this.cachedEntries;
+    }
+    this.cachedEntries = this.entries.toArray();
+    return this.cachedEntries;
+  }
+  getSize() {
+    return this.entries.getSize();
+  }
+  clear() {
+    this.entries.clear();
+    this.cachedEntries = null;
+    this.notifySubscribers();
+  }
+  dispose() {
+    this.uninstall();
+    this.entries.clear();
+    this.cachedEntries = null;
+    this.clearSubscribers();
+  }
+  scheduleNotify() {
+    if (this.notifyScheduled) {
+      return;
+    }
+    this.notifyScheduled = true;
+    queueMicrotask(() => {
+      this.notifyScheduled = false;
+      this.notifySubscribers();
+    });
+  }
+}
+//# sourceMappingURL=WindowErrorStore.js.map

package/build/esm/store/WindowErrorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowErrorStore.js","names":["CircularBuffer","SubscribableStore","entryCounter","nextId","Date","now","describeRejectionReason","reason","Error","message","stack","JSON","stringify","String","WindowErrorStore","cachedEntries","installed","suppressed","notifyScheduled","errorListener","rejectionListener","constructor","capacity","entries","install","window","event","error","undefined","entry","id","kind","filename","lineno","colno","timestamp","push","scheduleNotify","addEventListener","uninstall","removeEventListener","suppress","unsuppress","recordError","source","getEntries","toArray","getSize","clear","notifySubscribers","dispose","clearSubscribers","queueMicrotask"],"sources":["WindowErrorStore.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Captures global JS errors (uncaught throws) and unhandled promise rejections\n// from the host page. React's dev-mode render errors are captured separately\n// via console.error in ConsoleLogStore, so we don't ship a dedicated error\n// boundary alongside this.\n\nimport { CircularBuffer } from \"../utils/CircularBuffer.js\";\nimport { SubscribableStore } from \"./SubscribableStore.js\";\n\nexport type WindowErrorKind = \"error\" | \"unhandledrejection\";\n\nexport interface WindowErrorEntry {\n  readonly id: string;\n  readonly kind: WindowErrorKind;\n  readonly message: string;\n  readonly stack?: string;\n  readonly filename?: string;\n  readonly lineno?: number;\n  readonly colno?: number;\n  readonly timestamp: number;\n}\n\nlet entryCounter = 0;\n\nfunction nextId(): string {\n  return `windowError-${++entryCounter}-${Date.now()}`;\n}\n\nfunction describeRejectionReason(\n  reason: unknown,\n): { message: string; stack?: string } {\n  if (reason instanceof Error) {\n    return { message: reason.message, stack: reason.stack };\n  }\n  if (typeof reason === \"string\") {\n    return { message: reason };\n  }\n  try {\n    return { message: JSON.stringify(reason) };\n  } catch {\n    return { message: String(reason) };\n  }\n}\n\nexport class WindowErrorStore extends SubscribableStore {\n  private readonly entries: CircularBuffer<WindowErrorEntry>;\n  private cachedEntries: readonly WindowErrorEntry[] | null = null;\n  private installed = false;\n  private suppressed = false;\n  private notifyScheduled = false;\n\n  private errorListener: ((event: ErrorEvent) => void) | null = null;\n  private rejectionListener:\n    | ((event: PromiseRejectionEvent) => void)\n    | null = null;\n\n  constructor(capacity: number = 1000) {\n    super();\n    this.entries = new CircularBuffer(capacity);\n  }\n\n  install(): void {\n    if (this.installed) {\n      return;\n    }\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    this.errorListener = (event: ErrorEvent) => {\n      if (this.suppressed) {\n        return;\n      }\n      const message = event.message\n        || (event.error instanceof Error ? event.error.message : \"Error\");\n      const stack = event.error instanceof Error\n        ? event.error.stack\n        : undefined;\n      const entry: WindowErrorEntry = {\n        id: nextId(),\n        kind: \"error\",\n        message,\n        ...(stack !== undefined ? { stack } : {}),\n        ...(event.filename ? { filename: event.filename } : {}),\n        ...(typeof event.lineno === \"number\" ? { lineno: event.lineno } : {}),\n        ...(typeof event.colno === \"number\" ? { colno: event.colno } : {}),\n        timestamp: Date.now(),\n      };\n      this.entries.push(entry);\n      this.cachedEntries = null;\n      this.scheduleNotify();\n    };\n\n    this.rejectionListener = (event: PromiseRejectionEvent) => {\n      if (this.suppressed) {\n        return;\n      }\n      const { message, stack } = describeRejectionReason(event.reason);\n      const entry: WindowErrorEntry = {\n        id: nextId(),\n        kind: \"unhandledrejection\",\n        message,\n        ...(stack !== undefined ? { stack } : {}),\n        timestamp: Date.now(),\n      };\n      this.entries.push(entry);\n      this.cachedEntries = null;\n      this.scheduleNotify();\n    };\n\n    window.addEventListener(\"error\", this.errorListener);\n    window.addEventListener(\"unhandledrejection\", this.rejectionListener);\n    this.installed = true;\n  }\n\n  uninstall(): void {\n    if (!this.installed) {\n      return;\n    }\n    if (typeof window !== \"undefined\") {\n      if (this.errorListener) {\n        window.removeEventListener(\"error\", this.errorListener);\n      }\n      if (this.rejectionListener) {\n        window.removeEventListener(\n          \"unhandledrejection\",\n          this.rejectionListener,\n        );\n      }\n    }\n    this.errorListener = null;\n    this.rejectionListener = null;\n    this.installed = false;\n  }\n\n  suppress(): void {\n    this.suppressed = true;\n  }\n\n  unsuppress(): void {\n    this.suppressed = false;\n  }\n\n  recordError(error: Error, source?: string): void {\n    if (this.suppressed) {\n      return;\n    }\n    const entry: WindowErrorEntry = {\n      id: nextId(),\n      kind: \"error\",\n      message: error.message,\n      ...(error.stack !== undefined ? { stack: error.stack } : {}),\n      ...(source !== undefined ? { filename: source } : {}),\n      timestamp: Date.now(),\n    };\n    this.entries.push(entry);\n    this.cachedEntries = null;\n    this.scheduleNotify();\n  }\n\n  getEntries(): readonly WindowErrorEntry[] {\n    if (this.cachedEntries != null) {\n      return this.cachedEntries;\n    }\n    this.cachedEntries = this.entries.toArray();\n    return this.cachedEntries;\n  }\n\n  getSize(): number {\n    return this.entries.getSize();\n  }\n\n  clear(): void {\n    this.entries.clear();\n    this.cachedEntries = null;\n    this.notifySubscribers();\n  }\n\n  dispose(): void {\n    this.uninstall();\n    this.entries.clear();\n    this.cachedEntries = null;\n    this.clearSubscribers();\n  }\n\n  private scheduleNotify(): void {\n    if (this.notifyScheduled) {\n      return;\n    }\n    this.notifyScheduled = true;\n    queueMicrotask(() => {\n      this.notifyScheduled = false;\n      this.notifySubscribers();\n    });\n  }\n}\n"],"mappings":"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","ignoreList":[]}