expo-app-metrics 0.2.0 → 56.0.0

package/android/src/main/java/expo/modules/appmetrics/AppMetadata.kt

@@ -5,7 +5,7 @@ data class AppMetadata(
   val appIdentifier: String,
   val appVersion: String?,
   val appBuildNumber: String?,
-  val appUpdateId: String?,
+  val appUpdatesInfo: AppUpdatesInfo?,
   val appEasBuildId: String?,
   val languageTag: String?,
   val deviceOs: String?,
@@ -14,5 +14,14 @@ data class AppMetadata(
   val deviceName: String?,
   val expoSdkVersion: String,
   val reactNativeVersion: String,
-  val clientVersion: String?,
+  val clientVersion: String?
 )
+
+data class AppUpdatesInfo(
+  val updateId: String?,
+  val runtimeVersion: String?,
+  val requestHeaders: Map<String, String>?
+) {
+  val channel: String?
+    get() = requestHeaders?.get("expo-channel-name")
+}

package/android/src/main/java/expo/modules/appmetrics/AppMetadataProvider.kt

@@ -46,7 +46,7 @@ public object AppMetadataProvider {
       appIdentifier = context.packageName,
       appVersion = packageInfo.versionName,
       appBuildNumber = getAppBuildNumber(packageInfo),
-      appUpdateId = getAppUpdateId(),
+      appUpdatesInfo = getAppUpdatesInfo(),
       appEasBuildId = BuildConfig.EXPO_EAS_BUILD_ID,
       languageTag = Locale.getDefault().getLanguageTag(),
       deviceOs = DEVICE_OS,
@@ -79,14 +79,18 @@ fun getAppBuildNumber(packageInfo: PackageInfo): String =
     packageInfo.versionCode.toString()
   }
 
-fun getAppUpdateId(): String? {
-  val controller = UpdatesControllerRegistry.controller?.get() ?: return null
+fun getAppUpdatesInfo(): AppUpdatesInfo {
+  val controller = UpdatesControllerRegistry.controller?.get()
+    ?: return AppUpdatesInfo(updateId = null, runtimeVersion = null, requestHeaders = null)
   val launchedUpdateId = controller.launchedUpdateId
   val embeddedUpdateId = controller.embeddedUpdateId
-  if (launchedUpdateId == embeddedUpdateId) {
-    return null
-  }
-  return launchedUpdateId?.toString()
+  // Ignore embedded launches – they are not available on the website anyway.
+  val updateId = if (launchedUpdateId == embeddedUpdateId) null else launchedUpdateId?.toString()
+  return AppUpdatesInfo(
+    updateId = updateId,
+    runtimeVersion = controller.runtimeVersion,
+    requestHeaders = controller.requestHeaders
+  )
 }
 
 fun getModelName(): String {

package/android/src/main/java/expo/modules/appmetrics/storage/MetricsDatabase.kt

@@ -26,7 +26,7 @@ object MetricsConstants {
 
 @Database(
   entities = [Metric::class, Session::class],
-  version = 11,
+  version = 13,
   exportSchema = false
 )
 abstract class MetricsDatabase : RoomDatabase() {
@@ -71,6 +71,9 @@ data class Session(
   @Field val appVersion: String? = null,
   @Field val appBuildNumber: String? = null,
   @Field val appUpdateId: String? = null,
+  @Field val appUpdateRuntimeVersion: String? = null,
+  // JSON-encoded Map<String, String> of update request headers
+  @Field val appUpdateRequestHeaders: String? = null,
   @Field val appEasBuildId: String? = null,
   // Device Info
   @Field val deviceOs: String? = null,

package/android/src/main/java/expo/modules/appmetrics/storage/SessionManager.kt

@@ -8,6 +8,9 @@ import expo.modules.appmetrics.AppMetricsPreferences
 import expo.modules.appmetrics.SQLITE_MAX_BIND_VARIABLES
 import expo.modules.appmetrics.TAG
 import expo.modules.appmetrics.utils.TimeUtils
+import kotlinx.serialization.builtins.MapSerializer
+import kotlinx.serialization.builtins.serializer
+import kotlinx.serialization.json.Json
 import java.util.UUID
 import java.util.concurrent.CopyOnWriteArrayList
 
@@ -50,7 +53,11 @@ class SessionManager(
       appIdentifier = metadata?.appIdentifier,
       appVersion = metadata?.appVersion,
       appBuildNumber = metadata?.appBuildNumber,
-      appUpdateId = metadata?.appUpdateId,
+      appUpdateId = metadata?.appUpdatesInfo?.updateId,
+      appUpdateRuntimeVersion = metadata?.appUpdatesInfo?.runtimeVersion,
+      appUpdateRequestHeaders = metadata?.appUpdatesInfo?.requestHeaders?.let {
+        Json.encodeToString(MapSerializer(String.serializer(), String.serializer()), it)
+      },
       appEasBuildId = metadata?.appEasBuildId,
       deviceOs = metadata?.deviceOs,
       deviceOsVersion = metadata?.deviceOsVersion,

package/android/src/main/java/expo/modules/appmetrics/updates/UpdatesMonitoring.kt

@@ -1,6 +1,7 @@
 package expo.modules.appmetrics.updates
 
 import android.util.Log
+import expo.modules.appmetrics.AppUpdatesInfo
 import expo.modules.appmetrics.MetricCategory
 import expo.modules.appmetrics.TAG
 import expo.modules.appmetrics.storage.Metric
@@ -18,28 +19,33 @@ class UpdatesMonitoring(
 ) {
 
   /**
-   * Returns the launched OTA update ID, or null if the app was launched from the embedded bundle.
+   * Returns the current updates info (update ID, runtime version, request headers) for the
+   * launched app, or an empty info object when updates is not available.
    */
-  fun getLaunchedUpdateId(): String? {
-    val controller = UpdatesControllerRegistry.controller?.get() ?: return null
-    val launchedUpdateId = controller.launchedUpdateId ?: return null
-    val embeddedUpdateId = controller.embeddedUpdateId ?: return null
-
-    // Ignore embedded launches
-    if (launchedUpdateId == embeddedUpdateId) {
-      return null
-    }
-    return launchedUpdateId.toString().lowercase()
+  fun getUpdatesMetricsInfo(): AppUpdatesInfo {
+    val controller = UpdatesControllerRegistry.controller?.get()
+      ?: return AppUpdatesInfo(updateId = null, runtimeVersion = null, requestHeaders = null)
+    val launchedUpdateId = controller.launchedUpdateId
+    val embeddedUpdateId = controller.embeddedUpdateId
+    // Ignore embedded launches – they are not available on the website anyway.
+    val updateId = if (launchedUpdateId == embeddedUpdateId) null else launchedUpdateId?.toString()?.lowercase()
+    return AppUpdatesInfo(
+      updateId = updateId,
+      runtimeVersion = controller.runtimeVersion,
+      requestHeaders = controller.requestHeaders
+    )
   }
 
   /**
-   * Patches the app metadata with the OTA update ID if applicable.
+   * Patches the app metadata with the OTA updates info if applicable.
    */
   fun patchAppInfoIfNeeded(currentMetadata: expo.modules.appmetrics.AppMetadata?): expo.modules.appmetrics.AppMetadata? {
-    val updateId = getLaunchedUpdateId() ?: return currentMetadata
-    if (currentMetadata == null || currentMetadata.appUpdateId != null) return currentMetadata
-    Log.d(TAG, "OTA update ID found, patching AppMetadata")
-    return currentMetadata.copy(appUpdateId = updateId)
+    if (currentMetadata == null) return currentMetadata
+    val updatesInfo = getUpdatesMetricsInfo()
+    if (updatesInfo.updateId == null && updatesInfo.runtimeVersion == null) return currentMetadata
+    if (currentMetadata.appUpdatesInfo?.updateId != null) return currentMetadata
+    Log.d(TAG, "OTA update info found, patching AppMetadata")
+    return currentMetadata.copy(appUpdatesInfo = updatesInfo)
   }
 
   /**

package/android/src/main/java/expo/modules/appmetrics/updates/UpdatesStateEvent.kt

@@ -18,7 +18,7 @@ data class UpdatesStateEvent(
     DownloadCompleteWithRollback("downloadCompleteWithRollback"),
     DownloadError("downloadError"),
     DownloadProgress("downloadProgress"),
-    Restart("restart");
+    Restart("restart")
   }
 
   companion object {

package/build/AppMetricsRoot.d.ts

@@ -6,7 +6,7 @@ import React from 'react';
  */
 export declare function AppMetricsRoot({ children }: {
     children: React.ReactNode;
-}): React.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 export declare namespace AppMetricsRoot {
     var wrap: <P extends Record<string, unknown>>(Component: React.ComponentType<P>) => React.ComponentType<P>;
 }

package/build/AppMetricsRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppMetricsRoot.d.ts","sourceRoot":"","sources":["../src/AppMetricsRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAIzC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAMzE;yBANe,cAAc;eAYM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACxD,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAChC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC"}
+{"version":3,"file":"AppMetricsRoot.d.ts","sourceRoot":"","sources":["../src/AppMetricsRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAIzC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAMzE;yBANe,cAAc;eAYM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACxD,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAChC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC"}

package/build/AppMetricsRoot.js

@@ -1,3 +1,4 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import React, { useEffect } from 'react';
 import AppMetrics from './module';
 /**
@@ -9,16 +10,14 @@ export function AppMetricsRoot({ children }) {
     useEffect(() => {
         AppMetrics.markFirstRender();
     }, []);
-    return <>{children}</>;
+    return _jsx(_Fragment, { children: children });
 }
 /**
  * Wraps a component with `AppMetricsRoot`.
  * Usage: `AppMetricsRoot.wrap(App);`
  */
 AppMetricsRoot.wrap = function wrap(Component) {
-    const Wrapped = (props) => (<AppMetricsRoot>
-      <Component {...props}/>
-    </AppMetricsRoot>);
+    const Wrapped = (props) => (_jsx(AppMetricsRoot, { children: _jsx(Component, { ...props }) }));
     Wrapped.displayName = `AppMetricsRoot(${Component.displayName || Component.name || 'Component'})`;
     return Wrapped;
 };

package/build/AppMetricsRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppMetricsRoot.js","sourceRoot":"","sources":["../src/AppMetricsRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,UAAU,MAAM,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAiC;IACxE,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,eAAe,EAAE,CAAC;IAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,cAAc,CAAC,IAAI,GAAG,SAAS,IAAI,CACjC,SAAiC;IAEjC,MAAM,OAAO,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,CAC5B,CAAC,cAAc,CACb;MAAA,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EACvB;IAAA,EAAE,cAAc,CAAC,CAClB,CAAC;IACF,OAAO,CAAC,WAAW,GAAG,kBAAkB,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAClG,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import React, { useEffect } from 'react';\n\nimport AppMetrics from './module';\n\n/**\n * A root component that automatically marks the first render.\n * Wrap your app's root component with this to measure time to first render\n * without manually calling `AppMetrics.markFirstRender()`.\n */\nexport function AppMetricsRoot({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    AppMetrics.markFirstRender();\n  }, []);\n\n  return <>{children}</>;\n}\n\n/**\n * Wraps a component with `AppMetricsRoot`.\n * Usage: `AppMetricsRoot.wrap(App);`\n */\nAppMetricsRoot.wrap = function wrap<P extends Record<string, unknown>>(\n  Component: React.ComponentType<P>\n): React.ComponentType<P> {\n  const Wrapped = (props: P) => (\n    <AppMetricsRoot>\n      <Component {...props} />\n    </AppMetricsRoot>\n  );\n  Wrapped.displayName = `AppMetricsRoot(${Component.displayName || Component.name || 'Component'})`;\n  return Wrapped;\n};\n"]}
+{"version":3,"file":"AppMetricsRoot.js","sourceRoot":"","sources":["../src/AppMetricsRoot.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,UAAU,MAAM,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAiC;IACxE,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,eAAe,EAAE,CAAC;IAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,cAAc,CAAC,IAAI,GAAG,SAAS,IAAI,CACjC,SAAiC;IAEjC,MAAM,OAAO,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,CAC5B,KAAC,cAAc,cACb,KAAC,SAAS,OAAK,KAAK,GAAI,GACT,CAClB,CAAC;IACF,OAAO,CAAC,WAAW,GAAG,kBAAkB,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAClG,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import React, { useEffect } from 'react';\n\nimport AppMetrics from './module';\n\n/**\n * A root component that automatically marks the first render.\n * Wrap your app's root component with this to measure time to first render\n * without manually calling `AppMetrics.markFirstRender()`.\n */\nexport function AppMetricsRoot({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    AppMetrics.markFirstRender();\n  }, []);\n\n  return <>{children}</>;\n}\n\n/**\n * Wraps a component with `AppMetricsRoot`.\n * Usage: `AppMetricsRoot.wrap(App);`\n */\nAppMetricsRoot.wrap = function wrap<P extends Record<string, unknown>>(\n  Component: React.ComponentType<P>\n): React.ComponentType<P> {\n  const Wrapped = (props: P) => (\n    <AppMetricsRoot>\n      <Component {...props} />\n    </AppMetricsRoot>\n  );\n  Wrapped.displayName = `AppMetricsRoot(${Component.displayName || Component.name || 'Component'})`;\n  return Wrapped;\n};\n"]}

package/build/module.d.ts

@@ -2,8 +2,12 @@ import type { MetricAttributes } from './types';
 declare const _default: {
     markInteractive(attributes?: MetricAttributes): void;
     markFirstRender(): void;
+    logEvent(name: string, options?: import("./types").LogEventOptions): void;
     getStoredEntries(): Promise<import("./types").Metric[]>;
     clearStoredEntries(): Promise<void>;
+    getAllSessions(): Promise<import("./types").Session[]>;
+    simulateCrashReport(): void;
+    triggerCrash(kind: import("./types").CrashKind): void;
     startSession(): string;
     stopSession(sessionId: string): void;
     addCustomMetricToSession(sessionId: string, metric: {

package/build/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4B,gBAAgB,EAAE,MAAM,SAAS,CAAC;;iCAQ3C,gBAAgB;;;;;;;;;;iBAU6qG,CAAC;cAAsB,CAAC;;;AAZpvG,wBAWE"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4B,gBAAgB,EAAE,MAAM,SAAS,CAAC;;iCAQ3C,gBAAgB;;;;;;;;;;;;;;iBAUujR,CAAC;cAAsB,CAAC;;;AAZ9nR,wBAWE"}

package/build/module.web.d.ts

@@ -1,5 +1,5 @@
 import { NativeModule } from 'expo';
-import type { ExpoAppMetricsModuleType, MetricAttributes } from './types';
+import type { ExpoAppMetricsModuleType, LogEventOptions, MetricAttributes } from './types';
 export * from './types';
 declare class ExpoAppMetricsModule extends NativeModule implements ExpoAppMetricsModuleType {
     addCustomMetricToSession(sessionId: string, metric: {
@@ -8,9 +8,13 @@ declare class ExpoAppMetricsModule extends NativeModule implements ExpoAppMetric
         value: number;
     }): Promise<void>;
     markFirstRender(): Promise<void>;
-    markInteractive(_attributes?: MetricAttributes): Promise<void>;
+    markInteractive(attributes?: MetricAttributes): Promise<void>;
+    logEvent(name: string, options?: LogEventOptions): void;
     getStoredEntries(): Promise<never[]>;
     clearStoredEntries(): Promise<void>;
+    getAllSessions(): Promise<never[]>;
+    simulateCrashReport(): void;
+    triggerCrash(): void;
     startSession(metadata?: string): string;
     stopSession(sessionId: string): void;
 }

package/build/module.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.web.d.ts","sourceRoot":"","sources":["../src/module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,MAAM,CAAC;AAEvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1E,cAAc,SAAS,CAAC;AAExB,cAAM,oBAAqB,SAAQ,YAAa,YAAW,wBAAwB;IACjF,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,IAAI,CAAC;IAGV,eAAe;IACf,eAAe,CAAC,WAAW,CAAC,EAAE,gBAAgB;IAC9C,gBAAgB;IAGhB,kBAAkB;IACxB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM;IAG9B,WAAW,CAAC,SAAS,EAAE,MAAM;CAC9B;;AAED,wBAAyE"}
+{"version":3,"file":"module.web.d.ts","sourceRoot":"","sources":["../src/module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,MAAM,CAAC;AAEvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3F,cAAc,SAAS,CAAC;AAExB,cAAM,oBAAqB,SAAQ,YAAa,YAAW,wBAAwB;IACjF,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,IAAI,CAAC;IAGV,eAAe;IACf,eAAe,CAAC,UAAU,CAAC,EAAE,gBAAgB;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAC1C,gBAAgB;IAGhB,kBAAkB;IAClB,cAAc;IAGpB,mBAAmB;IACnB,YAAY;IACZ,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM;IAG9B,WAAW,CAAC,SAAS,EAAE,MAAM;CAC9B;;AAED,wBAAyE"}

package/build/module.web.js

@@ -5,11 +5,17 @@ class ExpoAppMetricsModule extends NativeModule {
         throw new Error('Method not implemented.');
     }
     async markFirstRender() { }
-    async markInteractive(_attributes) { }
+    async markInteractive(attributes) { }
+    logEvent(name, options) { }
     async getStoredEntries() {
         return [];
     }
     async clearStoredEntries() { }
+    async getAllSessions() {
+        return [];
+    }
+    simulateCrashReport() { }
+    triggerCrash() { }
     startSession(metadata) {
         return '';
     }

package/build/module.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.web.js","sourceRoot":"","sources":["../src/module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAIvD,cAAc,SAAS,CAAC;AAExB,MAAM,oBAAqB,SAAQ,YAAY;IAC7C,wBAAwB,CACtB,SAAiB,EACjB,MAAyD;QAEzD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,eAAe,KAAI,CAAC;IAC1B,KAAK,CAAC,eAAe,CAAC,WAA8B,IAAG,CAAC;IACxD,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,kBAAkB,KAAI,CAAC;IAC7B,YAAY,CAAC,QAAiB;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,WAAW,CAAC,SAAiB,IAAG,CAAC;CAClC;AAED,eAAe,iBAAiB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC","sourcesContent":["import { NativeModule, registerWebModule } from 'expo';\n\nimport type { ExpoAppMetricsModuleType, MetricAttributes } from './types';\n\nexport * from './types';\n\nclass ExpoAppMetricsModule extends NativeModule implements ExpoAppMetricsModuleType {\n  addCustomMetricToSession(\n    sessionId: string,\n    metric: { category: string; name: string; value: number }\n  ): Promise<void> {\n    throw new Error('Method not implemented.');\n  }\n  async markFirstRender() {}\n  async markInteractive(_attributes?: MetricAttributes) {}\n  async getStoredEntries() {\n    return [];\n  }\n  async clearStoredEntries() {}\n  startSession(metadata?: string) {\n    return '';\n  }\n  stopSession(sessionId: string) {}\n}\n\nexport default registerWebModule(ExpoAppMetricsModule, 'ExpoAppMetrics');\n"]}
+{"version":3,"file":"module.web.js","sourceRoot":"","sources":["../src/module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAIvD,cAAc,SAAS,CAAC;AAExB,MAAM,oBAAqB,SAAQ,YAAY;IAC7C,wBAAwB,CACtB,SAAiB,EACjB,MAAyD;QAEzD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,eAAe,KAAI,CAAC;IAC1B,KAAK,CAAC,eAAe,CAAC,UAA6B,IAAG,CAAC;IACvD,QAAQ,CAAC,IAAY,EAAE,OAAyB,IAAG,CAAC;IACpD,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,kBAAkB,KAAI,CAAC;IAC7B,KAAK,CAAC,cAAc;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,mBAAmB,KAAI,CAAC;IACxB,YAAY,KAAI,CAAC;IACjB,YAAY,CAAC,QAAiB;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,WAAW,CAAC,SAAiB,IAAG,CAAC;CAClC;AAED,eAAe,iBAAiB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC","sourcesContent":["import { NativeModule, registerWebModule } from 'expo';\n\nimport type { ExpoAppMetricsModuleType, LogEventOptions, MetricAttributes } from './types';\n\nexport * from './types';\n\nclass ExpoAppMetricsModule extends NativeModule implements ExpoAppMetricsModuleType {\n  addCustomMetricToSession(\n    sessionId: string,\n    metric: { category: string; name: string; value: number }\n  ): Promise<void> {\n    throw new Error('Method not implemented.');\n  }\n  async markFirstRender() {}\n  async markInteractive(attributes?: MetricAttributes) {}\n  logEvent(name: string, options?: LogEventOptions) {}\n  async getStoredEntries() {\n    return [];\n  }\n  async clearStoredEntries() {}\n  async getAllSessions() {\n    return [];\n  }\n  simulateCrashReport() {}\n  triggerCrash() {}\n  startSession(metadata?: string) {\n    return '';\n  }\n  stopSession(sessionId: string) {}\n}\n\nexport default registerWebModule(ExpoAppMetricsModule, 'ExpoAppMetrics');\n"]}

package/build/types.d.ts

@@ -107,11 +107,176 @@ export type MetricAttributes = {
      */
     params?: Record<string, unknown>;
 };
+/**
+ * Severity of a log event, ordered from least to most severe:
+ *
+ * - `"trace"` — Fine-grained tracing, typically only useful while reproducing
+ *   a specific issue.
+ * - `"debug"` — Diagnostic detail useful during development; usually filtered
+ *   out in production.
+ * - `"info"` — Routine, expected events that record normal app behavior.
+ * - `"warn"` — Unexpected but recoverable conditions worth investigating.
+ * - `"error"` — An operation failed; the app continues running but is in a
+ *   degraded state.
+ * - `"fatal"` — A severe failure, often immediately followed by app termination.
+ */
+export type LogSeverity = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Value types accepted in a log event's `attributes` map. Strings, numbers,
+ * and booleans are stored as typed primitives; arrays and nested maps preserve
+ * their structure. Other JS values (functions, `Date`, `undefined`, etc.) are
+ * not supported and may be dropped by downstream consumers.
+ */
+export type LogAttributeValue = string | number | boolean | LogAttributeValue[] | {
+    [key: string]: LogAttributeValue;
+};
+/**
+ * A single log event collected during a session.
+ */
+export type LogRecord = {
+    /**
+     * ISO 8601 timestamp of when the record was created.
+     */
+    timestamp: string;
+    /**
+     * Event name.
+     */
+    name: string;
+    /**
+     * Optional free-form message describing the event.
+     */
+    body?: string | null;
+    /**
+     * Custom attributes attached to the event. Each entry is preserved with its
+     * original value type — see `LogAttributeValue` for the supported shapes.
+     */
+    attributes?: Record<string, LogAttributeValue> | null;
+    /**
+     * Severity of the event.
+     */
+    severity: LogSeverity;
+};
+/**
+ * Optional configuration accepted by `logEvent`. The event name is passed as
+ * the first positional argument since it's required and the only field most
+ * callers set.
+ */
+export type LogEventOptions = {
+    /**
+     * Optional free-form message describing the event.
+     */
+    body?: string | null;
+    /**
+     * Custom attributes attached to the event. Each entry is preserved with its
+     * original value type — see `LogAttributeValue` for the supported shapes.
+     */
+    attributes?: Record<string, LogAttributeValue> | null;
+    /**
+     * Severity of the event.
+     *
+     * @default "info"
+     */
+    severity?: LogSeverity | null;
+};
+export type SessionType = 'main' | 'foreground' | 'screen' | 'custom' | 'unknown';
+export type CrashKind = 'badAccess' | 'fatalError' | 'divideByZero' | 'forceUnwrapNil' | 'arrayOutOfBounds' | 'objcException' | 'stackOverflow';
+type SessionBase = {
+    id: string;
+    startDate: string;
+    endDate?: string | null;
+    metrics: Metric[];
+    logs: LogRecord[];
+};
+export type MainSession = SessionBase & {
+    type: 'main';
+    crashReport?: CrashReport | null;
+};
+export type GenericSession = SessionBase & {
+    type: Exclude<SessionType, 'main'>;
+};
+export type Session = MainSession | GenericSession;
+export type CallStackFrame = {
+    binaryName?: string | null;
+    binaryUUID?: string | null;
+    address?: number | null;
+    offsetIntoBinaryTextSegment?: number | null;
+    sampleCount?: number | null;
+    subFrames?: CallStackFrame[] | null;
+    /**
+     * Resolved symbol from on-device `dladdr` symbolication. Swift and Itanium-ABI C++
+     * names are demangled; Objective-C selectors and plain C symbols are returned as-is.
+     * `null` when the binary is not loaded in this process or `dladdr` could not resolve it.
+     *
+     * @platform ios
+     */
+    symbol?: string | null;
+};
+export type CallStack = {
+    threadAttributed?: boolean | null;
+    callStackRootFrames?: CallStackFrame[] | null;
+};
+export type CallStackTree = {
+    callStacks?: CallStack[] | null;
+};
+export type CrashReport = {
+    exceptionType?: number | null;
+    exceptionCode?: number | null;
+    signal?: number | null;
+    terminationReason?: string | null;
+    virtualMemoryRegionInfo?: string | null;
+    exceptionReason?: {
+        composedMessage: string;
+        formatString: string;
+        arguments: string[];
+        exceptionType: string;
+        className: string;
+        exceptionName: string;
+    } | null;
+    callStackTree?: CallStackTree | null;
+    timestampBegin: string;
+    timestampEnd: string;
+    ingestedAt: string;
+};
 export interface ExpoAppMetricsModuleType {
     markFirstRender(): void;
     markInteractive(attributes?: MetricAttributes): void;
+    /**
+     * Records a log event against the current main session. The event is
+     * persisted locally and dispatched on the next `dispatchEvents()` flush as an
+     * OpenTelemetry log record sent to the `/v1/logs` endpoint.
+     *
+     * Severity defaults to `"info"` when not provided.
+     *
+     * @param name Event name. Maps to the OpenTelemetry `event.name` attribute.
+     * @param options Optional body, attributes, and severity overrides.
+     */
+    logEvent(name: string, options?: LogEventOptions): void;
     getStoredEntries(): Promise<Metric[]>;
     clearStoredEntries(): Promise<void>;
+    /**
+     * Returns all sessions across the current and historical entries,
+     * ordered with the current launch first.
+     *
+     * @private This API is unstable and may change without notice.
+     * @platform ios
+     */
+    getAllSessions(): Promise<Session[]>;
+    /**
+     * Simulates a crash report, attributing it to the current main session.
+     * Intended for development and debugging only.
+     *
+     * @private This API is unstable and may change without notice.
+     * @platform ios
+     */
+    simulateCrashReport(): void;
+    /**
+     * Intentionally crashes the app to produce a real MetricKit diagnostic.
+     * Intended for development and debugging only.
+     *
+     * @private This API is unstable and may change without notice.
+     * @platform ios
+     */
+    triggerCrash(kind: CrashKind): void;
     /**
      * Starts a new app metrics session. Returns the session ID.
      *
@@ -135,4 +300,5 @@ export interface ExpoAppMetricsModuleType {
         params?: Record<string, unknown>;
     }): Promise<void>;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,eAAe,IAAI,IAAI,CAAC;IACxB,eAAe,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrD,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,YAAY,IAAI,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;OAEG;IACH,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type AppStartupTimes = {\n  /**\n   * Time from when the user taps the app to the moment the app starts executing the main code.\n   * It includes loading native dynamic libraries, executing C++ static constructors\n   * and Objective-C `+load` methods defined in classes or categories.\n   *\n   * @platform iOS\n   */\n  loadTime?: number;\n  /**\n   * Full time from process start until the root view of the React Native instance is created,\n   * recorded when the app is launched fresh by the user.\n   */\n  coldLaunchTime?: number;\n  /**\n   * Launch time recorded when the process was already running in the background\n   * before the user launches the app.\n   */\n  warmLaunchTime?: number;\n  /**\n   * Duration to evaluate the JavaScript bundle by the runtime.\n   */\n  bundleLoadTime?: number;\n  /**\n   * Time until the first React render occurs.\n   */\n  timeToFirstRender?: number;\n  /**\n   * Time until the app is interactive (after first render).\n   */\n  timeToInteractive?: number;\n};\n\nexport type MemoryUsageSnapshot = {\n  /**\n   * Memory in bytes allocated by the app, including both the physical memory and additional memory that the app might be using,\n   * such as memory that has been paged out (swapped) to disk or memory that is shared with other processes.\n   *\n   * @platform iOS\n   */\n  allocated?: number;\n  /**\n   * Physical memory in bytes pages currently in use (resident size).\n   */\n  physical: number;\n  /**\n   * The amount of available memory in bytes that app can still allocate.\n   */\n  available: number;\n  /**\n   * The amount of memory in bytes currently used by the Java heap.\n   *\n   * @platform android\n   */\n  javaHeap?: number;\n};\n\nexport type FrameRateMetrics = {\n  /**\n   * Total amount of frames rendered.\n   */\n  renderedFrames: number;\n  /**\n   * Expected amount of frames rendered if everything renders without any delay.\n   */\n  expectedFrames: number;\n  /**\n   * Number of frames which were skipped because the main thread was busy with some work.\n   */\n  droppedFrames: number;\n  /**\n   * Total amount of frozen frames. Frozen frame is frame that takes at least 700ms to render.\n   * It is a term from [Android development](https://developer.android.com/topic/performance/vitals/frozen).\n   */\n  frozenFrames: number;\n  /**\n   * Total amount of slow frames. Slow frame is frame that takes at least 17ms to render.\n   * It is a term from [Android development](https://developer.android.com/topic/performance/vitals/render).\n   */\n  slowFrames: number;\n  /**\n   * Total amount of freeze durations, in seconds. Freeze is an amount of time every frame rendering was delayed by in comparison with the ideal performant frame.\n   * For example if expected frame duration was 16ms, but in reality we've rendered this frame in 320ms, we have a freeze with 304ms duration.\n   */\n  freezeTime: number;\n  /**\n   * Total duration of the screen session, in seconds. It is counted by summing up all rendered frames duration.\n   */\n  sessionDuration: number;\n};\n\nexport interface Metric {\n  timestamp: string;\n  category: string;\n  name: string;\n  value: number;\n  sessionId: string;\n  routeName?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type MetricAttributes = {\n  /**\n   * Name of the route associated with the metric. Some metrics populate this\n   * with a sensible default when omitted — for example, the TTI metric falls\n   * back to the initial route name detected from the router.\n   */\n  routeName?: string;\n  /**\n   * Custom parameters to attach to the metric.\n   */\n  params?: Record<string, unknown>;\n};\n\nexport interface ExpoAppMetricsModuleType {\n  markFirstRender(): void;\n  markInteractive(attributes?: MetricAttributes): void;\n  getStoredEntries(): Promise<Metric[]>;\n  clearStoredEntries(): Promise<void>;\n\n  /**\n   * Starts a new app metrics session. Returns the session ID.\n   *\n   * @platform android\n   */\n  startSession(): string;\n  /**\n   * Stops the app metrics session with the given session ID.\n   *\n   * @platform android\n   */\n  stopSession(sessionId: string): void;\n  /**\n   * @platform android\n   */\n  addCustomMetricToSession(\n    sessionId: string,\n    metric: {\n      category: string;\n      name: string;\n      value: number;\n      routeName?: string;\n      params?: Record<string, unknown>;\n    }\n  ): Promise<void>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type AppStartupTimes = {\n  /**\n   * Time from when the user taps the app to the moment the app starts executing the main code.\n   * It includes loading native dynamic libraries, executing C++ static constructors\n   * and Objective-C `+load` methods defined in classes or categories.\n   *\n   * @platform iOS\n   */\n  loadTime?: number;\n  /**\n   * Full time from process start until the root view of the React Native instance is created,\n   * recorded when the app is launched fresh by the user.\n   */\n  coldLaunchTime?: number;\n  /**\n   * Launch time recorded when the process was already running in the background\n   * before the user launches the app.\n   */\n  warmLaunchTime?: number;\n  /**\n   * Duration to evaluate the JavaScript bundle by the runtime.\n   */\n  bundleLoadTime?: number;\n  /**\n   * Time until the first React render occurs.\n   */\n  timeToFirstRender?: number;\n  /**\n   * Time until the app is interactive (after first render).\n   */\n  timeToInteractive?: number;\n};\n\nexport type MemoryUsageSnapshot = {\n  /**\n   * Memory in bytes allocated by the app, including both the physical memory and additional memory that the app might be using,\n   * such as memory that has been paged out (swapped) to disk or memory that is shared with other processes.\n   *\n   * @platform iOS\n   */\n  allocated?: number;\n  /**\n   * Physical memory in bytes pages currently in use (resident size).\n   */\n  physical: number;\n  /**\n   * The amount of available memory in bytes that app can still allocate.\n   */\n  available: number;\n  /**\n   * The amount of memory in bytes currently used by the Java heap.\n   *\n   * @platform android\n   */\n  javaHeap?: number;\n};\n\nexport type FrameRateMetrics = {\n  /**\n   * Total amount of frames rendered.\n   */\n  renderedFrames: number;\n  /**\n   * Expected amount of frames rendered if everything renders without any delay.\n   */\n  expectedFrames: number;\n  /**\n   * Number of frames which were skipped because the main thread was busy with some work.\n   */\n  droppedFrames: number;\n  /**\n   * Total amount of frozen frames. Frozen frame is frame that takes at least 700ms to render.\n   * It is a term from [Android development](https://developer.android.com/topic/performance/vitals/frozen).\n   */\n  frozenFrames: number;\n  /**\n   * Total amount of slow frames. Slow frame is frame that takes at least 17ms to render.\n   * It is a term from [Android development](https://developer.android.com/topic/performance/vitals/render).\n   */\n  slowFrames: number;\n  /**\n   * Total amount of freeze durations, in seconds. Freeze is an amount of time every frame rendering was delayed by in comparison with the ideal performant frame.\n   * For example if expected frame duration was 16ms, but in reality we've rendered this frame in 320ms, we have a freeze with 304ms duration.\n   */\n  freezeTime: number;\n  /**\n   * Total duration of the screen session, in seconds. It is counted by summing up all rendered frames duration.\n   */\n  sessionDuration: number;\n};\n\nexport interface Metric {\n  timestamp: string;\n  category: string;\n  name: string;\n  value: number;\n  sessionId: string;\n  routeName?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type MetricAttributes = {\n  /**\n   * Name of the route associated with the metric. Some metrics populate this\n   * with a sensible default when omitted — for example, the TTI metric falls\n   * back to the initial route name detected from the router.\n   */\n  routeName?: string;\n  /**\n   * Custom parameters to attach to the metric.\n   */\n  params?: Record<string, unknown>;\n};\n\n/**\n * Severity of a log event, ordered from least to most severe:\n *\n * - `\"trace\"` — Fine-grained tracing, typically only useful while reproducing\n *   a specific issue.\n * - `\"debug\"` — Diagnostic detail useful during development; usually filtered\n *   out in production.\n * - `\"info\"` — Routine, expected events that record normal app behavior.\n * - `\"warn\"` — Unexpected but recoverable conditions worth investigating.\n * - `\"error\"` — An operation failed; the app continues running but is in a\n *   degraded state.\n * - `\"fatal\"` — A severe failure, often immediately followed by app termination.\n */\nexport type LogSeverity = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';\n\n/**\n * Value types accepted in a log event's `attributes` map. Strings, numbers,\n * and booleans are stored as typed primitives; arrays and nested maps preserve\n * their structure. Other JS values (functions, `Date`, `undefined`, etc.) are\n * not supported and may be dropped by downstream consumers.\n */\nexport type LogAttributeValue =\n  | string\n  | number\n  | boolean\n  | LogAttributeValue[]\n  | { [key: string]: LogAttributeValue };\n\n/**\n * A single log event collected during a session.\n */\nexport type LogRecord = {\n  /**\n   * ISO 8601 timestamp of when the record was created.\n   */\n  timestamp: string;\n  /**\n   * Event name.\n   */\n  name: string;\n  /**\n   * Optional free-form message describing the event.\n   */\n  body?: string | null;\n  /**\n   * Custom attributes attached to the event. Each entry is preserved with its\n   * original value type — see `LogAttributeValue` for the supported shapes.\n   */\n  attributes?: Record<string, LogAttributeValue> | null;\n  /**\n   * Severity of the event.\n   */\n  severity: LogSeverity;\n};\n\n/**\n * Optional configuration accepted by `logEvent`. The event name is passed as\n * the first positional argument since it's required and the only field most\n * callers set.\n */\nexport type LogEventOptions = {\n  /**\n   * Optional free-form message describing the event.\n   */\n  body?: string | null;\n  /**\n   * Custom attributes attached to the event. Each entry is preserved with its\n   * original value type — see `LogAttributeValue` for the supported shapes.\n   */\n  attributes?: Record<string, LogAttributeValue> | null;\n  /**\n   * Severity of the event.\n   *\n   * @default \"info\"\n   */\n  severity?: LogSeverity | null;\n};\n\nexport type SessionType = 'main' | 'foreground' | 'screen' | 'custom' | 'unknown';\n\nexport type CrashKind =\n  | 'badAccess'\n  | 'fatalError'\n  | 'divideByZero'\n  | 'forceUnwrapNil'\n  | 'arrayOutOfBounds'\n  | 'objcException'\n  | 'stackOverflow';\n\ntype SessionBase = {\n  id: string;\n  startDate: string;\n  endDate?: string | null;\n  metrics: Metric[];\n  logs: LogRecord[];\n};\n\nexport type MainSession = SessionBase & {\n  type: 'main';\n  crashReport?: CrashReport | null;\n};\n\nexport type GenericSession = SessionBase & {\n  type: Exclude<SessionType, 'main'>;\n};\n\nexport type Session = MainSession | GenericSession;\n\nexport type CallStackFrame = {\n  binaryName?: string | null;\n  binaryUUID?: string | null;\n  address?: number | null;\n  offsetIntoBinaryTextSegment?: number | null;\n  sampleCount?: number | null;\n  subFrames?: CallStackFrame[] | null;\n  /**\n   * Resolved symbol from on-device `dladdr` symbolication. Swift and Itanium-ABI C++\n   * names are demangled; Objective-C selectors and plain C symbols are returned as-is.\n   * `null` when the binary is not loaded in this process or `dladdr` could not resolve it.\n   *\n   * @platform ios\n   */\n  symbol?: string | null;\n};\n\nexport type CallStack = {\n  threadAttributed?: boolean | null;\n  callStackRootFrames?: CallStackFrame[] | null;\n};\n\nexport type CallStackTree = {\n  callStacks?: CallStack[] | null;\n};\n\nexport type CrashReport = {\n  exceptionType?: number | null;\n  exceptionCode?: number | null;\n  signal?: number | null;\n  terminationReason?: string | null;\n  virtualMemoryRegionInfo?: string | null;\n  exceptionReason?: {\n    composedMessage: string;\n    formatString: string;\n    arguments: string[];\n    exceptionType: string;\n    className: string;\n    exceptionName: string;\n  } | null;\n  callStackTree?: CallStackTree | null;\n  timestampBegin: string;\n  timestampEnd: string;\n  ingestedAt: string;\n};\n\nexport interface ExpoAppMetricsModuleType {\n  markFirstRender(): void;\n  markInteractive(attributes?: MetricAttributes): void;\n  /**\n   * Records a log event against the current main session. The event is\n   * persisted locally and dispatched on the next `dispatchEvents()` flush as an\n   * OpenTelemetry log record sent to the `/v1/logs` endpoint.\n   *\n   * Severity defaults to `\"info\"` when not provided.\n   *\n   * @param name Event name. Maps to the OpenTelemetry `event.name` attribute.\n   * @param options Optional body, attributes, and severity overrides.\n   */\n  logEvent(name: string, options?: LogEventOptions): void;\n  getStoredEntries(): Promise<Metric[]>;\n  clearStoredEntries(): Promise<void>;\n  /**\n   * Returns all sessions across the current and historical entries,\n   * ordered with the current launch first.\n   *\n   * @private This API is unstable and may change without notice.\n   * @platform ios\n   */\n  getAllSessions(): Promise<Session[]>;\n\n  /**\n   * Simulates a crash report, attributing it to the current main session.\n   * Intended for development and debugging only.\n   *\n   * @private This API is unstable and may change without notice.\n   * @platform ios\n   */\n  simulateCrashReport(): void;\n\n  /**\n   * Intentionally crashes the app to produce a real MetricKit diagnostic.\n   * Intended for development and debugging only.\n   *\n   * @private This API is unstable and may change without notice.\n   * @platform ios\n   */\n  triggerCrash(kind: CrashKind): void;\n\n  /**\n   * Starts a new app metrics session. Returns the session ID.\n   *\n   * @platform android\n   */\n  startSession(): string;\n  /**\n   * Stops the app metrics session with the given session ID.\n   *\n   * @platform android\n   */\n  stopSession(sessionId: string): void;\n  /**\n   * @platform android\n   */\n  addCustomMetricToSession(\n    sessionId: string,\n    metric: {\n      category: string;\n      name: string;\n      value: number;\n      routeName?: string;\n      params?: Record<string, unknown>;\n    }\n  ): Promise<void>;\n}\n"]}

package/expo-module.config.json

@@ -9,7 +9,7 @@
     "publication": {
       "groupId": "expo.modules.appmetrics",
       "artifactId": "expo.modules.appmetrics",
-      "version": "0.2.0",
+      "version": "56.0.0",
       "repository": "local-maven-repo"
     }
   }

package/ios/AppMetrics.swift

@@ -1,9 +1,26 @@
 // Copyright 2025-present 650 Industries. All rights reserved.
 import ExpoModulesCore
 
+#if !os(tvOS)
+import MetricKit
+#endif
+
 public struct AppMetrics {
   #if !os(tvOS)
   static let metricKitSubscriber = MetricKitSubscriber()
+
+  /**
+   Registers the MetricKit subscriber to receive diagnostic and performance payloads.
+   Even though MetricKit doesn't work on the simulator, it prints some logs (probably once a day)
+   that are piped to the terminal when using the `expo run:ios` command.
+   To avoid them, we explicitly don't register the subscriber on the simulator.
+   */
+  static func registerMetricKitSubscriber() {
+    #if !targetEnvironment(simulator)
+    MXMetricManager.shared.add(metricKitSubscriber)
+    metricKitSubscriber.processPastPayloads()
+    #endif
+  }
   #endif
 
   public static let storage = MetricsStorage()