@flareapp/js 2.6.0 → 2.8.0

package/README.md

@@ -51,6 +51,23 @@ flare.logger.info('Checkout started', { cartId: cart.id, total: cart.total });
 Logs are buffered and batched, and flushed when the tab is hidden so buffered logs survive a page unload. The optional
 second argument is structured, searchable attributes.
 
+## What happens when someone leaves the page
+
+Logs and spans are batched, so there's usually something unsent when a visitor leaves. The client flushes it when
+the tab is hidden or the page closes.
+
+Browsers cap what you can send at that moment: roughly 64KB across every request still in flight. The client stays
+under 60KB, and logs and spans share that budget.
+
+Switching tabs is safe. Hiding a tab triggers the same flush, and whatever didn't fit goes out when the visitor
+comes back.
+
+If nothing fits, the batch is still sent, as a normal request instead of a keepalive one. That usually lands, but
+it can be cancelled if the page closes right then.
+
+You'll only hit the limit on pages that produce a lot of telemetry before the visitor leaves. Log less on those
+pages rather than raising the limits.
+
 ## Documentation
 
 Full documentation on configuration, hooks, context, breadcrumbs, solution providers, and more is available

package/dist/browser.cjs

@@ -1,21 +1,58 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_catchWindowErrors = require('./catchWindowErrors-_IlVo06V.cjs');
+const require_componentProfiler = require('./componentProfiler-C6qY96Bt.cjs');
 let _flareapp_core = require("@flareapp/core");
 
 //#region src/browser.ts
 var Flare = class extends _flareapp_core.Flare {
-	constructor(api = new _flareapp_core.Api(), contextCollector = require_catchWindowErrors.collectBrowser, fileReader = new require_catchWindowErrors.FetchFileReader(), scopeProvider = new _flareapp_core.GlobalScopeProvider()) {
-		super(api, contextCollector, fileReader, scopeProvider, new require_catchWindowErrors.BrowserFlushScheduler());
+	constructor(api = new _flareapp_core.Api(), contextCollector = require_componentProfiler.collectBrowser, fileReader = new require_componentProfiler.FetchFileReader(), scopeProvider = new _flareapp_core.GlobalScopeProvider()) {
+		super(api, contextCollector, fileReader, scopeProvider, new require_componentProfiler.BrowserFlushScheduler());
 		this.setSdkInfo({
 			name: "@flareapp/js",
-			version: require_catchWindowErrors.CLIENT_VERSION
+			version: require_componentProfiler.CLIENT_VERSION
 		});
+		this.setFramework({ name: _flareapp_core.FrameworkName.Js });
+	}
+	configure(config) {
+		const wasTracing = this.config.enableTracing;
+		super.configure(config);
+		const nowTracing = this.config.enableTracing;
+		if (!wasTracing && nowTracing) {
+			require_componentProfiler.instrumentFetch(this);
+			require_componentProfiler.instrumentXHR(this);
+			require_componentProfiler.startBrowserTracing(this);
+		} else if (wasTracing && !nowTracing) {
+			require_componentProfiler.stopBrowserTracing();
+			require_componentProfiler.unpatchFetch();
+			require_componentProfiler.unpatchXHR();
+		}
+		return this;
 	}
 };
 
 //#endregion
-exports.BrowserFlushScheduler = require_catchWindowErrors.BrowserFlushScheduler;
-exports.FetchFileReader = require_catchWindowErrors.FetchFileReader;
+exports.BrowserFlushScheduler = require_componentProfiler.BrowserFlushScheduler;
+Object.defineProperty(exports, 'BrowserSpanType', {
+  enumerable: true,
+  get: function () {
+    return _flareapp_core.BrowserSpanType;
+  }
+});
+exports.FetchFileReader = require_componentProfiler.FetchFileReader;
 exports.Flare = Flare;
-exports.catchWindowErrors = require_catchWindowErrors.catchWindowErrors;
-exports.collectBrowser = require_catchWindowErrors.collectBrowser;
+exports.absoluteHref = require_componentProfiler.absoluteHref;
+exports.absoluteUrl = require_componentProfiler.absoluteUrl;
+exports.activeComponentRoot = require_componentProfiler.activeComponentRoot;
+exports.catchWindowErrors = require_componentProfiler.catchWindowErrors;
+exports.collectBrowser = require_componentProfiler.collectBrowser;
+exports.createFlareResolver = require_componentProfiler.createFlareResolver;
+exports.currentPath = require_componentProfiler.currentPath;
+exports.instrumentOnce = require_componentProfiler.instrumentOnce;
+exports.insulate = require_componentProfiler.insulate;
+exports.nowNano = require_componentProfiler.nowNano;
+exports.recordComponentSpan = require_componentProfiler.recordComponentSpan;
+exports.registerNavigationSource = require_componentProfiler.registerNavigationSource;
+exports.reserveSpanId = require_componentProfiler.reserveSpanId;
+exports.resolveComponentParent = require_componentProfiler.resolveComponentParent;
+exports.resolveHref = require_componentProfiler.resolveHref;
+exports.routeName = require_componentProfiler.routeName;
+exports.safeInvoke = require_componentProfiler.safeInvoke;

package/dist/browser.d.cts

@@ -1,9 +1,10 @@
-import { i as catchWindowErrors, n as FetchFileReader, r as collectBrowser, t as BrowserFlushScheduler } from "./BrowserFlushScheduler-CR7L8-z6.cjs";
-import { Api, ContextCollector, FileReader, Flare as Flare$1, ScopeProvider } from "@flareapp/core";
+import { C as collectBrowser, S as FetchFileReader, T as createFlareResolver, _ as RouteName, a as nowNano, b as routeName, c as resolveComponentParent, d as TrackTeardown, f as instrumentOnce, g as NavigationSource, h as registerNavigationSource, i as activeComponentRoot, l as absoluteHref, m as safeInvoke, n as ComponentSpanRecord, o as recordComponentSpan, p as insulate, r as ComponentTraceContext, s as reserveSpanId, t as BrowserSpanType, u as absoluteUrl, v as currentPath, w as catchWindowErrors, x as BrowserFlushScheduler, y as resolveHref } from "./spanTypes-iA1RdfLw.cjs";
+import { Api, Config, ContextCollector, FileReader, Flare as Flare$1, ScopeProvider } from "@flareapp/core";
 
 //#region src/browser.d.ts
 declare class Flare extends Flare$1 {
   constructor(api?: Api, contextCollector?: ContextCollector, fileReader?: FileReader, scopeProvider?: ScopeProvider);
+  configure(config: Partial<Config>): this;
 }
 //#endregion
-export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };
+export { BrowserFlushScheduler, BrowserSpanType, type ComponentSpanRecord, type ComponentTraceContext, FetchFileReader, Flare, type NavigationSource, type RouteName, type TrackTeardown, absoluteHref, absoluteUrl, activeComponentRoot, catchWindowErrors, collectBrowser, createFlareResolver, currentPath, instrumentOnce, insulate, nowNano, recordComponentSpan, registerNavigationSource, reserveSpanId, resolveComponentParent, resolveHref, routeName, safeInvoke };

