@spatius/avatarkit 1.3.1-beta.6 → 1.3.1

package/dist/assets/{logger-D8rDVim7.js → logger-YPooEAbA.js}

@@ -1156,6 +1156,28 @@ let DrivingServiceMode = /* @__PURE__ */ function(DrivingServiceMode) {
 	DrivingServiceMode["direct"] = "direct";
 	/** Driven by host application */
 	DrivingServiceMode["backend"] = "backend";
+	/**
+	* Use this **only** when driving the avatar through the companion RTC SDK,
+	* `@spatius/avatarkit-rtc`. If you are not using that package, stay on
+	* `direct` / `backend` — do not switch to this because it looks newer.
+	*
+	* **Telemetry dimension only — it gates no behaviour.** Every session reports
+	* `dsm`; without a value of its own, RTC traffic would be indistinguishable
+	* from plain `backend` traffic on the dashboards.
+	*
+	* It deliberately does not unlock any API. RTC drives the avatar frame by
+	* frame through `AvatarView.renderFrame` / `renderFromProtobuf`, which put the
+	* view into pure-rendering mode on their own — it never calls the host-driven
+	* feeding path (`yieldAudioData` / `yieldFramesData`) that `backend` exists
+	* for. So the `=== backend` checks guarding those methods are left untouched:
+	* loosening them for `rtc` would widen the reachable API surface without
+	* enabling anything RTC actually uses.
+	*
+	* Note the two concepts sit at different levels and are not interchangeable:
+	* pure-rendering mode is a per-frame runtime state of the render loop, while
+	* this is a session-wide value declared once at `initialize`.
+	*/
+	DrivingServiceMode["rtc"] = "rtc";
 	return DrivingServiceMode;
 }({});
 let LogLevel = /* @__PURE__ */ function(LogLevel) {
@@ -7111,7 +7133,7 @@ let customRandom = (alphabet, defaultSize, getRandom) => {
 	};
 };
 let customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size | 0, random);
