sitepong 0.2.13 → 0.2.15

package/dist/entries/rn.d.ts

@@ -360,6 +360,14 @@ interface SitePongInitConfig extends SitePongConfig {
         blockSelector?: string;
         /** CSS selector whose text is masked in the screen template */
         maskSelector?: string;
+        /**
+         * Release channel / environment tagged on events (development | preview |
+         * production | …). Defaults to the SDK `environment` (usually 'production').
+         * A channel in `ignoreChannels` suppresses capture entirely.
+         */
+        channel?: string;
+        /** Channels for which capture is a no-op (default ['development']). */
+        ignoreChannels?: string[];
     };
     /** Cron monitoring configuration */
     crons?: {
@@ -738,6 +746,17 @@ interface WatchtowerConfig {
      * Default 30_000 (30s). Lower it in tests to exercise session rolling.
      */
     sessionGraceMs?: number;
+    /**
+     * Release channel / environment tagged on every event (development | preview
+     * | production | …). When omitted, the native engine auto-resolves it:
+     * debug builds → "development", release builds → "production".
+     */
+    channel?: string;
+    /**
+     * Channels for which capture is a complete no-op (default ["development"]).
+     * Debug builds thus self-suppress; pass [] to capture dev on demand.
+     */
+    ignoreChannels?: string[];
 }
 /**
  * Start the shared native capture engine for React Native. Idempotent.
@@ -749,7 +768,7 @@ declare function startWatchtower(config: WatchtowerConfig): void;
  * Set user identity — stamped as distinct_id on every subsequent event. Call
  * this wherever you call the SDK's identify(), with the same id.
  */
-declare function setWatchtowerUser(distinctId: string | null): void;
+declare function setWatchtowerUser(distinctId: string | null, email?: string | null, name?: string | null): void;
 /**
  * The engine's current capture session id (null when not running). Attach it
  * to error reports/analytics — it is the key that joins an error to its
@@ -792,6 +811,14 @@ interface StructuralCaptureConfig {
     sampleIntervalMs?: number;
     flushIntervalMs?: number;
     debug?: boolean;
+    /**
+     * Release channel / environment (development | preview | production | …).
+     * Defaults to 'development' under __DEV__, else 'production'. A channel in
+     * `ignoreChannels` makes start() a no-op so dev replays are never sent.
+     */
+    channel?: string;
+    /** Channels for which capture is a no-op (default ['development']). */
+    ignoreChannels?: string[];
 }
 declare class StructuralCapture {
     private readonly recorder;

package/dist/entries/rn.js

@@ -2625,7 +2625,7 @@ var SitePongClient = class {
     }
     for (const hook of this.identifyHooks) {
       try {
-        hook(userId);
+        hook(userId, traits);
       } catch (err) {
         this.log("identify hook failed:", err);
       }
@@ -2731,6 +2731,10 @@ var SitePongClient = class {
       flushInterval: opts.flushInterval,
       blockSelector: opts.blockSelector,
       maskSelector: opts.maskSelector,
+      // Channel defaults to the SDK environment; ignoreChannels defaults to
+      // ['development'] inside the capture when omitted.
+      channel: opts.channel ?? this.config.environment,
+      ignoreChannels: opts.ignoreChannels,
       debug: this.config.debug
     });
     this.watchtowerCapture.start(this.analyticsManager?.getAutocaptureModule() ?? null);
@@ -3149,7 +3153,7 @@ sitepong.flushProfiles.bind(sitepong);
 var getRemoteConfig = sitepong.getRemoteConfig.bind(sitepong);
 var isRemoteConfigFeatureEnabled = sitepong.isRemoteConfigFeatureEnabled.bind(sitepong);
 var onRemoteConfigChange = sitepong.onRemoteConfigChange.bind(sitepong);
-sitepong.registerIdentifyHook.bind(sitepong);
+var registerIdentifyHook = sitepong.registerIdentifyHook.bind(sitepong);
 
 // src/react-native/storage.ts
 function createAsyncStorageAdapter(asyncStorage) {
@@ -3954,9 +3958,26 @@ function fiberRootFromInstance(instance) {
   return fiberRoot && typeof fiberRoot === "object" && fiberRoot.current ? fiberRoot : null;
 }
 
+// src/analytics/channel.ts
+function normalize(v) {
+  const c = v?.trim().toLowerCase();
+  return c && c.length > 0 ? c : void 0;
+}
+function resolveChannel(explicit, buildDefault) {
+  return normalize(explicit) ?? buildDefault;
+}
+function isChannelSuppressed(channel, ignoreChannels) {
+  const ignore = (ignoreChannels ?? ["development"]).map((c) => normalize(c)).filter((c) => c !== void 0);
+  return ignore.includes(channel);
+}
+
 // src/react-native/structural/capture.ts
 var WALK_BUDGET_MS = 24;
 var MAX_OVERLOAD_SKIP = 8;
+function rnDefaultChannel() {
+  const dev = globalThis.__DEV__;
+  return dev ? "development" : "production";
+}
 function genSessionId() {
   const rand = Math.floor(Math.random() * 16777215).toString(36);
   return `wt-${Date.now().toString(36)}-${rand}`;
@@ -4005,6 +4026,11 @@ var StructuralCapture = class {
   }
   start(cfg) {
     if (this.running) return;
+    const channel = resolveChannel(cfg.channel, rnDefaultChannel());
+    if (isChannelSuppressed(channel, cfg.ignoreChannels)) {
+      if (cfg.debug) console.log("[structural] suppressed channel", channel, "\u2014 not capturing");
+      return;
+    }
     installStructuralHook();
     this.cfg = cfg;
     this.sessionId = cfg.sessionId || genSessionId();
@@ -4725,6 +4751,7 @@ function loadBridge() {
   return getScreenRecorderModule();
 }
 var started = false;
+var identifyHookUnsub = null;
 function startWatchtower(config) {
   if (started) return;
   const bridge = loadBridge();
@@ -4743,14 +4770,24 @@ function startWatchtower(config) {
     endpoint: config.endpoint,
     sampleRate: config.sampleRate ?? 0.1,
     platform: config.platform ?? "react-native-ios",
-    sessionGraceMs: config.sessionGraceMs ?? 3e4
+    sessionGraceMs: config.sessionGraceMs ?? 3e4,
+    // Forwarded to WatchtowerCore; undefined channel → native auto-resolves
+    // (debug→development, release→production). ignoreChannels defaults to
+    // ["development"] natively when omitted.
+    channel: config.channel,
+    ignoreChannels: config.ignoreChannels
   });
   started = true;
   if (config.distinctId) setWatchtowerUser(config.distinctId);
+  if (!identifyHookUnsub) {
+    identifyHookUnsub = registerIdentifyHook(
+      (userId, traits) => setWatchtowerUser(userId, traits?.email ?? null, traits?.name ?? null)
+    );
+  }
 }
-function setWatchtowerUser(distinctId) {
+function setWatchtowerUser(distinctId, email = null, name = null) {
   try {
-    loadBridge()?.watchtowerSetUser(distinctId);
+    loadBridge()?.watchtowerSetUser(distinctId, email, name);
   } catch {
   }
 }
@@ -4765,6 +4802,8 @@ function stopWatchtower() {
   if (!started) return;
   loadBridge()?.watchtowerStop();
   started = false;
+  identifyHookUnsub?.();
+  identifyHookUnsub = null;
 }
 function subscribeNavigationToWatchtower(navigationRef) {
   const unsubscribe = createNavigationTracker(navigationRef, {