package/dist/browser.d.mts

@@ -1,9 +1,10 @@
-import { i as catchWindowErrors, n as FetchFileReader, r as collectBrowser, t as BrowserFlushScheduler } from "./BrowserFlushScheduler-CZiDvxtf.mjs";
-import { Api, ContextCollector, FileReader, Flare as Flare$1, ScopeProvider } from "@flareapp/core";
+import { C as collectBrowser, S as FetchFileReader, T as createFlareResolver, _ as RouteName, a as nowNano, b as routeName, c as resolveComponentParent, d as TrackTeardown, f as instrumentOnce, g as NavigationSource, h as registerNavigationSource, i as activeComponentRoot, l as absoluteHref, m as safeInvoke, n as ComponentSpanRecord, o as recordComponentSpan, p as insulate, r as ComponentTraceContext, s as reserveSpanId, t as BrowserSpanType, u as absoluteUrl, v as currentPath, w as catchWindowErrors, x as BrowserFlushScheduler, y as resolveHref } from "./spanTypes-CjF1_Uqi.mjs";
+import { Api, Config, ContextCollector, FileReader, Flare as Flare$1, ScopeProvider } from "@flareapp/core";
 
 //#region src/browser.d.ts
 declare class Flare extends Flare$1 {
   constructor(api?: Api, contextCollector?: ContextCollector, fileReader?: FileReader, scopeProvider?: ScopeProvider);
+  configure(config: Partial<Config>): this;
 }
 //#endregion
