@agent-native/core 0.128.3 → 0.129.0

package/src/client/analytics.ts

@@ -1,5 +1,5 @@
-import * as amplitude from "@amplitude/analytics-browser";
-import * as Sentry from "@sentry/browser";
+import type * as amplitude from "@amplitude/analytics-browser";
+import type * as Sentry from "@sentry/browser";
 
 import {
   llmConnectionTrackingProperties,
@@ -9,7 +9,10 @@ import {
   getOrCreateAnalyticsAnonymousId,
   getOrCreateAnalyticsSessionId,
 } from "./analytics-session.js";
-import { agentNativePath } from "./api-path.js";
+import {
+  fetchAgentEngineStatus,
+  fetchAuthSessionStatus,
+} from "./client-status-requests.js";
 import {
   installErrorCapture,
   type CapturedExceptionEvent,
@@ -149,7 +152,17 @@ let _getDefaultProps: GetDefaultProps | null = null;
 let _agentNativeAnalyticsPublicKey: string | null = null;
 let _agentNativeAnalyticsEndpoint: string | null = null;
 let _amplitudeInitialized = false;
+let _amplitudeModule: typeof amplitude | null = null;
+let _amplitudeLoadPromise: Promise<typeof amplitude | null> | null = null;
+let _amplitudeApiKey: string | null = null;
+let _pendingAmplitudeEvents: Array<[string, Record<string, unknown>]> = [];
 let _sentryInitialized = false;
+let _sentryModule: typeof Sentry | null = null;
+let _sentryLoadPromise: Promise<typeof Sentry | null> | null = null;
+let _pendingSentryCaptures: Array<{
+  error: unknown;
+  context: ClientCaptureContext;
+}> = [];
 let _llmConnectionStatus: LlmConnectionStatus | null = null;
 let _llmConnectionRefresh: Promise<void> | null = null;
 let _llmConnectionRefreshInstalled = false;
@@ -301,20 +314,12 @@ function refreshLlmConnectionStatus(): Promise<void> {
     return Promise.resolve();
   }
   if (_llmConnectionRefresh) return _llmConnectionRefresh;
-  let request: Promise<Response>;
-  try {
-    request = fetch(agentNativePath("/_agent-native/agent-engine/status"));
-  } catch {
-    return Promise.resolve();
-  }
-  _llmConnectionRefresh = request
-    .then((res) => (res.ok ? res.json() : null))
-    .then((data) => {
-      _llmConnectionStatus = normalizeAgentEngineStatus(data);
-      cacheLlmConnectionStatus(_llmConnectionStatus);
-    })
-    .catch(() => {
-      if (!_llmConnectionStatus) {
+  _llmConnectionRefresh = fetchAgentEngineStatus()
+    .then((result) => {
+      if (result.state === "available") {
+        _llmConnectionStatus = normalizeAgentEngineStatus(result.value);
+        cacheLlmConnectionStatus(_llmConnectionStatus);
+      } else if (!_llmConnectionStatus) {
         _llmConnectionStatus = readCachedLlmConnectionStatus();
       }
     })
@@ -396,15 +401,11 @@ function refreshTrackingAuthSession(): Promise<void> {
     return Promise.resolve();
   }
   if (_trackingSessionRefresh) return _trackingSessionRefresh;
-  _trackingSessionRefresh = fetch(
-    agentNativePath("/_agent-native/auth/session"),
-  )
-    .then((res) => (res.ok ? res.json() : null))
-    .then((data) => {
-      setTrackingIdentityFromSession(data);
-    })
-    .catch(() => {
-      clearTrackingIdentity();
+  _trackingSessionRefresh = fetchAuthSessionStatus()
+    .then((result) => {
+      if (result.state === "available") {
+        setTrackingIdentityFromSession(result.value);
+      }
     })
     .finally(() => {
       _trackingIdentityResolved = true;
@@ -616,12 +617,31 @@ function ensureAmplitude(): boolean {
   const key = (import.meta.env as Record<string, string | undefined>)
     ?.VITE_AMPLITUDE_API_KEY;
   if (!key) return false;
-  // Standard pageviews and explicit events are emitted below. Keep SDK-level
-  // DOM/network autocapture off so rendered user content is never collected as
-  // an implicit analytics side effect.
-  amplitude.init(key, { autocapture: false });
-  _amplitudeInitialized = true;
-  return true;
+  _amplitudeApiKey = key;
+  if (_amplitudeLoadPromise) return false;
+
+  _amplitudeLoadPromise = import("@amplitude/analytics-browser")
+    .then((module) => {
+      // Standard pageviews and explicit events are emitted below. Keep SDK-level
+      // DOM/network autocapture off so rendered user content is never collected as
+      // an implicit analytics side effect.
+      module.init(key, { autocapture: false });
+      _amplitudeModule = module;
+      _amplitudeInitialized = true;
+      for (const [name, properties] of _pendingAmplitudeEvents) {
+        module.track(name, properties);
+      }
+      _pendingAmplitudeEvents = [];
+      return module;
+    })
+    .catch(() => {
+      _pendingAmplitudeEvents = [];
+      return null;
+    })
+    .finally(() => {
+      _amplitudeLoadPromise = null;
+    });
+  return false;
 }
 
 function hasOnlySourcelessFrames(value: {
@@ -881,58 +901,103 @@ function getClientSentryDsn(): string | undefined {
   );
 }
 
-function ensureSentry(): void {
-  if (_sentryInitialized) return;
-  const dsn = getClientSentryDsn();
-  if (!dsn) return;
-  Sentry.init({
-    dsn,
-    environment:
-      window.__AGENT_NATIVE_CONFIG__?.sentryEnvironment ||
-      (import.meta.env as Record<string, string | undefined>)?.MODE ||
-      "production",
-    beforeSend(event) {
-      if (shouldDropBrowserSentryNoise(event)) {
-        return null;
+function captureWithSentry(
+  module: typeof Sentry,
+  error: unknown,
+  context: ClientCaptureContext,
+): string | undefined {
+  return module.withScope((scope) => {
+    if (context.tags) {
+      for (const [k, v] of Object.entries(context.tags)) {
+        if (typeof v === "string") scope.setTag(k, v);
       }
-      // Strip sensitive query params from the request URL. React Router
-      // history can include share tokens, ?signin=1, password reset codes,
-      // public-share password params (audit F-07), etc.
-      if (event.request?.url) {
-        event.request.url = scrubUrl(event.request.url);
+    }
+    if (context.extra) {
+      for (const [k, v] of Object.entries(context.extra)) {
+        if (v !== undefined) scope.setExtra(k, v);
       }
-      // Clean the same params from breadcrumb URLs (Sentry captures
-      // history.pushState breadcrumbs by default).
-      if (Array.isArray(event.breadcrumbs)) {
-        for (const crumb of event.breadcrumbs) {
-          if (crumb && typeof crumb === "object" && "data" in crumb) {
-            const data = crumb.data as Record<string, unknown> | undefined;
-            if (data && typeof data.url === "string") {
-              data.url = scrubUrl(data.url);
-            }
-            if (data && typeof data.from === "string") {
-              data.from = scrubUrl(data.from);
-            }
-            if (data && typeof data.to === "string") {
-              data.to = scrubUrl(data.to);
+    }
+    if (context.contexts) {
+      for (const [k, v] of Object.entries(context.contexts)) {
+        scope.setContext(k, v);
+      }
+    }
+    return module.captureException(error);
+  });
+}
+
+function ensureSentry(loadWithoutDsn = false): void {
+  if (_sentryInitialized || _sentryLoadPromise) return;
+  const dsn = getClientSentryDsn();
+  if (!dsn && !loadWithoutDsn) return;
+  _sentryLoadPromise = import("@sentry/browser")
+    .then((module) => {
+      _sentryModule = module;
+      if (!dsn) {
+        for (const pending of _pendingSentryCaptures) {
+          captureWithSentry(module, pending.error, pending.context);
+        }
+        _pendingSentryCaptures = [];
+        return module;
+      }
+      module.init({
+        dsn,
+        environment:
+          window.__AGENT_NATIVE_CONFIG__?.sentryEnvironment ||
+          (import.meta.env as Record<string, string | undefined>)?.MODE ||
+          "production",
+        beforeSend(event) {
+          if (shouldDropBrowserSentryNoise(event)) {
+            return null;
+          }
+          // Strip sensitive query params from the request URL. React Router
+          // history can include share tokens, ?signin=1, password reset codes,
+          // public-share password params (audit F-07), etc.
+          if (event.request?.url) {
+            event.request.url = scrubUrl(event.request.url);
+          }
+          // Clean the same params from breadcrumb URLs (Sentry captures
+          // history.pushState breadcrumbs by default).
+          if (Array.isArray(event.breadcrumbs)) {
+            for (const crumb of event.breadcrumbs) {
+              if (crumb && typeof crumb === "object" && "data" in crumb) {
+                const data = crumb.data as Record<string, unknown> | undefined;
+                if (data && typeof data.url === "string") {
+                  data.url = scrubUrl(data.url);
+                }
+                if (data && typeof data.from === "string") {
+                  data.from = scrubUrl(data.from);
+                }
+                if (data && typeof data.to === "string") {
+                  data.to = scrubUrl(data.to);
+                }
+              }
             }
           }
-        }
+          return event;
+        },
+      });
+      module.setTag("runtime", "browser");
+      _sentryInitialized = true;
+      // Flush any user/tag that was set before init.
+      if (_pendingSentryUser !== undefined) {
+        module.setUser(_pendingSentryUser);
+        _pendingSentryUser = undefined;
       }
-      return event;
-    },
-  });
-  Sentry.setTag("runtime", "browser");
-  _sentryInitialized = true;
-  // Flush any user/tag that was set before init.
-  if (_pendingSentryUser !== undefined) {
-    Sentry.setUser(_pendingSentryUser);
-    _pendingSentryUser = undefined;
-  }
-  if (_pendingSentryOrgId !== undefined) {
-    Sentry.setTag("orgId", _pendingSentryOrgId);
-    _pendingSentryOrgId = undefined;
-  }
+      if (_pendingSentryOrgId !== undefined) {
+        module.setTag("orgId", _pendingSentryOrgId);
+        _pendingSentryOrgId = undefined;
+      }
+      for (const pending of _pendingSentryCaptures) {
+        captureWithSentry(module, pending.error, pending.context);
+      }
+      _pendingSentryCaptures = [];
+      return module;
+    })
+    .catch(() => null)
+    .finally(() => {
+      _sentryLoadPromise = null;
+    });
 }
 
 /**
@@ -972,10 +1037,10 @@ export function setSentryUser(
   ) {
     void startConfiguredSessionReplay(_sessionReplayOptions);
   }
-  if (_sentryInitialized) {
-    Sentry.setUser(user);
+  if (_sentryInitialized && _sentryModule) {
+    _sentryModule.setUser(user);
     if (orgId !== undefined) {
-      Sentry.setTag("orgId", orgId ?? null);
+      _sentryModule.setTag("orgId", orgId ?? null);
     }
     return;
   }
@@ -1024,25 +1089,12 @@ export function captureClientException(
 ): string | undefined {
   if (typeof window === "undefined") return undefined;
   try {
-    ensureSentry();
-    return Sentry.withScope((scope) => {
-      if (context.tags) {
-        for (const [k, v] of Object.entries(context.tags)) {
-          if (typeof v === "string") scope.setTag(k, v);
-        }
-      }
-      if (context.extra) {
-        for (const [k, v] of Object.entries(context.extra)) {
-          if (v !== undefined) scope.setExtra(k, v);
-        }
-      }
-      if (context.contexts) {
-        for (const [k, v] of Object.entries(context.contexts)) {
-          scope.setContext(k, v);
-        }
-      }
-      return Sentry.captureException(error);
-    });
+    ensureSentry(true);
+    if (_sentryModule) return captureWithSentry(_sentryModule, error, context);
+    if (_pendingSentryCaptures.length < 50) {
+      _pendingSentryCaptures.push({ error, context });
+    }
+    return undefined;
   } catch {
     return undefined;
   }
@@ -1647,6 +1699,7 @@ function pageviewProperties(reason: string): Record<string, unknown> {
 }
 
 function emitPageview(reason: string): void {
+  if (typeof window === "undefined") return;
   if (isLocalAnalyticsHostname(window.location.hostname)) return;
   const state = getPageviewTrackingState();
   const key = pageviewKey();
@@ -1767,7 +1820,11 @@ export function trackEvent(
   const props = resolveProps(name, params);
   window.gtag?.("event", name.replace(/\s+/g, "_"), props);
   if (ensureAmplitude()) {
-    amplitude.track(name, props);
+    _amplitudeModule?.track(name, props);
+  } else if (_amplitudeApiKey) {
+    if (_pendingAmplitudeEvents.length < 100) {
+      _pendingAmplitudeEvents.push([name, props]);
+    }
   }
   sendAgentNativeAnalytics(name, props);
 }