@goliapkg/sentori-react-native 0.8.1 → 0.8.2

package/lib/init.d.ts

@@ -1,3 +1,4 @@
+import { type PreCrashChannel } from './pre-crash-sentinel';
 import type { AttachmentMeta } from './types';
 export type InitOptions = {
     /** Project token starting with `st_pk_`. Required. */
@@ -36,6 +37,13 @@ export type InitOptions = {
          *  the buffer is sealed and uploaded as a `sessionTrail`
          *  attachment. Defaults to false. */
         sessionTrail?: boolean;
+        /** v0.9.1 +S4 — pre-crash sentinel. Subscribes to JS-thread
+         *  frame timing; when ≥ 50% of a 60-frame window misses the
+         *  budget (default 32 ms / < 30 fps), emits a `kind: nearCrash`
+         *  event proactively so dashboards see the "about-to-die"
+         *  signal before an actual crash. */
+        preCrashSentinel?: boolean;
+        sentinelChannels?: PreCrashChannel[];
         /** v0.9.0 #3 — launch-crash loop guard. When two consecutive
          *  launches don't reach `markLaunchCompleted()` (typical of an
          *  OTA update with a fatal bug), invoke the host callback with

package/lib/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAkB,cAAc,EAA2B,MAAM,SAAS,CAAC;AAIvF,MAAM,MAAM,WAAW,GAAG;IACxB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,OAAO,CAAC,EACJ,OAAO,GACP;YACE;;qEAEyD;YACzD,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;QACN;;8DAEsD;QACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;;;;;;uBAOe;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB;;;6CAGqC;QACrC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB;;;sEAG8D;QAC9D,gBAAgB,CAAC,EAAE;YACjB,OAAO,EAAE,OAAO,CAAC;YACjB,qBAAqB,CAAC,EAAE,CACtB,IAAI,EAAE,OAAO,sBAAsB,EAAE,eAAe,KAElD,OAAO,sBAAsB,EAAE,iBAAiB,GAChD,OAAO,CAAC,OAAO,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;YAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF;;;;;gEAK4D;IAC5D,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAIF,eAAO,MAAM,IAAI,GAAI,SAAS,WAAW,KAAG,IAoH3C,CAAC;AAiBF,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAaA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQnF,OAAO,KAAK,EAAkB,cAAc,EAA2B,MAAM,SAAS,CAAC;AAIvF,MAAM,MAAM,WAAW,GAAG;IACxB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,OAAO,CAAC,EACJ,OAAO,GACP;YACE;;qEAEyD;YACzD,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;QACN;;8DAEsD;QACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;;;;;;uBAOe;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB;;;6CAGqC;QACrC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB;;;;6CAIqC;QACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;QACrC;;;sEAG8D;QAC9D,gBAAgB,CAAC,EAAE;YACjB,OAAO,EAAE,OAAO,CAAC;YACjB,qBAAqB,CAAC,EAAE,CACtB,IAAI,EAAE,OAAO,sBAAsB,EAAE,eAAe,KAElD,OAAO,sBAAsB,EAAE,iBAAiB,GAChD,OAAO,CAAC,OAAO,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;YAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF;;;;;gEAK4D;IAC5D,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAIF,eAAO,MAAM,IAAI,GAAI,SAAS,WAAW,KAAG,IA4H3C,CAAC;AAiBF,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/lib/init.js

@@ -8,6 +8,7 @@ import { markLaunchCompleted, runLaunchCrashGuard, } from './launch-crash-guard'
 import { startMetricsTimer } from './metrics';
 import { drainNativePending, setNativeConfig } from './native';
 import { startNetworkTypeWatch } from './netinfo';
+import { startPreCrashSentinel } from './pre-crash-sentinel';
 import { startSession } from './session-tracker';
 import { drainOfflineQueue, enqueue, startTransport, uploadAttachment, } from './transport';
 const DEFAULT_INGEST_URL = 'https://ingest.sentori.golia.jp';
@@ -53,6 +54,14 @@ export const init = (options) => {
     startNetworkTypeWatch();
     // v0.8.3 — drain custom-metric ring every 30 s.
     startMetricsTimer();
+    // v0.9.1 +S4 — pre-crash sentinel. Off by default; opt-in via
+    // `capture.preCrashSentinel: true`.
+    if (options.capture?.preCrashSentinel === true) {
+        startPreCrashSentinel({
+            enabled: true,
+            channels: options.capture.sentinelChannels,
+        });
+    }
     const capture = options.capture ?? {};
     if (capture.globalErrors !== false)
         installGlobalHandler();

package/lib/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AA8ErB,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAE7D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,OAAoB,EAAQ,EAAE;IACjD,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GACP,OAAO,CAAC,WAAW;QACnB,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAE/D,oEAAoE;IACpE,gEAAgE;IAChE,oEAAoE;IACpE,2BAA2B;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAC9C,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;QACjB,KAAK,mBAAmB,CACtB,GAAG,EACH,OAAO,CAAC,OAAO,EACf,aAAa,EAAE,EAAE,EAAE,IAAI,IAAI,CAC5B,CAAC;IACJ,CAAC;IAED,SAAS,CAAC;QACR,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB;QAClD,OAAO,EAAE,IAAI;QACb,kBAAkB,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI;QACxD,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,IAAI;QACjD,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,IAAI;QACjD,mBAAmB,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI;KAC5D,CAAC,CAAC;IAEH,uEAAuE;IACvE,iEAAiE;IACjE,eAAe,CAAC;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,GAAG;KACjB,CAAC,CAAC;IAEH,cAAc,EAAE,CAAC;IACjB,kEAAkE;IAClE,kEAAkE;IAClE,QAAQ;IACR,qBAAqB,EAAE,CAAC;IACxB,gDAAgD;IAChD,iBAAiB,EAAE,CAAC;IACpB,8DAA8D;IAC9D,oCAAoC;IACpC,IAAI,OAAO,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC/C,qBAAqB,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK;QAAE,oBAAoB,EAAE,CAAC;IAC3D,IAAI,OAAO,CAAC,iBAAiB,KAAK,KAAK;QAAE,qBAAqB,EAAE,CAAC;IACjE,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,qBAAqB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC/B,+DAA+D;QAC/D,kEAAkE;QAClE,gEAAgE;QAChE,YAAY,EAAE,CAAC;QACf,uBAAuB,EAAE,CAAC;IAC5B,CAAC;IAED,8DAA8D;IAC9D,2DAA2D;IAC3D,iDAAiD;IACjD,kBAAkB,EAAE;SACjB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAE5B,CAAC;gBACF,8DAA8D;gBAC9D,2DAA2D;gBAC3D,0DAA0D;gBAC1D,6DAA6D;gBAC7D,2DAA2D;gBAC3D,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;wBAC1C,MAAM,IAAI,GAAG,MAAM,gBAAgB,CACjC,KAAK,CAAC,EAAE,EACR,CAAC,CAAC,IAAI,EACN,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAC5C,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CACrB,CAAC;wBACF,IAAI,IAAI,EAAE,CAAC;4BACT,IAAI,CAAC,KAAK,CAAC,WAAW;gCAAE,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC;4BAC/C,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC/B,CAAC;oBACH,CAAC;oBACD,OAAO,KAAK,CAAC,mBAAmB,CAAC;gBACnC,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnB,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEpC,kEAAkE;IAClE,mEAAmE;IACnE,qEAAqE;IACrE,uEAAuE;IACvE,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;QACjB,UAAU,CAAC,GAAG,EAAE;YACd,KAAK,mBAAmB,CAAC,aAAa,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC;QACxD,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}

package/lib/pre-crash-sentinel.d.ts

@@ -0,0 +1,12 @@
+export type PreCrashChannel = 'frame-budget-overrun' | 'memory-pressure' | 'oom-warning' | 'storage-low';
+export type PreCrashSentinelOptions = {
+    enabled: boolean;
+    channels?: PreCrashChannel[];
+    /** Lower → more sensitive. Default 32 ms (< 30 fps). */
+    frameBudgetMs?: number;
+    /** Fraction of frames in the window that must miss budget. Default 0.5. */
+    tripRatio?: number;
+};
+export declare function startPreCrashSentinel(opts: PreCrashSentinelOptions): void;
+export declare function stopPreCrashSentinel(): void;
+//# sourceMappingURL=pre-crash-sentinel.d.ts.map

package/lib/pre-crash-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-crash-sentinel.d.ts","sourceRoot":"","sources":["../src/pre-crash-sentinel.ts"],"names":[],"mappings":"AAmCA,MAAM,MAAM,eAAe,GACvB,sBAAsB,GACtB,iBAAiB,GACjB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAUzE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/lib/pre-crash-sentinel.js

@@ -0,0 +1,116 @@
+// v0.9.1 +S4 — pre-crash sentinel.
+//
+// Predictive (vs reactive) telemetry. Subscribes to JS-thread frame
+// timing via requestAnimationFrame and, when a rolling 60-frame
+// window has ≥ 50% of frames slower than 32 ms (i.e. < 30 fps for
+// half the window), emits an `event.kind = nearCrash` to the server.
+// Backend stores it in the same events stream so the dashboard shows
+// "X user sessions had near-crash signals 4 minutes before the
+// actual NSException".
+//
+// Memory pressure / OOM / storage low signals will need native
+// system observers and ship in v1.0. v0.9.1 covers the most common
+// runaway-render-loop case purely from JS.
+import { startSpan } from '@goliapkg/sentori-core';
+import { getBundleInfo } from './bundle-info';
+import { collectDeviceForSentinel, getAppForSentinel } from './sentinel-context';
+import { getConfig, isInitialized } from './config';
+import { enqueue } from './transport';
+import { uuidV7 } from './uuid';
+const FRAME_BUDGET_MS = 32; // < 30 fps
+const WINDOW_FRAMES = 60; // ~1 s at 60 fps
+const TRIP_RATIO = 0.5;
+const COOLDOWN_MS = 60_000; // don't spam: one nearCrash event per minute
+let _running = false;
+let _lastFrameAt = 0;
+let _slowFrames = 0;
+let _totalFrames = 0;
+let _lastEmitAt = 0;
+let _channels = new Set();
+export function startPreCrashSentinel(opts) {
+    if (!opts.enabled || _running)
+        return;
+    _running = true;
+    _channels = new Set(opts.channels ?? ['frame-budget-overrun']);
+    if (_channels.has('frame-budget-overrun')) {
+        startFrameBudgetWatch(opts.frameBudgetMs ?? FRAME_BUDGET_MS, opts.tripRatio ?? TRIP_RATIO);
+    }
+    // Native channels (memory-pressure, oom-warning, storage-low) hook
+    // through a TODO native module in v1.0.
+}
+export function stopPreCrashSentinel() {
+    _running = false;
+    _slowFrames = 0;
+    _totalFrames = 0;
+    _channels.clear();
+}
+function startFrameBudgetWatch(budgetMs, tripRatio) {
+    if (typeof requestAnimationFrame !== 'function')
+        return;
+    _lastFrameAt = Date.now();
+    function tick() {
+        if (!_running)
+            return;
+        const now = Date.now();
+        const delta = now - _lastFrameAt;
+        _lastFrameAt = now;
+        if (delta >= budgetMs)
+            _slowFrames++;
+        _totalFrames++;
+        if (_totalFrames >= WINDOW_FRAMES) {
+            const ratio = _slowFrames / _totalFrames;
+            if (ratio >= tripRatio && now - _lastEmitAt > COOLDOWN_MS) {
+                _lastEmitAt = now;
+                emitNearCrash({
+                    slowFrames: _slowFrames,
+                    totalFrames: _totalFrames,
+                    ratio,
+                    windowMs: WINDOW_FRAMES * (budgetMs / 2), // approximate
+                    channel: 'frame-budget-overrun',
+                });
+            }
+            _slowFrames = 0;
+            _totalFrames = 0;
+        }
+        requestAnimationFrame(tick);
+    }
+    requestAnimationFrame(tick);
+}
+function emitNearCrash(data) {
+    if (!isInitialized())
+        return;
+    const config = getConfig();
+    if (!config)
+        return;
+    const span = startSpan('sentori.nearCrash', {
+        name: data.channel,
+        tags: {
+            'nearCrash.channel': data.channel,
+            'nearCrash.ratio': data.ratio.toFixed(3),
+            'nearCrash.slow_frames': String(data.slowFrames),
+            'nearCrash.total_frames': String(data.totalFrames),
+        },
+    });
+    span.finish({ status: 'ok' });
+    const event = {
+        id: uuidV7(),
+        timestamp: new Date().toISOString(),
+        kind: 'nearCrash',
+        platform: 'javascript',
+        release: config.release,
+        environment: config.environment,
+        device: collectDeviceForSentinel(),
+        app: getAppForSentinel(config.release),
+        ...(getBundleInfo() ? { bundle: getBundleInfo() } : {}),
+        error: {
+            type: 'NearCrash',
+            message: `frame budget overrun: ${(data.ratio * 100).toFixed(0)}% of last ${data.totalFrames} frames slow`,
+            stack: [],
+        },
+        tags: {
+            'nearCrash.channel': data.channel,
+        },
+    };
+    enqueue(event);
+}
+//# sourceMappingURL=pre-crash-sentinel.js.map

package/lib/pre-crash-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-crash-sentinel.js","sourceRoot":"","sources":["../src/pre-crash-sentinel.ts"],"names":[],"mappings":"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"}

package/lib/sentinel-context.d.ts

@@ -0,0 +1,4 @@
+import type { App, Device } from './types';
+export declare const collectDeviceForSentinel: () => Device;
+export declare const getAppForSentinel: (release: string) => App;
+//# sourceMappingURL=sentinel-context.d.ts.map

package/lib/sentinel-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-context.d.ts","sourceRoot":"","sources":["../src/sentinel-context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,wBAAwB,QAAO,MAgC3C,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,GAkBnD,CAAC"}

package/lib/sentinel-context.js

@@ -0,0 +1,52 @@
+// Shared device + app collectors. Used by both capture.ts (errors)
+// and pre-crash-sentinel.ts (nearCrash). Same shape so the dashboard
+// can render both kinds of events through the same UI components.
+import { getCachedNetworkType } from './netinfo';
+export const collectDeviceForSentinel = () => {
+    let os = 'other';
+    let osVersion = '0';
+    let locale;
+    const networkType = getCachedNetworkType();
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const RN = require('react-native');
+        const rnOS = RN.Platform.OS;
+        os = rnOS === 'android' || rnOS === 'ios' || rnOS === 'web' ? rnOS : 'other';
+        osVersion = String(RN.Platform.Version);
+        if (rnOS === 'ios') {
+            const s = RN.NativeModules.SettingsManager?.settings;
+            locale = s?.AppleLocale ?? s?.AppleLanguages?.[0];
+        }
+        else if (rnOS === 'android') {
+            locale = RN.NativeModules.I18nManager?.localeIdentifier;
+        }
+    }
+    catch {
+        // not in RN runtime
+    }
+    const device = { os, osVersion };
+    if (locale)
+        device.locale = locale;
+    if (networkType)
+        device.networkType = networkType;
+    return device;
+};
+export const getAppForSentinel = (release) => {
+    const m = /^(?:[^@]+@)?([^+]+)(?:\+(.+))?$/.exec(release);
+    const version = m?.[1] ?? '0.0.0';
+    const build = m?.[2];
+    let rnVersion = 'unknown';
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        rnVersion = require('react-native/package.json').version;
+    }
+    catch {
+        // not in RN runtime
+    }
+    return {
+        build,
+        framework: { name: 'react-native', version: rnVersion },
+        version,
+    };
+};
+//# sourceMappingURL=sentinel-context.js.map

