@mushi-mushi/core 1.28.0 → 1.30.0

package/dist/index.cjs

@@ -232,7 +232,8 @@ function createApiClient(options) {
     if (cbFailures >= cbThreshold) cbOpenUntil = Date.now() + cbCooldownMs;
   };
   async function request(method, path, body, retries = maxRetries, internalKind, extraHeaders) {
-    if (cbIsOpen()) {
+    const tracked = internalKind !== "reporter-poll";
+    if (tracked && cbIsOpen()) {
       return { ok: false, error: { code: "CIRCUIT_OPEN", message: "Endpoint temporarily unavailable; retrying later." } };
     }
     const url = `${baseUrl}${path}`;
@@ -251,7 +252,7 @@ function createApiClient(options) {
       ...extraHeaders
     };
     const serialized = body ? JSON.stringify(body) : void 0;
-    if (serialized && method !== "GET") {
+    if (serialized && method !== "GET" && internalKind !== "reporter-poll") {
       lastOutbound = { url, headers, body: serialized, path };
     }
     try {
@@ -291,19 +292,22 @@ function createApiClient(options) {
           await sleep(retryAfterMs ?? getBackoffDelay(maxRetries - retries));
           return request(method, path, body, retries - 1, internalKind, extraHeaders);
         }
-        if (unusable) cbRecordUnreachable();
-        else cbRecordReachable();
+        if (tracked) {
+          if (unusable) cbRecordUnreachable();
+          else cbRecordReachable();
+        }
         return {
           ok: false,
           error: {
             code: errorBody.error?.code || `HTTP_${response.status}`,
-            message: errorBody.error?.message || errorBody.message || `HTTP ${response.status} error`
+            message: errorBody.error?.message || errorBody.message || `HTTP ${response.status} error`,
+            status: response.status
           }
         };
       }
       const payload = await response.json();
       const data = payload && typeof payload === "object" && "ok" in payload && "data" in payload ? payload.data : payload;
-      cbRecordReachable();
+      if (tracked) cbRecordReachable();
       return { ok: true, data };
     } catch (error) {
       clearTimeout(timer);
@@ -311,7 +315,7 @@ function createApiClient(options) {
         await sleep(getBackoffDelay(maxRetries - retries));
         return request(method, path, body, retries - 1, internalKind, extraHeaders);
       }
-      cbRecordUnreachable();
+      if (tracked) cbRecordUnreachable();
       return {
         ok: false,
         error: {
@@ -322,39 +326,17 @@ function createApiClient(options) {
     }
   }
   async function requestForReporter(method, path, reporterToken, body) {
-    const tokenHash = await sha256Hex(reporterToken);
-    const ts = String(Date.now());
-    const hmac = await hmacSha256Hex(apiKey, `${projectId}.${ts}.${tokenHash}`);
-    const url = `${baseUrl}${path}`;
-    const response = await fetch(url, {
-      method,
-      headers: {
-        "Content-Type": "application/json",
-        "X-Mushi-Api-Key": apiKey,
-        "X-Mushi-Project": projectId,
-        ...sdkPackage ? { [MUSHI_SDK_PACKAGE_HEADER]: sdkPackage } : {},
-        ...sdkVersion ? { [MUSHI_SDK_VERSION_HEADER]: sdkVersion } : {},
-        [MUSHI_INTERNAL_HEADER]: "reporter-poll",
+    try {
+      const tokenHash = await sha256Hex(reporterToken);
+      const ts = String(Date.now());
+      return await request(method, path, body, maxRetries, "reporter-poll", {
         "X-Reporter-Token-Hash": tokenHash,
         "X-Reporter-Ts": ts,
-        "X-Reporter-Hmac": hmac
-      },
-      body: body ? JSON.stringify(body) : void 0,
-      keepalive: isPageUnloading(),
-      [MUSHI_INTERNAL_INIT_MARKER]: "reporter-poll"
-    });
-    if (!response.ok) {
-      const errorBody = await response.json().catch(() => ({}));
-      return {
-        ok: false,
-        error: {
-          code: `HTTP_${response.status}`,
-          message: errorBody.error?.message ?? errorBody.message ?? `HTTP ${response.status} error`
-        }
-      };
+        "X-Reporter-Hmac": await hmacSha256Hex(apiKey, `${projectId}.${ts}.${tokenHash}`)
+      });
+    } catch (error) {
+      return { ok: false, error: { code: "NETWORK_ERROR", message: error instanceof Error ? error.message : "Unknown error" } };
     }
-    const payload = await response.json();
-    return { ok: true, data: payload.data ?? payload };
   }
   return {
     async submitReport(report) {
@@ -474,6 +456,18 @@ function createApiClient(options) {
         "discovery"
       );
     },
+    /** POST /v1/sdk/events — batched product-analytics events (Mushi.track()).
+     *  Best-effort (1 retry); the event tracker spills unsent batches to
+     *  localStorage and replays them on the next page load. */
+    async postProductEvents(payload) {
+      return request(
+        "POST",
+        "/v1/sdk/events",
+        payload,
+        1,
+        "discovery"
+      );
+    },
     async submitActivity(userId, events, opts) {
       return request(
         "POST",
@@ -600,7 +594,7 @@ function sleep(ms) {
 function getBackoffDelay(attempt) {
   return Math.min(1e3 * 2 ** attempt + Math.random() * 500, 1e4);
 }
-function parseRetryAfter(value, now2 = Date.now()) {
+function parseRetryAfter(value, now3 = Date.now()) {
   if (!value) return null;
   const raw = value.trim();
   if (!raw) return null;
@@ -608,7 +602,7 @@ function parseRetryAfter(value, now2 = Date.now()) {
   if (Number.isFinite(seconds)) return seconds < 0 ? null : seconds * 1e3;
   const at = Date.parse(raw);
   if (Number.isNaN(at)) return null;
-  return Math.max(at - now2, 0);
+  return Math.max(at - now3, 0);
 }
 function isRetryable(error) {
   if (error instanceof DOMException && error.name === "AbortError") return true;
@@ -826,6 +820,8 @@ var KNOWN_CONFIG_KEYS = [
   "circuitBreaker",
   "preset",
   "runtimeConfig",
+  "analytics",
+  "trackSessions",
   "sentry",
   "widget",
   "capture",
@@ -917,23 +913,23 @@ function presetDefaults(preset) {
   }
 }
 function expandPreset(config) {
-  const defaults = presetDefaults(config.preset);
-  if (!defaults) return config;
+  const defaults2 = presetDefaults(config.preset);
+  if (!defaults2) return config;
   return {
     ...config,
     widget: {
-      ...defaults.widget,
+      ...defaults2.widget,
       ...config.widget
     },
     capture: {
-      ...defaults.capture,
+      ...defaults2.capture,
       ...config.capture
     },
     proactive: {
-      ...defaults.proactive,
+      ...defaults2.proactive,
       ...config.proactive,
       cooldown: {
-        ...defaults.proactive?.cooldown,
+        ...defaults2.proactive?.cooldown,
         ...config.proactive?.cooldown
       }
     }
@@ -1344,12 +1340,12 @@ function createOfflineQueue(config = {}) {
     const n = row.attempts;
     return typeof n === "number" && Number.isFinite(n) ? n : 0;
   }
-  function isExpired(row, now2) {
+  function isExpired(row, now3) {
     const queuedAt = row.queuedAt;
     if (!queuedAt) return false;
     const ts = Date.parse(queuedAt);
     if (Number.isNaN(ts)) return false;
-    return now2 - ts > MAX_QUEUE_AGE_MS;
+    return now3 - ts > MAX_QUEUE_AGE_MS;
   }
   function detectBackend() {
     if (backendType) return backendType;
@@ -1536,7 +1532,7 @@ function createOfflineQueue(config = {}) {
     await lsEnqueue(report);
     return "localstorage";
   }
-  async function enqueue(report) {
+  async function enqueue2(report) {
     if (!enabled) return;
     const currentSize = await size();
     if (currentSize >= maxQueueSize) {
@@ -1554,10 +1550,10 @@ function createOfflineQueue(config = {}) {
   async function runFlush(client) {
     const { backend, rows: storedRows } = await readRows();
     let rows = storedRows;
-    const now2 = Date.now();
+    const now3 = Date.now();
     const fresh = [];
     for (const row of rows) {
-      if (isExpired(row, now2)) {
+      if (isExpired(row, now3)) {
         const rowId = row.id;
         await removeRow(backend, rowId);
         queueLog.debug("Offline queue: evicting stale report", { id: rowId });
@@ -1705,7 +1701,7 @@ function createOfflineQueue(config = {}) {
     syncCleanup?.();
     syncCleanup = null;
   }
-  return { enqueue, flush, size, clear, startAutoSync, stopAutoSync };
+  return { enqueue: enqueue2, flush, size, clear, startAutoSync, stopAutoSync };
 }
 
 // src/environment.ts
@@ -2047,21 +2043,94 @@ function randomSuffix() {
   return n.toString(36).padStart(6, "0").slice(0, 6);
 }
 
+// src/analytics-gate.ts
+var AUTOMATED_UA_RE = /HeadlessChrome|PhantomJS|Lighthouse|\bbot\b|bot[/-]|crawler|spider/i;
+function consentKey(projectId) {
+  return "mushi_events_consent_" + projectId;
+}
+var listeners = /* @__PURE__ */ new Set();
+function dntActive() {
+  if (typeof navigator === "undefined") return false;
+  const nav = navigator;
+  if (nav.globalPrivacyControl === true) return true;
+  const winDnt = typeof window !== "undefined" ? window.doNotTrack : void 0;
+  const dnt = nav.doNotTrack ?? nav.msDoNotTrack ?? winDnt;
+  return dnt === "1" || dnt === "yes";
+}
+function isAutomatedBrowser() {
+  if (typeof navigator === "undefined") return false;
+  if (navigator.webdriver === true) return true;
+  return AUTOMATED_UA_RE.test(navigator.userAgent ?? "");
+}
+function analyticsBlockReason(config) {
+  if (config?.enabled === false) return "disabled";
+  if (config?.respectDoNotTrack !== false && dntActive()) return "dnt";
+  if (config?.excludeBots !== false && isAutomatedBrowser()) return "automation";
+  return null;
+}
+function readStoredConsent(projectId) {
+  if (!projectId) return null;
+  try {
+    const v = localStorage.getItem(consentKey(projectId));
+    return v === "granted" || v === "denied" ? v : null;
+  } catch {
+    return null;
+  }
+}
+function writeStoredConsent(projectId, state) {
+  if (!projectId) return;
+  try {
+    localStorage.setItem(consentKey(projectId), state);
+  } catch {
+  }
+}
+function resolveAnalyticsConsent(projectId, config) {
+  const stored = readStoredConsent(projectId);
+  if (config?.consent === "required") return stored ?? "pending";
+  return stored === "denied" ? "denied" : "granted";
+}
+function setAnalyticsConsent(projectId, state) {
+  writeStoredConsent(projectId, state);
+  for (const listener of [...listeners]) {
+    try {
+      listener(state);
+    } catch {
+    }
+  }
+}
+function onAnalyticsConsentChange(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
 // src/session-tracker.ts
 var HEARTBEAT_INTERVAL_MS = 6e4;
 var _client = null;
 var _sdkVersion;
 var _userIdHash = null;
-var _reporterTokenHash = null;
+var _reporterToken = null;
 var _pageViewCount = 0;
 var _heartbeatTimer = null;
 var _initialized = false;
+var _active = false;
+var _started = false;
+var _unsubscribeConsent = null;
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function currentRoute() {
   if (typeof window === "undefined") return "";
-  return window.location.pathname + window.location.search;
+  return window.location.pathname;
+}
+function referrerOrigin() {
+  if (typeof document === "undefined" || !document.referrer) return null;
+  try {
+    return new URL(document.referrer).origin;
+  } catch {
+    return null;
+  }
 }
 function userAgent() {
   if (typeof navigator === "undefined") return null;
@@ -2073,7 +2142,8 @@ function buildPayload(kind, extra) {
     session_id: getSessionId(),
     ts: now(),
     page_view_count: _pageViewCount,
-    reporter_token_hash: _reporterTokenHash,
+    // Wire name kept for older servers; the value is the raw token (hashed server-side).
+    reporter_token_hash: _reporterToken,
     user_id_hash: _userIdHash,
     user_agent: userAgent(),
     sdk_version: _sdkVersion,
@@ -2081,26 +2151,42 @@ function buildPayload(kind, extra) {
   };
 }
 function send(payload) {
-  if (!_client) return;
+  if (!_client || !_active) return;
   _client.postSessionEvent(payload).catch(() => {
   });
 }
+function recordPageView(route) {
+  if (!_active) return;
+  _pageViewCount += 1;
+  send(buildPayload("page_view", { route }));
+}
+function activate() {
+  if (_active || !_initialized) return;
+  _active = true;
+  if (!_started) {
+    _started = true;
+    _pageViewCount = 1;
+    send(buildPayload("session_start", { route: currentRoute(), referrer: referrerOrigin() }));
+  }
+  _heartbeatTimer = setInterval(() => {
+    send(buildPayload("session_heartbeat", { route: currentRoute() }));
+  }, HEARTBEAT_INTERVAL_MS);
+}
+function deactivate() {
+  _active = false;
+  if (_heartbeatTimer != null) {
+    clearInterval(_heartbeatTimer);
+    _heartbeatTimer = null;
+  }
+}
 function initSessionTracker(opts) {
   if (_initialized || typeof window === "undefined") return;
+  if (analyticsBlockReason(opts.analytics) !== null) return;
   _initialized = true;
   _client = opts.client;
   _sdkVersion = opts.sdkVersion;
-  _reporterTokenHash = opts.reporterTokenHash ?? null;
+  _reporterToken = opts.reporterToken ?? opts.reporterTokenHash ?? null;
   _userIdHash = opts.userIdHash ?? null;
-  const entryRoute = currentRoute();
-  _pageViewCount = 1;
-  send(buildPayload("session_start", {
-    route: entryRoute,
-    referrer: typeof document !== "undefined" ? document.referrer ?? null : null
-  }));
-  _heartbeatTimer = setInterval(() => {
-    send(buildPayload("session_heartbeat", { route: currentRoute() }));
-  }, HEARTBEAT_INTERVAL_MS);
   const onHide = () => {
     if (typeof document !== "undefined" && document.visibilityState === "hidden") {
       send(buildPayload("session_end", { route: currentRoute() }));
@@ -2109,46 +2195,423 @@ function initSessionTracker(opts) {
   if (typeof document !== "undefined") {
     document.addEventListener("visibilitychange", onHide, { passive: true });
   }
-  if (typeof window !== "undefined") {
-    window.addEventListener("pagehide", () => {
-      send(buildPayload("session_end", { route: currentRoute() }));
-    }, { passive: true });
+  window.addEventListener("pagehide", () => {
+    send(buildPayload("session_end", { route: currentRoute() }));
+  }, { passive: true });
+  if (opts.patchHistory !== false) {
+    patchHistoryForPageViews();
   }
-  patchHistoryForPageViews();
+  _unsubscribeConsent = onAnalyticsConsentChange((state) => {
+    if (state === "granted") activate();
+    else deactivate();
+  });
+  if (resolveAnalyticsConsent(opts.projectId ?? "", opts.analytics) === "granted") activate();
 }
 function trackPageView(route) {
   if (!_initialized || !_client) return;
-  _pageViewCount += 1;
-  send(buildPayload("page_view", { route: route ?? currentRoute() }));
+  recordPageView(route ?? currentRoute());
 }
 function updateSessionIdentity(userIdHash) {
   _userIdHash = userIdHash;
 }
 function destroySessionTracker() {
-  if (_heartbeatTimer != null) {
-    clearInterval(_heartbeatTimer);
-    _heartbeatTimer = null;
-  }
+  deactivate();
+  _unsubscribeConsent?.();
+  _unsubscribeConsent = null;
   _initialized = false;
+  _started = false;
   _client = null;
 }
 var _historyPatched = false;
 function patchHistoryForPageViews() {
   if (_historyPatched || typeof history === "undefined") return;
   _historyPatched = true;
-  const wrap = (original) => function(...args) {
+  const wrap = (original, countsAsPageView) => function(...args) {
     const result = original.apply(this, args);
-    if (original === history.pushState) {
-      _pageViewCount += 1;
-      send(buildPayload("page_view", { route: currentRoute() }));
+    if (countsAsPageView) recordPageView(currentRoute());
+    return result;
+  };
+  history.pushState = wrap(history.pushState, true);
+  history.replaceState = wrap(history.replaceState, false);
+  window.addEventListener("popstate", () => {
+    recordPageView(currentRoute());
+  }, { passive: true });
+}
+
+// src/analytics-taxonomy.ts
+var EVENT_NAME_RE = /^[a-z][a-z0-9_]{1,63}$/;
+var EVENT_PROPERTY_LIMITS = {
+  maxKeys: 40,
+  maxKeyLength: 64,
+  maxValueLength: 256,
+  maxBytes: 8192,
+  /** Client batch size before an immediate flush. */
+  maxClientBatch: 20,
+  /** Server-side per-request ceiling. */
+  maxServerBatch: 50,
+  /** Distinct event names per project before the server returns 422. */
+  maxEventNamesPerProject: 200
+};
+var RESERVED_PROPERTY_PREFIX = "$";
+var PII_PROPERTY_KEY_RE = /(email|phone|password|passwd|token|secret|ssn|address|credit|card|iban)/i;
+var MUSHI_SURFACES = ["web", "console", "docs", "cli", "mcp", "server", "mobile"];
+var MUSHI_EVENTS = {
+  // ── Any surface (SDK `analytics.autoPageviews`) ──────────────────────────
+  page_view: { surface: ["web", "docs", "console"], required: [] },
+  // ── Landing + docs (apps/docs) ───────────────────────────────────────────
+  // Every docs route; `route` repeats the reserved `$route` as a host prop so
+  // the requirement is checkable. company_funnel_weekly counts visits from
+  // this and landing_view.
+  docs_page_view: { surface: "docs", required: ["route"] },
+  landing_view: { surface: "docs", required: [] },
+  cta_click: { surface: "docs", required: ["cta_id", "location"] },
+  quickstart_view: { surface: "docs", required: [] },
+  pricing_view: { surface: "docs", required: [] },
+  connect_demo_click: { surface: "docs", required: ["href"] },
+  signup_click: { surface: "docs", required: ["href"] },
+  // ── Console (apps/admin) ─────────────────────────────────────────────────
+  signup_completed: { surface: "console", required: ["signup_source"] },
+  report_opened: { surface: ["console", "mcp"], required: ["report_id"] },
+  fix_context_pulled: { surface: ["console", "mcp"], required: ["report_id"] },
+  fix_dispatched: { surface: ["console", "mcp"], required: ["report_id", "agent"] },
+  invite_sent: { surface: "console", required: [] },
+  upgrade_clicked: { surface: "console", required: ["plan"] },
+  test_report_sent: { surface: "console", required: ["project_id"] },
+  diagnosis_viewed: { surface: "console", required: ["report_id", "project_id", "surface"] },
+  // ── Server-emitted (edge functions) ──────────────────────────────────────
+  project_created: { surface: "server", required: ["project_id"] },
+  key_minted: { surface: "server", required: ["project_id"] },
+  first_report_received: { surface: "server", required: ["project_id"] },
+  first_diagnosis_ready: { surface: "server", required: ["project_id"] },
+  fix_merged: { surface: "server", required: ["project_id"] },
+  upgrade_completed: { surface: "server", required: ["project_id", "plan"] },
+  // ── Growth loop (widget "Bug reports by Mushi" mark) ─────────────────────
+  loop_impression: { surface: "web", required: [] },
+  loop_click: { surface: "web", required: [] },
+  loop_signup: { surface: "console", required: ["ref"] }
+};
+var MUSHI_EVENT_NAMES = Object.keys(MUSHI_EVENTS);
+var ACTIVATION_EVENT = "first_report_received";
+var HABIT_EVENTS = ["report_opened", "fix_context_pulled", "fix_dispatched"];
+function isValidEventName(name) {
+  return typeof name === "string" && EVENT_NAME_RE.test(name);
+}
+function sanitizeEventProperties(input, opts = {}) {
+  const out = {};
+  const dropped = [];
+  if (!input || typeof input !== "object" || Array.isArray(input)) return { properties: out, dropped };
+  const allow = new Set(opts.allowlist ?? []);
+  let keys = 0;
+  for (const [rawKey, rawValue] of Object.entries(input)) {
+    if (keys >= EVENT_PROPERTY_LIMITS.maxKeys) {
+      dropped.push(rawKey);
+      continue;
+    }
+    const key = rawKey.slice(0, EVENT_PROPERTY_LIMITS.maxKeyLength);
+    if (key.startsWith(RESERVED_PROPERTY_PREFIX) && !opts.allowReserved) {
+      dropped.push(key);
+      continue;
+    }
+    if (PII_PROPERTY_KEY_RE.test(key) && !allow.has(key)) {
+      dropped.push(key);
+      continue;
+    }
+    let value;
+    if (rawValue === null || typeof rawValue === "boolean") value = rawValue;
+    else if (typeof rawValue === "number") value = Number.isFinite(rawValue) ? rawValue : null;
+    else if (typeof rawValue === "string") {
+      const s = rawValue.slice(0, EVENT_PROPERTY_LIMITS.maxValueLength);
+      value = opts.scrub ? opts.scrub(s) : s;
+    } else if (rawValue instanceof Date) value = rawValue.toISOString();
+    else {
+      dropped.push(key);
+      continue;
+    }
+    out[key] = value;
+    keys += 1;
+  }
+  return { properties: out, dropped };
+}
+function propertiesWithinByteLimit(properties) {
+  try {
+    return JSON.stringify(properties).length <= EVENT_PROPERTY_LIMITS.maxBytes;
+  } catch {
+    return false;
+  }
+}
+
+// src/event-tracker.ts
+var _client2 = null;
+var _projectId = "";
+var _anonId = null;
+var _userId = null;
+var _userTraits = null;
+var _sdkVersion2;
+var _config = defaults();
+var _scrub;
+var _getSessionId;
+var _buffer = [];
+var _consentBuffer = [];
+var _consent = "granted";
+var _sampledIn = true;
+var _flushTimer = null;
+var _initialized2 = false;
+var _flushing = false;
+var _pendingIdentify = false;
+var _unsubscribeConsent2 = null;
+var CONSENT_BUFFER_MAX = 50;
+var SPILL_MAX = 200;
+var SPILL_TTL_MS = 24 * 60 * 60 * 1e3;
+function defaults() {
+  return {
+    sampleRate: 1,
+    autoPageviews: false,
+    flushIntervalMs: 5e3,
+    surface: "web",
+    propertyAllowlist: []
+  };
+}
+function now2() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function spillKey() {
+  return "mushi_events_spill_" + _projectId;
+}
+function isRetryableStatus(status) {
+  return status === void 0 || status === 429 || status >= 500;
+}
+function analyticsIdKey() {
+  return "mushi_analytics_id_" + _projectId;
+}
+function loadOrMintAnalyticsId() {
+  try {
+    const stored = localStorage.getItem(analyticsIdKey());
+    if (stored) return stored;
+  } catch {
+  }
+  return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : "a-" + Math.random().toString(36).slice(2) + Date.now().toString(36);
+}
+function persistAnalyticsId() {
+  if (!_anonId) return;
+  try {
+    if (localStorage.getItem(analyticsIdKey()) !== _anonId) localStorage.setItem(analyticsIdKey(), _anonId);
+  } catch {
+  }
+}
+function hashToUnit(s) {
+  let h = 2166136261;
+  for (let i = 0; i < s.length; i += 1) {
+    h ^= s.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return (h >>> 0) / 4294967296;
+}
+function readSpill() {
+  try {
+    const raw = localStorage.getItem(spillKey());
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    if (!parsed || Date.now() - parsed.at > SPILL_TTL_MS) {
+      localStorage.removeItem(spillKey());
+      return [];
+    }
+    return Array.isArray(parsed.events) ? parsed.events.slice(0, SPILL_MAX) : [];
+  } catch {
+    return [];
+  }
+}
+function writeSpill(events) {
+  try {
+    if (events.length === 0) {
+      localStorage.removeItem(spillKey());
+      return;
     }
+    localStorage.setItem(spillKey(), JSON.stringify({ at: Date.now(), events: events.slice(-SPILL_MAX) }));
+  } catch {
+  }
+}
+function takeSpill() {
+  const events = readSpill();
+  if (events.length > 0) writeSpill([]);
+  return events;
+}
+function buildPayload2(events) {
+  return {
+    anon_id: _anonId,
+    user_id: _userId,
+    user_traits: _userTraits,
+    session_id: _getSessionId ? _getSessionId() : null,
+    sdk_version: _sdkVersion2,
+    surface: _config.surface,
+    events
+  };
+}
+async function flushNow() {
+  if (!_client2 || _flushing || _consent !== "granted") return;
+  if (_buffer.length === 0 && !_pendingIdentify) return;
+  _flushing = true;
+  persistAnalyticsId();
+  const batch = _buffer.splice(0, EVENT_PROPERTY_LIMITS.maxServerBatch);
+  if (_pendingIdentify) {
+    batch.unshift({ name: "identify", ts: now2(), properties: {} });
+    _pendingIdentify = false;
+  }
+  try {
+    const res = await _client2.postProductEvents(buildPayload2(batch));
+    if (res.ok) {
+      writeSpill([]);
+    } else if (isRetryableStatus(res.error?.status)) {
+      writeSpill([...readSpill(), ...batch.filter((e) => e.name !== "identify")]);
+    }
+  } catch {
+    writeSpill([...readSpill(), ...batch.filter((e) => e.name !== "identify")]);
+  } finally {
+    _flushing = false;
+  }
+  if (_buffer.length >= EVENT_PROPERTY_LIMITS.maxClientBatch) void flushNow();
+}
+function enqueue(ev) {
+  if (_consent === "denied") return false;
+  if (_consent === "pending") {
+    if (_consentBuffer.length >= CONSENT_BUFFER_MAX) return false;
+    _consentBuffer.push(ev);
+    return true;
+  }
+  _buffer.push(ev);
+  if (_buffer.length >= EVENT_PROPERTY_LIMITS.maxClientBatch) void flushNow();
+  return true;
+}
+function applyConsent(state) {
+  if (state === "denied") {
+    _consent = "denied";
+    _buffer = [];
+    _consentBuffer = [];
+    _pendingIdentify = false;
+    writeSpill([]);
+    return;
+  }
+  const wasPending = _consent === "pending";
+  _consent = "granted";
+  if (wasPending) {
+    _buffer.push(...takeSpill(), ..._consentBuffer);
+    _consentBuffer = [];
+  }
+  if (_buffer.length > 0 || _pendingIdentify) void flushNow();
+}
+function stripUndefined(o) {
+  const out = {};
+  for (const [k, v] of Object.entries(o)) {
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+function isEventTrackingActive() {
+  return _initialized2 && _consent === "granted" && _sampledIn;
+}
+function getEventAnonymousId() {
+  if (!_initialized2 || _consent === "denied") return null;
+  return _anonId;
+}
+function initEventTracker(opts) {
+  if (_initialized2) return;
+  if (typeof window === "undefined") return;
+  const cfg = opts.config ?? {};
+  _config = { ...defaults(), ...stripUndefined(cfg), propertyAllowlist: cfg.propertyAllowlist ?? [] };
+  _projectId = opts.projectId;
+  if (analyticsBlockReason(cfg) !== null) return;
+  _initialized2 = true;
+  _client2 = opts.client;
+  _anonId = opts.anonId ?? loadOrMintAnalyticsId();
+  _userId = opts.userId ?? null;
+  _sdkVersion2 = opts.sdkVersion;
+  _scrub = opts.scrub;
+  _getSessionId = opts.getSessionId;
+  const rate = Math.min(1, Math.max(0, _config.sampleRate));
+  _sampledIn = rate >= 1 ? true : rate <= 0 ? false : hashToUnit(_anonId ?? "anon") < rate;
+  if (!_sampledIn) return;
+  _consent = resolveAnalyticsConsent(_projectId, cfg);
+  if (_consent === "granted") _buffer.push(...takeSpill());
+  else if (_consent === "denied") writeSpill([]);
+  _unsubscribeConsent2 = onAnalyticsConsentChange(applyConsent);
+  const interval = Math.max(1e3, _config.flushIntervalMs);
+  _flushTimer = setInterval(() => {
+    void flushNow();
+  }, interval);
+  const onHide = () => {
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") void flushNow();
+  };
+  if (typeof document !== "undefined") document.addEventListener("visibilitychange", onHide, { passive: true });
+  window.addEventListener("pagehide", () => {
+    void flushNow();
+  }, { passive: true });
+  if (_config.autoPageviews) patchHistory();
+}
+function trackEvent(name, properties, opts) {
+  if (!_initialized2 || !_sampledIn) return false;
+  if (!isValidEventName(name)) return false;
+  const { properties: props } = sanitizeEventProperties(properties, {
+    allowlist: _config.propertyAllowlist,
+    scrub: _scrub
+  });
+  let merged = props;
+  if (opts?.reserved) {
+    const { properties: res } = sanitizeEventProperties(opts.reserved, { allowReserved: true, scrub: _scrub });
+    merged = { ...props, ...res };
+  }
+  merged.$surface = _config.surface;
+  if (typeof location !== "undefined" && merged.$route === void 0) merged.$route = location.pathname;
+  if (!propertiesWithinByteLimit(merged)) return false;
+  return enqueue({
+    name,
+    ts: opts?.ts ?? now2(),
+    properties: merged,
+    ...opts?.dedupKey ? { dedup_key: opts.dedupKey } : {}
+  });
+}
+function setEventConsent(state) {
+  if (!_initialized2) _consent = state;
+  setAnalyticsConsent(_projectId, state);
+}
+function updateEventIdentity(userId, traits) {
+  _userId = userId;
+  _userTraits = traits ?? null;
+  if (!_initialized2 || !_sampledIn || !userId || _consent === "denied") return;
+  _pendingIdentify = true;
+  if (_consent === "granted") void flushNow();
+}
+function flushEvents() {
+  return flushNow();
+}
+function destroyEventTracker() {
+  if (_flushTimer != null) {
+    clearInterval(_flushTimer);
+    _flushTimer = null;
+  }
+  _unsubscribeConsent2?.();
+  _unsubscribeConsent2 = null;
+  _initialized2 = false;
+  _client2 = null;
+  _buffer = [];
+  _consentBuffer = [];
+  _consent = "granted";
+  _sampledIn = true;
+  _pendingIdentify = false;
+  _userId = null;
+  _userTraits = null;
+  _config = defaults();
+}
+var _historyPatched2 = false;
+function patchHistory() {
+  if (_historyPatched2 || typeof history === "undefined") return;
+  _historyPatched2 = true;
+  const original = history.pushState;
+  history.pushState = function(...args) {
+    const result = original.apply(this, args);
+    trackEvent("page_view");
     return result;
   };
-  history.pushState = wrap(history.pushState);
-  history.replaceState = wrap(history.replaceState);
   window.addEventListener("popstate", () => {
-    _pageViewCount += 1;
-    send(buildPayload("page_view", { route: currentRoute() }));
+    trackEvent("page_view");
   }, { passive: true });
 }
 
@@ -2165,12 +2628,12 @@ function createRateLimiter(config = {}) {
   let tokens = maxBurst;
   let lastRefill = Date.now();
   function refill() {
-    const now2 = Date.now();
-    const elapsed = now2 - lastRefill;
+    const now3 = Date.now();
+    const elapsed = now3 - lastRefill;
     const refills = Math.floor(elapsed / refillIntervalMs);
     if (refills > 0) {
       tokens = Math.min(maxBurst, tokens + refills * refillRate);
-      lastRefill = now2;
+      lastRefill = now3;
     }
   }
   function tryConsume() {
@@ -2568,15 +3031,15 @@ function mushiTokens(mode) {
 // src/identity.ts
 var MUSHI_IDENTITY_TOKEN_PREFIX = "mushi.identity";
 function buildIdentityClaims(input) {
-  const now2 = Math.floor(Date.now() / 1e3);
+  const now3 = Math.floor(Date.now() / 1e3);
   const ttl = input.ttlSeconds && input.ttlSeconds > 0 ? Math.min(input.ttlSeconds, 3600) : 600;
   return {
     projectId: input.projectId,
     sub: input.userId,
     ...input.email ? { email: input.email } : {},
     ...input.name ? { name: input.name } : {},
-    iat: now2,
-    exp: now2 + ttl
+    iat: now3,
+    exp: now3 + ttl
   };
 }
 function base64UrlDecode(segment) {
@@ -2803,9 +3266,13 @@ function isSafeFaviconHref(href) {
   }
 }
 
+exports.ACTIVATION_EVENT = ACTIVATION_EVENT;
 exports.DEFAULT_API_ENDPOINT = DEFAULT_API_ENDPOINT;
 exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES;
 exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
+exports.EVENT_NAME_RE = EVENT_NAME_RE;
+exports.EVENT_PROPERTY_LIMITS = EVENT_PROPERTY_LIMITS;
+exports.HABIT_EVENTS = HABIT_EVENTS;
 exports.MAX_REPORT_PAYLOAD_BYTES = MAX_REPORT_PAYLOAD_BYTES;
 exports.MAX_SCREENSHOT_DATA_URL_BYTES = MAX_SCREENSHOT_DATA_URL_BYTES;
 exports.MUSHI_ACCENT_SHADOW = MUSHI_ACCENT_SHADOW;
@@ -2818,6 +3285,8 @@ exports.MUSHI_COLORS_LIGHT = MUSHI_COLORS_LIGHT;
 exports.MUSHI_CONTROL_DISABLED = MUSHI_CONTROL_DISABLED;
 exports.MUSHI_COPY = MUSHI_COPY;
 exports.MUSHI_DURATION = MUSHI_DURATION;
+exports.MUSHI_EVENTS = MUSHI_EVENTS;
+exports.MUSHI_EVENT_NAMES = MUSHI_EVENT_NAMES;
 exports.MUSHI_GEOMETRY = MUSHI_GEOMETRY;
 exports.MUSHI_IDENTITY_TOKEN_PREFIX = MUSHI_IDENTITY_TOKEN_PREFIX;
 exports.MUSHI_INTERNAL_HEADER = MUSHI_INTERNAL_HEADER;
@@ -2834,11 +3303,13 @@ exports.MUSHI_SDK_PACKAGE_HEADER = MUSHI_SDK_PACKAGE_HEADER;
 exports.MUSHI_SDK_VERSION_HEADER = MUSHI_SDK_VERSION_HEADER;
 exports.MUSHI_SHADOW_INK = MUSHI_SHADOW_INK;
 exports.MUSHI_SPACING = MUSHI_SPACING;
+exports.MUSHI_SURFACES = MUSHI_SURFACES;
 exports.MUSHI_TIER_COLORS = MUSHI_TIER_COLORS;
 exports.MUSHI_TYPE = MUSHI_TYPE;
 exports.MUSHI_USER_TOKEN_HEADER = MUSHI_USER_TOKEN_HEADER;
 exports.MUSHI_Z = MUSHI_Z;
 exports.REGION_ENDPOINTS = REGION_ENDPOINTS;
+exports.analyticsBlockReason = analyticsBlockReason;
 exports.buildBeaconEnvelope = buildBeaconEnvelope;
 exports.buildIdentityClaims = buildIdentityClaims;
 exports.buildSdkIngestHeaders = buildSdkIngestHeaders;
@@ -2851,26 +3322,34 @@ exports.createOfflineQueue = createOfflineQueue;
 exports.createPiiScrubber = createPiiScrubber;
 exports.createPreFilter = createPreFilter;
 exports.createRateLimiter = createRateLimiter;
+exports.destroyEventTracker = destroyEventTracker;
 exports.destroySessionTracker = destroySessionTracker;
 exports.diagnoseEnvConfig = diagnoseEnvConfig;
+exports.dntActive = dntActive;
 exports.estimateJsonBytes = estimateJsonBytes;
 exports.expandPreset = expandPreset;
 exports.extractTunnelPath = extractTunnelPath;
 exports.faviconUrlCandidates = faviconUrlCandidates;
+exports.flushEvents = flushEvents;
 exports.flushLastOutboundOnUnload = flushLastOutboundOnUnload;
 exports.formatBytes = formatBytes;
 exports.getBackoffDelay = getBackoffDelay;
 exports.getDeviceFingerprintHash = getDeviceFingerprintHash;
+exports.getEventAnonymousId = getEventAnonymousId;
 exports.getReporterToken = getReporterToken;
 exports.getSessionId = getSessionId;
 exports.githubRepoDomainHint = githubRepoDomainHint;
 exports.hmacSha256Hex = hmacSha256Hex;
+exports.initEventTracker = initEventTracker;
 exports.initSessionTracker = initSessionTracker;
+exports.isAutomatedBrowser = isAutomatedBrowser;
+exports.isEventTrackingActive = isEventTrackingActive;
 exports.isLikelyGenericFavicon = isLikelyGenericFavicon;
 exports.isMushiBeaconEnvelope = isMushiBeaconEnvelope;
 exports.isPageUnloading = isPageUnloading;
 exports.isSameOriginOrRelative = isSameOriginOrRelative;
 exports.isUntrustedFaviconUrl = isUntrustedFaviconUrl;
+exports.isValidEventName = isValidEventName;
 exports.markPageUnloading = markPageUnloading;
 exports.matchesErrorFilter = matchesErrorFilter;
 exports.mushiPalette = mushiPalette;
@@ -2878,13 +3357,16 @@ exports.mushiTokens = mushiTokens;
 exports.newUuid = newUuid;
 exports.noopLogger = noopLogger;
 exports.normaliseThrown = normaliseThrown;
+exports.onAnalyticsConsentChange = onAnalyticsConsentChange;
 exports.originToDomain = originToDomain;
 exports.parseIdentityToken = parseIdentityToken;
 exports.parseRetryAfter = parseRetryAfter;
 exports.projectFaviconUrlCandidates = projectFaviconUrlCandidates;
 exports.projectInitials = projectInitials;
 exports.projectInitialsThemeIndex = projectInitialsThemeIndex;
+exports.propertiesWithinByteLimit = propertiesWithinByteLimit;
 exports.readPageFaviconHref = readPageFaviconHref;
+exports.resolveAnalyticsConsent = resolveAnalyticsConsent;
 exports.resolveEnvConfig = resolveEnvConfig;
 exports.resolveProjectDomain = resolveProjectDomain;
 exports.resolveProjectFaviconDomains = resolveProjectFaviconDomains;
@@ -2892,12 +3374,17 @@ exports.resolveRegionEndpoint = resolveRegionEndpoint;
 exports.resolveRequestBaseUrl = resolveRequestBaseUrl;
 exports.resolveWidgetAccent = resolveWidgetAccent;
 exports.safeWidgetHex = safeWidgetHex;
+exports.sanitizeEventProperties = sanitizeEventProperties;
 exports.scrubPii = scrubPii;
 exports.scrubUrl = scrubUrl;
 exports.sendOnUnload = sendOnUnload;
+exports.setAnalyticsConsent = setAnalyticsConsent;
+exports.setEventConsent = setEventConsent;
 exports.sha256Hex = sha256Hex;
 exports.shouldDropCapturedError = shouldDropCapturedError;
+exports.trackEvent = trackEvent;
 exports.trackPageView = trackPageView;
+exports.updateEventIdentity = updateEventIdentity;
 exports.updateSessionIdentity = updateSessionIdentity;
 exports.validateConfig = validateConfig;
 //# sourceMappingURL=index.cjs.map