@sentry/browser 9.8.0 → 9.10.0

package/build/npm/types-ts3.8/log.d.ts

@@ -0,0 +1,169 @@
+import { Log, ParameterizedString } from '@sentry/core';
+/**
+ * @summary Capture a log with the `trace` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { userId: 100, route: '/dashboard' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.trace('User clicked submit button', {
+ *   buttonId: 'submit-form',
+ *   formId: 'user-profile',
+ *   timestamp: Date.now()
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.trace(Sentry.logger.fmt`User ${user} navigated to ${page}`, {
+ *   userId: '123',
+ *   sessionId: 'abc-xyz'
+ * });
+ * ```
+ */
+export declare function trace(message: ParameterizedString, attributes?: Log['attributes']): void;
+/**
+ * @summary Capture a log with the `debug` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { component: 'Header', state: 'loading' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.debug('Component mounted', {
+ *   component: 'UserProfile',
+ *   props: { userId: 123 },
+ *   renderTime: 150
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.debug(Sentry.logger.fmt`API request to ${endpoint} failed`, {
+ *   statusCode: 404,
+ *   requestId: 'req-123',
+ *   duration: 250
+ * });
+ * ```
+ */
+export declare function debug(message: ParameterizedString, attributes?: Log['attributes']): void;
+/**
+ * @summary Capture a log with the `info` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { feature: 'checkout', status: 'completed' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.info('User completed checkout', {
+ *   orderId: 'order-123',
+ *   amount: 99.99,
+ *   paymentMethod: 'credit_card'
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.info(Sentry.logger.fmt`User ${user} updated profile picture`, {
+ *   userId: 'user-123',
+ *   imageSize: '2.5MB',
+ *   timestamp: Date.now()
+ * });
+ * ```
+ */
+export declare function info(message: ParameterizedString, attributes?: Log['attributes']): void;
+/**
+ * @summary Capture a log with the `warn` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { browser: 'Chrome', version: '91.0' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.warn('Browser compatibility issue detected', {
+ *   browser: 'Safari',
+ *   version: '14.0',
+ *   feature: 'WebRTC',
+ *   fallback: 'enabled'
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.warn(Sentry.logger.fmt`API endpoint ${endpoint} is deprecated`, {
+ *   recommendedEndpoint: '/api/v2/users',
+ *   sunsetDate: '2024-12-31',
+ *   clientVersion: '1.2.3'
+ * });
+ * ```
+ */
+export declare function warn(message: ParameterizedString, attributes?: Log['attributes']): void;
+/**
+ * @summary Capture a log with the `error` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { error: 'NetworkError', url: '/api/data' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.error('Failed to load user data', {
+ *   error: 'NetworkError',
+ *   url: '/api/users/123',
+ *   statusCode: 500,
+ *   retryCount: 3
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.error(Sentry.logger.fmt`Payment processing failed for order ${orderId}`, {
+ *   error: 'InsufficientFunds',
+ *   amount: 100.00,
+ *   currency: 'USD',
+ *   userId: 'user-456'
+ * });
+ * ```
+ */
+export declare function error(message: ParameterizedString, attributes?: Log['attributes']): void;
+/**
+ * @summary Capture a log with the `fatal` level. Requires `_experiments.enableLogs` to be enabled.
+ *
+ * @param message - The message to log.
+ * @param attributes - Arbitrary structured data that stores information about the log - e.g., { appState: 'corrupted', sessionId: 'abc-123' }.
+ *
+ * @example
+ *
+ * ```
+ * Sentry.logger.fatal('Application state corrupted', {
+ *   lastKnownState: 'authenticated',
+ *   sessionId: 'session-123',
+ *   timestamp: Date.now(),
+ *   recoveryAttempted: true
+ * });
+ * ```
+ *
+ * @example With template strings
+ *
+ * ```
+ * Sentry.logger.fatal(Sentry.logger.fmt`Critical system failure in ${service}`, {
+ *   service: 'payment-processor',
+ *   errorCode: 'CRITICAL_FAILURE',
+ *   affectedUsers: 150,
+ *   timestamp: Date.now()
+ * });
+ * ```
+ */
+export declare function fatal(message: ParameterizedString, attributes?: Log['attributes']): void;
+export { fmt } from '@sentry/core';
+//# sourceMappingURL=log.d.ts.map

