@everframe/react-native 1.0.0 → 1.2.0

package/android/src/main/java/dev/everframe/rn/ReporterBridge.kt

@@ -0,0 +1,89 @@
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: 2026 ScriptX
+package dev.everframe.rn
+
+import android.app.Activity
+import android.content.Context
+import android.os.Handler
+import android.os.Looper
+import android.util.Log
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.common.LifecycleState
+import dev.everframe.Everframe
+import dev.everframe.config.ReportResult
+import java.lang.reflect.InvocationTargetException
+import java.lang.reflect.Method
+import kotlin.coroutines.Continuation
+import kotlin.coroutines.intrinsics.suspendCoroutineUninterceptedOrReturn
+import kotlinx.coroutines.CancellationException
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+/** Reflection preserves compatibility with separately built native reporter artifacts. */
+internal class ReporterBridge(
+    private val resolveInstaller: () -> Class<*> = { Class.forName("dev.everframe.ui.ReporterResolverInstaller") },
+) {
+    fun scheduleInstall(context: Context) {
+        val application = context.applicationContext
+        val install = Runnable {
+            try {
+                val type = installerType()
+                invoke(type.getMethod("create", Context::class.java), type.getDeclaredConstructor().newInstance(), application)
+            } catch (_: Throwable) {
+                Log.w("Everframe.rn", "Reporter initialization deferred; opening will retry")
+            }
+        }
+        if (Looper.myLooper() == Looper.getMainLooper()) install.run()
+        else Handler(Looper.getMainLooper()).post(install)
+    }
+
+    suspend fun open(context: ReactApplicationContext): ReportResult = withContext(Dispatchers.Main.immediate) {
+        val activity = context.currentActivity
+        if (context.lifecycleState != LifecycleState.RESUMED || activity == null ||
+            activity.isFinishing || activity.isDestroyed || activity.application !== context.applicationContext) {
+            return@withContext ReportResult.Cancelled("no_active_activity")
+        }
+        try {
+            val type = installerType()
+            val instance = type.getDeclaredConstructor().newInstance()
+            val method = try {
+                type.getMethod("openForActivity", Context::class.java, Activity::class.java, Continuation::class.java)
+            } catch (_: NoSuchMethodException) { null }
+            if (method == null) {
+                // Absence is the only legacy fallback. A present method's failure is final.
+                invoke(type.getMethod("create", Context::class.java), instance, context.applicationContext)
+                Everframe.report.open()
+            } else {
+                suspendCoroutineUninterceptedOrReturn<ReportResult> { continuation ->
+                    invoke(method, instance, context.applicationContext, activity, continuation)
+                }
+            }
+        } catch (failure: Throwable) {
+            when (failure) {
+                is CancellationException -> throw failure
+                is ReporterBridgeFailure -> throw failure
+                is NoSuchMethodException -> throw ReporterBridgeFailure("Reporter UI is incompatible; update the native reporter dependency")
+                else -> throw ReporterBridgeFailure("Reporter initialization or opening failed")
+            }
+        }
+    }
+
+    private fun installerType(): Class<*> = try { resolveInstaller() }
+    catch (_: ClassNotFoundException) {
+        throw ReporterBridgeFailure("Reporter UI dependency is missing; add dev.everframe:reporter-ui")
+    }
+
+    private fun invoke(method: Method, instance: Any, vararg arguments: Any?): Any? =
+        try { method.invoke(instance, *arguments) }
+        catch (failure: InvocationTargetException) { throw failure.targetException }
+
+    /** Only SDK-owned constant messages may cross the JS promise boundary. */
+    fun rejectionMessage(failure: Throwable): String = when (failure) {
+        is ReporterBridgeFailure -> failure.message!!
+        is CancellationException -> "Reporter opening was cancelled"
+        else -> "Reporter initialization or opening failed"
+    }
+
+    // No host exception/cause is forwarded to JS or diagnostic logs.
+    private class ReporterBridgeFailure(message: String) : IllegalStateException(message)
+}

package/dist/NativeEverframe.d.ts

