@sentry/browser 8.39.0-dev.0 → 8.41.0-beta.0

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

@@ -3,15 +3,15 @@ export { reportingObserverIntegration } from './integrations/reportingobserver';
 export { httpClientIntegration } from './integrations/httpclient';
 export { contextLinesIntegration } from './integrations/contextlines';
 export { captureConsoleIntegration, debugIntegration, extraErrorDataIntegration, rewriteFramesIntegration, sessionTimingIntegration, captureFeedback, } from '@sentry/core';
-export { replayIntegration, getReplay, } from '@sentry-internal/replay';
+export { replayIntegration, getReplay } from '@sentry-internal/replay';
 export { ReplayEventType, ReplayEventWithTime, ReplayBreadcrumbFrame, ReplayBreadcrumbFrameEvent, ReplayOptionFrameEvent, ReplayFrame, ReplayFrameEvent, ReplaySpanFrame, ReplaySpanFrameEvent, } from '@sentry-internal/replay';
 export { replayCanvasIntegration } from '@sentry-internal/replay-canvas';
 import { feedbackAsyncIntegration } from './feedbackAsync';
 import { feedbackSyncIntegration } from './feedbackSync';
 export { feedbackAsyncIntegration, feedbackSyncIntegration, feedbackSyncIntegration as feedbackIntegration };
-export { getFeedback, sendFeedback, } from '@sentry-internal/feedback';
+export { getFeedback, sendFeedback } from '@sentry-internal/feedback';
 export * from './metrics';
-export { defaultRequestInstrumentationOptions, instrumentOutgoingRequests, } from './tracing/request';
+export { defaultRequestInstrumentationOptions, instrumentOutgoingRequests } from './tracing/request';
 export { browserTracingIntegration, startBrowserTracingNavigationSpan, startBrowserTracingPageLoadSpan, } from './tracing/browserTracingIntegration';
 export { RequestInstrumentationOptions } from './tracing/request';
 export { addTracingExtensions, registerSpanErrorInstrumentation, getActiveSpan, getRootSpan, startSpan, startInactiveSpan, startSpanManual, withActiveSpan, startNewTrace, getSpanDescendants, setMeasurement, getSpanStatusFromHttpCode, setHttpStatus, makeMultiplexedTransport, moduleMetadataIntegration, zodErrorsIntegration, thirdPartyErrorFilterIntegration, } from '@sentry/core';
@@ -19,4 +19,7 @@ export { Span } from '@sentry/types';
 export { makeBrowserOfflineTransport } from './transports/offline';
 export { browserProfilingIntegration } from './profiling/integration';
 export { spotlightBrowserIntegration } from './integrations/spotlight';
+export { copyFlagsFromScopeToEvent, insertFlagToScope } from './utils/featureFlags';
+export { launchDarklyIntegration, buildLaunchDarklyFlagUsedHandler } from './integrations/featureFlags/launchdarkly';
+export { openFeatureIntegration, OpenFeatureIntegrationHook } from './integrations/featureFlags/openfeature';
 //# sourceMappingURL=index.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/launchdarkly/index.d.ts

@@ -0,0 +1,2 @@
+export { launchDarklyIntegration, buildLaunchDarklyFlagUsedHandler } from './integration';
+//# sourceMappingURL=index.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/launchdarkly/integration.d.ts

