@flareapp/js 2.2.1 → 2.4.0

package/README.md

@@ -1,7 +1,8 @@
 # @flareapp/js
 
-The core JavaScript/TypeScript client for [Flare](https://flareapp.io) error tracking. Captures frontend errors, parses
-stack traces, collects browser context, and reports everything to the Flare backend.
+The core JavaScript/TypeScript client for [Flare](https://flareapp.io) error tracking and logging. Captures frontend
+errors, parses stack traces, collects browser context, sends structured logs, and reports everything to the Flare
+backend.
 
 ## Installation
 
@@ -20,6 +21,20 @@ flare.light('YOUR_FLARE_API_KEY');
 That is all you need. The client automatically listens for uncaught exceptions and unhandled promise rejections,
 collects browser context, and sends error reports to Flare.
 
+## Logging
+
+Beyond errors, the client can send structured logs. Logs are opt-in: enable them with `enableLogs`, then call any of
+the eight syslog levels (`debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency`).
+
+```js
+flare.configure({ enableLogs: true });
+
+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.
+
 ## Documentation
 
 Full documentation on configuration, hooks, context, breadcrumbs, solution providers, and more is available

package/dist/BrowserFlushScheduler-CR7L8-z6.d.cts

@@ -0,0 +1,43 @@
+import { ContextCollector, FileReader, FlushFn, FlushScheduler } from "@flareapp/core";
+
+//#region src/browser/catchWindowErrors.d.ts
+declare function catchWindowErrors(): void;
+//#endregion
+//#region src/browser/context/collectBrowser.d.ts
+declare const collectBrowser: ContextCollector;
+//#endregion
+//#region src/browser/FetchFileReader.d.ts
+/**
+ * Browser `FileReader` implementation that fetches source files over HTTP(S).
+ *
+ * Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
+ * the original source for each frame and render a code snippet around the
+ * offending line. The source URL comes from the frame (usually the URL of
+ * the JS bundle that produced the error, post-sourcemap resolution).
+ *
+ * Three safety gates:
+ *
+ * 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
+ *    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
+ *    `null` immediately. This avoids surprise privilege boundaries (e.g.,
+ *    pages should not read extension-internal files) and dodges CORS/CSP
+ *    walls that would error noisily.
+ * 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
+ *    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
+ *    snippet is simply omitted from the report.
+ * 3. **Catch-all.** Network failures, CORS errors, and aborted requests
+ *    return `null`. We never let a source-fetch failure leak as an error
+ *    that the consumer page would see.
+ *
+ * The `read()` contract returns `null` on any failure path, never throws.
+ */
+declare class FetchFileReader implements FileReader {
+  read(url: string): Promise<string | null>;
+}
+//#endregion
+//#region src/browser/BrowserFlushScheduler.d.ts
+declare class BrowserFlushScheduler implements FlushScheduler {
+  register(flush: FlushFn): void;
+}
+//#endregion
+export { catchWindowErrors as i, FetchFileReader as n, collectBrowser as r, BrowserFlushScheduler as t };

package/dist/BrowserFlushScheduler-CZiDvxtf.d.mts

@@ -0,0 +1,43 @@
+import { ContextCollector, FileReader, FlushFn, FlushScheduler } from "@flareapp/core";
+
+//#region src/browser/catchWindowErrors.d.ts
+declare function catchWindowErrors(): void;
+//#endregion
+//#region src/browser/context/collectBrowser.d.ts
+declare const collectBrowser: ContextCollector;
+//#endregion
+//#region src/browser/FetchFileReader.d.ts
+/**
+ * Browser `FileReader` implementation that fetches source files over HTTP(S).
+ *
+ * Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
+ * the original source for each frame and render a code snippet around the
+ * offending line. The source URL comes from the frame (usually the URL of
+ * the JS bundle that produced the error, post-sourcemap resolution).
+ *
+ * Three safety gates:
+ *
+ * 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
+ *    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
+ *    `null` immediately. This avoids surprise privilege boundaries (e.g.,
+ *    pages should not read extension-internal files) and dodges CORS/CSP
+ *    walls that would error noisily.
+ * 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
+ *    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
+ *    snippet is simply omitted from the report.
+ * 3. **Catch-all.** Network failures, CORS errors, and aborted requests
+ *    return `null`. We never let a source-fetch failure leak as an error
+ *    that the consumer page would see.
+ *
+ * The `read()` contract returns `null` on any failure path, never throws.
+ */
+declare class FetchFileReader implements FileReader {
+  read(url: string): Promise<string | null>;
+}
+//#endregion
+//#region src/browser/BrowserFlushScheduler.d.ts
+declare class BrowserFlushScheduler implements FlushScheduler {
+  register(flush: FlushFn): void;
+}
+//#endregion
+export { catchWindowErrors as i, FetchFileReader as n, collectBrowser as r, BrowserFlushScheduler as t };

package/dist/browser.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_catchWindowErrors = require('./catchWindowErrors-CTX8goVc.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());
+		this.setSdkInfo({
+			name: "@flareapp/js",
+			version: require_catchWindowErrors.CLIENT_VERSION
+		});
+	}
+};
+
+//#endregion
+exports.BrowserFlushScheduler = require_catchWindowErrors.BrowserFlushScheduler;
+exports.FetchFileReader = require_catchWindowErrors.FetchFileReader;
+exports.Flare = Flare;
+exports.catchWindowErrors = require_catchWindowErrors.catchWindowErrors;
+exports.collectBrowser = require_catchWindowErrors.collectBrowser;

package/dist/browser.d.cts

@@ -0,0 +1,9 @@
+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";
+
+//#region src/browser.d.ts
+declare class Flare extends Flare$1 {
+  constructor(api?: Api, contextCollector?: ContextCollector, fileReader?: FileReader, scopeProvider?: ScopeProvider);
+}
+//#endregion
+export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };

package/dist/browser.d.mts

@@ -0,0 +1,9 @@
+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";
+
+//#region src/browser.d.ts
+declare class Flare extends Flare$1 {
+  constructor(api?: Api, contextCollector?: ContextCollector, fileReader?: FileReader, scopeProvider?: ScopeProvider);
+}
+//#endregion
+export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };

package/dist/browser.mjs

@@ -0,0 +1,16 @@
+import { a as BrowserFlushScheduler, i as collectBrowser, n as CLIENT_VERSION, r as FetchFileReader, t as catchWindowErrors } from "./catchWindowErrors-DKjw0DIA.mjs";
+import { Api, Flare as Flare$1, GlobalScopeProvider } from "@flareapp/core";
+
+//#region src/browser.ts
+var Flare = class extends Flare$1 {
+	constructor(api = new Api(), contextCollector = collectBrowser, fileReader = new FetchFileReader(), scopeProvider = new GlobalScopeProvider()) {
+		super(api, contextCollector, fileReader, scopeProvider, new BrowserFlushScheduler());
+		this.setSdkInfo({
+			name: "@flareapp/js",
+			version: CLIENT_VERSION
+		});
+	}
+};
+
+//#endregion
+export { BrowserFlushScheduler, FetchFileReader, Flare, catchWindowErrors, collectBrowser };

package/dist/catchWindowErrors-CTX8goVc.cjs

@@ -0,0 +1,180 @@
+let _flareapp_core = require("@flareapp/core");
+
+//#region src/browser/BrowserFlushScheduler.ts
+var BrowserFlushScheduler = class {
+	register(flush) {
+		if (typeof document === "undefined" || !document) return;
+		document.addEventListener("visibilitychange", () => {
+			if (document.visibilityState === "hidden") flush({ keepalive: true });
+		});
+	}
+};
+
+//#endregion
+//#region src/browser/context/cookie.ts
+function cookie() {
+	if (!window.document.cookie) return {};
+	const cookies = {};
+	window.document.cookie.split("; ").forEach((rawCookie) => {
+		const idx = rawCookie.indexOf("=");
+		if (idx === -1) {
+			cookies[rawCookie] = "";
+			return;
+		}
+		const name = rawCookie.slice(0, idx);
+		cookies[name] = rawCookie.slice(idx + 1);
+	});
+	return { "http.request.cookies": cookies };
+}
+
+//#endregion
+//#region src/browser/context/request.ts
+function request(urlDenylist) {
+	return {
+		"url.full": (0, _flareapp_core.redactUrlQuery)(window.location.href, urlDenylist),
+		"user_agent.original": window.navigator.userAgent,
+		"http.request.referrer": (0, _flareapp_core.redactUrlQuery)(window.document.referrer, urlDenylist),
+		"document.ready_state": window.document.readyState
+	};
+}
+
+//#endregion
+//#region src/browser/context/requestData.ts
+function requestData(urlDenylist) {
+	if (!window.location.search) return {};
+	return { "url.query": (0, _flareapp_core.redactUrlQuery)(window.location.search, urlDenylist).replace(/^\?/, "") };
+}
+
+//#endregion
+//#region src/browser/context/collectBrowser.ts
+const collectBrowser = (config) => {
+	if (typeof window === "undefined") return { "flare.entry_point.type": "server" };
+	const attrs = { "flare.entry_point.type": "web" };
+	if (window?.location?.href) {
+		attrs["flare.entry_point.value"] = (0, _flareapp_core.redactUrlQuery)(window.location.href, config.urlDenylist);
+		if (window.location.pathname) {
+			attrs["flare.entry_point.handler.identifier"] = window.location.pathname;
+			attrs["flare.entry_point.handler.type"] = "browser";
+		}
+	}
+	if (window?.location?.hostname) attrs["host.name"] = window.location.hostname;
+	Object.assign(attrs, request(config.urlDenylist));
+	Object.assign(attrs, requestData(config.urlDenylist));
+	Object.assign(attrs, cookie());
+	return attrs;
+};
+
+//#endregion
+//#region src/browser/FetchFileReader.ts
+/**
+* Browser `FileReader` implementation that fetches source files over HTTP(S).
+*
+* Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
+* the original source for each frame and render a code snippet around the
+* offending line. The source URL comes from the frame (usually the URL of
+* the JS bundle that produced the error, post-sourcemap resolution).
+*
+* Three safety gates:
+*
+* 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
+*    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
+*    `null` immediately. This avoids surprise privilege boundaries (e.g.,
+*    pages should not read extension-internal files) and dodges CORS/CSP
+*    walls that would error noisily.
+* 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
+*    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
+*    snippet is simply omitted from the report.
+* 3. **Catch-all.** Network failures, CORS errors, and aborted requests
+*    return `null`. We never let a source-fetch failure leak as an error
+*    that the consumer page would see.
+*
+* The `read()` contract returns `null` on any failure path, never throws.
+*/
+var FetchFileReader = class {
+	read(url) {
+		if (!/^https?:\/\//i.test(url)) return Promise.resolve(null);
+		return fetch(url).then((response) => {
+			if (response.status !== 200) return null;
+			return response.text();
+		}).catch(() => null);
+	}
+};
+
+//#endregion
+//#region src/env/index.ts
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.4.0" : "?";
+
+//#endregion
+//#region src/browser/catchWindowErrors.ts
+function catchWindowErrors() {
+	if (typeof window === "undefined") return;
+	window.addEventListener("error", (event) => {
+		const flare = window.flare;
+		if (!flare) return;
+		if (event.error instanceof Error) flare.reportSilently(event.error);
+	});
+	window.addEventListener("unhandledrejection", (event) => {
+		const flare = window.flare;
+		if (!flare) return;
+		const reason = event.reason;
+		if (reason instanceof Error) {
+			flare.reportSilently(reason);
+			return;
+		}
+		if (hasStack(reason)) {
+			const error = new Error(describeRejectionReason(reason));
+			error.stack = reason.stack;
+			flare.reportSilently(error);
+			return;
+		}
+		Promise.resolve(flare.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
+	});
+}
+function describeRejectionReason(reason) {
+	if (typeof reason === "string") return reason;
+	if (reason && typeof reason === "object") {
+		const message = reason.message;
+		if (typeof message === "string") return message;
+		try {
+			return JSON.stringify(reason);
+		} catch {
+			return "Unhandled promise rejection (non-serializable reason)";
+		}
+	}
+	return String(reason);
+}
+function hasStack(value) {
+	return typeof value === "object" && value !== null && "stack" in value && typeof value.stack === "string";
+}
+
+//#endregion
+Object.defineProperty(exports, 'BrowserFlushScheduler', {
+  enumerable: true,
+  get: function () {
+    return BrowserFlushScheduler;
+  }
+});
+Object.defineProperty(exports, 'CLIENT_VERSION', {
+  enumerable: true,
+  get: function () {
+    return CLIENT_VERSION;
+  }
+});
+Object.defineProperty(exports, 'FetchFileReader', {
+  enumerable: true,
+  get: function () {
+    return FetchFileReader;
+  }
+});
+Object.defineProperty(exports, 'catchWindowErrors', {
+  enumerable: true,
+  get: function () {
+    return catchWindowErrors;
+  }
+});
+Object.defineProperty(exports, 'collectBrowser', {
+  enumerable: true,
+  get: function () {
+    return collectBrowser;
+  }
+});

package/dist/catchWindowErrors-DKjw0DIA.mjs

@@ -0,0 +1,151 @@
+import { redactUrlQuery } from "@flareapp/core";
+
+//#region src/browser/BrowserFlushScheduler.ts
+var BrowserFlushScheduler = class {
+	register(flush) {
+		if (typeof document === "undefined" || !document) return;
+		document.addEventListener("visibilitychange", () => {
+			if (document.visibilityState === "hidden") flush({ keepalive: true });
+		});
+	}
+};
+
+//#endregion
+//#region src/browser/context/cookie.ts
+function cookie() {
+	if (!window.document.cookie) return {};
+	const cookies = {};
+	window.document.cookie.split("; ").forEach((rawCookie) => {
+		const idx = rawCookie.indexOf("=");
+		if (idx === -1) {
+			cookies[rawCookie] = "";
+			return;
+		}
+		const name = rawCookie.slice(0, idx);
+		cookies[name] = rawCookie.slice(idx + 1);
+	});
+	return { "http.request.cookies": cookies };
+}
+
+//#endregion
+//#region src/browser/context/request.ts
+function request(urlDenylist) {
+	return {
+		"url.full": redactUrlQuery(window.location.href, urlDenylist),
+		"user_agent.original": window.navigator.userAgent,
+		"http.request.referrer": redactUrlQuery(window.document.referrer, urlDenylist),
+		"document.ready_state": window.document.readyState
+	};
+}
+
+//#endregion
+//#region src/browser/context/requestData.ts
+function requestData(urlDenylist) {
+	if (!window.location.search) return {};
+	return { "url.query": redactUrlQuery(window.location.search, urlDenylist).replace(/^\?/, "") };
+}
+
+//#endregion
+//#region src/browser/context/collectBrowser.ts
+const collectBrowser = (config) => {
+	if (typeof window === "undefined") return { "flare.entry_point.type": "server" };
+	const attrs = { "flare.entry_point.type": "web" };
+	if (window?.location?.href) {
+		attrs["flare.entry_point.value"] = redactUrlQuery(window.location.href, config.urlDenylist);
+		if (window.location.pathname) {
+			attrs["flare.entry_point.handler.identifier"] = window.location.pathname;
+			attrs["flare.entry_point.handler.type"] = "browser";
+		}
+	}
+	if (window?.location?.hostname) attrs["host.name"] = window.location.hostname;
+	Object.assign(attrs, request(config.urlDenylist));
+	Object.assign(attrs, requestData(config.urlDenylist));
+	Object.assign(attrs, cookie());
+	return attrs;
+};
+
+//#endregion
+//#region src/browser/FetchFileReader.ts
+/**
+* Browser `FileReader` implementation that fetches source files over HTTP(S).
+*
+* Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
+* the original source for each frame and render a code snippet around the
+* offending line. The source URL comes from the frame (usually the URL of
+* the JS bundle that produced the error, post-sourcemap resolution).
+*
+* Three safety gates:
+*
+* 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
+*    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
+*    `null` immediately. This avoids surprise privilege boundaries (e.g.,
+*    pages should not read extension-internal files) and dodges CORS/CSP
+*    walls that would error noisily.
+* 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
+*    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
+*    snippet is simply omitted from the report.
+* 3. **Catch-all.** Network failures, CORS errors, and aborted requests
+*    return `null`. We never let a source-fetch failure leak as an error
+*    that the consumer page would see.
+*
+* The `read()` contract returns `null` on any failure path, never throws.
+*/
+var FetchFileReader = class {
+	read(url) {
+		if (!/^https?:\/\//i.test(url)) return Promise.resolve(null);
+		return fetch(url).then((response) => {
+			if (response.status !== 200) return null;
+			return response.text();
+		}).catch(() => null);
+	}
+};
+
+//#endregion
+//#region src/env/index.ts
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.4.0" : "?";
+
+//#endregion
+//#region src/browser/catchWindowErrors.ts
+function catchWindowErrors() {
+	if (typeof window === "undefined") return;
+	window.addEventListener("error", (event) => {
+		const flare = window.flare;
+		if (!flare) return;
+		if (event.error instanceof Error) flare.reportSilently(event.error);
+	});
+	window.addEventListener("unhandledrejection", (event) => {
+		const flare = window.flare;
+		if (!flare) return;
+		const reason = event.reason;
+		if (reason instanceof Error) {
+			flare.reportSilently(reason);
+			return;
+		}
+		if (hasStack(reason)) {
+			const error = new Error(describeRejectionReason(reason));
+			error.stack = reason.stack;
+			flare.reportSilently(error);
+			return;
+		}
+		Promise.resolve(flare.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
+	});
+}
+function describeRejectionReason(reason) {
+	if (typeof reason === "string") return reason;
+	if (reason && typeof reason === "object") {
+		const message = reason.message;
+		if (typeof message === "string") return message;
+		try {
+			return JSON.stringify(reason);
+		} catch {
+			return "Unhandled promise rejection (non-serializable reason)";
+		}
+	}
+	return String(reason);
+}
+function hasStack(value) {
+	return typeof value === "object" && value !== null && "stack" in value && typeof value.stack === "string";
+}
+
+//#endregion
+export { BrowserFlushScheduler as a, collectBrowser as i, CLIENT_VERSION as n, FetchFileReader as r, catchWindowErrors as t };

package/dist/index.cjs

@@ -1,156 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_catchWindowErrors = require('./catchWindowErrors-CTX8goVc.cjs');
+const require_browser = require('./browser.cjs');
 let _flareapp_core = require("@flareapp/core");
 
-//#region src/browser/catchWindowErrors.ts
-function catchWindowErrors() {
-	if (typeof window === "undefined") return;
-	window.addEventListener("error", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		if (event.error instanceof Error) flare.reportSilently(event.error);
-	});
-	window.addEventListener("unhandledrejection", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		const reason = event.reason;
-		if (reason instanceof Error) {
-			flare.reportSilently(reason);
-			return;
-		}
-		if (hasStack(reason)) {
-			const error = new Error(describeRejectionReason(reason));
-			error.stack = reason.stack;
-			flare.reportSilently(error);
-			return;
-		}
-		Promise.resolve(flare.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
-	});
-}
-function describeRejectionReason(reason) {
-	if (typeof reason === "string") return reason;
-	if (reason && typeof reason === "object") {
-		const message = reason.message;
-		if (typeof message === "string") return message;
-		try {
-			return JSON.stringify(reason);
-		} catch {
-			return "Unhandled promise rejection (non-serializable reason)";
-		}
-	}
-	return String(reason);
-}
-function hasStack(value) {
-	return typeof value === "object" && value !== null && "stack" in value && typeof value.stack === "string";
-}
-
-//#endregion
-//#region src/browser/context/cookie.ts
-function cookie() {
-	if (!window.document.cookie) return {};
-	const cookies = {};
-	window.document.cookie.split("; ").forEach((rawCookie) => {
-		const idx = rawCookie.indexOf("=");
-		if (idx === -1) {
-			cookies[rawCookie] = "";
-			return;
-		}
-		const name = rawCookie.slice(0, idx);
-		cookies[name] = rawCookie.slice(idx + 1);
-	});
-	return { "http.request.cookies": cookies };
-}
-
-//#endregion
-//#region src/browser/context/request.ts
-function request(urlDenylist) {
-	return {
-		"url.full": (0, _flareapp_core.redactUrlQuery)(window.location.href, urlDenylist),
-		"user_agent.original": window.navigator.userAgent,
-		"http.request.referrer": (0, _flareapp_core.redactUrlQuery)(window.document.referrer, urlDenylist),
-		"document.ready_state": window.document.readyState
-	};
-}
-
-//#endregion
-//#region src/browser/context/requestData.ts
-function requestData(urlDenylist) {
-	if (!window.location.search) return {};
-	return { "url.query": (0, _flareapp_core.redactUrlQuery)(window.location.search, urlDenylist).replace(/^\?/, "") };
-}
-
-//#endregion
-//#region src/browser/context/collectBrowser.ts
-const collectBrowser = (config) => {
-	if (typeof window === "undefined") return { "flare.entry_point.type": "server" };
-	const attrs = { "flare.entry_point.type": "web" };
-	if (window?.location?.href) {
-		attrs["flare.entry_point.value"] = (0, _flareapp_core.redactUrlQuery)(window.location.href, config.urlDenylist);
-		if (window.location.pathname) {
-			attrs["flare.entry_point.handler.identifier"] = window.location.pathname;
-			attrs["flare.entry_point.handler.type"] = "browser";
-		}
-	}
-	Object.assign(attrs, request(config.urlDenylist));
-	Object.assign(attrs, requestData(config.urlDenylist));
-	Object.assign(attrs, cookie());
-	return attrs;
-};
-
-//#endregion
-//#region src/browser/FetchFileReader.ts
-/**
-* Browser `FileReader` implementation that fetches source files over HTTP(S).
-*
-* Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
-* the original source for each frame and render a code snippet around the
-* offending line. The source URL comes from the frame (usually the URL of
-* the JS bundle that produced the error, post-sourcemap resolution).
-*
-* Three safety gates:
-*
-* 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
-*    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
-*    `null` immediately. This avoids surprise privilege boundaries (e.g.,
-*    pages should not read extension-internal files) and dodges CORS/CSP
-*    walls that would error noisily.
-* 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
-*    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
-*    snippet is simply omitted from the report.
-* 3. **Catch-all.** Network failures, CORS errors, and aborted requests
-*    return `null`. We never let a source-fetch failure leak as an error
-*    that the consumer page would see.
-*
-* The `read()` contract returns `null` on any failure path, never throws.
-*/
-var FetchFileReader = class {
-	read(url) {
-		if (!/^https?:\/\//i.test(url)) return Promise.resolve(null);
-		return fetch(url).then((response) => {
-			if (response.status !== 200) return null;
-			return response.text();
-		}).catch(() => null);
-	}
-};
-
-//#endregion
-//#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.2.1" : "?";
-
-//#endregion
 //#region src/index.ts
-var Flare = class extends _flareapp_core.Flare {
-	constructor(api = new _flareapp_core.Api(), contextCollector = collectBrowser, fileReader = new FetchFileReader(), scopeProvider = new _flareapp_core.GlobalScopeProvider()) {
-		super(api, contextCollector, fileReader, scopeProvider);
-		this.setSdkInfo({
-			name: "@flareapp/js",
-			version: CLIENT_VERSION
-		});
-	}
-};
-const flare = new Flare();
+const flare = new require_browser.Flare();
 if (typeof window !== "undefined" && window) {
 	window.flare = flare;
-	catchWindowErrors();
+	require_catchWindowErrors.catchWindowErrors();
 }
 
 //#endregion
@@ -160,13 +17,19 @@ Object.defineProperty(exports, 'DEFAULT_URL_DENYLIST', {
     return _flareapp_core.DEFAULT_URL_DENYLIST;
   }
 });
-exports.Flare = Flare;
+exports.Flare = require_browser.Flare;
 Object.defineProperty(exports, 'GlobalScopeProvider', {
   enumerable: true,
   get: function () {
     return _flareapp_core.GlobalScopeProvider;
   }
 });
+Object.defineProperty(exports, 'Logger', {
+  enumerable: true,
+  get: function () {
+    return _flareapp_core.Logger;
+  }
+});
 Object.defineProperty(exports, 'NullFileReader', {
   enumerable: true,
   get: function () {

package/dist/index.d.cts

@@ -1,9 +1,7 @@
-import { Api, AttributeValue, Attributes, Config, ContextCollector, ContextCollector as ContextCollector$1, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FileReader as FileReader$1, Flare as Flare$1, Framework, GlobalScopeProvider, Glow, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, ScopeProvider as ScopeProvider$1, SdkInfo, SpanEvent, StackFrame, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
+import { Flare } from "./browser.cjs";
+import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
 
 //#region src/index.d.ts
-declare class Flare extends Flare$1 {
-  constructor(api?: Api, contextCollector?: ContextCollector$1, fileReader?: FileReader$1, scopeProvider?: ScopeProvider$1);
-}
 declare const flare: Flare;
 //#endregion
-export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type Framework, GlobalScopeProvider, type Glow, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };

package/dist/index.d.mts

@@ -1,9 +1,7 @@
-import { Api, AttributeValue, Attributes, Config, ContextCollector, ContextCollector as ContextCollector$1, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FileReader as FileReader$1, Flare as Flare$1, Framework, GlobalScopeProvider, Glow, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, ScopeProvider as ScopeProvider$1, SdkInfo, SpanEvent, StackFrame, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
+import { Flare } from "./browser.mjs";
+import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
 
 //#region src/index.d.ts
-declare class Flare extends Flare$1 {
-  constructor(api?: Api, contextCollector?: ContextCollector$1, fileReader?: FileReader$1, scopeProvider?: ScopeProvider$1);
-}
 declare const flare: Flare;
 //#endregion
-export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type Framework, GlobalScopeProvider, type Glow, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };

package/dist/index.mjs

@@ -1,151 +1,8 @@
-import { Api, DEFAULT_URL_DENYLIST, Flare as Flare$1, GlobalScopeProvider, GlobalScopeProvider as GlobalScopeProvider$1, NullFileReader, Scope, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, redactUrlQuery as redactUrlQuery$1, resolveDenylist } from "@flareapp/core";
+import { t as catchWindowErrors } from "./catchWindowErrors-DKjw0DIA.mjs";
+import { Flare } from "./browser.mjs";
+import { DEFAULT_URL_DENYLIST, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
 
-//#region src/browser/catchWindowErrors.ts
-function catchWindowErrors() {
-	if (typeof window === "undefined") return;
-	window.addEventListener("error", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		if (event.error instanceof Error) flare.reportSilently(event.error);
-	});
-	window.addEventListener("unhandledrejection", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		const reason = event.reason;
-		if (reason instanceof Error) {
-			flare.reportSilently(reason);
-			return;
-		}
-		if (hasStack(reason)) {
-			const error = new Error(describeRejectionReason(reason));
-			error.stack = reason.stack;
-			flare.reportSilently(error);
-			return;
-		}
-		Promise.resolve(flare.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
-	});
-}
-function describeRejectionReason(reason) {
-	if (typeof reason === "string") return reason;
-	if (reason && typeof reason === "object") {
-		const message = reason.message;
-		if (typeof message === "string") return message;
-		try {
-			return JSON.stringify(reason);
-		} catch {
-			return "Unhandled promise rejection (non-serializable reason)";
-		}
-	}
-	return String(reason);
-}
-function hasStack(value) {
-	return typeof value === "object" && value !== null && "stack" in value && typeof value.stack === "string";
-}
-
-//#endregion
-//#region src/browser/context/cookie.ts
-function cookie() {
-	if (!window.document.cookie) return {};
-	const cookies = {};
-	window.document.cookie.split("; ").forEach((rawCookie) => {
-		const idx = rawCookie.indexOf("=");
-		if (idx === -1) {
-			cookies[rawCookie] = "";
-			return;
-		}
-		const name = rawCookie.slice(0, idx);
-		cookies[name] = rawCookie.slice(idx + 1);
-	});
-	return { "http.request.cookies": cookies };
-}
-
-//#endregion
-//#region src/browser/context/request.ts
-function request(urlDenylist) {
-	return {
-		"url.full": redactUrlQuery$1(window.location.href, urlDenylist),
-		"user_agent.original": window.navigator.userAgent,
-		"http.request.referrer": redactUrlQuery$1(window.document.referrer, urlDenylist),
-		"document.ready_state": window.document.readyState
-	};
-}
-
-//#endregion
-//#region src/browser/context/requestData.ts
-function requestData(urlDenylist) {
-	if (!window.location.search) return {};
-	return { "url.query": redactUrlQuery$1(window.location.search, urlDenylist).replace(/^\?/, "") };
-}
-
-//#endregion
-//#region src/browser/context/collectBrowser.ts
-const collectBrowser = (config) => {
-	if (typeof window === "undefined") return { "flare.entry_point.type": "server" };
-	const attrs = { "flare.entry_point.type": "web" };
-	if (window?.location?.href) {
-		attrs["flare.entry_point.value"] = redactUrlQuery$1(window.location.href, config.urlDenylist);
-		if (window.location.pathname) {
-			attrs["flare.entry_point.handler.identifier"] = window.location.pathname;
-			attrs["flare.entry_point.handler.type"] = "browser";
-		}
-	}
-	Object.assign(attrs, request(config.urlDenylist));
-	Object.assign(attrs, requestData(config.urlDenylist));
-	Object.assign(attrs, cookie());
-	return attrs;
-};
-
-//#endregion
-//#region src/browser/FetchFileReader.ts
-/**
-* Browser `FileReader` implementation that fetches source files over HTTP(S).
-*
-* Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
-* the original source for each frame and render a code snippet around the
-* offending line. The source URL comes from the frame (usually the URL of
-* the JS bundle that produced the error, post-sourcemap resolution).
-*
-* Three safety gates:
-*
-* 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
-*    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
-*    `null` immediately. This avoids surprise privilege boundaries (e.g.,
-*    pages should not read extension-internal files) and dodges CORS/CSP
-*    walls that would error noisily.
-* 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
-*    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
-*    snippet is simply omitted from the report.
-* 3. **Catch-all.** Network failures, CORS errors, and aborted requests
-*    return `null`. We never let a source-fetch failure leak as an error
-*    that the consumer page would see.
-*
-* The `read()` contract returns `null` on any failure path, never throws.
-*/
-var FetchFileReader = class {
-	read(url) {
-		if (!/^https?:\/\//i.test(url)) return Promise.resolve(null);
-		return fetch(url).then((response) => {
-			if (response.status !== 200) return null;
-			return response.text();
-		}).catch(() => null);
-	}
-};
-
-//#endregion
-//#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.2.1" : "?";
-
-//#endregion
 //#region src/index.ts
-var Flare = class extends Flare$1 {
-	constructor(api = new Api(), contextCollector = collectBrowser, fileReader = new FetchFileReader(), scopeProvider = new GlobalScopeProvider$1()) {
-		super(api, contextCollector, fileReader, scopeProvider);
-		this.setSdkInfo({
-			name: "@flareapp/js",
-			version: CLIENT_VERSION
-		});
-	}
-};
 const flare = new Flare();
 if (typeof window !== "undefined" && window) {
 	window.flare = flare;
@@ -153,4 +10,4 @@ if (typeof window !== "undefined" && window) {
 }
 
 //#endregion
-export { DEFAULT_URL_DENYLIST, Flare, GlobalScopeProvider, NullFileReader, Scope, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { DEFAULT_URL_DENYLIST, Flare, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/js",
-    "version": "2.2.1",
+    "version": "2.4.0",
     "description": "JavaScript client for flareapp.io",
     "homepage": "https://flareapp.io",
     "bugs": {
@@ -39,17 +39,27 @@
                 "types": "./dist/index.d.cts",
                 "default": "./dist/index.cjs"
             }
+        },
+        "./browser": {
+            "import": {
+                "types": "./dist/browser.d.mts",
+                "default": "./dist/browser.mjs"
+            },
+            "require": {
+                "types": "./dist/browser.d.cts",
+                "default": "./dist/browser.cjs"
+            }
         }
     },
     "scripts": {
         "prepublishOnly": "npm run build",
-        "build": "tsdown src/index.ts --format cjs,esm --dts --env.FLARE_JS_CLIENT_VERSION=$(node -p \"require('./package.json').version\") --clean",
+        "build": "tsdown src/index.ts src/browser.ts --format cjs,esm --dts --env.FLARE_JS_CLIENT_VERSION=$(node -p \"require('./package.json').version\") --clean",
         "test": "vitest run",
         "typescript": "tsc --noEmit",
         "release": "release-it"
     },
     "dependencies": {
-        "@flareapp/core": "2.2.1"
+        "@flareapp/core": "2.4.0"
     },
     "devDependencies": {
         "error-stack-parser": "^2.0.2",