sitepong 0.2.0 → 0.2.2

package/dist/react/index.mjs

@@ -1,5 +1,4 @@
 import { createContext, useRef, useEffect, Component, useContext, useCallback, useState } from 'react';
-import 'web-vitals';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 // src/react/provider.tsx
@@ -522,6 +521,60 @@ function clearSession() {
   memorySessionTs = null;
 }
 
+// src/analytics/utm.ts
+var STORAGE_KEY2 = "sp_utm";
+var UTM_KEYS = [
+  ["source", "utm_source"],
+  ["medium", "utm_medium"],
+  ["campaign", "utm_campaign"],
+  ["term", "utm_term"],
+  ["content", "utm_content"]
+];
+function parseFromLocation() {
+  if (typeof window === "undefined" || !window.location || !window.location.search) return null;
+  let params;
+  try {
+    params = new URLSearchParams(window.location.search);
+  } catch {
+    return null;
+  }
+  const result = {};
+  let found = false;
+  for (const [key, queryKey] of UTM_KEYS) {
+    const value = params.get(queryKey);
+    if (value) {
+      result[key] = value;
+      found = true;
+    }
+  }
+  return found ? result : null;
+}
+function readStored() {
+  if (typeof sessionStorage === "undefined") return null;
+  try {
+    const raw = sessionStorage.getItem(STORAGE_KEY2);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeStored(utm) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(STORAGE_KEY2, JSON.stringify(utm));
+  } catch {
+  }
+}
+function getSessionUtm() {
+  const stored = readStored();
+  if (stored) return stored;
+  const fresh = parseFromLocation();
+  if (fresh) writeStored(fresh);
+  return fresh;
+}
+
 // src/analytics/autocapture.ts
 var DEFAULT_BLOCK_SELECTORS = [
   "[data-sp-no-capture]",
@@ -530,6 +583,7 @@ var DEFAULT_BLOCK_SELECTORS = [
 var MAX_TEXT_LENGTH = 255;
 var AutocaptureModule = class {
   constructor(config, callback) {
+    this.listeners = [];
     this.clickHandler = null;
     this.submitHandler = null;
     this.active = false;
@@ -544,6 +598,27 @@ var AutocaptureModule = class {
     };
     this.callback = callback;
   }
+  /**
+   * Register a secondary listener that receives the same events as the
+   * primary callback (e.g. Watchtower tap capture reusing the single click
+   * listener + selector resolution). Returns an unsubscribe function.
+   */
+  addListener(cb) {
+    this.listeners.push(cb);
+    return () => {
+      const idx = this.listeners.indexOf(cb);
+      if (idx >= 0) this.listeners.splice(idx, 1);
+    };
+  }
+  emit(event) {
+    this.callback(event);
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch {
+      }
+    }
+  }
   start() {
     if (this.active || typeof document === "undefined" || typeof document.addEventListener !== "function") return;
     this.active = true;
@@ -576,7 +651,7 @@ var AutocaptureModule = class {
       properties.$event_type = "click";
       properties.$x = e.clientX;
       properties.$y = e.clientY;
-      this.callback({
+      this.emit({
         type: "click",
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         properties
@@ -598,7 +673,7 @@ var AutocaptureModule = class {
       };
       const elemProps = this.getElementProperties(form);
       Object.assign(properties, elemProps);
-      this.callback({
+      this.emit({
         type: "form_submit",
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         properties
@@ -815,6 +890,14 @@ var AnalyticsManager = class {
     );
     this.autocaptureModule.start();
   }
+  /**
+   * The live AutocaptureModule (if click/form autocapture is enabled) —
+   * Watchtower tap capture attaches to it so there is only ONE document-level
+   * click listener and one selector/element resolution path.
+   */
+  getAutocaptureModule() {
+    return this.autocaptureModule;
+  }
   track(eventName, properties) {
     if (!this.config.enabled) return;
     const event = this.createEvent("track", { name: eventName, properties });
@@ -928,7 +1011,9 @@ var AnalyticsManager = class {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       url: typeof window !== "undefined" && window.location ? window.location.href : void 0,
       referrer: typeof document !== "undefined" && typeof document.referrer === "string" ? document.referrer : void 0,
-      userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0
+      userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
+      utm: getSessionUtm() || void 0,
+      appVersion: this.config.appVersion || void 0
     };
   }
   enqueue(event) {
@@ -1626,7 +1711,7 @@ var DEFAULT_REMOTE_CONFIG = {
 };
 
 // src/remote-config/manager.ts
-var STORAGE_KEY2 = "sitepong_remote_config";
+var STORAGE_KEY3 = "sitepong_remote_config";
 var STORAGE_TS_KEY = "sitepong_remote_config_ts";
 var RemoteConfigManager = class {
   constructor(options) {
@@ -1669,7 +1754,7 @@ var RemoteConfigManager = class {
     const storage = this.options.storage;
     if (!storage) return;
     try {
-      const cached = await storage.getItem(STORAGE_KEY2);
+      const cached = await storage.getItem(STORAGE_KEY3);
       const cachedTs = await storage.getItem(STORAGE_TS_KEY);
       if (cached && cachedTs) {
         const age = Date.now() - parseInt(cachedTs, 10);
@@ -1730,7 +1815,7 @@ var RemoteConfigManager = class {
     const storage = this.options.storage;
     if (!storage) return;
     try {
-      await storage.setItem(STORAGE_KEY2, JSON.stringify(this.config));
+      await storage.setItem(STORAGE_KEY3, JSON.stringify(this.config));
       await storage.setItem(STORAGE_TS_KEY, String(Date.now()));
     } catch {
       this.log("Failed to cache remote config");
@@ -1986,7 +2071,7 @@ function stripTrailingSlash(url) {
 var superlinkClient = new SuperLinkClient();
 
 // src/superlink/parse.ts
-var UTM_KEYS = [
+var UTM_KEYS2 = [
   ["source", "utm_source"],
   ["medium", "utm_medium"],
   ["campaign", "utm_campaign"],
@@ -2002,7 +2087,7 @@ function parseUniversalLink(url) {
   }
   const params = parsed.searchParams;
   const utm = {};
-  for (const [key, queryKey] of UTM_KEYS) {
+  for (const [key, queryKey] of UTM_KEYS2) {
     const value = params.get(queryKey);
     if (value) utm[key] = value;
   }
@@ -2069,13 +2154,13 @@ function getMatchedDeepLink() {
 }
 
 // src/superlink/web.ts
-var STORAGE_KEY3 = "sp_superlink";
+var STORAGE_KEY4 = "sp_superlink";
 var captured = null;
 var didCapture = false;
-function readStored() {
+function readStored2() {
   if (typeof sessionStorage === "undefined") return null;
   try {
-    const raw = sessionStorage.getItem(STORAGE_KEY3);
+    const raw = sessionStorage.getItem(STORAGE_KEY4);
     if (!raw) return null;
     const parsed = JSON.parse(raw);
     return parsed && typeof parsed === "object" ? parsed : null;
@@ -2083,10 +2168,10 @@ function readStored() {
     return null;
   }
 }
-function writeStored(link) {
+function writeStored2(link) {
   if (typeof sessionStorage === "undefined") return;
   try {
-    sessionStorage.setItem(STORAGE_KEY3, JSON.stringify(link));
+    sessionStorage.setItem(STORAGE_KEY4, JSON.stringify(link));
   } catch {
   }
 }
@@ -2134,7 +2219,7 @@ function extractIdentityMetadata(url) {
 function captureWebDeepLink() {
   if (didCapture) return captured;
   didCapture = true;
-  const stored = readStored();
+  const stored = readStored2();
   if (stored) {
     captured = stored;
     return captured;
@@ -2143,7 +2228,7 @@ function captureWebDeepLink() {
   const link = parseUniversalLink(window.location.href);
   if (link && hasPayload(link)) {
     captured = link;
-    writeStored(link);
+    writeStored2(link);
     void superlinkClient.reportEvent({
       type: "opened",
       click_id: link.click_id,
@@ -2324,6 +2409,8 @@ var SitePongClient = class {
     this.databaseTracker = null;
     this.profiler = null;
     this.remoteConfigManager = null;
+    this.watchtowerCapture = null;
+    this.watchtowerOptions = void 0;
     this.envUnsubs = [];
     this.identifyHooks = [];
     this.config = {
@@ -2443,6 +2530,12 @@ var SitePongClient = class {
     } else if (config.replay?.enabled) {
       this.log("Replay requested but not available on this platform (web only).");
     }
+    this.watchtowerOptions = config.watchtower;
+    if (config.watchtower?.enabled && webManagerFactories.createWatchtowerCapture) {
+      this.startWatchtowerCapture();
+    } else if (config.watchtower?.enabled) {
+      this.log("Watchtower capture requested but not available on this platform (web only).");
+    }
     if (config.crons?.enabled) {
       this.cronManager = new CronMonitorManager({
         apiKey: config.apiKey,
@@ -2682,6 +2775,7 @@ var SitePongClient = class {
         this.log("identify hook failed:", err);
       }
     }
+    this.watchtowerCapture?.setDistinctId(userId);
     if (!this.analyticsManager) {
       this.log("Analytics not enabled. Set analytics.enabled: true in init()");
       return;
@@ -2749,6 +2843,49 @@ var SitePongClient = class {
   getReplaySessionId() {
     return this.replayManager?.getSessionId() ?? null;
   }
+  // --- Watchtower tap capture (web) ---
+  /**
+   * Start Watchtower web tap capture. Options merge over `watchtower` from
+   * init(); `projectId` is required (either here or in init config). Reuses
+   * the analytics AutocaptureModule's click listener when autocapture is on.
+   */
+  startWatchtowerCapture(options) {
+    if (!webManagerFactories.createWatchtowerCapture) {
+      this.log("Watchtower capture not available on this platform (web only).");
+      return false;
+    }
+    if (!this.initialized || !this.config.apiKey) {
+      this.log("Watchtower capture requires init() to be called first.");
+      return false;
+    }
+    const opts = { ...this.watchtowerOptions, ...options };
+    if (!opts.projectId) {
+      this.log("Watchtower capture requires watchtower.projectId.");
+      return false;
+    }
+    if (this.watchtowerCapture) {
+      this.watchtowerCapture.stop();
+      this.watchtowerCapture = null;
+    }
+    this.watchtowerCapture = webManagerFactories.createWatchtowerCapture({
+      apiKey: this.config.apiKey,
+      projectId: opts.projectId,
+      endpoint: opts.endpoint || this.config.endpoint || DEFAULT_ENDPOINT3,
+      appVersion: this.config.release || void 0,
+      maxBatchSize: opts.maxBatchSize,
+      flushInterval: opts.flushInterval,
+      blockSelector: opts.blockSelector,
+      maskSelector: opts.maskSelector,
+      debug: this.config.debug
+    });
+    this.watchtowerCapture.start(this.analyticsManager?.getAutocaptureModule() ?? null);
+    return true;
+  }
+  stopWatchtowerCapture() {
+    if (!this.watchtowerCapture) return;
+    this.watchtowerCapture.stop();
+    this.watchtowerCapture = null;
+  }
   // --- Performance (Tier 7) ---
   startTransaction(name, data) {
     if (!this.performanceManager) {
@@ -2900,6 +3037,7 @@ var SitePongClient = class {
     if (this.replayManager) {
       this.replayManager.setUser(null);
     }
+    this.watchtowerCapture?.setDistinctId(null);
   }
   addBreadcrumb(breadcrumb) {
     this.log("Breadcrumb added:", breadcrumb);
@@ -3124,6 +3262,8 @@ var getDeviceSignals = sitepong.getDeviceSignals.bind(sitepong);
 var getFraudCheck = sitepong.getFraudCheck.bind(sitepong);
 var startReplay = sitepong.startReplay.bind(sitepong);
 var stopReplay = sitepong.stopReplay.bind(sitepong);
+var startWatchtowerCapture = sitepong.startWatchtowerCapture.bind(sitepong);
+var stopWatchtowerCapture = sitepong.stopWatchtowerCapture.bind(sitepong);
 var isReplayRecording = sitepong.isReplayRecording.bind(sitepong);
 var getReplaySessionId = sitepong.getReplaySessionId.bind(sitepong);
 var startTransaction = sitepong.startTransaction.bind(sitepong);
@@ -3524,6 +3664,6 @@ function useReplay() {
   return { recording, start, stop };
 }
 
-export { DEFAULT_SUPERLINK_ENDPOINT, SitePongContext, SitePongErrorBoundary, SitePongProvider, SuperLinkClient, TracePropagator, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload2 as getVariantPayload, getVisitorId, getWebVitals, group, identify2 as identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, stopReplay, superlinkClient, identify as superlinkIdentify, track, trackPageView, useAddBreadcrumb, useAllFlags, useCaptureException, useCaptureMessage, useErrorCapture, useExperiment, useFeatureFlag, useFeatureFlagPayload, useFraudCheck, useGroup, useIdentify, usePerformanceTransaction, useReplay, useSetUser, useSitePong, useTrack, useTrackPageView, useVisitorId, useWebVitals, waitForFlags, writeClipboardToken };
+export { DEFAULT_SUPERLINK_ENDPOINT, SitePongContext, SitePongErrorBoundary, SitePongProvider, SuperLinkClient, TracePropagator, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload2 as getVariantPayload, getVisitorId, getWebVitals, group, identify2 as identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, startWatchtowerCapture, stopReplay, stopWatchtowerCapture, superlinkClient, identify as superlinkIdentify, track, trackPageView, useAddBreadcrumb, useAllFlags, useCaptureException, useCaptureMessage, useErrorCapture, useExperiment, useFeatureFlag, useFeatureFlagPayload, useFraudCheck, useGroup, useIdentify, usePerformanceTransaction, useReplay, useSetUser, useSitePong, useTrack, useTrackPageView, useVisitorId, useWebVitals, waitForFlags, writeClipboardToken };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map