@fz-firefly/web 0.0.0-stage → 0.2.1

package/dist/index.js

@@ -0,0 +1,876 @@
+import { FireflyTransportError, captureHttpFailure, captureHttpRequest, createClient, installClickBreadcrumbs, installConsoleBreadcrumbs, installLifecycleBreadcrumbs, installResourceErrorHooks, isIngestRequestUrl, parseRetryAfter, resolveOptions, serializeHttpBody, serializeHttpResponseBody } from "@fz-firefly/core";
+// src/hooks/global-errors.ts
+/**
+* 安装全局错误钩子。
+*
+* 覆盖两类未捕获错误：
+* 1. window 'error'：运行时异常（资源加载失败由 resource-errors 单独处理）；
+* 2. window 'unhandledrejection'：未处理的 Promise 拒绝。
+*
+* 全部使用 addEventListener，不覆盖 window.onerror，
+* 业务自己挂的处理器仍然有效。
+*
+* @returns 卸载函数
+*/
+function installGlobalErrorHooks(client) {
+	const handleError = (event) => {
+		try {
+			const target = event.target;
+			if (target && typeof target.tagName === "string") return;
+			if (event.error) client.captureException(event.error);
+			else if (event.message) client.captureException(new Error(event.message));
+		} catch (_unused) {}
+	};
+	const handleRejection = (event) => {
+		try {
+			const reason = event.reason;
+			client.captureException(reason !== null && reason !== void 0 ? reason : /* @__PURE__ */ new Error("Unhandled promise rejection"));
+		} catch (_unused2) {}
+	};
+	window.addEventListener("error", handleError);
+	window.addEventListener("unhandledrejection", handleRejection);
+	return () => {
+		window.removeEventListener("error", handleError);
+		window.removeEventListener("unhandledrejection", handleRejection);
+	};
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+// src/hooks/http-errors.ts
+/** 响应头白名单，避免把 Set-Cookie 等敏感头带进监控。 */
+const RESPONSE_HEADER_WHITELIST = [
+	"content-type",
+	"content-length",
+	"x-request-id",
+	"x-trace-id",
+	"traceparent",
+	"x-b3-traceid"
+];
+/** 读取请求头里的 content-type，兼容 Headers / 数组 / 普通对象。 */
+function headerValue(headers, name) {
+	if (!headers) return "";
+	if (typeof Headers !== "undefined" && headers instanceof Headers) {
+		var _headers$get;
+		return (_headers$get = headers.get(name)) !== null && _headers$get !== void 0 ? _headers$get : "";
+	}
+	if (Array.isArray(headers)) {
+		var _pair$;
+		const pair = headers.find(([key]) => key.toLowerCase() === name);
+		return (_pair$ = pair === null || pair === void 0 ? void 0 : pair[1]) !== null && _pair$ !== void 0 ? _pair$ : "";
+	}
+	for (const [key, value] of Object.entries(headers)) if (key.toLowerCase() === name) return String(value);
+	return "";
+}
+/** 只保留白名单内的响应头。 */
+function pickResponseHeaders(headers) {
+	if (!headers) return void 0;
+	const result = {};
+	for (const name of RESPONSE_HEADER_WHITELIST) {
+		const value = headers.get(name);
+		if (value) result[name] = value;
+	}
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/** 从响应头里取 request id / trace id。 */
+function requestIdOf(headers) {
+	if (!headers) return void 0;
+	for (const name of [
+		"x-request-id",
+		"x-trace-id",
+		"traceparent",
+		"x-b3-traceid"
+	]) {
+		const value = headers.get(name);
+		if (value) return value;
+	}
+}
+/** 解析 content-length；非法值返回 undefined。 */
+function contentLengthOf(headers) {
+	const value = headers === null || headers === void 0 ? void 0 : headers.get("content-length");
+	if (!value) return void 0;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) && parsed >= 0 ? parsed : void 0;
+}
+/** 估算响应体大小，content-length 缺失时退化为字符数。 */
+function sizeOf(body) {
+	if (!body) return void 0;
+	if (typeof body.value === "string") return body.value.length;
+	try {
+		return JSON.stringify(body.value).length;
+	} catch (_unused) {
+		return;
+	}
+}
+/** 判断 fetch 抛出的错误是否只是主动取消。 */
+function isAbortError(error) {
+	return typeof error === "object" && error !== null && error.name === "AbortError";
+}
+/**
+* 准备一个按需读取请求体的函数。
+*
+* Request 的 clone 必须在 fetch 之前完成，但真正读取要等确认请求失败
+* 或确认是慢请求，避免成功请求也去读一遍 body。
+*/
+function prepareFetchBody(input, init, contentType, options) {
+	if ((init === null || init === void 0 ? void 0 : init.body) !== void 0 && init.body !== null) {
+		const body = init.body;
+		return async () => serializeHttpBody(body, contentType, options);
+	}
+	if (typeof Request !== "undefined" && input instanceof Request && input.body) try {
+		const clone = input.clone();
+		return async () => {
+			try {
+				const text = await clone.text();
+				return serializeHttpBody(text, contentType || "application/json", options);
+			} catch (_unused2) {
+				return;
+			}
+		};
+	} catch (_unused3) {}
+	return async () => void 0;
+}
+/** 单次响应体采集最多读取的字节数；避免为大文件把整个 body 读进内存。 */
+const MAX_RESPONSE_READ_BYTES = 524288;
+/** 响应体截断标记。 */
+const TRUNCATED_MARKER = "\n…[truncated]…\n";
+/** 与 shared 的 isTextContentType 对齐；用于在读取前跳过二进制。 */
+function isTextResponseContentType(contentType) {
+	const value = contentType.toLowerCase();
+	return value === "" || value.startsWith("text/") || value.includes("json") || value.includes("xml") || value.includes("javascript") || value.includes("x-www-form-urlencoded");
+}
+function isJsonResponseContentType(contentType) {
+	const value = contentType.toLowerCase();
+	return value.includes("application/json") || value.includes("+json");
+}
+function concatBytes(chunks, total) {
+	const bytes = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		bytes.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return bytes;
+}
+function decodeBytes(bytes) {
+	if (typeof TextDecoder !== "undefined") return new TextDecoder().decode(bytes);
+	let text = "";
+	for (let index = 0; index < bytes.length; index += 1) text += String.fromCharCode(bytes[index]);
+	return text;
+}
+/** 把文本压到 maxChars 以内，并尽量保留头部和尾部。 */
+function compactText(text, maxChars) {
+	if (text.length <= maxChars) return {
+		text,
+		truncated: false
+	};
+	const tailChars = Math.min(1024, Math.max(0, Math.floor(maxChars / 4)));
+	const headChars = Math.max(0, maxChars - tailChars - 15);
+	return {
+		text: `${text.slice(0, headChars)}${TRUNCATED_MARKER}${text.slice(-tailChars)}`,
+		truncated: true
+	};
+}
+/**
+* 从 clone 的 ReadableStream 限量读取响应体。
+*
+* 最多读 512KB，避免大文件把内存打满；文本超过 maxChars 时保留头尾，
+* 尾部通常包含错误码/错误提示，比单纯截断前 N 字符更有用。
+*/
+async function readLimitedResponseBody(clone, contentType, options) {
+	if (!isTextResponseContentType(contentType)) return void 0;
+	if (!clone.body) return void 0;
+	const reader = clone.body.getReader();
+	const chunks = [];
+	let total = 0;
+	let hitLimit = false;
+	try {
+		while (total < MAX_RESPONSE_READ_BYTES) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			if (!value || value.length === 0) continue;
+			const remaining = MAX_RESPONSE_READ_BYTES - total;
+			if (value.length > remaining) {
+				chunks.push(value.slice(0, remaining));
+				total += remaining;
+				hitLimit = true;
+				break;
+			}
+			chunks.push(value);
+			total += value.length;
+		}
+	} catch (_unused4) {
+		return;
+	} finally {
+		try {
+			await reader.cancel();
+		} catch (_unused5) {}
+	}
+	const text = decodeBytes(concatBytes(chunks, total));
+	const maxChars = options.maxChars && options.maxChars > 0 ? options.maxChars : 4096;
+	if (text.length <= maxChars) return serializeHttpResponseBody(text, contentType, _objectSpread2(_objectSpread2({}, options), {}, { maxChars }));
+	if (hitLimit && isJsonResponseContentType(contentType)) return;
+	if (isJsonResponseContentType(contentType)) {
+		const parsed = serializeHttpBody(text, contentType, _objectSpread2(_objectSpread2({}, options), {}, { maxChars: text.length + 1 }));
+		if (parsed) try {
+			const json = JSON.stringify(parsed.value);
+			if (json) return {
+				value: compactText(json, maxChars).text,
+				truncated: true
+			};
+		} catch (_unused6) {}
+	}
+	const compacted = compactText(text, maxChars);
+	const capture = serializeHttpResponseBody(compacted.text, contentType, _objectSpread2(_objectSpread2({}, options), {}, { maxChars }));
+	if (!capture) return void 0;
+	return {
+		value: capture.value,
+		truncated: capture.truncated || compacted.truncated || hitLimit
+	};
+}
+/** 自动记录请求日志、失败请求事件和慢请求面包屑。 */
+function installHttpErrorHooks(client, options) {
+	var _options$slowRequestT;
+	if (options.captureHttp === false) return () => {};
+	const captureBody = options.captureHttpBody !== false;
+	const captureResponseBody = options.captureHttpResponseBody !== false;
+	const requestBodyOptions = {
+		redactKeys: options.redactKeys,
+		maxChars: options.maxHttpBodyChars
+	};
+	const responseBodyOptions = {
+		redactKeys: options.redactKeys,
+		maxChars: options.maxHttpResponseChars
+	};
+	const slowThresholdMs = (_options$slowRequestT = options.slowRequestThresholdMs) !== null && _options$slowRequestT !== void 0 ? _options$slowRequestT : 1e3;
+	const restores = [];
+	installFetchHook(client, captureBody, captureResponseBody, requestBodyOptions, responseBodyOptions, slowThresholdMs, restores);
+	installXhrHook(client, captureBody, captureResponseBody, requestBodyOptions, responseBodyOptions, slowThresholdMs, restores);
+	return () => {
+		for (const restore of restores) restore();
+	};
+}
+function installFetchHook(client, captureBody, captureResponseBody, requestBodyOptions, responseBodyOptions, slowThresholdMs, restores) {
+	if (typeof window === "undefined" || typeof window.fetch !== "function") return;
+	const originalFetch = window.fetch;
+	const wrapped = async function(input, init) {
+		var _response$headers$get;
+		const request = typeof Request !== "undefined" && input instanceof Request ? input : void 0;
+		let method;
+		let url;
+		try {
+			var _ref, _init$method, _request$url;
+			method = ((_ref = (_init$method = init === null || init === void 0 ? void 0 : init.method) !== null && _init$method !== void 0 ? _init$method : request === null || request === void 0 ? void 0 : request.method) !== null && _ref !== void 0 ? _ref : "GET").toUpperCase();
+			url = (_request$url = request === null || request === void 0 ? void 0 : request.url) !== null && _request$url !== void 0 ? _request$url : String(input);
+		} catch (_unused7) {
+			return originalFetch.call(this, input, init);
+		}
+		if (isIngestRequestUrl(url)) return originalFetch.call(this, input, init);
+		let readBody = async () => void 0;
+		try {
+			const contentType = headerValue(init === null || init === void 0 ? void 0 : init.headers, "content-type") || (request === null || request === void 0 ? void 0 : request.headers.get("content-type")) || "";
+			readBody = captureBody ? prepareFetchBody(input, init, contentType, requestBodyOptions) : async () => void 0;
+		} catch (_unused8) {}
+		const startedAt = Date.now();
+		let response;
+		try {
+			response = await originalFetch.call(this, input, init);
+		} catch (error) {
+			if (!isAbortError(error)) (async () => {
+				try {
+					const requestBody = await readBody();
+					captureHttpFailure(client, {
+						method,
+						url,
+						statusCode: 0,
+						durationMs: Date.now() - startedAt,
+						category: "fetch",
+						startedAt,
+						requestBody: requestBody === null || requestBody === void 0 ? void 0 : requestBody.value,
+						requestBodyTruncated: requestBody === null || requestBody === void 0 ? void 0 : requestBody.truncated,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				} catch (_unused9) {}
+			})();
+			throw error;
+		}
+		const durationMs = Date.now() - startedAt;
+		const ok = response.status >= 200 && response.status < 400;
+		const slow = durationMs >= slowThresholdMs;
+		const responseContentType = (_response$headers$get = response.headers.get("content-type")) !== null && _response$headers$get !== void 0 ? _response$headers$get : "";
+		const responseHeaders = pickResponseHeaders(response.headers);
+		const requestId = requestIdOf(response.headers);
+		const responseSize = contentLengthOf(response.headers);
+		const capture = (requestBody, responseBody) => {
+			try {
+				captureHttpRequest(client, {
+					method,
+					url,
+					statusCode: response.status,
+					durationMs,
+					category: "fetch",
+					ok,
+					startedAt,
+					requestBody: requestBody === null || requestBody === void 0 ? void 0 : requestBody.value,
+					requestBodyTruncated: requestBody === null || requestBody === void 0 ? void 0 : requestBody.truncated,
+					responseBody: responseBody === null || responseBody === void 0 ? void 0 : responseBody.value,
+					responseBodyTruncated: responseBody === null || responseBody === void 0 ? void 0 : responseBody.truncated,
+					responseHeaders,
+					requestId,
+					responseSize: responseSize !== null && responseSize !== void 0 ? responseSize : sizeOf(responseBody),
+					slowThresholdMs
+				});
+			} catch (_unused10) {}
+		};
+		if (!(!ok || slow) || !captureBody && !captureResponseBody) {
+			capture();
+			return response;
+		}
+		let responseClone;
+		if (captureResponseBody) try {
+			responseClone = response.clone();
+		} catch (_unused11) {}
+		(async () => {
+			let requestBody;
+			if (captureBody) try {
+				requestBody = await readBody();
+			} catch (_unused12) {}
+			try {
+				const responseBody = responseClone ? await readLimitedResponseBody(responseClone, responseContentType, responseBodyOptions) : void 0;
+				capture(requestBody, responseBody);
+			} catch (_unused13) {
+				capture(requestBody, void 0);
+			}
+		})();
+		return response;
+	};
+	try {
+		window.fetch = wrapped;
+		restores.push(() => {
+			if (window.fetch === wrapped) window.fetch = originalFetch;
+		});
+	} catch (_unused14) {}
+}
+function installXhrHook(client, captureBody, captureResponseBody, requestBodyOptions, responseBodyOptions, slowThresholdMs, restores) {
+	if (typeof window === "undefined" || typeof window.XMLHttpRequest !== "function") return;
+	const XHR = window.XMLHttpRequest;
+	const meta = /* @__PURE__ */ new WeakMap();
+	const originalOpen = XHR.prototype.open;
+	const originalSend = XHR.prototype.send;
+	const originalSetRequestHeader = XHR.prototype.setRequestHeader;
+	const originalAbort = XHR.prototype.abort;
+	const wrappedOpen = function(method, url, async, username, password) {
+		if (isIngestRequestUrl(String(url))) {
+			meta.delete(this);
+			return originalOpen.call(this, method, url, async !== null && async !== void 0 ? async : true, username, password);
+		}
+		meta.set(this, {
+			method: String(method).toUpperCase(),
+			url: String(url),
+			contentType: "",
+			body: void 0,
+			startedAt: 0,
+			aborted: false
+		});
+		return originalOpen.call(this, method, url, async !== null && async !== void 0 ? async : true, username, password);
+	};
+	const wrappedSend = function(body) {
+		const info = meta.get(this);
+		if (!info) {
+			originalSend.call(this, body);
+			return;
+		}
+		info.body = body;
+		info.startedAt = Date.now();
+		const onLoadEnd = function() {
+			const current = meta.get(this);
+			if (!current || current.aborted) return;
+			try {
+				var _ref2, _ref3, _responseHeaders$xRe, _responseHeaders$cont, _contentLengthOfValue;
+				const status = this.status;
+				const ok = status >= 200 && status < 400;
+				const durationMs = Date.now() - current.startedAt;
+				const slow = durationMs >= slowThresholdMs;
+				const responseHeaders = parseXhrResponseHeaders(this);
+				const requestId = (_ref2 = (_ref3 = (_responseHeaders$xRe = responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["x-request-id"]) !== null && _responseHeaders$xRe !== void 0 ? _responseHeaders$xRe : responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["x-trace-id"]) !== null && _ref3 !== void 0 ? _ref3 : responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["traceparent"]) !== null && _ref2 !== void 0 ? _ref2 : responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["x-b3-traceid"];
+				const contentType = (_responseHeaders$cont = responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["content-type"]) !== null && _responseHeaders$cont !== void 0 ? _responseHeaders$cont : "";
+				const requestBodyCapture = (!ok || slow) && captureBody ? serializeHttpBody(current.body, current.contentType, requestBodyOptions) : void 0;
+				const responseBodyCapture = (!ok || slow) && captureResponseBody ? serializeXhrResponseBody(this, contentType, responseBodyOptions) : void 0;
+				captureHttpRequest(client, _objectSpread2({
+					method: current.method,
+					url: current.url,
+					statusCode: status,
+					durationMs,
+					category: "xhr",
+					ok,
+					startedAt: current.startedAt,
+					requestBody: requestBodyCapture === null || requestBodyCapture === void 0 ? void 0 : requestBodyCapture.value,
+					requestBodyTruncated: requestBodyCapture === null || requestBodyCapture === void 0 ? void 0 : requestBodyCapture.truncated,
+					responseBody: responseBodyCapture === null || responseBodyCapture === void 0 ? void 0 : responseBodyCapture.value,
+					responseBodyTruncated: responseBodyCapture === null || responseBodyCapture === void 0 ? void 0 : responseBodyCapture.truncated,
+					responseHeaders,
+					requestId,
+					responseSize: (_contentLengthOfValue = contentLengthOfValue(responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders["content-length"])) !== null && _contentLengthOfValue !== void 0 ? _contentLengthOfValue : sizeOf(responseBodyCapture),
+					slowThresholdMs
+				}, status === 0 ? { error: "network error or timeout" } : {}));
+			} catch (_unused15) {}
+		};
+		this.addEventListener("loadend", onLoadEnd, { once: true });
+		originalSend.call(this, body);
+	};
+	const wrappedSetRequestHeader = function(name, value) {
+		const info = meta.get(this);
+		if (info && name.toLowerCase() === "content-type") info.contentType = value;
+		return originalSetRequestHeader.call(this, name, value);
+	};
+	const wrappedAbort = function() {
+		const info = meta.get(this);
+		if (info) info.aborted = true;
+		return originalAbort.call(this);
+	};
+	try {
+		XHR.prototype.open = wrappedOpen;
+		XHR.prototype.send = wrappedSend;
+		XHR.prototype.setRequestHeader = wrappedSetRequestHeader;
+		XHR.prototype.abort = wrappedAbort;
+		restores.push(() => {
+			if (XHR.prototype.open === wrappedOpen) XHR.prototype.open = originalOpen;
+			if (XHR.prototype.send === wrappedSend) XHR.prototype.send = originalSend;
+			if (XHR.prototype.setRequestHeader === wrappedSetRequestHeader) XHR.prototype.setRequestHeader = originalSetRequestHeader;
+			if (XHR.prototype.abort === wrappedAbort) XHR.prototype.abort = originalAbort;
+		});
+	} catch (_unused16) {}
+}
+/** 解析 XHR 的响应头；部分环境不实现 getAllResponseHeaders。 */
+function parseXhrResponseHeaders(xhr) {
+	try {
+		var _xhr$getAllResponseHe;
+		const raw = (_xhr$getAllResponseHe = xhr.getAllResponseHeaders) === null || _xhr$getAllResponseHe === void 0 ? void 0 : _xhr$getAllResponseHe.call(xhr);
+		if (!raw) return void 0;
+		const result = {};
+		for (const line of raw.trim().split(/[\r\n]+/)) {
+			const index = line.indexOf(":");
+			if (index <= 0) continue;
+			const key = line.slice(0, index).trim().toLowerCase();
+			const value = line.slice(index + 1).trim();
+			if (RESPONSE_HEADER_WHITELIST.includes(key) && value) result[key] = value;
+		}
+		return Object.keys(result).length > 0 ? result : void 0;
+	} catch (_unused17) {
+		return;
+	}
+}
+/** 读取 XHR 响应体；二进制响应不读取。 */
+function serializeXhrResponseBody(xhr, contentType, options) {
+	try {
+		const responseType = xhr.responseType;
+		if (responseType && responseType !== "text" && responseType !== "json") return;
+		const body = responseType === "json" ? xhr.response : xhr.responseText;
+		if (typeof body === "string") {
+			const maxChars = options.maxChars && options.maxChars > 0 ? options.maxChars : 4096;
+			const compacted = compactText(body, maxChars);
+			const capture = serializeHttpResponseBody(compacted.text, contentType, _objectSpread2(_objectSpread2({}, options), {}, { maxChars }));
+			if (!capture) return void 0;
+			return {
+				value: capture.value,
+				truncated: capture.truncated || compacted.truncated
+			};
+		}
+		return serializeHttpResponseBody(body, contentType, options);
+	} catch (_unused18) {
+		return;
+	}
+}
+/** 解析 content-length 字符串。 */
+function contentLengthOfValue(value) {
+	if (!value) return void 0;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) && parsed >= 0 ? parsed : void 0;
+}
+// src/platform/context.ts
+/**
+* 创建浏览器上下文采集器。
+*
+* 只采集「定位问题需要、且不涉及隐私」的信息：
+* 浏览器/系统/屏幕/网络/语言。
+* 不采集输入框内容、Cookie、Authorization 头。
+*/
+function createContext() {
+	return {
+		platform: "web",
+		pageUrl: () => {
+			var _window$location;
+			return typeof window === "undefined" ? void 0 : (_window$location = window.location) === null || _window$location === void 0 ? void 0 : _window$location.href;
+		},
+		pageRoute: () => {
+			var _window$location2;
+			return typeof window === "undefined" ? void 0 : (_window$location2 = window.location) === null || _window$location2 === void 0 ? void 0 : _window$location2.pathname;
+		},
+		collect() {
+			var _connection$effective, _window$screen, _window$screen2, _window$devicePixelRa;
+			const nav = window.navigator;
+			const ua = nav.userAgent;
+			const browser = detectBrowser(ua);
+			const connection = nav.connection;
+			return {
+				browser: {
+					name: browser,
+					version: detectBrowserVersion(ua, browser),
+					language: nav.language,
+					user_agent: ua,
+					viewport: {
+						width: window.innerWidth,
+						height: window.innerHeight
+					}
+				},
+				os: {
+					name: detectOs(ua),
+					version: detectOsVersion(ua)
+				},
+				device: { model: detectDevice(ua) },
+				network: {
+					effective_type: (_connection$effective = connection === null || connection === void 0 ? void 0 : connection.effectiveType) !== null && _connection$effective !== void 0 ? _connection$effective : "unknown",
+					online: nav.onLine !== false
+				},
+				screen: {
+					width: (_window$screen = window.screen) === null || _window$screen === void 0 ? void 0 : _window$screen.width,
+					height: (_window$screen2 = window.screen) === null || _window$screen2 === void 0 ? void 0 : _window$screen2.height,
+					pixel_ratio: (_window$devicePixelRa = window.devicePixelRatio) !== null && _window$devicePixelRa !== void 0 ? _window$devicePixelRa : 1
+				},
+				runtime: {
+					name: "web",
+					sdk: "@fz-firefly/web"
+				},
+				locale: {
+					language: nav.language,
+					timezone: typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : void 0
+				}
+			};
+		}
+	};
+}
+/** 从 UA 粗略识别浏览器。微信内置浏览器优先判断，否则会被识别成 Chrome。 */
+function detectBrowser(ua) {
+	if (/MicroMessenger/i.test(ua)) return "WeChat";
+	if (/Edg\//.test(ua)) return "Edge";
+	if (/Chrome\//.test(ua)) return "Chrome";
+	if (/Firefox\//.test(ua)) return "Firefox";
+	if (/Safari\//.test(ua)) return "Safari";
+	return "Unknown";
+}
+/** 从 UA 提取浏览器版本。 */
+function detectBrowserVersion(ua, browser) {
+	var _pattern$exec;
+	const pattern = {
+		WeChat: /MicroMessenger\/([\d.]+)/i,
+		Edge: /Edg\/([\d.]+)/i,
+		Chrome: /Chrome\/([\d.]+)/i,
+		Firefox: /Firefox\/([\d.]+)/i,
+		Safari: /Version\/([\d.]+).*Safari/i
+	}[browser];
+	return pattern === null || pattern === void 0 || (_pattern$exec = pattern.exec(ua)) === null || _pattern$exec === void 0 ? void 0 : _pattern$exec[1];
+}
+/** 从 UA 粗略识别操作系统。 */
+function detectOs(ua) {
+	if (/Android/i.test(ua)) return "Android";
+	if (/iPhone|iPad|iPod/i.test(ua)) return "iOS";
+	if (/Windows/i.test(ua)) return "Windows";
+	if (/Mac OS X/i.test(ua)) return "macOS";
+	if (/Linux/i.test(ua)) return "Linux";
+	return "Unknown";
+}
+/** 从 UA 提取操作系统版本。 */
+function detectOsVersion(ua) {
+	const candidates = [
+		[/Android\s([\d.]+)/i, (match) => {
+			var _match$;
+			return (_match$ = match[1]) !== null && _match$ !== void 0 ? _match$ : "";
+		}],
+		[/(?:iPhone|iPad|iPod).*?OS\s([\d_]+)/i, (match) => {
+			var _match$2;
+			return ((_match$2 = match[1]) !== null && _match$2 !== void 0 ? _match$2 : "").replace(/_/g, ".");
+		}],
+		[/Windows NT\s([\d.]+)/i, (match) => {
+			var _match$3;
+			return (_match$3 = match[1]) !== null && _match$3 !== void 0 ? _match$3 : "";
+		}],
+		[/Mac OS X\s([\d_]+)/i, (match) => {
+			var _match$4;
+			return ((_match$4 = match[1]) !== null && _match$4 !== void 0 ? _match$4 : "").replace(/_/g, ".");
+		}]
+	];
+	for (const [pattern, format] of candidates) {
+		const match = pattern.exec(ua);
+		if (match) {
+			const value = format(match);
+			if (value) return value;
+		}
+	}
+}
+/** 设备型号。浏览器通常拿不到精确型号，小程序端会由适配层补上。 */
+function detectDevice(ua) {
+	if (/iPhone/i.test(ua)) return "iPhone";
+	if (/iPad/i.test(ua)) return "iPad";
+	if (/Android/i.test(ua)) return "Android";
+	return "Desktop";
+}
+// src/platform/storage.ts
+/**
+* 创建浏览器存储。
+*
+* 优先用 localStorage 保证刷新/崩溃后还能补报；
+* 隐私模式、配额满、被安全策略禁用时，localStorage 的读写会抛错，
+* 这时退化为内存 Map —— 功能降级，但绝不能影响业务页面。
+*/
+function createStorage() {
+	const memory = /* @__PURE__ */ new Map();
+	let useLocal = canUseLocalStorage();
+	return {
+		get(key) {
+			var _memory$get;
+			if (useLocal) try {
+				return window.localStorage.getItem(key);
+			} catch (_unused) {
+				useLocal = false;
+			}
+			return (_memory$get = memory.get(key)) !== null && _memory$get !== void 0 ? _memory$get : null;
+		},
+		set(key, value) {
+			memory.set(key, value);
+			if (useLocal) try {
+				window.localStorage.setItem(key, value);
+			} catch (_unused2) {
+				useLocal = false;
+			}
+		},
+		remove(key) {
+			memory.delete(key);
+			if (useLocal) try {
+				window.localStorage.removeItem(key);
+			} catch (_unused3) {
+				useLocal = false;
+			}
+		}
+	};
+}
+/** 探测 localStorage 是否可写。只执行一次，避免每次读写都付异常开销。 */
+function canUseLocalStorage() {
+	try {
+		const probe = "__firefly_probe__";
+		window.localStorage.setItem(probe, "1");
+		window.localStorage.removeItem(probe);
+		return true;
+	} catch (_unused4) {
+		return false;
+	}
+}
+// src/platform/transport.ts
+/**
+* 创建浏览器上报通道。
+*
+* 使用 POST + text/plain + 查询参数传 key：
+* text/plain 属于 CORS 简单请求，不会触发 OPTIONS 预检，
+* 少了这一趟往返，页面崩溃边缘的上报成功率会高不少。
+*/
+function createTransport(endpoint) {
+	const baseUrl = `${endpoint.replace(/\/+$/, "")}/api/ingest/v1/envelope`;
+	return {
+		async send(body, dsn, options) {
+			const url = `${baseUrl}?key=${encodeURIComponent(dsn)}`;
+			try {
+				if (typeof fetch === "function") {
+					const init = {
+						method: "POST",
+						headers: { "Content-Type": "text/plain;charset=UTF-8" },
+						body,
+						credentials: "omit"
+					};
+					if (options === null || options === void 0 ? void 0 : options.keepalive) init.keepalive = true;
+					const response = await fetch(url, init);
+					if (!response.ok) throw new FireflyTransportError(`Firefly: 上报失败，HTTP ${response.status}`, {
+						statusCode: response.status,
+						retryAfterMs: parseRetryAfter(response.headers.get("retry-after"))
+					});
+					return;
+				}
+				await sendWithXhr(url, body);
+			} catch (error) {
+				if (error instanceof FireflyTransportError) throw error;
+				throw new FireflyTransportError("Firefly: 上报网络错误", { cause: error });
+			}
+		},
+		/** 页面卸载阶段优先用 sendBeacon；浏览器拒绝时返回 false 走 fetch。 */
+		sendBeacon(body, dsn) {
+			if (typeof navigator === "undefined" || typeof navigator.sendBeacon !== "function") return false;
+			try {
+				return navigator.sendBeacon(`${baseUrl}?key=${encodeURIComponent(dsn)}`, body);
+			} catch (_unused) {
+				return false;
+			}
+		}
+	};
+}
+/** XHR 兜底实现。仅在 fetch 不存在时使用。 */
+function sendWithXhr(url, body) {
+	return new Promise((resolve, reject) => {
+		try {
+			const xhr = new XMLHttpRequest();
+			xhr.open("POST", url, true);
+			xhr.setRequestHeader("Content-Type", "text/plain;charset=UTF-8");
+			xhr.onload = () => {
+				if (xhr.status >= 200 && xhr.status < 300) resolve();
+				else reject(new FireflyTransportError(`Firefly: 上报失败，HTTP ${xhr.status}`, { statusCode: xhr.status }));
+			};
+			xhr.onerror = () => reject(new FireflyTransportError("Firefly: 上报网络错误"));
+			xhr.send(body);
+		} catch (error) {
+			reject(new FireflyTransportError("Firefly: 上报网络错误", { cause: error }));
+		}
+	});
+}
+// src/index.ts
+/**
+* 浏览器端入口。
+*
+* 一行接入：
+* ```ts
+* const handle = initFirefly({ dsn, endpoint, environment, release });
+* ```
+* 之后未捕获异常、未处理的 Promise 拒绝、资源加载失败会自动上报；
+* 失败 HTTP 请求会单独上报，成功请求进入页面请求日志，慢请求额外
+* 写 warning 面包屑；点击、路由、console、生命周期和失败请求会写入
+* 面包屑时间线。
+*/
+function initFirefly(options) {
+	var _window$location, _window$location$sear, _window$location2, _window$location3, _window$location4;
+	const globalWindow = window;
+	if (globalWindow.__firefly__) return globalWindow.__firefly__;
+	const resolved = resolveOptions(options);
+	const client = createClient(resolved, {
+		storage: createStorage(),
+		transport: createTransport(resolved.endpoint),
+		context: createContext()
+	});
+	const initialPath = ((_window$location = window.location) === null || _window$location === void 0 ? void 0 : _window$location.pathname) || "/";
+	const initialQuery = queryOf((_window$location$sear = (_window$location2 = window.location) === null || _window$location2 === void 0 ? void 0 : _window$location2.search) !== null && _window$location$sear !== void 0 ? _window$location$sear : "");
+	client.startPageSession(initialPath, _objectSpread2({
+		navigation_type: "initial",
+		url: (_window$location3 = window.location) === null || _window$location3 === void 0 ? void 0 : _window$location3.href
+	}, initialQuery ? { query: initialQuery } : {}));
+	client.addBreadcrumb({
+		type: "navigation",
+		category: "page",
+		level: "info",
+		timestamp: Date.now(),
+		message: `进入 ${initialPath}`,
+		data: {
+			path: initialPath,
+			url: (_window$location4 = window.location) === null || _window$location4 === void 0 ? void 0 : _window$location4.href,
+			navigation_type: "initial"
+		}
+	});
+	const disposeHooks = [
+		installGlobalErrorHooks(client),
+		...options.captureResourceErrors === false ? [] : [installResourceErrorHooks(client)],
+		...options.captureClicks === false ? [] : [installClickBreadcrumbs(client)],
+		installConsoleBreadcrumbs(client, options),
+		installLifecycleBreadcrumbs(client, options),
+		installHttpErrorHooks(client, options),
+		installPageHideFlush(client)
+	];
+	const handle = {
+		client,
+		dispose() {
+			for (const dispose of disposeHooks) dispose();
+			client.close();
+			if (globalWindow.__firefly__ === handle) delete globalWindow.__firefly__;
+		}
+	};
+	globalWindow.__firefly__ = handle;
+	return handle;
+}
+/** 把 location.search 解析成可序列化的页面参数。 */
+function queryOf(search) {
+	const params = new URLSearchParams(search);
+	const keys = [...new Set(params.keys())];
+	if (keys.length === 0) return void 0;
+	const result = {};
+	for (const key of keys) {
+		const values = params.getAll(key);
+		if (values.length === 0) continue;
+		result[key] = values.length === 1 ? values[0] : values;
+	}
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/**
+* 页面隐藏/卸载时冲刷一次队列。
+* 移动端切后台、关闭标签页都会触发 pagehide，这是最后的补发机会。
+*/
+function installPageHideFlush(client) {
+	const handler = () => {
+		client.flush({
+			beacon: true,
+			keepalive: true
+		});
+	};
+	window.addEventListener("pagehide", handler);
+	return () => {
+		window.removeEventListener("pagehide", handler);
+	};
+}
+export { initFirefly };
+
+//# sourceMappingURL=index.js.map