@scalebun/react-native 1.0.4 → 1.2.0

package/src/features/engage/engagePushTokenBridge.ts

@@ -44,14 +44,14 @@ export async function getNativePushToken(): Promise<NativePushToken | null> {
     try {
         const mod = getEngageModule();
         if (!mod?.getPushToken) {
-            logger.debug('[Engage] ScaleBunEngage native module unavailable — skipping push token');
+            __DEV__ && logger.debug('[Engage] ScaleBunEngage native module unavailable — skipping push token');
             return null;
         }
         const result = await mod.getPushToken();
         if (!result?.token || !result?.platform) return null;
         return result;
     } catch (err: any) {
-        logger.debug(`[Engage] getPushToken failed (fail-soft): ${err?.message}`);
+        __DEV__ && logger.debug(`[Engage] getPushToken failed (fail-soft): ${err?.message}`);
         return null;
     }
 }
@@ -66,7 +66,7 @@ export function subscribeNativePushTokenRefresh(
     try {
         const nativeModule = NativeModules?.ScaleBunEngage;
         if (!nativeModule) {
-            logger.debug('[Engage] ScaleBunEngage native module unavailable — no token-refresh listener');
+            __DEV__ && logger.debug('[Engage] ScaleBunEngage native module unavailable — no token-refresh listener');
             return () => {};
         }
         const emitter = new NativeEventEmitter(nativeModule);
@@ -78,7 +78,7 @@ export function subscribeNativePushTokenRefresh(
         );
         return () => subscription.remove();
     } catch (err: any) {
-        logger.debug(`[Engage] token-refresh subscription failed (fail-soft): ${err?.message}`);
+        __DEV__ && logger.debug(`[Engage] token-refresh subscription failed (fail-soft): ${err?.message}`);
         return () => {};
     }
 }

package/src/features/engage/engageShakeBridge.ts

@@ -39,7 +39,7 @@ export function installEngageShakeBridge(): () => void {
     try {
         const mod = getModule();
         if (!mod?.startShakeDetection) {
-            logger.debug('[Engage] ScaleBunEngage shake detection unavailable — skipping');
+            __DEV__ && logger.debug('[Engage] ScaleBunEngage shake detection unavailable — skipping');
             return () => {};
         }
 
@@ -61,7 +61,7 @@ export function installEngageShakeBridge(): () => void {
             } catch { /* no-throw */ }
         };
     } catch (err: any) {
-        logger.debug(`[Engage] shake bridge install failed (fail-soft): ${err?.message}`);
+        __DEV__ && logger.debug(`[Engage] shake bridge install failed (fail-soft): ${err?.message}`);
         return () => {};
     }
 }

package/src/features/engage/engageSignals.ts

@@ -31,7 +31,7 @@ class EngageSignalBus {
             try {
                 l(signal);
             } catch (err) {
-                logger.debug('[Engage] signal listener threw:', (err as Error)?.message);
+                __DEV__ && logger.debug('[Engage] signal listener threw:', (err as Error)?.message);
             }
         }
     }

package/src/features/engage/engageStoreReviewBridge.ts

@@ -36,13 +36,13 @@ export async function requestNativeStoreReview(): Promise<boolean> {
     try {
         const mod = getEngageModule();
         if (!mod?.requestReview) {
-            logger.debug('[Engage] ScaleBunEngage native module unavailable — skipping store review');
+            __DEV__ && logger.debug('[Engage] ScaleBunEngage native module unavailable — skipping store review');
             return false;
         }
         const ran = await mod.requestReview();
         return ran === true;
     } catch (err: any) {
-        logger.debug(`[Engage] requestReview failed (fail-soft): ${err?.message}`);
+        __DEV__ && logger.debug(`[Engage] requestReview failed (fail-soft): ${err?.message}`);
         return false;
     }
 }

package/src/features/engage/engageTestSeenStore.ts

