@scalebun/react-native 1.3.3 → 1.5.0

package/dist/scalebun.full.js

@@ -489,7 +489,7 @@ var SDK_VERSION;
 var init_version = __esm({
   "lib/module/core/constants/version.js"() {
     "use strict";
-    SDK_VERSION = "1.3.3";
+    SDK_VERSION = "1.5.0";
   }
 });
 
@@ -539,6 +539,10 @@ function mergeDeviceContext(configured, detected = staticDeviceContext()) {
     ...detected
   };
 }
+function resolveEventPlatform() {
+  const os = resolvePlatformOS();
+  return os === "ios" || os === "android" || os === "web" ? os : "react_native";
+}
 var init_device = __esm({
   "lib/module/core/context/device.js"() {
     "use strict";
@@ -1235,6 +1239,7 @@ var init_transport = __esm({
     "use strict";
     init_protocol2();
     init_timings();
+    init_version();
     DebugTransport = class {
       ws = null;
       state = "disconnected";
@@ -1406,7 +1411,7 @@ var init_transport = __esm({
           timestamp: Date.now(),
           sequence: this.nextSequence(),
           payload: {
-            sdkVersion: "0.1.0",
+            sdkVersion: SDK_VERSION,
             appName: this.config.appName,
             appVersion: this.config.appVersion,
             bundleId: this.config.bundleId,
@@ -7329,7 +7334,7 @@ var init_JsStallCollector = __esm({
     "use strict";
     init_models();
     MAX_STALL_RECORDS = 100;
-    JsStallCollector = class {
+    JsStallCollector = class _JsStallCollector {
       pollTimer = null;
       reportTimer = null;
       lastTick = 0;
@@ -7339,6 +7344,11 @@ var init_JsStallCollector = __esm({
       maxStallMs = 0;
       totalStallMs = 0;
       recentStalls = [];
+      /** Per-run caps on INDIVIDUAL stall events — see the emit site. Summaries are uncapped. */
+      static EMITTED_STALLS_MAX = 200;
+      static CRITICAL_OVERFLOW_MAX = 100;
+      emittedStalls = 0;
+      emittedCriticalOverflow = 0;
       constructor(config, onStall, onSummary, contextProvider) {
         this.config = config;
         this.onStall = onStall;
@@ -7399,6 +7409,13 @@ var init_JsStallCollector = __esm({
         }
         if (durationMs > 100) {
           const severity = this._classifySeverity(durationMs);
+          if (this.emittedStalls >= _JsStallCollector.EMITTED_STALLS_MAX) {
+            if (severity !== "critical") return;
+            if (this.emittedCriticalOverflow >= _JsStallCollector.CRITICAL_OVERFLOW_MAX) return;
+            this.emittedCriticalOverflow++;
+          } else {
+            this.emittedStalls++;
+          }
           const event = {
             id: `stall-${timestamp}-${Math.random().toString(36).substring(2, 8)}`,
             type: "js_stall",
@@ -7835,13 +7852,27 @@ var init_FrameMetricsCollector = __esm({
     import_react_native9 = require("react-native");
     init_getNativePerformanceModule();
     init_models();
-    FrameMetricsCollector = class {
+    FrameMetricsCollector = class _FrameMetricsCollector {
       eventSubscription = null;
       running = false;
       /** AppState subscription — see `_installAppStateGate`. */
       appStateSubscription = null;
       /** True while the native sampler is actually running (i.e. armed AND foregrounded). */
       sampling = false;
+      /** Timestamp of the last emitted window — drives the healthy-window heartbeat below. */
+      lastEmitTs = 0;
+      /**
+       * HEALTHY windows emit at a heartbeat, not per report interval.
+       *
+       * The native sampler reports every `reportIntervalMs` (5 s), and every window became a stored
+       * row — on a session hours long that is 720 rows/hour of "still 60 fps", which is how real
+       * sessions hit the dashboard's 2,000-row display cap with nothing to say. A window that shows
+       * ANY jank (dropped/frozen frames, meaningful slow-frame count, an FPS dip) always emits; a
+       * healthy window emits only when the heartbeat has elapsed, keeping the FPS series alive for
+       * the charts at 1/12th the volume. Capture cadence is unchanged — only identical-looking
+       * healthy rows are elided, and the first window after ANY emit gap states the recovery.
+       */
+      static HEALTHY_HEARTBEAT_MS = 6e4;
       constructor(config, onFrameMetrics, contextProvider) {
         this.config = config;
         this.onFrameMetrics = onFrameMetrics;
@@ -7944,10 +7975,17 @@ var init_FrameMetricsCollector = __esm({
         const expectedFrames = Math.round(windowMs / 16.67);
         const actualFrames = Math.max(0, totalFrames - droppedFrames);
         const estimatedFps = expectedFrames > 0 ? Math.round(actualFrames / expectedFrames * 60) : 60;
+        const clampedFps = Math.min(60, Math.max(0, estimatedFps));
+        const now2 = Date.now();
+        const healthy = droppedFrames === 0 && frozenFrames === 0 && slowFrames <= 2 && clampedFps >= 55;
+        if (healthy && this.lastEmitTs !== 0 && now2 - this.lastEmitTs < _FrameMetricsCollector.HEALTHY_HEARTBEAT_MS) {
+          return;
+        }
+        this.lastEmitTs = now2;
         const event = {
-          id: `frames-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`,
+          id: `frames-${now2}-${Math.random().toString(36).substring(2, 8)}`,
           type: "frame_metrics",
-          timestamp: Date.now(),
+          timestamp: now2,
           schemaVersion: PERF_SCHEMA_VERSION,
           context: this.contextProvider(),
           windowMs,
@@ -7955,7 +7993,7 @@ var init_FrameMetricsCollector = __esm({
           droppedFrames,
           slowFrames,
           frozenFrames,
-          estimatedFps: Math.min(60, Math.max(0, estimatedFps)),
+          estimatedFps: clampedFps,
           maxFrameTimeMs
         };
         this.onFrameMetrics(event);
@@ -10003,6 +10041,10 @@ function enableDebug(config) {
       __DEV__ && logger.debug("Debug already enabled, skipping");
       return;
     }
+    if (!__DEV__ && !config.allowInRelease) {
+      logger.warn("[ScaleBun] Debug connection refused in a release build. The debug transport is unencrypted (ws://) and carries captured traffic and the shared secret in cleartext, so it is development-only by default. If you genuinely need it in a release build, set `allowInRelease: true` \u2014 and do not ship that to users.");
+      return;
+    }
     if (!isDevToolsBundled()) {
       logger.warn("[ScaleBun] debugConnection was configured, but the desktop-debugger tooling is not in this bundle. It is excluded by default (the ScaleBun desktop app is not yet released); opt in with `withScaleBun(config, { features: { devTools: true } })` in metro.config.js. All other SDK behaviour is unaffected.");
       return;
@@ -10097,7 +10139,7 @@ function enableDebug(config) {
           journeyEnabled: _journeyConfig.enabled,
           canScreenshot: true,
           navMode: _autoScreenDetector ? "auto" : "beacon",
-          sdkVersion: "1.0.0"
+          sdkVersion: SDK_VERSION
         });
         __DEV__ && logger.debug("Emitted journey:debug_ready event to desktop");
       } catch {
@@ -10232,6 +10274,7 @@ var init_bootstrap = __esm({
     "use strict";
     init_transport();
     init_timings();
+    init_version();
     init_stream();
     init_commands();
     init_internalLogger();
@@ -10511,89 +10554,6 @@ var init_nativeCrashBridge = __esm({
   }
 });
 
-// lib/module/analytics/batching.js
-function chunkEvents(events, size = MAX_BATCH_EVENTS) {
-  const cap = Math.max(1, Math.min(size, MAX_BATCH_EVENTS));
-  if (events.length <= cap) return events.length ? [events.slice()] : [];
-  const out = [];
-  for (let i = 0; i < events.length; i += cap) {
-    out.push(events.slice(i, i + cap));
-  }
-  return out;
-}
-function clampBatchSize(configured, fallback) {
-  const n = typeof configured === "number" && configured > 0 ? configured : fallback;
-  return Math.max(1, Math.min(n, MAX_BATCH_EVENTS));
-}
-function batchIdempotencyKey(eventIds) {
-  let h = 2166136261;
-  const joined = eventIds.join("
");
-  for (let i = 0; i < joined.length; i++) {
-    h ^= joined.charCodeAt(i);
-    h = Math.imul(h, 16777619) >>> 0;
-  }
-  return `sdk-${eventIds.length}-${h.toString(16).padStart(8, "0")}`;
-}
-var MAX_BATCH_EVENTS;
-var init_batching = __esm({
-  "lib/module/analytics/batching.js"() {
-    "use strict";
-    MAX_BATCH_EVENTS = 500;
-  }
-});
-
-// lib/module/analytics/automaticEvents.js
-function compactProperties(properties) {
-  const out = {
-    capture_source: "automatic"
-  };
-  for (const [key, value] of Object.entries(properties ?? {})) {
-    if (value !== void 0) out[key] = value;
-  }
-  return out;
-}
-function emitAutomaticEvent(name, properties) {
-  const event = {
-    name,
-    properties: compactProperties(properties)
-  };
-  if (listeners.size === 0) {
-    pending3.push(event);
-    if (pending3.length > MAX_PENDING2) pending3.shift();
-    return;
-  }
-  for (const listener of listeners) {
-    try {
-      listener(event);
-    } catch {
-    }
-  }
-}
-function subscribeAutomaticEvents(listener) {
-  listeners.add(listener);
-  if (pending3.length > 0) {
-    const buffered = pending3.splice(0, pending3.length);
-    for (const event of buffered) {
-      try {
-        listener(event);
-      } catch {
-      }
-    }
-  }
-  return () => {
-    listeners.delete(listener);
-  };
-}
-var listeners, pending3, MAX_PENDING2;
-var init_automaticEvents = __esm({
-  "lib/module/analytics/automaticEvents.js"() {
-    "use strict";
-    listeners = /* @__PURE__ */ new Set();
-    pending3 = [];
-    MAX_PENDING2 = 50;
-  }
-});
-
 // lib/module/crypto/hmacSha256.js
 function utf8(str3) {
   const out = [];
@@ -10710,6 +10670,89 @@ var init_hmacSha256 = __esm({
   }
 });
 
+// lib/module/analytics/batching.js
+function chunkEvents(events, size = MAX_BATCH_EVENTS) {
+  const cap = Math.max(1, Math.min(size, MAX_BATCH_EVENTS));
+  if (events.length <= cap) return events.length ? [events.slice()] : [];
+  const out = [];
+  for (let i = 0; i < events.length; i += cap) {
+    out.push(events.slice(i, i + cap));
+  }
+  return out;
+}
+function clampBatchSize(configured, fallback) {
+  const n = typeof configured === "number" && configured > 0 ? configured : fallback;
+  return Math.max(1, Math.min(n, MAX_BATCH_EVENTS));
+}
+function batchIdempotencyKey(eventIds) {
+  let h = 2166136261;
+  const joined = eventIds.join("
");
+  for (let i = 0; i < joined.length; i++) {
+    h ^= joined.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return `sdk-${eventIds.length}-${h.toString(16).padStart(8, "0")}`;
+}
+var MAX_BATCH_EVENTS;
+var init_batching = __esm({
+  "lib/module/analytics/batching.js"() {
+    "use strict";
+    MAX_BATCH_EVENTS = 500;
+  }
+});
+
+// lib/module/analytics/automaticEvents.js
+function compactProperties(properties) {
+  const out = {
+    capture_source: "automatic"
+  };
+  for (const [key, value] of Object.entries(properties ?? {})) {
+    if (value !== void 0) out[key] = value;
+  }
+  return out;
+}
+function emitAutomaticEvent(name, properties) {
+  const event = {
+    name,
+    properties: compactProperties(properties)
+  };
+  if (listeners.size === 0) {
+    pending3.push(event);
+    if (pending3.length > MAX_PENDING2) pending3.shift();
+    return;
+  }
+  for (const listener of listeners) {
+    try {
+      listener(event);
+    } catch {
+    }
+  }
+}
+function subscribeAutomaticEvents(listener) {
+  listeners.add(listener);
+  if (pending3.length > 0) {
+    const buffered = pending3.splice(0, pending3.length);
+    for (const event of buffered) {
+      try {
+        listener(event);
+      } catch {
+      }
+    }
+  }
+  return () => {
+    listeners.delete(listener);
+  };
+}
+var listeners, pending3, MAX_PENDING2;
+var init_automaticEvents = __esm({
+  "lib/module/analytics/automaticEvents.js"() {
+    "use strict";
+    listeners = /* @__PURE__ */ new Set();
+    pending3 = [];
+    MAX_PENDING2 = 50;
+  }
+});
+
 // lib/module/analytics/EventTracker.js
 function uuid() {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
@@ -10723,7 +10766,9 @@ var init_EventTracker = __esm({
   "lib/module/analytics/EventTracker.js"() {
     "use strict";
     init_StorageBackend();
+    init_device();
     init_deviceId();
+    init_version();
     init_internalLogger();
     init_nativeCrashBridge();
     init_hmacSha256();
@@ -10752,7 +10797,7 @@ var init_EventTracker = __esm({
       constructor(config) {
         this.storage = createStorageBackend();
         this.cfg = {
-          platform: "react_native",
+          platform: resolveEventPlatform(),
           flushIntervalMs: DEFAULT_FLUSH_MS,
           batchSize: DEFAULT_BATCH,
           autoLifecycleEvents: true,
@@ -10978,7 +11023,7 @@ var init_EventTracker = __esm({
           event_name: eventName,
           event_time: Date.now(),
           app_id: this.cfg.appId,
-          platform: this.cfg.platform ?? "react_native",
+          platform: this.cfg.platform ?? resolveEventPlatform(),
           installation_id: this.installationId,
           anonymous_id: this.anonymousId,
           session_id: canonicalSessionId || this.sessionId,
@@ -10989,7 +11034,7 @@ var init_EventTracker = __esm({
             ...properties ?? {}
           },
           context: {
-            sdk_version: ctx.sdk_version ?? "0.1.0",
+            sdk_version: ctx.sdk_version ?? SDK_VERSION,
             ...ctx
           }
         };
@@ -11073,6 +11118,38 @@ var init_EventTracker = __esm({
   }
 });
 
+// lib/module/core/id/installationId.js
+function resolveInstallationId() {
+  try {
+    const storage3 = createStorageBackend();
+    const existing = storage3.get(K_INSTALLATION_ID);
+    if (existing) return existing;
+    const id = `inst-${randomSegment()}${randomSegment()}`;
+    storage3.set(K_INSTALLATION_ID, id);
+    return id;
+  } catch {
+    return `inst-ephemeral-${randomSegment()}`;
+  }
+}
+function randomSegment() {
+  try {
+    const g = globalThis;
+    if (g.crypto?.getRandomValues) {
+      const bytes = g.crypto.getRandomValues(new Uint8Array(6));
+      return Array.from(bytes).map((b) => b.toString(36).padStart(2, "0")).join("").slice(0, 8);
+    }
+  } catch {
+  }
+  return Math.random().toString(36).slice(2, 10).padEnd(8, "0");
+}
+var init_installationId = __esm({
+  "lib/module/core/id/installationId.js"() {
+    "use strict";
+    init_StorageBackend();
+    init_EventTracker();
+  }
+});
+
 // lib/module/features/engage/engageSignals.js
 var EngageSignalBus, engageSignals;
 var init_engageSignals = __esm({
@@ -11532,18 +11609,6 @@ function subscribeNativeProgress(onTick) {
     };
   }
 }
-function resolveInstallationId() {
-  try {
-    const storage3 = createStorageBackend();
-    const existing = storage3.get(K_INSTALLATION_ID);
-    if (existing) return existing;
-    const id = `inst-${Math.random().toString(36).slice(2, 10)}${Math.random().toString(36).slice(2, 10)}`;
-    storage3.set(K_INSTALLATION_ID, id);
-    return id;
-  } catch {
-    return `inst-ephemeral-${Math.random().toString(36).slice(2, 10)}`;
-  }
-}
 async function deliverOtaEvents(params) {
   const events = otaEventEmitter.flush();
   if (!events.length) return;
@@ -11593,7 +11658,7 @@ var init_OtaOrchestrator = __esm({
     init_OtaEventEmitter();
     init_geoCountry();
     init_deviceAttributes();
-    init_EventTracker();
+    init_installationId();
     init_signature();
     init_environment();
     init_retry();
@@ -12715,6 +12780,7 @@ var init_journeyManager = __esm({
     "use strict";
     init_journeyTypes();
     init_gestureBuffer();
+    init_version();
     init_gestureDetector();
     init_navDetector();
     init_screenshotHelper();
@@ -13071,7 +13137,7 @@ var init_journeyManager = __esm({
           journeyEnabled: this.config.enabled,
           canScreenshot: this.screenshotHelper.canCapture,
           navMode: this.navDetector.navMode,
-          sdkVersion: "0.1.0"
+          sdkVersion: SDK_VERSION
         };
         this._emitEvent(JOURNEY_EVENTS.DEBUG_READY, payload);
       }
@@ -15332,6 +15398,7 @@ function decodeManual(base64) {
 }
 
 // lib/module/features/session/BackendSessionAdapter.js
+init_installationId();
 init_version();
 init_bridgeAdapter();
 init_nativeModule();
@@ -15467,6 +15534,13 @@ var BackendSessionAdapter = class _BackendSessionAdapter {
       const payload = {
         sessionId: session.sessionId,
         deviceId: session.deviceId,
+        // The canonical per-install id — the SAME value OTA events are
+        // reported under, and a DIFFERENT value from deviceId. The
+        // backend stores it on the Device so release health can join a
+        // bundle's installs to that device's sessions. Without it, crash
+        // impact for a release resolves to "no data" for every device
+        // that never registered for push.
+        installationId: resolveInstallationId(),
         startedAt: session.startedAt,
         // Link the recording row to the always-on analytics row so the
         // dashboard can join them. track() events land on the analytics
@@ -17014,6 +17088,10 @@ function isSessionLaneEvent(name) {
 function resolveEventLane(name) {
   return isSessionLaneEvent(name) ? "session" : "analytics";
 }
+var INTERNAL_ONLY_SIGNALS = /* @__PURE__ */ new Set(["$network_request"]);
+function isUploadedSessionEvent(name) {
+  return !INTERNAL_ONLY_SIGNALS.has(name);
+}
 
 // lib/module/config/ConfigManager.js
 init_StorageBackend();
@@ -19498,7 +19576,8 @@ var ScaleBunFacade = class {
         appId,
         clientKey,
         apiBaseUrl,
-        platform: rawConfig?.platform ?? "react_native",
+        // Auto-detected (Platform.OS) unless the integration overrides it — see resolveEventPlatform.
+        platform: rawConfig?.platform ?? resolveEventPlatform(),
         appVersion: rawConfig?.appVersion,
         osVersion: rawConfig?.osVersion,
         autoLifecycleEvents: rawConfig?.autoLifecycleEvents !== false,
@@ -20308,7 +20387,8 @@ var ScaleBunFacade = class {
       __DEV__ && logger.debug("Tracking event:", name);
       engageSignals.emit(name, payload);
       const adapter = SessionManager.getExistingInstance()?.getBackendTransport();
-      if (this._clientKey && adapter) {
+      if (!isUploadedSessionEvent(name)) {
+      } else if (this._clientKey && adapter) {
         adapter.trackEvent({
           eventId: generateEventId(),
           sessionId: adapter.analyticsSessionId ?? "",