sitepong 0.2.0 → 0.2.2

package/dist/index.js

@@ -2,8 +2,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-require('web-vitals');
-
 // src/flags/anonymous-id.ts
 var STORAGE_KEY = "sitepong_anonymous_id";
 function generateUUID() {
@@ -522,6 +520,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 +582,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 +597,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 +650,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 +672,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 +889,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 +1010,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 +1710,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 +1753,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 +1814,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 +2070,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 +2086,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 +2153,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 +2167,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 +2218,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 +2227,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 +2408,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 +2529,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 +2774,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 +2842,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 +3036,7 @@ var SitePongClient = class {
     if (this.replayManager) {
       this.replayManager.setUser(null);
     }
+    this.watchtowerCapture?.setDistinctId(null);
   }
   addBreadcrumb(breadcrumb) {
     this.log("Breadcrumb added:", breadcrumb);
@@ -3124,6 +3261,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);
@@ -3237,7 +3376,9 @@ exports.startProfileSpan = startProfileSpan;
 exports.startReplay = startReplay;
 exports.startSpan = startSpan;
 exports.startTransaction = startTransaction;
+exports.startWatchtowerCapture = startWatchtowerCapture;
 exports.stopReplay = stopReplay;
+exports.stopWatchtowerCapture = stopWatchtowerCapture;
 exports.superlinkClient = superlinkClient;
 exports.superlinkIdentify = identify;
 exports.track = track;