sitepong 0.2.14 → 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.
@@ -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

@@ -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);
@@ -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();
@@ -4744,7 +4770,12 @@ 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);