sitepong 0.1.13 → 0.2.1

package/dist/react/index.mjs

@@ -1,4 +1,5 @@
 import { createContext, useRef, useEffect, Component, useContext, useCallback, useState } from 'react';
+import 'web-vitals';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 // src/react/provider.tsx
@@ -521,6 +522,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]",
@@ -927,7 +982,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) {
@@ -1625,7 +1682,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) {
@@ -1668,7 +1725,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);
@@ -1729,7 +1786,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");
@@ -1908,6 +1965,292 @@ var TracePropagator = class {
   }
 };
 
+// src/superlink/client.ts
+var DEFAULT_SUPERLINK_ENDPOINT = "https://pongl.ink";
+var SuperLinkClient = class {
+  constructor(config = {}) {
+    this.config = {
+      endpoint: stripTrailingSlash(config.endpoint || DEFAULT_SUPERLINK_ENDPOINT),
+      appId: config.appId,
+      installId: config.installId,
+      debug: config.debug ?? false
+    };
+  }
+  /** Replace config in place (used by init() so module-level helpers see updates). */
+  configure(config) {
+    if (config.endpoint) this.config.endpoint = stripTrailingSlash(config.endpoint);
+    if (config.appId !== void 0) this.config.appId = config.appId;
+    if (config.installId !== void 0) this.config.installId = config.installId;
+    if (config.debug !== void 0) this.config.debug = config.debug;
+  }
+  log(...args) {
+    if (this.config.debug) console.warn("[SuperLink]", ...args);
+  }
+  /**
+   * POST /match — ask the redirect engine to resolve a deferred deep link from
+   * a click token (Android referrer / iOS clipboard) and/or a device
+   * fingerprint. Returns `{ matched: false }` on any error.
+   */
+  async match(body) {
+    const payload = {
+      ...body,
+      install_id: body.install_id ?? this.config.installId
+    };
+    try {
+      const res = await fetch(`${this.config.endpoint}/match`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (!res.ok) {
+        this.log("match failed", res.status);
+        return { matched: false };
+      }
+      const data = await res.json();
+      return data ?? { matched: false };
+    } catch (err) {
+      this.log("match error", err);
+      return { matched: false };
+    }
+  }
+  /**
+   * POST /events — report a lifecycle event (opened / converted) back to the
+   * redirect engine, which fans out to analytics + webhooks. Best-effort.
+   */
+  async reportEvent(input) {
+    try {
+      const res = await fetch(`${this.config.endpoint}/events`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          app_id: this.config.appId,
+          install_id: this.config.installId,
+          ...input
+        })
+      });
+      if (!res.ok) this.log("event failed", input.type, res.status);
+      return res.ok;
+    } catch (err) {
+      this.log("event error", err);
+      return false;
+    }
+  }
+};
+function stripTrailingSlash(url) {
+  return url.endsWith("/") ? url.slice(0, -1) : url;
+}
+var superlinkClient = new SuperLinkClient();
+
+// src/superlink/parse.ts
+var UTM_KEYS2 = [
+  ["source", "utm_source"],
+  ["medium", "utm_medium"],
+  ["campaign", "utm_campaign"],
+  ["term", "utm_term"],
+  ["content", "utm_content"]
+];
+function parseUniversalLink(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  const params = parsed.searchParams;
+  const utm = {};
+  for (const [key, queryKey] of UTM_KEYS2) {
+    const value = params.get(queryKey);
+    if (value) utm[key] = value;
+  }
+  const referral = {};
+  const deep_link_data = {};
+  params.forEach((value, key) => {
+    if (key.startsWith("r_")) {
+      referral[key.slice(2)] = value;
+    } else if (key.startsWith("~")) {
+      deep_link_data[key.slice(1)] = value;
+    }
+  });
+  const explicitPath = params.get("$deep_link_path") ?? params.get("dlp");
+  const deep_link_path = explicitPath ?? (parsed.pathname && parsed.pathname !== "/" ? parsed.pathname : null);
+  return {
+    deep_link_path,
+    deep_link_data,
+    utm,
+    referral,
+    click_id: params.get("click_id"),
+    match_type: "none",
+    confidence: 1
+  };
+}
+
+// src/superlink/deferred.ts
+var handlers = /* @__PURE__ */ new Set();
+var lastMatched = null;
+function toDeepLink(res) {
+  return {
+    deep_link_path: res.deep_link_path ?? null,
+    deep_link_data: res.deep_link_data ?? {},
+    utm: res.utm ?? {},
+    referral: res.referral ?? {},
+    click_id: res.click_id ?? null,
+    match_type: res.match_type ?? "fingerprint",
+    confidence: res.confidence ?? (res.match_type && res.match_type !== "none" ? 1 : 0)
+  };
+}
+function emitDeferredDeepLink(link) {
+  lastMatched = link;
+  for (const handler of handlers) {
+    try {
+      handler(link);
+    } catch (err) {
+      if (superlinkClient.config.debug) console.warn("[SuperLink] handler threw", err);
+    }
+  }
+}
+function onDeferredDeepLink(handler) {
+  handlers.add(handler);
+  if (lastMatched) {
+    try {
+      handler(lastMatched);
+    } catch {
+    }
+  }
+  return () => {
+    handlers.delete(handler);
+  };
+}
+function getMatchedDeepLink() {
+  return lastMatched;
+}
+
+// src/superlink/web.ts
+var STORAGE_KEY4 = "sp_superlink";
+var captured = null;
+var didCapture = false;
+function readStored2() {
+  if (typeof sessionStorage === "undefined") return null;
+  try {
+    const raw = sessionStorage.getItem(STORAGE_KEY4);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeStored2(link) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(STORAGE_KEY4, JSON.stringify(link));
+  } catch {
+  }
+}
+function hasPayload(link) {
+  return Boolean(
+    link.deep_link_path || link.click_id || Object.keys(link.deep_link_data).length > 0 || Object.keys(link.referral).length > 0 || Object.keys(link.utm).length > 0
+  );
+}
+function writeClipboardToken(clickId) {
+  if (typeof navigator === "undefined" || !navigator.clipboard) return;
+  const url = `${superlinkClient.config.endpoint}/c/${clickId}`;
+  navigator.clipboard.writeText(url).catch(() => {
+  });
+}
+function extractIdentityMetadata(url) {
+  const href = url ?? (typeof window !== "undefined" && window.location ? window.location.href : null);
+  if (!href) return void 0;
+  let loc;
+  try {
+    loc = new URL(href);
+  } catch {
+    return void 0;
+  }
+  const email = loc.searchParams.get("email");
+  const phone = loc.searchParams.get("phone");
+  const userId = loc.searchParams.get("user_id");
+  const id = loc.searchParams.get("id");
+  const customRaw = loc.searchParams.get("custom");
+  const identity = {};
+  if (email) identity.email = email;
+  if (phone) identity.phone = phone;
+  if (userId) identity.user_id = userId;
+  if (id) identity.id = id;
+  if (customRaw) {
+    try {
+      const custom = JSON.parse(decodeURIComponent(customRaw));
+      if (typeof custom === "object" && custom !== null) {
+        identity.custom = custom;
+      }
+    } catch {
+    }
+  }
+  return Object.keys(identity).length > 0 ? identity : void 0;
+}
+function captureWebDeepLink() {
+  if (didCapture) return captured;
+  didCapture = true;
+  const stored = readStored2();
+  if (stored) {
+    captured = stored;
+    return captured;
+  }
+  if (typeof window === "undefined" || !window.location) return null;
+  const link = parseUniversalLink(window.location.href);
+  if (link && hasPayload(link)) {
+    captured = link;
+    writeStored2(link);
+    void superlinkClient.reportEvent({
+      type: "opened",
+      click_id: link.click_id,
+      platform: "desktop",
+      properties: { surface: "web" }
+    });
+  }
+  return captured;
+}
+function getDeepLink() {
+  if (!didCapture) return captureWebDeepLink();
+  return captured;
+}
+function webFingerprint() {
+  const fp = { platform: "desktop" };
+  if (typeof navigator !== "undefined") {
+    if (navigator.userAgent) fp.user_agent = navigator.userAgent;
+    const lang = navigator.language || navigator.languages && navigator.languages[0];
+    if (lang) fp.language = lang;
+  }
+  return fp;
+}
+async function identify(identity) {
+  if (!identity || Object.keys(identity).length === 0) return null;
+  const res = await superlinkClient.match({
+    identity,
+    fingerprint: webFingerprint()
+  });
+  if (!res.matched) return null;
+  const link = toDeepLink(res);
+  emitDeferredDeepLink(link);
+  return link;
+}
+async function completeFromScan(scanned) {
+  if (!scanned) return null;
+  const res = await superlinkClient.match({
+    qr_token: scanned,
+    fingerprint: webFingerprint()
+  });
+  if (!res.matched) return null;
+  const link = toDeepLink(res);
+  emitDeferredDeepLink(link);
+  return link;
+}
+
+// src/superlink/index.ts
+function initSuperLink(config = {}) {
+  superlinkClient.configure(config);
+  captureWebDeepLink();
+}
+
 // src/index.ts
 function installFallbackEnvironment() {
   if (getEnvironment()) return;
@@ -2117,6 +2460,10 @@ var SitePongClient = class {
         webVitals: config.performance.webVitals,
         navigationTiming: config.performance.navigationTiming,
         resourceTiming: config.performance.resourceTiming,
+        capturePageLoadTimings: config.performance.capturePageLoadTimings,
+        capturePageRenderTimings: config.performance.capturePageRenderTimings,
+        excludedResourceUrls: config.performance.excludedResourceUrls,
+        resourceNameSanitizer: config.performance.resourceNameSanitizer,
         sampleRate: config.performance.sampleRate,
         flushInterval: config.performance.flushInterval,
         performanceEndpoint: config.performance.performanceEndpoint,
@@ -2825,7 +3172,7 @@ var areFlagsReady = sitepong.areFlagsReady.bind(sitepong);
 var refreshFlags = sitepong.refreshFlags.bind(sitepong);
 var track = sitepong.track.bind(sitepong);
 var trackPageView = sitepong.trackPageView.bind(sitepong);
-var identify = sitepong.identify.bind(sitepong);
+var identify2 = sitepong.identify.bind(sitepong);
 var group = sitepong.group.bind(sitepong);
 var resetAnalytics = sitepong.resetAnalytics.bind(sitepong);
 var getVisitorId = sitepong.getVisitorId.bind(sitepong);
@@ -3037,7 +3384,7 @@ function useTrackPageView() {
 function useIdentify() {
   return useCallback(
     (userId, traits) => {
-      identify(userId, traits);
+      identify2(userId, traits);
     },
     []
   );
@@ -3233,6 +3580,6 @@ function useReplay() {
   return { recording, start, stop };
 }
 
-export { SitePongContext, SitePongErrorBoundary, SitePongProvider, TracePropagator, addBreadcrumb, areFlagsReady, captureError, captureMessage, clearAnonymousId, clearUser, sitepong as client, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, endSpan, endTransaction, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload2 as getVariantPayload, getVisitorId, getWebVitals, group, identify, init, initRN, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onRemoteConfigChange, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, stopReplay, track, trackPageView, useAddBreadcrumb, useAllFlags, useCaptureException, useCaptureMessage, useErrorCapture, useExperiment, useFeatureFlag, useFeatureFlagPayload, useFraudCheck, useGroup, useIdentify, usePerformanceTransaction, useReplay, useSetUser, useSitePong, useTrack, useTrackPageView, useVisitorId, useWebVitals, waitForFlags };
+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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map