@flareapp/core 2.9.0 → 2.11.0

package/dist/index.cjs

@@ -26,7 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_urlAttributes = require('./urlAttributes-CEP6bOBn.cjs');
+const require_urlAttributes = require('./urlAttributes-Cinqzwjy.cjs');
 let error_stack_parser = require("error-stack-parser");
 error_stack_parser = __toESM(error_stack_parser);
 
@@ -220,6 +220,7 @@ var TelemetryBuffer = class {
 	}
 	add(record) {
 		const config = this.deps.getConfig();
+		if (config.hasConsent === false) return;
 		const limits = this.policy.limits(config);
 		const bytes = this.policy.estimateBytes(record);
 		if (bytes > limits.maxBytes) {
@@ -239,6 +240,10 @@ var TelemetryBuffer = class {
 		const config = this.deps.getConfig();
 		if (!this.policy.enabled(config)) return;
 		if (this.entries.length === 0) return;
+		if (config.hasConsent === false) {
+			this.clearTimer();
+			return;
+		}
 		if (!require_urlAttributes.assertKey(config.key, config.debug)) {
 			this.clearTimer();
 			return;
@@ -574,6 +579,7 @@ var Logger = class {
 	}
 	record(level, message, context, attributes) {
 		const config = this.deps.getConfig();
+		if (config.hasConsent === false) return;
 		if (!config.enableLogs) return;
 		if (config.minimumLogLevel && !isAtOrAboveMinimum(level, config.minimumLogLevel)) return;
 		const userAttributes = {
@@ -612,6 +618,8 @@ const RESOURCE_PREFIXES = [
 	"host.",
 	"os.",
 	"process.",
+	"device.",
+	"network.",
 	"flare.framework.",
 	"flare.language."
 ];
@@ -1441,6 +1449,7 @@ var Flare = class {
 	_tracer;
 	_config = {
 		key: null,
+		hasConsent: true,
 		version: "",
 		sourcemapVersionId: require_urlAttributes.SOURCEMAP_VERSION,
 		stage: "",
@@ -1582,6 +1591,21 @@ var Flare = class {
 		this._tracer.flush();
 		return this;
 	}
+	/**
+	* Turn sending on or off for consent. Off blocks errors, logs, and traces, and drops telemetry
+	* captured earlier so a later grant cannot ship it. On re-grant, flushes anything still buffered.
+	*/
+	setConsent(granted) {
+		this._config.hasConsent = granted;
+		if (granted) {
+			this._logger.flush();
+			this._tracer.flush();
+		} else {
+			this._logger.clear();
+			this._tracer.clear();
+		}
+		return this;
+	}
 	configure(config) {
 		const wasLogsEnabled = this._config.enableLogs;
 		const wasTracingEnabled = this._config.enableTracing;
@@ -1668,11 +1692,19 @@ var Flare = class {
 		this.framework = framework;
 		return this;
 	}
+	/**
+	* True when a report must not be captured: consent withdrawn, or dropped by sampling. Consent is
+	* checked first, so a blocked report never runs the sampler or assembles a report (no cookie read).
+	*/
+	shouldSkipCapture() {
+		if (this._config.hasConsent === false) return true;
+		return this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate;
+	}
 	report(error, attributes = {}) {
 		return this.track(this.reportInternal(error, attributes));
 	}
 	async reportInternal(error, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const coerced = error instanceof Error ? error : new Error(String(error));
 		const errorToReport = await this._config.beforeEvaluate(coerced);
@@ -1688,7 +1720,7 @@ var Flare = class {
 		return this.track(this.reportUnhandledRejectionInternal(message, attributes));
 	}
 	async reportUnhandledRejectionInternal(message, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const report = this.buildReport({
 			exceptionClass: "UnhandledRejection",
@@ -1706,7 +1738,7 @@ var Flare = class {
 		return this.track(this.reportMessageInternal(message, level, attributes));
 	}
 	async reportMessageInternal(message, level, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const stackTrace = await createStackTrace(/* @__PURE__ */ new Error(), this._config.debug, this.fileReader);
 		stackTrace.shift();
@@ -1823,6 +1855,7 @@ var Flare = class {
 		return report;
 	}
 	async sendReport(report) {
+		if (this._config.hasConsent === false) return;
 		if (!require_urlAttributes.assertKey(this._config.key, this._config.debug)) return;
 		const reportToSubmit = await this._config.beforeSubmit(report);
 		if (!reportToSubmit) return;
@@ -1830,6 +1863,73 @@ var Flare = class {
 	}
 };
 
+//#endregion
+//#region src/device/DeviceInfoProvider.ts
+/** Default for platforms with no device info. */
+var NullDeviceInfoProvider = class {
+	collect() {
+		return {};
+	}
+};
+
+//#endregion
+//#region src/device/deviceInfoToAttributes.ts
+/** Map `DeviceInfo` to wire attributes: flat keys plus a `context.device` card. Shared by every SDK, so keys never drift. */
+function deviceInfoToAttributes(info) {
+	const attrs = {};
+	require_urlAttributes.setDefined(attrs, "os.name", info.os?.name);
+	require_urlAttributes.setDefined(attrs, "os.version", info.os?.version);
+	require_urlAttributes.setDefined(attrs, "process.runtime.name", info.runtime?.name);
+	require_urlAttributes.setDefined(attrs, "process.runtime.version", info.runtime?.version);
+	require_urlAttributes.setDefined(attrs, "device.type", info.device?.type);
+	require_urlAttributes.setDefined(attrs, "device.model.name", info.device?.model);
+	require_urlAttributes.setDefined(attrs, "device.memory_gb", info.device?.memoryGb);
+	require_urlAttributes.setDefined(attrs, "device.cpu_cores", info.device?.cpuCores);
+	require_urlAttributes.setDefined(attrs, "device.screen.width", info.device?.screen?.width);
+	require_urlAttributes.setDefined(attrs, "device.screen.height", info.device?.screen?.height);
+	require_urlAttributes.setDefined(attrs, "device.screen.scale", info.device?.screen?.scale);
+	require_urlAttributes.setDefined(attrs, "network.effective_type", info.network?.effectiveType);
+	require_urlAttributes.setDefined(attrs, "network.downlink_mbps", info.network?.downlinkMbps);
+	require_urlAttributes.setDefined(attrs, "network.rtt_ms", info.network?.rttMs);
+	require_urlAttributes.setDefined(attrs, "network.online", info.network?.online);
+	require_urlAttributes.setDefined(attrs, "app.version", info.app?.version);
+	require_urlAttributes.setDefined(attrs, "app.id", info.app?.id);
+	const group = buildDeviceContextGroup(info);
+	if (Object.keys(group).length > 0) attrs["context.device"] = group;
+	return attrs;
+}
+/**
+* `context.device` card for the error UI. Rendered one level deep, so values stay scalar. Built only when
+* a device or network signal exists (an os-only Node report gets none).
+*/
+function buildDeviceContextGroup(info) {
+	if (!hasDeviceSignal(info.device) && !hasNetworkSignal(info.network)) return {};
+	const group = {};
+	const os = [info.os?.name, info.os?.version].filter((value) => value != null).join(" ");
+	if (os) group.OS = os;
+	require_urlAttributes.setDefined(group, "Model", info.device?.model);
+	require_urlAttributes.setDefined(group, "Type", info.device?.type);
+	const screen = info.device?.screen;
+	if (screen?.width != null && screen?.height != null) group.Screen = screen.scale != null ? `${screen.width} × ${screen.height} @ ${screen.scale}x` : `${screen.width} × ${screen.height}`;
+	if (info.device?.memoryGb != null) group.Memory = `${info.device.memoryGb} GB`;
+	require_urlAttributes.setDefined(group, "CPU cores", info.device?.cpuCores);
+	require_urlAttributes.setDefined(group, "Connection", info.network?.effectiveType);
+	if (info.network?.downlinkMbps != null) group.Downlink = `${info.network.downlinkMbps} Mbps`;
+	if (info.network?.rttMs != null) group.RTT = `${info.network.rttMs} ms`;
+	require_urlAttributes.setDefined(group, "Online", info.network?.online);
+	require_urlAttributes.setDefined(group, "App version", info.app?.version);
+	require_urlAttributes.setDefined(group, "App ID", info.app?.id);
+	require_urlAttributes.setDefined(group, "Language", info.locale?.language);
+	require_urlAttributes.setDefined(group, "Timezone", info.locale?.timezone);
+	return group;
+}
+function hasDeviceSignal(device) {
+	return device != null && (device.type != null || device.model != null || device.memoryGb != null || device.cpuCores != null || device.screen?.width != null || device.screen?.height != null);
+}
+function hasNetworkSignal(network) {
+	return network != null && (network.effectiveType != null || network.downlinkMbps != null || network.rttMs != null || network.online != null);
+}
+
 //#endregion
 exports.Api = Api;
 exports.BrowserSpanEventType = BrowserSpanEventType;
@@ -1843,6 +1943,7 @@ exports.InMemoryActiveSpanHolder = InMemoryActiveSpanHolder;
 exports.Logger = Logger;
 exports.MAX_BREADCRUMB_URL_LENGTH = MAX_BREADCRUMB_URL_LENGTH;
 exports.NoopFlushScheduler = NoopFlushScheduler;
+exports.NullDeviceInfoProvider = NullDeviceInfoProvider;
 exports.NullFileReader = NullFileReader;
 exports.Scope = Scope;
 exports.SpanStatusCode = SpanStatusCode;
@@ -1851,6 +1952,7 @@ exports.USER_IDENTITY_KEYS = USER_IDENTITY_KEYS;
 exports.assert = require_urlAttributes.assert;
 exports.assertKey = require_urlAttributes.assertKey;
 exports.breadcrumbUrl = breadcrumbUrl;
+exports.buildDeviceContextGroup = buildDeviceContextGroup;
 exports.buildTraceparent = buildTraceparent;
 exports.buildTracesEnvelope = buildTracesEnvelope;
 exports.convertToError = require_urlAttributes.convertToError;
@@ -1858,6 +1960,7 @@ exports.createIdentityTagger = require_urlAttributes.createIdentityTagger;
 exports.createStackTrace = createStackTrace;
 exports.defaultNowNano = defaultNowNano;
 exports.describeRejectionReason = require_urlAttributes.describeRejectionReason;
+exports.deviceInfoToAttributes = deviceInfoToAttributes;
 exports.extractCode = require_urlAttributes.extractCode;
 exports.flatJsonStringify = require_urlAttributes.flatJsonStringify;
 exports.getCodeSnippet = getCodeSnippet;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { $ as TracesSampler, A as BufferedLog, B as OtelLogRecord, D as AnyValue, E as assert, F as Framework, G as SdkInfo, H as OverriddenGrouping, I as Glow, J as SpanOptions, K as Span, L as KeyValue, M as Config, N as EntryPointHandler, O as AttributeValue, P as EntryPointType, Q as TracesEnvelope, R as LogsEnvelope, S as convertToError, T as assertKey, U as Report, V as OtelSpan, W as SamplingContext, X as SpanStatusCode, Y as SpanStatus, Z as StackFrame, _ as glowsToEvents, a as SafeCloneOptions, b as SdkTaggable, c as describeRejectionReason, d as redactObjectValues, et as User, f as redactUrlQuery, h as now, it as FrameworkName, j as BufferedSpan, k as Attributes, l as routeRejection, m as safeDecode, n as urlAttributes, nt as BrowserSpanType, o as safeClone, p as resolveDenylist, q as SpanEvent, r as toCustomContext, rt as SpanTypeName, s as RejectionReporter, tt as BrowserSpanEventType, u as DEFAULT_URL_DENYLIST, v as flatJsonStringify, x as createIdentityTagger, y as extractCode, z as MessageLevel } from "./urlAttributes-DSPpBmH-.cjs";
+import { $ as TracesEnvelope, A as Attributes, B as MessageLevel, C as convertToError, D as assert, E as assertKey, F as EntryPointType, G as SamplingContext, H as OtelSpan, I as Framework, J as SpanEvent, K as SdkInfo, L as Glow, M as BufferedSpan, N as Config, O as AnyValue, P as EntryPointHandler, Q as StackFrame, R as KeyValue, S as createIdentityTagger, U as OverriddenGrouping, V as OtelLogRecord, W as Report, X as SpanStatus, Y as SpanOptions, Z as SpanStatusCode, at as FrameworkName, b as extractCode, c as RejectionReporter, d as DEFAULT_URL_DENYLIST, et as TracesSampler, f as redactObjectValues, g as now, h as safeDecode, it as SpanTypeName, j as BufferedLog, k as AttributeValue, l as describeRejectionReason, m as resolveDenylist, n as urlAttributes, nt as BrowserSpanEventType, o as SafeCloneOptions, p as redactUrlQuery, q as Span, r as toCustomContext, rt as BrowserSpanType, s as safeClone, tt as User, u as routeRejection, v as glowsToEvents, x as SdkTaggable, y as flatJsonStringify, z as LogsEnvelope } from "./urlAttributes-D0zqStcw.cjs";
 
 //#region src/api/Api.d.ts
 declare class Api {
@@ -277,6 +277,11 @@ declare class Flare {
    */
   withSpan<T>(name: string, fn: (span: Span) => T, opts?: SpanOptions): T;
   light(key?: string, debug?: boolean): this;
+  /**
+   * Turn sending on or off for consent. Off blocks errors, logs, and traces, and drops telemetry
+   * captured earlier so a later grant cannot ship it. On re-grant, flushes anything still buffered.
+   */
+  setConsent(granted: boolean): this;
   configure(config: Partial<Config>): this;
   test(): Promise<void>;
   private testInternal;
@@ -293,6 +298,11 @@ declare class Flare {
   setEntryPoint(handler: EntryPointHandler): this;
   setSdkInfo(info: SdkInfo): this;
   setFramework(framework: Framework): this;
+  /**
+   * True when a report must not be captured: consent withdrawn, or dropped by sampling. Consent is
+   * checked first, so a blocked report never runs the sampler or assembles a report (no cookie read).
+   */
+  private shouldSkipCapture;
   report(error: Error, attributes?: Attributes): Promise<void>;
   private reportInternal;
   reportSilently(error: Error, attributes?: Attributes): void;
@@ -350,7 +360,66 @@ declare class NullFileReader implements FileReader {
   read(_url: string): Promise<string | null>;
 }
 //#endregion
+//#region src/device/types.d.ts
+/** Effective connection quality. The API never reports 5g: a 5g device reports '4g'. */
+type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';
+/** Normalised device info. Every field optional: each provider fills what it reads, the mapper drops the rest. */
+type DeviceInfo = {
+  os?: {
+    name?: string;
+    version?: string;
+  };
+  runtime?: {
+    name?: string;
+    version?: string;
+  };
+  device?: {
+    type?: string;
+    model?: string;
+    memoryGb?: number;
+    cpuCores?: number;
+    screen?: {
+      width?: number;
+      height?: number;
+      scale?: number;
+    };
+  };
+  network?: {
+    effectiveType?: EffectiveConnectionType;
+    downlinkMbps?: number;
+    rttMs?: number;
+    online?: boolean;
+  };
+  app?: {
+    version?: string;
+    id?: string;
+  };
+  locale?: {
+    language?: string;
+    timezone?: string;
+  };
+};
+//#endregion
+//#region src/device/DeviceInfoProvider.d.ts
+/** The seam each platform implements to read device info. A `ContextCollector` maps it with `deviceInfoToAttributes`. */
+interface DeviceInfoProvider {
+  collect(): DeviceInfo;
+}
+/** Default for platforms with no device info. */
+declare class NullDeviceInfoProvider implements DeviceInfoProvider {
+  collect(): DeviceInfo;
+}
+//#endregion
+//#region src/device/deviceInfoToAttributes.d.ts
+/** Map `DeviceInfo` to wire attributes: flat keys plus a `context.device` card. Shared by every SDK, so keys never drift. */
+declare function deviceInfoToAttributes(info: DeviceInfo): Attributes;
+/**
+ * `context.device` card for the error UI. Rendered one level deep, so values stay scalar. Built only when
+ * a device or network signal exists (an os-only Node report gets none).
+ */
+declare function buildDeviceContextGroup(info: DeviceInfo): Record<string, AttributeValue>;
+//#endregion
 //#region src/stacktrace/createStackTrace.d.ts
 declare function createStackTrace(error: Error, debug: boolean, fileReader: FileReader): Promise<Array<StackFrame>>;
 //#endregion
-export { type ActiveSpanHolder, type AnyValue, Api, type AttributeValue, type Attributes, BrowserSpanEventType, BrowserSpanType, type BufferedLog, type BufferedSpan, type Config, type ContextCollector, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, type EntryPointHandler, type EntryPointType, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, InMemoryActiveSpanHolder, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, MAX_BREADCRUMB_URL_LENGTH, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OtelSpan, type OverriddenGrouping, type RejectionReporter, type Report, type SafeCloneOptions, type SamplingContext, Scope, type ScopeProvider, type SdkInfo, type SdkTaggable, type Span, type SpanEvent, type SpanLifecycleEvent, type SpanLifecycleListener, type SpanOptions, type SpanPhase, type SpanStatus, SpanStatusCode, type SpanTypeName, type StackFrame, Tracer, type TracerDeps, type TracesEnvelope, type TracesSampler, USER_IDENTITY_KEYS, type User, assert, assertKey, breadcrumbUrl, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };
+export { type ActiveSpanHolder, type AnyValue, Api, type AttributeValue, type Attributes, BrowserSpanEventType, BrowserSpanType, type BufferedLog, type BufferedSpan, type Config, type ContextCollector, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, type DeviceInfo, type DeviceInfoProvider, type EffectiveConnectionType, type EntryPointHandler, type EntryPointType, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, InMemoryActiveSpanHolder, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, MAX_BREADCRUMB_URL_LENGTH, type MessageLevel, NoopFlushScheduler, NullDeviceInfoProvider, NullFileReader, type OtelLogRecord, type OtelSpan, type OverriddenGrouping, type RejectionReporter, type Report, type SafeCloneOptions, type SamplingContext, Scope, type ScopeProvider, type SdkInfo, type SdkTaggable, type Span, type SpanEvent, type SpanLifecycleEvent, type SpanLifecycleListener, type SpanOptions, type SpanPhase, type SpanStatus, SpanStatusCode, type SpanTypeName, type StackFrame, Tracer, type TracerDeps, type TracesEnvelope, type TracesSampler, USER_IDENTITY_KEYS, type User, assert, assertKey, breadcrumbUrl, buildDeviceContextGroup, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, deviceInfoToAttributes, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as TracesSampler, A as BufferedLog, B as OtelLogRecord, D as AnyValue, E as assert, F as Framework, G as SdkInfo, H as OverriddenGrouping, I as Glow, J as SpanOptions, K as Span, L as KeyValue, M as Config, N as EntryPointHandler, O as AttributeValue, P as EntryPointType, Q as TracesEnvelope, R as LogsEnvelope, S as convertToError, T as assertKey, U as Report, V as OtelSpan, W as SamplingContext, X as SpanStatusCode, Y as SpanStatus, Z as StackFrame, _ as glowsToEvents, a as SafeCloneOptions, b as SdkTaggable, c as describeRejectionReason, d as redactObjectValues, et as User, f as redactUrlQuery, h as now, it as FrameworkName, j as BufferedSpan, k as Attributes, l as routeRejection, m as safeDecode, n as urlAttributes, nt as BrowserSpanType, o as safeClone, p as resolveDenylist, q as SpanEvent, r as toCustomContext, rt as SpanTypeName, s as RejectionReporter, tt as BrowserSpanEventType, u as DEFAULT_URL_DENYLIST, v as flatJsonStringify, x as createIdentityTagger, y as extractCode, z as MessageLevel } from "./urlAttributes-CYJKlJKi.mjs";
+import { $ as TracesEnvelope, A as Attributes, B as MessageLevel, C as convertToError, D as assert, E as assertKey, F as EntryPointType, G as SamplingContext, H as OtelSpan, I as Framework, J as SpanEvent, K as SdkInfo, L as Glow, M as BufferedSpan, N as Config, O as AnyValue, P as EntryPointHandler, Q as StackFrame, R as KeyValue, S as createIdentityTagger, U as OverriddenGrouping, V as OtelLogRecord, W as Report, X as SpanStatus, Y as SpanOptions, Z as SpanStatusCode, at as FrameworkName, b as extractCode, c as RejectionReporter, d as DEFAULT_URL_DENYLIST, et as TracesSampler, f as redactObjectValues, g as now, h as safeDecode, it as SpanTypeName, j as BufferedLog, k as AttributeValue, l as describeRejectionReason, m as resolveDenylist, n as urlAttributes, nt as BrowserSpanEventType, o as SafeCloneOptions, p as redactUrlQuery, q as Span, r as toCustomContext, rt as BrowserSpanType, s as safeClone, tt as User, u as routeRejection, v as glowsToEvents, x as SdkTaggable, y as flatJsonStringify, z as LogsEnvelope } from "./urlAttributes-DhkRD7pA.mjs";
 
 //#region src/api/Api.d.ts
 declare class Api {
@@ -277,6 +277,11 @@ declare class Flare {
    */
   withSpan<T>(name: string, fn: (span: Span) => T, opts?: SpanOptions): T;
   light(key?: string, debug?: boolean): this;
+  /**
+   * Turn sending on or off for consent. Off blocks errors, logs, and traces, and drops telemetry
+   * captured earlier so a later grant cannot ship it. On re-grant, flushes anything still buffered.
+   */
+  setConsent(granted: boolean): this;
   configure(config: Partial<Config>): this;
   test(): Promise<void>;
   private testInternal;
@@ -293,6 +298,11 @@ declare class Flare {
   setEntryPoint(handler: EntryPointHandler): this;
   setSdkInfo(info: SdkInfo): this;
   setFramework(framework: Framework): this;
+  /**
+   * True when a report must not be captured: consent withdrawn, or dropped by sampling. Consent is
+   * checked first, so a blocked report never runs the sampler or assembles a report (no cookie read).
+   */
+  private shouldSkipCapture;
   report(error: Error, attributes?: Attributes): Promise<void>;
   private reportInternal;
   reportSilently(error: Error, attributes?: Attributes): void;
@@ -350,7 +360,66 @@ declare class NullFileReader implements FileReader {
   read(_url: string): Promise<string | null>;
 }
 //#endregion
+//#region src/device/types.d.ts
+/** Effective connection quality. The API never reports 5g: a 5g device reports '4g'. */
+type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';
+/** Normalised device info. Every field optional: each provider fills what it reads, the mapper drops the rest. */
+type DeviceInfo = {
+  os?: {
+    name?: string;
+    version?: string;
+  };
+  runtime?: {
+    name?: string;
+    version?: string;
+  };
+  device?: {
+    type?: string;
+    model?: string;
+    memoryGb?: number;
+    cpuCores?: number;
+    screen?: {
+      width?: number;
+      height?: number;
+      scale?: number;
+    };
+  };
+  network?: {
+    effectiveType?: EffectiveConnectionType;
+    downlinkMbps?: number;
+    rttMs?: number;
+    online?: boolean;
+  };
+  app?: {
+    version?: string;
+    id?: string;
+  };
+  locale?: {
+    language?: string;
+    timezone?: string;
+  };
+};
+//#endregion
+//#region src/device/DeviceInfoProvider.d.ts
+/** The seam each platform implements to read device info. A `ContextCollector` maps it with `deviceInfoToAttributes`. */
+interface DeviceInfoProvider {
+  collect(): DeviceInfo;
+}
+/** Default for platforms with no device info. */
+declare class NullDeviceInfoProvider implements DeviceInfoProvider {
+  collect(): DeviceInfo;
+}
+//#endregion
+//#region src/device/deviceInfoToAttributes.d.ts
+/** Map `DeviceInfo` to wire attributes: flat keys plus a `context.device` card. Shared by every SDK, so keys never drift. */
+declare function deviceInfoToAttributes(info: DeviceInfo): Attributes;
+/**
+ * `context.device` card for the error UI. Rendered one level deep, so values stay scalar. Built only when
+ * a device or network signal exists (an os-only Node report gets none).
+ */
+declare function buildDeviceContextGroup(info: DeviceInfo): Record<string, AttributeValue>;
+//#endregion
 //#region src/stacktrace/createStackTrace.d.ts
 declare function createStackTrace(error: Error, debug: boolean, fileReader: FileReader): Promise<Array<StackFrame>>;
 //#endregion
-export { type ActiveSpanHolder, type AnyValue, Api, type AttributeValue, type Attributes, BrowserSpanEventType, BrowserSpanType, type BufferedLog, type BufferedSpan, type Config, type ContextCollector, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, type EntryPointHandler, type EntryPointType, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, InMemoryActiveSpanHolder, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, MAX_BREADCRUMB_URL_LENGTH, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OtelSpan, type OverriddenGrouping, type RejectionReporter, type Report, type SafeCloneOptions, type SamplingContext, Scope, type ScopeProvider, type SdkInfo, type SdkTaggable, type Span, type SpanEvent, type SpanLifecycleEvent, type SpanLifecycleListener, type SpanOptions, type SpanPhase, type SpanStatus, SpanStatusCode, type SpanTypeName, type StackFrame, Tracer, type TracerDeps, type TracesEnvelope, type TracesSampler, USER_IDENTITY_KEYS, type User, assert, assertKey, breadcrumbUrl, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };
+export { type ActiveSpanHolder, type AnyValue, Api, type AttributeValue, type Attributes, BrowserSpanEventType, BrowserSpanType, type BufferedLog, type BufferedSpan, type Config, type ContextCollector, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, type DeviceInfo, type DeviceInfoProvider, type EffectiveConnectionType, type EntryPointHandler, type EntryPointType, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, InMemoryActiveSpanHolder, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, MAX_BREADCRUMB_URL_LENGTH, type MessageLevel, NoopFlushScheduler, NullDeviceInfoProvider, NullFileReader, type OtelLogRecord, type OtelSpan, type OverriddenGrouping, type RejectionReporter, type Report, type SafeCloneOptions, type SamplingContext, Scope, type ScopeProvider, type SdkInfo, type SdkTaggable, type Span, type SpanEvent, type SpanLifecycleEvent, type SpanLifecycleListener, type SpanOptions, type SpanPhase, type SpanStatus, SpanStatusCode, type SpanTypeName, type StackFrame, Tracer, type TracerDeps, type TracesEnvelope, type TracesSampler, USER_IDENTITY_KEYS, type User, assert, assertKey, breadcrumbUrl, buildDeviceContextGroup, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, deviceInfoToAttributes, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { D as CLIENT_VERSION, E as assert, O as KEY, S as convertToError, T as assertKey, _ as TRUNCATED, a as routeRejection, b as extractCode, c as redactUrlQuery, d as now, f as timelineEvents, g as MAX_TRAVERSAL_DEPTH, h as safeClone, i as describeRejectionReason, k as SOURCEMAP_VERSION, l as resolveDenylist, m as flatJsonStringify, n as urlAttributes, o as DEFAULT_URL_DENYLIST, p as glowsToEvents, r as toCustomContext, s as redactObjectValues, u as safeDecode, v as createTraversalBudget, x as createIdentityTagger, y as spendNode } from "./urlAttributes-qNkR9fIF.mjs";
+import { A as SOURCEMAP_VERSION, C as convertToError, D as assert, E as assertKey, O as CLIENT_VERSION, S as createIdentityTagger, _ as MAX_TRAVERSAL_DEPTH, a as describeRejectionReason, b as spendNode, c as redactObjectValues, d as safeDecode, f as now, g as safeClone, h as flatJsonStringify, i as setDefined, k as KEY, l as redactUrlQuery, m as glowsToEvents, n as urlAttributes, o as routeRejection, p as timelineEvents, r as toCustomContext, s as DEFAULT_URL_DENYLIST, u as resolveDenylist, v as TRUNCATED, x as extractCode, y as createTraversalBudget } from "./urlAttributes-DmpMd_4O.mjs";
 import ErrorStackParser from "error-stack-parser";
 
 //#region src/framework.ts
@@ -191,6 +191,7 @@ var TelemetryBuffer = class {
 	}
 	add(record) {
 		const config = this.deps.getConfig();
+		if (config.hasConsent === false) return;
 		const limits = this.policy.limits(config);
 		const bytes = this.policy.estimateBytes(record);
 		if (bytes > limits.maxBytes) {
@@ -210,6 +211,10 @@ var TelemetryBuffer = class {
 		const config = this.deps.getConfig();
 		if (!this.policy.enabled(config)) return;
 		if (this.entries.length === 0) return;
+		if (config.hasConsent === false) {
+			this.clearTimer();
+			return;
+		}
 		if (!assertKey(config.key, config.debug)) {
 			this.clearTimer();
 			return;
@@ -545,6 +550,7 @@ var Logger = class {
 	}
 	record(level, message, context, attributes) {
 		const config = this.deps.getConfig();
+		if (config.hasConsent === false) return;
 		if (!config.enableLogs) return;
 		if (config.minimumLogLevel && !isAtOrAboveMinimum(level, config.minimumLogLevel)) return;
 		const userAttributes = {
@@ -583,6 +589,8 @@ const RESOURCE_PREFIXES = [
 	"host.",
 	"os.",
 	"process.",
+	"device.",
+	"network.",
 	"flare.framework.",
 	"flare.language."
 ];
@@ -1412,6 +1420,7 @@ var Flare = class {
 	_tracer;
 	_config = {
 		key: null,
+		hasConsent: true,
 		version: "",
 		sourcemapVersionId: SOURCEMAP_VERSION,
 		stage: "",
@@ -1553,6 +1562,21 @@ var Flare = class {
 		this._tracer.flush();
 		return this;
 	}
+	/**
+	* Turn sending on or off for consent. Off blocks errors, logs, and traces, and drops telemetry
+	* captured earlier so a later grant cannot ship it. On re-grant, flushes anything still buffered.
+	*/
+	setConsent(granted) {
+		this._config.hasConsent = granted;
+		if (granted) {
+			this._logger.flush();
+			this._tracer.flush();
+		} else {
+			this._logger.clear();
+			this._tracer.clear();
+		}
+		return this;
+	}
 	configure(config) {
 		const wasLogsEnabled = this._config.enableLogs;
 		const wasTracingEnabled = this._config.enableTracing;
@@ -1639,11 +1663,19 @@ var Flare = class {
 		this.framework = framework;
 		return this;
 	}
+	/**
+	* True when a report must not be captured: consent withdrawn, or dropped by sampling. Consent is
+	* checked first, so a blocked report never runs the sampler or assembles a report (no cookie read).
+	*/
+	shouldSkipCapture() {
+		if (this._config.hasConsent === false) return true;
+		return this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate;
+	}
 	report(error, attributes = {}) {
 		return this.track(this.reportInternal(error, attributes));
 	}
 	async reportInternal(error, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const coerced = error instanceof Error ? error : new Error(String(error));
 		const errorToReport = await this._config.beforeEvaluate(coerced);
@@ -1659,7 +1691,7 @@ var Flare = class {
 		return this.track(this.reportUnhandledRejectionInternal(message, attributes));
 	}
 	async reportUnhandledRejectionInternal(message, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const report = this.buildReport({
 			exceptionClass: "UnhandledRejection",
@@ -1677,7 +1709,7 @@ var Flare = class {
 		return this.track(this.reportMessageInternal(message, level, attributes));
 	}
 	async reportMessageInternal(message, level, attributes = {}) {
-		if (this._config.sampleRate < 1 && Math.random() >= this._config.sampleRate) return;
+		if (this.shouldSkipCapture()) return;
 		const seenAtUnixNano = Date.now() * 1e6;
 		const stackTrace = await createStackTrace(/* @__PURE__ */ new Error(), this._config.debug, this.fileReader);
 		stackTrace.shift();
@@ -1794,6 +1826,7 @@ var Flare = class {
 		return report;
 	}
 	async sendReport(report) {
+		if (this._config.hasConsent === false) return;
 		if (!assertKey(this._config.key, this._config.debug)) return;
 		const reportToSubmit = await this._config.beforeSubmit(report);
 		if (!reportToSubmit) return;
@@ -1802,4 +1835,71 @@ var Flare = class {
 };
 
 //#endregion
-export { Api, BrowserSpanEventType, BrowserSpanType, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, Flare, FrameworkName, GlobalScopeProvider, InMemoryActiveSpanHolder, Logger, MAX_BREADCRUMB_URL_LENGTH, NoopFlushScheduler, NullFileReader, Scope, SpanStatusCode, Tracer, USER_IDENTITY_KEYS, assert, assertKey, breadcrumbUrl, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };
+//#region src/device/DeviceInfoProvider.ts
+/** Default for platforms with no device info. */
+var NullDeviceInfoProvider = class {
+	collect() {
+		return {};
+	}
+};
+
+//#endregion
+//#region src/device/deviceInfoToAttributes.ts
+/** Map `DeviceInfo` to wire attributes: flat keys plus a `context.device` card. Shared by every SDK, so keys never drift. */
+function deviceInfoToAttributes(info) {
+	const attrs = {};
+	setDefined(attrs, "os.name", info.os?.name);
+	setDefined(attrs, "os.version", info.os?.version);
+	setDefined(attrs, "process.runtime.name", info.runtime?.name);
+	setDefined(attrs, "process.runtime.version", info.runtime?.version);
+	setDefined(attrs, "device.type", info.device?.type);
+	setDefined(attrs, "device.model.name", info.device?.model);
+	setDefined(attrs, "device.memory_gb", info.device?.memoryGb);
+	setDefined(attrs, "device.cpu_cores", info.device?.cpuCores);
+	setDefined(attrs, "device.screen.width", info.device?.screen?.width);
+	setDefined(attrs, "device.screen.height", info.device?.screen?.height);
+	setDefined(attrs, "device.screen.scale", info.device?.screen?.scale);
+	setDefined(attrs, "network.effective_type", info.network?.effectiveType);
+	setDefined(attrs, "network.downlink_mbps", info.network?.downlinkMbps);
+	setDefined(attrs, "network.rtt_ms", info.network?.rttMs);
+	setDefined(attrs, "network.online", info.network?.online);
+	setDefined(attrs, "app.version", info.app?.version);
+	setDefined(attrs, "app.id", info.app?.id);
+	const group = buildDeviceContextGroup(info);
+	if (Object.keys(group).length > 0) attrs["context.device"] = group;
+	return attrs;
+}
+/**
+* `context.device` card for the error UI. Rendered one level deep, so values stay scalar. Built only when
+* a device or network signal exists (an os-only Node report gets none).
+*/
+function buildDeviceContextGroup(info) {
+	if (!hasDeviceSignal(info.device) && !hasNetworkSignal(info.network)) return {};
+	const group = {};
+	const os = [info.os?.name, info.os?.version].filter((value) => value != null).join(" ");
+	if (os) group.OS = os;
+	setDefined(group, "Model", info.device?.model);
+	setDefined(group, "Type", info.device?.type);
+	const screen = info.device?.screen;
+	if (screen?.width != null && screen?.height != null) group.Screen = screen.scale != null ? `${screen.width} × ${screen.height} @ ${screen.scale}x` : `${screen.width} × ${screen.height}`;
+	if (info.device?.memoryGb != null) group.Memory = `${info.device.memoryGb} GB`;
+	setDefined(group, "CPU cores", info.device?.cpuCores);
+	setDefined(group, "Connection", info.network?.effectiveType);
+	if (info.network?.downlinkMbps != null) group.Downlink = `${info.network.downlinkMbps} Mbps`;
+	if (info.network?.rttMs != null) group.RTT = `${info.network.rttMs} ms`;
+	setDefined(group, "Online", info.network?.online);
+	setDefined(group, "App version", info.app?.version);
+	setDefined(group, "App ID", info.app?.id);
+	setDefined(group, "Language", info.locale?.language);
+	setDefined(group, "Timezone", info.locale?.timezone);
+	return group;
+}
+function hasDeviceSignal(device) {
+	return device != null && (device.type != null || device.model != null || device.memoryGb != null || device.cpuCores != null || device.screen?.width != null || device.screen?.height != null);
+}
+function hasNetworkSignal(network) {
+	return network != null && (network.effectiveType != null || network.downlinkMbps != null || network.rttMs != null || network.online != null);
+}
+
+//#endregion
+export { Api, BrowserSpanEventType, BrowserSpanType, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, Flare, FrameworkName, GlobalScopeProvider, InMemoryActiveSpanHolder, Logger, MAX_BREADCRUMB_URL_LENGTH, NoopFlushScheduler, NullDeviceInfoProvider, NullFileReader, Scope, SpanStatusCode, Tracer, USER_IDENTITY_KEYS, assert, assertKey, breadcrumbUrl, buildDeviceContextGroup, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, deviceInfoToAttributes, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, recordBreadcrumb, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };

package/dist/{urlAttributes-CEP6bOBn.cjs → urlAttributes-Cinqzwjy.cjs}

@@ -1,6 +1,6 @@
 
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.9.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.11.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -351,6 +351,13 @@ function routeRejection(reporter, reason) {
 	Promise.resolve(reporter.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
 }
 
+//#endregion
+//#region src/util/setDefined.ts
+/** Assign the value only when it is neither undefined nor null. */
+function setDefined(target, key, value) {
+	if (value !== void 0 && value !== null) target[key] = value;
+}
+
 //#endregion
 //#region src/util/toCustomContext.ts
 /** Wraps a framework payload as the `context.custom` attribute a report expects. */
@@ -534,6 +541,12 @@ Object.defineProperty(exports, 'safeDecode', {
     return safeDecode;
   }
 });
+Object.defineProperty(exports, 'setDefined', {
+  enumerable: true,
+  get: function () {
+    return setDefined;
+  }
+});
 Object.defineProperty(exports, 'spendNode', {
   enumerable: true,
   get: function () {

package/dist/{urlAttributes-CYJKlJKi.d.mts → urlAttributes-D0zqStcw.d.cts}

@@ -65,6 +65,9 @@ type User = {
 };
 type Config = {
   key: string | null;
+  /** When false, the SDK sends nothing: no errors, logs, or traces. Flip it with `setConsent()`.
+   *  Default true, so setups without a consent tool are unchanged. */
+  hasConsent: boolean;
   version: string;
   sourcemapVersionId: string;
   stage: string;
@@ -434,6 +437,10 @@ type SafeCloneOptions = {
  */
 declare function safeClone(value: unknown, options: SafeCloneOptions): unknown;
 //#endregion
+//#region src/util/setDefined.d.ts
+/** Assign the value only when it is neither undefined nor null. */
+declare function setDefined(target: Attributes, key: string, value: AttributeValue | undefined): void;
+//#endregion
 //#region src/util/statelessRegExp.d.ts
 /**
  * A `/g` or `/y` regex carries `lastIndex` between `test()` calls, so every other call misses. Returns
@@ -460,4 +467,4 @@ declare const MAX_URL_LENGTH = 2048;
  */
 declare function urlAttributes(url: string, denylist?: RegExp): Attributes;
 //#endregion
-export { TracesSampler as $, BufferedLog as A, OtelLogRecord as B, ProfileComponentsOption as C, AnyValue as D, assert as E, Framework as F, SdkInfo as G, OverriddenGrouping as H, Glow as I, SpanOptions as J, Span as K, KeyValue as L, Config as M, EntryPointHandler as N, AttributeValue as O, EntryPointType as P, TracesEnvelope as Q, LogsEnvelope as R, convertToError as S, assertKey as T, Report as U, OtelSpan as V, SamplingContext as W, SpanStatusCode as X, SpanStatus as Y, StackFrame as Z, glowsToEvents as _, SafeCloneOptions as a, SdkTaggable as b, describeRejectionReason as c, redactObjectValues as d, User as et, redactUrlQuery as f, timelineEvents as g, now as h, withoutStatefulFlags as i, FrameworkName as it, BufferedSpan as j, Attributes as k, routeRejection as l, safeDecode as m, urlAttributes as n, BrowserSpanType as nt, safeClone as o, resolveDenylist as p, SpanEvent as q, toCustomContext as r, SpanTypeName as rt, RejectionReporter as s, MAX_URL_LENGTH as t, BrowserSpanEventType as tt, DEFAULT_URL_DENYLIST as u, flatJsonStringify as v, createComponentMatcher as w, createIdentityTagger as x, extractCode as y, MessageLevel as z };
+export { TracesEnvelope as $, Attributes as A, MessageLevel as B, convertToError as C, assert as D, assertKey as E, EntryPointType as F, SamplingContext as G, OtelSpan as H, Framework as I, SpanEvent as J, SdkInfo as K, Glow as L, BufferedSpan as M, Config as N, AnyValue as O, EntryPointHandler as P, StackFrame as Q, KeyValue as R, createIdentityTagger as S, createComponentMatcher as T, OverriddenGrouping as U, OtelLogRecord as V, Report as W, SpanStatus as X, SpanOptions as Y, SpanStatusCode as Z, timelineEvents as _, setDefined as a, FrameworkName as at, extractCode as b, RejectionReporter as c, DEFAULT_URL_DENYLIST as d, TracesSampler as et, redactObjectValues as f, now as g, safeDecode as h, withoutStatefulFlags as i, SpanTypeName as it, BufferedLog as j, AttributeValue as k, describeRejectionReason as l, resolveDenylist as m, urlAttributes as n, BrowserSpanEventType as nt, SafeCloneOptions as o, redactUrlQuery as p, Span as q, toCustomContext as r, BrowserSpanType as rt, safeClone as s, MAX_URL_LENGTH as t, User as tt, routeRejection as u, glowsToEvents as v, ProfileComponentsOption as w, SdkTaggable as x, flatJsonStringify as y, LogsEnvelope as z };

package/dist/{urlAttributes-DSPpBmH-.d.cts → urlAttributes-DhkRD7pA.d.mts}

@@ -65,6 +65,9 @@ type User = {
 };
 type Config = {
   key: string | null;
+  /** When false, the SDK sends nothing: no errors, logs, or traces. Flip it with `setConsent()`.
+   *  Default true, so setups without a consent tool are unchanged. */
+  hasConsent: boolean;
   version: string;
   sourcemapVersionId: string;
   stage: string;
@@ -434,6 +437,10 @@ type SafeCloneOptions = {
  */
 declare function safeClone(value: unknown, options: SafeCloneOptions): unknown;
 //#endregion
+//#region src/util/setDefined.d.ts
+/** Assign the value only when it is neither undefined nor null. */
+declare function setDefined(target: Attributes, key: string, value: AttributeValue | undefined): void;
+//#endregion
 //#region src/util/statelessRegExp.d.ts
 /**
  * A `/g` or `/y` regex carries `lastIndex` between `test()` calls, so every other call misses. Returns
@@ -460,4 +467,4 @@ declare const MAX_URL_LENGTH = 2048;
  */
 declare function urlAttributes(url: string, denylist?: RegExp): Attributes;
 //#endregion
-export { TracesSampler as $, BufferedLog as A, OtelLogRecord as B, ProfileComponentsOption as C, AnyValue as D, assert as E, Framework as F, SdkInfo as G, OverriddenGrouping as H, Glow as I, SpanOptions as J, Span as K, KeyValue as L, Config as M, EntryPointHandler as N, AttributeValue as O, EntryPointType as P, TracesEnvelope as Q, LogsEnvelope as R, convertToError as S, assertKey as T, Report as U, OtelSpan as V, SamplingContext as W, SpanStatusCode as X, SpanStatus as Y, StackFrame as Z, glowsToEvents as _, SafeCloneOptions as a, SdkTaggable as b, describeRejectionReason as c, redactObjectValues as d, User as et, redactUrlQuery as f, timelineEvents as g, now as h, withoutStatefulFlags as i, FrameworkName as it, BufferedSpan as j, Attributes as k, routeRejection as l, safeDecode as m, urlAttributes as n, BrowserSpanType as nt, safeClone as o, resolveDenylist as p, SpanEvent as q, toCustomContext as r, SpanTypeName as rt, RejectionReporter as s, MAX_URL_LENGTH as t, BrowserSpanEventType as tt, DEFAULT_URL_DENYLIST as u, flatJsonStringify as v, createComponentMatcher as w, createIdentityTagger as x, extractCode as y, MessageLevel as z };
+export { TracesEnvelope as $, Attributes as A, MessageLevel as B, convertToError as C, assert as D, assertKey as E, EntryPointType as F, SamplingContext as G, OtelSpan as H, Framework as I, SpanEvent as J, SdkInfo as K, Glow as L, BufferedSpan as M, Config as N, AnyValue as O, EntryPointHandler as P, StackFrame as Q, KeyValue as R, createIdentityTagger as S, createComponentMatcher as T, OverriddenGrouping as U, OtelLogRecord as V, Report as W, SpanStatus as X, SpanOptions as Y, SpanStatusCode as Z, timelineEvents as _, setDefined as a, FrameworkName as at, extractCode as b, RejectionReporter as c, DEFAULT_URL_DENYLIST as d, TracesSampler as et, redactObjectValues as f, now as g, safeDecode as h, withoutStatefulFlags as i, SpanTypeName as it, BufferedLog as j, AttributeValue as k, describeRejectionReason as l, resolveDenylist as m, urlAttributes as n, BrowserSpanEventType as nt, SafeCloneOptions as o, redactUrlQuery as p, Span as q, toCustomContext as r, BrowserSpanType as rt, safeClone as s, MAX_URL_LENGTH as t, User as tt, routeRejection as u, glowsToEvents as v, ProfileComponentsOption as w, SdkTaggable as x, flatJsonStringify as y, LogsEnvelope as z };

package/dist/{urlAttributes-qNkR9fIF.mjs → urlAttributes-DmpMd_4O.mjs}

@@ -1,5 +1,5 @@
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.9.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.11.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -350,6 +350,13 @@ function routeRejection(reporter, reason) {
 	Promise.resolve(reporter.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
 }
 
+//#endregion
+//#region src/util/setDefined.ts
+/** Assign the value only when it is neither undefined nor null. */
+function setDefined(target, key, value) {
+	if (value !== void 0 && value !== null) target[key] = value;
+}
+
 //#endregion
 //#region src/util/toCustomContext.ts
 /** Wraps a framework payload as the `context.custom` attribute a report expects. */
@@ -389,4 +396,4 @@ function urlAttributes(url, denylist = DEFAULT_URL_DENYLIST) {
 }
 
 //#endregion
-export { createComponentMatcher as C, CLIENT_VERSION as D, assert as E, KEY as O, convertToError as S, assertKey as T, TRUNCATED as _, routeRejection as a, extractCode as b, redactUrlQuery as c, now as d, timelineEvents as f, MAX_TRAVERSAL_DEPTH as g, safeClone as h, describeRejectionReason as i, SOURCEMAP_VERSION as k, resolveDenylist as l, flatJsonStringify as m, urlAttributes as n, DEFAULT_URL_DENYLIST as o, glowsToEvents as p, toCustomContext as r, redactObjectValues as s, MAX_URL_LENGTH as t, safeDecode as u, createTraversalBudget as v, withoutStatefulFlags as w, createIdentityTagger as x, spendNode as y };
+export { SOURCEMAP_VERSION as A, convertToError as C, assert as D, assertKey as E, CLIENT_VERSION as O, createIdentityTagger as S, withoutStatefulFlags as T, MAX_TRAVERSAL_DEPTH as _, describeRejectionReason as a, spendNode as b, redactObjectValues as c, safeDecode as d, now as f, safeClone as g, flatJsonStringify as h, setDefined as i, KEY as k, redactUrlQuery as l, glowsToEvents as m, urlAttributes as n, routeRejection as o, timelineEvents as p, toCustomContext as r, DEFAULT_URL_DENYLIST as s, MAX_URL_LENGTH as t, resolveDenylist as u, TRUNCATED as v, createComponentMatcher as w, extractCode as x, createTraversalBudget as y };

package/dist/util/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_urlAttributes = require('../urlAttributes-CEP6bOBn.cjs');
+const require_urlAttributes = require('../urlAttributes-Cinqzwjy.cjs');
 
 exports.DEFAULT_URL_DENYLIST = require_urlAttributes.DEFAULT_URL_DENYLIST;
 exports.MAX_URL_LENGTH = require_urlAttributes.MAX_URL_LENGTH;
@@ -19,6 +19,7 @@ exports.resolveDenylist = require_urlAttributes.resolveDenylist;
 exports.routeRejection = require_urlAttributes.routeRejection;
 exports.safeClone = require_urlAttributes.safeClone;
 exports.safeDecode = require_urlAttributes.safeDecode;
+exports.setDefined = require_urlAttributes.setDefined;
 exports.timelineEvents = require_urlAttributes.timelineEvents;
 exports.toCustomContext = require_urlAttributes.toCustomContext;
 exports.urlAttributes = require_urlAttributes.urlAttributes;

package/dist/util/index.d.cts

@@ -1,2 +1,2 @@
-import { C as ProfileComponentsOption, E as assert, S as convertToError, T as assertKey, _ as glowsToEvents, a as SafeCloneOptions, b as SdkTaggable, c as describeRejectionReason, d as redactObjectValues, f as redactUrlQuery, g as timelineEvents, h as now, i as withoutStatefulFlags, l as routeRejection, m as safeDecode, n as urlAttributes, o as safeClone, p as resolveDenylist, r as toCustomContext, s as RejectionReporter, t as MAX_URL_LENGTH, u as DEFAULT_URL_DENYLIST, v as flatJsonStringify, w as createComponentMatcher, x as createIdentityTagger, y as extractCode } from "../urlAttributes-DSPpBmH-.cjs";
-export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };
+import { C as convertToError, D as assert, E as assertKey, S as createIdentityTagger, T as createComponentMatcher, _ as timelineEvents, a as setDefined, b as extractCode, c as RejectionReporter, d as DEFAULT_URL_DENYLIST, f as redactObjectValues, g as now, h as safeDecode, i as withoutStatefulFlags, l as describeRejectionReason, m as resolveDenylist, n as urlAttributes, o as SafeCloneOptions, p as redactUrlQuery, r as toCustomContext, s as safeClone, t as MAX_URL_LENGTH, u as routeRejection, v as glowsToEvents, w as ProfileComponentsOption, x as SdkTaggable, y as flatJsonStringify } from "../urlAttributes-D0zqStcw.cjs";
+export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, setDefined, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };

package/dist/util/index.d.mts

@@ -1,2 +1,2 @@
-import { C as ProfileComponentsOption, E as assert, S as convertToError, T as assertKey, _ as glowsToEvents, a as SafeCloneOptions, b as SdkTaggable, c as describeRejectionReason, d as redactObjectValues, f as redactUrlQuery, g as timelineEvents, h as now, i as withoutStatefulFlags, l as routeRejection, m as safeDecode, n as urlAttributes, o as safeClone, p as resolveDenylist, r as toCustomContext, s as RejectionReporter, t as MAX_URL_LENGTH, u as DEFAULT_URL_DENYLIST, v as flatJsonStringify, w as createComponentMatcher, x as createIdentityTagger, y as extractCode } from "../urlAttributes-CYJKlJKi.mjs";
-export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };
+import { C as convertToError, D as assert, E as assertKey, S as createIdentityTagger, T as createComponentMatcher, _ as timelineEvents, a as setDefined, b as extractCode, c as RejectionReporter, d as DEFAULT_URL_DENYLIST, f as redactObjectValues, g as now, h as safeDecode, i as withoutStatefulFlags, l as describeRejectionReason, m as resolveDenylist, n as urlAttributes, o as SafeCloneOptions, p as redactUrlQuery, r as toCustomContext, s as safeClone, t as MAX_URL_LENGTH, u as routeRejection, v as glowsToEvents, w as ProfileComponentsOption, x as SdkTaggable, y as flatJsonStringify } from "../urlAttributes-DhkRD7pA.mjs";
+export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, setDefined, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };

package/dist/util/index.mjs

@@ -1,3 +1,3 @@
-import { C as createComponentMatcher, E as assert, S as convertToError, T as assertKey, a as routeRejection, b as extractCode, c as redactUrlQuery, d as now, f as timelineEvents, h as safeClone, i as describeRejectionReason, l as resolveDenylist, m as flatJsonStringify, n as urlAttributes, o as DEFAULT_URL_DENYLIST, p as glowsToEvents, r as toCustomContext, s as redactObjectValues, t as MAX_URL_LENGTH, u as safeDecode, w as withoutStatefulFlags, x as createIdentityTagger } from "../urlAttributes-qNkR9fIF.mjs";
+import { C as convertToError, D as assert, E as assertKey, S as createIdentityTagger, T as withoutStatefulFlags, a as describeRejectionReason, c as redactObjectValues, d as safeDecode, f as now, g as safeClone, h as flatJsonStringify, i as setDefined, l as redactUrlQuery, m as glowsToEvents, n as urlAttributes, o as routeRejection, p as timelineEvents, r as toCustomContext, s as DEFAULT_URL_DENYLIST, t as MAX_URL_LENGTH, u as resolveDenylist, w as createComponentMatcher, x as extractCode } from "../urlAttributes-DmpMd_4O.mjs";
 
-export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };
+export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, setDefined, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/core",
-    "version": "2.9.0",
+    "version": "2.11.0",
     "description": "Environment-agnostic core for the Flare JS SDK",
     "homepage": "https://flareapp.io",
     "bugs": {