package/lib/sentinel-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-context.js","sourceRoot":"","sources":["../src/sentinel-context.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,qEAAqE;AACrE,kEAAkE;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAW,EAAE;IACnD,IAAI,EAAE,GAAiB,OAAO,CAAC;IAC/B,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,IAAI,MAA0B,CAAC;IAC/B,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAQhC,CAAC;QACF,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,EAAE,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7E,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,QAAQ,CAAC;YACrD,MAAM,GAAG,CAAC,EAAE,WAAW,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,gBAAgB,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IACD,MAAM,MAAM,GAAW,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IACzC,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACnC,IAAI,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAO,EAAE;IACxD,MAAM,CAAC,GAAG,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAErB,IAAI,SAAS,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC;QACH,iEAAiE;QACjE,SAAS,GAAI,OAAO,CAAC,2BAA2B,CAAyB,CAAC,OAAO,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IAED,OAAO;QACL,KAAK;QACL,SAAS,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE;QACvD,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/sentori-react-native",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Sentori SDK for React Native \u2014 JS-layer error capture, native crash handlers (iOS / Android), batched transport, fetch + react-navigation tracing.",
   "license": "MIT",
   "homepage": "https://sentori.golia.jp",
@@ -80,6 +80,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@goliapkg/sentori-core": "0.8.0"
+    "@goliapkg/sentori-core": "0.8.1"
   }
 }