-let nanoid$1 = (size = 21) => {
+let nanoid$2 = (size = 21) => {
 	let id = "";
 	let bytes = crypto.getRandomValues(new Uint8Array(size |= 0));
 	while (size--) id += urlAlphabet[bytes[size] & 63];
@@ -7136,11 +7158,11 @@ function getOrCreateClientId() {
 	try {
 		const stored = localStorage.getItem(CLIENT_ID_STORAGE_KEY);
 		if (stored) return stored;
-		const clientId = nanoid$1(21);
+		const clientId = nanoid$2(21);
 		localStorage.setItem(CLIENT_ID_STORAGE_KEY, clientId);
 		return clientId;
 	} catch (error) {
-		return `temp_${nanoid$1(21)}_${Date.now()}`;
+		return `temp_${nanoid$2(21)}_${Date.now()}`;
 	}
 }
 //#endregion
@@ -7158,7 +7180,7 @@ function getOrCreateClientId() {
 * Custom character set: only uppercase, lowercase letters and numbers (URL safe, no hyphens)
 * Character set: A-Z, a-z, 0-9 (62 characters)
 */
-const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
+const nanoid$1 = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 /**
 * Generate unified conversation ID
 * 
@@ -7173,7 +7195,7 @@ const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvw
 const generateTraceId = () => generateConversationId();
 function generateConversationId() {
 	const now = /* @__PURE__ */ new Date();
-	return `${`${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}${String(now.getUTCHours()).padStart(2, "0")}${String(now.getUTCMinutes()).padStart(2, "0")}${String(now.getUTCSeconds()).padStart(2, "0")}`}_${nanoid()}`;
+	return `${`${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}${String(now.getUTCHours()).padStart(2, "0")}${String(now.getUTCMinutes()).padStart(2, "0")}${String(now.getUTCSeconds()).padStart(2, "0")}`}_${nanoid$1()}`;
 }
 //#endregion
 //#region utils/id-manager.ts
@@ -7182,9 +7204,12 @@ function generateConversationId() {
 * Unified management of all types of IDs in SDK
 * @internal
 */
+/** 与 conversation_id 同字符集：URL 安全、无连字符。 */
+const nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
 var IdManager = class {
 	ids = {
 		clientId: "",
+		sessionId: "",
 		userId: null,
 		appId: null,
 		sessionToken: null,
@@ -7267,10 +7292,16 @@ var IdManager = class {
 	getLogContext() {
 		return {
 			client_id: this.ids.clientId,
+			session_id: this.ids.sessionId,
 			user_id: this.ids.userId || "",
 			app_id: this.ids.appId || ""
 		};
 	}
+	/** 本次启动的 session id；首次调用时生成。 @internal */
+	getSessionId() {
+		if (!this.ids.sessionId) this.ids.sessionId = nanoid();
+		return this.ids.sessionId;
+	}
 	/**
 	* Clear all IDs (for testing or reset)
 	* @internal
@@ -13329,119 +13360,6 @@ var OTLPLogExporter = class extends OTLPExporterBase {
 	}
 };
 //#endregion
-//#region utils/event-store.ts
-/**
-* Event Store - Persistent buffer for OTel telemetry events.
-*
-* Each emitted event is written here before being handed to the OTel
-* BatchProcessor. When the wrapper exporter picks a batch up for HTTP
-* upload it deletes those records — so anything still here on next
-* startup is unsent and gets re-emitted (replay).
-*
-* Schema is intentionally minimal: no status / retry_count. A record's
-* presence in the store means "not yet handed to inner.export".
-* @internal
-*/
-const DB_NAME = "avatarkit_events";
-const STORE_NAME = "events";
-const DB_VERSION = 1;
-var EventStore = class {
-	db = null;
-	initPromise = null;
-	initialize() {
-		if (this.db) return Promise.resolve();
-		if (this.initPromise) return this.initPromise;
-		this.initPromise = new Promise((resolve, reject) => {
-			const req = indexedDB.open(DB_NAME, DB_VERSION);
-			req.onerror = () => reject(/* @__PURE__ */ new Error("Failed to open avatarkit_events"));
-			req.onsuccess = () => {
-				this.db = req.result;
-				resolve();
-			};
-			req.onupgradeneeded = (e) => {
-				const db = e.target.result;
-				if (!db.objectStoreNames.contains(STORE_NAME)) db.createObjectStore(STORE_NAME, {
-					keyPath: "id",
-					autoIncrement: true
-				});
-			};
-		});
-		return this.initPromise;
-	}
-	/**
-	* Append a record, returning the auto-generated id.
-	* Caller must use this id as the `_index` attribute when emitting to OTel.
-	*/
-	async add(record) {
-		if (!this.db) await this.initialize();
-		if (!this.db) throw new Error("event-store not available");
-		return new Promise((resolve, reject) => {
-			const req = this.db.transaction([STORE_NAME], "readwrite").objectStore(STORE_NAME).add(record);
-			req.onsuccess = () => resolve(req.result);
-			req.onerror = () => reject(/* @__PURE__ */ new Error("event-store add failed"));
-		});
-	}
-	/**
-	* Atomically: for each id, check whether it still exists in the store;
-	* if so, delete it and include it in the returned set. Used by the
-	* wrapper exporter to claim ownership of a batch — only records the
-	* caller successfully "took" should be forwarded to inner.export.
-	*
-	* This is the multi-tab dedup mechanism: when Tab B starts and replays
-	* records that Tab A also still has in memory, only one tab will win
-	* the take and actually send.
-	*
-	* The get + delete pair runs inside a single readwrite transaction so
-	* concurrent tabs see consistent state.
-	*/
-	async takeIfExists(ids) {
-		const taken = /* @__PURE__ */ new Set();
-		if (ids.length === 0) return taken;
-		if (!this.db) await this.initialize();
-		if (!this.db) return taken;
-		return new Promise((resolve) => {
-			const tx = this.db.transaction([STORE_NAME], "readwrite");
-			const store = tx.objectStore(STORE_NAME);
-			let pending = ids.length;
-			const finish = () => {
-				if (--pending === 0) resolve(taken);
-			};
-			for (const id of ids) {
-				const req = store.get(id);
-				req.onsuccess = () => {
-					if (req.result !== void 0) {
-						taken.add(id);
-						store.delete(id);
-					}
-					finish();
-				};
-				req.onerror = () => finish();
-			}
-			tx.onerror = () => {
-				logger.warn("[event-store] takeIfExists tx failed");
-				resolve(taken);
-			};
-		});
-	}
-	/**
-	* Return all stored records. Used on startup to replay anything left
-	* over from a previous (possibly crashed) session.
-	*/
-	async getAll() {
-		if (!this.db) await this.initialize();
-		if (!this.db) return [];
-		return new Promise((resolve) => {
-			const req = this.db.transaction([STORE_NAME], "readonly").objectStore(STORE_NAME).getAll();
-			req.onsuccess = () => resolve(req.result || []);
-			req.onerror = () => {
-				logger.warn("[event-store] getAll failed");
-				resolve([]);
-			};
-		});
-	}
-};
-const eventStore = new EventStore();
-//#endregion
 //#region node_modules/.pnpm/@opentelemetry+exporter-metrics-otlp-http@0.218.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/exporter-metrics-otlp-http/build/esm/OTLPMetricExporterOptions.js
 var AggregationTemporalityPreference;
 (function(AggregationTemporalityPreference) {
@@ -13550,7 +13468,7 @@ const HTTP_NETWORK_BUCKETS_MS = [
 	5e3
 ];
 /**
-* RTC playback 指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
+* 播放指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
 * 帧率只可能落在 0~25，缺帧数和卡顿次数几乎全部挤在第一个桶里，分位数因此毫无意义。
 * 桶按各指标的实际值域给：
 *
@@ -13559,9 +13477,18 @@ const HTTP_NETWORK_BUCKETS_MS = [
 * - 卡顿次数：数的是次数不是帧，自成一组。
 * - 百分比：每 5% 一档，0~100。
 * - 时长：分两组——整轮播放是秒级，单次卡顿是一帧起步的毫秒级。
+* - 延迟：音频送入是等距（要看偏离整秒多少），动画到达是等比（两种用法差一个数量级）。
+* - GPU 耗时：个位数毫秒，按帧预算设档。
 *
-* 这些 metric 由 @spatius/avatarkit-rtc 发出（meter 名 spatius-avatarkit-rtc），
-* 但 view 只能配在创建 MeterProvider 的这一侧，所以桶定义留在这里。
+* 本 SDK 与 @spatius/avatarkit-rtc（meter 名 spatius-avatarkit-rtc）两边的指标都在这里配：
+* view 只能配在创建 MeterProvider 的这一侧，rtc 那批虽由另一个包发出，桶定义也得留在此处。
+* 同名概念两边共用一组桶，好让两条链路的分布能直接叠着比。
+*/
+/**
+* 上界给到 30 而非 25：25fps 是目标帧率，正常轮次全落在那一档，若把它当上界，
+* 每一轮健康播放都会挤进 +Inf 溢出桶，与真正超发的异常轮次混在一起，
+* 这条 metric 就只剩「是否达标」这一个比特的信息。25 单独成档、上面再留几格，
+* 达标与超发才分得开。
 */
 const RTC_FPS_BUCKETS = [
 	0,
@@ -13588,7 +13515,12 @@ const RTC_FPS_BUCKETS = [
 	21,
 	22,
 	23,
-	24
+	24,
+	25,
+	26,
+	27,
+	28,
+	30
 ];
 /**
 * 一轮播出的帧数。档位是播放时长桶除以帧间隔（40ms），和时长视角一一对应：
@@ -13690,8 +13622,120 @@ const RTC_STALL_DURATION_BUCKETS_MS = [
 	5120,
 	10240
 ];
+/**
+* 音频送入节奏：tap_N 是第 N 秒音频送入的时刻，metric 记的是相对首包（tap_0）的累计 Δ。
+* 流式输入下 tap_1/2/4 天然聚在 1000/2000/4000 附近，偏离多少正是要看的——喂得比实时慢，
+* 后台就攒不够音频、推理迟迟不触发。等距 200ms 让这三个中心各自落在档位边界上，
+* 偏移一两档就能读出来；等比会把它们挤进同一格。
+*
+* 上界 6000 而非 4000：4000 是 tap_4 的理想值，拿理想值当上界，正常轮次会全部挤进
+* +Inf 溢出桶，与真正喂得慢的轮次混在一起。
+*/
+const AUDIO_LATENCY_BUCKETS_MS = [
+	0,
+	200,
+	400,
+	600,
+	800,
+	1e3,
+	1200,
+	1400,
+	1600,
+	1800,
+	2e3,
+	2200,
+	2400,
+	2600,
+	2800,
+	3e3,
+	3200,
+	3400,
+	3600,
+	3800,
+	4e3,
+	4200,
+	4400,
+	4600,
+	4800,
+	5e3,
+	5200,
+	5400,
+	5600,
+	5800,
+	6e3
+];
+/**
+* 动画包到达：anim_N 是第 N 组动画包到达的时刻（同样相对 tap_0 的累计 Δ）。
+* 后台攒够音频（2s/4s/4s）就推理下发，所以这个值等于「攒音频的等待 + 推理 + 网络下行」，
+* 与播放进度无关：一次性灌入 10s 预制音频，三个包会连着回来，全落在低位；实时流式喂，
+* 则要等音频攒够，anim_2 可以到十几秒。两种用法差一个数量级，同一个直方图要都装得下，
+* 因此用等比而非等距——低位密到看清推理耗时，高位疏到兜住慢速流式。
+*
+* 200ms 起步：网络下行本身就要这个量级，再往下细分没有意义。
+*/
+const ANIM_LATENCY_BUCKETS_MS = [
+	0,
+	200,
+	400,
+	800,
+	1600,
+	3200,
+	6400,
+	12800,
+	25600
+];
+/**
+* 单帧 GPU 渲染耗时。实测中低端机器可以到 30ms 上下，因此值域按机型跨度给到 100ms，
+* 每 5ms 一档——而不是只覆盖高端机那几毫秒。40ms 是一帧的总预算，越过就意味着 GPU
+* 单独一项已经吃满整帧；再往上到 100ms 是给最差的机型留的观测空间。
+*
+* webgl 没有可移植的 GPU timer，取不到样本，那几轮整条 metric 不发（见 AvatarController），
+* 所以这里的分布只含 webgpu 的真实数据，不会被一堆 0 压在第一格。
+*/
+const GPU_RENDER_BUCKETS_MS = [
+	5,
+	10,
+	15,
+	20,
+	25,
+	30,
+	35,
+	40,
+	45,
+	50,
+	55,
+	60,
+	65,
+	70,
+	75,
+	80,
+	85,
+	90,
+	95,
+	100
+];
 /** metric 名 → 桶，供下面的 views 展开。 */
-const RTC_BUCKET_PROFILES = [
+const BUCKET_PROFILES = [
+	["playback_avg_fps", RTC_FPS_BUCKETS],
+	["playback_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
+	["playback_audio_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
+	["playback_animation_frame_count", RTC_FRAME_COUNT_BUCKETS],
+	["playback_jank_frame_count", RTC_LOST_FRAME_BUCKETS],
+	["playback_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["playback_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_audio_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["playback_audio_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_audio_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
+	["playback_gpu_render_p50_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_gpu_render_p90_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_gpu_render_p95_ms", GPU_RENDER_BUCKETS_MS],
+	["playback_latency_tap_1_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["playback_latency_tap_2_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["playback_latency_tap_4_ms", AUDIO_LATENCY_BUCKETS_MS],
+	["playback_latency_anim_0_ms", ANIM_LATENCY_BUCKETS_MS],
+	["playback_latency_anim_1_ms", ANIM_LATENCY_BUCKETS_MS],
+	["playback_latency_anim_2_ms", ANIM_LATENCY_BUCKETS_MS],
 	["rtc_playback_avg_fps", RTC_FPS_BUCKETS],
 	["rtc_playback_frame_count", RTC_FRAME_COUNT_BUCKETS],
 	["rtc_playback_skipped_frames", RTC_LOST_FRAME_BUCKETS],
@@ -13700,13 +13744,49 @@ const RTC_BUCKET_PROFILES = [
 	["rtc_playback_start_transition_missing", RTC_LOST_FRAME_BUCKETS],
 	["rtc_playback_end_transition_missing", RTC_LOST_FRAME_BUCKETS],
 	["rtc_playback_skip_rate_pct", RTC_PERCENT_BUCKETS],
+	["rtc_playback_stall_rate_pct", RTC_PERCENT_BUCKETS],
 	["rtc_playback_duration_ms", RTC_PLAYBACK_DURATION_BUCKETS_MS],
 	["rtc_playback_stall_total_ms", RTC_STALL_DURATION_BUCKETS_MS],
 	["rtc_playback_stall_max_ms", RTC_STALL_DURATION_BUCKETS_MS],
 	["rtc_transport_packets_lost", RTC_LOST_FRAME_BUCKETS],
 	["rtc_transport_packets_recovered", RTC_LOST_FRAME_BUCKETS],
 	["rtc_transport_packets_dropped", RTC_LOST_FRAME_BUCKETS],
-	["rtc_transport_packets_out_of_order", RTC_LOST_FRAME_BUCKETS]
+	["rtc_transport_packets_out_of_order", RTC_LOST_FRAME_BUCKETS],
+	["rtc_transport_rtp_packets_lost", RTC_LOST_FRAME_BUCKETS],
+	["rtc_transport_rtp_loss_rate_pct", RTC_PERCENT_BUCKETS],
+	["rtc_transport_rtt_ms", [
+		10,
+		20,
+		30,
+		40,
+		50,
+		75,
+		100,
+		150,
+		200,
+		300,
+		400,
+		600,
+		800,
+		1e3
+	]],
+	["rtc_transport_jitter_ms", [
+		1,
+		2,
+		3,
+		5,
+		8,
+		12,
+		16,
+		20,
+		25,
+		30,
+		40,
+		60,
+		80,
+		120,
+		200
+	]]
 ];
 const METRIC_EXPORT_INTERVAL_MS = 1e4;
 let sdkVersion$2 = "1.0.0";
@@ -13740,11 +13820,11 @@ function initializeOtelMetrics(version, resourceAttrs) {
 				"dsm": resourceAttrs.dsm
 			}),
 			readers: [new PeriodicExportingMetricReader({
-				exporter: new OTLPMetricExporter({
+				exporter: observeExporter(new OTLPMetricExporter({
 					url: OTEL_METRICS_ENDPOINT,
 					headers: { "Authorization": buildBasicAuthHeader$1() },
 					temporalityPreference: AggregationTemporality.DELTA
-				}),
+				}), "/v1/metrics", OTEL_METRICS_ENDPOINT),
 				exportIntervalMillis: METRIC_EXPORT_INTERVAL_MS
 			})],
 			views: [{
@@ -13753,7 +13833,7 @@ function initializeOtelMetrics(version, resourceAttrs) {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
 					options: { boundaries: HTTP_NETWORK_BUCKETS_MS }
 				}
-			}, ...RTC_BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
+			}, ...BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
 				instrumentName,
 				aggregation: {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
@@ -13781,6 +13861,23 @@ function getHistogram(name) {
 	return h;
 }
 /**
+* 本周期内是否写入过**业务** metric。
+*
+* 观测遥测通道自身的那条记录（http.client.request.duration 的 /v1/* operation）有意
+* 不弄脏它：那条记录本身产生于「导出」这个动作，若也算数，就成了
+* 导出 → 写入 → 下周期非空 → 又导出 → 又写入 的永动机，用户什么都不做也每 10s 发一包。
+*
+* 只有真实业务 metric 才把它置真；metrics 导出前若为假就整轮跳过，观测记录攒着等下一趟
+* 真有业务数据的车捎走。
+*/
+let hasBusinessMetric = false;
+/** 供导出侧读取并复位。@internal */
+function takeBusinessMetricFlag() {
+	const v = hasBusinessMetric;
+	hasBusinessMetric = false;
+	return v;
+}
+/**
 * 记录一个 metric 数据点（Histogram）。
 * @param name metric 名
 * @param value 数值（延迟 ms / 帧率 / 时长 / 次数 / 比率等）
@@ -13793,6 +13890,7 @@ function recordMetric(name, value, attributes = {}) {
 	const h = getHistogram(name);
 	if (!h) return;
 	try {
+		if (name !== HTTP_CLIENT_DURATION_METRIC || !String(attributes.operation ?? "").startsWith("/v1/")) hasBusinessMetric = true;
 		h.record(value, attributes);
 	} catch (error) {
 		logger.warn(`[OTel-Metrics] Failed to record ${name}:`, error instanceof Error ? error.message : String(error));
@@ -13811,12 +13909,13 @@ function recordMetric(name, value, attributes = {}) {
 * @internal
 */
 function recordHttpClientDuration(params) {
-	const { operation, method, durationMs, statusCode, serverAddress } = params;
+	const { operation, method, durationMs, statusCode, serverAddress, cacheHit } = params;
 	const attrs = {
 		"http.request.method": method,
 		"operation": operation || "_OTHER"
 	};
 	if (serverAddress) attrs["server.address"] = serverAddress;
+	if (typeof cacheHit === "boolean") attrs["cache_hit"] = cacheHit;
 	if (typeof statusCode === "number") attrs["http.response.status_code"] = statusCode;
 	else attrs["error.type"] = "transport_error";
 	recordMetric(HTTP_CLIENT_DURATION_METRIC, durationMs, attrs);
@@ -13841,6 +13940,226 @@ function cleanupOtelMetrics() {
 	}
 }
 //#endregion
+//#region utils/otel-export-observer.ts
+/**
+* 遥测通道自身的送达可观测性 —— 给 OTLP 导出请求做 Transaction 上报。
+*
+* 三条通道（logs / metrics / traces）此前把导出结果直接透传给 BatchProcessor 就丢了：
+* 导出批量失败（网络、CDN 缓存、鉴权、后端 5xx）在后台侧只表现为「某个 app_id 数据变少」，
+* 分不清是真没数据还是上报挂了。之前 EdgeOne 边缘缓存无 ACAO 头导致 CORS 全挂就是这类。
+*
+* 复用业务请求那套 `http.client.request.duration`（同 metric 名、同 Network profile 桶、
+* 同成败判定），只是新增 operation 取值。后台不必为此建新看板。
+*
+* ## 自举局限（务必知悉）
+*
+* 这条上报**走的正是它要观测的通道**，所以：
+* - 通道整体挂掉时，这条 metric 同样发不出去 —— 覆盖不了「全挂」场景。全挂在后台侧的
+*   表现是该 app_id 数据整体消失，那本身才是信号。
+* - 真正能观测到的是**部分失败**（三条通道各自独立 exporter，logs 挂了 metrics 可能还通）
+*   与**间歇失败**（断续失败后恢复，失败计数随下一批发出）。
+*
+* ## 记录时机：暂存，等下一次导出搭车
+*
+* 导出结束时**不直接写 histogram**，只记进内存里的 pending 列表；等下一次导出发生时，
+* 才在其**开始**把 pending 写进 histogram。
+*
+* 这样做是为了让 metrics 通道自己也能被观测。直接写会形成自反馈：metrics 的导出由
+* `PeriodicExportingMetricReader` 周期驱动，写入产生数据点 → 下周期必须导出 → 导出
+* 又写入 —— 空闲时也永不静默。改成暂存后，**写入本身不触发任何导出**，只是等下一次
+* 本来就要发生的导出把它带走，环就断了。
+*
+* 代价是延迟一个周期：reader 先 `collect()` 快照、再 `_export()` 发送（见
+* PeriodicExportingMetricReader 的 _runOnce），所以在导出时写入必然错过本轮快照，
+* 数据落在下一轮。对成功率这种趋势指标，慢一个周期无妨。
+*
+* 副作用是最后一批 pending 会随页面关闭丢失（进程结束，没有"下一次导出"）。同样可接受：
+* 丢的是最后 10s 的成功率样本，不是业务数据。
+*
+* @internal
+*/
+/**
+* 已完成但尚未写进 histogram 的导出结果。上限用于兜底：正常情况下每个周期都会被
+* 排空，只有在「导出彻底停止但仍有 record 进来」这类异常下才会堆积。
+*/
+const pending = [];
+const PENDING_LIMIT = 256;
+/** 暂存一次 OTLP 导出的结果，等下一次导出搭车写入（见文件头「记录时机」）。 */
+function enqueueExportResult(p) {
+	if (pending.length >= PENDING_LIMIT) pending.shift();
+	pending.push(p);
+}
+/**
+* 把暂存的导出结果写进 histogram。在**导出开始时**调用：此时 reader 已完成本轮
+* collect 快照，写入的数据会随下一轮发出。
+*/
+function flushPendingExports() {
+	if (pending.length === 0) return;
+	const batch = pending.splice(0, pending.length);
+	for (const p of batch) recordHttpClientDuration({
+		operation: p.channel,
+		method: "POST",
+		durationMs: p.durationMs,
+		statusCode: p.success ? 200 : void 0,
+		serverAddress: p.serverAddress
+	});
+}
+/** 从 OTLP endpoint URL 取 host（低基数），取不到时退回 `_OTHER`。 */
+function hostOf(endpoint) {
+	try {
+		return new URL(endpoint).host;
+	} catch {
+		return "_OTHER";
+	}
+}
+/**
+* 给任意 OTLP exporter 包一层导出结果观测。原样透传参数与 callback，只在 callback
+* 回来时把结果暂存 —— 不改变导出行为，也不吞异常。
+*/
+function observeExporter(inner, channel, endpoint) {
+	const serverAddress = hostOf(endpoint);
+	const wrapped = new Proxy(inner, { get(target, prop, receiver) {
+		if (prop === "export") return observedExport;
+		const value = Reflect.get(target, prop, receiver);
+		return typeof value === "function" ? value.bind(target) : value;
+	} });
+	const observedExport = function(items, resultCallback) {
+		try {
+			flushPendingExports();
+		} catch {}
+		if (channel === "/v1/metrics" && !takeBusinessMetricFlag()) {
+			resultCallback({ code: 0 });
+			return;
+		}
+		const startMs = Date.now();
+		inner.export(items, (result) => {
+			try {
+				enqueueExportResult({
+					channel,
+					durationMs: Math.round(Date.now() - startMs),
+					success: result.code === 0,
+					serverAddress
+				});
+			} catch {}
+			resultCallback(result);
+		});
+	};
+	return wrapped;
+}
+//#endregion
+//#region utils/event-store.ts
+/**
+* Event Store - Persistent buffer for OTel telemetry events.
+*
+* Each emitted event is written here before being handed to the OTel
+* BatchProcessor. When the wrapper exporter picks a batch up for HTTP
+* upload it deletes those records — so anything still here on next
+* startup is unsent and gets re-emitted (replay).
+*
+* Schema is intentionally minimal: no status / retry_count. A record's
+* presence in the store means "not yet handed to inner.export".
+* @internal
+*/
+const DB_NAME = "avatarkit_events";
+const STORE_NAME = "events";
+const DB_VERSION = 1;
+var EventStore = class {
+	db = null;
+	initPromise = null;
+	initialize() {
+		if (this.db) return Promise.resolve();
+		if (this.initPromise) return this.initPromise;
+		this.initPromise = new Promise((resolve, reject) => {
+			const req = indexedDB.open(DB_NAME, DB_VERSION);
+			req.onerror = () => reject(/* @__PURE__ */ new Error("Failed to open avatarkit_events"));
+			req.onsuccess = () => {
+				this.db = req.result;
+				resolve();
+			};
+			req.onupgradeneeded = (e) => {
+				const db = e.target.result;
+				if (!db.objectStoreNames.contains(STORE_NAME)) db.createObjectStore(STORE_NAME, {
+					keyPath: "id",
+					autoIncrement: true
+				});
+			};
+		});
+		return this.initPromise;
+	}
+	/**
+	* Append a record, returning the auto-generated id.
+	* Caller must use this id as the `_index` attribute when emitting to OTel.
+	*/
+	async add(record) {
+		if (!this.db) await this.initialize();
+		if (!this.db) throw new Error("event-store not available");
+		return new Promise((resolve, reject) => {
+			const req = this.db.transaction([STORE_NAME], "readwrite").objectStore(STORE_NAME).add(record);
+			req.onsuccess = () => resolve(req.result);
+			req.onerror = () => reject(/* @__PURE__ */ new Error("event-store add failed"));
+		});
+	}
+	/**
+	* Atomically: for each id, check whether it still exists in the store;
+	* if so, delete it and include it in the returned set. Used by the
+	* wrapper exporter to claim ownership of a batch — only records the
+	* caller successfully "took" should be forwarded to inner.export.
+	*
+	* This is the multi-tab dedup mechanism: when Tab B starts and replays
+	* records that Tab A also still has in memory, only one tab will win
+	* the take and actually send.
+	*
+	* The get + delete pair runs inside a single readwrite transaction so
+	* concurrent tabs see consistent state.
+	*/
+	async takeIfExists(ids) {
+		const taken = /* @__PURE__ */ new Set();
+		if (ids.length === 0) return taken;
+		if (!this.db) await this.initialize();
+		if (!this.db) return taken;
+		return new Promise((resolve) => {
+			const tx = this.db.transaction([STORE_NAME], "readwrite");
+			const store = tx.objectStore(STORE_NAME);
+			let pending = ids.length;
+			const finish = () => {
+				if (--pending === 0) resolve(taken);
+			};
+			for (const id of ids) {
+				const req = store.get(id);
+				req.onsuccess = () => {
+					if (req.result !== void 0) {
+						taken.add(id);
+						store.delete(id);
+					}
+					finish();
+				};
+				req.onerror = () => finish();
+			}
+			tx.onerror = () => {
+				logger.warn("[event-store] takeIfExists tx failed");
+				resolve(taken);
+			};
+		});
+	}
+	/**
+	* Return all stored records. Used on startup to replay anything left
+	* over from a previous (possibly crashed) session.
+	*/
+	async getAll() {
+		if (!this.db) await this.initialize();
+		if (!this.db) return [];
+		return new Promise((resolve) => {
+			const req = this.db.transaction([STORE_NAME], "readonly").objectStore(STORE_NAME).getAll();
+			req.onsuccess = () => resolve(req.result || []);
+			req.onerror = () => {
+				logger.warn("[event-store] getAll failed");
+				resolve([]);
+			};
+		});
+	}
+};
+const eventStore = new EventStore();
+//#endregion
 //#region utils/bootstrap.ts
 /**
 * Bootstrap 全球接入入口
@@ -14230,13 +14549,13 @@ function initializeOtel(version, resourceAttrs) {
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
 			}),
-			processors: [new BatchLogRecordProcessor(new ReliableExporter(new OTLPLogExporter({
+			processors: [new BatchLogRecordProcessor(new ReliableExporter(observeExporter(new OTLPLogExporter({
 				url: OTEL_LOGS_ENDPOINT,
 				headers: {
 					"Authorization": buildBasicAuthHeader(),
 					"stream-name": OTEL_STREAM_NAME
 				}
-			})))]
+			}), "/v1/logs", OTEL_LOGS_ENDPOINT)))]
 		});
 		logs.setGlobalLoggerProvider(loggerProvider);
 		isInitialized$1 = true;
@@ -15115,7 +15434,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-DR8dNylh.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-C_Anluwp.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();
@@ -15205,4 +15524,4 @@ function captureErrorContext(level, error) {
 	});
 }
 //#endregion
-export { ROOT_CONTEXT as $, hrTimeDuration as A, getStringFromEnv as B, OTLPExporterBase as C, ExportResultCode as D, BindOnceFuture as E, ATTR_EXCEPTION_MESSAGE as F, diag as G, isTracingSuppressed as H, ATTR_EXCEPTION_STACKTRACE as I, isValidTraceId as J, context as K, ATTR_EXCEPTION_TYPE as L, isTimeInputHrTime as M, millisToHrTime as N, addHrTimes as O, otperformance as P, createNoopMeter as Q, ATTR_SERVICE_NAME as R, toAttributes$1 as S, resourceFromAttributes as T, suppressTracing as U, globalErrorHandler as V, trace as W, TraceFlags as X, INVALID_SPAN_CONTEXT as Y, ContextAPI as Z, recordHttpClientDuration as _, DrivingServiceMode as _t, clientContextFields as a, OTEL_LOGS_ENDPOINT as at, createInstrumentationScope as b, logEvent as c, OTEL_TRACES_ENDPOINT as ct, cleanupOtel as d, isDebugMode as dt, createContextKey as et, initializeOtel as f, idManager as ft, initializeOtelMetrics as g, DEFAULT_REGION_REQUEST as gt, cleanupOtelMetrics as h, DEFAULT_REGION as ht, cleanupPostHog as i, unregisterGlobal as it, isTimeInput as j, hrTime as k, logMetric as l, OTEL_TRACES_STREAM_NAME as lt, fetchBootstrap as m, AvatarError as mt, setLogLevel as n, getGlobal as nt, getLogsFeatureFlag as o, OTEL_PASSWORD as ot, clockSync as p, generateTraceId as pt, isSpanContextValid as q, logSink as r, registerGlobal as rt, initializePostHog as s, OTEL_STREAM_NAME as st, logger as t, DiagAPI as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_USERNAME as ut, createLegacyOtlpBrowserExportDelegate as v, ErrorCode as vt, defaultResource as w, createResource as x, JSON_ENCODER as y, LogLevel as yt, getNumberFromEnv as z };
+export { ContextAPI as $, addHrTimes as A, ATTR_SERVICE_NAME as B, createResource as C, resourceFromAttributes as D, defaultResource as E, millisToHrTime as F, suppressTracing as G, getStringFromEnv as H, otperformance as I, context as J, trace as K, ATTR_EXCEPTION_MESSAGE as L, hrTimeDuration as M, isTimeInput as N, BindOnceFuture as O, isTimeInputHrTime as P, TraceFlags as Q, ATTR_EXCEPTION_STACKTRACE as R, createInstrumentationScope as S, OTLPExporterBase as T, globalErrorHandler as U, getNumberFromEnv as V, isTracingSuppressed as W, isValidTraceId as X, isSpanContextValid as Y, INVALID_SPAN_CONTEXT as Z, cleanupOtelMetrics as _, DEFAULT_REGION as _t, clientContextFields as a, registerGlobal as at, createLegacyOtlpBrowserExportDelegate as b, ErrorCode as bt, logEvent as c, OTEL_PASSWORD as ct, cleanupOtel as d, OTEL_TRACES_STREAM_NAME as dt, createNoopMeter as et, initializeOtel as f, OTEL_USERNAME as ft, observeExporter as g, AvatarError as gt, hostOf as h, generateTraceId as ht, cleanupPostHog as i, getGlobal as it, hrTime as j, ExportResultCode as k, logMetric as l, OTEL_STREAM_NAME as lt, fetchBootstrap as m, idManager as mt, setLogLevel as n, createContextKey as nt, getLogsFeatureFlag as o, unregisterGlobal as ot, clockSync as p, isDebugMode as pt, diag as q, logSink as r, DiagAPI as rt, initializePostHog as s, OTEL_LOGS_ENDPOINT as st, logger as t, ROOT_CONTEXT as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_TRACES_ENDPOINT as ut, initializeOtelMetrics as v, DEFAULT_REGION_REQUEST as vt, toAttributes$1 as w, JSON_ENCODER as x, LogLevel as xt, recordHttpClientDuration as y, DrivingServiceMode as yt, ATTR_EXCEPTION_TYPE as z };