@spatius/avatarkit 1.3.8 → 1.3.9

package/dist/{otel-trace-CZJAGjGg.js → otel-trace-DqXSWBaw.js}

@@ -1,4 +1,26 @@
-import { n as __toESM, t as __commonJSMin } from "./rolldown-runtime-FDOR9p9I.js";
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 //#region core/sdk-ref.ts
 var ref = null;
 /** @internal 仅供 AvatarSDK 在自身模块求值时回填。 */
@@ -1292,8 +1314,6 @@ var AvatarState = /* @__PURE__ */ function(AvatarState) {
 	return AvatarState;
 }({});
 var ErrorCode = /* @__PURE__ */ function(ErrorCode) {
-	/** AppID not recognized (reserved, future appID validation logic) */
-	ErrorCode["appIDUnrecognized"] = "appIDUnrecognized";
 	/** Session Token invalid (WebSocket close code 4010) */
 	ErrorCode["sessionTokenInvalid"] = "sessionTokenInvalid";
 	/** Session Token expired (WebSocket close code 4010) */
@@ -1312,10 +1332,17 @@ var ErrorCode = /* @__PURE__ */ function(ErrorCode) {
 	ErrorCode["failedToDownloadAvatarAssets"] = "failedToDownloadAvatarAssets";
 	/** Avatar asset compatibility_flags not supported by this SDK version (upgrade SDK) */
 	ErrorCode["unsupportedAvatarAsset"] = "unsupportedAvatarAsset";
+	/**
+	* Neither WebGL2 nor WebGPU is available, so the avatar cannot be drawn at all.
+	* Typically hardware acceleration is disabled in the browser, the GPU driver is
+	* blocklisted, or the page runs in a restricted iframe. Deterministic — no point
+	* retrying; tell the user to enable graphics acceleration.
+	*/
+	ErrorCode["renderNotSupported"] = "renderNotSupported";
+	/** Render system failed to initialize for a reason other than missing WebGL2/WebGPU */
+	ErrorCode["renderInitFailed"] = "renderInitFailed";
 	/** WebSocket connection error (handshake failure, network error) */
 	ErrorCode["websocketError"] = "websocketError";
-	/** WebSocket connection closed abnormally (close code 1006) */
-	ErrorCode["websocketClosedAbnormally"] = "websocketClosedAbnormally";
 	/** WebSocket closed with unexpected close code */
 	ErrorCode["websocketClosedUnexpected"] = "websocketClosedUnexpected";
 	/** Session timeout (WebSocket close code 4002) */
@@ -1328,8 +1355,6 @@ var ErrorCode = /* @__PURE__ */ function(ErrorCode) {
 	ErrorCode["playbackStartFailed"] = "playbackStartFailed";
 	/** Playback initialization failed */
 	ErrorCode["playbackInitFailed"] = "playbackInitFailed";
-	/** Audio-only playback initialization failed */
-	ErrorCode["audioOnlyInitFailed"] = "audioOnlyInitFailed";
 	/** No audio data to play */
 	ErrorCode["noAudio"] = "noAudio";
 	/**
@@ -1355,93 +1380,671 @@ var AvatarError = class extends Error {
 		this.name = "AvatarError";
 	}
 };
-//#endregion
-//#region node_modules/.pnpm/posthog-js@1.422.5_react@19.2.4/node_modules/posthog-js/dist/module.js
-var t = "undefined" != typeof window ? window : void 0;
-var i = "undefined" != typeof globalThis ? globalThis : t;
-var e = null == i ? void 0 : i.navigator;
-var r = null == i ? void 0 : i.document;
-var s = null == i ? void 0 : i.location;
-var n = null == i ? void 0 : i.fetch;
-var o = null != i && i.XMLHttpRequest && "withCredentials" in new i.XMLHttpRequest() ? i.XMLHttpRequest : void 0;
-var a = null == i ? void 0 : i.AbortController;
-var l = null == i ? void 0 : i.CompressionStream;
-var h = null == e ? void 0 : e.userAgent;
-function u() {
-	return !(!t || !1 === t.navigator.onLine);
-}
-var d = "undefined" != typeof globalThis ? globalThis : t;
-d && "undefined" == typeof self && (d.self = d), d && "undefined" == typeof File && (d.File = function() {});
-var v = null != t ? t : {};
-var c = {
-	DEBUG: !1,
-	LIB_VERSION: "0.7.0",
-	LIB_NAME: "browser-common"
-};
-function f(t, i, e, r, s, n, o) {
-	try {
-		var a = t[n](o), l = a.value;
-	} catch (t) {
-		e(t);
-		return;
+var logSink = class LogSink {
+	static instance = null;
+	db = null;
+	dbName = "avatarkit_logs";
+	storeName = "logs";
+	version = 1;
+	trimThreshold = 5e3;
+	trimBufferSize = 1e3;
+	isFlushing = false;
+	constructor() {}
+	static getInstance() {
+		if (!LogSink.instance) LogSink.instance = new LogSink();
+		return LogSink.instance;
 	}
-	a.done ? i(l) : Promise.resolve(l).then(r, s);
-}
-function p(t) {
-	return function() {
-		var i = this, e = arguments;
-		return new Promise((function(r, s) {
-			var n = t.apply(i, e);
-			function o(t) {
-				f(n, r, s, o, a, "next", t);
-			}
-			function a(t) {
-				f(n, r, s, o, a, "throw", t);
+	/**
+	* Initialize IndexedDB
+	*/
+	async initialize() {
+		if (this.db) return;
+		return new Promise((resolve, reject) => {
+			const request = indexedDB.open(this.dbName, this.version);
+			request.onerror = () => {
+				reject(/* @__PURE__ */ new Error("Failed to open IndexedDB"));
+			};
+			request.onsuccess = () => {
+				this.db = request.result;
+				resolve();
+			};
+			request.onupgradeneeded = (event) => {
+				const db = event.target.result;
+				if (!db.objectStoreNames.contains(this.storeName)) db.createObjectStore(this.storeName, {
+					keyPath: "id",
+					autoIncrement: true
+				}).createIndex("ts", "ts", { unique: false });
+			};
+		});
+	}
+	/**
+	* Append log entry to IndexedDB
+	*/
+	async append(entry) {
+		if (!this.db) try {
+			await this.initialize();
+		} catch {
+			return;
+		}
+		if (!this.db) return;
+		try {
+			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
+			await new Promise((resolve, reject) => {
+				const request = store.add(entry);
+				request.onsuccess = () => resolve();
+				request.onerror = () => reject(/* @__PURE__ */ new Error("Failed to add log"));
+			});
+			this.getCount().then((count) => {
+				if (count > this.trimThreshold) this.trim().catch(() => {});
+			}).catch(() => {});
+		} catch (error) {}
+	}
+	/**
+	* Get total log count
+	*/
+	async getCount() {
+		if (!this.db) return 0;
+		return new Promise((resolve, reject) => {
+			const request = this.db.transaction([this.storeName], "readonly").objectStore(this.storeName).count();
+			request.onsuccess = () => {
+				resolve(request.result);
+			};
+			request.onerror = () => {
+				reject(/* @__PURE__ */ new Error("Failed to count logs"));
+			};
+		});
+	}
+	/**
+	* Trim logs to keep only recent entries
+	*/
+	async trim() {
+		if (!this.db || this.isFlushing) return;
+		try {
+			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
+			const getAllRequest = store.getAll();
+			const entries = await new Promise((resolve, reject) => {
+				getAllRequest.onsuccess = () => {
+					resolve(getAllRequest.result);
+				};
+				getAllRequest.onerror = () => {
+					reject(/* @__PURE__ */ new Error("Failed to get logs"));
+				};
+			});
+			const keepCount = this.trimThreshold - this.trimBufferSize;
+			if (entries.length <= keepCount) return;
+			entries.sort((a, b) => a.ts - b.ts);
+			const toDelete = entries.slice(0, entries.length - keepCount);
+			for (const entry of toDelete) if (entry.id !== void 0) await new Promise((resolve, reject) => {
+				const deleteRequest = store.delete(entry.id);
+				deleteRequest.onsuccess = () => resolve();
+				deleteRequest.onerror = () => reject(/* @__PURE__ */ new Error("Failed to delete log"));
+			});
+		} catch (error) {}
+	}
+	/**
+	* Flush logs to server
+	*/
+	async flush() {
+		if (!this.db || this.isFlushing) return;
+		this.isFlushing = true;
+		try {
+			const getAllRequest = this.db.transaction([this.storeName], "readonly").objectStore(this.storeName).getAll();
+			const entries = await new Promise((resolve, reject) => {
+				getAllRequest.onsuccess = () => {
+					resolve(getAllRequest.result);
+				};
+				getAllRequest.onerror = () => {
+					reject(/* @__PURE__ */ new Error("Failed to get logs"));
+				};
+			});
+			if (entries.length === 0) {
+				this.isFlushing = false;
+				return;
 			}
-			o(void 0);
-		}));
-	};
-}
-function _() {
-	return _ = Object.assign ? Object.assign.bind() : function(t) {
-		for (var i = 1; arguments.length > i; i++) {
-			var e = arguments[i];
-			for (var r in e) ({}).hasOwnProperty.call(e, r) && (t[r] = e[r]);
+			const requestBody = { logs: entries.map((entry) => ({
+				...entry,
+				extra: {
+					...entry.extra,
+					platform: "Web"
+				}
+			})) };
+			const jsonData = JSON.stringify(requestBody);
+			const gzippedData = await this.gzip(jsonData);
+			const response = await fetch("https://hogtool.spatialwalk.ai/batch-upload-log", {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					"Content-Encoding": "gzip"
+				},
+				body: gzippedData,
+				signal: AbortSignal.timeout(15e3)
+			});
+			if (!response.ok) throw new Error(`Failed to upload logs: ${response.status} ${response.statusText}`);
+			await this.clearFirst(entries.length);
+		} catch (error) {
+			console.warn("[LogSink] Failed to flush logs:", error);
+			throw error;
+		} finally {
+			this.isFlushing = false;
 		}
-		return t;
-	}, _.apply(null, arguments);
-}
-function g(t, i) {
-	if (null == t) return {};
-	var e = {};
-	for (var r in t) if ({}.hasOwnProperty.call(t, r)) {
-		if (-1 !== i.indexOf(r)) continue;
-		e[r] = t[r];
 	}
-	return e;
-}
-var m = (t) => {
-	if ("string" != typeof t) return t;
-	try {
-		return JSON.parse(t);
-	} catch (i) {
-		return t;
+	/**
+	* Clear first N log entries
+	*/
+	async clearFirst(count) {
+		if (!this.db || count <= 0) return;
+		try {
+			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
+			const getAllRequest = store.getAll();
+			const entries = await new Promise((resolve, reject) => {
+				getAllRequest.onsuccess = () => {
+					resolve(getAllRequest.result);
+				};
+				getAllRequest.onerror = () => {
+					reject(/* @__PURE__ */ new Error("Failed to get logs"));
+				};
+			});
+			entries.sort((a, b) => a.ts - b.ts);
+			const toDelete = entries.slice(0, count);
+			for (const entry of toDelete) if (entry.id !== void 0) await new Promise((resolve, reject) => {
+				const deleteRequest = store.delete(entry.id);
+				deleteRequest.onsuccess = () => resolve();
+				deleteRequest.onerror = () => reject(/* @__PURE__ */ new Error("Failed to delete log"));
+			});
+		} catch (error) {}
 	}
-};
-function y(t) {
-	return "string" == typeof t || t;
-}
-function b(t) {
-	return "string" == typeof t ? t : void 0;
-}
-var w = [
-	"$feature_flag",
-	"$feature_flag_response",
-	"$feature_flag_has_experiment",
-	"$feature_flag_id",
-	"$feature_flag_version",
-	"$feature_flag_reason",
-	"$feature_flag_request_id",
+	/**
+	* Gzip string data
+	*/
+	async gzip(data) {
+		try {
+			const encoded = new TextEncoder().encode(data);
+			const compressedStream = new ReadableStream({ start(controller) {
+				controller.enqueue(encoded);
+				controller.close();
+			} }).pipeThrough(new CompressionStream("gzip"));
+			return await new Response(compressedStream).blob();
+		} catch (error) {
+			console.error("[LogSink] gzip() error:", error);
+			throw error;
+		}
+	}
+}.getInstance();
+//#endregion
+//#region node_modules/.pnpm/nanoid@5.1.6/node_modules/nanoid/url-alphabet/index.js
+var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+//#endregion
+//#region node_modules/.pnpm/nanoid@5.1.6/node_modules/nanoid/index.browser.js
+var random = (bytes) => crypto.getRandomValues(new Uint8Array(bytes));
+var customRandom = (alphabet, defaultSize, getRandom) => {
+	let mask = (2 << Math.log2(alphabet.length - 1)) - 1;
+	let step = -~(1.6 * mask * defaultSize / alphabet.length);
+	return (size = defaultSize) => {
+		let id = "";
+		while (true) {
+			let bytes = getRandom(step);
+			let j = step | 0;
+			while (j--) {
+				id += alphabet[bytes[j] & mask] || "";
+				if (id.length >= size) return id;
+			}
+		}
+	};
+};
+var customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size | 0, random);
+var nanoid$2 = (size = 21) => {
+	let id = "";
+	let bytes = crypto.getRandomValues(new Uint8Array(size |= 0));
+	while (size--) id += urlAlphabet[bytes[size] & 63];
+	return id;
+};
+//#endregion
+//#region utils/client-id.ts
+/**
+* Client ID management utility
+* Used to generate and persist unique device identifier
+* @internal
+*/
+var CLIENT_ID_STORAGE_KEY = "spavatar_client_id";
+/**
+* Get or create client_id
+* - If exists in localStorage, return existing client_id
+* - If not exists, generate new client_id and store to localStorage
+* @returns client_id string
+* @internal
+*/
+function getOrCreateClientId() {
+	try {
+		const stored = localStorage.getItem(CLIENT_ID_STORAGE_KEY);
+		if (stored) return stored;
+		const clientId = nanoid$2(21);
+		localStorage.setItem(CLIENT_ID_STORAGE_KEY, clientId);
+		return clientId;
+	} catch (error) {
+		return `temp_${nanoid$2(21)}_${Date.now()}`;
+	}
+}
+//#endregion
+//#region utils/conversationId.ts
+/**
+* Conversation ID generation utility
+* 
+* Unified format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
+* Example: 20251027143034_aB3dEf9hIjKl
+* 
+* Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
+* @internal
+*/
+/**
+* Custom character set: only uppercase, lowercase letters and numbers (URL safe, no hyphens)
+* Character set: A-Z, a-z, 0-9 (62 characters)
+*/
+var nanoid$1 = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
+/**
+* Generate unified conversation ID
+* 
+* Format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
+* Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
+* 
+* @returns Conversation ID in format YYYYMMDDHHmmss_nanoid
+* @example
+* generateConversationId() // "20251027143034_aB3dEf9hIjKl"
+* @internal
+*/
+var 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$1()}`;
+}
+//#endregion
+//#region utils/id-manager.ts
+/**
+* ID Manager
+* Unified management of all types of IDs in SDK
+* @internal
+*/
+/** 与 conversation_id 同字符集：URL 安全、无连字符。 */
+var nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
+var IdManager = class {
+	ids = {
+		clientId: "",
+		sessionId: "",
+		userId: null,
+		appId: null,
+		sessionToken: null,
+		connectionId: null,
+		conversationId: null
+	};
+	constructor() {
+		this.ids.clientId = getOrCreateClientId();
+	}
+	getClientId() {
+		return this.ids.clientId;
+	}
+	setUserId(userId) {
+		this.ids.userId = userId;
+	}
+	getUserId() {
+		return this.ids.userId;
+	}
+	setAppId(appId) {
+		this.ids.appId = appId;
+	}
+	getAppId() {
+		return this.ids.appId;
+	}
+	setSessionToken(token) {
+		this.ids.sessionToken = token;
+	}
+	getSessionToken() {
+		return this.ids.sessionToken;
+	}
+	/**
+	* Generate new connectionId (for WebSocket connection)
+	* @internal
+	*/
+	generateConnectionId() {
+		this.ids.connectionId = generateConversationId();
+		return this.ids.connectionId;
+	}
+	/**
+	* Set connectionId (for connectionId received from server)
+	* @internal
+	*/
+	setConnectionId(connectionId) {
+		this.ids.connectionId = connectionId;
+	}
+	getConnectionId() {
+		return this.ids.connectionId;
+	}
+	clearConnectionId() {
+		this.ids.connectionId = null;
+	}
+	/**
+	* Generate new conversationId (for each conversation)
+	* @internal
+	*/
+	generateNewConversationId() {
+		this.ids.conversationId = generateConversationId();
+		return this.ids.conversationId;
+	}
+	getConversationId() {
+		return this.ids.conversationId;
+	}
+	setConversationId(conversationId) {
+		this.ids.conversationId = conversationId;
+	}
+	clearConversationId() {
+		this.ids.conversationId = null;
+	}
+	/**
+	* Get all IDs (for log reporting)
+	* @internal
+	*/
+	getAllIds() {
+		return { ...this.ids };
+	}
+	/**
+	* Get public log parameters (contains all necessary IDs)
+	* @internal
+	*/
+	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
+	*/
+	clear() {
+		this.ids.userId = null;
+		this.ids.appId = null;
+		this.ids.sessionToken = null;
+		this.ids.connectionId = null;
+		this.ids.conversationId = null;
+	}
+};
+var idManager = new IdManager();
+//#endregion
+//#region utils/log-sanitizer.ts
+var ALGORITHM_REG = new RegExp(`\\b(${[
+	"flame",
+	"keyframe",
+	"keyframes",
+	"splat",
+	"splats",
+	"covariance",
+	"gaussian",
+	"cov6",
+	"packeddata",
+	"sortorder",
+	"sortindex",
+	"avatar_core",
+	"emscripten",
+	"wasm",
+	"blendshape",
+	"expressionparam",
+	"rig"
+].join("|")})\\b`, "gi");
+/** Chinese characters (CJK Unified Ideographs) */
+var CHINESE_REG = /[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/;
+/** Patterns to redact: capture group 1 = key, 2 = value; replace value with *** */
+var SENSITIVE_PATTERNS = [
+	{
+		reg: /\b(token|sessiontoken|accesstoken|apikey|apisecret|secret|password|auth)=([^\s,}\]'"]+)/gi,
+		replacement: "$1=***"
+	},
+	{
+		reg: /\b(conversationid|connectionid|clientid|sessionid)=([^\s,}\]'"]+)/gi,
+		replacement: "$1=***"
+	},
+	{
+		reg: /\b(appid|app_id)=([^\s,}\]'"]+)/gi,
+		replacement: "$1=***"
+	},
+	{
+		reg: /\b(userid|user_id)=([^\s,}\]'"]+)/gi,
+		replacement: "$1=***"
+	},
+	{
+		reg: /(https?:\/\/)[^\s,}\]'"]+/gi,
+		replacement: "$1***"
+	},
+	{
+		reg: /(wss?:\/\/)[^\s,}\]'"]+/gi,
+		replacement: "$1***"
+	}
+];
+/**
+* Check if message contains Chinese.
+*/
+function hasChinese(msg) {
+	return CHINESE_REG.test(msg);
+}
+/**
+* Check if message contains algorithm/internal terms.
+*/
+function hasAlgorithmTerms(msg) {
+	return ALGORITHM_REG.test(msg);
+}
+/**
+* Redact sensitive substrings in message.
+*/
+function redactSensitive(msg) {
+	let out = msg;
+	for (const { reg, replacement } of SENSITIVE_PATTERNS) out = out.replace(reg, replacement);
+	return out;
+}
+/**
+* Sanitize a log message for local persistence.
+* - Do not persist if message contains Chinese or algorithm terms.
+* - Otherwise persist, but redact sensitive content first.
+*/
+function sanitizeForLocalLog(message) {
+	if (hasChinese(message) || hasAlgorithmTerms(message)) return {
+		shouldPersist: false,
+		sanitized: message
+	};
+	return {
+		shouldPersist: true,
+		sanitized: redactSensitive(message)
+	};
+}
+//#endregion
+//#region utils/logger.ts
+/**
+* Logger Utility
+* Environment-aware logger wrapper with local log persistence
+* - Always writes to local log file (IndexedDB) regardless of logLevel
+* - Console output is controlled by logLevel
+* - Errors and warnings are always reported to PostHog (when enabled)
+*
+* Usage: Replace `console.log()` with `logger.log()`
+*/
+setGlobalLogLevel(LogLevel$1.Warning);
+var baseLogger = useLogger("Web").useGlobalConfig();
+logSink.initialize().catch(() => {});
+var currentLogLevel = LogLevel.off;
+/**
+* Write log to local storage.
+* Skips persistence if message contains Chinese, algorithm terms (e.g. Flame, splat), or sensitive content.
+* Otherwise redacts sensitive substrings then persists.
+*/
+async function writeToLocalLog(message, level, extra = {}) {
+	try {
+		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
+		if (!shouldPersist) return;
+		const version = requireSDK().version;
+		const appId = idManager.getAppId();
+		const userId = idManager.getUserId();
+		await logSink.append({
+			level,
+			ts: Date.now(),
+			msg: sanitized,
+			extra: {
+				...extra,
+				_category: "Web",
+				sdk_version: version || "",
+				app_id: appId || "",
+				user_id: userId || "",
+				platform: "Web",
+				framework: "",
+				framework_version: ""
+			}
+		});
+	} catch {}
+}
+/**
+* Format console message with [AvatarKit] prefix
+*/
+function formatConsoleMessage(message) {
+	return `[AvatarKit] ${message}`;
+}
+var logger = {
+	debug: (message, ...args) => {
+		writeToLocalLog(message, "info", {}).catch(() => {});
+		if (currentLogLevel === LogLevel.all) baseLogger.debug(formatConsoleMessage(message), ...args);
+	},
+	verbose: (message, ...args) => {
+		writeToLocalLog(message, "info", {}).catch(() => {});
+		if (currentLogLevel === LogLevel.all) baseLogger.verbose(formatConsoleMessage(message), ...args);
+	},
+	log: (message, ...args) => {
+		writeToLocalLog(message, "info", {}).catch(() => {});
+		if (currentLogLevel === LogLevel.all) baseLogger.log(formatConsoleMessage(message), ...args);
+	},
+	warn: (message, ...args) => {
+		writeToLocalLog(message, "warn", {}).catch(() => {});
+		if (currentLogLevel === LogLevel.warning || currentLogLevel === LogLevel.all) baseLogger.warn(formatConsoleMessage(message), ...args);
+	},
+	error: (message, ...args) => {
+		const fullMessage = message + (args.length > 0 ? " " + args.map((a) => a instanceof Error ? a.message : typeof a === "string" ? a : JSON.stringify(a)).join(" ") : "");
+		writeToLocalLog(fullMessage, "error", {}).catch(() => {});
+		if (currentLogLevel !== LogLevel.off) baseLogger.error(formatConsoleMessage(fullMessage));
+	}
+};
+/**
+* Set SDK log level
+* Note: Local log writing is always enabled regardless of logLevel
+* @param level SDK's LogLevel enum value
+* @internal
+*/
+function setLogLevel(level) {
+	currentLogLevel = level;
+	switch (level) {
+		case LogLevel.off:
+			setGlobalLogLevel(LogLevel$1.Error);
+			break;
+		case LogLevel.error:
+			setGlobalLogLevel(LogLevel$1.Error);
+			break;
+		case LogLevel.warning:
+			setGlobalLogLevel(LogLevel$1.Warning);
+			break;
+		case LogLevel.all:
+			setGlobalLogLevel(LogLevel$1.Debug);
+			break;
+		default:
+			setGlobalLogLevel(LogLevel$1.Warning);
+			break;
+	}
+}
+//#endregion
+//#region node_modules/.pnpm/posthog-js@1.422.5_react@19.2.4/node_modules/posthog-js/dist/module.js
+var t = "undefined" != typeof window ? window : void 0;
+var i = "undefined" != typeof globalThis ? globalThis : t;
+var e = null == i ? void 0 : i.navigator;
+var r = null == i ? void 0 : i.document;
+var s = null == i ? void 0 : i.location;
+var n = null == i ? void 0 : i.fetch;
+var o = null != i && i.XMLHttpRequest && "withCredentials" in new i.XMLHttpRequest() ? i.XMLHttpRequest : void 0;
+var a = null == i ? void 0 : i.AbortController;
+var l = null == i ? void 0 : i.CompressionStream;
+var h = null == e ? void 0 : e.userAgent;
+function u() {
+	return !(!t || !1 === t.navigator.onLine);
+}
+var d = "undefined" != typeof globalThis ? globalThis : t;
+d && "undefined" == typeof self && (d.self = d), d && "undefined" == typeof File && (d.File = function() {});
+var v = null != t ? t : {};
+var c = {
+	DEBUG: !1,
+	LIB_VERSION: "0.7.0",
+	LIB_NAME: "browser-common"
+};
+function f(t, i, e, r, s, n, o) {
+	try {
+		var a = t[n](o), l = a.value;
+	} catch (t) {
+		e(t);
+		return;
+	}
+	a.done ? i(l) : Promise.resolve(l).then(r, s);
+}
+function p(t) {
+	return function() {
+		var i = this, e = arguments;
+		return new Promise((function(r, s) {
+			var n = t.apply(i, e);
+			function o(t) {
+				f(n, r, s, o, a, "next", t);
+			}
+			function a(t) {
+				f(n, r, s, o, a, "throw", t);
+			}
+			o(void 0);
+		}));
+	};
+}
+function _() {
+	return _ = Object.assign ? Object.assign.bind() : function(t) {
+		for (var i = 1; arguments.length > i; i++) {
+			var e = arguments[i];
+			for (var r in e) ({}).hasOwnProperty.call(e, r) && (t[r] = e[r]);
+		}
+		return t;
+	}, _.apply(null, arguments);
+}
+function g(t, i) {
+	if (null == t) return {};
+	var e = {};
+	for (var r in t) if ({}.hasOwnProperty.call(t, r)) {
+		if (-1 !== i.indexOf(r)) continue;
+		e[r] = t[r];
+	}
+	return e;
+}
+var m = (t) => {
+	if ("string" != typeof t) return t;
+	try {
+		return JSON.parse(t);
+	} catch (i) {
+		return t;
+	}
+};
+function y(t) {
+	return "string" == typeof t || t;
+}
+function b(t) {
+	return "string" == typeof t ? t : void 0;
+}
+var w = [
+	"$feature_flag",
+	"$feature_flag_response",
+	"$feature_flag_has_experiment",
+	"$feature_flag_id",
+	"$feature_flag_version",
+	"$feature_flag_reason",
+	"$feature_flag_request_id",
 	"$feature_flag_evaluated_at",
 	"$feature_flag_error",
 	"locally_evaluated",
@@ -11104,232 +11707,81 @@ var iu = _({}, zh, qh, Hh, Vh, Wh, Gh, Jh, Kh, Yh, Qh, { conversations: class {
 							kind: "retry-later",
 							error: null !== (e = t.error) && void 0 !== e ? e : /* @__PURE__ */ new Error("metrics request failed with status " + i)
 						});
-					}
-				}
-			}));
-		}));
-	}
-	Gc() {
-		return this._instance.requestRouter.endpointFor("api", "/i/v1/metrics") + "?token=" + encodeURIComponent(this._instance.config.token);
-	}
-} });
-Rl.__defaultExtensionClasses = _({}, iu);
-var eu = function() {
-	c.SDK_DIST_CHANNEL = "npm";
-	var i = fl[xl] = new Rl();
-	return function() {
-		function i() {
-			i.done || (i.done = !0, El = !1, es(fl, (function(t) {
-				t._dom_loaded();
-			})));
-		}
-		null != r && r.addEventListener ? "complete" === r.readyState ? i() : us(r, "DOMContentLoaded", i, { capture: !1 }) : t && Ie.error("Browser doesn't support `document.addEventListener` so PostHog couldn't be initialized");
-	}(), i;
-}();
-//#endregion
-//#region node_modules/.pnpm/nanoid@5.1.6/node_modules/nanoid/url-alphabet/index.js
-var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
-//#endregion
-//#region node_modules/.pnpm/nanoid@5.1.6/node_modules/nanoid/index.browser.js
-var random = (bytes) => crypto.getRandomValues(new Uint8Array(bytes));
-var customRandom = (alphabet, defaultSize, getRandom) => {
-	let mask = (2 << Math.log2(alphabet.length - 1)) - 1;
-	let step = -~(1.6 * mask * defaultSize / alphabet.length);
-	return (size = defaultSize) => {
-		let id = "";
-		while (true) {
-			let bytes = getRandom(step);
-			let j = step | 0;
-			while (j--) {
-				id += alphabet[bytes[j] & mask] || "";
-				if (id.length >= size) return id;
-			}
-		}
-	};
-};
-var customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size | 0, random);
-var nanoid$2 = (size = 21) => {
-	let id = "";
-	let bytes = crypto.getRandomValues(new Uint8Array(size |= 0));
-	while (size--) id += urlAlphabet[bytes[size] & 63];
-	return id;
-};
-//#endregion
-//#region utils/client-id.ts
-/**
-* Client ID management utility
-* Used to generate and persist unique device identifier
-* @internal
-*/
-var CLIENT_ID_STORAGE_KEY = "spavatar_client_id";
-/**
-* Get or create client_id
-* - If exists in localStorage, return existing client_id
-* - If not exists, generate new client_id and store to localStorage
-* @returns client_id string
-* @internal
-*/
-function getOrCreateClientId() {
-	try {
-		const stored = localStorage.getItem(CLIENT_ID_STORAGE_KEY);
-		if (stored) return stored;
-		const clientId = nanoid$2(21);
-		localStorage.setItem(CLIENT_ID_STORAGE_KEY, clientId);
-		return clientId;
-	} catch (error) {
-		return `temp_${nanoid$2(21)}_${Date.now()}`;
-	}
-}
-//#endregion
-//#region utils/conversationId.ts
-/**
-* Conversation ID generation utility
-* 
-* Unified format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
-* Example: 20251027143034_aB3dEf9hIjKl
-* 
-* Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
-* @internal
-*/
-/**
-* Custom character set: only uppercase, lowercase letters and numbers (URL safe, no hyphens)
-* Character set: A-Z, a-z, 0-9 (62 characters)
-*/
-var nanoid$1 = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
-/**
-* Generate unified conversation ID
-* 
-* Format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
-* Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
-* 
-* @returns Conversation ID in format YYYYMMDDHHmmss_nanoid
-* @example
-* generateConversationId() // "20251027143034_aB3dEf9hIjKl"
-* @internal
-*/
-var 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$1()}`;
-}
-//#endregion
-//#region utils/id-manager.ts
-/**
-* ID Manager
-* Unified management of all types of IDs in SDK
-* @internal
-*/
-/** 与 conversation_id 同字符集：URL 安全、无连字符。 */
-var nanoid = customAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", 12);
-var IdManager = class {
-	ids = {
-		clientId: "",
-		sessionId: "",
-		userId: null,
-		appId: null,
-		sessionToken: null,
-		connectionId: null,
-		conversationId: null
-	};
-	constructor() {
-		this.ids.clientId = getOrCreateClientId();
-	}
-	getClientId() {
-		return this.ids.clientId;
-	}
-	setUserId(userId) {
-		this.ids.userId = userId;
-	}
-	getUserId() {
-		return this.ids.userId;
-	}
-	setAppId(appId) {
-		this.ids.appId = appId;
-	}
-	getAppId() {
-		return this.ids.appId;
-	}
-	setSessionToken(token) {
-		this.ids.sessionToken = token;
-	}
-	getSessionToken() {
-		return this.ids.sessionToken;
-	}
-	/**
-	* Generate new connectionId (for WebSocket connection)
-	* @internal
-	*/
-	generateConnectionId() {
-		this.ids.connectionId = generateConversationId();
-		return this.ids.connectionId;
-	}
-	/**
-	* Set connectionId (for connectionId received from server)
-	* @internal
-	*/
-	setConnectionId(connectionId) {
-		this.ids.connectionId = connectionId;
-	}
-	getConnectionId() {
-		return this.ids.connectionId;
-	}
-	clearConnectionId() {
-		this.ids.connectionId = null;
-	}
-	/**
-	* Generate new conversationId (for each conversation)
-	* @internal
-	*/
-	generateNewConversationId() {
-		this.ids.conversationId = generateConversationId();
-		return this.ids.conversationId;
-	}
-	getConversationId() {
-		return this.ids.conversationId;
-	}
-	setConversationId(conversationId) {
-		this.ids.conversationId = conversationId;
-	}
-	clearConversationId() {
-		this.ids.conversationId = null;
-	}
-	/**
-	* Get all IDs (for log reporting)
-	* @internal
-	*/
-	getAllIds() {
-		return { ...this.ids };
-	}
-	/**
-	* Get public log parameters (contains all necessary IDs)
-	* @internal
-	*/
-	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;
+	Gc() {
+		return this._instance.requestRouter.endpointFor("api", "/i/v1/metrics") + "?token=" + encodeURIComponent(this._instance.config.token);
 	}
-	/**
-	* Clear all IDs (for testing or reset)
-	* @internal
-	*/
-	clear() {
-		this.ids.userId = null;
-		this.ids.appId = null;
-		this.ids.sessionToken = null;
-		this.ids.connectionId = null;
-		this.ids.conversationId = null;
+} });
+Rl.__defaultExtensionClasses = _({}, iu);
+var eu = function() {
+	c.SDK_DIST_CHANNEL = "npm";
+	var i = fl[xl] = new Rl();
+	return function() {
+		function i() {
+			i.done || (i.done = !0, El = !1, es(fl, (function(t) {
+				t._dom_loaded();
+			})));
+		}
+		null != r && r.addEventListener ? "complete" === r.readyState ? i() : us(r, "DOMContentLoaded", i, { capture: !1 }) : t && Ie.error("Browser doesn't support `document.addEventListener` so PostHog couldn't be initialized");
+	}(), i;
+}();
+//#endregion
+//#region utils/telemetry-rate-limit.ts
+/**
+* 事件限频（三端同一规则，见 knowledge/error-telemetry-gap-audit.md「限频策略」）。
+*
+* 只给**循环路径**上的错误事件用（每帧 / 每包 / 每 tick）：一台机器卡在某个坏状态时，
+* 同一条错误一秒能刷几十次，既刷爆上报量也淹没别的事件。
+*
+* - key = 事件名 + `stage` / `op` / `path` / `direction` / `backend` 之一（低基数判别字段），
+*   **不含** reason 自由文本——否则每条 reason 都是新 key，限频等于没有
+* - 同一 key 每 session（页面生命周期）首次必发
+* - 之后 60s 内只发一次；被压掉的次数累计进下一条的 `suppressed_count`
+*/
+var WINDOW_MS = 6e4;
+var slots = /* @__PURE__ */ new Map();
+var DISCRIMINATORS = [
+	"stage",
+	"op",
+	"path",
+	"direction",
+	"backend",
+	"code"
+];
+/** @internal */
+function rateLimitKey(event, contents) {
+	for (const k of DISCRIMINATORS) {
+		const v = contents[k];
+		if (v !== void 0 && v !== null && v !== "") return `${event}|${k}=${String(v)}`;
 	}
-};
-var idManager = new IdManager();
+	return event;
+}
+/**
+* 判定这次能不能发。返回 `null` = 压掉；返回数字 = 放行，数字是自上次放行以来被压掉的次数。
+* @internal
+*/
+function admitRateLimited(key, now = Date.now()) {
+	const slot = slots.get(key);
+	if (!slot) {
+		slots.set(key, {
+			lastSent: now,
+			suppressed: 0
+		});
+		return 0;
+	}
+	if (now - slot.lastSent < WINDOW_MS) {
+		slot.suppressed++;
+		return null;
+	}
+	const suppressed = slot.suppressed;
+	slot.lastSent = now;
+	slot.suppressed = 0;
+	return suppressed;
+}
 //#endregion
 //#region config/constants.ts
 var POSTHOG_HOST = "https://i.spatialwalk.ai";
