@sentry/react-native 8.2.0 → 8.4.0

package/ts3.8/dist/js/tracing/expoAsset.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Internal interface for expo-asset's Asset instance.
+ * We define this to avoid a hard dependency on expo-asset.
+ */
+export interface ExpoAssetInstance {
+    name: string;
+    type: string;
+    hash: string | null;
+    uri: string;
+    localUri: string | null;
+    width: number | null;
+    height: number | null;
+    downloaded: boolean;
+    downloadAsync(): Promise<ExpoAssetInstance>;
+}
+/**
+ * Represents the expo-asset `Asset` class with its static methods.
+ * We only describe the methods that we instrument.
+ */
+export interface ExpoAsset {
+    loadAsync(moduleId: number | number[] | string | string[]): Promise<ExpoAssetInstance[]>;
+    fromModule(virtualAssetModule: number | string): ExpoAssetInstance;
+}
+/**
+ * Wraps expo-asset's `Asset` class to add automated performance monitoring.
+ *
+ * This function instruments `Asset.loadAsync` static method
+ * to create performance spans that measure how long asset loading takes.
+ *
+ * @param assetClass - The `Asset` class from `expo-asset`
+ * @returns The same class with instrumented static methods
+ *
+ * @example
+ * ```typescript
+ * import { Asset } from 'expo-asset';
+ * import * as Sentry from '@sentry/react-native';
+ *
+ * Sentry.wrapExpoAsset(Asset);
+ * ```
+ */
+export declare function wrapExpoAsset<T extends ExpoAsset>(assetClass: T): T;
+//# sourceMappingURL=expoAsset.d.ts.map

package/ts3.8/dist/js/tracing/expoImage.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Internal interface for expo-image's ImageSource.
+ * We define this to avoid a hard dependency on expo-image.
+ */
+interface ExpoImageSource {
+    uri?: string;
+    headers?: Record<string, string>;
+    width?: number | null;
+    height?: number | null;
+    cacheKey?: string;
+}
+/**
+ * Internal interface for expo-image's ImageLoadOptions.
+ * We define this to avoid a hard dependency on expo-image.
+ */
+interface ExpoImageLoadOptions {
+    maxWidth?: number;
+    maxHeight?: number;
+    onError?(error: Error, retry: () => void): void;
+}
+/**
+ * Internal interface for expo-image's ImageRef.
+ * We define this to avoid a hard dependency on expo-image.
+ */
+interface ExpoImageRef {
+    readonly width: number;
+    readonly height: number;
+    readonly scale: number;
+    readonly mediaType: string | null;
+    readonly isAnimated?: boolean;
+}
+/**
+ * Represents the expo-image `Image` class with its static methods.
+ * We only describe the methods that we instrument.
+ */
+export interface ExpoImage {
+    prefetch(urls: string | string[], cachePolicyOrOptions?: any): Promise<boolean>;
+    loadAsync(source: ExpoImageSource | string | number, options?: ExpoImageLoadOptions): Promise<ExpoImageRef>;
+    clearMemoryCache?(): Promise<boolean>;
+    clearDiskCache?(): Promise<boolean>;
+}
+/**
+ * Wraps expo-image's `Image` class to add automated performance monitoring.
+ *
+ * This function instruments `Image.prefetch` and `Image.loadAsync` static methods
+ * to create performance spans that measure how long image prefetching and loading take.
+ *
+ * @param imageClass - The `Image` class from `expo-image`
+ * @returns The same class with instrumented static methods
+ *
+ * @example
+ * ```typescript
+ * import { Image } from 'expo-image';
+ * import * as Sentry from '@sentry/react-native';
+ *
+ * Sentry.wrapExpoImage(Image);
+ * ```
+ */
+export declare function wrapExpoImage<T extends ExpoImage>(imageClass: T): T;
+export {};
+//# sourceMappingURL=expoImage.d.ts.map

package/ts3.8/dist/js/tracing/index.d.ts

@@ -4,6 +4,10 @@ export { reactNavigationIntegration } from './reactnavigation';
 export { reactNativeNavigationIntegration } from './reactnativenavigation';
 export { wrapExpoRouter } from './expoRouter';
 export type { ExpoRouter } from './expoRouter';
+export { wrapExpoImage } from './expoImage';
+export type { ExpoImage } from './expoImage';
+export { wrapExpoAsset } from './expoAsset';
+export type { ExpoAsset } from './expoAsset';
 export { startIdleNavigationSpan, startIdleSpan, getDefaultIdleNavigationSpanOptions } from './span';
 export type { ReactNavigationCurrentRoute, ReactNavigationRoute } from './types';
 export { ReactNativeProfiler } from './reactnativeprofiler';

