@flareapp/core 2.8.0 → 2.10.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-CNGTgOJp.cjs');
+const require_urlAttributes = require('./urlAttributes-B37JykP3.cjs');
 let error_stack_parser = require("error-stack-parser");
 error_stack_parser = __toESM(error_stack_parser);
 
@@ -66,6 +66,11 @@ const BrowserSpanType = {
 	Component: "browser_component",
 	WebVital: "browser_web_vital"
 };
+const BrowserSpanEventType = {
+	Click: "browser_click",
+	Input: "browser_input",
+	RouteChange: "browser_route_change"
+};
 
 //#endregion
 //#region src/types.ts
@@ -175,6 +180,23 @@ var Api = class {
 	}
 };
 
+//#endregion
+//#region src/breadcrumbs/recordBreadcrumb.ts
+const MAX_BREADCRUMB_URL_LENGTH = 256;
+function breadcrumbUrl(href, denylist) {
+	const redacted = require_urlAttributes.redactUrlQuery(href, denylist);
+	return redacted.length > MAX_BREADCRUMB_URL_LENGTH ? redacted.slice(0, MAX_BREADCRUMB_URL_LENGTH) : redacted;
+}
+function recordBreadcrumb(scopeProvider, config, type, attributes, startTimeUnixNano) {
+	if (!config.enableBreadcrumbs) return;
+	scopeProvider.active().addBreadcrumb({
+		type,
+		startTimeUnixNano,
+		endTimeUnixNano: null,
+		attributes
+	}, config.maxBreadcrumbs);
+}
+
 //#endregion
 //#region src/telemetry/TelemetryBuffer.ts
 /**
@@ -198,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) {
@@ -217,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;
@@ -552,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 = {
@@ -633,6 +661,7 @@ function userIdentityAttributes(scope) {
 */
 var Scope = class {
 	glows = [];
+	breadcrumbs = [];
 	pendingAttributes = {};
 	entryPoint = null;
 	/** Caps at `maxGlowsPerReport` by dropping the oldest, so the payload stays bounded. */
@@ -643,6 +672,15 @@ var Scope = class {
 	clearGlows() {
 		this.glows = [];
 	}
+	/** Drops the oldest when full. */
+	addBreadcrumb(breadcrumb, maxBreadcrumbs) {
+		if (maxBreadcrumbs <= 0) return;
+		this.breadcrumbs.push(breadcrumb);
+		if (this.breadcrumbs.length > maxBreadcrumbs) this.breadcrumbs = this.breadcrumbs.slice(this.breadcrumbs.length - maxBreadcrumbs);
+	}
+	clearBreadcrumbs() {
+		this.breadcrumbs = [];
+	}
 	setAttribute(key, value) {
 		this.pendingAttributes[key] = value;
 	}
@@ -1409,10 +1447,13 @@ var Flare = class {
 	_tracer;
 	_config = {
 		key: null,
+		hasConsent: true,
 		version: "",
 		sourcemapVersionId: require_urlAttributes.SOURCEMAP_VERSION,
 		stage: "",
 		maxGlowsPerReport: 30,
+		enableBreadcrumbs: false,
+		maxBreadcrumbs: 100,
 		ingestUrl: "https://ingress.flareapp.io/v1/errors",
 		reportBrowserExtensionErrors: false,
 		debug: false,
@@ -1548,9 +1589,25 @@ 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;
+		const wasBreadcrumbsEnabled = this._config.enableBreadcrumbs;
 		this._config = {
 			...this._config,
 			...config
@@ -1560,6 +1617,7 @@ var Flare = class {
 		if (config.urlDenylist !== void 0 || config.replaceDefaultUrlDenylist !== void 0) this._config.urlDenylist = require_urlAttributes.resolveDenylist(config.urlDenylist, config.replaceDefaultUrlDenylist ?? this._config.replaceDefaultUrlDenylist);
 		if (wasLogsEnabled && this._config.enableLogs === false) this._logger.clear();
 		if (config.key !== void 0) this._logger.flush();
+		if (wasBreadcrumbsEnabled && this._config.enableBreadcrumbs === false) this.scopeProvider.active().clearBreadcrumbs();
 		if (wasTracingEnabled && this._config.enableTracing === false) this._tracer.clear();
 		if (config.key !== void 0) this._tracer.flush();
 		return this;
@@ -1583,6 +1641,9 @@ var Flare = class {
 		}, this._config.maxGlowsPerReport);
 		return this;
 	}
+	addBreadcrumb(type, attributes, startTimeUnixNano) {
+		recordBreadcrumb(this.scopeProvider, this._config, type, attributes, startTimeUnixNano);
+	}
 	clearGlows() {
 		this.scopeProvider.active().clearGlows();
 		return this;
@@ -1629,11 +1690,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);
@@ -1649,7 +1718,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",
@@ -1667,7 +1736,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();
@@ -1774,7 +1843,7 @@ var Flare = class {
 			message: input.message,
 			seenAtUnixNano: input.seenAtUnixNano,
 			stacktrace: input.stacktrace,
-			events: require_urlAttributes.glowsToEvents(activeScope.glows),
+			events: require_urlAttributes.timelineEvents(activeScope.glows, activeScope.breadcrumbs),
 			attributes
 		};
 		if (input.isLog) report.isLog = true;
@@ -1784,6 +1853,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;
@@ -1793,6 +1863,7 @@ var Flare = class {
 
 //#endregion
 exports.Api = Api;
+exports.BrowserSpanEventType = BrowserSpanEventType;
 exports.BrowserSpanType = BrowserSpanType;
 exports.DEFAULT_MAX_LIVE_TRACES = DEFAULT_MAX_LIVE_TRACES;
 exports.DEFAULT_URL_DENYLIST = require_urlAttributes.DEFAULT_URL_DENYLIST;
@@ -1801,6 +1872,7 @@ exports.FrameworkName = FrameworkName;
 exports.GlobalScopeProvider = GlobalScopeProvider;
 exports.InMemoryActiveSpanHolder = InMemoryActiveSpanHolder;
 exports.Logger = Logger;
+exports.MAX_BREADCRUMB_URL_LENGTH = MAX_BREADCRUMB_URL_LENGTH;
 exports.NoopFlushScheduler = NoopFlushScheduler;
 exports.NullFileReader = NullFileReader;
 exports.Scope = Scope;
@@ -1809,6 +1881,7 @@ exports.Tracer = Tracer;
 exports.USER_IDENTITY_KEYS = USER_IDENTITY_KEYS;
 exports.assert = require_urlAttributes.assert;
 exports.assertKey = require_urlAttributes.assertKey;
+exports.breadcrumbUrl = breadcrumbUrl;
 exports.buildTraceparent = buildTraceparent;
 exports.buildTracesEnvelope = buildTracesEnvelope;
 exports.convertToError = require_urlAttributes.convertToError;
@@ -1823,6 +1896,7 @@ exports.glowsToEvents = require_urlAttributes.glowsToEvents;
 exports.now = require_urlAttributes.now;
 exports.parseTraceparent = parseTraceparent;
 exports.readLinesFromFile = readLinesFromFile;
+exports.recordBreadcrumb = recordBreadcrumb;
 exports.redactObjectValues = require_urlAttributes.redactObjectValues;
 exports.redactUrlQuery = require_urlAttributes.redactUrlQuery;
 exports.resolveDenylist = require_urlAttributes.resolveDenylist;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { $ as User, A as BufferedSpan, B as OtelSpan, D as AttributeValue, E as AnyValue, F as Glow, G as Span, H as Report, I as KeyValue, J as SpanStatus, K as SpanEvent, L as LogsEnvelope, M as EntryPointHandler, N as EntryPointType, O as Attributes, P as Framework, Q as TracesSampler, R as MessageLevel, T as assert, U as SamplingContext, V as OverriddenGrouping, W as SdkInfo, X as StackFrame, Y as SpanStatusCode, Z as TracesEnvelope, _ as flatJsonStringify, a as SafeCloneOptions, b as createIdentityTagger, c as describeRejectionReason, d as redactObjectValues, et as BrowserSpanType, f as redactUrlQuery, g as glowsToEvents, h as now, j as Config, k as BufferedLog, l as routeRejection, m as safeDecode, n as urlAttributes, nt as FrameworkName, o as safeClone, p as resolveDenylist, q as SpanOptions, r as toCustomContext, s as RejectionReporter, tt as SpanTypeName, u as DEFAULT_URL_DENYLIST, v as extractCode, w as assertKey, x as convertToError, y as SdkTaggable, z as OtelLogRecord } from "./urlAttributes-CvOw6tU3.cjs";
+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-DW_i-YQ3.cjs";
 
 //#region src/api/Api.d.ts
 declare class Api {
@@ -82,11 +82,15 @@ declare function userIdentityAttributes(scope: Scope): Attributes;
  */
 declare class Scope {
   glows: Glow[];
+  breadcrumbs: SpanEvent[];
   pendingAttributes: Attributes;
   entryPoint: EntryPointHandler | null;
   /** Caps at `maxGlowsPerReport` by dropping the oldest, so the payload stays bounded. */
   addGlow(glow: Glow, maxGlowsPerReport: number): void;
   clearGlows(): void;
+  /** Drops the oldest when full. */
+  addBreadcrumb(breadcrumb: SpanEvent, maxBreadcrumbs: number): void;
+  clearBreadcrumbs(): void;
   setAttribute(key: string, value: AttributeValue): void;
   /** Shallow: last write wins per key, nested objects are not deep-merged. */
   mergeAttributes(partial: Attributes): void;
@@ -273,10 +277,16 @@ 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;
   glow(name: string, level?: MessageLevel, data?: Record<string, unknown> | Record<string, unknown>[]): this;
+  protected addBreadcrumb(type: string, attributes: Attributes, startTimeUnixNano: number): void;
   clearGlows(): this;
   addContext(name: string, value: AttributeValue): this;
   addContextGroup(groupName: string, value: Record<string, AttributeValue>): this;
@@ -288,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;
@@ -314,6 +329,11 @@ declare class Flare {
   sendReport(report: Report): Promise<void>;
 }
 //#endregion
+//#region src/breadcrumbs/recordBreadcrumb.d.ts
+declare const MAX_BREADCRUMB_URL_LENGTH = 256;
+declare function breadcrumbUrl(href: string, denylist: RegExp): string;
+declare function recordBreadcrumb(scopeProvider: ScopeProvider, config: Config, type: string, attributes: Attributes, startTimeUnixNano: number): void;
+//#endregion
 //#region src/tracing/envelope.d.ts
 declare function buildTracesEnvelope(spans: BufferedSpan[], resourceAttributes: Attributes, scopeName: string, scopeVersion: string): TracesEnvelope;
 //#endregion
@@ -343,4 +363,4 @@ declare class NullFileReader implements FileReader {
 //#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, 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, 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, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, 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 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 };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as User, A as BufferedSpan, B as OtelSpan, D as AttributeValue, E as AnyValue, F as Glow, G as Span, H as Report, I as KeyValue, J as SpanStatus, K as SpanEvent, L as LogsEnvelope, M as EntryPointHandler, N as EntryPointType, O as Attributes, P as Framework, Q as TracesSampler, R as MessageLevel, T as assert, U as SamplingContext, V as OverriddenGrouping, W as SdkInfo, X as StackFrame, Y as SpanStatusCode, Z as TracesEnvelope, _ as flatJsonStringify, a as SafeCloneOptions, b as createIdentityTagger, c as describeRejectionReason, d as redactObjectValues, et as BrowserSpanType, f as redactUrlQuery, g as glowsToEvents, h as now, j as Config, k as BufferedLog, l as routeRejection, m as safeDecode, n as urlAttributes, nt as FrameworkName, o as safeClone, p as resolveDenylist, q as SpanOptions, r as toCustomContext, s as RejectionReporter, tt as SpanTypeName, u as DEFAULT_URL_DENYLIST, v as extractCode, w as assertKey, x as convertToError, y as SdkTaggable, z as OtelLogRecord } from "./urlAttributes-B9BlkrfW.mjs";
+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-CYsfTfi9.mjs";
 
 //#region src/api/Api.d.ts
 declare class Api {
@@ -82,11 +82,15 @@ declare function userIdentityAttributes(scope: Scope): Attributes;
  */
 declare class Scope {
   glows: Glow[];
+  breadcrumbs: SpanEvent[];
   pendingAttributes: Attributes;
   entryPoint: EntryPointHandler | null;
   /** Caps at `maxGlowsPerReport` by dropping the oldest, so the payload stays bounded. */
   addGlow(glow: Glow, maxGlowsPerReport: number): void;
   clearGlows(): void;
+  /** Drops the oldest when full. */
+  addBreadcrumb(breadcrumb: SpanEvent, maxBreadcrumbs: number): void;
+  clearBreadcrumbs(): void;
   setAttribute(key: string, value: AttributeValue): void;
   /** Shallow: last write wins per key, nested objects are not deep-merged. */
   mergeAttributes(partial: Attributes): void;
@@ -273,10 +277,16 @@ 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;
   glow(name: string, level?: MessageLevel, data?: Record<string, unknown> | Record<string, unknown>[]): this;
+  protected addBreadcrumb(type: string, attributes: Attributes, startTimeUnixNano: number): void;
   clearGlows(): this;
   addContext(name: string, value: AttributeValue): this;
   addContextGroup(groupName: string, value: Record<string, AttributeValue>): this;
@@ -288,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;
@@ -314,6 +329,11 @@ declare class Flare {
   sendReport(report: Report): Promise<void>;
 }
 //#endregion
+//#region src/breadcrumbs/recordBreadcrumb.d.ts
+declare const MAX_BREADCRUMB_URL_LENGTH = 256;
+declare function breadcrumbUrl(href: string, denylist: RegExp): string;
+declare function recordBreadcrumb(scopeProvider: ScopeProvider, config: Config, type: string, attributes: Attributes, startTimeUnixNano: number): void;
+//#endregion
 //#region src/tracing/envelope.d.ts
 declare function buildTracesEnvelope(spans: BufferedSpan[], resourceAttributes: Attributes, scopeName: string, scopeVersion: string): TracesEnvelope;
 //#endregion
@@ -343,4 +363,4 @@ declare class NullFileReader implements FileReader {
 //#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, 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, 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, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, 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 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 };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { D as KEY, E as CLIENT_VERSION, O as SOURCEMAP_VERSION, T as assert, _ as createTraversalBudget, a as routeRejection, b as createIdentityTagger, c as redactUrlQuery, d as now, f as glowsToEvents, g as TRUNCATED, h as MAX_TRAVERSAL_DEPTH, i as describeRejectionReason, l as resolveDenylist, m as safeClone, n as urlAttributes, o as DEFAULT_URL_DENYLIST, p as flatJsonStringify, r as toCustomContext, s as redactObjectValues, u as safeDecode, v as spendNode, w as assertKey, x as convertToError, y as extractCode } from "./urlAttributes-D3gCx23B.mjs";
+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-DeDN7qtu.mjs";
 import ErrorStackParser from "error-stack-parser";
 
 //#region src/framework.ts
@@ -37,6 +37,11 @@ const BrowserSpanType = {
 	Component: "browser_component",
 	WebVital: "browser_web_vital"
 };
+const BrowserSpanEventType = {
+	Click: "browser_click",
+	Input: "browser_input",
+	RouteChange: "browser_route_change"
+};
 
 //#endregion
 //#region src/types.ts
@@ -146,6 +151,23 @@ var Api = class {
 	}
 };
 
+//#endregion
+//#region src/breadcrumbs/recordBreadcrumb.ts
+const MAX_BREADCRUMB_URL_LENGTH = 256;
+function breadcrumbUrl(href, denylist) {
+	const redacted = redactUrlQuery(href, denylist);
+	return redacted.length > MAX_BREADCRUMB_URL_LENGTH ? redacted.slice(0, MAX_BREADCRUMB_URL_LENGTH) : redacted;
+}
+function recordBreadcrumb(scopeProvider, config, type, attributes, startTimeUnixNano) {
+	if (!config.enableBreadcrumbs) return;
+	scopeProvider.active().addBreadcrumb({
+		type,
+		startTimeUnixNano,
+		endTimeUnixNano: null,
+		attributes
+	}, config.maxBreadcrumbs);
+}
+
 //#endregion
 //#region src/telemetry/TelemetryBuffer.ts
 /**
@@ -169,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) {
@@ -188,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;
@@ -523,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 = {
@@ -604,6 +632,7 @@ function userIdentityAttributes(scope) {
 */
 var Scope = class {
 	glows = [];
+	breadcrumbs = [];
 	pendingAttributes = {};
 	entryPoint = null;
 	/** Caps at `maxGlowsPerReport` by dropping the oldest, so the payload stays bounded. */
@@ -614,6 +643,15 @@ var Scope = class {
 	clearGlows() {
 		this.glows = [];
 	}
+	/** Drops the oldest when full. */
+	addBreadcrumb(breadcrumb, maxBreadcrumbs) {
+		if (maxBreadcrumbs <= 0) return;
+		this.breadcrumbs.push(breadcrumb);
+		if (this.breadcrumbs.length > maxBreadcrumbs) this.breadcrumbs = this.breadcrumbs.slice(this.breadcrumbs.length - maxBreadcrumbs);
+	}
+	clearBreadcrumbs() {
+		this.breadcrumbs = [];
+	}
 	setAttribute(key, value) {
 		this.pendingAttributes[key] = value;
 	}
@@ -1380,10 +1418,13 @@ var Flare = class {
 	_tracer;
 	_config = {
 		key: null,
+		hasConsent: true,
 		version: "",
 		sourcemapVersionId: SOURCEMAP_VERSION,
 		stage: "",
 		maxGlowsPerReport: 30,
+		enableBreadcrumbs: false,
+		maxBreadcrumbs: 100,
 		ingestUrl: "https://ingress.flareapp.io/v1/errors",
 		reportBrowserExtensionErrors: false,
 		debug: false,
@@ -1519,9 +1560,25 @@ 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;
+		const wasBreadcrumbsEnabled = this._config.enableBreadcrumbs;
 		this._config = {
 			...this._config,
 			...config
@@ -1531,6 +1588,7 @@ var Flare = class {
 		if (config.urlDenylist !== void 0 || config.replaceDefaultUrlDenylist !== void 0) this._config.urlDenylist = resolveDenylist(config.urlDenylist, config.replaceDefaultUrlDenylist ?? this._config.replaceDefaultUrlDenylist);
 		if (wasLogsEnabled && this._config.enableLogs === false) this._logger.clear();
 		if (config.key !== void 0) this._logger.flush();
+		if (wasBreadcrumbsEnabled && this._config.enableBreadcrumbs === false) this.scopeProvider.active().clearBreadcrumbs();
 		if (wasTracingEnabled && this._config.enableTracing === false) this._tracer.clear();
 		if (config.key !== void 0) this._tracer.flush();
 		return this;
@@ -1554,6 +1612,9 @@ var Flare = class {
 		}, this._config.maxGlowsPerReport);
 		return this;
 	}
+	addBreadcrumb(type, attributes, startTimeUnixNano) {
+		recordBreadcrumb(this.scopeProvider, this._config, type, attributes, startTimeUnixNano);
+	}
 	clearGlows() {
 		this.scopeProvider.active().clearGlows();
 		return this;
@@ -1600,11 +1661,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);
@@ -1620,7 +1689,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",
@@ -1638,7 +1707,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();
@@ -1745,7 +1814,7 @@ var Flare = class {
 			message: input.message,
 			seenAtUnixNano: input.seenAtUnixNano,
 			stacktrace: input.stacktrace,
-			events: glowsToEvents(activeScope.glows),
+			events: timelineEvents(activeScope.glows, activeScope.breadcrumbs),
 			attributes
 		};
 		if (input.isLog) report.isLog = true;
@@ -1755,6 +1824,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;
@@ -1763,4 +1833,4 @@ var Flare = class {
 };
 
 //#endregion
-export { Api, BrowserSpanType, DEFAULT_MAX_LIVE_TRACES, DEFAULT_URL_DENYLIST, Flare, FrameworkName, GlobalScopeProvider, InMemoryActiveSpanHolder, Logger, NoopFlushScheduler, NullFileReader, Scope, SpanStatusCode, Tracer, USER_IDENTITY_KEYS, assert, assertKey, buildTraceparent, buildTracesEnvelope, convertToError, createIdentityTagger, createStackTrace, defaultNowNano, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, parseTraceparent, readLinesFromFile, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, spanId, toCustomContext, urlAttributes, userIdentityAttributes };
+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 };

package/dist/{urlAttributes-CNGTgOJp.cjs → urlAttributes-B37JykP3.cjs}

@@ -1,6 +1,6 @@
 
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.8.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.10.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -218,6 +218,15 @@ function glowsToEvents(glows) {
 	}));
 }
 
+//#endregion
+//#region src/util/timelineEvents.ts
+function byTime(a, b) {
+	return a.startTimeUnixNano - b.startTimeUnixNano;
+}
+function timelineEvents(glows, breadcrumbs) {
+	return [...glowsToEvents(glows), ...breadcrumbs].sort(byTime);
+}
+
 //#endregion
 //#region src/util/now.ts
 function now() {
@@ -531,6 +540,12 @@ Object.defineProperty(exports, 'spendNode', {
     return spendNode;
   }
 });
+Object.defineProperty(exports, 'timelineEvents', {
+  enumerable: true,
+  get: function () {
+    return timelineEvents;
+  }
+});
 Object.defineProperty(exports, 'toCustomContext', {
   enumerable: true,
   get: function () {

package/dist/{urlAttributes-B9BlkrfW.d.mts → urlAttributes-CYsfTfi9.d.mts}

@@ -37,6 +37,12 @@ declare const BrowserSpanType: {
 type BrowserSpanType = (typeof BrowserSpanType)[keyof typeof BrowserSpanType];
 /** Any other value stays legal, so a host SDK can stamp its own without a core release. */
 type SpanTypeName = BrowserSpanType | (string & {});
+declare const BrowserSpanEventType: {
+  readonly Click: "browser_click";
+  readonly Input: "browser_input";
+  readonly RouteChange: "browser_route_change";
+};
+type BrowserSpanEventType = (typeof BrowserSpanEventType)[keyof typeof BrowserSpanEventType];
 //#endregion
 //#region src/types.d.ts
 type MessageLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
@@ -59,10 +65,15 @@ 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;
   maxGlowsPerReport: number;
+  enableBreadcrumbs: boolean;
+  maxBreadcrumbs: number;
   reportBrowserExtensionErrors: boolean;
   ingestUrl: string;
   debug: boolean;
@@ -366,6 +377,9 @@ declare function flatJsonStringify(json: object): string;
 //#region src/util/glowsToEvents.d.ts
 declare function glowsToEvents(glows: Glow[]): SpanEvent[];
 //#endregion
+//#region src/util/timelineEvents.d.ts
+declare function timelineEvents(glows: Glow[], breadcrumbs: SpanEvent[]): SpanEvent[];
+//#endregion
 //#region src/util/now.d.ts
 declare function now(): number;
 //#endregion
@@ -449,4 +463,4 @@ declare const MAX_URL_LENGTH = 2048;
  */
 declare function urlAttributes(url: string, denylist?: RegExp): Attributes;
 //#endregion
-export { User as $, BufferedSpan as A, OtelSpan as B, createComponentMatcher as C, AttributeValue as D, AnyValue as E, Glow as F, Span as G, Report as H, KeyValue as I, SpanStatus as J, SpanEvent as K, LogsEnvelope as L, EntryPointHandler as M, EntryPointType as N, Attributes as O, Framework as P, TracesSampler as Q, MessageLevel as R, ProfileComponentsOption as S, assert as T, SamplingContext as U, OverriddenGrouping as V, SdkInfo as W, StackFrame as X, SpanStatusCode as Y, TracesEnvelope as Z, flatJsonStringify as _, SafeCloneOptions as a, createIdentityTagger as b, describeRejectionReason as c, redactObjectValues as d, BrowserSpanType as et, redactUrlQuery as f, glowsToEvents as g, now as h, withoutStatefulFlags as i, Config as j, BufferedLog as k, routeRejection as l, safeDecode as m, urlAttributes as n, FrameworkName as nt, safeClone as o, resolveDenylist as p, SpanOptions as q, toCustomContext as r, RejectionReporter as s, MAX_URL_LENGTH as t, SpanTypeName as tt, DEFAULT_URL_DENYLIST as u, extractCode as v, assertKey as w, convertToError as x, SdkTaggable as y, OtelLogRecord as z };
+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 };

package/dist/{urlAttributes-CvOw6tU3.d.cts → urlAttributes-DW_i-YQ3.d.cts}

@@ -37,6 +37,12 @@ declare const BrowserSpanType: {
 type BrowserSpanType = (typeof BrowserSpanType)[keyof typeof BrowserSpanType];
 /** Any other value stays legal, so a host SDK can stamp its own without a core release. */
 type SpanTypeName = BrowserSpanType | (string & {});
+declare const BrowserSpanEventType: {
+  readonly Click: "browser_click";
+  readonly Input: "browser_input";
+  readonly RouteChange: "browser_route_change";
+};
+type BrowserSpanEventType = (typeof BrowserSpanEventType)[keyof typeof BrowserSpanEventType];
 //#endregion
 //#region src/types.d.ts
 type MessageLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
@@ -59,10 +65,15 @@ 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;
   maxGlowsPerReport: number;
+  enableBreadcrumbs: boolean;
+  maxBreadcrumbs: number;
   reportBrowserExtensionErrors: boolean;
   ingestUrl: string;
   debug: boolean;
@@ -366,6 +377,9 @@ declare function flatJsonStringify(json: object): string;
 //#region src/util/glowsToEvents.d.ts
 declare function glowsToEvents(glows: Glow[]): SpanEvent[];
 //#endregion
+//#region src/util/timelineEvents.d.ts
+declare function timelineEvents(glows: Glow[], breadcrumbs: SpanEvent[]): SpanEvent[];
+//#endregion
 //#region src/util/now.d.ts
 declare function now(): number;
 //#endregion
@@ -449,4 +463,4 @@ declare const MAX_URL_LENGTH = 2048;
  */
 declare function urlAttributes(url: string, denylist?: RegExp): Attributes;
 //#endregion
-export { User as $, BufferedSpan as A, OtelSpan as B, createComponentMatcher as C, AttributeValue as D, AnyValue as E, Glow as F, Span as G, Report as H, KeyValue as I, SpanStatus as J, SpanEvent as K, LogsEnvelope as L, EntryPointHandler as M, EntryPointType as N, Attributes as O, Framework as P, TracesSampler as Q, MessageLevel as R, ProfileComponentsOption as S, assert as T, SamplingContext as U, OverriddenGrouping as V, SdkInfo as W, StackFrame as X, SpanStatusCode as Y, TracesEnvelope as Z, flatJsonStringify as _, SafeCloneOptions as a, createIdentityTagger as b, describeRejectionReason as c, redactObjectValues as d, BrowserSpanType as et, redactUrlQuery as f, glowsToEvents as g, now as h, withoutStatefulFlags as i, Config as j, BufferedLog as k, routeRejection as l, safeDecode as m, urlAttributes as n, FrameworkName as nt, safeClone as o, resolveDenylist as p, SpanOptions as q, toCustomContext as r, RejectionReporter as s, MAX_URL_LENGTH as t, SpanTypeName as tt, DEFAULT_URL_DENYLIST as u, extractCode as v, assertKey as w, convertToError as x, SdkTaggable as y, OtelLogRecord as z };
+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 };

package/dist/{urlAttributes-D3gCx23B.mjs → urlAttributes-DeDN7qtu.mjs}

@@ -1,5 +1,5 @@
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.8.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.10.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -217,6 +217,15 @@ function glowsToEvents(glows) {
 	}));
 }
 
+//#endregion
+//#region src/util/timelineEvents.ts
+function byTime(a, b) {
+	return a.startTimeUnixNano - b.startTimeUnixNano;
+}
+function timelineEvents(glows, breadcrumbs) {
+	return [...glowsToEvents(glows), ...breadcrumbs].sort(byTime);
+}
+
 //#endregion
 //#region src/util/now.ts
 function now() {
@@ -380,4 +389,4 @@ function urlAttributes(url, denylist = DEFAULT_URL_DENYLIST) {
 }
 
 //#endregion
-export { withoutStatefulFlags as C, KEY as D, CLIENT_VERSION as E, SOURCEMAP_VERSION as O, createComponentMatcher as S, assert as T, createTraversalBudget as _, routeRejection as a, createIdentityTagger as b, redactUrlQuery as c, now as d, glowsToEvents as f, TRUNCATED as g, MAX_TRAVERSAL_DEPTH as h, describeRejectionReason as i, resolveDenylist as l, safeClone as m, urlAttributes as n, DEFAULT_URL_DENYLIST as o, flatJsonStringify as p, toCustomContext as r, redactObjectValues as s, MAX_URL_LENGTH as t, safeDecode as u, spendNode as v, assertKey as w, convertToError as x, extractCode as y };
+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 };

package/dist/util/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_urlAttributes = require('../urlAttributes-CNGTgOJp.cjs');
+const require_urlAttributes = require('../urlAttributes-B37JykP3.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.timelineEvents = require_urlAttributes.timelineEvents;
 exports.toCustomContext = require_urlAttributes.toCustomContext;
 exports.urlAttributes = require_urlAttributes.urlAttributes;
 exports.withoutStatefulFlags = require_urlAttributes.withoutStatefulFlags;

package/dist/util/index.d.cts

@@ -1,2 +1,2 @@
-import { C as createComponentMatcher, S as ProfileComponentsOption, T as assert, _ as flatJsonStringify, a as SafeCloneOptions, b as createIdentityTagger, c as describeRejectionReason, d as redactObjectValues, f as redactUrlQuery, g as glowsToEvents, 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 extractCode, w as assertKey, x as convertToError, y as SdkTaggable } from "../urlAttributes-CvOw6tU3.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, toCustomContext, urlAttributes, withoutStatefulFlags };
+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-DW_i-YQ3.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 };

package/dist/util/index.d.mts

@@ -1,2 +1,2 @@
-import { C as createComponentMatcher, S as ProfileComponentsOption, T as assert, _ as flatJsonStringify, a as SafeCloneOptions, b as createIdentityTagger, c as describeRejectionReason, d as redactObjectValues, f as redactUrlQuery, g as glowsToEvents, 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 extractCode, w as assertKey, x as convertToError, y as SdkTaggable } from "../urlAttributes-B9BlkrfW.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, toCustomContext, urlAttributes, withoutStatefulFlags };
+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-CYsfTfi9.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 };

package/dist/util/index.mjs

@@ -1,3 +1,3 @@
-import { C as withoutStatefulFlags, S as createComponentMatcher, T as assert, a as routeRejection, b as createIdentityTagger, c as redactUrlQuery, d as now, f as glowsToEvents, i as describeRejectionReason, l as resolveDenylist, m as safeClone, n as urlAttributes, o as DEFAULT_URL_DENYLIST, p as flatJsonStringify, r as toCustomContext, s as redactObjectValues, t as MAX_URL_LENGTH, u as safeDecode, w as assertKey, x as convertToError, y as extractCode } from "../urlAttributes-D3gCx23B.mjs";
+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-DeDN7qtu.mjs";
 
-export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, extractCode, flatJsonStringify, glowsToEvents, now, redactObjectValues, redactUrlQuery, resolveDenylist, routeRejection, safeClone, safeDecode, 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, timelineEvents, toCustomContext, urlAttributes, withoutStatefulFlags };

package/package.json

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