@@ -61,7 +61,7 @@ export class EngageTestSeenStore {
     markSeen(testRunId: string): void {
         if (!testRunId) return;
         this.backend.set(this.keyFor(testRunId), String(Date.now()));
-        logger.debug(`[Engage] test ${testRunId} marked displayed (persisted)`);
+        __DEV__ && logger.debug(`[Engage] test ${testRunId} marked displayed (persisted)`);
     }
 
     /**

package/src/features/engage/engageThrottle.ts

@@ -85,7 +85,7 @@ export class EngageThrottleStore {
                 };
             }
         } catch (err) {
-            logger.debug('[Engage] throttle state read failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] throttle state read failed:', (err as Error)?.message);
         }
         return { impressions: 0, lastShownAt: 0, completed: false };
     }
@@ -95,7 +95,7 @@ export class EngageThrottleStore {
         try {
             this.backend.delete(this.keyFor(campaignId));
         } catch (err) {
-            logger.debug('[Engage] throttle clearOne failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] throttle clearOne failed:', (err as Error)?.message);
         }
     }
 
@@ -115,7 +115,7 @@ export class EngageThrottleStore {
                 }
             }
         } catch (err) {
-            logger.debug('[Engage] throttle clearAll failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] throttle clearAll failed:', (err as Error)?.message);
         }
         return n;
     }
@@ -124,7 +124,7 @@ export class EngageThrottleStore {
         try {
             this.backend.set(this.keyFor(campaignId), JSON.stringify(state));
         } catch (err) {
-            logger.debug('[Engage] throttle state write failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] throttle state write failed:', (err as Error)?.message);
         }
     }
 

package/src/features/engage/engageTriggerEngine.ts

@@ -112,18 +112,18 @@ export function installEngageTriggerEngine(deps: EngageTriggerEngineDeps): () =>
             // Found live: a cold start with the screen off burned both a survey
             // and an in-app message before the phone was ever unlocked.
             if (appLifecycle.getCurrentState() !== 'active') {
-                logger.debug(
+                __DEV__ && logger.debug(
                     `[Engage] trigger suppressed (app ${appLifecycle.getCurrentState()}): ${options.trigger ?? 'manual'}`,
                 );
                 return;
             }
-            logger.debug(
+            __DEV__ && logger.debug(
                 `[Engage] trigger fire: ${options.trigger ?? 'manual'}` +
                     (options.screen ? ` screen=${options.screen}` : ''),
             );
             deps.fire(options);
         } catch (err) {
-            logger.debug('[Engage] trigger fire failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] trigger fire failed:', (err as Error)?.message);
         }
     };
 
@@ -297,7 +297,7 @@ export function installEngageTriggerEngine(deps: EngageTriggerEngineDeps): () =>
                 .filter((s): s is number => typeof s === 'number');
             if (targets.includes(next)) fire({ trigger: 'n_sessions' });
         } catch (err) {
-            logger.debug('[Engage] n_sessions check failed:', (err as Error)?.message);
+            __DEV__ && logger.debug('[Engage] n_sessions check failed:', (err as Error)?.message);
         }
     })();
 

package/src/features/engage/engageWindowInsets.ts

@@ -64,7 +64,7 @@ export async function readNativeWindowInsets(
         return normalizeWindowInsets(await module.getWindowInsets());
     } catch (error: unknown) {
         const reason = error instanceof Error ? error.message : String(error);
-        logger.debug(`[Engage] getWindowInsets failed (fail-soft): ${reason}`);
+        __DEV__ && logger.debug(`[Engage] getWindowInsets failed (fail-soft): ${reason}`);
         return null;
     }
 }

package/src/features/install-referrer/installReferrer.ts

@@ -40,7 +40,7 @@ export async function getInstallReferrer(): Promise<string | null> {
         const raw = await mod.getInstallReferrer();
         return typeof raw === 'string' ? raw : null;
     } catch (err) {
-        logger.debug(`[InstallReferrer] fetch failed: ${(err as Error)?.message}`);
+        __DEV__ && logger.debug(`[InstallReferrer] fetch failed: ${(err as Error)?.message}`);
         return null;
     }
 }
@@ -102,11 +102,11 @@ export async function captureInstallReferrerOnce(sink: InstallReferrerSink): Pro
         if (!parsed) return;
         if (parsed.clickId) sink.setClickId(parsed.clickId);
         sink.emit('install_referrer', { referrer: parsed.raw, ...parsed.params });
-        logger.debug(
+        __DEV__ && logger.debug(
             `[InstallReferrer] captured (clickId=${parsed.clickId ?? '-'}, ` +
                 `${Object.keys(parsed.params).length} params)`,
         );
     } catch (err) {
-        logger.debug(`[InstallReferrer] capture failed: ${(err as Error)?.message}`);
+        __DEV__ && logger.debug(`[InstallReferrer] capture failed: ${(err as Error)?.message}`);
     }
 }

package/src/features/journey/calibrationContext.ts

@@ -42,12 +42,3 @@ export function consumeCalibrationTarget(): CalibrationTarget | null {
     pending = null;
     return out;
 }
-
-export function peekCalibrationTarget(): CalibrationTarget | null {
-    if (!pending) return null;
-    if (Date.now() - pending.setAt > TTL_MS) {
-        pending = null;
-        return null;
-    }
-    return pending;
-}

package/src/features/journey/journeyManager.ts

@@ -21,7 +21,9 @@ import { GestureDetector } from './gestureDetector';
 import { NavDetector } from './navDetector';
 import { ScreenshotHelper } from './screenshotHelper';
 import { findTarget } from './targetRegistry';
-import { PROTOCOL_VERSION } from '../../debug/protocol';
+// The SDK-owned constant, not the debug/protocol shim — the shim re-exports from the vendored
+// schema module, which would pull every desktop wire-message schema into production bundles.
+import { PROTOCOL_VERSION } from '../../core/constants/protocol';
 
 // ─── Journey Event Names ────────────────────────────────────────────────────
 

package/src/features/navigation/AutoScreenDetector.ts

@@ -142,7 +142,7 @@ export class AutoScreenDetector {
             if (!ref) return;
             this._navigationRef = ref;
             this._wireNavigationListener();
-            logger.debug('[AutoScreenDetector] Navigation ref set');
+            __DEV__ && logger.debug('[AutoScreenDetector] Navigation ref set');
         } catch (err: any) {
             logger.warn('[AutoScreenDetector] setNavigationRef failed:', err?.message);
         }
@@ -310,7 +310,7 @@ export class AutoScreenDetector {
         this._started = true;
         this._autoHookReactNavigation();
         this._startHeuristicPolling();
-        logger.debug('[AutoScreenDetector] Started');
+        __DEV__ && logger.debug('[AutoScreenDetector] Started');
     }
 
     /**
@@ -432,7 +432,7 @@ export class AutoScreenDetector {
                     'ScaleBun.setNavigationRef(ref) to restore screen names.',
                 );
             } else {
-                logger.debug(`[AutoScreenDetector] React Navigation auto-hook installed (${installed}/3 entry points)`);
+                __DEV__ && logger.debug(`[AutoScreenDetector] React Navigation auto-hook installed (${installed}/3 entry points)`);
             }
         } catch { /* @react-navigation/native not installed — heuristic remains fallback */ }
     }
