@scalebun/react-native 1.3.3 → 1.5.0

package/dist/scalebun.slim.js

@@ -492,7 +492,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";
   }
 });
 
@@ -542,6 +542,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";
@@ -5327,6 +5331,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;
@@ -5421,7 +5429,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 {
@@ -5556,6 +5564,7 @@ var init_bootstrap = __esm({
     "use strict";
     import_transport = __toESM(require_devtools_stub());
     init_timings();
+    init_version();
     import_stream = __toESM(require_devtools_stub());
     import_commands = __toESM(require_devtools_stub());
     init_internalLogger();
@@ -5849,89 +5858,6 @@ var init_NativeScaleBunPerformance = __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 = [];
@@ -6048,6 +5974,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) => {
@@ -6061,7 +6070,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();
@@ -6090,7 +6101,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,
@@ -6316,7 +6327,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,
@@ -6327,7 +6338,7 @@ var init_EventTracker = __esm({
             ...properties ?? {}
           },
           context: {
-            sdk_version: ctx.sdk_version ?? "0.1.0",
+            sdk_version: ctx.sdk_version ?? SDK_VERSION,
             ...ctx
           }
         };
@@ -6411,6 +6422,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({
@@ -6870,18 +6913,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;
@@ -6931,7 +6962,7 @@ var init_OtaOrchestrator = __esm({
     init_OtaEventEmitter();
     init_geoCountry();
     init_deviceAttributes();
-    init_EventTracker();
+    init_installationId();
     init_signature();
     init_environment();
     init_retry();
@@ -8053,6 +8084,7 @@ var init_journeyManager = __esm({
     "use strict";
     init_journeyTypes();
     init_gestureBuffer();
+    init_version();
     init_gestureDetector();
     init_navDetector();
     init_screenshotHelper();
@@ -8409,7 +8441,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);
       }
@@ -10491,7 +10523,7 @@ var PERF_SCHEMA_VERSION = 1;
 
 // lib/module/features/performance/collectors/JsStallCollector.js
 var MAX_STALL_RECORDS = 100;
-var JsStallCollector = class {
+var JsStallCollector = class _JsStallCollector {
   pollTimer = null;
   reportTimer = null;
   lastTick = 0;
@@ -10501,6 +10533,11 @@ var JsStallCollector = class {
   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;
@@ -10561,6 +10598,13 @@ var JsStallCollector = class {
     }
     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",
@@ -10948,13 +10992,27 @@ var AutoScreenLoadCollector = class {
 
 // lib/module/features/performance/collectors/FrameMetricsCollector.js
 var import_react_native12 = require("react-native");
-var FrameMetricsCollector = class {
+var 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;
@@ -11057,10 +11115,17 @@ var FrameMetricsCollector = class {
     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,
@@ -11068,7 +11133,7 @@ var FrameMetricsCollector = class {
       droppedFrames,
       slowFrames,
       frozenFrames,
-      estimatedFps: Math.min(60, Math.max(0, estimatedFps)),
+      estimatedFps: clampedFps,
       maxFrameTimeMs
     };
     this.onFrameMetrics(event);
@@ -12131,6 +12196,7 @@ function decodeManual(base64) {
 }
 
 // lib/module/features/session/BackendSessionAdapter.js
+init_installationId();
 init_version();
 init_bridgeAdapter();
 init_nativeModule();
@@ -12266,6 +12332,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
@@ -13813,6 +13886,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();
@@ -16296,7 +16373,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,
@@ -17106,7 +17184,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 ?? "",