package/ts3.8/dist/js/tracing/onSpanEndUtils.d.ts

@@ -21,6 +21,13 @@ export declare const ignoreEmptyRouteChangeTransactions: (client: Client | undef
 export declare const onlySampleIfChildSpans: (client: Client, span: Span) => void;
 /**
  * Hooks on AppState change to cancel the span if the app goes background.
+ *
+ * On iOS the JS thread can be suspended between the `inactive` and
+ * `background` transitions, which means the `background` event may never
+ * reach JS in time. To handle this we schedule a deferred cancellation when
+ * the app becomes `inactive`. If the app returns to `active` before the
+ * timeout fires, the cancellation is cleared. If it transitions to
+ * `background` first, we cancel immediately and clear the timeout.
  */
 export declare const cancelInBackground: (client: Client, span: Span) => void;
 //# sourceMappingURL=onSpanEndUtils.d.ts.map

package/ts3.8/dist/js/tracing/origin.d.ts

@@ -8,4 +8,6 @@ export declare const SPAN_ORIGIN_AUTO_NAVIGATION_CUSTOM = "auto.navigation.custo
 export declare const SPAN_ORIGIN_AUTO_UI_TIME_TO_DISPLAY = "auto.ui.time_to_display";
 export declare const SPAN_ORIGIN_MANUAL_UI_TIME_TO_DISPLAY = "manual.ui.time_to_display";
 export declare const SPAN_ORIGIN_AUTO_EXPO_ROUTER_PREFETCH = "auto.expo_router.prefetch";
+export declare const SPAN_ORIGIN_AUTO_RESOURCE_EXPO_IMAGE = "auto.resource.expo_image";
+export declare const SPAN_ORIGIN_AUTO_RESOURCE_EXPO_ASSET = "auto.resource.expo_asset";
 //# sourceMappingURL=origin.d.ts.map

package/ts3.8/dist/js/tracing/reactnavigation.d.ts

@@ -1,5 +1,20 @@
 import type { Client, Integration } from '@sentry/core';
 export declare const INTEGRATION_NAME = "ReactNavigation";
+/**
+ * Extracts dynamic route parameters from a route name and its params.
+ * Matches Expo Router style dynamic segments like `[id]` and `[...slug]`.
+ *
+ * Only params whose keys appear as dynamic segments in the route name are returned,
+ * filtering out non-structural params (query params, etc.) that may contain PII.
+ *
+ * Note: dynamic segment values (e.g. the `123` in `profile/[id]`) may be user-identifiable.
+ * This function only extracts params — callers are responsible for checking `sendDefaultPii`
+ * before including the result in span attributes.
+ *
+ * Previous route params are intentionally not captured — only the current route's
+ * structural params are needed for trace attribution.
+ */
+export declare function extractDynamicRouteParams(routeName: string, params?: Record<string, unknown>): Record<string, string> | undefined;
 interface ReactNavigationIntegrationOptions {
     /**
      * How long the instrumentation will wait for the route to mount after a change has been initiated,

package/ts3.8/dist/js/tracing/span.d.ts

@@ -7,14 +7,14 @@ export declare const defaultIdleOptions: {
      *
      * @default 1_000 (ms)
      */
-    finalTimeout: number;
+    idleTimeout: number;
     /**
      * The max. time an idle span may run.
      * If this time is exceeded, the idle span will finish no matter what.
      *
-     * @default 60_0000 (ms)
+     * @default 600_000 (ms)
      */
-    idleTimeout: number;
+    finalTimeout: number;
 };
 export declare const startIdleNavigationSpan: (startSpanOption: StartSpanOptions, { finalTimeout, idleTimeout, isAppRestart, }?: Partial<{
     /**
@@ -23,14 +23,14 @@ export declare const startIdleNavigationSpan: (startSpanOption: StartSpanOptions
      *
      * @default 1_000 (ms)
      */
-    finalTimeout: number;
+    idleTimeout: number;
     /**
      * The max. time an idle span may run.
      * If this time is exceeded, the idle span will finish no matter what.
      *
-     * @default 60_0000 (ms)
+     * @default 600_000 (ms)
      */
-    idleTimeout: number;
+    finalTimeout: number;
 }> & {
     isAppRestart?: boolean | undefined;
 }) => Span | undefined;

package/ts3.8/dist/js/tracing/utils.d.ts

@@ -1,4 +1,4 @@
-import type { MeasurementUnit, Span, SpanJSON, TransactionSource } from '@sentry/core';
+import type { MeasurementUnit, Span, SpanJSON, StartSpanOptions, TransactionSource } from '@sentry/core';
 export declare const defaultTransactionSource: TransactionSource;
 export declare const customTransactionSource: TransactionSource;
 /**
@@ -42,6 +42,32 @@ export declare function getBundleStartTimestampMs(): number | undefined;
  * Creates valid span JSON object from the given data.
  */
 export declare function createSpanJSON(from: Partial<SpanJSON> & Pick<Required<SpanJSON>, 'description' | 'start_timestamp' | 'timestamp' | 'origin'>): SpanJSON;
+/**
+ * Wraps a function call that returns a `Promise` with an inactive span that
+ * is automatically ended on success or failure (both sync throws and async
+ * rejections).
+ *
+ * This is the standard pattern for instrumenting async SDK operations such as
+ * `Image.loadAsync` and `Asset.loadAsync`.
+ *
+ * The span status is always set by this utility (`ok` on resolve, `error` on
+ * reject or sync throw). If you need custom status logic (e.g. inspecting the
+ * resolved value), handle span lifecycle manually instead.
+ *
+ * @param spanOptions  Options forwarded to `startInactiveSpan`.
+ * @param fn           The function to call.
+ * @returns            Whatever `fn` returns (the original `Promise`).
+ */
+export declare function traceAsyncOperation<T>(spanOptions: StartSpanOptions, fn: () => Promise<T>): Promise<T>;
+/**
+ * Strips query string and fragment from a URL, preserving the scheme, host, and path.
+ */
+export declare function sanitizeUrl(url: string): string;
+/**
+ * Extracts a short, human-readable description from a URL by stripping
+ * the query string, fragment, and path — returning only the filename.
+ */
+export declare function describeUrl(url: string): string;
 /**
  *
  */

package/ts3.8/dist/js/utils/expoglobalobject.d.ts

@@ -5,15 +5,9 @@
  *
  * https://github.com/expo/expo/blob/b51b5139f2caa2a9495e4132437d7ca612276158/packages/expo-constants/src/Constants.ts
  * https://github.com/expo/expo/blob/b51b5139f2caa2a9495e4132437d7ca612276158/packages/expo-manifests/src/Manifests.ts
+ * https://github.com/expo/expo/blob/fce7f6eb2ea2611cb30e9cb20baaeee2ac0a18b6/packages/expo-constants/src/Constants.types.ts
  */
 export interface ExpoConstants {
-    /**
-     * Deprecated. But until removed we can use it as user ID to match the native SDKs.
-     */
-    installationId?: string;
-    /**
-     * Version of the Expo Go app
-     */
     expoVersion?: string | null;
     manifest?: null | {
         [key: string]: unknown;
@@ -23,6 +17,52 @@ export interface ExpoConstants {
          */
         runtimeVersion?: string;
     };
+    /**
+     * Returns the current execution environment.
+     * Values: 'bare', 'standalone', 'storeClient'
+     */
+    executionEnvironment?: string;
+    /**
+     * Deprecated. Returns 'expo' when running in Expo Go, otherwise null.
+     */
+    appOwnership?: string | null;
+    /**
+     * Identifies debug vs. production builds.
+     */
+    debugMode?: boolean;
+    /**
+     * Unique identifier per app session.
+     */
+    sessionId?: string;
+    /**
+     * Runtime version info.
+     */
+    expoRuntimeVersion?: string | null;
+    /**
+     * Device status bar height.
+     */
+    statusBarHeight?: number;
+    /**
+     * Available system fonts.
+     */
+    systemFonts?: string[];
+    /**
+     * The standard Expo config object defined in app.json and app.config.js files.
+     */
+    expoConfig?: null | {
+        [key: string]: unknown;
+        name?: string;
+        slug?: string;
+        version?: string;
+        sdkVersion?: string;
+    };
+    /**
+     * EAS configuration when applicable.
+     */
+    easConfig?: null | {
+        [key: string]: unknown;
+        projectId?: string;
+    };
 }
 /**
  * Interface from the Expo SDK defined here

package/ts3.8/dist/js/version.d.ts

@@ -1,4 +1,4 @@
 export declare const SDK_PACKAGE_NAME = "npm:@sentry/react-native";
 export declare const SDK_NAME = "sentry.javascript.react-native";
-export declare const SDK_VERSION = "8.2.0";
+export declare const SDK_VERSION = "8.4.0";
 //# sourceMappingURL=version.d.ts.map