package/build/npm/types-ts3.8/tracing/browserTracingIntegration.d.ts

@@ -86,6 +86,28 @@ export interface BrowserTracingOptions {
      * Default: true
      */
     enableHTTPTimings: boolean;
+    /**
+     * Link the currently started trace to a previous trace (e.g. a prior pageload, navigation or
+     * manually started span). When enabled, this option will allow you to navigate between traces
+     * in the Sentry UI.
+     *
+     * You can set this option to the following values:
+     *
+     * - `'in-memory'`: The previous trace data will be stored in memory.
+     *   This is useful for single-page applications and enabled by default.
+     *
+     * - `'session-storage'`: The previous trace data will be stored in the `sessionStorage`.
+     *   This is useful for multi-page applications or static sites but it means that the
+     *   Sentry SDK writes to the browser's `sessionStorage`.
+     *
+     * - `'off'`: The previous trace data will not be stored or linked.
+     *
+     * Note that your `tracesSampleRate` or `tracesSampler` config significantly influences
+     * how often traces will be linked.
+     *
+     * @default 'in-memory' - see explanation above
+     */
+    linkPreviousTrace: 'in-memory' | 'session-storage' | 'off';
     /**
      * _experiments allows the user to send options to define how this integration works.
      *

package/build/npm/types-ts3.8/tracing/previousTrace.d.ts

@@ -0,0 +1,31 @@
+import { Span } from '@sentry/core';
+import { SpanContextData } from '@sentry/core';
+export interface PreviousTraceInfo {
+    /**
+     * Span context of the previous trace's local root span
+     */
+    spanContext: SpanContextData;
+    /**
+     * Timestamp in seconds when the previous trace was started
+     */
+    startTimestamp: number;
+}
+export declare const PREVIOUS_TRACE_MAX_DURATION = 3600;
+export declare const PREVIOUS_TRACE_KEY = "sentry_previous_trace";
+/**
+ * Adds a previous_trace span link to the passed span if the passed
+ * previousTraceInfo is still valid.
+ *
+ * @returns the updated previous trace info (based on the current span/trace) to
+ * be used on the next call
+ */
+export declare function addPreviousTraceSpanLink(previousTraceInfo: PreviousTraceInfo | undefined, span: Span): PreviousTraceInfo;
+/**
+ * Stores @param previousTraceInfo in sessionStorage.
+ */
+export declare function storePreviousTraceInSessionStorage(previousTraceInfo: PreviousTraceInfo): void;
+/**
+ * Retrieves the previous trace from sessionStorage if available.
+ */
+export declare function getPreviousTraceFromSessionStorage(): PreviousTraceInfo | undefined;
+//# sourceMappingURL=previousTrace.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/browser",
-  "version": "9.8.0",
+  "version": "9.10.0",
   "description": "Official Sentry SDK for browsers",
   "repository": "git://github.com/getsentry/sentry-javascript.git",
   "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/browser",
@@ -39,14 +39,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@sentry-internal/browser-utils": "9.8.0",
-    "@sentry-internal/feedback": "9.8.0",
-    "@sentry-internal/replay": "9.8.0",
-    "@sentry-internal/replay-canvas": "9.8.0",
-    "@sentry/core": "9.8.0"
+    "@sentry-internal/browser-utils": "9.10.0",
+    "@sentry-internal/feedback": "9.10.0",
+    "@sentry-internal/replay": "9.10.0",
+    "@sentry-internal/replay-canvas": "9.10.0",
+    "@sentry/core": "9.10.0"
   },
   "devDependencies": {
-    "@sentry-internal/integration-shims": "9.8.0",
+    "@sentry-internal/integration-shims": "9.10.0",
     "fake-indexeddb": "^4.0.1"
   },
   "scripts": {