@@ -0,0 +1,25 @@
+import { LDInspectionFlagUsedHandler } from './types';
+/**
+ * Sentry integration for capturing feature flags from LaunchDarkly.
+ *
+ * See the [feature flag documentation](https://develop.sentry.dev/sdk/expected-features/#feature-flags) for more information.
+ *
+ * @example
+ * ```
+ * import * as Sentry from '@sentry/browser';
+ * import {launchDarklyIntegration, buildLaunchDarklyFlagUsedInspector} from '@sentry/browser';
+ * import * as LaunchDarkly from 'launchdarkly-js-client-sdk';
+ *
+ * Sentry.init(..., integrations: [launchDarklyIntegration()])
+ * const ldClient = LaunchDarkly.initialize(..., {inspectors: [buildLaunchDarklyFlagUsedHandler()]});
+ * ```
+ */
+export declare const launchDarklyIntegration: () => import("@sentry/types").Integration;
+/**
+ * LaunchDarkly hook that listens for flag evaluations and updates the `flags`
+ * context in our Sentry scope. This needs to be registered as an
+ * 'inspector' in LaunchDarkly initialize() options, separately from
+ * `launchDarklyIntegration`. Both are needed to collect feature flags on error.
+ */
+export declare function buildLaunchDarklyFlagUsedHandler(): LDInspectionFlagUsedHandler;
+//# sourceMappingURL=integration.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/launchdarkly/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Inline definitions of LaunchDarkly types so we don't have to include their
+ * SDK in devDependencies. These are only for type-checking and can be extended
+ * as needed - for exact definitions, reference `launchdarkly-js-client-sdk`.
+ */
+/**
+ * Currently, the Sentry integration does not read from values of this type.
+ */
+export type LDContext = object;
+/**
+ * An object that combines the result of a feature flag evaluation with information about
+ * how it was calculated.
+ */
+export interface LDEvaluationDetail {
+    value: unknown;
+}
+/**
+ * Callback interface for collecting information about the SDK at runtime.
+ *
+ * This interface is used to collect information about flag usage.
+ *
+ * This interface should not be used by the application to access flags for the purpose of controlling application
+ * flow. It is intended for monitoring, analytics, or debugging purposes.
+ */
+export interface LDInspectionFlagUsedHandler {
+    type: 'flag-used';
+    /**
+     * Name of the inspector. Will be used for logging issues with the inspector.
+     */
+    name: string;
+    /**
+     * If `true`, then the inspector will be ran synchronously with evaluation.
+     * Synchronous inspectors execute inline with evaluation and care should be taken to ensure
+     * they have minimal performance overhead.
+     */
+    synchronous?: boolean;
+    /**
+     * This method is called when a flag is accessed via a variation method, or it can be called based on actions in
+     * wrapper SDKs which have different methods of tracking when a flag was accessed. It is not called when a call is made
+     * to allFlags.
+     */
+    method: (flagKey: string, flagDetail: LDEvaluationDetail, context: LDContext) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/openfeature/index.d.ts

@@ -0,0 +1,2 @@
+export { openFeatureIntegration, OpenFeatureIntegrationHook } from './integration';
+//# sourceMappingURL=index.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/openfeature/integration.d.ts

@@ -0,0 +1,16 @@
+import { EvaluationDetails, HookContext, HookHints, JsonValue, OpenFeatureHook } from './types';
+export declare const openFeatureIntegration: () => import("@sentry/types").Integration;
+/**
+ * OpenFeature Hook class implementation.
+ */
+export declare class OpenFeatureIntegrationHook implements OpenFeatureHook {
+    /**
+     * Successful evaluation result.
+     */
+    after(_hookContext: Readonly<HookContext<JsonValue>>, evaluationDetails: EvaluationDetails<JsonValue>): void;
+    /**
+     * On error evaluation result.
+     */
+    error(hookContext: Readonly<HookContext<JsonValue>>, _error: unknown, _hookHints?: HookHints): void;
+}
+//# sourceMappingURL=integration.d.ts.map

package/build/npm/types-ts3.8/integrations/featureFlags/openfeature/types.d.ts

@@ -0,0 +1,86 @@
+export type FlagValue = boolean | string | number | JsonValue;
+export type FlagValueType = 'boolean' | 'string' | 'number' | 'object';
+export type JsonArray = JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JsonValue = PrimitiveValue | JsonObject | JsonArray;
+export type Metadata = Record<string, string>;
+export type PrimitiveValue = null | boolean | string | number;
+export type FlagMetadata = Record<string, string | number | boolean>;
+export declare const StandardResolutionReasons: {
+    readonly STATIC: "STATIC";
+    readonly DEFAULT: "DEFAULT";
+    readonly TARGETING_MATCH: "TARGETING_MATCH";
+    readonly SPLIT: "SPLIT";
+    readonly CACHED: "CACHED";
+    readonly DISABLED: "DISABLED";
+    readonly UNKNOWN: "UNKNOWN";
+    readonly STALE: "STALE";
+    readonly ERROR: "ERROR";
+};
+export declare enum ErrorCode {
+    PROVIDER_NOT_READY = "PROVIDER_NOT_READY",
+    PROVIDER_FATAL = "PROVIDER_FATAL",
+    FLAG_NOT_FOUND = "FLAG_NOT_FOUND",
+    PARSE_ERROR = "PARSE_ERROR",
+    TYPE_MISMATCH = "TYPE_MISMATCH",
+    TARGETING_KEY_MISSING = "TARGETING_KEY_MISSING",
+    INVALID_CONTEXT = "INVALID_CONTEXT",
+    GENERAL = "GENERAL"
+}
+export interface Logger {
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export type ResolutionReason = keyof typeof StandardResolutionReasons | (string & Record<never, never>);
+export type EvaluationContextValue = PrimitiveValue | Date | {
+    [key: string]: EvaluationContextValue;
+} | EvaluationContextValue[];
+export type EvaluationContext = {
+    targetingKey?: string;
+} & Record<string, EvaluationContextValue>;
+export interface ProviderMetadata extends Readonly<Metadata> {
+    readonly name: string;
+}
+export interface ClientMetadata {
+    readonly name?: string;
+    readonly domain?: string;
+    readonly version?: string;
+    readonly providerMetadata: ProviderMetadata;
+}
+export type HookHints = Readonly<Record<string, unknown>>;
+export interface HookContext<T extends FlagValue = FlagValue> {
+    readonly flagKey: string;
+    readonly defaultValue: T;
+    readonly flagValueType: FlagValueType;
+    readonly context: Readonly<EvaluationContext>;
+    readonly clientMetadata: ClientMetadata;
+    readonly providerMetadata: ProviderMetadata;
+    readonly logger: Logger;
+}
+export interface BeforeHookContext extends HookContext {
+    context: EvaluationContext;
+}
+export type ResolutionDetails<U> = {
+    value: U;
+    variant?: string;
+    flagMetadata?: FlagMetadata;
+    reason?: ResolutionReason;
+    errorCode?: ErrorCode;
+    errorMessage?: string;
+};
+export type EvaluationDetails<T extends FlagValue> = {
+    flagKey: string;
+    flagMetadata: Readonly<FlagMetadata>;
+} & ResolutionDetails<T>;
+export interface BaseHook<T extends FlagValue = FlagValue, BeforeHookReturn = unknown, HooksReturn = unknown> {
+    before?(hookContext: BeforeHookContext, hookHints?: HookHints): BeforeHookReturn;
+    after?(hookContext: Readonly<HookContext<T>>, evaluationDetails: EvaluationDetails<T>, hookHints?: HookHints): HooksReturn;
+    error?(hookContext: Readonly<HookContext<T>>, error: unknown, hookHints?: HookHints): HooksReturn;
+    finally?(hookContext: Readonly<HookContext<T>>, hookHints?: HookHints): HooksReturn;
+}
+export type OpenFeatureHook = BaseHook<FlagValue, void, void>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,34 @@
+import { Event, FeatureFlag } from '@sentry/types';
+/**
+ * Ordered LRU cache for storing feature flags in the scope context. The name
+ * of each flag in the buffer is unique, and the output of getAll() is ordered
+ * from oldest to newest.
+ */
+/**
+ * Max size of the LRU flag buffer stored in Sentry scope and event contexts.
+ */
+export declare const FLAG_BUFFER_SIZE = 100;
+/**
+ * Copies feature flags that are in current scope context to the event context
+ */
+export declare function copyFlagsFromScopeToEvent(event: Event): Event;
+/**
+ * Creates a feature flags values array in current context if it does not exist
+ * and inserts the flag into a FeatureFlag array while maintaining ordered LRU
+ * properties. Not thread-safe. After inserting:
+ * - `flags` is sorted in order of recency, with the newest flag at the end.
+ * - No other flags with the same name exist in `flags`.
+ * - The length of `flags` does not exceed `maxSize`. The oldest flag is evicted
+ *  as needed.
+ *
+ * @param name     Name of the feature flag to insert.
+ * @param value    Value of the feature flag.
+ * @param maxSize  Max number of flags the buffer should store. It's recommended
+ *   to keep this consistent across insertions. Default is FLAG_BUFFER_SIZE
+ */
+export declare function insertFlagToScope(name: string, value: unknown, maxSize?: number): void;
+/**
+ * Exported for tests
+ */
+export declare function insertToFlagBuffer(flags: FeatureFlag[], name: string, value: unknown, maxSize: number): void;
+//# sourceMappingURL=featureFlags.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/browser",
-  "version": "8.39.0-dev.0",
+  "version": "8.41.0-beta.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,16 +39,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@sentry-internal/browser-utils": "8.39.0-dev.0",
-    "@sentry-internal/feedback": "8.39.0-dev.0",
-    "@sentry-internal/replay": "8.39.0-dev.0",
-    "@sentry-internal/replay-canvas": "8.39.0-dev.0",
-    "@sentry/core": "8.39.0-dev.0",
-    "@sentry/types": "8.39.0-dev.0",
-    "@sentry/utils": "8.39.0-dev.0"
+    "@sentry-internal/browser-utils": "8.41.0-beta.0",
+    "@sentry-internal/feedback": "8.41.0-beta.0",
+    "@sentry-internal/replay": "8.41.0-beta.0",
+    "@sentry-internal/replay-canvas": "8.41.0-beta.0",
+    "@sentry/core": "8.41.0-beta.0",
+    "@sentry/types": "8.41.0-beta.0"
   },
   "devDependencies": {
-    "@sentry-internal/integration-shims": "8.39.0-dev.0",
+    "@sentry-internal/integration-shims": "8.41.0-beta.0",
     "fake-indexeddb": "^4.0.1"
   },
   "scripts": {