-export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };
+export { BrowserFlushScheduler, BrowserSpanType, type ComponentSpanRecord, type ComponentTraceContext, FetchFileReader, Flare, type NavigationSource, type RouteName, type TrackTeardown, absoluteHref, absoluteUrl, activeComponentRoot, catchWindowErrors, collectBrowser, createFlareResolver, currentPath, instrumentOnce, insulate, nowNano, recordComponentSpan, registerNavigationSource, reserveSpanId, resolveComponentParent, resolveHref, routeName, safeInvoke };

package/dist/browser.mjs

@@ -1,5 +1,5 @@
-import { a as BrowserFlushScheduler, i as collectBrowser, n as CLIENT_VERSION, r as FetchFileReader, t as catchWindowErrors } from "./catchWindowErrors-DaCqd2yC.mjs";
-import { Api, Flare as Flare$1, GlobalScopeProvider } from "@flareapp/core";
+import { C as safeInvoke, D as BrowserFlushScheduler, E as collectBrowser, S as insulate, T as FetchFileReader, _ as unpatchXHR, a as resolveComponentParent, b as BrowserSpanType, c as registerNavigationSource, d as currentPath, f as resolveHref, g as instrumentXHR, h as absoluteUrl, i as reserveSpanId, l as startBrowserTracing, m as absoluteHref, n as nowNano, o as catchWindowErrors, p as routeName, r as recordComponentSpan, s as createFlareResolver, t as activeComponentRoot, u as stopBrowserTracing, v as instrumentFetch, w as CLIENT_VERSION, x as instrumentOnce, y as unpatchFetch } from "./componentProfiler-CoH2m13n.mjs";
+import { Api, Flare as Flare$1, FrameworkName, GlobalScopeProvider } from "@flareapp/core";
 
 //#region src/browser.ts
 var Flare = class extends Flare$1 {
@@ -9,8 +9,24 @@ var Flare = class extends Flare$1 {
 			name: "@flareapp/js",
 			version: CLIENT_VERSION
 		});
+		this.setFramework({ name: FrameworkName.Js });
+	}
+	configure(config) {
+		const wasTracing = this.config.enableTracing;
+		super.configure(config);
+		const nowTracing = this.config.enableTracing;
+		if (!wasTracing && nowTracing) {
+			instrumentFetch(this);
+			instrumentXHR(this);
+			startBrowserTracing(this);
+		} else if (wasTracing && !nowTracing) {
+			stopBrowserTracing();
+			unpatchFetch();
+			unpatchXHR();
+		}
+		return this;
 	}
 };
 
 //#endregion
-export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };
+export { BrowserFlushScheduler, BrowserSpanType, FetchFileReader, Flare, absoluteHref, absoluteUrl, activeComponentRoot, catchWindowErrors, collectBrowser, createFlareResolver, currentPath, instrumentOnce, insulate, nowNano, recordComponentSpan, registerNavigationSource, reserveSpanId, resolveComponentParent, resolveHref, routeName, safeInvoke };