@@ -23,7 +23,7 @@ type Rect = {
  * Rich variants (e.g., callbacks, function refs) MUST stay on the JS side.
  */
 type ConfigOpts = {
-    apiKey?: string;
+    sdkKey?: string;
     sdkVersion?: string;
     /**
      * If true, the native side captures a UIWindow/SurfaceFlinger screenshot
@@ -49,6 +49,14 @@ type ConfigOpts = {
      * once polarity is flipped.
      */
     installIdentifierDisabled?: boolean;
+    /**
+     * Client veto for automatic crash capture. `true` turns off the native SDKs' crash capture
+     * (JVM, native crashes and ANRs on Android; native crashes on iOS) as well as the JS handlers:
+     * both natives store `capture.crash = !crashReportingDisabled`. Flat because RN codegen rejects
+     * nested objects; `extractBridgeConfig` flattens the host-facing `crashReporting: { disabled }`.
+     * Absent means capture stays on.
+     */
+    crashReportingDisabled?: boolean;
     /**
      * Built-in attach-PIN surface mode (spec 2026-08-19): 'builtin' (default —
      * the native SDK presents the code itself), 'custom' (host renders it from
@@ -128,6 +136,21 @@ type ConfigOpts = {
     vitalsEnabled?: boolean;
     vitalsSampleRate?: number;
     vitalsCaptureSourceQuery?: boolean;
+    /**
+     * Whether this is a debug build, which Everframe never makes a release out of. The JS facade always
+     * sends it (the config's `debugBuild`, else `__DEV__`). Absent means the native SDK decides for itself.
+     */
+    debugBuild?: boolean;
+    /**
+     * Native foreground monitoring (release health). The JS facade always sends this flag: `true` with a
+     * validated loaded bundle, or `false` to revoke monitoring. A bridge that finds it missing treats it as
+     * on, and only an explicit `false` as off. The native SDK reads the app version.
+     */
+    releaseHealthEnabled?: boolean;
+    releaseHealthLoadedBuildId?: string;
+    releaseHealthUserId?: string;
+    /** Count debug builds, which the native SDKs skip by default. Absent means false. */
+    releaseHealthIncludeDebugBuilds?: boolean;
 };
 /**
  * Host-declared user for self-declared recognition (spec 2026-08-12). Flat by
@@ -228,6 +251,8 @@ interface Spec extends TurboModule {
      * freeform-object escape hatch; `from`/`to` win over its keys.
      */
     recordScreen(name: string, data?: UnsafeObject): void;
+    /** Additive diagnostic bridge: bounded JSON of cached native observations; no I/O. */
+    getReportDeliveryStatusJson(): string;
     /**
      * Crash/error reporting (spec 2026-07-18). SYNCHRONOUS by design (non-void
      * return forces a sync TurboModule method): the fatal path must complete

package/dist/chunk-ENPQ66EV.js

@@ -0,0 +1 @@
+import{a as o}from"./chunk-XUSV3KOD.js";var h=["native-handled","bridge-handled","bridge-automatic","jvm-uncaught"],A=["persisted","disabled","admission-suppressed","reentrant","invalid-input","ownership-lost","storage-unavailable","failed"],S=["enqueue-committed","enqueue-failed","capacity-evicted","removed-after-acceptance","removed-after-terminal","removal-failed","read-failed"],T=["capacity","key-unavailable","corrupt","io","revoked","invalid-entry","busy","unknown","unsupported-format"],R=["live-submit","outbox-drain"],K=["server-accepted","retryable-http","terminal-http","network-failure","authorization-cancelled","cancelled","failed"],V=JSON.parse,H=Object.keys,y=Object.hasOwn,Q=Array.isArray,U=Number.isInteger,I=Reflect.apply,z=RegExp.prototype.test,_=/[^\x00-\x7f]/,k=2147483647;function d(e,t){let r={};for(let n=0;n<e.length;n++){let a=e[n];r[a]=t(a)}return r}o(d,"mapKeys");function J(e,t){return{schemaVersion:1,status:e,reason:t,scope:"native-runtime-observations",coverage:"best-effort",revision:0,capture:{enabled:!1,paths:d(h,()=>({supported:!1,settledAttempts:0,outcomes:d(A,()=>0)}))},queue:{scope:"sdk-report-outbox",observation:"not-observed",quality:"unknown",capacityPolicy:"unknown",terminalHttpPolicy:"unknown",operations:d(S,()=>0),migration:"not-observed"},transport:d(R,()=>({settledAttempts:0,outcomes:d(K,()=>0)}))}}o(J,"emptyReportDeliveryStatus");function l(e,t,r=[]){if(!e||typeof e!="object"||Q(e))throw new Error;let n=H(e);for(let a=0;a<t.length;a++)if(!y(e,t[a]))throw new Error;for(let a=0;a<n.length;a++){let i=n[a];if(!g(t,i)&&!g(r,i))throw new Error}return e}o(l,"record");function g(e,t){for(let r=0;r<e.length;r++)if(e[r]===t)return!0;return!1}o(g,"contains");function c(e,t){if(typeof e!="string"||!g(t,e))throw new Error;return e}o(c,"enumeration");function v(e){if(typeof e!="number"||!U(e)||e<0||e>k)throw new Error;return e}o(v,"counter");function P(e){if(typeof e!="boolean")throw new Error;return e}o(P,"boolean");function q(e,t){let r=l(e,t);return d(t,n=>v(r[n]))}o(q,"counters");function j(e,t){let r=q(e.outcomes,t),n=v(e.settledAttempts),a=0;for(let b=0;b<t.length;b++)a+=r[t[b]];if((a>k?k:a)!==n)throw new Error;let i=y(e,"lastOutcome")?c(e.lastOutcome,t):void 0;if(n>0!=(i!==void 0)||i!==void 0&&r[i]===0)throw new Error;return{settledAttempts:n,outcomes:r,...i===void 0?{}:{lastOutcome:i}}}o(j,"settled");function C(e,t,r){for(let n=0;n<t.length;n++)if(r(e[t[n]])!==0)return!0;return!1}o(C,"nonzero");function M(e){try{if(typeof e!="string"||e.length>16384||I(z,_,[e]))return null;let t=l(V(e),["schemaVersion","status","reason","scope","coverage","revision","capture","queue","transport"]);if(t.schemaVersion!==1||t.scope!=="native-runtime-observations"||t.coverage!=="best-effort")return null;let r=c(t.status,["active","not-started","disabled","unavailable"]),n=c(t.reason,["none","no-start","capture-disabled","snapshot-busy"]);if({active:"none","not-started":"no-start",disabled:"capture-disabled",unavailable:"snapshot-busy"}[r]!==n)return null;let a=l(t.capture,["enabled","paths"]),i=l(a.paths,h),b=d(h,p=>{let f=l(i[p],["supported","settledAttempts","outcomes"],["lastOutcome"]),m={supported:P(f.supported),...j(f,A)};if(!m.supported&&m.settledAttempts!==0)throw new Error;return m}),u=l(t.queue,["scope","observation","quality","capacityPolicy","terminalHttpPolicy","operations","migration"],["pendingCount","lastFailure"]);if(u.scope!=="sdk-report-outbox")return null;let s={scope:"sdk-report-outbox",observation:c(u.observation,["not-observed","observed","failed"]),quality:c(u.quality,["complete","partial","unknown"]),capacityPolicy:c(u.capacityPolicy,["reject-new","evict-oldest"]),terminalHttpPolicy:c(u.terminalHttpPolicy,["retain","attempt-remove"]),operations:q(u.operations,S),migration:c(u.migration,["not-observed","clear","blocked","unknown"]),...y(u,"pendingCount")?{pendingCount:v(u.pendingCount)}:{},...y(u,"lastFailure")?{lastFailure:c(u.lastFailure,T)}:{}};if(s.capacityPolicy==="reject-new"!=(s.terminalHttpPolicy==="retain")||(s.observation!=="observed"||s.quality==="unknown")&&s.pendingCount!==void 0||s.observation!=="observed"&&s.quality!=="unknown"||s.observation==="failed"!=(s.lastFailure!==void 0))return null;let D=l(t.transport,R),E=d(R,p=>{let f=l(D[p],["settledAttempts","outcomes"],["lastOutcome","lastHttpStatus"]),m=j(f,K);if(y(f,"lastHttpStatus")){let x=v(f.lastHttpStatus);if(x<100||x>599||!g(["server-accepted","retryable-http","terminal-http"],m.lastOutcome??""))throw new Error;m.lastHttpStatus=x}return m}),w={schemaVersion:1,status:r,reason:n,scope:"native-runtime-observations",coverage:"best-effort",revision:v(t.revision),capture:{enabled:P(a.enabled),paths:b},queue:s,transport:E};return r!=="active"&&(w.revision!==0||w.capture.enabled||s.observation!=="not-observed"||C(b,h,p=>p.settledAttempts)||C(E,R,p=>p.settledAttempts)||C(s.operations,S,p=>p))?null:w}catch{return null}}o(M,"parseReportDeliveryStatus");function O(){return{attempted:0,accepted:0,duplicateSuppressed:0,allowanceSuppressed:0,bridgeUnavailable:0,nativeRefused:0,captureFailed:0,reentrantSuppressed:0,inactiveAborted:0,legacyAttempted:0}}o(O,"emptyCounters");function N(e,t){return{status:e,reason:t,scope:"mounted-js-admission",limits:{handled:10,automatic:10},counters:{handled:O(),errorUtils:O(),rejection:O()}}}o(N,"emptyErrorCaptureStatus");function F(e,t){e[t]=Math.min(2147483647,e[t]+1)}o(F,"incrementErrorCaptureCounter");function B(){let e=N("active","none").counters;return{begin(t){F(e[t],"attempted");let r=!1;return n=>{r||(r=!0,F(e[t],n))}},snapshot(){return{handled:{...e.handled},errorUtils:{...e.errorUtils},rejection:{...e.rejection}}}}}o(B,"createErrorCaptureLedger");function Y(e,t){return{status:e,reason:t,previousCallbacksPresent:!1,counters:{pending:0,accepted:0,cancelled:0,capacityDropped:0,sizeDropped:0,expired:0,duplicateSuppressed:0,allowanceSuppressed:0,nativeRefused:0,captureFailed:0,discarded:0}}}o(Y,"emptyPromiseRejectionStatus");export{J as a,M as b,N as c,B as d,Y as e};

package/dist/chunk-POE5CSO5.js

@@ -0,0 +1 @@
+import{a as i,c as s,e as u}from"./chunk-ENPQ66EV.js";import{a as t}from"./chunk-XUSV3KOD.js";var n=class extends Error{static{t(this,"EverframeNotMountedError")}name="EverframeNotMountedError";constructor(o){super(o??"EverframeProvider is not mounted; wrap your app root.")}};var r=null,a={};function x(){return a}t(x,"__getContextEpoch");function f(){try{return r?.getPromiseRejectionStatus?.()??u("not-mounted","no-mount")}catch{return u("install-failed","hook-install")}}t(f,"getPromiseRejectionStatus");function E(e){r=e,a={}}t(E,"__setCurrentContext");function g(){return r}t(g,"__getCurrentContext");function R(){let e=r;return e?e.open():Promise.reject(new n("EverframeProvider not mounted; wrap your root with <EverframeProvider>."))}t(R,"open");function S(e){r?.setExtra(e)}t(S,"setExtra");function y(e){r?.addBreadcrumb(e)}t(y,"addBreadcrumb");function C(e,o){o!==void 0?r?.recordScreen(e,o):r?.recordScreen(e)}t(C,"recordScreen");function b(e){r?.setUser(e)}t(b,"setUser");function j(e,o){r?.captureException(e,o)}t(j,"captureException");function w(){try{return r?.getErrorCaptureStatus?.()??s("not-mounted","no-mount")}catch{return s("not-mounted","no-mount")}}t(w,"getErrorCaptureStatus");function P(){let e=r;try{let o=e?.getReportDeliveryStatus?.();return e===r&&o?o:i("not-mounted","no-mount")}catch{return i("unavailable","native-call-failed")}}t(P,"getReportDeliveryStatus");export{n as a,x as b,f as c,E as d,g as e,R as f,S as g,y as h,C as i,b as j,j as k,w as l,P as m};