@flareapp/core 2.10.0 → 2.12.0

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

@@ -1,10 +1,10 @@
 //#region src/framework.d.ts
 /**
- * Framework names the Flare backend recognises. Wire format, so the values never change: they ship as
- * `flare.framework.name` and (lowercased) as `context.custom.framework`.
+ * Framework names the Flare backend recognizes. Wire format: these values never change, since they
+ * ship as `flare.framework.name` and (lowercased) as `context.custom.framework`.
  *
- * `Js` and `Node` are the base SDKs' fallback claim, overwritten when a framework package tags its
- * own name. `NodeElectron` is an Electron main process; its renderers report their own.
+ * `Js` and `Node` are fallback claims from the base SDKs, overwritten when a framework package sets
+ * its own name. `NodeElectron` is the Electron main process; renderers report their own name.
  */
 declare const FrameworkName: {
   readonly Js: "js";
@@ -20,7 +20,7 @@ type FrameworkName = (typeof FrameworkName)[keyof typeof FrameworkName];
 //#endregion
 //#region src/spanTypes.d.ts
 /**
- * Span types the Flare backend recognises. Wire format, so the values never change: they ship as the
+ * Span types the Flare backend recognizes. Wire format, so the values never change: they ship as the
  * `flare.span_type` attribute and the backend groups performance data by them.
  *
  * These are the browser client's set. They live in core because core's `SpanOptions.spanType` needs
@@ -37,6 +37,10 @@ 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 & {});
+/**
+ * Span event types on an error report. Kept apart from `BrowserSpanType`: these are points in time,
+ * not spans with a duration. That is also why a route change is not called `browser_navigation`.
+ */
 declare const BrowserSpanEventType: {
   readonly Click: "browser_click";
   readonly Input: "browser_input";
@@ -363,6 +367,9 @@ declare function createIdentityTagger(config: {
   tagFramework(flare: SdkTaggable, frameworkVersion?: string): void;
 };
 //#endregion
+//#region src/util/evictLruIfNew.d.ts
+declare function evictLruIfNew<V>(map: Map<string, V>, key: string, cap: number): void;
+//#endregion
 //#region src/util/extractCode.d.ts
 declare function extractCode(error: Error): string | undefined;
 //#endregion
@@ -384,6 +391,10 @@ declare function timelineEvents(glows: Glow[], breadcrumbs: SpanEvent[]): SpanEv
 declare function now(): number;
 //#endregion
 //#region src/util/redactUrl.d.ts
+/**
+ * Matched against query-string keys, cookie names, and (in framework SDKs) prop/route-param keys. Values for
+ * matching keys are replaced with [redacted] before sending so credentials/PII don't leak in error reports.
+ */
 declare const DEFAULT_URL_DENYLIST: RegExp;
 declare function resolveDenylist(custom?: RegExp, replaceDefault?: boolean, defaultDenylist?: RegExp): RegExp;
 /**
@@ -411,9 +422,9 @@ type RejectionReporter = {
 declare function describeRejectionReason(reason: unknown): string;
 /**
  * Routes by whether `reason` carries a stack: stack-bearing reasons go to `reportSilently`, stackless
- * ones to `reportUnhandledRejection`.
- * The `.catch` is what stops a transport failure from surfacing as a second unhandled rejection.
- * `reportSilently` is assumed async and left unwrapped, so a synchronous throw there still propagates.
+ * ones to `reportUnhandledRejection`. The `.catch` stops a transport failure from surfacing as a second
+ * unhandled rejection. `reportSilently` is assumed async and left unwrapped, so a synchronous throw there
+ * still propagates.
  */
 declare function routeRejection(reporter: RejectionReporter, reason: unknown): void;
 //#endregion
@@ -437,6 +448,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
@@ -463,4 +478,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 { StackFrame as $, AttributeValue as A, LogsEnvelope as B, createIdentityTagger as C, assertKey as D, createComponentMatcher as E, EntryPointHandler as F, Report as G, OtelLogRecord as H, EntryPointType as I, Span as J, SamplingContext as K, Framework as L, BufferedLog as M, BufferedSpan as N, assert as O, Config as P, SpanStatusCode as Q, Glow as R, SdkTaggable as S, ProfileComponentsOption as T, OtelSpan as U, MessageLevel as V, OverriddenGrouping as W, SpanOptions as X, SpanEvent as Y, SpanStatus as Z, timelineEvents as _, setDefined as a, SpanTypeName as at, extractCode as b, RejectionReporter as c, DEFAULT_URL_DENYLIST as d, TracesEnvelope as et, redactObjectValues as f, now as g, safeDecode as h, withoutStatefulFlags as i, BrowserSpanType as it, Attributes as j, AnyValue as k, describeRejectionReason as l, resolveDenylist as m, urlAttributes as n, User as nt, SafeCloneOptions as o, FrameworkName as ot, redactUrlQuery as p, SdkInfo as q, toCustomContext as r, BrowserSpanEventType as rt, safeClone as s, MAX_URL_LENGTH as t, TracesSampler as tt, routeRejection as u, glowsToEvents as v, convertToError as w, evictLruIfNew as x, flatJsonStringify as y, KeyValue as z };

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

@@ -1,6 +1,6 @@
 
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.10.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.12.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -87,6 +87,14 @@ function createIdentityTagger(config) {
 	};
 }
 
+//#endregion
+//#region src/util/evictLruIfNew.ts
+function evictLruIfNew(map, key, cap) {
+	if (map.has(key) || map.size < cap) return;
+	const lru = map.keys().next().value;
+	if (lru !== void 0) map.delete(lru);
+}
+
 //#endregion
 //#region src/util/extractCode.ts
 const MAX_CODE_LENGTH = 64;
@@ -98,28 +106,16 @@ function extractCode(error) {
 
 //#endregion
 //#region src/util/traversalBudget.ts
-/**
-* Cycle detection only tracks the ancestor path, so a value holding the same child under two keys is not
-* a cycle but still costs 2^depth to walk. Host data (glows, addContext, span attributes) reaches that
-* shape through any object graph shared by reference.
-*
-* The node cap only bounds that walk if EVERY visited node is charged, primitive leaves included. It used
-* to charge containers only, so 15 shared objects over an array of 1000 strings walked ~17M uncharged
-* strings before the cap fired: 1.2s and 1GB. Callers must spend before their leaf branches return, not
-* after. We do not memoize instead: a value shared under two keys is not a cycle and must not read as one.
-*/
 const MAX_TRAVERSAL_DEPTH = 24;
 const MAX_TRAVERSAL_NODES = 5e4;
 function createTraversalBudget(nodes = MAX_TRAVERSAL_NODES) {
 	return { remaining: nodes };
 }
-/** Consumes one node. False once the budget is spent: stop descending. */
 function spendNode(budget) {
 	if (budget.remaining <= 0) return false;
 	budget.remaining--;
 	return true;
 }
-/** Marks where a walk stopped, so a truncated payload does not read as a complete one. */
 const TRUNCATED = "[truncated: too large]";
 
 //#endregion
@@ -182,10 +178,6 @@ function truncate(value, max) {
 	if (value.length <= max) return value;
 	return `${value.slice(0, max)}…[truncated ${value.length - max} chars]`;
 }
-/**
-* Literal object / null prototypes only. Class instances may have side-effecting getters or
-* non-enumerable internals we should not traverse, so they are left to the caller's mode policy.
-*/
 function isPlainObject(value) {
 	if (value === null || typeof value !== "object") return false;
 	const proto = Object.getPrototypeOf(value);
@@ -235,6 +227,10 @@ function now() {
 
 //#endregion
 //#region src/util/redactUrl.ts
+/**
+* Matched against query-string keys, cookie names, and (in framework SDKs) prop/route-param keys. Values for
+* matching keys are replaced with [redacted] before sending so credentials/PII don't leak in error reports.
+*/
 const DEFAULT_URL_DENYLIST = /password|passwd|pwd|token|secret|authorization|\bauth\b|bearer|oauth|credentials?|cookie|api[-_]?key|private[-_]?key|session|csrf|xsrf|\bpin\b|\bssn\b|card[-_]?number|\bcvv\b/i;
 function resolveDenylist(custom, replaceDefault = false, defaultDenylist = DEFAULT_URL_DENYLIST) {
 	if (!custom) return defaultDenylist;
@@ -284,10 +280,6 @@ function redactObjectValues(obj, denylist = DEFAULT_URL_DENYLIST) {
 	for (const key of Object.keys(obj)) result[key] = denylist.test(key) ? "[redacted]" : obj[key];
 	return result;
 }
-/**
-* Removes userinfo (`user:pass@`) from an absolute URL's authority only. A path or query can legally
-* contain `@`, so only the authority (after `scheme://`, up to the first `/`, `?`, `#`) is inspected.
-*/
 function stripUserinfo(url) {
 	const schemeMatch = /^[a-z][a-z0-9+.-]*:\/\//i.exec(url);
 	if (!schemeMatch) return url;
@@ -333,9 +325,9 @@ function hasStack(reason) {
 }
 /**
 * Routes by whether `reason` carries a stack: stack-bearing reasons go to `reportSilently`, stackless
-* ones to `reportUnhandledRejection`.
-* The `.catch` is what stops a transport failure from surfacing as a second unhandled rejection.
-* `reportSilently` is assumed async and left unwrapped, so a synchronous throw there still propagates.
+* ones to `reportUnhandledRejection`. The `.catch` stops a transport failure from surfacing as a second
+* unhandled rejection. `reportSilently` is assumed async and left unwrapped, so a synchronous throw there
+* still propagates.
 */
 function routeRejection(reporter, reason) {
 	if (reason instanceof Error) {
@@ -351,6 +343,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. */
@@ -474,6 +473,12 @@ Object.defineProperty(exports, 'describeRejectionReason', {
     return describeRejectionReason;
   }
 });
+Object.defineProperty(exports, 'evictLruIfNew', {
+  enumerable: true,
+  get: function () {
+    return evictLruIfNew;
+  }
+});
 Object.defineProperty(exports, 'extractCode', {
   enumerable: true,
   get: function () {
@@ -534,6 +539,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-DeDN7qtu.mjs → urlAttributes-ggdpIKSS.mjs}

@@ -1,5 +1,5 @@
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.10.0" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.12.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -86,6 +86,14 @@ function createIdentityTagger(config) {
 	};
 }
 
+//#endregion
+//#region src/util/evictLruIfNew.ts
+function evictLruIfNew(map, key, cap) {
+	if (map.has(key) || map.size < cap) return;
+	const lru = map.keys().next().value;
+	if (lru !== void 0) map.delete(lru);
+}
+
 //#endregion
 //#region src/util/extractCode.ts
 const MAX_CODE_LENGTH = 64;
@@ -97,28 +105,16 @@ function extractCode(error) {
 
 //#endregion
 //#region src/util/traversalBudget.ts
-/**
-* Cycle detection only tracks the ancestor path, so a value holding the same child under two keys is not
-* a cycle but still costs 2^depth to walk. Host data (glows, addContext, span attributes) reaches that
-* shape through any object graph shared by reference.
-*
-* The node cap only bounds that walk if EVERY visited node is charged, primitive leaves included. It used
-* to charge containers only, so 15 shared objects over an array of 1000 strings walked ~17M uncharged
-* strings before the cap fired: 1.2s and 1GB. Callers must spend before their leaf branches return, not
-* after. We do not memoize instead: a value shared under two keys is not a cycle and must not read as one.
-*/
 const MAX_TRAVERSAL_DEPTH = 24;
 const MAX_TRAVERSAL_NODES = 5e4;
 function createTraversalBudget(nodes = MAX_TRAVERSAL_NODES) {
 	return { remaining: nodes };
 }
-/** Consumes one node. False once the budget is spent: stop descending. */
 function spendNode(budget) {
 	if (budget.remaining <= 0) return false;
 	budget.remaining--;
 	return true;
 }
-/** Marks where a walk stopped, so a truncated payload does not read as a complete one. */
 const TRUNCATED = "[truncated: too large]";
 
 //#endregion
@@ -181,10 +177,6 @@ function truncate(value, max) {
 	if (value.length <= max) return value;
 	return `${value.slice(0, max)}…[truncated ${value.length - max} chars]`;
 }
-/**
-* Literal object / null prototypes only. Class instances may have side-effecting getters or
-* non-enumerable internals we should not traverse, so they are left to the caller's mode policy.
-*/
 function isPlainObject(value) {
 	if (value === null || typeof value !== "object") return false;
 	const proto = Object.getPrototypeOf(value);
@@ -234,6 +226,10 @@ function now() {
 
 //#endregion
 //#region src/util/redactUrl.ts
+/**
+* Matched against query-string keys, cookie names, and (in framework SDKs) prop/route-param keys. Values for
+* matching keys are replaced with [redacted] before sending so credentials/PII don't leak in error reports.
+*/
 const DEFAULT_URL_DENYLIST = /password|passwd|pwd|token|secret|authorization|\bauth\b|bearer|oauth|credentials?|cookie|api[-_]?key|private[-_]?key|session|csrf|xsrf|\bpin\b|\bssn\b|card[-_]?number|\bcvv\b/i;
 function resolveDenylist(custom, replaceDefault = false, defaultDenylist = DEFAULT_URL_DENYLIST) {
 	if (!custom) return defaultDenylist;
@@ -283,10 +279,6 @@ function redactObjectValues(obj, denylist = DEFAULT_URL_DENYLIST) {
 	for (const key of Object.keys(obj)) result[key] = denylist.test(key) ? "[redacted]" : obj[key];
 	return result;
 }
-/**
-* Removes userinfo (`user:pass@`) from an absolute URL's authority only. A path or query can legally
-* contain `@`, so only the authority (after `scheme://`, up to the first `/`, `?`, `#`) is inspected.
-*/
 function stripUserinfo(url) {
 	const schemeMatch = /^[a-z][a-z0-9+.-]*:\/\//i.exec(url);
 	if (!schemeMatch) return url;
@@ -332,9 +324,9 @@ function hasStack(reason) {
 }
 /**
 * Routes by whether `reason` carries a stack: stack-bearing reasons go to `reportSilently`, stackless
-* ones to `reportUnhandledRejection`.
-* The `.catch` is what stops a transport failure from surfacing as a second unhandled rejection.
-* `reportSilently` is assumed async and left unwrapped, so a synchronous throw there still propagates.
+* ones to `reportUnhandledRejection`. The `.catch` stops a transport failure from surfacing as a second
+* unhandled rejection. `reportSilently` is assumed async and left unwrapped, so a synchronous throw there
+* still propagates.
 */
 function routeRejection(reporter, reason) {
 	if (reason instanceof Error) {
@@ -350,6 +342,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 +388,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 { KEY as A, createIdentityTagger as C, assertKey as D, withoutStatefulFlags as E, assert as O, evictLruIfNew as S, createComponentMatcher 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, SOURCEMAP_VERSION as j, CLIENT_VERSION 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, convertToError as w, extractCode as x, createTraversalBudget as y };

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

@@ -1,10 +1,10 @@
 //#region src/framework.d.ts
 /**
- * Framework names the Flare backend recognises. Wire format, so the values never change: they ship as
- * `flare.framework.name` and (lowercased) as `context.custom.framework`.
+ * Framework names the Flare backend recognizes. Wire format: these values never change, since they
+ * ship as `flare.framework.name` and (lowercased) as `context.custom.framework`.
  *
- * `Js` and `Node` are the base SDKs' fallback claim, overwritten when a framework package tags its
- * own name. `NodeElectron` is an Electron main process; its renderers report their own.
+ * `Js` and `Node` are fallback claims from the base SDKs, overwritten when a framework package sets
+ * its own name. `NodeElectron` is the Electron main process; renderers report their own name.
  */
 declare const FrameworkName: {
   readonly Js: "js";
@@ -20,7 +20,7 @@ type FrameworkName = (typeof FrameworkName)[keyof typeof FrameworkName];
 //#endregion
 //#region src/spanTypes.d.ts
 /**
- * Span types the Flare backend recognises. Wire format, so the values never change: they ship as the
+ * Span types the Flare backend recognizes. Wire format, so the values never change: they ship as the
  * `flare.span_type` attribute and the backend groups performance data by them.
  *
  * These are the browser client's set. They live in core because core's `SpanOptions.spanType` needs
@@ -37,6 +37,10 @@ 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 & {});
+/**
+ * Span event types on an error report. Kept apart from `BrowserSpanType`: these are points in time,
+ * not spans with a duration. That is also why a route change is not called `browser_navigation`.
+ */
 declare const BrowserSpanEventType: {
   readonly Click: "browser_click";
   readonly Input: "browser_input";
@@ -363,6 +367,9 @@ declare function createIdentityTagger(config: {
   tagFramework(flare: SdkTaggable, frameworkVersion?: string): void;
 };
 //#endregion
+//#region src/util/evictLruIfNew.d.ts
+declare function evictLruIfNew<V>(map: Map<string, V>, key: string, cap: number): void;
+//#endregion
 //#region src/util/extractCode.d.ts
 declare function extractCode(error: Error): string | undefined;
 //#endregion
@@ -384,6 +391,10 @@ declare function timelineEvents(glows: Glow[], breadcrumbs: SpanEvent[]): SpanEv
 declare function now(): number;
 //#endregion
 //#region src/util/redactUrl.d.ts
+/**
+ * Matched against query-string keys, cookie names, and (in framework SDKs) prop/route-param keys. Values for
+ * matching keys are replaced with [redacted] before sending so credentials/PII don't leak in error reports.
+ */
 declare const DEFAULT_URL_DENYLIST: RegExp;
 declare function resolveDenylist(custom?: RegExp, replaceDefault?: boolean, defaultDenylist?: RegExp): RegExp;
 /**
@@ -411,9 +422,9 @@ type RejectionReporter = {
 declare function describeRejectionReason(reason: unknown): string;
 /**
  * Routes by whether `reason` carries a stack: stack-bearing reasons go to `reportSilently`, stackless
- * ones to `reportUnhandledRejection`.
- * The `.catch` is what stops a transport failure from surfacing as a second unhandled rejection.
- * `reportSilently` is assumed async and left unwrapped, so a synchronous throw there still propagates.
+ * ones to `reportUnhandledRejection`. The `.catch` stops a transport failure from surfacing as a second
+ * unhandled rejection. `reportSilently` is assumed async and left unwrapped, so a synchronous throw there
+ * still propagates.
  */
 declare function routeRejection(reporter: RejectionReporter, reason: unknown): void;
 //#endregion
@@ -437,6 +448,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
@@ -463,4 +478,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 { StackFrame as $, AttributeValue as A, LogsEnvelope as B, createIdentityTagger as C, assertKey as D, createComponentMatcher as E, EntryPointHandler as F, Report as G, OtelLogRecord as H, EntryPointType as I, Span as J, SamplingContext as K, Framework as L, BufferedLog as M, BufferedSpan as N, assert as O, Config as P, SpanStatusCode as Q, Glow as R, SdkTaggable as S, ProfileComponentsOption as T, OtelSpan as U, MessageLevel as V, OverriddenGrouping as W, SpanOptions as X, SpanEvent as Y, SpanStatus as Z, timelineEvents as _, setDefined as a, SpanTypeName as at, extractCode as b, RejectionReporter as c, DEFAULT_URL_DENYLIST as d, TracesEnvelope as et, redactObjectValues as f, now as g, safeDecode as h, withoutStatefulFlags as i, BrowserSpanType as it, Attributes as j, AnyValue as k, describeRejectionReason as l, resolveDenylist as m, urlAttributes as n, User as nt, SafeCloneOptions as o, FrameworkName as ot, redactUrlQuery as p, SdkInfo as q, toCustomContext as r, BrowserSpanEventType as rt, safeClone as s, MAX_URL_LENGTH as t, TracesSampler as tt, routeRejection as u, glowsToEvents as v, convertToError as w, evictLruIfNew as x, flatJsonStringify as y, KeyValue as z };

package/dist/util/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_urlAttributes = require('../urlAttributes-B37JykP3.cjs');
+const require_urlAttributes = require('../urlAttributes-D0eXRrGm.cjs');
 
 exports.DEFAULT_URL_DENYLIST = require_urlAttributes.DEFAULT_URL_DENYLIST;
 exports.MAX_URL_LENGTH = require_urlAttributes.MAX_URL_LENGTH;
@@ -9,6 +9,7 @@ exports.convertToError = require_urlAttributes.convertToError;
 exports.createComponentMatcher = require_urlAttributes.createComponentMatcher;
 exports.createIdentityTagger = require_urlAttributes.createIdentityTagger;
 exports.describeRejectionReason = require_urlAttributes.describeRejectionReason;
+exports.evictLruIfNew = require_urlAttributes.evictLruIfNew;
 exports.extractCode = require_urlAttributes.extractCode;
 exports.flatJsonStringify = require_urlAttributes.flatJsonStringify;
 exports.glowsToEvents = require_urlAttributes.glowsToEvents;
@@ -19,6 +20,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-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 };
+import { C as createIdentityTagger, D as assertKey, E as createComponentMatcher, O as assert, S as SdkTaggable, T as ProfileComponentsOption, _ 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 convertToError, x as evictLruIfNew, y as flatJsonStringify } from "../urlAttributes-CU2Yr37w.cjs";
+export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, evictLruIfNew, 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-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 };
+import { C as createIdentityTagger, D as assertKey, E as createComponentMatcher, O as assert, S as SdkTaggable, T as ProfileComponentsOption, _ 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 convertToError, x as evictLruIfNew, y as flatJsonStringify } from "../urlAttributes-rWoVW31H.mjs";
+export { DEFAULT_URL_DENYLIST, MAX_URL_LENGTH, ProfileComponentsOption, RejectionReporter, SafeCloneOptions, SdkTaggable, assert, assertKey, convertToError, createComponentMatcher, createIdentityTagger, describeRejectionReason, evictLruIfNew, 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-DeDN7qtu.mjs";
+import { C as createIdentityTagger, D as assertKey, E as withoutStatefulFlags, O as assert, S as evictLruIfNew, T as createComponentMatcher, 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 convertToError, x as extractCode } from "../urlAttributes-ggdpIKSS.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, evictLruIfNew, 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.10.0",
+    "version": "2.12.0",
     "description": "Environment-agnostic core for the Flare JS SDK",
     "homepage": "https://flareapp.io",
     "bugs": {