@sentry/browser 10.69.0 → 11.0.0-alpha.0

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

@@ -1,87 +0,0 @@
-import { Client, RequestHookInfo, ResponseHookInfo, Span } from '@sentry/core/browser';
-/** Options for Request Instrumentation */
-export interface RequestInstrumentationOptions {
-    /**
-     * List of strings and/or Regular Expressions used to determine which outgoing requests will have `sentry-trace` and `baggage`
-     * headers attached.
-     *
-     * **Default:** If this option is not provided, tracing headers will be attached to all outgoing requests.
-     * If you are using a browser SDK, by default, tracing headers will only be attached to outgoing requests to the same origin.
-     *
-     * **Disclaimer:** Carelessly setting this option in browser environments may result into CORS errors!
-     * Only attach tracing headers to requests to the same origin, or to requests to services you can control CORS headers of.
-     * Cross-origin requests, meaning requests to a different domain, for example a request to `https://api.example.com/` while you're on `https://example.com/`, take special care.
-     * If you are attaching headers to cross-origin requests, make sure the backend handling the request returns a `"Access-Control-Allow-Headers: sentry-trace, baggage"` header to ensure your requests aren't blocked.
-     *
-     * If you provide a `tracePropagationTargets` array, the entries you provide will be matched against the entire URL of the outgoing request.
-     * If you are using a browser SDK, the entries will also be matched against the pathname of the outgoing requests.
-     * This is so you can have matchers for relative requests, for example, `/^\/api/` if you want to trace requests to your `/api` routes on the same domain.
-     *
-     * If any of the two match any of the provided values, tracing headers will be attached to the outgoing request.
-     * Both, the string values, and the RegExes you provide in the array will match if they partially match the URL or pathname.
-     *
-     * Examples:
-     * - `tracePropagationTargets: [/^\/api/]` and request to `https://same-origin.com/api/posts`:
-     *   - Tracing headers will be attached because the request is sent to the same origin and the regex matches the pathname "/api/posts".
-     * - `tracePropagationTargets: [/^\/api/]` and request to `https://different-origin.com/api/posts`:
-     *   - Tracing headers will not be attached because the pathname will only be compared when the request target lives on the same origin.
-     * - `tracePropagationTargets: [/^\/api/, 'https://external-api.com']` and request to `https://external-api.com/v1/data`:
-     *   - Tracing headers will be attached because the request URL matches the string `'https://external-api.com'`.
-     */
-    tracePropagationTargets?: Array<string | RegExp>;
-    /**
-     * Flag to disable patching all together for fetch requests.
-     *
-     * Default: true
-     */
-    traceFetch: boolean;
-    /**
-     * Flag to disable patching all together for xhr requests.
-     *
-     * Default: true
-     */
-    traceXHR: boolean;
-    /**
-     * Flag to disable tracking of long-lived streams, like server-sent events (SSE) via fetch.
-     * Do not enable this in case you have live streams or very long running streams.
-     *
-     * Disabled by default since it can lead to issues with streams using the `cancel()` api
-     * (https://github.com/getsentry/sentry-javascript/issues/13950)
-     *
-     * Default: false
-     *
-     * @deprecated Use `fetchStreamPerformanceIntegration()` instead. Add it to your `integrations` array
-     * to track the duration of streamed fetch response bodies.
-     */
-    trackFetchStreamPerformance: boolean;
-    /**
-     * If true, Sentry will capture http timings and add them to the corresponding http spans.
-     *
-     * Default: true
-     */
-    enableHTTPTimings: boolean;
-    /**
-     * This function will be called before creating a span for a request with the given url.
-     * Return false if you don't want a span for the given url.
-     *
-     * Default: (url: string) => true
-     */
-    shouldCreateSpanForRequest?(this: void, url: string): boolean;
-    /**
-     * Is called when spans are started for outgoing requests.
-     */
-    onRequestSpanStart?(span: Span, requestInformation: RequestHookInfo): void;
-    /**
-     * Is called when spans end for outgoing requests, providing access to response headers.
-     */
-    onRequestSpanEnd?(span: Span, responseInformation: ResponseHookInfo): void;
-}
-export declare const defaultRequestInstrumentationOptions: RequestInstrumentationOptions;
-/** Registers span creators for xhr and fetch requests  */
-export declare function instrumentOutgoingRequests(client: Client, _options?: Partial<RequestInstrumentationOptions>): void;
-/**
- * A function that determines whether to attach tracing headers to a request.
- * We only export this function for testing purposes.
- */
-export declare function shouldAttachHeaders(targetUrl: string, tracePropagationTargets: (string | RegExp)[] | undefined): boolean;
-//# sourceMappingURL=request.d.ts.map

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

