@agent-native/core 0.90.11 → 0.91.1

package/dist/client/analytics-session.d.ts

@@ -0,0 +1,3 @@
+export declare function getOrCreateAnalyticsAnonymousId(): string | undefined;
+export declare function getOrCreateAnalyticsSessionId(): string | undefined;
+//# sourceMappingURL=analytics-session.d.ts.map

package/dist/client/analytics-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.d.ts","sourceRoot":"","sources":["../../src/client/analytics-session.ts"],"names":[],"mappings":"AAyCA,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,SAAS,CAQpE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,SAAS,CAkBlE"}

package/dist/client/analytics-session.js

@@ -0,0 +1,66 @@
+const ANONYMOUS_ID_STORAGE_KEY = "agent-native.anonymous_id";
+const SESSION_ID_STORAGE_KEY = "agent-native.session_id";
+const SESSION_LAST_ACTIVITY_STORAGE_KEY = "agent-native.session_last_activity";
+// 30-minute idle timeout matches GA4 / Mixpanel defaults: a tab left open
+// overnight starts a new session in the morning instead of stretching one visit.
+const SESSION_IDLE_TIMEOUT_MS = 30 * 60 * 1000;
+function generateVisitorId() {
+    try {
+        if (typeof crypto !== "undefined" &&
+            typeof crypto.randomUUID === "function") {
+            return crypto.randomUUID();
+        }
+    }
+    catch {
+        // fall through to Math.random
+    }
+    return (Date.now().toString(36) +
+        Math.random().toString(36).slice(2) +
+        Math.random().toString(36).slice(2));
+}
+function safeStorageGet(key) {
+    try {
+        return window.localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+}
+function safeStorageSet(key, value) {
+    try {
+        window.localStorage.setItem(key, value);
+    }
+    catch {
+        // private browsing / storage disabled -- best-effort
+    }
+}
+export function getOrCreateAnalyticsAnonymousId() {
+    if (typeof window === "undefined")
+        return undefined;
+    let id = safeStorageGet(ANONYMOUS_ID_STORAGE_KEY);
+    if (!id) {
+        id = generateVisitorId();
+        safeStorageSet(ANONYMOUS_ID_STORAGE_KEY, id);
+    }
+    return id;
+}
+export function getOrCreateAnalyticsSessionId() {
+    if (typeof window === "undefined")
+        return undefined;
+    const now = Date.now();
+    const lastActivityRaw = safeStorageGet(SESSION_LAST_ACTIVITY_STORAGE_KEY);
+    const lastActivity = lastActivityRaw
+        ? Number.parseInt(lastActivityRaw, 10)
+        : 0;
+    let id = safeStorageGet(SESSION_ID_STORAGE_KEY);
+    const expired = !lastActivity ||
+        Number.isNaN(lastActivity) ||
+        now - lastActivity > SESSION_IDLE_TIMEOUT_MS;
+    if (!id || expired) {
+        id = generateVisitorId();
+        safeStorageSet(SESSION_ID_STORAGE_KEY, id);
+    }
+    safeStorageSet(SESSION_LAST_ACTIVITY_STORAGE_KEY, String(now));
+    return id;
+}
+//# sourceMappingURL=analytics-session.js.map

package/dist/client/analytics-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.js","sourceRoot":"","sources":["../../src/client/analytics-session.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AAC7D,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AACzD,MAAM,iCAAiC,GAAG,oCAAoC,CAAC;AAC/E,0EAA0E;AAC1E,iFAAiF;AACjF,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,IACE,OAAO,MAAM,KAAK,WAAW;YAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EACvC,CAAC;YACD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,OAAO,CACL,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,KAAa;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,EAAE,GAAG,cAAc,CAAC,wBAAwB,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,iBAAiB,EAAE,CAAC;QACzB,cAAc,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,eAAe,GAAG,cAAc,CAAC,iCAAiC,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,eAAe;QAClC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC,CAAC;IACN,IAAI,EAAE,GAAG,cAAc,CAAC,sBAAsB,CAAC,CAAC;IAChD,MAAM,OAAO,GACX,CAAC,YAAY;QACb,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;QAC1B,GAAG,GAAG,YAAY,GAAG,uBAAuB,CAAC;IAC/C,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC;QACnB,EAAE,GAAG,iBAAiB,EAAE,CAAC;QACzB,cAAc,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,cAAc,CAAC,iCAAiC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["const ANONYMOUS_ID_STORAGE_KEY = \"agent-native.anonymous_id\";\nconst SESSION_ID_STORAGE_KEY = \"agent-native.session_id\";\nconst SESSION_LAST_ACTIVITY_STORAGE_KEY = \"agent-native.session_last_activity\";\n// 30-minute idle timeout matches GA4 / Mixpanel defaults: a tab left open\n// overnight starts a new session in the morning instead of stretching one visit.\nconst SESSION_IDLE_TIMEOUT_MS = 30 * 60 * 1000;\n\nfunction generateVisitorId(): string {\n  try {\n    if (\n      typeof crypto !== \"undefined\" &&\n      typeof crypto.randomUUID === \"function\"\n    ) {\n      return crypto.randomUUID();\n    }\n  } catch {\n    // fall through to Math.random\n  }\n  return (\n    Date.now().toString(36) +\n    Math.random().toString(36).slice(2) +\n    Math.random().toString(36).slice(2)\n  );\n}\n\nfunction safeStorageGet(key: string): string | null {\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction safeStorageSet(key: string, value: string): void {\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // private browsing / storage disabled -- best-effort\n  }\n}\n\nexport function getOrCreateAnalyticsAnonymousId(): string | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  let id = safeStorageGet(ANONYMOUS_ID_STORAGE_KEY);\n  if (!id) {\n    id = generateVisitorId();\n    safeStorageSet(ANONYMOUS_ID_STORAGE_KEY, id);\n  }\n  return id;\n}\n\nexport function getOrCreateAnalyticsSessionId(): string | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  const now = Date.now();\n  const lastActivityRaw = safeStorageGet(SESSION_LAST_ACTIVITY_STORAGE_KEY);\n  const lastActivity = lastActivityRaw\n    ? Number.parseInt(lastActivityRaw, 10)\n    : 0;\n  let id = safeStorageGet(SESSION_ID_STORAGE_KEY);\n  const expired =\n    !lastActivity ||\n    Number.isNaN(lastActivity) ||\n    now - lastActivity > SESSION_IDLE_TIMEOUT_MS;\n  if (!id || expired) {\n    id = generateVisitorId();\n    safeStorageSet(SESSION_ID_STORAGE_KEY, id);\n  }\n  safeStorageSet(SESSION_LAST_ACTIVITY_STORAGE_KEY, String(now));\n  return id;\n}\n"]}

