sitepong 0.1.13 → 0.2.0

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
@@ -1908,6 +1909,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;
@@ -2117,6 +2404,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 +3116,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 +3328,7 @@ function useTrackPageView() {
 function useIdentify() {
   return useCallback(
     (userId, traits) => {
-      identify(userId, traits);
+      identify2(userId, traits);
     },
     []
   );
@@ -3233,6 +3524,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