@@ -1,39 +0,0 @@
-import { Span } from '@sentry/core/browser';
-/**
- * Sets an inactive span active on the current scope.
- *
- * This is useful in browser applications, if you want to create a span that cannot be finished
- * within its callback. Any spans started while the given span is active, will be children of the span.
- *
- * If there already was an active span on the scope prior to calling this function, it is replaced
- * with the given span and restored after the span ended. Otherwise, the span will simply be
- * removed, resulting in no active span on the scope.
- *
- * IMPORTANT: This function can ONLY be used in the browser! Calling this function in a server
- * environment (for example in a server-side rendered component) will result in undefined behaviour
- * and is not supported.
- * You MUST call `span.end()` manually, otherwise the span will never be finished.
- *
- * @example
- * ```js
- * let checkoutSpan;
- *
- * on('checkoutStarted', () => {
- *  checkoutSpan = Sentry.startInactiveSpan({ name: 'checkout-flow' });
- *  Sentry.setActiveSpanInBrowser(checkoutSpan);
- * })
- *
- * // during this time, any spans started will be children of `checkoutSpan`:
- * Sentry.startSpan({ name: 'checkout-step-1' }, () => {
- *  // ... `
- * })
- *
- * on('checkoutCompleted', () => {
- *  checkoutSpan?.end();
- * })
- * ```
- *
- * @param span - the span to set active
- */
-export declare function setActiveSpanInBrowser(span: Span): void;
-//# sourceMappingURL=setActiveSpan.d.ts.map

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

@@ -1,17 +0,0 @@
-/**
- * Checks if the baggage header has Sentry values.
- */
-export declare function baggageHeaderHasSentryValues(baggageHeader: string): boolean;
-/**
- * Gets the full URL from a given URL string.
- */
-export declare function getFullURL(url: string): string | undefined;
-/**
- * Checks if the entry is a PerformanceResourceTiming.
- */
-export declare function isPerformanceResourceTiming(entry: PerformanceEntry): entry is PerformanceResourceTiming;
-/**
- * Creates a Headers object from a record of string key-value pairs, and returns undefined if it fails.
- */
-export declare function createHeadersSafely(headers: Record<string, string> | undefined): Headers | undefined;
-//# sourceMappingURL=utils.d.ts.map

package/build/npm/types-ts3.8/transports/fetch.d.ts

@@ -1,8 +0,0 @@
-import { Transport } from '@sentry/core/browser';
-import { WINDOW } from '../helpers';
-import { BrowserTransportOptions } from './types';
-/**
- * Creates a Transport that uses the Fetch API to send events to Sentry.
- */
-export declare function makeFetchTransport(options: BrowserTransportOptions, nativeFetch?: typeof WINDOW.fetch): Transport;
-//# sourceMappingURL=fetch.d.ts.map

package/build/npm/types-ts3.8/transports/offline.d.ts