@@ -19863,755 +20315,398 @@ async function replayPersistedEvents() {
 		}
 		if (loggerProvider) loggerProvider.forceFlush().catch(() => {});
 	} catch (error) {
-		logger.warn("[OTel] Failed to load persisted events:", error instanceof Error ? error.message : String(error));
-	}
-}
-/**
-* Cleanup OTel (flush remaining events and shutdown).
-* @internal
-*/
-function cleanupOtel() {
-	if (!isInitialized$2 || !loggerProvider) return;
-	try {
-		loggerProvider.shutdown().catch((error) => {
-			logger.warn("[OTel] Shutdown error:", error instanceof Error ? error.message : String(error));
-		});
-		isInitialized$2 = false;
-		loggerProvider = null;
-		logger.log("[OTel] Cleaned up");
-	} catch (error) {
-		logger.warn("[OTel] Failed to cleanup:", error instanceof Error ? error.message : String(error));
-		isInitialized$2 = false;
-		loggerProvider = null;
-	}
-}
-//#endregion
-//#region utils/posthog-tracker.ts
-/**
-* PostHog Telemetry Tool (Browser Version)
-* 
-* Unified PostHog telemetry reporting, supports custom reporting
-* Uses PostHog JS SDK for event tracking, suitable for browser environments
-* @internal
-*/
-/**
-* 构建时间戳字段：本地时间戳（校准基准+单调流逝）+ 后台时间戳（拿到才带）。
-* @internal
-*/
-function timestampFields(enqueueMono) {
-	const local = enqueueMono === void 0 ? clockSync.localNow() : clockSync.localAt(enqueueMono);
-	const server = enqueueMono === void 0 ? clockSync.serverNow() : clockSync.serverAt(enqueueMono);
-	const fields = { timestamp: local };
-	if (server !== null) fields.server_timestamp = server;
-	return fields;
-}
-/**
-* 客户端环境字段（仅 OTel log 通道补——PostHog 通道由其 SDK 自动附加同类 `$` 属性）。
-* 全部从浏览器 API 现取（与 PostHog 客户端取法一致），不解析 UA/不造设备信息，
-* 浏览器/OS/设备类型交给后端从 user_agent 解析。GeoIP（国家/城市/IP）由后端从 IP 推断，此处不涉及。
-* 每条 log 实时取：url/pathname 随 SPA 路由变，取当前值才准。全程 try/catch 兜底，缺失即省略该字段。
-* @internal
-*/
-function clientContextFields() {
-	const fields = {};
-	try {
-		if (typeof window !== "undefined" && window.location) {
-			const loc = window.location;
-			if (loc.host) fields.host = loc.host;
-			if (loc.hostname) fields.domain = loc.hostname;
-			if (loc.href) fields.url = loc.href;
-			if (loc.pathname) fields.pathname = loc.pathname;
-		}
-		if (typeof document !== "undefined" && document.referrer) fields.referrer = document.referrer;
-		if (typeof navigator !== "undefined") {
-			if (navigator.userAgent) fields.user_agent = navigator.userAgent;
-			if (navigator.language) fields.locale = navigator.language;
-		}
-		if (typeof screen !== "undefined") {
-			if (screen.width) fields.screen_width = screen.width;
-			if (screen.height) fields.screen_height = screen.height;
-		}
-		if (typeof window !== "undefined") {
-			if (window.innerWidth) fields.viewport_width = window.innerWidth;
-			if (window.innerHeight) fields.viewport_height = window.innerHeight;
-		}
-		const tz = Intl?.DateTimeFormat?.().resolvedOptions?.().timeZone;
-		if (tz) fields.timezone = tz;
-	} catch {}
-	return fields;
-}
-var sdkVersion$1 = "1.0.0";
-var isInitialized$1 = false;
-var commonRegion = "";
-var commonDsm = "";
-function isPostHogEnabled() {
-	return !commonRegion.startsWith("cn-");
-}
-var SDK_POSTHOG_INSTANCE_NAME = "spatius-posthog";
-var sdkPosthogInstance = null;
-var eventQueue = [];
-/**
-* Get common fields for PostHog (excluding level)
-* userProperties = 公共字段除了 level 外的所有字段
-* @internal
-*/
-function getCommonFields() {
-	const logContext = idManager.getLogContext();
-	return {
-		platform: "Web",
-		sdk_version: sdkVersion$1,
-		app_id: logContext.app_id || "",
-		user_id: logContext.user_id || "",
-		client_id: logContext.client_id,
-		region: commonRegion,
-		dsm: commonDsm,
-		framework: "",
-		framework_version: ""
-	};
-}
-/**
-* Initialize PostHog with the SDK version.
-* @internal
-*/
-function initializePostHog(version, commonFields) {
-	commonRegion = commonFields.region;
-	commonDsm = commonFields.dsm;
-	if (!isPostHogEnabled()) {
-		logger.log(`[PostHog] Tracking disabled for region=${commonRegion} (data residency)`);
-		return;
-	}
-	const { host, apiKey, disableCompression } = getPostHogConfig();
-	if (!apiKey) {
-		logger.warn("[PostHog] API Key not configured, tracking disabled");
-		return;
-	}
-	if (isInitialized$1) {
-		logger.log("[PostHog] Already initialized, skipping");
-		return;
-	}
-	sdkVersion$1 = version;
-	try {
-		const logContext = idManager.getLogContext();
-		eu.init(apiKey, {
-			api_host: host,
-			person_profiles: "identified_only",
-			capture_pageview: false,
-			capture_pageleave: false,
-			disable_compression: disableCompression,
-			disable_session_recording: true,
-			autocapture: false,
-			capture_performance: false,
-			loaded: (posthogInstance) => {
-				logger.log(`[PostHog] Initialized successfully - host: ${host}, instance: ${SDK_POSTHOG_INSTANCE_NAME}`);
-				isInitialized$1 = true;
-				sdkPosthogInstance = posthogInstance;
-				const userProperties = getCommonFields();
-				if (logContext.user_id) posthogInstance.identify(logContext.user_id, userProperties);
-				else posthogInstance.register(userProperties);
-				posthogInstance.setPersonPropertiesForFlags(userProperties);
-				flushEventQueue();
-				clockSync.onReady(() => flushEventQueue());
-			}
-		}, SDK_POSTHOG_INSTANCE_NAME);
-	} catch (error) {
-		logger.warn("[PostHog] Failed to initialize:", error instanceof Error ? error.message : String(error));
-	}
-}
-/**
-* Get SDK's PostHog instance (if not initialized, try to get it)
-* @internal
-*/
-function getSdkPosthogInstance() {
-	if (sdkPosthogInstance) return sdkPosthogInstance;
-	try {
-		sdkPosthogInstance = eu.getInstance?.(SDK_POSTHOG_INSTANCE_NAME);
-		return sdkPosthogInstance;
-	} catch (error) {
-		return null;
-	}
-}
-/**
-* Get logs feature flag (default: false)
-* Reloads feature flags from server first, then checks if logs_feature_flag is enabled
-* @returns Promise<boolean> - true if feature flag is enabled, false otherwise
-* @internal
-*/
-async function getLogsFeatureFlag() {
-	let instance = getSdkPosthogInstance();
-	if (!instance) {
-		const maxWaitTime = 5e3;
-		const checkInterval = 100;
-		const startTime = Date.now();
-		while (!instance && Date.now() - startTime < maxWaitTime) {
-			await new Promise((resolve) => setTimeout(resolve, checkInterval));
-			instance = getSdkPosthogInstance();
-		}
-	}
-	if (!instance) {
-		logger.log("[PostHog] PostHog not initialized after waiting, logs feature flag disabled (default: false)");
-		return false;
-	}
-	try {
-		const commonFields = getCommonFields();
-		instance.setPersonPropertiesForFlags(commonFields);
-		instance.reloadFeatureFlags();
-		await new Promise((resolve) => {
-			instance.onFeatureFlags((_flags, _variants, { errorsLoading } = {}) => {
-				if (errorsLoading) logger.warn("[PostHog] Error loading feature flags");
-				resolve();
-			});
-		});
-		const isEnabled = instance.isFeatureEnabled("logs_feature_flag") === true;
-		logger.log(`[PostHog] Logs feature flag: ${isEnabled ? "enabled" : "disabled"}`);
-		return isEnabled;
-	} catch (error) {
-		logger.warn("[PostHog] Failed to get logs feature flag:", error instanceof Error ? error.message : String(error));
-		return false;
+		logger.warn("[OTel] Failed to load persisted events:", error instanceof Error ? error.message : String(error));
 	}
 }
 /**
-* Update PostHog person properties for feature flags evaluation
+* Cleanup OTel (flush remaining events and shutdown).
 * @internal
 */