package/dist/client/analytics.d.ts

@@ -1,5 +1,6 @@
 import type { SessionReplayOptions, SessionReplayStartResult } from "./session-replay.js";
 export { scrubUrl } from "./url-scrub.js";
+export { addErrorBreadcrumb, captureException, captureMessage, isErrorCaptureInstalled, type CaptureExceptionContext, type CapturedExceptionEvent, type ExceptionBreadcrumb, type ExceptionLevel, } from "./error-capture.js";
 export type { SessionReplayConsoleOptions, SessionReplayNetworkOptions, SessionReplayOptions, SessionReplayStartResult, SessionReplayUrlMatcher, } from "./session-replay.js";
 declare global {
     interface Window {
@@ -11,6 +12,24 @@ declare global {
     }
 }
 type GetDefaultProps = (name: string, properties: Record<string, unknown>) => Record<string, unknown>;
+/**
+ * First-party, Sentry-style error capture configuration. Pass `true`/`false`
+ * to force on/off, or an options object to tune it. When omitted, error
+ * capture auto-enables whenever a first-party analytics public key is
+ * configured (mirroring pageview + session-replay auto-enable).
+ */
+export type ErrorCaptureConfigOptions = {
+    /** Build/release identifier attached to every captured exception. */
+    release?: string;
+    /** Deployment environment (e.g. "production"). Defaults to Vite MODE. */
+    environment?: string;
+    /** Auto-capture `window.onerror`. Defaults to true. */
+    captureGlobalErrors?: boolean;
+    /** Auto-capture `unhandledrejection`. Defaults to true. */
+    captureUnhandledRejections?: boolean;
+    /** Breadcrumb ring-buffer size. Defaults to 20. */
+    maxBreadcrumbs?: number;
+};
 export type ConfigureTrackingOptions = {
     /**
      * Agent Native first-party analytics public key. This mirrors hosted
@@ -24,12 +43,25 @@ export type ConfigureTrackingOptions = {
     endpoint?: string;
     getDefaultProps?: GetDefaultProps;
     sessionReplay?: boolean | SessionReplayOptions;
+    /**
+     * First-party, Sentry-style error capture. Auto-captures uncaught errors
+     * and unhandled rejections and exposes `captureException`/`captureMessage`.
+     * Auto-enables when a public key is present; pass `false` to disable.
+     */
+    errorCapture?: boolean | ErrorCaptureConfigOptions;
 };
 type SentryUser = {
     id?: string;
     email?: string;
     username?: string;
 };
+/**
+ * Dedicated first-party analytics event name for captured exceptions. The
+ * analytics server ingest forks events with this name into the error-capture
+ * tables (error_issues / error_events) while still recording them in
+ * analytics_events for alerting. Keep in sync with the template server ingest.
+ */
+export declare const AGENT_NATIVE_EXCEPTION_EVENT_NAME = "$exception";
 export interface FirstTouchAttribution {
     ref?: string;
     via?: string;

package/dist/client/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/client/analytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/client/analytics.ts"],"names":[],"mappings":"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"}

package/dist/client/analytics.js

@@ -1,9 +1,12 @@
 import * as amplitude from "@amplitude/analytics-browser";
 import * as Sentry from "@sentry/browser";
 import { llmConnectionTrackingProperties, } from "../shared/llm-connection.js";
+import { getOrCreateAnalyticsAnonymousId, getOrCreateAnalyticsSessionId, } from "./analytics-session.js";
 import { agentNativePath } from "./api-path.js";
+import { installErrorCapture, } from "./error-capture.js";
 import { scrubUrl } from "./url-scrub.js";
 export { scrubUrl } from "./url-scrub.js";
+export { addErrorBreadcrumb, captureException, captureMessage, isErrorCaptureInstalled, } from "./error-capture.js";
 let _getDefaultProps = null;
 let _agentNativeAnalyticsPublicKey = null;
 let _agentNativeAnalyticsEndpoint = null;
@@ -19,21 +22,24 @@ let _trackingSessionRefreshInstalled = false;
 let _sessionReplayOptions = null;
 let _sessionReplayIdentitySnapshot = null;
 let _sessionReplayStartPromise = null;
+let _errorCaptureInstalled = false;
+let _errorCaptureDisposer = null;
+let _sessionReplayModuleForCapture = null;
 // Buffer for setSentryUser calls made before Sentry has initialized.
 // `undefined` means "no pending update"; `null` means "pending clear".
 let _pendingSentryUser = undefined;
 let _pendingSentryOrgId = undefined;
 const AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT = "https://analytics.agent-native.com/track";
+/**
+ * Dedicated first-party analytics event name for captured exceptions. The
+ * analytics server ingest forks events with this name into the error-capture
+ * tables (error_issues / error_events) while still recording them in
+ * analytics_events for alerting. Keep in sync with the template server ingest.
+ */
+export const AGENT_NATIVE_EXCEPTION_EVENT_NAME = "$exception";
 const PAGEVIEW_TRACKING_STATE_KEY = Symbol.for("agent-native.client.pageviewTracking");
-const ANONYMOUS_ID_STORAGE_KEY = "agent-native.anonymous_id";
-const SESSION_ID_STORAGE_KEY = "agent-native.session_id";
-const SESSION_LAST_ACTIVITY_STORAGE_KEY = "agent-native.session_last_activity";
 const LLM_CONNECTION_STORAGE_KEY = "agent-native.llm_connection_status";
 const LLM_CONNECTION_CACHE_TTL_MS = 5 * 60 * 1000;
-// 30-minute idle timeout matches GA4 / Mixpanel defaults — a tab left open
-// overnight starts a new session in the morning rather than stretching one
-// session over multiple visits.
-const SESSION_IDLE_TIMEOUT_MS = 30 * 60 * 1000;
 // First-touch referral attribution (viral attribution). Captured once on the
 // visitor's first page load and persisted across the signup boundary so the
 // server-side `signup` event can record where the user came from. First-write
@@ -57,20 +63,6 @@ const FIRST_TOUCH_QUERY_FIELDS = [
     "utm_term",
 ];
 let _firstTouchCaptured = false;
-function generateVisitorId() {
-    try {
-        if (typeof crypto !== "undefined" &&
-            typeof crypto.randomUUID === "function") {
-            return crypto.randomUUID();
-        }
-    }
-    catch {
-        // fall through to Math.random
-    }
-    return (Date.now().toString(36) +
-        Math.random().toString(36).slice(2) +
-        Math.random().toString(36).slice(2));
-}
 function safeStorageGet(key) {
     try {
         return window.localStorage.getItem(key);
@@ -267,36 +259,13 @@ function applyTrackingIdentity(properties, identity = _trackingIdentity) {
     return next;
 }
 function getOrCreateAnonymousId() {
-    if (typeof window === "undefined")
-        return undefined;
-    let id = safeStorageGet(ANONYMOUS_ID_STORAGE_KEY);
-    if (!id) {
-        id = generateVisitorId();
-        safeStorageSet(ANONYMOUS_ID_STORAGE_KEY, id);
-    }
-    return id;
+    return getOrCreateAnalyticsAnonymousId();
 }
 export function getAnalyticsAnonymousId() {
     return getOrCreateAnonymousId();
 }
 function getOrCreateSessionId() {
-    if (typeof window === "undefined")
-        return undefined;
-    const now = Date.now();
-    const lastActivityRaw = safeStorageGet(SESSION_LAST_ACTIVITY_STORAGE_KEY);
-    const lastActivity = lastActivityRaw
-        ? Number.parseInt(lastActivityRaw, 10)
-        : 0;
-    let id = safeStorageGet(SESSION_ID_STORAGE_KEY);
-    const expired = !lastActivity ||
-        Number.isNaN(lastActivity) ||
-        now - lastActivity > SESSION_IDLE_TIMEOUT_MS;
-    if (!id || expired) {
-        id = generateVisitorId();
-        safeStorageSet(SESSION_ID_STORAGE_KEY, id);
-    }
-    safeStorageSet(SESSION_LAST_ACTIVITY_STORAGE_KEY, String(now));
-    return id;
+    return getOrCreateAnalyticsSessionId();
 }
 export function getAnalyticsSessionId() {
     return getOrCreateSessionId();
@@ -811,8 +780,109 @@ export function configureTracking(options) {
             endpoint: options.endpoint,
             publicKey,
         });
+        maybeInstallErrorCapture(options.errorCapture);
     }
 }
+/**
+ * Lazily load the session-replay module so error capture can read the active
+ * replay id and surface manual captures on the replay timeline without a
+ * static import (which would create an analytics <-> session-replay import
+ * cycle and pull the replay module into the analytics chunk eagerly).
+ */
+function loadSessionReplayModuleForCapture() {
+    if (_sessionReplayModuleForCapture)
+        return;
+    import("./session-replay.js")
+        .then((mod) => {
+        _sessionReplayModuleForCapture = mod;
+    })
+        .catch(() => {
+        // Session linkage is best-effort; capture still works without it.
+    });
+}
+function errorCaptureSessionContext() {
+    return {
+        sessionId: getOrCreateSessionId(),
+        anonymousId: getOrCreateAnonymousId(),
+        replayId: _sessionReplayModuleForCapture?.getSessionReplayId?.() ?? undefined,
+    };
+}
+function exceptionEventProperties(event) {
+    return {
+        exceptionType: event.type,
+        exceptionMessage: event.message,
+        ...(event.stack ? { exceptionStack: event.stack } : {}),
+        handled: event.handled,
+        level: event.level,
+        occurredAt: event.occurredAt,
+        ...(event.url ? { errorUrl: event.url } : {}),
+        ...(event.release ? { release: event.release } : {}),
+        ...(event.environment ? { environment: event.environment } : {}),
+        ...(event.sessionReplayId
+            ? { sessionReplayId: event.sessionReplayId }
+            : {}),
+        ...(event.breadcrumbs?.length ? { breadcrumbs: event.breadcrumbs } : {}),
+        ...(event.tags ? { exceptionTags: event.tags } : {}),
+        ...(event.extra ? { exceptionExtra: event.extra } : {}),
+    };
+}
+function sendExceptionEvent(event) {
+    // Route through the existing first-party analytics ingest as a dedicated
+    // `$exception` event. This reuses the public-key auth + sendBeacon/keepalive
+    // transport; the server forks it into error_issues/error_events and still
+    // records it in analytics_events for alerting.
+    trackEvent(AGENT_NATIVE_EXCEPTION_EVENT_NAME, exceptionEventProperties(event));
+}
+function emitExceptionToReplay(event) {
+    _sessionReplayModuleForCapture?.emitSessionReplayException?.({
+        type: event.type,
+        message: event.message,
+        level: event.level,
+        ...(event.stack ? { stack: event.stack } : {}),
+        ...(event.url ? { url: event.url } : {}),
+    });
+}
+function errorCaptureAutoEnabled() {
+    const publicKey = _agentNativeAnalyticsPublicKey ||
+        import.meta.env
+            ?.VITE_AGENT_NATIVE_ANALYTICS_PUBLIC_KEY;
+    return !!publicKey;
+}
+function maybeInstallErrorCapture(config) {
+    if (typeof window === "undefined")
+        return;
+    if (config === false) {
+        _errorCaptureDisposer?.();
+        _errorCaptureDisposer = null;
+        _errorCaptureInstalled = false;
+        return;
+    }
+    if (_errorCaptureInstalled && config === undefined)
+        return;
+    const enabled = config === undefined ? errorCaptureAutoEnabled() : true;
+    if (!enabled)
+        return;
+    const options = typeof config === "object" ? config : {};
+    loadSessionReplayModuleForCapture();
+    _errorCaptureDisposer = installErrorCapture({
+        send: sendExceptionEvent,
+        getSessionContext: errorCaptureSessionContext,
+        emitReplayEvent: emitExceptionToReplay,
+        environment: options.environment ||
+            import.meta.env?.MODE,
+        ...(options.release ? { release: options.release } : {}),
+        ...(options.captureGlobalErrors !== undefined
+            ? { captureGlobalErrors: options.captureGlobalErrors }
+            : {}),
+        ...(options.captureUnhandledRejections !== undefined
+            ? { captureUnhandledRejections: options.captureUnhandledRejections }
+            : {}),
+        ...(options.maxBreadcrumbs !== undefined
+            ? { maxBreadcrumbs: options.maxBreadcrumbs }
+            : {}),
+    });
+    _errorCaptureInstalled = true;
+}
 function sessionReplayEnabledFromEnv() {
     const env = import.meta.env ?? {};
     const value = env.VITE_AGENT_NATIVE_SESSION_REPLAY_ENABLED ||