@@ -1,33 +0,0 @@
-import { BaseTransportOptions, OfflineTransportOptions, Transport } from '@sentry/core/browser';
-type Store = <T>(callback: (store: IDBObjectStore) => T | PromiseLike<T>) => Promise<T>;
-/** Create or open an IndexedDb store */
-export declare function createStore(dbName: string, storeName: string): Store;
-/** Insert into the end of the store */
-export declare function push(store: Store, value: Uint8Array | string, maxQueueSize: number): Promise<void>;
-/** Insert into the front of the store */
-export declare function unshift(store: Store, value: Uint8Array | string, maxQueueSize: number): Promise<void>;
-/** Pop the oldest value from the store */
-export declare function shift(store: Store): Promise<Uint8Array | string | undefined>;
-export interface BrowserOfflineTransportOptions extends Pick<OfflineTransportOptions, Exclude<keyof OfflineTransportOptions, 'createStore'>> {
-    /**
-     * Name of indexedDb database to store envelopes in
-     * Default: 'sentry-offline'
-     */
-    dbName?: string;
-    /**
-     * Name of indexedDb object store to store envelopes in
-     * Default: 'queue'
-     */
-    storeName?: string;
-    /**
-     * Maximum number of envelopes to store
-     * Default: 30
-     */
-    maxQueueSize?: number;
-}
-/**
- * Creates a transport that uses IndexedDb to store events when offline.
- */
-export declare function makeBrowserOfflineTransport<T extends BaseTransportOptions>(createTransport?: (options: T) => Transport): (options: T & BrowserOfflineTransportOptions) => Transport;
-export {};
-//# sourceMappingURL=offline.d.ts.map

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

@@ -1,6 +0,0 @@
-import { BaseTransportOptions } from '@sentry/core/browser';
-export interface BrowserTransportOptions extends BaseTransportOptions {
-    /** Fetch API init parameters. Used by the FetchTransport */
-    fetchOptions?: RequestInit;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1,10 +0,0 @@
-import { DsnComponents, EventEnvelope, SdkMetadata, UserFeedback } from '@sentry/core/browser';
-/**
- * Creates an envelope from a user feedback.
- */
-export declare function createUserFeedbackEnvelope(feedback: UserFeedback, { metadata, tunnel, dsn, }: {
-    metadata: SdkMetadata | undefined;
-    tunnel: string | undefined;
-    dsn: DsnComponents | undefined;
-}): EventEnvelope;
-//# sourceMappingURL=userfeedback.d.ts.map

package/build/npm/types-ts3.8/utils/detectBrowserExtension.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns true if the SDK is running in an embedded browser extension.
- * Stand-alone browser extensions (which do not share the same data as the main browser page) are fine.
- */
-export declare function checkAndWarnIfIsEmbeddedBrowserExtension(): boolean;
-//# sourceMappingURL=detectBrowserExtension.d.ts.map

package/build/npm/types-ts3.8/utils/lazyLoadIntegration.d.ts

@@ -1,35 +0,0 @@
-import { IntegrationFn } from '@sentry/core/browser';
-declare const LAZY_LOADABLE_NAMES: readonly [
-    "replayIntegration",
-    "replayCanvasIntegration",
-    "feedbackIntegration",
-    "feedbackModalIntegration",
-    "feedbackScreenshotIntegration",
-    "captureConsoleIntegration",
-    "contextLinesIntegration",
-    "linkedErrorsIntegration",
-    "dedupeIntegration",
-    "extraErrorDataIntegration",
-    "graphqlClientIntegration",
-    "httpClientIntegration",
-    "reportingObserverIntegration",
-    "rewriteFramesIntegration",
-    "browserProfilingIntegration",
-    "moduleMetadataIntegration",
-    "instrumentAnthropicAiClient",
-    "instrumentOpenAiClient",
-    "instrumentGoogleGenAIClient",
-    "instrumentStateGraph",
-    "instrumentLangGraph",
-    "createLangChainCallbackHandler",
-    "instrumentLangChainEmbeddings"
-];
-type ElementOf<T extends readonly unknown[]> = T[number];
-type LazyLoadableIntegrationName = ElementOf<typeof LAZY_LOADABLE_NAMES>;
-/**
- * Lazy load an integration from the CDN.
- * Rejects if the integration cannot be loaded.
- */
-export declare function lazyLoadIntegration(name: LazyLoadableIntegrationName, scriptNonce?: string): Promise<IntegrationFn>;
-export {};
-//# sourceMappingURL=lazyLoadIntegration.d.ts.map