@fz-firefly/core 0.0.0-stage → 0.2.0

package/dist/index.cjs

@@ -0,0 +1,1585 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// \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;
+}
+// src/breadcrumbs/store.ts
+/**
+* 面包屑环形缓冲。
+* 只保留最近 N 条，超出丢最旧的。错误发生时快照一份塞进事件。
+*/
+var BreadcrumbStore = class {
+	constructor(max) {
+		this.max = max;
+		_defineProperty(this, "items", []);
+		_defineProperty(this, "dropped", 0);
+	}
+	/** 追加一条面包屑，并裁剪到上限。 */
+	add(breadcrumb) {
+		this.items.push(breadcrumb);
+		if (this.items.length > this.max) {
+			const removed = this.items.length - this.max;
+			this.items.splice(0, removed);
+			this.dropped += removed;
+		}
+	}
+	/** 返回副本，避免调用方修改内部数组。 */
+	snapshot() {
+		return [...this.items];
+	}
+	/** 当前缓冲状态，用于提示时间线可能不完整。 */
+	stats() {
+		return {
+			size: this.items.length,
+			max: this.max,
+			dropped: this.dropped
+		};
+	}
+};
+// src/utils/uuid.ts
+/**
+* 生成事件 id（uuid v4）。
+*
+* 优先用平台自带的 crypto.randomUUID；
+* 老浏览器与部分小程序没有它，退化为 Math.random 版本。
+* 这个 id 是服务端的幂等键，重复概率必须足够低。
+*/
+function createEventId() {
+	const cryptoApi = typeof globalThis === "undefined" ? void 0 : globalThis.crypto;
+	if (typeof (cryptoApi === null || cryptoApi === void 0 ? void 0 : cryptoApi.randomUUID) === "function") return cryptoApi.randomUUID();
+	return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
+		const random = Math.random() * 16 | 0;
+		return (char === "x" ? random : random & 3 | 8).toString(16);
+	});
+}
+// \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/runtime/page-session.ts
+/**
+* 页面会话跟踪器。
+*
+* 一次「进入页面」对应一个 session：
+* - Web：首次加载 + SPA 路由切换；
+* - uni-app / Taro：navigateTo / redirectTo / switchTab / reLaunch / navigateBack。
+*
+* 面包屑会自动带上 session_id、seq、t_rel_ms，事件里则通过
+* `contexts.page` 暴露会话信息，后台可以把一次页面访问内的
+* 请求、点击、报错串成一条时间线。
+*/
+var PageSessionTracker = class {
+	constructor() {
+		_defineProperty(this, "id", createEventId());
+		_defineProperty(this, "path", void 0);
+		_defineProperty(this, "startedAt", Date.now());
+		_defineProperty(this, "seq", 0);
+		_defineProperty(this, "meta", {});
+	}
+	/** 开始一次新的页面会话。 */
+	start(path, meta = {}) {
+		this.id = createEventId();
+		this.path = path;
+		this.startedAt = Date.now();
+		this.seq = 0;
+		this.meta = _objectSpread2({}, meta);
+		return this.info();
+	}
+	/** 分配下一个面包屑序号。 */
+	nextSeq() {
+		this.seq += 1;
+		return this.seq;
+	}
+	/** 距离页面进入时刻的毫秒数。 */
+	get elapsedMs() {
+		return Math.max(0, Date.now() - this.startedAt);
+	}
+	/** 当前会话快照。 */
+	info() {
+		return {
+			id: this.id,
+			path: this.path,
+			startedAt: this.startedAt,
+			seq: this.seq,
+			meta: _objectSpread2({}, this.meta)
+		};
+	}
+	/** 事件 contexts.page 的内容。 */
+	context() {
+		return _objectSpread2(_objectSpread2(_objectSpread2({}, this.meta), {}, { session_id: this.id }, this.path ? { path: this.path } : {}), {}, { started_at: new Date(this.startedAt).toISOString() });
+	}
+};
+// src/utils/text.ts
+/** 截断标记；保留头尾时插在中间。 */
+const TRUNCATED_MARKER = "\n…[truncated]…\n";
+/**
+* 按字符数压缩文本，超长时保留头部和尾部。
+*
+* 错误信息、HTML 错误页和 JSON 的尾部经常比中间更重要，单纯 slice(0, max)
+* 会把真正的错误码/错误提示丢掉。
+*/
+function truncateWithTail(value, max) {
+	if (value.length <= max) return {
+		value,
+		truncated: false
+	};
+	if (max <= 15) return {
+		value: value.slice(0, max),
+		truncated: true
+	};
+	const tail = Math.min(256, Math.floor(max / 4));
+	const head = Math.max(0, max - tail - 15);
+	return {
+		value: `${value.slice(0, head)}${TRUNCATED_MARKER}${value.slice(-tail)}`,
+		truncated: true
+	};
+}
+// src/runtime/request-log.ts
+/**
+* 页面会话内的请求日志。
+*
+* 只保留最近 N 条，避免事件体积失控；成功请求也记录，
+* 但不会像面包屑那样把点击/导航挤出 50 条缓冲。
+*/
+var RequestLogStore = class {
+	constructor(max, maxBodyChars = 1024) {
+		this.max = max;
+		this.maxBodyChars = maxBodyChars;
+		_defineProperty(this, "items", []);
+		_defineProperty(this, "total", 0);
+		_defineProperty(this, "failed", 0);
+	}
+	/** 追加一条请求记录。 */
+	add(record) {
+		this.total += 1;
+		if (!record.ok) this.failed += 1;
+		this.items.push(this.compact(record));
+		if (this.items.length > this.max) this.items.splice(0, this.items.length - this.max);
+	}
+	/** 进入新页面时清空，避免把上一个页面的请求带进来。 */
+	clear() {
+		this.items = [];
+		this.total = 0;
+		this.failed = 0;
+	}
+	/** 返回副本。 */
+	snapshot() {
+		return {
+			items: [...this.items],
+			total: this.total,
+			failed: this.failed
+		};
+	}
+	/** 请求日志不需要完整响应体，截断到较小长度，避免 30 条撑爆信封。 */
+	compact(record) {
+		const requestBody = truncateValue(record.request_body, this.maxBodyChars);
+		const responseBody = truncateValue(record.response_body, this.maxBodyChars);
+		return _objectSpread2(_objectSpread2(_objectSpread2({}, record), record.request_body !== void 0 ? {
+			request_body: requestBody.value,
+			request_body_truncated: record.request_body_truncated || requestBody.truncated
+		} : {}), record.response_body !== void 0 ? {
+			response_body: responseBody.value,
+			response_body_truncated: record.response_body_truncated || responseBody.truncated
+		} : {});
+	}
+};
+/** 字符串直接截断；对象序列化后超长则退化成截断字符串。 */
+function truncateValue(value, maxChars) {
+	if (value === void 0) return {
+		value,
+		truncated: false
+	};
+	if (typeof value === "string") return truncateWithTail(value, maxChars);
+	try {
+		const json = JSON.stringify(value);
+		if (!json || json.length <= maxChars) return {
+			value,
+			truncated: false
+		};
+		return {
+			value: truncateWithTail(json, maxChars).value,
+			truncated: true
+		};
+	} catch (_unused) {
+		return {
+			value: "[Unserializable]",
+			truncated: true
+		};
+	}
+}
+// src/runtime/normalize.ts
+/**
+* 协议上限的本地副本。
+*
+* core 不运行时 import shared（避免为一个常量把 Zod 协议打进 core），
+* 这些值必须与 packages/shared/src/constants.ts 保持一致。
+*/
+const MAX_FIELD_CHARS = 16384;
+const MAX_URL_CHARS = 2048;
+const MAX_FRAMES = 100;
+const MAX_OCCURRENCES = 1e4;
+const MAX_RELEASE_CHARS = 128;
+const MAX_DIST_CHARS = 128;
+const MAX_ROUTE_CHARS = 512;
+const MAX_USER_ID_CHARS = 256;
+const MAX_BREADCRUMB_TYPE_CHARS = 32;
+const MAX_BREADCRUMB_CATEGORY_CHARS = 64;
+const MAX_BREADCRUMB_MESSAGE_CHARS = 512;
+const MAX_SESSION_ID_CHARS = 64;
+const MAX_EXCEPTION_TYPE_CHARS = 256;
+const MAX_FUNCTION_CHARS = 512;
+const MAX_EVENT_NAME_CHARS = 128;
+/** 按字符数截断；调用方传入的都是 UTF-16 字符串。 */
+function cut(value, max) {
+	return value.length <= max ? value : value.slice(0, max);
+}
+function cutOptional(value, max) {
+	return value === void 0 ? void 0 : cut(value, max);
+}
+function normalizeFrame(frame) {
+	return _objectSpread2(_objectSpread2({}, frame), {}, {
+		filename: cut(frame.filename, MAX_URL_CHARS),
+		abs_path: cutOptional(frame.abs_path, MAX_URL_CHARS),
+		function: cutOptional(frame.function, MAX_FUNCTION_CHARS)
+	});
+}
+/** 超过 100 帧时保留首尾各 50 帧，中间部分丢失。 */
+function normalizeFrames(frames) {
+	if (frames.length <= MAX_FRAMES) return frames.map(normalizeFrame);
+	const half = Math.floor(MAX_FRAMES / 2);
+	return [...frames.slice(0, half), ...frames.slice(-50)].map(normalizeFrame);
+}
+function normalizeBreadcrumb(breadcrumb) {
+	return _objectSpread2(_objectSpread2({}, breadcrumb), {}, {
+		type: cut(breadcrumb.type, MAX_BREADCRUMB_TYPE_CHARS),
+		category: cutOptional(breadcrumb.category, MAX_BREADCRUMB_CATEGORY_CHARS),
+		session_id: cutOptional(breadcrumb.session_id, MAX_SESSION_ID_CHARS),
+		message: cutOptional(breadcrumb.message, MAX_BREADCRUMB_MESSAGE_CHARS)
+	});
+}
+function normalizeOccurrences(value) {
+	if (!Number.isFinite(value)) return 1;
+	return Math.min(Math.max(1, Math.floor(value)), MAX_OCCURRENCES);
+}
+/**
+* 把事件裁剪到服务端协议允许的范围。
+*
+* 客户端不裁剪时，服务端 parseEnvelope 会静默丢弃非法 item，调用方却拿到 200。
+* 这里统一处理字符串、帧数、面包屑、occurrences，并对空 message / event_name
+* 返回 null，让调用方明确拒绝。
+*/
+function normalizeEventItem(item) {
+	const base = _objectSpread2(_objectSpread2({}, item), {}, {
+		occurrences: normalizeOccurrences(item.occurrences),
+		release: cutOptional(item.release, MAX_RELEASE_CHARS),
+		dist: cutOptional(item.dist, MAX_DIST_CHARS),
+		breadcrumbs: item.breadcrumbs.slice(-50).map(normalizeBreadcrumb),
+		url: cutOptional(item.url, MAX_URL_CHARS),
+		route: cutOptional(item.route, MAX_ROUTE_CHARS),
+		user: item.user ? {
+			id: cutOptional(item.user.id, MAX_USER_ID_CHARS),
+			anonymous_id: cutOptional(item.user.anonymous_id, MAX_USER_ID_CHARS)
+		} : void 0
+	});
+	if (base.type === "error") {
+		const exception = base.exception;
+		const stacktrace = exception.stacktrace ? { frames: normalizeFrames(exception.stacktrace.frames) } : void 0;
+		return _objectSpread2(_objectSpread2({}, base), {}, {
+			message: cutOptional(base.message, MAX_FIELD_CHARS),
+			exception: _objectSpread2(_objectSpread2({}, exception), {}, {
+				type: cut(exception.type, MAX_EXCEPTION_TYPE_CHARS),
+				value: cutOptional(exception.value, MAX_FIELD_CHARS)
+			}, stacktrace ? { stacktrace } : {})
+		});
+	}
+	if (base.type === "message") {
+		if (base.message.trim() === "") return null;
+		return _objectSpread2(_objectSpread2({}, base), {}, { message: cut(base.message, MAX_FIELD_CHARS) });
+	}
+	if (base.type === "track") {
+		if (base.event_name.trim() === "") return null;
+		return _objectSpread2(_objectSpread2({}, base), {}, { event_name: cut(base.event_name, MAX_EVENT_NAME_CHARS) });
+	}
+	return base;
+}
+// src/options.ts
+/** 默认自动冲刷间隔：5 秒。与客户端节流窗口一致。 */
+const DEFAULT_FLUSH_INTERVAL_MS = 5e3;
+/** 默认内存队列上限。 */
+const DEFAULT_MAX_QUEUE_SIZE = 100;
+/** 默认面包屑上限。 */
+const DEFAULT_MAX_BREADCRUMBS = 50;
+/** 默认事件携带的请求日志条数。 */
+const DEFAULT_MAX_REQUEST_LOG = 30;
+/** 默认慢请求阈值：1 秒。 */
+const DEFAULT_SLOW_REQUEST_THRESHOLD_MS = 1e3;
+/** 默认响应体最大字符数。 */
+const DEFAULT_MAX_HTTP_RESPONSE_CHARS = 4096;
+/** 默认单批次最大重试次数。 */
+const DEFAULT_MAX_RETRIES = 5;
+/** 默认重试基础延迟：5 秒。 */
+const DEFAULT_RETRY_BASE_DELAY_MS = 5e3;
+/** 默认重试最大延迟：5 分钟。 */
+const DEFAULT_RETRY_MAX_DELAY_MS = 3e5;
+/**
+* 校验必填项并补齐默认值。
+*
+* 这里故意抛错而不是静默降级：dsn 或 endpoint 缺失时，
+* 上报永远不会成功，早点暴露比后台一条数据都没有更好。
+*/
+function resolveOptions(options) {
+	var _options$flushInterva, _options$maxQueueSize, _options$maxRequestLo, _options$slowRequestT, _options$maxHttpRespo, _options$maxRetries, _options$retryBaseDel, _options$retryMaxDela;
+	if (!options.dsn) throw new Error("Firefly: dsn 不能为空，请在后台项目设置中获取");
+	if (!options.endpoint) throw new Error("Firefly: endpoint 不能为空，请填写服务端地址");
+	if (!options.environment) throw new Error("Firefly: environment 不能为空，请传入构建环境");
+	return _objectSpread2(_objectSpread2({}, options), {}, {
+		flushIntervalMs: (_options$flushInterva = options.flushIntervalMs) !== null && _options$flushInterva !== void 0 ? _options$flushInterva : DEFAULT_FLUSH_INTERVAL_MS,
+		maxQueueSize: (_options$maxQueueSize = options.maxQueueSize) !== null && _options$maxQueueSize !== void 0 ? _options$maxQueueSize : 100,
+		maxBreadcrumbs: Number.isFinite(options.maxBreadcrumbs) ? Math.min(Math.max(0, Math.floor(options.maxBreadcrumbs)), 50) : 50,
+		maxRequestLog: (_options$maxRequestLo = options.maxRequestLog) !== null && _options$maxRequestLo !== void 0 ? _options$maxRequestLo : 30,
+		slowRequestThresholdMs: (_options$slowRequestT = options.slowRequestThresholdMs) !== null && _options$slowRequestT !== void 0 ? _options$slowRequestT : DEFAULT_SLOW_REQUEST_THRESHOLD_MS,
+		maxHttpResponseChars: (_options$maxHttpRespo = options.maxHttpResponseChars) !== null && _options$maxHttpRespo !== void 0 ? _options$maxHttpRespo : DEFAULT_MAX_HTTP_RESPONSE_CHARS,
+		maxRetries: (_options$maxRetries = options.maxRetries) !== null && _options$maxRetries !== void 0 ? _options$maxRetries : 5,
+		retryBaseDelayMs: (_options$retryBaseDel = options.retryBaseDelayMs) !== null && _options$retryBaseDel !== void 0 ? _options$retryBaseDel : DEFAULT_RETRY_BASE_DELAY_MS,
+		retryMaxDelayMs: (_options$retryMaxDela = options.retryMaxDelayMs) !== null && _options$retryMaxDela !== void 0 ? _options$retryMaxDela : DEFAULT_RETRY_MAX_DELAY_MS
+	});
+}
+// src/runtime/queue.ts
+/** 队列在存储里的键名。加项目前缀由适配层负责（本包只有一个队列）。 */
+const STORAGE_KEY = "firefly:queue";
+/** 单个信封最多携带的事件数，与协议上限一致。 */
+const BATCH_SIZE = 50;
+/**
+* 单个信封的最大字节数。
+*
+* 与 @fz-firefly/shared 的 LIMITS.MAX_BODY_BYTES 保持一致；
+* 这里不 import shared，避免 core 为了一个常量引入协议/Zod 运行时。
+*/
+const MAX_ENVELOPE_BYTES = 262144;
+/** fetch keepalive 的保守上限；浏览器通常限制在 64KB 左右。 */
+const MAX_KEEPALIVE_BYTES = 61440;
+/** 计算 UTF-8 字节数，兼容没有 TextEncoder 的小程序/老 WebView。 */
+function utf8ByteLength(value) {
+	let bytes = 0;
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code < 128) bytes += 1;
+		else if (code < 2048) bytes += 2;
+		else if (code >= 55296 && code <= 56319) {
+			const next = value.charCodeAt(index + 1);
+			if (next >= 56320 && next <= 57343) {
+				bytes += 4;
+				index += 1;
+			} else bytes += 3;
+		} else bytes += 3;
+	}
+	return bytes;
+}
+/**
+* 事件队列。
+*
+* 职责：
+* - 入队时持久化，页面崩溃/刷新后下次启动还能补发；
+* - 按 50 条一批发送；
+* - 网络错误 / 5xx / 429 指数退避重试，超过上限丢弃该批次；
+* - 4xx（401/403 除外）直接丢弃该批次，不无限重试；
+* - 超过上限丢最旧的，防止错误风暴把存储撑爆。
+*/
+var EventQueue = class {
+	constructor(deps) {
+		var _deps$maxRetries, _deps$retryBaseDelayM, _deps$retryMaxDelayMs, _deps$now, _deps$random;
+		this.deps = deps;
+		_defineProperty(this, "items", []);
+		_defineProperty(this, "retryAttempt", 0);
+		_defineProperty(this, "nextRetryAt", 0);
+		_defineProperty(this, "flushPromise", null);
+		_defineProperty(this, "maxRetries", void 0);
+		_defineProperty(this, "retryBaseDelayMs", void 0);
+		_defineProperty(this, "retryMaxDelayMs", void 0);
+		_defineProperty(this, "now", void 0);
+		_defineProperty(this, "random", void 0);
+		this.maxRetries = (_deps$maxRetries = deps.maxRetries) !== null && _deps$maxRetries !== void 0 ? _deps$maxRetries : 5;
+		this.retryBaseDelayMs = (_deps$retryBaseDelayM = deps.retryBaseDelayMs) !== null && _deps$retryBaseDelayM !== void 0 ? _deps$retryBaseDelayM : DEFAULT_RETRY_BASE_DELAY_MS;
+		this.retryMaxDelayMs = (_deps$retryMaxDelayMs = deps.retryMaxDelayMs) !== null && _deps$retryMaxDelayMs !== void 0 ? _deps$retryMaxDelayMs : DEFAULT_RETRY_MAX_DELAY_MS;
+		this.now = (_deps$now = deps.now) !== null && _deps$now !== void 0 ? _deps$now : Date.now;
+		this.random = (_deps$random = deps.random) !== null && _deps$random !== void 0 ? _deps$random : Math.random;
+		this.restore();
+	}
+	/** 当前待发送条数。 */
+	get size() {
+		return this.items.length;
+	}
+	/** 入队并落盘。 */
+	enqueue(item) {
+		if (this.deps.maxQueueSize > 0 && this.items.length >= this.deps.maxQueueSize) this.items.shift();
+		this.items.push(item);
+		this.persist();
+	}
+	/**
+	* 冲刷队列。
+	* 同一时间只允许一个 flush 在跑，避免定时器、pagehide、手动 flush 并发。
+	* 这个方法不抛错，失败通过 onError 暴露。
+	*/
+	flush(options = {}) {
+		if (this.flushPromise) return this.flushPromise.then(() => this.flush(options), () => this.flush(options));
+		const running = this.flushInternal(options).then(() => {
+			this.flushPromise = null;
+		}, (error) => {
+			this.flushPromise = null;
+			throw error;
+		});
+		this.flushPromise = running;
+		return running;
+	}
+	async flushInternal(options) {
+		const now = this.now();
+		if (now < this.nextRetryAt) return;
+		let batchLimit = BATCH_SIZE;
+		while (this.items.length > 0) {
+			let batch;
+			try {
+				batch = this.buildBatch(batchLimit);
+			} catch (error) {
+				const item = this.items[0];
+				if (!item) return;
+				this.removeItems([item]);
+				this.reportError(error);
+				continue;
+			}
+			if (!batch) {
+				const item = this.items[0];
+				if (!item) return;
+				this.removeItems([item]);
+				this.reportError(/* @__PURE__ */ new Error("Firefly: 单条事件超过信封上限，已丢弃"));
+				continue;
+			}
+			try {
+				let beaconAccepted = false;
+				if (options.beacon && this.deps.transport.sendBeacon) try {
+					beaconAccepted = this.deps.transport.sendBeacon(batch.body, this.deps.dsn);
+				} catch (_unused) {
+					beaconAccepted = false;
+				}
+				if (!beaconAccepted) {
+					const keepalive = options.keepalive === true && utf8ByteLength(batch.body) <= MAX_KEEPALIVE_BYTES;
+					await this.deps.transport.send(batch.body, this.deps.dsn, keepalive ? { keepalive: true } : void 0);
+				}
+				this.retryAttempt = 0;
+				this.nextRetryAt = 0;
+				this.removeItems(batch.items);
+			} catch (error) {
+				var _details$retryable, _details$retryAfterMs;
+				const details = error;
+				if (details.statusCode === 413) {
+					if (batch.items.length > 1) {
+						batchLimit = Math.max(1, Math.floor(batch.items.length / 2));
+						continue;
+					}
+					this.reportError(error);
+					this.removeItems(batch.items);
+					this.retryAttempt = 0;
+					this.nextRetryAt = 0;
+					continue;
+				}
+				this.reportError(error);
+				if (!((_details$retryable = details.retryable) !== null && _details$retryable !== void 0 ? _details$retryable : true)) {
+					this.removeItems(batch.items);
+					if (details.statusCode === 401 || details.statusCode === 403) {
+						this.items = [];
+						this.persist();
+					}
+					this.retryAttempt = 0;
+					this.nextRetryAt = 0;
+					return;
+				}
+				this.retryAttempt += 1;
+				if (this.retryAttempt > this.maxRetries) {
+					this.removeItems(batch.items);
+					this.retryAttempt = 0;
+					this.nextRetryAt = 0;
+					return;
+				}
+				const base = (_details$retryAfterMs = details.retryAfterMs) !== null && _details$retryAfterMs !== void 0 ? _details$retryAfterMs : this.retryBaseDelayMs * 2 ** (this.retryAttempt - 1);
+				const delay = Math.min(base, this.retryMaxDelayMs);
+				this.nextRetryAt = now + delay + delay * .2 * this.random();
+				return;
+			}
+		}
+	}
+	/**
+	* 选出不超过条数/字节上限的队首批次。
+	*
+	* 先按最大条数二进制搜索，buildEnvelope 每次都包含 sdk/sent_at 等
+	* 信封开销，所以用最终 JSON 的字节数判断，而不是估算 item 大小。
+	*/
+	buildBatch(limit) {
+		const maxItems = Math.min(limit, BATCH_SIZE, this.items.length);
+		if (maxItems <= 0) return null;
+		let low = 1;
+		let high = maxItems;
+		let best = null;
+		while (low <= high) {
+			const count = Math.floor((low + high) / 2);
+			const items = this.items.slice(0, count);
+			const body = this.deps.buildEnvelope(items);
+			if (utf8ByteLength(body) <= MAX_ENVELOPE_BYTES) {
+				best = {
+					items,
+					body
+				};
+				low = count + 1;
+			} else high = count - 1;
+		}
+		return best;
+	}
+	/** 按对象引用移除已发送/已丢弃的条目，避免 flush 期间 enqueue 导致误删。 */
+	removeItems(items) {
+		if (items.length === 0) return;
+		const removing = new Set(items);
+		this.items = this.items.filter((item) => !removing.has(item));
+		this.persist();
+	}
+	/** 隔离用户的 onError，避免回调异常打断队列状态机。 */
+	reportError(error) {
+		try {
+			var _this$deps$onError, _this$deps;
+			(_this$deps$onError = (_this$deps = this.deps).onError) === null || _this$deps$onError === void 0 || _this$deps$onError.call(_this$deps, error);
+		} catch (_unused2) {}
+	}
+	/** 队列为空时删键，避免存储里留一个无意义的空数组。 */
+	persist() {
+		try {
+			if (this.items.length === 0) this.deps.storage.remove(STORAGE_KEY);
+			else this.deps.storage.set(STORAGE_KEY, JSON.stringify(this.items));
+		} catch (_unused3) {}
+	}
+	/** 启动时恢复上次未发完的条目。损坏的数据直接丢弃。 */
+	restore() {
+		try {
+			const raw = this.deps.storage.get(STORAGE_KEY);
+			if (!raw) return;
+			const parsed = JSON.parse(raw);
+			if (!Array.isArray(parsed)) return;
+			const max = this.deps.maxQueueSize > 0 ? this.deps.maxQueueSize : parsed.length;
+			this.items = parsed.slice(-max);
+		} catch (_unused4) {}
+	}
+};
+// src/runtime/scope.ts
+/**
+* 当前作用域。
+* 保存 setUser / setTag / setContext 设置的值，组装事件时合并进去。
+* 后续要支持 withScope 时，只需在这里做分支复制。
+*/
+var Scope = class {
+	constructor() {
+		_defineProperty(
+			this,
+			/** 当前用户，null 表示未登录。 */
+			"user",
+			null
+		);
+		_defineProperty(
+			this,
+			/** 全局标签。 */
+			"tags",
+			{}
+		);
+		_defineProperty(
+			this,
+			/** 全局上下文，按类别分组。 */
+			"contexts",
+			{}
+		);
+	}
+	setUser(user) {
+		this.user = user;
+	}
+	setTag(key, value) {
+		this.tags[key] = value;
+	}
+	setContext(key, value) {
+		this.contexts[key] = value;
+	}
+	/** 合并一个上下文分组，保留平台层已经写入的字段。 */
+	mergeContext(key, value) {
+		var _this$contexts$key;
+		this.contexts[key] = _objectSpread2(_objectSpread2({}, (_this$contexts$key = this.contexts[key]) !== null && _this$contexts$key !== void 0 ? _this$contexts$key : {}), value);
+	}
+};
+// src/runtime/throttle.ts
+/**
+* 同签名错误节流。
+*
+* 错误风暴里同一个错误可能一秒触发上千次。如果每次都入队，
+* 队列会被瞬间打满，真正有价值的新错误反而被挤掉。
+* 这里以「5 秒固定窗口 + 签名」为粒度合并，只累加 occurrences。
+*/
+var ErrorThrottle = class {
+	constructor(windowMs = 5e3, clock = Date.now) {
+		this.windowMs = windowMs;
+		this.clock = clock;
+		_defineProperty(this, "entries", /* @__PURE__ */ new Map());
+	}
+	/**
+	* 登记一条错误。
+	* @param item 已组装好的事件
+	* @param signature 同签名判定依据（类型 + 消息 + 首个业务帧）
+	*/
+	register(item, signature) {
+		const now = this.clock();
+		const existing = this.entries.get(signature);
+		if (existing && now - existing.at < this.windowMs) return {
+			added: false,
+			existing: existing.item
+		};
+		this.entries.set(signature, {
+			item,
+			at: now
+		});
+		this.prune(now);
+		return { added: true };
+	}
+	/** 清掉过期条目，防止长时间运行后 Map 无限增长。 */
+	prune(now) {
+		if (this.entries.size < 500) return;
+		for (const [signature, entry] of this.entries) if (now - entry.at >= this.windowMs) this.entries.delete(signature);
+	}
+};
+// src/client.ts
+/** SDK 自身标识，随每个信封上报，便于排查协议兼容问题。 */
+const SDK_NAME = "@fz-firefly/core";
+const SDK_VERSION = "0.2.0";
+/** 匿名用户 id 的存储键；生成后不随登录变化。 */
+const ANONYMOUS_ID_KEY = "firefly_anonymous_id";
+/** 读取或生成稳定的匿名用户 id。 */
+function resolveAnonymousId(storage) {
+	try {
+		const stored = storage.get(ANONYMOUS_ID_KEY);
+		if (stored) return stored;
+	} catch (_unused) {}
+	const created = `anon_${createEventId()}`;
+	try {
+		storage.set(ANONYMOUS_ID_KEY, created);
+	} catch (_unused2) {}
+	return created;
+}
+/**
+* 合并平台上下文与 scope 上下文。
+*
+* 协议要求 contexts 的每个分组都是对象；这里顺便把平台层返回的
+* 非对象值过滤掉，避免一条非法上下文导致整条事件被服务端拒绝。
+*/
+function mergeContexts(base, extra) {
+	const result = {};
+	for (const [key, value] of Object.entries(base)) if (value && typeof value === "object" && !Array.isArray(value)) result[key] = value;
+	for (const [key, value] of Object.entries(extra)) {
+		var _result$key;
+		result[key] = _objectSpread2(_objectSpread2({}, (_result$key = result[key]) !== null && _result$key !== void 0 ? _result$key : {}), value);
+	}
+	return result;
+}
+/** 把长文本压到一行，避免异常面包屑本身过大。 */
+function truncateText(value, max) {
+	return value.length <= max ? value : `${value.slice(0, max)}…`;
+}
+/**
+* 创建客户端。
+*
+* 这里只做与平台无关的事情：组装事件、去重节流、排队、定时冲刷。
+* 具体怎么发、存哪里、错误钩子挂在哪，全部由适配层注入。
+*/
+function createClient(options, deps) {
+	const scope = new Scope();
+	const breadcrumbs = new BreadcrumbStore(options.maxBreadcrumbs);
+	const pageSession = new PageSessionTracker();
+	const requestLog = new RequestLogStore(options.maxRequestLog, Math.min(options.maxHttpResponseChars, 1024));
+	const throttle = new ErrorThrottle();
+	const anonymousId = resolveAnonymousId(deps.storage);
+	const queue = new EventQueue({
+		storage: deps.storage,
+		transport: deps.transport,
+		dsn: options.dsn,
+		maxQueueSize: options.maxQueueSize,
+		maxRetries: options.maxRetries,
+		retryBaseDelayMs: options.retryBaseDelayMs,
+		retryMaxDelayMs: options.retryMaxDelayMs,
+		onError: options.onError,
+		buildEnvelope: (items) => JSON.stringify({
+			sdk: {
+				name: SDK_NAME,
+				version: SDK_VERSION
+			},
+			sent_at: (/* @__PURE__ */ new Date()).toISOString(),
+			items
+		})
+	});
+	let timer = null;
+	if (options.flushIntervalMs > 0) {
+		var _unref;
+		timer = setInterval(() => {
+			queue.flush();
+		}, options.flushIntervalMs);
+		(_unref = timer.unref) === null || _unref === void 0 || _unref.call(timer);
+	}
+	/**
+	* 合并业务用户与 SDK 的匿名 id。
+	* 登录只增加 id，不会替换或重新生成 anonymous_id。
+	*/
+	function resolveUser(override) {
+		var _ref, _base$anonymous_id;
+		const base = (_ref = override !== null && override !== void 0 ? override : scope.user) !== null && _ref !== void 0 ? _ref : {};
+		return _objectSpread2(_objectSpread2({}, base), {}, { anonymous_id: (_base$anonymous_id = base.anonymous_id) !== null && _base$anonymous_id !== void 0 ? _base$anonymous_id : anonymousId });
+	}
+	/** 追加面包屑，并自动补页面会话字段。 */
+	function addBreadcrumbInternal(breadcrumb) {
+		try {
+			const session = pageSession.info();
+			breadcrumbs.add(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({}, breadcrumb), breadcrumb.session_id ? {} : { session_id: session.id }), breadcrumb.seq !== void 0 ? {} : { seq: pageSession.nextSeq() }), breadcrumb.t_rel_ms !== void 0 ? {} : { t_rel_ms: pageSession.elapsedMs }));
+		} catch (_unused3) {}
+	}
+	/** 把上一次捕获的异常写成面包屑，方便看连续报错的时间线。 */
+	function addExceptionBreadcrumb(item) {
+		if (item.type !== "error") return;
+		try {
+			const exception = item.exception;
+			const value = exception.value ? truncateText(exception.value, 200) : "";
+			addBreadcrumbInternal({
+				type: "exception",
+				level: item.level,
+				timestamp: Date.now(),
+				message: value ? `${exception.type}: ${value}` : exception.type,
+				data: _objectSpread2({ type: exception.type }, value ? { value } : {})
+			});
+		} catch (_unused4) {}
+	}
+	/** 开始一次页面会话，并同步到事件上下文。 */
+	function startPageSession(path, meta = {}) {
+		const info = pageSession.start(path, meta);
+		requestLog.clear();
+		scope.setContext("page", pageSession.context());
+		return info;
+	}
+	/** 记录一次已完成请求；页面会话 id 自动补齐。 */
+	function recordRequest(record) {
+		try {
+			var _record$session_id;
+			requestLog.add(_objectSpread2(_objectSpread2({}, record), {}, { session_id: (_record$session_id = record.session_id) !== null && _record$session_id !== void 0 ? _record$session_id : pageSession.info().id }));
+		} catch (_unused5) {}
+	}
+	/** 组装 contexts，并按需带上当前页面会话的请求日志。 */
+	function buildContexts(includeRequestLog = false, extra = {}) {
+		const contexts = mergeContexts(deps.context.collect(), scope.contexts);
+		const breadcrumbStats = breadcrumbs.stats();
+		contexts.breadcrumb_stats = {
+			size: breadcrumbStats.size,
+			max: breadcrumbStats.max,
+			dropped: breadcrumbStats.dropped
+		};
+		if (includeRequestLog) {
+			const requests = requestLog.snapshot();
+			if (requests.total > 0) contexts.requests = {
+				items: requests.items,
+				total: requests.total,
+				failed: requests.failed
+			};
+		}
+		for (const [key, value] of Object.entries(extra)) {
+			var _contexts$key;
+			contexts[key] = _objectSpread2(_objectSpread2({}, (_contexts$key = contexts[key]) !== null && _contexts$key !== void 0 ? _contexts$key : {}), value);
+		}
+		return contexts;
+	}
+	/** 组装所有事件共用的字段。
+	* 每次调用都生成新的事件 id 与时间戳。
+	*/
+	function buildBase(includeRequestLog = false) {
+		var _scope$user, _scope$user$anonymous, _scope$user2, _deps$context$pageUrl, _deps$context, _deps$context$pageRou, _deps$context2;
+		return {
+			event_id: createEventId(),
+			occurrences: 1,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			platform: deps.context.platform,
+			environment: options.environment,
+			release: options.release,
+			dist: options.dist,
+			breadcrumbs: breadcrumbs.snapshot(),
+			contexts: buildContexts(includeRequestLog),
+			tags: _objectSpread2({}, scope.tags),
+			user: _objectSpread2(_objectSpread2({}, (_scope$user = scope.user) !== null && _scope$user !== void 0 ? _scope$user : {}), {}, { anonymous_id: (_scope$user$anonymous = (_scope$user2 = scope.user) === null || _scope$user2 === void 0 ? void 0 : _scope$user2.anonymous_id) !== null && _scope$user$anonymous !== void 0 ? _scope$user$anonymous : anonymousId }),
+			url: (_deps$context$pageUrl = (_deps$context = deps.context).pageUrl) === null || _deps$context$pageUrl === void 0 ? void 0 : _deps$context$pageUrl.call(_deps$context),
+			route: (_deps$context$pageRou = (_deps$context2 = deps.context).pageRoute) === null || _deps$context$pageRou === void 0 ? void 0 : _deps$context$pageRou.call(_deps$context2)
+		};
+	}
+	/** 把任意抛出物转成协议里的 exception 结构。 */
+	function normalizeError(error) {
+		if (error instanceof Error) return {
+			type: error.name || "Error",
+			value: error.message,
+			stacktrace: parseStack(error.stack)
+		};
+		if (typeof error === "string") return {
+			type: "Error",
+			value: error
+		};
+		try {
+			return {
+				type: "Error",
+				value: JSON.stringify(error)
+			};
+		} catch (_unused6) {
+			return {
+				type: "Error",
+				value: String(error)
+			};
+		}
+	}
+	/**
+	* 把 V8 / Gecko / JavaScriptCore 的 stack 字符串解析成帧数组。
+	*
+	* V8:    at fn (https://a.com/app.js:1:2)
+	* Gecko: fn@https://a.com/app.js:1:2
+	* JSC:   fn@https://a.com/app.js:1:2
+	*
+	* 不再无条件跳过第一行：Safari/Firefox 的第一行就是真实帧。
+	*/
+	function parseStack(stack) {
+		if (!stack) return void 0;
+		const frames = [];
+		for (const line of stack.split(/\r?\n/)) {
+			const v8 = line.match(/^\s*at\s+(?:(.*?)\s+\()?(.*?):(\d+)(?::(\d+))?\)?\s*$/);
+			if (v8) {
+				const [, fn, filename, lineno, colno] = v8;
+				frames.push(makeFrame(fn, filename, lineno, colno));
+				continue;
+			}
+			const gecko = line.match(/^(.*?)@(.*?):(\d+)(?::(\d+))?$/);
+			if (gecko) {
+				const [, fn, filename, lineno, colno] = gecko;
+				frames.push(makeFrame(fn, filename, lineno, colno));
+			}
+		}
+		return frames.length > 0 ? { frames } : void 0;
+	}
+	function makeFrame(fn, filename, lineno, colno) {
+		const file = filename || "<unknown>";
+		return _objectSpread2(_objectSpread2({
+			filename: file,
+			function: fn ? fn.trim() || void 0 : void 0,
+			lineno: Number(lineno)
+		}, colno ? { colno: Number(colno) } : {}), {}, { in_app: !file.includes("node_modules") });
+	}
+	/** 客户端节流签名：类型 + 消息 + 首个业务帧。行号刻意不参与，与服务端一致。 */
+	function signatureOf(item) {
+		var _item$exception$stack, _item$exception$stack2, _item$exception$value, _first$function, _first$filename;
+		if (item.type !== "error") return `${item.type}:${item.event_id}`;
+		const first = ((_item$exception$stack = (_item$exception$stack2 = item.exception.stacktrace) === null || _item$exception$stack2 === void 0 ? void 0 : _item$exception$stack2.frames) !== null && _item$exception$stack !== void 0 ? _item$exception$stack : []).find((frame) => frame.in_app);
+		return `${item.exception.type}|${(_item$exception$value = item.exception.value) !== null && _item$exception$value !== void 0 ? _item$exception$value : ""}|${(_first$function = first === null || first === void 0 ? void 0 : first.function) !== null && _first$function !== void 0 ? _first$function : ""}@${(_first$filename = first === null || first === void 0 ? void 0 : first.filename) !== null && _first$filename !== void 0 ? _first$filename : ""}`;
+	}
+	/**
+	* 先按协议裁剪，再走 beforeSend，最后再裁剪一次。
+	*
+	* beforeSend 可能改大字段或返回缺字段的对象；第二次裁剪保证最终入队
+	* 的 item 仍然符合服务端 schema，避免被静默丢弃。
+	*/
+	function prepareItem(item) {
+		const normalized = normalizeEventItem(item);
+		if (!normalized) return null;
+		const filtered = options.beforeSend ? options.beforeSend(normalized) : normalized;
+		if (!filtered) return null;
+		return normalizeEventItem(filtered);
+	}
+	/** 统一走 beforeSend 与队列，避免每种事件各写一遍。 */
+	function submit(item) {
+		const prepared = prepareItem(item);
+		if (prepared) queue.enqueue(prepared);
+		return prepared;
+	}
+	return {
+		captureException(error, context = {}) {
+			try {
+				var _context$level, _context$contexts, _context$tags;
+				const prepared = prepareItem(_objectSpread2(_objectSpread2({}, buildBase(true)), {}, {
+					type: "error",
+					category: "code",
+					level: (_context$level = context.level) !== null && _context$level !== void 0 ? _context$level : "error",
+					message: error instanceof Error ? error.message : String(error),
+					exception: normalizeError(error),
+					contexts: buildContexts(true, (_context$contexts = context.contexts) !== null && _context$contexts !== void 0 ? _context$contexts : {}),
+					tags: _objectSpread2(_objectSpread2({}, scope.tags), (_context$tags = context.tags) !== null && _context$tags !== void 0 ? _context$tags : {}),
+					user: resolveUser(context.user)
+				}));
+				if (!prepared) return "";
+				const result = throttle.register(prepared, signatureOf(prepared));
+				if (!result.added && result.existing) {
+					result.existing.occurrences = Math.min(result.existing.occurrences + 1, MAX_OCCURRENCES);
+					return result.existing.event_id;
+				}
+				queue.enqueue(prepared);
+				addExceptionBreadcrumb(prepared);
+				return prepared.event_id;
+			} catch (_unused7) {
+				return "";
+			}
+		},
+		captureMessage(message, level = "info", context = {}) {
+			try {
+				var _context$level2, _context$source, _context$contexts2, _context$tags2, _filtered$event_id;
+				const filtered = submit(_objectSpread2(_objectSpread2({}, buildBase(true)), {}, {
+					type: "message",
+					category: "interface",
+					level: (_context$level2 = context.level) !== null && _context$level2 !== void 0 ? _context$level2 : level,
+					source: (_context$source = context.source) !== null && _context$source !== void 0 ? _context$source : "message",
+					message,
+					contexts: buildContexts(true, (_context$contexts2 = context.contexts) !== null && _context$contexts2 !== void 0 ? _context$contexts2 : {}),
+					tags: _objectSpread2(_objectSpread2({}, scope.tags), (_context$tags2 = context.tags) !== null && _context$tags2 !== void 0 ? _context$tags2 : {}),
+					user: resolveUser(context.user)
+				}));
+				return (_filtered$event_id = filtered === null || filtered === void 0 ? void 0 : filtered.event_id) !== null && _filtered$event_id !== void 0 ? _filtered$event_id : "";
+			} catch (_unused8) {
+				return "";
+			}
+		},
+		track(name, properties = {}) {
+			try {
+				submit(_objectSpread2(_objectSpread2({}, buildBase(false)), {}, {
+					type: "track",
+					event_name: name,
+					properties
+				}));
+			} catch (_unused9) {}
+		},
+		startPageSession,
+		recordRequest,
+		addBreadcrumb(breadcrumb) {
+			addBreadcrumbInternal(breadcrumb);
+		},
+		setUser(user) {
+			scope.setUser(user);
+		},
+		setTag(key, value) {
+			scope.setTag(key, value);
+		},
+		setContext(key, value) {
+			scope.setContext(key, value);
+		},
+		async flush(options) {
+			try {
+				await queue.flush(options);
+			} catch (_unused10) {}
+		},
+		close() {
+			if (timer) {
+				clearInterval(timer);
+				timer = null;
+			}
+		}
+	};
+}
+// src/errors.ts
+/**
+* 上报失败错误。
+*
+* 队列需要根据 HTTP 状态判断是否值得重试：
+* - 网络错误、408、425、429、5xx：可以重试；
+* - 400、401、403、404、413、422 等：重试也不会成功，应该丢弃。
+*/
+var FireflyTransportError = class extends Error {
+	constructor(message, options = {}) {
+		var _options$retryable;
+		super(message);
+		_defineProperty(this, "statusCode", void 0);
+		_defineProperty(this, "retryable", void 0);
+		_defineProperty(this, "retryAfterMs", void 0);
+		_defineProperty(this, "cause", void 0);
+		this.name = "FireflyTransportError";
+		this.statusCode = options.statusCode;
+		this.retryable = (_options$retryable = options.retryable) !== null && _options$retryable !== void 0 ? _options$retryable : isRetryableStatus(options.statusCode);
+		this.retryAfterMs = options.retryAfterMs;
+		this.cause = options.cause;
+	}
+};
+/** 根据 HTTP 状态判断是否可重试。 */
+function isRetryableStatus(statusCode) {
+	if (statusCode === void 0 || statusCode === 0) return true;
+	if (statusCode === 408 || statusCode === 425 || statusCode === 429) return true;
+	return statusCode >= 500;
+}
+/** 解析 Retry-After：支持秒数和 HTTP 日期两种格式。 */
+function parseRetryAfter(value) {
+	if (!value) return void 0;
+	const seconds = Number(value);
+	if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+	const date = Date.parse(value);
+	if (!Number.isFinite(date)) return void 0;
+	return Math.max(0, date - Date.now());
+}
+// src/http.ts
+/** 面包屑里单个 body 的上限；请求日志自身还有更小的限制。 */
+const MAX_BREADCRUMB_BODY_CHARS = 1024;
+/** 把过大的 body 压成 JSON 字符串片段，避免 50 条面包屑撑爆信封。 */
+function compactBody(value) {
+	if (value === void 0) return {
+		value,
+		truncated: false
+	};
+	if (typeof value === "string") return truncateWithTail(value, MAX_BREADCRUMB_BODY_CHARS);
+	try {
+		const json = JSON.stringify(value);
+		if (!json || json.length <= MAX_BREADCRUMB_BODY_CHARS) return {
+			value,
+			truncated: false
+		};
+		return {
+			value: truncateWithTail(json, MAX_BREADCRUMB_BODY_CHARS).value,
+			truncated: true
+		};
+	} catch (_unused) {
+		return {
+			value: "[Unserializable]",
+			truncated: true
+		};
+	}
+}
+/**
+* 记录一次已完成请求。
+*
+* 所有请求都进入页面请求日志；只有失败请求或慢请求才写面包屑，
+* 避免 50 条面包屑缓冲被正常请求挤满。
+*/
+function captureHttpRequest(client, details) {
+	var _details$ok, _details$slowThreshol;
+	const ok = (_details$ok = details.ok) !== null && _details$ok !== void 0 ? _details$ok : details.statusCode >= 200 && details.statusCode < 400;
+	const statusLabel = details.statusCode > 0 ? String(details.statusCode) : "NETWORK";
+	const requestBody = compactBody(details.requestBody);
+	const responseBody = compactBody(details.responseBody);
+	const requestBodyTruncated = details.requestBodyTruncated || requestBody.truncated;
+	const responseBodyTruncated = details.responseBodyTruncated || responseBody.truncated;
+	const data = _objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({
+		method: details.method,
+		url: details.url,
+		status_code: details.statusCode,
+		duration_ms: details.durationMs,
+		ok,
+		phase: "end"
+	}, details.requestId ? { request_id: details.requestId } : {}), details.responseSize !== void 0 ? { response_size: details.responseSize } : {}), details.requestBody !== void 0 ? { request_body: requestBody.value } : {}), requestBodyTruncated ? { request_body_truncated: true } : {}), details.responseBody !== void 0 ? { response_body: responseBody.value } : {}), responseBodyTruncated ? { response_body_truncated: true } : {}), details.responseHeaders ? { response_headers: details.responseHeaders } : {}), details.error ? { error: details.error } : {});
+	try {
+		var _client$recordRequest;
+		(_client$recordRequest = client.recordRequest) === null || _client$recordRequest === void 0 || _client$recordRequest.call(client, _objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({
+			method: details.method,
+			url: details.url,
+			status_code: details.statusCode,
+			duration_ms: details.durationMs,
+			ok,
+			category: details.category
+		}, details.startedAt !== void 0 ? { started_at: new Date(details.startedAt).toISOString() } : {}), details.requestId ? { request_id: details.requestId } : {}), details.responseSize !== void 0 ? { response_size: details.responseSize } : {}), details.requestBody !== void 0 ? { request_body: requestBody.value } : {}), requestBodyTruncated ? { request_body_truncated: true } : {}), details.responseBody !== void 0 ? { response_body: responseBody.value } : {}), responseBodyTruncated ? { response_body_truncated: true } : {}), details.error ? { error: details.error } : {}));
+	} catch (_unused2) {}
+	const slow = details.durationMs >= ((_details$slowThreshol = details.slowThresholdMs) !== null && _details$slowThreshol !== void 0 ? _details$slowThreshol : 1e3);
+	if (!ok || slow) try {
+		client.addBreadcrumb({
+			type: "http",
+			category: details.category,
+			level: ok ? "warning" : "error",
+			timestamp: Date.now(),
+			message: `${details.method} ${details.url} -> ${statusLabel}${ok ? ` (${details.durationMs}ms)` : ""}`,
+			data
+		});
+	} catch (_unused3) {}
+	if (ok) return;
+	try {
+		client.captureMessage(`HTTP ${statusLabel} ${details.method} ${details.url}`, "error", {
+			source: "http",
+			tags: {
+				source: "http",
+				http_method: details.method,
+				http_status: details.statusCode
+			},
+			contexts: { http: data }
+		});
+	} catch (_unused4) {}
+}
+/**
+* 失败请求的兼容入口。
+*
+* 保留原函数名，避免已接入的适配层和行为测试需要同时改。
+*/
+function captureHttpFailure(client, details) {
+	captureHttpRequest(client, _objectSpread2(_objectSpread2({}, details), {}, { ok: false }));
+}
+/** 成功请求入口；慢请求会自动写 warning 面包屑。 */
+function captureHttpSuccess(client, details) {
+	captureHttpRequest(client, _objectSpread2(_objectSpread2({}, details), {}, { ok: true }));
+}
+// src/http-capture.ts
+/** 默认需要脱敏的字段名，匹配时会忽略大小写、下划线和连字符。 */
+const DEFAULT_HTTP_REDACT_KEYS = [
+	"password",
+	"passwd",
+	"pwd",
+	"token",
+	"accesstoken",
+	"refreshtoken",
+	"idtoken",
+	"authtoken",
+	"jwt",
+	"authorization",
+	"cookie",
+	"setcookie",
+	"secret",
+	"clientsecret",
+	"apikey",
+	"session",
+	"sessionid",
+	"csrf",
+	"creditcard",
+	"cardnumber",
+	"cvv",
+	"idcard",
+	"phone",
+	"mobile",
+	"email"
+];
+/** 字段名归一化，便于匹配 accessToken / access_token / access-token。 */
+function normalizeHttpRedactKey(key) {
+	return key.toLowerCase().replace(/[_\-\s]/g, "");
+}
+/** 判断一个字段名是否在脱敏清单里。 */
+function isHttpRedactKey(key, redactKeys) {
+	return redactKeys.has(normalizeHttpRedactKey(key));
+}
+/** 递归脱敏，保留字段名，只替换值。 */
+function redactValue(value, redactKeys, depth) {
+	if (depth > 6) return "[MAX_DEPTH]";
+	if (Array.isArray(value)) return value.map((item) => redactValue(item, redactKeys, depth + 1));
+	if (!value || typeof value !== "object") return value;
+	if (Object.prototype.toString.call(value) !== "[object Object]") return value;
+	const result = {};
+	for (const [key, item] of Object.entries(value)) result[key] = isHttpRedactKey(key, redactKeys) ? "[REDACTED]" : redactValue(item, redactKeys, depth + 1);
+	return result;
+}
+/** 判断 Content-Type 是否是 JSON。 */
+function isJsonContentType(contentType) {
+	const value = contentType.toLowerCase();
+	return value.includes("application/json") || value.includes("+json");
+}
+/** 安全解析 JSON。 */
+function parseJson(value) {
+	try {
+		return JSON.parse(value);
+	} catch (_unused) {
+		return;
+	}
+}
+/** 解码 form-urlencoded 的 key/value；异常数据保留原值。 */
+function decodeFormComponent(value) {
+	try {
+		return decodeURIComponent(value.replace(/\+/g, " "));
+	} catch (_unused2) {
+		return value;
+	}
+}
+/**
+* 手动解析 application/x-www-form-urlencoded。
+*
+* 不依赖 URLSearchParams：部分小程序基础库和老 WebView 没有这个全局类。
+*/
+function parseFormUrlEncoded(value) {
+	const result = {};
+	for (const pair of value.split("&")) {
+		if (!pair) continue;
+		const index = pair.indexOf("=");
+		const rawKey = index === -1 ? pair : pair.slice(0, index);
+		const rawValue = index === -1 ? "" : pair.slice(index + 1);
+		result[decodeFormComponent(rawKey)] = decodeFormComponent(rawValue);
+	}
+	return result;
+}
+/** 把 fetch / XHR / uni.request / Taro.request 的 body 统一成可序列化对象。 */
+function normalizeBody(body, contentType) {
+	if (body === null || body === void 0) return void 0;
+	if (typeof body === "string") {
+		const trimmed = body.trim();
+		if (!trimmed) return void 0;
+		if (isJsonContentType(contentType) || /^[[{]/.test(trimmed)) return parseJson(trimmed);
+		if (contentType.toLowerCase().includes("application/x-www-form-urlencoded")) return parseFormUrlEncoded(body);
+		return;
+	}
+	if (typeof URLSearchParams !== "undefined" && body instanceof URLSearchParams) {
+		const result = {};
+		body.forEach((value, key) => {
+			result[key] = value;
+		});
+		return result;
+	}
+	if (typeof FormData !== "undefined" && body instanceof FormData) {
+		const result = {};
+		body.forEach((value, key) => {
+			result[key] = typeof value === "string" ? value : {
+				file: value.name,
+				size: value.size,
+				type: value.type
+			};
+		});
+		return result;
+	}
+	if (typeof Blob !== "undefined" && body instanceof Blob) return {
+		type: body.type,
+		size: body.size
+	};
+	if (typeof ArrayBuffer !== "undefined" && body instanceof ArrayBuffer) return {
+		type: "ArrayBuffer",
+		byteLength: body.byteLength
+	};
+	if (typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(body)) return {
+		type: body.constructor.name,
+		byteLength: body.byteLength
+	};
+	if (typeof ReadableStream !== "undefined" && body instanceof ReadableStream) return;
+	if (typeof body === "object") return body;
+}
+/**
+* 序列化并脱敏请求体。
+*
+* 只处理 JSON、form-urlencoded、FormData 和普通对象；二进制和流式 body
+* 只记录类型/大小，避免读取原始内容。
+*/
+function serializeHttpBody(body, contentType, options = {}) {
+	var _options$redactKeys;
+	const normalized = normalizeBody(body, contentType !== null && contentType !== void 0 ? contentType : "");
+	if (normalized === void 0) return void 0;
+	const redacted = redactValue(normalized, new Set([...DEFAULT_HTTP_REDACT_KEYS, ...(_options$redactKeys = options.redactKeys) !== null && _options$redactKeys !== void 0 ? _options$redactKeys : []].map(normalizeHttpRedactKey)), 0);
+	let json;
+	try {
+		json = JSON.stringify(redacted);
+	} catch (_unused3) {
+		return;
+	}
+	if (!json) return void 0;
+	const maxChars = options.maxChars && options.maxChars > 0 ? options.maxChars : 4096;
+	if (json.length <= maxChars) return {
+		value: redacted,
+		truncated: false
+	};
+	return {
+		value: json.slice(0, maxChars),
+		truncated: true
+	};
+}
+/** 判断 Content-Type 是否适合按文本保留。 */
+function isTextContentType(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");
+}
+/**
+* 序列化响应体。
+*
+* 与请求体不同，响应体经常是 HTML 错误页或纯文本提示，
+* JSON 解析失败时保留一段可读文本，避免接口 500 时只看到状态码。
+* 二进制响应（图片、文件流）直接跳过。
+*/
+function serializeHttpResponseBody(body, contentType, options = {}) {
+	const capture = serializeHttpBody(body, contentType, options);
+	if (capture) return capture;
+	if (typeof body !== "string") return void 0;
+	if (!isTextContentType(contentType !== null && contentType !== void 0 ? contentType : "")) return void 0;
+	const text = body.trim();
+	if (!text) return void 0;
+	const maxChars = options.maxChars && options.maxChars > 0 ? options.maxChars : 4096;
+	return text.length <= maxChars ? {
+		value: text,
+		truncated: false
+	} : {
+		value: text.slice(0, maxChars),
+		truncated: true
+	};
+}
+/** 判断一个 URL 是否是 SDK 自己的上报地址，避免递归上报。 */
+function isIngestRequestUrl(url) {
+	try {
+		return new URL(url, "http://localhost").pathname.includes("/api/ingest/");
+	} catch (_unused4) {
+		return url.includes("/api/ingest/");
+	}
+}
+// src/browser-hooks.ts
+const MAX_ARG_CHARS = 120;
+const MAX_MESSAGE_CHARS = 300;
+const MAX_ARGS = 5;
+function formatArg(value) {
+	if (typeof value === "string") return value.length <= MAX_ARG_CHARS ? value : `${value.slice(0, MAX_ARG_CHARS)}…`;
+	if (value instanceof Error) return `${value.name}: ${value.message}`.slice(0, MAX_ARG_CHARS);
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (typeof value === "function") return `[Function ${value.name || "anonymous"}]`;
+	if (typeof value === "bigint" || typeof value === "symbol") return String(value);
+	if (typeof value === "object") try {
+		const json = JSON.stringify(value);
+		if (!json) return String(value);
+		return json.length <= MAX_ARG_CHARS ? json : `${json.slice(0, MAX_ARG_CHARS)}…`;
+	} catch (_unused) {
+		return Object.prototype.toString.call(value);
+	}
+	return String(value).slice(0, MAX_ARG_CHARS);
+}
+function formatArgs(args) {
+	const text = args.slice(0, MAX_ARGS).map(formatArg).filter((item) => item.length > 0).join(" ");
+	return text.length <= MAX_MESSAGE_CHARS ? text : `${text.slice(0, MAX_MESSAGE_CHARS)}…`;
+}
+/** 采集 console.error / console.warn。 */
+function installConsoleBreadcrumbs(client, options = {}) {
+	if (options.captureConsole === false) return () => {};
+	if (typeof console === "undefined") return () => {};
+	const originalError = console.error;
+	const originalWarn = console.warn;
+	const wrap = (level) => {
+		const original = level === "error" ? originalError : originalWarn;
+		return function(...args) {
+			try {
+				const text = formatArgs(args);
+				client.addBreadcrumb({
+					type: "console",
+					category: level,
+					level: level === "error" ? "error" : "warning",
+					timestamp: Date.now(),
+					message: text ? `console.${level}: ${text}` : `console.${level}`,
+					data: {
+						logger: level,
+						args: args.slice(0, MAX_ARGS).map(formatArg)
+					}
+				});
+			} catch (_unused2) {}
+			original.apply(this, args);
+		};
+	};
+	const wrappedError = wrap("error");
+	const wrappedWarn = wrap("warn");
+	try {
+		console.error = wrappedError;
+		console.warn = wrappedWarn;
+	} catch (_unused3) {
+		return () => {};
+	}
+	return () => {
+		if (console.error === wrappedError) console.error = originalError;
+		if (console.warn === wrappedWarn) console.warn = originalWarn;
+	};
+}
+const INTERACTIVE_SELECTOR = "button, a, [role=\"button\"], input, select, textarea, label, [data-testid], [data-test]";
+function escapeIdentifier(value) {
+	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return CSS.escape(value);
+	return value.replace(/[^a-zA-Z0-9_-]/g, (char) => `\\${char}`);
+}
+function selectorOf(element) {
+	var _element$getAttribute;
+	const testId = (_element$getAttribute = element.getAttribute("data-testid")) !== null && _element$getAttribute !== void 0 ? _element$getAttribute : element.getAttribute("data-test");
+	if (testId) return `[data-testid="${testId.replace(/"/g, "\\\"")}"]`;
+	if (element.id) return `#${escapeIdentifier(element.id)}`;
+	const tag = element.tagName.toLowerCase();
+	const classes = Array.from(element.classList).slice(0, 2);
+	if (classes.length === 0) return tag;
+	return `${tag}.${classes.map(escapeIdentifier).join(".")}`;
+}
+function textOf(element) {
+	var _ref, _ref2, _ref3, _element$getAttribute2;
+	const raw = ((_ref = (_ref2 = (_ref3 = (_element$getAttribute2 = element.getAttribute("aria-label")) !== null && _element$getAttribute2 !== void 0 ? _element$getAttribute2 : element.getAttribute("title")) !== null && _ref3 !== void 0 ? _ref3 : element.getAttribute("placeholder")) !== null && _ref2 !== void 0 ? _ref2 : element.textContent) !== null && _ref !== void 0 ? _ref : "").replace(/\s+/g, " ").trim();
+	if (!raw) return void 0;
+	return raw.length > 60 ? `${raw.slice(0, 60)}…` : raw;
+}
+function describe(element) {
+	const info = {
+		selector: selectorOf(element),
+		tag: element.tagName.toLowerCase()
+	};
+	const text = textOf(element);
+	if (text) info.text = text;
+	if (element.id) info.id = element.id;
+	if (element.classList.length > 0) info.classes = Array.from(element.classList).slice(0, 4);
+	for (const [key, attribute] of [
+		["role", "role"],
+		["aria_label", "aria-label"],
+		["name", "name"],
+		["type", "type"]
+	]) {
+		const value = element.getAttribute(attribute);
+		if (value) info[key] = value;
+	}
+	if (element.tagName === "A") {
+		const href = element.getAttribute("href");
+		if (href) info.href = href;
+	}
+	return info;
+}
+/** 记录点击面包屑；没有 DOM 的小程序自动 no-op。 */
+function installClickBreadcrumbs(client) {
+	if (typeof document === "undefined") return () => {};
+	const handler = (event) => {
+		const target = event.target;
+		if (!(target instanceof Element)) return;
+		if (target === document.documentElement || target === document.body) return;
+		try {
+			var _target$closest;
+			const info = describe((_target$closest = target.closest(INTERACTIVE_SELECTOR)) !== null && _target$closest !== void 0 ? _target$closest : target);
+			client.addBreadcrumb({
+				type: "ui",
+				category: "click",
+				level: "info",
+				timestamp: Date.now(),
+				message: info.text ? `点击「${info.text}」` : `点击 ${info.selector}`,
+				data: info
+			});
+		} catch (_unused4) {}
+	};
+	document.addEventListener("click", handler, true);
+	return () => document.removeEventListener("click", handler, true);
+}
+/** 资源加载失败；没有 window 的小程序自动 no-op。 */
+function installResourceErrorHooks(client) {
+	if (typeof window === "undefined") return () => {};
+	const handleResourceError = (event) => {
+		try {
+			var _ref4, _target$src;
+			const target = event.target;
+			if (!target || typeof target.tagName !== "string") return;
+			const url = (_ref4 = (_target$src = target.src) !== null && _target$src !== void 0 ? _target$src : target.href) !== null && _ref4 !== void 0 ? _ref4 : "";
+			if (!url) return;
+			client.captureMessage(`资源加载失败: ${url}`, "warning", {
+				source: "resource",
+				tags: { resource: target.tagName.toLowerCase() }
+			});
+		} catch (_unused5) {}
+	};
+	window.addEventListener("error", handleResourceError, true);
+	return () => {
+		window.removeEventListener("error", handleResourceError, true);
+	};
+}
+/** 页面可见性与网络状态面包屑；没有 DOM 的小程序自动 no-op。 */
+function installLifecycleBreadcrumbs(client, options = {}) {
+	if (options.captureLifecycle === false) return () => {};
+	if (typeof window === "undefined" || typeof document === "undefined") return () => {};
+	const add = (category, message, data) => {
+		try {
+			client.addBreadcrumb({
+				type: "lifecycle",
+				category,
+				level: "info",
+				timestamp: Date.now(),
+				message,
+				data
+			});
+		} catch (_unused6) {}
+	};
+	const handleVisibility = () => {
+		var _window$location;
+		add("visibility", `页面${document.visibilityState === "hidden" ? "隐藏" : "可见"}`, {
+			state: document.visibilityState,
+			url: (_window$location = window.location) === null || _window$location === void 0 ? void 0 : _window$location.href
+		});
+	};
+	const handleOnline = () => {
+		var _window$location2;
+		add("network", "网络恢复", {
+			online: true,
+			url: (_window$location2 = window.location) === null || _window$location2 === void 0 ? void 0 : _window$location2.href
+		});
+	};
+	const handleOffline = () => {
+		var _window$location3;
+		add("network", "网络断开", {
+			online: false,
+			url: (_window$location3 = window.location) === null || _window$location3 === void 0 ? void 0 : _window$location3.href
+		});
+	};
+	document.addEventListener("visibilitychange", handleVisibility);
+	window.addEventListener("online", handleOnline);
+	window.addEventListener("offline", handleOffline);
+	return () => {
+		document.removeEventListener("visibilitychange", handleVisibility);
+		window.removeEventListener("online", handleOnline);
+		window.removeEventListener("offline", handleOffline);
+	};
+}
+exports.BreadcrumbStore = BreadcrumbStore;
+exports.DEFAULT_FLUSH_INTERVAL_MS = DEFAULT_FLUSH_INTERVAL_MS;
+exports.DEFAULT_HTTP_REDACT_KEYS = DEFAULT_HTTP_REDACT_KEYS;
+exports.DEFAULT_MAX_BREADCRUMBS = DEFAULT_MAX_BREADCRUMBS;
+exports.DEFAULT_MAX_HTTP_RESPONSE_CHARS = DEFAULT_MAX_HTTP_RESPONSE_CHARS;
+exports.DEFAULT_MAX_QUEUE_SIZE = DEFAULT_MAX_QUEUE_SIZE;
+exports.DEFAULT_MAX_REQUEST_LOG = DEFAULT_MAX_REQUEST_LOG;
+exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES;
+exports.DEFAULT_RETRY_BASE_DELAY_MS = DEFAULT_RETRY_BASE_DELAY_MS;
+exports.DEFAULT_RETRY_MAX_DELAY_MS = DEFAULT_RETRY_MAX_DELAY_MS;
+exports.DEFAULT_SLOW_REQUEST_THRESHOLD_MS = DEFAULT_SLOW_REQUEST_THRESHOLD_MS;
+exports.ErrorThrottle = ErrorThrottle;
+exports.EventQueue = EventQueue;
+exports.FireflyTransportError = FireflyTransportError;
+exports.PageSessionTracker = PageSessionTracker;
+exports.RequestLogStore = RequestLogStore;
+exports.Scope = Scope;
+exports.captureHttpFailure = captureHttpFailure;
+exports.captureHttpRequest = captureHttpRequest;
+exports.captureHttpSuccess = captureHttpSuccess;
+exports.createClient = createClient;
+exports.createEventId = createEventId;
+exports.installClickBreadcrumbs = installClickBreadcrumbs;
+exports.installConsoleBreadcrumbs = installConsoleBreadcrumbs;
+exports.installLifecycleBreadcrumbs = installLifecycleBreadcrumbs;
+exports.installResourceErrorHooks = installResourceErrorHooks;
+exports.isHttpRedactKey = isHttpRedactKey;
+exports.isIngestRequestUrl = isIngestRequestUrl;
+exports.isRetryableStatus = isRetryableStatus;
+exports.normalizeHttpRedactKey = normalizeHttpRedactKey;
+exports.parseRetryAfter = parseRetryAfter;
+exports.resolveOptions = resolveOptions;
+exports.serializeHttpBody = serializeHttpBody;
+exports.serializeHttpResponseBody = serializeHttpResponseBody;
+
+//# sourceMappingURL=index.cjs.map