package/src/init.ts

@@ -11,6 +11,7 @@ import {
 import { startMetricsTimer } from './metrics';
 import { drainNativePending, setNativeConfig } from './native';
 import { startNetworkTypeWatch } from './netinfo';
+import { startPreCrashSentinel, type PreCrashChannel } from './pre-crash-sentinel';
 import { startSession } from './session-tracker';
 import {
   drainOfflineQueue,
@@ -61,6 +62,13 @@ export type InitOptions = {
      *  the buffer is sealed and uploaded as a `sessionTrail`
      *  attachment. Defaults to false. */
     sessionTrail?: boolean;
+    /** v0.9.1 +S4 — pre-crash sentinel. Subscribes to JS-thread
+     *  frame timing; when ≥ 50% of a 60-frame window misses the
+     *  budget (default 32 ms / < 30 fps), emits a `kind: nearCrash`
+     *  event proactively so dashboards see the "about-to-die"
+     *  signal before an actual crash. */
+    preCrashSentinel?: boolean;
+    sentinelChannels?: PreCrashChannel[];
     /** v0.9.0 #3 — launch-crash loop guard. When two consecutive
      *  launches don't reach `markLaunchCompleted()` (typical of an
      *  OTA update with a fatal bug), invoke the host callback with
@@ -142,6 +150,14 @@ export const init = (options: InitOptions): void => {
   startNetworkTypeWatch();
   // v0.8.3 — drain custom-metric ring every 30 s.
   startMetricsTimer();
+  // v0.9.1 +S4 — pre-crash sentinel. Off by default; opt-in via
+  // `capture.preCrashSentinel: true`.
+  if (options.capture?.preCrashSentinel === true) {
+    startPreCrashSentinel({
+      enabled: true,
+      channels: options.capture.sentinelChannels,
+    });
+  }
 
   const capture = options.capture ?? {};
   if (capture.globalErrors !== false) installGlobalHandler();

package/src/pre-crash-sentinel.ts

@@ -0,0 +1,140 @@
+// v0.9.1 +S4 — pre-crash sentinel.
+//
+// Predictive (vs reactive) telemetry. Subscribes to JS-thread frame
+// timing via requestAnimationFrame and, when a rolling 60-frame
+// window has ≥ 50% of frames slower than 32 ms (i.e. < 30 fps for
+// half the window), emits an `event.kind = nearCrash` to the server.
+// Backend stores it in the same events stream so the dashboard shows
+// "X user sessions had near-crash signals 4 minutes before the
+// actual NSException".
+//
+// Memory pressure / OOM / storage low signals will need native
+// system observers and ship in v1.0. v0.9.1 covers the most common
+// runaway-render-loop case purely from JS.
+
+import { startSpan } from '@goliapkg/sentori-core';
+
+import { getBundleInfo } from './bundle-info';
+import { collectDeviceForSentinel, getAppForSentinel } from './sentinel-context';
+import { getConfig, isInitialized } from './config';
+import { enqueue } from './transport';
+import { uuidV7 } from './uuid';
+import type { Event } from './types';
+
+const FRAME_BUDGET_MS = 32; // < 30 fps
+const WINDOW_FRAMES = 60; // ~1 s at 60 fps
+const TRIP_RATIO = 0.5;
+const COOLDOWN_MS = 60_000; // don't spam: one nearCrash event per minute
+
+let _running = false;
+let _lastFrameAt = 0;
+let _slowFrames = 0;
+let _totalFrames = 0;
+let _lastEmitAt = 0;
+let _channels: Set<string> = new Set();
+
+export type PreCrashChannel =
+  | 'frame-budget-overrun'
+  | 'memory-pressure'  // native, v1.0
+  | 'oom-warning'      // native, v1.0
+  | 'storage-low';     // native, v1.0
+
+export type PreCrashSentinelOptions = {
+  enabled: boolean;
+  channels?: PreCrashChannel[];
+  /** Lower → more sensitive. Default 32 ms (< 30 fps). */
+  frameBudgetMs?: number;
+  /** Fraction of frames in the window that must miss budget. Default 0.5. */
+  tripRatio?: number;
+};
+
+export function startPreCrashSentinel(opts: PreCrashSentinelOptions): void {
+  if (!opts.enabled || _running) return;
+  _running = true;
+  _channels = new Set(opts.channels ?? ['frame-budget-overrun']);
+
+  if (_channels.has('frame-budget-overrun')) {
+    startFrameBudgetWatch(opts.frameBudgetMs ?? FRAME_BUDGET_MS, opts.tripRatio ?? TRIP_RATIO);
+  }
+  // Native channels (memory-pressure, oom-warning, storage-low) hook
+  // through a TODO native module in v1.0.
+}
+
+export function stopPreCrashSentinel(): void {
+  _running = false;
+  _slowFrames = 0;
+  _totalFrames = 0;
+  _channels.clear();
+}
+
+function startFrameBudgetWatch(budgetMs: number, tripRatio: number): void {
+  if (typeof requestAnimationFrame !== 'function') return;
+  _lastFrameAt = Date.now();
+  function tick() {
+    if (!_running) return;
+    const now = Date.now();
+    const delta = now - _lastFrameAt;
+    _lastFrameAt = now;
+    if (delta >= budgetMs) _slowFrames++;
+    _totalFrames++;
+    if (_totalFrames >= WINDOW_FRAMES) {
+      const ratio = _slowFrames / _totalFrames;
+      if (ratio >= tripRatio && now - _lastEmitAt > COOLDOWN_MS) {
+        _lastEmitAt = now;
+        emitNearCrash({
+          slowFrames: _slowFrames,
+          totalFrames: _totalFrames,
+          ratio,
+          windowMs: WINDOW_FRAMES * (budgetMs / 2), // approximate
+          channel: 'frame-budget-overrun',
+        });
+      }
+      _slowFrames = 0;
+      _totalFrames = 0;
+    }
+    requestAnimationFrame(tick);
+  }
+  requestAnimationFrame(tick);
+}
+
+function emitNearCrash(data: {
+  slowFrames: number;
+  totalFrames: number;
+  ratio: number;
+  windowMs: number;
+  channel: PreCrashChannel;
+}): void {
+  if (!isInitialized()) return;
+  const config = getConfig();
+  if (!config) return;
+  const span = startSpan('sentori.nearCrash', {
+    name: data.channel,
+    tags: {
+      'nearCrash.channel': data.channel,
+      'nearCrash.ratio': data.ratio.toFixed(3),
+      'nearCrash.slow_frames': String(data.slowFrames),
+      'nearCrash.total_frames': String(data.totalFrames),
+    },
+  });
+  span.finish({ status: 'ok' });
+  const event: Event = {
+    id: uuidV7(),
+    timestamp: new Date().toISOString(),
+    kind: 'nearCrash',
+    platform: 'javascript',
+    release: config.release,
+    environment: config.environment,
+    device: collectDeviceForSentinel(),
+    app: getAppForSentinel(config.release),
+    ...(getBundleInfo() ? { bundle: getBundleInfo() as { id: string } } : {}),
+    error: {
+      type: 'NearCrash',
+      message: `frame budget overrun: ${(data.ratio * 100).toFixed(0)}% of last ${data.totalFrames} frames slow`,
+      stack: [],
+    },
+    tags: {
+      'nearCrash.channel': data.channel,
+    },
+  };
+  enqueue(event);
+}

package/src/sentinel-context.ts

@@ -0,0 +1,60 @@
+// Shared device + app collectors. Used by both capture.ts (errors)
+// and pre-crash-sentinel.ts (nearCrash). Same shape so the dashboard
+// can render both kinds of events through the same UI components.
+
+import { getCachedNetworkType } from './netinfo';
+import type { App, Device } from './types';
+
+export const collectDeviceForSentinel = (): Device => {
+  let os: Device['os'] = 'other';
+  let osVersion = '0';
+  let locale: string | undefined;
+  const networkType = getCachedNetworkType();
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const RN = require('react-native') as {
+      NativeModules: {
+        I18nManager?: { localeIdentifier?: string };
+        SettingsManager?: {
+          settings?: { AppleLanguages?: string[]; AppleLocale?: string };
+        };
+      };
+      Platform: { OS: string; Version: number | string };
+    };
+    const rnOS = RN.Platform.OS;
+    os = rnOS === 'android' || rnOS === 'ios' || rnOS === 'web' ? rnOS : 'other';
+    osVersion = String(RN.Platform.Version);
+    if (rnOS === 'ios') {
+      const s = RN.NativeModules.SettingsManager?.settings;
+      locale = s?.AppleLocale ?? s?.AppleLanguages?.[0];
+    } else if (rnOS === 'android') {
+      locale = RN.NativeModules.I18nManager?.localeIdentifier;
+    }
+  } catch {
+    // not in RN runtime
+  }
+  const device: Device = { os, osVersion };
+  if (locale) device.locale = locale;
+  if (networkType) device.networkType = networkType;
+  return device;
+};
+
+export const getAppForSentinel = (release: string): App => {
+  const m = /^(?:[^@]+@)?([^+]+)(?:\+(.+))?$/.exec(release);
+  const version = m?.[1] ?? '0.0.0';
+  const build = m?.[2];
+
+  let rnVersion = 'unknown';
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    rnVersion = (require('react-native/package.json') as { version: string }).version;
+  } catch {
+    // not in RN runtime
+  }
+
+  return {
+    build,
+    framework: { name: 'react-native', version: rnVersion },
+    version,
+  };
+};