@@ -464,7 +464,7 @@ export class AutoScreenDetector {
         this._navListenerWired = false;
         this._started = false;
         this._lastEmittedScreen = null;
-        logger.debug('[AutoScreenDetector] Stopped');
+        __DEV__ && logger.debug('[AutoScreenDetector] Stopped');
     }
 
     /** Teardown completely (reset singleton) */

package/src/features/ota/OtaOrchestrator.ts

@@ -162,12 +162,12 @@ async function deliverOtaEvents(params: {
       },
     );
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    logger.debug(`[OTA] Delivered ${items.length} telemetry event(s)`);
+    __DEV__ && logger.debug(`[OTA] Delivered ${items.length} telemetry event(s)`);
   } catch (err: any) {
     // Failed delivery must not fail the update — but the events must not be
     // lost either: requeue so the next sync retries them.
     for (const e of events) otaEventEmitter.emit(e);
-    logger.debug(`[OTA] Telemetry delivery failed (will retry next sync): ${err?.message}`);
+    __DEV__ && logger.debug(`[OTA] Telemetry delivery failed (will retry next sync): ${err?.message}`);
   }
 }
 
@@ -199,6 +199,15 @@ const DEFAULT_MAX_REVERT_ATTEMPTS = 2;
 export class OtaOrchestrator {
   private enabled = false;
   private currentBundle: OtaBundlePayload | null = null;
+
+  /**
+   * The bundle this process is running, once hydrated from the native slots.
+   * Read-only view for integrations (e.g. the CodePush shim's
+   * getUpdateMetadata) that need to report the running version.
+   */
+  public getCurrentBundle(): OtaBundlePayload | null {
+    return this.currentBundle;
+  }
   private isRestartRequiredState = false;
   private healthyTimer: ReturnType<typeof setTimeout> | null = null;
   private bootGuardConfig: BootGuardConfig = {};
@@ -260,7 +269,7 @@ export class OtaOrchestrator {
         // We cannot see which form the host used — the identity check after
         // restart is what proves it — but naming the right fix up front turns
         // a confusing silent failure into a one-line correction.
-        logger.debug(
+        __DEV__ && logger.debug(
           '[OTA] React Native >= 0.82 detected. The only valid Android integration is ' +
             'getDefaultReactHost(..., jsBundleFilePath = ScaleBunOtaModule.getJSBundleFile(ctx)) — ' +
             'ReactNativeHost and its getJSBundleFile() override no longer exist.',
@@ -271,7 +280,7 @@ export class OtaOrchestrator {
       this.enabled = true;
       this.bootGuardConfig = config ?? {};
       this.signatureConfig = config?.signature;
-      logger.debug(
+      __DEV__ && logger.debug(
         `[OTA] Orchestrator initialized (RN ${this.environment.rnVersionString ?? 'unknown'}` +
           `${this.environment.bridgeless ? ', bridgeless' : ''}` +
           `${this.environment.hermes ? `, Hermes HBC v${this.environment.hermesBytecodeVersion ?? '?'}` : ''})`,
@@ -320,7 +329,7 @@ export class OtaOrchestrator {
           version: record.version,
           sha256: record.sha256,
         } as OtaBundlePayload;
-        logger.debug(`[OTA] Running bundle v${record.version} (${record.bundleId})`);
+        __DEV__ && logger.debug(`[OTA] Running bundle v${record.version} (${record.bundleId})`);
         return;
       }
 
@@ -328,7 +337,7 @@ export class OtaOrchestrator {
       // a reinstall of the app, cleared storage, or a bundle staged by an
       // older SDK. Report the hash so the server can still recognise it.
       this.currentBundle = { sha256: current.sha256 } as OtaBundlePayload;
-      logger.debug(
+      __DEV__ && logger.debug(
         `[OTA] Running an OTA bundle (sha ${String(current.sha256).slice(0, 12)}…) with no local install record.`,
       );
     } catch {
@@ -366,7 +375,7 @@ export class OtaOrchestrator {
     if (expected) {
       if (running === expected.identityToken) {
         // Proven: the bundle we installed is the bundle executing.
-        logger.debug('[OTA] Install verified — running bundle matches what was installed.');
+        __DEV__ && logger.debug('[OTA] Install verified — running bundle matches what was installed.');
         this.clearInstallExpectation();
         return;
       }
@@ -610,11 +619,11 @@ export class OtaOrchestrator {
         return { status: 'ERROR', error: 'OTA native module disabled or missing' };
       }
 
-      logger.debug('[OTA] Sync started…');
+      __DEV__ && logger.debug('[OTA] Sync started…');
       const checkRes = await this.checkForUpdate(params);
 
       if (checkRes.action === 'NONE') {
-        logger.debug('[OTA] App is up to date');
+        __DEV__ && logger.debug('[OTA] App is up to date');
         // If we booted from an OTA bundle and it's healthy, clear the boot guard
         this.startBootGuardHeartbeat();
         return { status: 'UP_TO_DATE' };
@@ -667,7 +676,7 @@ export class OtaOrchestrator {
       // ── DOWNLOAD ─────────────────────────────────────────────────────────
       otaEventEmitter.emitSimple('DOWNLOAD_STARTED', bundle.id, { version: bundle.version });
       const downloadStart = Date.now();
-      logger.debug(`[OTA] Downloading update v${bundle.version}…`);
+      __DEV__ && logger.debug(`[OTA] Downloading update v${bundle.version}…`);
 
       // Live progress: native tick → DOWNLOAD_PROGRESS (feeds useOtaUpdate) →
       // throttled POST to the live tracker. `bundle.size` is the authoritative
@@ -718,7 +727,7 @@ export class OtaOrchestrator {
 
       // Sprint 7: Try patch first if offered, fall back to full bundle
       if (bundle.patch && NativeScaleBunOta.stagePatch) {
-        logger.debug(
+        __DEV__ && logger.debug(
           `[OTA] Patch available (${(bundle.patch.size / 1024).toFixed(0)} KB vs ` +
             `${(bundle.size / 1024).toFixed(0)} KB full) — trying patch…`,
         );
@@ -730,7 +739,7 @@ export class OtaOrchestrator {
           );
           if (staged) {
             patchUsed = true;
-            logger.debug('[OTA] Patch applied successfully');
+            __DEV__ && logger.debug('[OTA] Patch applied successfully');
           } else {
             logger.warn('[OTA] Patch staging returned false — falling back to full bundle');
           }
@@ -812,7 +821,7 @@ export class OtaOrchestrator {
       this.recordInstallExpectation(bundle);
 
       otaEventEmitter.emitSimple('INSTALLED', bundle.id, { version: bundle.version });
-      logger.debug(`[OTA] Update v${bundle.version} installed successfully!`);
+      __DEV__ && logger.debug(`[OTA] Update v${bundle.version} installed successfully!`);
 
       // Deliver telemetry BEFORE a restart tears the JS runtime down —
       // an INSTALLED event queued but not sent would vanish with the process.
@@ -876,12 +885,12 @@ export class OtaOrchestrator {
       }
 
       const healthyMs = this.bootGuardConfig.healthyAfterMs ?? DEFAULT_HEALTHY_AFTER_MS;
-      logger.debug(`[OTA] Boot guard active — marking healthy after ${healthyMs}ms`);
+      __DEV__ && logger.debug(`[OTA] Boot guard active — marking healthy after ${healthyMs}ms`);
 
       this.healthyTimer = setTimeout(() => {
         noThrow(() => {
           NativeScaleBunOta?.markHealthy();
-          logger.info('[OTA] Boot guard cleared — bundle marked healthy ✓');
+          __DEV__ && logger.info('[OTA] Boot guard cleared — bundle marked healthy ✓');
           this.healthyTimer = null;
         });
       }, healthyMs);
@@ -924,11 +933,11 @@ export class OtaOrchestrator {
             /* the restart below makes cleanup moot */
           }
           this.resumeRestartArmed = false;
-          logger.info('[OTA] App resumed — activating the staged update now');
+          __DEV__ && logger.info('[OTA] App resumed — activating the staged update now');
           this.restart();
         }
       });
-      logger.debug('[OTA] Update staged — will activate on next resume (ON_NEXT_RESUME)');
+      __DEV__ && logger.debug('[OTA] Update staged — will activate on next resume (ON_NEXT_RESUME)');
     } catch {
       // AppState unavailable (tests, exotic hosts): the update still activates
       // on the next cold start, which is the documented fallback behaviour.
@@ -948,7 +957,7 @@ export class OtaOrchestrator {
    */
   restart(): void {
     noThrow(() => {
-      logger.info('[OTA] Triggering app restart…');
+      __DEV__ && logger.info('[OTA] Triggering app restart…');
       if (NativeScaleBunOta && typeof NativeScaleBunOta.restartApp === 'function') {
         NativeScaleBunOta.restartApp();
       } else if (DevSettings && typeof DevSettings.reload === 'function') {

package/src/features/ota/geoCountry.ts

@@ -73,9 +73,9 @@ export function prefetchDeviceCountry(): Promise<void> {
             memory = raw;
             storage.set(K_COUNTRY, raw);
             storage.set(K_FETCHED_AT, String(Date.now()));
-            logger.debug(`[OTA] Device country resolved: ${raw}`);
+            __DEV__ && logger.debug(`[OTA] Device country resolved: ${raw}`);
         } catch (err: any) {
-            logger.debug(`[OTA] Geo lookup skipped: ${err?.message ?? err}`);
+            __DEV__ && logger.debug(`[OTA] Geo lookup skipped: ${err?.message ?? err}`);
         } finally {
             clearTimeout(timer);
             inFlight = null;

package/src/features/ota/retry.ts

@@ -75,7 +75,7 @@ export async function retryWithBackoff<T>(
       lastError = err;
 
       if (!isRetryable(err)) {
-        logger.debug(`[OTA] ${label} failed with a non-retryable error — not retrying`);
+        __DEV__ && logger.debug(`[OTA] ${label} failed with a non-retryable error — not retrying`);
         throw err;
       }
 
@@ -83,7 +83,7 @@ export async function retryWithBackoff<T>(
       if (isLast) break;
 
       const delay = backoffDelay(attempt, baseDelayMs, maxDelayMs);
-      logger.debug(
+      __DEV__ && logger.debug(
         `[OTA] ${label} failed (attempt ${attempt + 1}/${attempts}) — retrying in ${delay}ms`,
       );
       await sleep(delay);

package/src/features/replay/core/logger/logger.ts

@@ -15,10 +15,6 @@ export function setVerbose(enabled: boolean): void {
     _verbose = enabled;
 }
 
-export function isVerbose(): boolean {
-    return _verbose;
-}
-
 export const logger = {
     debug(message: string, ...args: unknown[]): void {
         if (_verbose) {

package/src/features/replay/integrations/network/networkAdapter.ts

@@ -47,70 +47,15 @@ export function reportNetworkRequest(request: NetworkRequestSummary): void {
 
         breadcrumbCollector.addNetworkBreadcrumb(sanitized).catch(() => { });
     } catch (err: any) {
-        logger.debug(`Network breadcrumb failed: ${err?.message}`);
+        __DEV__ && logger.debug(`Network breadcrumb failed: ${err?.message}`);
     }
 }
 
-/**
- * Set a filter function to control which URLs are recorded.
- * Return true to include, false to exclude.
- */
-export function setNetworkUrlFilter(filter: ((url: string) => boolean) | null): void {
-    _urlFilter = filter;
-}
-
 /** Enable/disable network breadcrumb collection */
 export function setNetworkEnabled(enabled: boolean): void {
     _enabled = enabled;
 }
 
-/**
- * Optional: create a fetch wrapper that auto-reports requests.
- * This does NOT replace global fetch — it wraps it for convenience.
- */
-export function createTrackedFetch(originalFetch: typeof fetch): typeof fetch {
-    return async function trackedFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {
-        const startTime = Date.now();
-        const method = init?.method ?? 'GET';
-        const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-        const requestSize = init?.body ? new Blob([init.body as any]).size : 0;
-
-        try {
-            const response = await originalFetch(input, init);
-            const duration = Date.now() - startTime;
-
-            reportNetworkRequest({
-                method,
-                url,
-                statusCode: response.status,
-                durationMs: duration,
-                requestSizeBytes: requestSize,
-                responseSizeBytes: 0, // Can't reliably get without reading body
-                error: !response.ok,
-                startTimestamp: startTime,
-            });
-
-            return response;
-        } catch (err: any) {
-            const duration = Date.now() - startTime;
-
-            reportNetworkRequest({
-                method,
-                url,
-                statusCode: 0,
-                durationMs: duration,
-                requestSizeBytes: requestSize,
-                responseSizeBytes: 0,
-                error: true,
-                errorMessage: err?.message,
-                startTimestamp: startTime,
-            });
-
-            throw err;
-        }
-    };
-}
-
 /** Basic URL sanitization: mask tokens/keys in query params */
 function sanitizeUrl(url: string): string {
     try {

package/src/features/replay/integrations/react-navigation/navigationIntegration.ts

@@ -65,7 +65,7 @@ export function useReplayNavigation(navigationRef: any): void {
                     }
                 });
 
-                logger.debug(`Screen: ${previousRouteName ?? '(none)'} → ${currentRouteName}`);
+                __DEV__ && logger.debug(`Screen: ${previousRouteName ?? '(none)'} → ${currentRouteName}`);
             }
         });
 

package/src/features/replay/integrations/touch/ReplayRoot.tsx

@@ -95,7 +95,7 @@ export function ReplayRoot({ children, disableInteractionTracking = false }: Rep
         // Also trigger a frame capture for interaction modes
         bridgeAdapter.captureFrame('interaction').catch(() => { });
 
-        logger.debug(`Interaction: ${interactionType} at (${Math.round(touch.pageX)}, ${Math.round(touch.pageY)})`);
+        __DEV__ && logger.debug(`Interaction: ${interactionType} at (${Math.round(touch.pageX)}, ${Math.round(touch.pageY)})`);
     }, [disableInteractionTracking]);
 
     return (

package/src/features/replay/pipeline/batching/batchManager.ts

@@ -116,7 +116,7 @@ class BatchManager {
             logger.warn('Batch queue full — dropping oldest batch');
         }
 
-        logger.debug(`Batch created: ${batch.batchId} (${batch.frames.length} frames, ${batch.events.length} events)`);
+        __DEV__ && logger.debug(`Batch created: ${batch.batchId} (${batch.frames.length} frames, ${batch.events.length} events)`);
         return batch;
     }
 

package/src/features/replay/pipeline/retry/retryPolicy.ts

@@ -49,7 +49,7 @@ export async function withRetry<T>(
             }
 
             const delay = calculateDelay(attempt, config);
-            logger.debug(`${label}: retry ${attempt + 1}/${config.maxAttempts} in ${delay}ms`);
+            __DEV__ && logger.debug(`${label}: retry ${attempt + 1}/${config.maxAttempts} in ${delay}ms`);
             await sleep(delay);
         }
     }

package/src/features/replay/public/api.ts

@@ -81,7 +81,7 @@ export const ReplaySdk = {
             }
 
             if (!config.enabled) {
-                logger.info('SDK disabled via config');
+                __DEV__ && logger.info('SDK disabled via config');
                 return;
             }
 
@@ -91,7 +91,7 @@ export const ReplaySdk = {
             // Desktop transport (always, if debugTransport provided)
             if (opts?.debugTransport) {
                 transports.push(new DesktopReplayTransport(opts.debugTransport));
-                logger.info('Desktop replay transport enabled');
+                __DEV__ && logger.info('Desktop replay transport enabled');
             }
 
             // Backend transport (flag-controlled + env check)
@@ -103,9 +103,9 @@ export const ReplaySdk = {
                         apiKey: config.apiKey,
                         batchSize: config.uploadBatchSize,
                     }));
-                    logger.info('Backend replay transport enabled');
+                    __DEV__ && logger.info('Backend replay transport enabled');
                 } else {
-                    logger.info('Backend replay transport skipped (dev/emulator mode)');
+                    __DEV__ && logger.info('Backend replay transport skipped (dev/emulator mode)');
                 }
             }
 
@@ -129,7 +129,7 @@ export const ReplaySdk = {
             try {
                 const success = await sessionOrchestrator.initialize(config);
                 if (success) {
-                    logger.info('SDK initialized with native module');
+                    __DEV__ && logger.info('SDK initialized with native module');
                 } else {
                     logger.warn('Native module not available — transport-only mode');
                 }
@@ -138,7 +138,7 @@ export const ReplaySdk = {
             }
 
             _initialized = true;
-            logger.info('SDK initialized successfully');
+            __DEV__ && logger.info('SDK initialized successfully');
         }, undefined);
     },
 
@@ -358,7 +358,7 @@ export const ReplaySdk = {
 
             _initialized = false;
             _config = null;
-            logger.info('SDK destroyed');
+            __DEV__ && logger.info('SDK destroyed');
         }, undefined);
     },
 };