-function updatePostHogPersonPropertiesForFlags() {
-	const instance = getSdkPosthogInstance();
-	if (!instance) return;
-	const commonFields = getCommonFields();
-	instance.setPersonPropertiesForFlags(commonFields);
+function cleanupOtel() {
+	if (!isInitialized$2 || !loggerProvider) return;
+	try {
+		loggerProvider.shutdown().catch((error) => {
+			logger.warn("[OTel] Shutdown error:", error instanceof Error ? error.message : String(error));
+		});
+		isInitialized$2 = false;
+		loggerProvider = null;
+		logger.log("[OTel] Cleaned up");
+	} catch (error) {
+		logger.warn("[OTel] Failed to cleanup:", error instanceof Error ? error.message : String(error));
+		isInitialized$2 = false;
+		loggerProvider = null;
+	}
 }
+//#endregion
+//#region utils/posthog-tracker.ts
 /**
-* Send queued events (called after PostHog initialization completes)
+* PostHog Telemetry Tool (Browser Version)
+* 
+* Unified PostHog telemetry reporting, supports custom reporting
+* Uses PostHog JS SDK for event tracking, suitable for browser environments
 * @internal
 */
-function flushEventQueue() {
-	if (!sdkPosthogInstance || !clockSync.isReady() || eventQueue.length === 0) return;
-	logger.log(`[PostHog] Flushing ${eventQueue.length} queued events`);
-	setTimeout(() => {
-		for (const { event, level, contents, enqueueMono } of eventQueue) try {
-			const properties = {
-				...getCommonFields(),
-				level,
-				service_module: "sdk",
-				...timestampFields(enqueueMono),
-				...resolveMarks(contents)
-			};
-			sdkPosthogInstance.capture(event, properties);
-		} catch (error) {
-			logger.warn(`[PostHog] Failed to flush queued event ${event}:`, error instanceof Error ? error.message : String(error));
-		}
-		eventQueue.length = 0;
-	}, 0);
-}
 /**
-* Report event to PostHog
-* @param event Event name
-* @param level Log level
-* @param contents Event contents
+* 构建时间戳字段：本地时间戳（校准基准+单调流逝）+ 后台时间戳（拿到才带）。
 * @internal
 */
-function trackEvent(event, level = "info", contents = {}) {
-	if (!isPostHogEnabled()) return;
-	const instance = getSdkPosthogInstance();
-	if (!instance || !clockSync.isReady()) {
-		eventQueue.push({
-			event,
-			level,
-			contents,
-			enqueueMono: performance.now()
-		});
-		return;
-	}
-	sdkPosthogInstance = instance;
-	try {
-		const properties = {
-			...getCommonFields(),
-			level,
-			service_module: "sdk",
-			...timestampFields(),
-			...resolveMarks(contents)
-		};
-		sdkPosthogInstance.capture(event, properties);
-	} catch (error) {
-		logger.warn("[PostHog] Failed to track event:", error instanceof Error ? error.message : String(error));
-	}
+function timestampFields(enqueueMono) {
+	const local = enqueueMono === void 0 ? clockSync.localNow() : clockSync.localAt(enqueueMono);
+	const server = enqueueMono === void 0 ? clockSync.serverNow() : clockSync.serverAt(enqueueMono);
+	const fields = { timestamp: local };
+	if (server !== null) fields.server_timestamp = server;
+	return fields;
 }
 /**
-* Cleanup PostHog (flush remaining events)
+* 客户端环境字段（仅 OTel log 通道补——PostHog 通道由其 SDK 自动附加同类 `$` 属性）。
+* 全部从浏览器 API 现取（与 PostHog 客户端取法一致），不解析 UA/不造设备信息，
+* 浏览器/OS/设备类型交给后端从 user_agent 解析。GeoIP（国家/城市/IP）由后端从 IP 推断，此处不涉及。
+* 每条 log 实时取：url/pathname 随 SPA 路由变，取当前值才准。全程 try/catch 兜底，缺失即省略该字段。
 * @internal
 */
-function cleanupPostHog() {
-	if (!isInitialized$1) return;
+function clientContextFields() {
+	const fields = {};
 	try {
-		const instance = getSdkPosthogInstance();
-		if (!instance) {
-			isInitialized$1 = false;
-			return;
+		if (typeof window !== "undefined" && window.location) {
+			const loc = window.location;
+			if (loc.host) fields.host = loc.host;
+			if (loc.hostname) fields.domain = loc.hostname;
+			if (loc.href) fields.url = loc.href;
+			if (loc.pathname) fields.pathname = loc.pathname;
 		}
-		sdkPosthogInstance = instance;
-		if (typeof instance.shutdown === "function") instance.shutdown();
-		else if (typeof instance.flush === "function") instance.flush();
-		isInitialized$1 = false;
-		sdkPosthogInstance = null;
-		logger.log("[PostHog] Cleaned up");
-	} catch (error) {
-		logger.warn("[PostHog] Failed to cleanup:", error instanceof Error ? error.message : String(error));
-		isInitialized$1 = false;
-		sdkPosthogInstance = null;
-	}
-}
-var TELEMETRY_LOG_METHOD = {
-	debug: "log",
-	info: "log",
-	warning: "warn",
-	error: "error"
-};
-/** 组装上报 context（附加 session_token 后缀）并写一条本地 console。两条上报通道共用。 */
-function buildTelemetryContext(event, level, contents) {
-	const sessionToken = idManager.getSessionToken() ?? "";
-	const context = {
-		session_token_suffix: sessionToken ? sessionToken.slice(-8) : "",
-		connection_id: idManager.getConnectionId() ?? "",
-		...clientContextFields(),
-		...contents
-	};
-	const logMethod = TELEMETRY_LOG_METHOD[level] ?? "log";
-	const propsDescription = Object.entries(contents).map(([k, v]) => `${k}=${v}`).join(", ");
-	logger[logMethod](`[Telemetry] ${event} [${propsDescription}]`);
-	return context;
-}
-/** 通过 OTel 上报（独立通道，失败隔离，不影响 PostHog）。 */
-function emitToOtel(event, level, context) {
-	try {
-		trackEventOtel(event, level, context);
-	} catch (error) {
-		logger.warn("[OTel] Dual-send failed:", error instanceof Error ? error.message : String(error));
-	}
+		if (typeof document !== "undefined" && document.referrer) fields.referrer = document.referrer;
+		if (typeof navigator !== "undefined") {
+			if (navigator.userAgent) fields.user_agent = navigator.userAgent;
+			if (navigator.language) fields.locale = navigator.language;
+		}
+		if (typeof screen !== "undefined") {
+			if (screen.width) fields.screen_width = screen.width;
+			if (screen.height) fields.screen_height = screen.height;
+		}
+		if (typeof window !== "undefined") {
+			if (window.innerWidth) fields.viewport_width = window.innerWidth;
+			if (window.innerHeight) fields.viewport_height = window.innerHeight;
+		}
+		const tz = Intl?.DateTimeFormat?.().resolvedOptions?.().timeZone;
+		if (tz) fields.timezone = tz;
+	} catch {}
+	return fields;
 }
-/**
-* 日志上报接口：同时发往 PostHog 与 OTel。
-* 用于 SDK 内部**日志类**事件（失败、状态变更、生命周期等）。
-* 指标类（延迟/帧率/时长/次数等度量）请用 {@link logMetric}——只发 OTel。
-* @param event Event name
-* @param level Log level
-* @param contents Log contents
-* @internal
-*/
-function logEvent(event, level = "info", contents = {}) {
-	const context = buildTelemetryContext(event, level, contents);
-	trackEvent(event, level, context);
-	emitToOtel(event, level, context);
+var sdkVersion$1 = "1.0.0";
+var isInitialized$1 = false;
+var commonRegion = "";
+var commonDsm = "";
+function isPostHogEnabled() {
+	return !commonRegion.startsWith("cn-");
 }
+var SDK_POSTHOG_INSTANCE_NAME = "spatius-posthog";
+var sdkPosthogInstance = null;
+var eventQueue = [];
 /**
-* 指标上报接口：**双发**——OTel Metric 信号（Histogram，供聚合 P95/均值/SLO）
-* + 一份 OTel log（带完整明细，供按 avatar_id 等排查单次）。不发 PostHog。
-*
-* metric 的天然形态是「一个数值 + 一组低基数标签」，故签名为 (name, value, labels, logExtra)：
-* - `value`  被记录到 Histogram（延迟 ms / 帧率 / 时长 / 次数 / 比率等）
-* - `labels` 低基数标签（dsm / resolution / is_fallback / renderer_backend 等），
-*            同时进 metric 的 attributes 和 log。**不要**放高基数字段（会撑爆 metric 基数）。
-* - `logExtra` 只进 log 的明细（avatar_id / conversation_id 等高基数字段）。
-*
-* @param name Metric 名（如 `fetch_avatar_latency`）
-* @param value 被聚合的数值
-* @param labels 低基数标签
-* @param logExtra 仅 log 携带的高基数明细
+* Get common fields for PostHog (excluding level)
+* userProperties = 公共字段除了 level 外的所有字段
 * @internal
 */
-function logMetric(name, value, labels = {}, logExtra = {}) {
-	recordMetric(name, value, labels);
-	emitToOtel(name, "info", buildTelemetryContext(name, "info", {
-		value,
-		...labels,
-		...logExtra
-	}));
-}
-var logSink = class LogSink {
-	static instance = null;
-	db = null;
-	dbName = "avatarkit_logs";
-	storeName = "logs";
-	version = 1;
-	trimThreshold = 5e3;
-	trimBufferSize = 1e3;
-	isFlushing = false;
-	constructor() {}
-	static getInstance() {
-		if (!LogSink.instance) LogSink.instance = new LogSink();
-		return LogSink.instance;
-	}
-	/**
-	* Initialize IndexedDB
-	*/
-	async initialize() {
-		if (this.db) return;
-		return new Promise((resolve, reject) => {
-			const request = indexedDB.open(this.dbName, this.version);
-			request.onerror = () => {
-				reject(/* @__PURE__ */ new Error("Failed to open IndexedDB"));
-			};
-			request.onsuccess = () => {
-				this.db = request.result;
-				resolve();
-			};
-			request.onupgradeneeded = (event) => {
-				const db = event.target.result;
-				if (!db.objectStoreNames.contains(this.storeName)) db.createObjectStore(this.storeName, {
-					keyPath: "id",
-					autoIncrement: true
-				}).createIndex("ts", "ts", { unique: false });
-			};
-		});
-	}
-	/**
-	* Append log entry to IndexedDB
-	*/
-	async append(entry) {
-		if (!this.db) try {
-			await this.initialize();
-		} catch {
-			return;
-		}
-		if (!this.db) return;
-		try {
-			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
-			await new Promise((resolve, reject) => {
-				const request = store.add(entry);
-				request.onsuccess = () => resolve();
-				request.onerror = () => reject(/* @__PURE__ */ new Error("Failed to add log"));
-			});
-			this.getCount().then((count) => {
-				if (count > this.trimThreshold) this.trim().catch(() => {});
-			}).catch(() => {});
-		} catch (error) {}
+function getCommonFields() {
+	const logContext = idManager.getLogContext();
+	return {
+		platform: "Web",
+		sdk_version: sdkVersion$1,
+		app_id: logContext.app_id || "",
+		user_id: logContext.user_id || "",
+		client_id: logContext.client_id,
+		region: commonRegion,
+		dsm: commonDsm,
+		framework: "",
+		framework_version: ""
+	};
+}
+/**
+* Initialize PostHog with the SDK version.
+* @internal
+*/
+function initializePostHog(version, commonFields) {
+	commonRegion = commonFields.region;
+	commonDsm = commonFields.dsm;
+	if (!isPostHogEnabled()) {
+		logger.log(`[PostHog] Tracking disabled for region=${commonRegion} (data residency)`);
+		return;
 	}
-	/**
-	* Get total log count
-	*/
-	async getCount() {
-		if (!this.db) return 0;
-		return new Promise((resolve, reject) => {
-			const request = this.db.transaction([this.storeName], "readonly").objectStore(this.storeName).count();
-			request.onsuccess = () => {
-				resolve(request.result);
-			};
-			request.onerror = () => {
-				reject(/* @__PURE__ */ new Error("Failed to count logs"));
-			};
-		});
+	const { host, apiKey, disableCompression } = getPostHogConfig();
+	if (!apiKey) {
+		logger.warn("[PostHog] API Key not configured, tracking disabled");
+		return;
 	}
-	/**
-	* Trim logs to keep only recent entries
-	*/
-	async trim() {
-		if (!this.db || this.isFlushing) return;
-		try {
-			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
-			const getAllRequest = store.getAll();
-			const entries = await new Promise((resolve, reject) => {
-				getAllRequest.onsuccess = () => {
-					resolve(getAllRequest.result);
-				};
-				getAllRequest.onerror = () => {
-					reject(/* @__PURE__ */ new Error("Failed to get logs"));
-				};
-			});
-			const keepCount = this.trimThreshold - this.trimBufferSize;
-			if (entries.length <= keepCount) return;
-			entries.sort((a, b) => a.ts - b.ts);
-			const toDelete = entries.slice(0, entries.length - keepCount);
-			for (const entry of toDelete) if (entry.id !== void 0) await new Promise((resolve, reject) => {
-				const deleteRequest = store.delete(entry.id);
-				deleteRequest.onsuccess = () => resolve();
-				deleteRequest.onerror = () => reject(/* @__PURE__ */ new Error("Failed to delete log"));
-			});
-		} catch (error) {}
+	if (isInitialized$1) {
+		logger.log("[PostHog] Already initialized, skipping");
+		return;
 	}
-	/**
-	* Flush logs to server
-	*/
-	async flush() {
-		if (!this.db || this.isFlushing) return;
-		this.isFlushing = true;
-		try {
-			const getAllRequest = this.db.transaction([this.storeName], "readonly").objectStore(this.storeName).getAll();
-			const entries = await new Promise((resolve, reject) => {
-				getAllRequest.onsuccess = () => {
-					resolve(getAllRequest.result);
-				};
-				getAllRequest.onerror = () => {
-					reject(/* @__PURE__ */ new Error("Failed to get logs"));
-				};
-			});
-			if (entries.length === 0) {
-				this.isFlushing = false;
-				return;
+	sdkVersion$1 = version;
+	try {
+		const logContext = idManager.getLogContext();
+		eu.init(apiKey, {
+			api_host: host,
+			person_profiles: "identified_only",
+			capture_pageview: false,
+			capture_pageleave: false,
+			disable_compression: disableCompression,
+			disable_session_recording: true,
+			autocapture: false,
+			capture_performance: false,
+			loaded: (posthogInstance) => {
+				logger.log(`[PostHog] Initialized successfully - host: ${host}, instance: ${SDK_POSTHOG_INSTANCE_NAME}`);
+				isInitialized$1 = true;
+				sdkPosthogInstance = posthogInstance;
+				const userProperties = getCommonFields();
+				if (logContext.user_id) posthogInstance.identify(logContext.user_id, userProperties);
+				else posthogInstance.register(userProperties);
+				posthogInstance.setPersonPropertiesForFlags(userProperties);
+				flushEventQueue();
+				clockSync.onReady(() => flushEventQueue());
 			}
-			const requestBody = { logs: entries.map((entry) => ({
-				...entry,
-				extra: {
-					...entry.extra,
-					platform: "Web"
-				}
-			})) };
-			const jsonData = JSON.stringify(requestBody);
-			const gzippedData = await this.gzip(jsonData);
-			const response = await fetch("https://hogtool.spatialwalk.ai/batch-upload-log", {
-				method: "POST",
-				headers: {
-					"Content-Type": "application/json",
-					"Content-Encoding": "gzip"
-				},
-				body: gzippedData,
-				signal: AbortSignal.timeout(15e3)
-			});
-			if (!response.ok) throw new Error(`Failed to upload logs: ${response.status} ${response.statusText}`);
-			await this.clearFirst(entries.length);
-		} catch (error) {
-			console.warn("[LogSink] Failed to flush logs:", error);
-			throw error;
-		} finally {
-			this.isFlushing = false;
-		}
+		}, SDK_POSTHOG_INSTANCE_NAME);
+	} catch (error) {
+		logger.warn("[PostHog] Failed to initialize:", error instanceof Error ? error.message : String(error));
 	}
-	/**
-	* Clear first N log entries
-	*/
-	async clearFirst(count) {
-		if (!this.db || count <= 0) return;
-		try {
-			const store = this.db.transaction([this.storeName], "readwrite").objectStore(this.storeName);
-			const getAllRequest = store.getAll();
-			const entries = await new Promise((resolve, reject) => {
-				getAllRequest.onsuccess = () => {
-					resolve(getAllRequest.result);
-				};
-				getAllRequest.onerror = () => {
-					reject(/* @__PURE__ */ new Error("Failed to get logs"));
-				};
-			});
-			entries.sort((a, b) => a.ts - b.ts);
-			const toDelete = entries.slice(0, count);
-			for (const entry of toDelete) if (entry.id !== void 0) await new Promise((resolve, reject) => {
-				const deleteRequest = store.delete(entry.id);
-				deleteRequest.onsuccess = () => resolve();
-				deleteRequest.onerror = () => reject(/* @__PURE__ */ new Error("Failed to delete log"));
-			});
-		} catch (error) {}
+}
+/**
+* Get SDK's PostHog instance (if not initialized, try to get it)
+* @internal
+*/
+function getSdkPosthogInstance() {
+	if (sdkPosthogInstance) return sdkPosthogInstance;
+	try {
+		sdkPosthogInstance = eu.getInstance?.(SDK_POSTHOG_INSTANCE_NAME);
+		return sdkPosthogInstance;
+	} catch (error) {
+		return null;
 	}
-	/**
-	* Gzip string data
-	*/
-	async gzip(data) {
-		try {
-			const encoded = new TextEncoder().encode(data);
-			const compressedStream = new ReadableStream({ start(controller) {
-				controller.enqueue(encoded);
-				controller.close();
-			} }).pipeThrough(new CompressionStream("gzip"));
-			return await new Response(compressedStream).blob();
-		} catch (error) {
-			console.error("[LogSink] gzip() error:", error);
-			throw error;
+}
+/**
+* Get logs feature flag (default: false)
+* Reloads feature flags from server first, then checks if logs_feature_flag is enabled
+* @returns Promise<boolean> - true if feature flag is enabled, false otherwise
+* @internal
+*/
+async function getLogsFeatureFlag() {
+	let instance = getSdkPosthogInstance();
+	if (!instance) {
+		const maxWaitTime = 5e3;
+		const checkInterval = 100;
+		const startTime = Date.now();
+		while (!instance && Date.now() - startTime < maxWaitTime) {
+			await new Promise((resolve) => setTimeout(resolve, checkInterval));
+			instance = getSdkPosthogInstance();
 		}
 	}
-}.getInstance();
-//#endregion
-//#region utils/log-sanitizer.ts
-var ALGORITHM_REG = new RegExp(`\\b(${[
-	"flame",
-	"keyframe",
-	"keyframes",
-	"splat",
-	"splats",
-	"covariance",
-	"gaussian",
-	"cov6",
-	"packeddata",
-	"sortorder",
-	"sortindex",
-	"avatar_core",
-	"emscripten",
-	"wasm",
-	"blendshape",
-	"expressionparam",
-	"rig"
-].join("|")})\\b`, "gi");
-/** Chinese characters (CJK Unified Ideographs) */
-var CHINESE_REG = /[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/;
-/** Patterns to redact: capture group 1 = key, 2 = value; replace value with *** */
-var SENSITIVE_PATTERNS = [
-	{
-		reg: /\b(token|sessiontoken|accesstoken|apikey|apisecret|secret|password|auth)=([^\s,}\]'"]+)/gi,
-		replacement: "$1=***"
-	},
-	{
-		reg: /\b(conversationid|connectionid|clientid|sessionid)=([^\s,}\]'"]+)/gi,
-		replacement: "$1=***"
-	},
-	{
-		reg: /\b(appid|app_id)=([^\s,}\]'"]+)/gi,
-		replacement: "$1=***"
-	},
-	{
-		reg: /\b(userid|user_id)=([^\s,}\]'"]+)/gi,
-		replacement: "$1=***"
-	},
-	{
-		reg: /(https?:\/\/)[^\s,}\]'"]+/gi,
-		replacement: "$1***"
-	},
-	{
-		reg: /(wss?:\/\/)[^\s,}\]'"]+/gi,
-		replacement: "$1***"
+	if (!instance) {
+		logger.log("[PostHog] PostHog not initialized after waiting, logs feature flag disabled (default: false)");
+		return false;
+	}
+	try {
+		const commonFields = getCommonFields();
+		instance.setPersonPropertiesForFlags(commonFields);
+		instance.reloadFeatureFlags();
+		await new Promise((resolve) => {
+			instance.onFeatureFlags((_flags, _variants, { errorsLoading } = {}) => {
+				if (errorsLoading) logger.warn("[PostHog] Error loading feature flags");
+				resolve();
+			});
+		});
+		const isEnabled = instance.isFeatureEnabled("logs_feature_flag") === true;
+		logger.log(`[PostHog] Logs feature flag: ${isEnabled ? "enabled" : "disabled"}`);
+		return isEnabled;
+	} catch (error) {
+		logger.warn("[PostHog] Failed to get logs feature flag:", error instanceof Error ? error.message : String(error));
+		return false;
 	}
-];
-/**
-* Check if message contains Chinese.
-*/
-function hasChinese(msg) {
-	return CHINESE_REG.test(msg);
-}
-/**
-* Check if message contains algorithm/internal terms.
-*/
-function hasAlgorithmTerms(msg) {
-	return ALGORITHM_REG.test(msg);
 }
 /**
-* Redact sensitive substrings in message.
+* Update PostHog person properties for feature flags evaluation
+* @internal
 */
-function redactSensitive(msg) {
-	let out = msg;
-	for (const { reg, replacement } of SENSITIVE_PATTERNS) out = out.replace(reg, replacement);
-	return out;
+function updatePostHogPersonPropertiesForFlags() {
+	const instance = getSdkPosthogInstance();
+	if (!instance) return;
+	const commonFields = getCommonFields();
+	instance.setPersonPropertiesForFlags(commonFields);
 }
 /**
-* Sanitize a log message for local persistence.
-* - Do not persist if message contains Chinese or algorithm terms.
-* - Otherwise persist, but redact sensitive content first.
+* Send queued events (called after PostHog initialization completes)
+* @internal
 */
-function sanitizeForLocalLog(message) {
-	if (hasChinese(message) || hasAlgorithmTerms(message)) return {
-		shouldPersist: false,
-		sanitized: message
-	};
-	return {
-		shouldPersist: true,
-		sanitized: redactSensitive(message)
-	};
+function flushEventQueue() {
+	if (!sdkPosthogInstance || !clockSync.isReady() || eventQueue.length === 0) return;
+	logger.log(`[PostHog] Flushing ${eventQueue.length} queued events`);
+	setTimeout(() => {
+		for (const { event, level, contents, enqueueMono } of eventQueue) try {
+			const properties = {
+				...getCommonFields(),
+				level,
+				service_module: "sdk",
+				...timestampFields(enqueueMono),
+				...resolveMarks(contents)
+			};
+			sdkPosthogInstance.capture(event, properties);
+		} catch (error) {
+			logger.warn(`[PostHog] Failed to flush queued event ${event}:`, error instanceof Error ? error.message : String(error));
+		}
+		eventQueue.length = 0;
+	}, 0);
 }
-//#endregion
-//#region utils/logger.ts
 /**
-* Logger Utility
-* Environment-aware logger wrapper with local log persistence
-* - Always writes to local log file (IndexedDB) regardless of logLevel
-* - Console output is controlled by logLevel
-* - Errors and warnings are always reported to PostHog (when enabled)
+* **只发 PostHog**，不进 OTel——也就是不进 OpenObserve，看板和告警都查不到。
 *
-* Usage: Replace `console.log()` with `logger.log()`
-*/
-setGlobalLogLevel(LogLevel$1.Warning);
-var baseLogger = useLogger("Web").withErrorProcessor((err) => {
-	captureErrorContext("error", err);
-	return err;
-}).useGlobalConfig();
-logSink.initialize().catch(() => {});
-var currentLogLevel = LogLevel.off;
-/**
-* Write log to local storage.
-* Skips persistence if message contains Chinese, algorithm terms (e.g. Flame, splat), or sensitive content.
-* Otherwise redacts sensitive substrings then persists.
+* 业务事件禁止直接调这个，用 {@link logEvent}（PostHog + OTel 双发）。这个名字
+* 故意起得难看：它以前叫 `trackEvent`，和 `internal-telemetry.ts` 里给 RTC 暴露的
+* OTel 单发 `trackEvent` 同名反向，`render_blank_canvas` 与 `render_init_failed`
+* 先后因此只进了 PostHog、后台零记录。现在唯一的调用点是 `logEvent` 本身，不再导出。
+* @param event Event name
+* @param level Log level
+* @param contents Event contents
+* @internal
 */
-async function writeToLocalLog(message, level, extra = {}) {
-	try {
-		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
-		if (!shouldPersist) return;
-		const version = requireSDK().version;
-		const appId = idManager.getAppId();
-		const userId = idManager.getUserId();
-		await logSink.append({
+function trackPostHogOnly(event, level = "info", contents = {}) {
+	if (!isPostHogEnabled()) return;
+	const instance = getSdkPosthogInstance();
+	if (!instance || !clockSync.isReady()) {
+		eventQueue.push({
+			event,
 			level,
-			ts: Date.now(),
-			msg: sanitized,
-			extra: {
-				...extra,
-				_category: "Web",
-				sdk_version: version || "",
-				app_id: appId || "",
-				user_id: userId || "",
-				platform: "Web",
-				framework: "",
-				framework_version: ""
-			}
+			contents,
+			enqueueMono: performance.now()
 		});
-	} catch {}
+		return;
+	}
+	sdkPosthogInstance = instance;
+	try {
+		const properties = {
+			...getCommonFields(),
+			level,
+			service_module: "sdk",
+			...timestampFields(),
+			...resolveMarks(contents)
+		};
+		sdkPosthogInstance.capture(event, properties);
+	} catch (error) {
+		logger.warn("[PostHog] Failed to track event:", error instanceof Error ? error.message : String(error));
+	}
 }
 /**
-* Format console message with [AvatarKit] prefix
+* Cleanup PostHog (flush remaining events)
+* @internal
 */
-function formatConsoleMessage(message) {
-	return `[AvatarKit] ${message}`;
-}
-var logger = {
-	debug: (message, ...args) => {
-		writeToLocalLog(message, "info", {}).catch(() => {});
-		if (currentLogLevel === LogLevel.all) baseLogger.debug(formatConsoleMessage(message), ...args);
-	},
-	verbose: (message, ...args) => {
-		writeToLocalLog(message, "info", {}).catch(() => {});
-		if (currentLogLevel === LogLevel.all) baseLogger.verbose(formatConsoleMessage(message), ...args);
-	},
-	log: (message, ...args) => {
-		writeToLocalLog(message, "info", {}).catch(() => {});
-		if (currentLogLevel === LogLevel.all) baseLogger.log(formatConsoleMessage(message), ...args);
-	},
-	warn: (message, ...args) => {
-		writeToLocalLog(message, "warn", {}).catch(() => {});
-		if (currentLogLevel === LogLevel.warning || currentLogLevel === LogLevel.all) baseLogger.warn(formatConsoleMessage(message), ...args);
-	},
-	error: (message, ...args) => {
-		const fullMessage = message + (args.length > 0 ? " " + args.map((a) => a instanceof Error ? a.message : typeof a === "string" ? a : JSON.stringify(a)).join(" ") : "");
-		writeToLocalLog(fullMessage, "error", {}).catch(() => {});
-		if (currentLogLevel !== LogLevel.off) baseLogger.error(formatConsoleMessage(fullMessage));
+function cleanupPostHog() {
+	if (!isInitialized$1) return;
+	try {
+		const instance = getSdkPosthogInstance();
+		if (!instance) {
+			isInitialized$1 = false;
+			return;
+		}
+		sdkPosthogInstance = instance;
+		if (typeof instance.shutdown === "function") instance.shutdown();
+		else if (typeof instance.flush === "function") instance.flush();
+		isInitialized$1 = false;
+		sdkPosthogInstance = null;
+		logger.log("[PostHog] Cleaned up");
+	} catch (error) {
+		logger.warn("[PostHog] Failed to cleanup:", error instanceof Error ? error.message : String(error));
+		isInitialized$1 = false;
+		sdkPosthogInstance = null;
 	}
+}
+var TELEMETRY_LOG_METHOD = {
+	debug: "log",
+	info: "log",
+	warning: "warn",
+	error: "error"
 };
+/** 组装上报 context（附加 session_token 后缀）并写一条本地 console。两条上报通道共用。 */
+function buildTelemetryContext(event, level, contents) {
+	const sessionToken = idManager.getSessionToken() ?? "";
+	const context = {
+		session_token_suffix: sessionToken ? sessionToken.slice(-8) : "",
+		connection_id: idManager.getConnectionId() ?? "",
+		...clientContextFields(),
+		...contents
+	};
+	const logMethod = TELEMETRY_LOG_METHOD[level] ?? "log";
+	const propsDescription = Object.entries(contents).map(([k, v]) => `${k}=${v}`).join(", ");
+	logger[logMethod](`[Telemetry] ${event} [${propsDescription}]`);
+	return context;
+}
+/** 通过 OTel 上报（独立通道，失败隔离，不影响 PostHog）。 */
+function emitToOtel(event, level, context) {
+	try {
+		trackEventOtel(event, level, context);
+	} catch (error) {
+		logger.warn("[OTel] Dual-send failed:", error instanceof Error ? error.message : String(error));
+	}
+}
 /**
-* Set SDK log level
-* Note: Local log writing is always enabled regardless of logLevel
-* @param level SDK's LogLevel enum value
+* 日志上报接口：同时发往 PostHog 与 OTel。
+* 用于 SDK 内部**日志类**事件（失败、状态变更、生命周期等）。
+* 指标类（延迟/帧率/时长/次数等度量）请用 {@link logMetric}——只发 OTel。
+* @param event Event name
+* @param level Log level
+* @param contents Log contents
 * @internal
 */
-function setLogLevel(level) {
-	currentLogLevel = level;
-	switch (level) {
-		case LogLevel.off:
-			setGlobalLogLevel(LogLevel$1.Error);
-			break;
-		case LogLevel.error:
-			setGlobalLogLevel(LogLevel$1.Error);
-			break;
-		case LogLevel.warning:
-			setGlobalLogLevel(LogLevel$1.Warning);
-			break;
-		case LogLevel.all:
-			setGlobalLogLevel(LogLevel$1.Debug);
-			break;
-		default:
-			setGlobalLogLevel(LogLevel$1.Warning);
-			break;
+function logEvent(event, level = "info", contents = {}, opts = {}) {
+	if (opts.rateLimit) {
+		const suppressed = admitRateLimited(rateLimitKey(event, contents));
+		if (suppressed === null) return;
+		if (suppressed > 0) contents = {
+			...contents,
+			suppressed_count: suppressed
+		};
 	}
+	const context = buildTelemetryContext(event, level, contents);
+	trackPostHogOnly(event, level, context);
+	emitToOtel(event, level, context);
+}
+/**
+* 指标上报：**只发** OTel Metric 信号（Histogram，供聚合 P95/均值/SLO）。
+* 不发 PostHog，也不再附带一条 log。
+*
+* 曾经每条 metric 都双发一条同名 log。那条 log 里 95% 的字节是每条都重复的
+* resource 字段（一条约 1KB，有效载荷只有事件名 + value 约 50 字节），而数值本身
+* 已经在 metric 信号里，聚合查询走的也是 metric——log 那一路纯属冗余。一轮播放
+* 12 条 metric 就多出 12KB 重复数据。
+*
+* **需要高基数明细（avatar_id / conversation_id / trace_id 等）时，在调用点自己
+* 再发一条 {@link logMetricDetail}**——显式一行，比让每条 metric 都默认背一条 log 便宜得多。
+*
+* - `value`  被记录到 Histogram（延迟 ms / 帧率 / 时长 / 次数 / 比率等）
+* - `labels` 低基数标签（dsm / resolution / is_fallback / renderer_backend 等）。
+*            **不要**放高基数字段，会撑爆 metric 基数。
+*
+* @param name Metric 名（如 `fetch_avatar_latency`）
+* @param value 被聚合的数值
+* @param labels 低基数标签
+* @internal
+*/
+function logMetric(name, value, labels = {}) {
+	recordMetric(name, value, labels);
 }
 /**
-* Capture error context for PostHog
+* 一条 metric 的高基数明细，作为独立 log 发出（**只走 OTel，不发 PostHog**）。
+*
+* 事件名与对应 metric 同名——看板按名查；`props` 里放同一份低基数 labels +
+* 高基数明细，与 {@link logMetric} 曾经自带的那条记录一致。
+*
+* 只在真的有 metric 装不下的字段（avatar_id / conversation_id / trace_id /
+* description 等）时才调；没有明细就别发，那种 log 是 metric 的逐字重复。
+*
+* 与 android `SPLogger.logMetricDetail` / iOS `logMetricDetail` 同形。
+* @internal
 */
-function captureErrorContext(level, error) {
-	trackEvent("logger_error", level, {
-		error: error instanceof Error ? error.message : String(error),
-		timestamp: Date.now(),
-		environment: "library",
-		user_agent: typeof navigator !== "undefined" ? navigator.userAgent : ""
-	});
+function logMetricDetail(name, value, props = {}) {
+	emitToOtel(name, "info", buildTelemetryContext(name, "info", {
+		value,
+		...props
+	}));
 }
 //#endregion
 //#region node_modules/.pnpm/@bufbuild+protobuf@2.10.1/node_modules/@bufbuild/protobuf/dist/esm/wire/varint.js
@@ -24593,4 +24688,4 @@ function cleanupOtelTrace() {
 	}
 }
 //#endregion
-export { DEFAULT_REGION as $, monoTimestamp as A, resolveSdkVersion as B, logMetric as C, initializeOtel as D, cleanupOtel as E, cleanupOtelMetrics as F, idManager as G, OTEL_LOGS_ENDPOINT as H, initializeOtelMetrics as I, AvatarError as J, generateTraceId as K, recordHttpClientDuration as L, clockSync as M, fetchBootstrap as N, trackEventOtel as O, hostOf as P, DEFAULT_OPUS_BITRATE as Q, recordMetric as R, logEvent as S, updatePostHogPersonPropertiesForFlags as T, OTEL_STREAM_NAME as U, setSdkIdentity as V, isDebugMode as W, ConnectionState as X, AvatarState as Y, ConversationState as Z, logSink as _, startLoadTrace as a, LogLevel as at, getLogsFeatureFlag as b, AudioFormat as c, TransitionType as ct, MessageType as d, DEFAULT_REGION_REQUEST as et, TransportCompression as f, setLogLevel as g, logger as h, startInitTrace as i, LoadProgress as it, resolveMarks as j, monoMarkFrom as k, EgressType as l, requireSDK as lt, BinaryWriter as m, initializeOtelTrace as n, ErrorCode as nt, startPlaybackTrace as o, RENDER_QUALITY_PARAMS as ot, BinaryReader as p, AnimationType as q, startConnectTrace as r, FrameStarvationMode as rt, buildTraceparent as s, RenderQuality as st, cleanupOtelTrace as t, DrivingServiceMode as tt, Message as u, setSDKRef as ut, cleanupPostHog as v, trackEvent as w, initializePostHog as x, clientContextFields as y, getSdkPackage as z };
+export { DEFAULT_REGION as $, fetchBootstrap as A, OTEL_STREAM_NAME as B, cleanupOtel as C, monoTimestamp as D, monoMarkFrom as E, recordMetric as F, generateTraceId as G, logger as H, getSdkPackage as I, AvatarError as J, logSink as K, resolveSdkVersion as L, cleanupOtelMetrics as M, initializeOtelMetrics as N, resolveMarks as O, recordHttpClientDuration as P, DEFAULT_OPUS_BITRATE as Q, setSdkIdentity as R, updatePostHogPersonPropertiesForFlags as S, trackEventOtel as T, setLogLevel as U, isDebugMode as V, idManager as W, ConnectionState as X, AvatarState as Y, ConversationState as Z, getLogsFeatureFlag as _, startLoadTrace as a, LogLevel as at, logMetric as b, AudioFormat as c, TransitionType as ct, MessageType as d, __commonJSMin as dt, DEFAULT_REGION_REQUEST as et, TransportCompression as f, __toESM as ft, clientContextFields as g, cleanupPostHog as h, startInitTrace as i, LoadProgress as it, hostOf as j, clockSync as k, EgressType as l, requireSDK as lt, BinaryWriter as m, initializeOtelTrace as n, ErrorCode as nt, startPlaybackTrace as o, RENDER_QUALITY_PARAMS as ot, BinaryReader as p, AnimationType as q, startConnectTrace as r, FrameStarvationMode as rt, buildTraceparent as s, RenderQuality as st, cleanupOtelTrace as t, DrivingServiceMode as tt, Message as u, setSDKRef as ut, initializePostHog as v, initializeOtel as w, logMetricDetail as x, logEvent as y, OTEL_LOGS_ENDPOINT as z };