sitepong 0.1.13 → 0.2.0

package/dist/react/index.d.mts

@@ -1,6 +1,6 @@
 import React, { Component, ReactNode, ErrorInfo } from 'react';
 import { SitePongInitConfig, ErrorContext, addBreadcrumb, DeviceSignals, WebVitals } from '../index.mjs';
-export { CapturedError, CronCheckinOptions, CronHandle, DatabaseQueryEvent, DatabaseTrackerConfig, DeviceInfo, EnvironmentAdapter, FraudCheckResult, MetricOptions, MutableRNEnvironmentAdapter, PerformanceConfig, PerformanceSpan, PerformanceTransaction, PlatformName, ProfileData, ProfileFrame, ProfilerConfig, RemoteConfig, RemoteConfigFeatures, RemoteConfigSampling, SitePongConfig, TraceContext, TracePropagator, VisitorIdResult, WebManagerFactories, areFlagsReady, captureError, captureMessage, clearAnonymousId, clearUser, 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, 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, waitForFlags } from '../index.mjs';
+export { CapturedError, CronCheckinOptions, CronHandle, DEFAULT_SUPERLINK_ENDPOINT, DatabaseQueryEvent, DatabaseTrackerConfig, DeferredDeepLinkHandler, DeviceInfo, EnvironmentAdapter, FraudCheckResult, MetricOptions, MutableRNEnvironmentAdapter, PerformanceConfig, PerformanceSpan, PerformanceTransaction, PlatformName, ProfileData, ProfileFrame, ProfilerConfig, RemoteConfig, RemoteConfigFeatures, RemoteConfigSampling, ResourceTimingBreakdown, SitePongConfig, SuperLinkClient, SuperLinkConfig, SuperLinkDeepLink, SuperLinkEventType, SuperLinkFingerprint, SuperLinkIdentityMetadata, SuperLinkMatchRequest, SuperLinkMatchResponse, SuperLinkMatchType, SuperLinkPlatform, TraceContext, TracePropagator, VisitorIdResult, WebManagerFactories, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, 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, getVariantPayload, getVisitorId, getWebVitals, group, 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, superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken } from '../index.mjs';
 import { C as CaptureContext, U as User } from '../types-Cms9VXx9.mjs';
 import { T as TrackProperties, U as UserTraits, G as GroupTraits } from '../types-BEqbz0tw.mjs';
 export { R as ReplayConfig, a as ReplayEvent } from '../types-BEqbz0tw.mjs';

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
 import React, { Component, ReactNode, ErrorInfo } from 'react';
 import { SitePongInitConfig, ErrorContext, addBreadcrumb, DeviceSignals, WebVitals } from '../index.js';
-export { CapturedError, CronCheckinOptions, CronHandle, DatabaseQueryEvent, DatabaseTrackerConfig, DeviceInfo, EnvironmentAdapter, FraudCheckResult, MetricOptions, MutableRNEnvironmentAdapter, PerformanceConfig, PerformanceSpan, PerformanceTransaction, PlatformName, ProfileData, ProfileFrame, ProfilerConfig, RemoteConfig, RemoteConfigFeatures, RemoteConfigSampling, SitePongConfig, TraceContext, TracePropagator, VisitorIdResult, WebManagerFactories, areFlagsReady, captureError, captureMessage, clearAnonymousId, clearUser, 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, 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, waitForFlags } from '../index.js';
+export { CapturedError, CronCheckinOptions, CronHandle, DEFAULT_SUPERLINK_ENDPOINT, DatabaseQueryEvent, DatabaseTrackerConfig, DeferredDeepLinkHandler, DeviceInfo, EnvironmentAdapter, FraudCheckResult, MetricOptions, MutableRNEnvironmentAdapter, PerformanceConfig, PerformanceSpan, PerformanceTransaction, PlatformName, ProfileData, ProfileFrame, ProfilerConfig, RemoteConfig, RemoteConfigFeatures, RemoteConfigSampling, ResourceTimingBreakdown, SitePongConfig, SuperLinkClient, SuperLinkConfig, SuperLinkDeepLink, SuperLinkEventType, SuperLinkFingerprint, SuperLinkIdentityMetadata, SuperLinkMatchRequest, SuperLinkMatchResponse, SuperLinkMatchType, SuperLinkPlatform, TraceContext, TracePropagator, VisitorIdResult, WebManagerFactories, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, 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, getVariantPayload, getVisitorId, getWebVitals, group, 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, superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken } from '../index.js';
 import { C as CaptureContext, U as User } from '../types-DQSv7JAE.js';
 import { T as TrackProperties, U as UserTraits, G as GroupTraits } from '../types-BEqbz0tw.js';
 export { R as ReplayConfig, a as ReplayEvent } from '../types-BEqbz0tw.js';

package/dist/react/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var react = require('react');
+require('web-vitals');
 var jsxRuntime = require('react/jsx-runtime');
 
 // src/react/provider.tsx
@@ -1910,6 +1911,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_KEYS = [
+  ["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_KEYS) {
+    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_KEY3 = "sp_superlink";
+var captured = null;
+var didCapture = false;
+function readStored() {
+  if (typeof sessionStorage === "undefined") return null;
+  try {
+    const raw = sessionStorage.getItem(STORAGE_KEY3);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeStored(link) {
+  if (typeof sessionStorage === "undefined") return;
+  try {
+    sessionStorage.setItem(STORAGE_KEY3, 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 = readStored();
+  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;
+    writeStored(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;
@@ -2119,6 +2406,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,
@@ -2827,7 +3118,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);
@@ -3039,7 +3330,7 @@ function useTrackPageView() {
 function useIdentify() {
   return react.useCallback(
     (userId, traits) => {
-      identify(userId, traits);
+      identify2(userId, traits);
     },
     []
   );
@@ -3235,17 +3526,21 @@ function useReplay() {
   return { recording, start, stop };
 }
 
+exports.DEFAULT_SUPERLINK_ENDPOINT = DEFAULT_SUPERLINK_ENDPOINT;
 exports.SitePongContext = SitePongContext;
 exports.SitePongErrorBoundary = SitePongErrorBoundary;
 exports.SitePongProvider = SitePongProvider;
+exports.SuperLinkClient = SuperLinkClient;
 exports.TracePropagator = TracePropagator;
 exports.addBreadcrumb = addBreadcrumb;
 exports.areFlagsReady = areFlagsReady;
 exports.captureError = captureError;
 exports.captureMessage = captureMessage;
+exports.captureWebDeepLink = captureWebDeepLink;
 exports.clearAnonymousId = clearAnonymousId;
 exports.clearUser = clearUser;
 exports.client = sitepong;
+exports.completeFromScan = completeFromScan;
 exports.createTraceContext = createTraceContext;
 exports.cronCheckin = cronCheckin;
 exports.cronStart = cronStart;
@@ -3254,6 +3549,7 @@ exports.dbTrack = dbTrack;
 exports.dbTrackSync = dbTrackSync;
 exports.endSpan = endSpan;
 exports.endTransaction = endTransaction;
+exports.extractIdentityMetadata = extractIdentityMetadata;
 exports.extractTrace = extractTrace;
 exports.flush = flush;
 exports.flushMetrics = flushMetrics;
@@ -3264,10 +3560,12 @@ exports.getAllFlags = getAllFlags;
 exports.getAnonymousId = getAnonymousId;
 exports.getDbNPlusOnePatterns = getDbNPlusOnePatterns;
 exports.getDbQueryCount = getDbQueryCount;
+exports.getDeepLink = getDeepLink;
 exports.getDeviceSignals = getDeviceSignals;
 exports.getFlag = getFlag;
 exports.getFraudCheck = getFraudCheck;
 exports.getLatestProfile = getLatestProfile;
+exports.getMatchedDeepLink = getMatchedDeepLink;
 exports.getProfiles = getProfiles;
 exports.getRemoteConfig = getRemoteConfig;
 exports.getReplaySessionId = getReplaySessionId;
@@ -3276,9 +3574,10 @@ exports.getVariantPayload = getVariantPayload2;
 exports.getVisitorId = getVisitorId;
 exports.getWebVitals = getWebVitals;
 exports.group = group;
-exports.identify = identify;
+exports.identify = identify2;
 exports.init = init;
 exports.initRN = initRN;
+exports.initSuperLink = initSuperLink;
 exports.isInitialized = isInitialized;
 exports.isRemoteConfigFeatureEnabled = isRemoteConfigFeatureEnabled;
 exports.isReplayRecording = isReplayRecording;
@@ -3288,7 +3587,9 @@ exports.metricHistogram = metricHistogram;
 exports.metricIncrement = metricIncrement;
 exports.metricStartTimer = metricStartTimer;
 exports.metricTime = metricTime;
+exports.onDeferredDeepLink = onDeferredDeepLink;
 exports.onRemoteConfigChange = onRemoteConfigChange;
+exports.parseUniversalLink = parseUniversalLink;
 exports.profile = profile;
 exports.propagateTrace = propagateTrace;
 exports.refreshFlags = refreshFlags;
@@ -3308,6 +3609,8 @@ exports.startReplay = startReplay;
 exports.startSpan = startSpan;
 exports.startTransaction = startTransaction;
 exports.stopReplay = stopReplay;
+exports.superlinkClient = superlinkClient;
+exports.superlinkIdentify = identify;
 exports.track = track;
 exports.trackPageView = trackPageView;
 exports.useAddBreadcrumb = useAddBreadcrumb;
@@ -3330,5 +3633,6 @@ exports.useTrackPageView = useTrackPageView;
 exports.useVisitorId = useVisitorId;
 exports.useWebVitals = useWebVitals;
 exports.waitForFlags = waitForFlags;
+exports.writeClipboardToken = writeClipboardToken;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map