@spatius/avatarkit 1.3.1-beta.4 → 1.3.1-beta.6

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.1-beta.6] - 2026-08-01
+
+### Changed
+- Internal telemetry changes only; no changes to the public API or runtime behavior.
+
+## [1.3.1-beta.5] - 2026-07-31
+
+### Changed
+- Internal playback and telemetry changes only; no changes to the public API or runtime behavior.
+
 ## [1.3.1-beta.4] - 2026-07-30
 
 ### Added

package/dist/{AvatarDownloader-C2JJVqKm.js → AvatarDownloader-Dfi7wtgQ.js}

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as AvatarSDK } from "./AvatarSDK-CuejGi0J.js";
-import { Et as ErrorCode, c as logEvent, gt as generateTraceId, l as logMetric, t as logger, vt as AvatarError, y as recordHttpClientDuration } from "./logger-C3fw-NWP.js";
-import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-PtNzUHiL.js";
-import { t as PwaCacheManager } from "./pwa-cache-manager-D3nj4sd5.js";
+import { t as AvatarSDK } from "./AvatarSDK-CnZqa_X4.js";
+import { Et as ErrorCode, c as logEvent, gt as generateTraceId, l as logMetric, t as logger, vt as AvatarError, y as recordHttpClientDuration } from "./logger-fAU8oahT.js";
+import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-CqKOrHrY.js";
+import { t as PwaCacheManager } from "./pwa-cache-manager-CwXaM3xR.js";
 //#region core/AvatarDownloader.ts
 var AvatarDownloader_exports = /* @__PURE__ */ __exportAll({ AvatarDownloader: () => AvatarDownloader });
 /**

package/dist/{AvatarSDK-CuejGi0J.js → AvatarSDK-CnZqa_X4.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { $ as TraceFlags, A as ExportResultCode, B as ATTR_EXCEPTION_TYPE, C as createInstrumentationScope, D as defaultResource, E as OTLPExporterBase, F as isTimeInputHrTime, G as isTracingSuppressed, H as getNumberFromEnv, I as millisToHrTime, J as diag$1, K as suppressTracing, L as otperformance, M as hrTime, N as hrTimeDuration, O as resourceFromAttributes, P as isTimeInput, Q as INVALID_SPAN_CONTEXT, R as ATTR_EXCEPTION_MESSAGE, S as JSON_ENCODER, T as toAttributes, Tt as DrivingServiceMode, U as getStringFromEnv, V as ATTR_SERVICE_NAME, W as globalErrorHandler, X as isSpanContextValid, Y as context, Z as isValidTraceId, _ as cleanupOtelMetrics, a as clientContextFields, at as getGlobal, c as logEvent, ct as OTEL_LOGS_ENDPOINT, d as cleanupOtel, dt as OTEL_TRACES_ENDPOINT, et as ContextAPI, f as initializeOtel, ft as OTEL_TRACES_STREAM_NAME, g as fetchBootstrap, h as clockSync, ht as idManager, i as cleanupPostHog, it as DiagAPI, j as addHrTimes, k as BindOnceFuture, kt as LogLevel, lt as OTEL_PASSWORD, n as setLogLevel, nt as ROOT_CONTEXT, o as getLogsFeatureFlag, ot as registerGlobal, pt as OTEL_USERNAME, q as trace, r as logSink, rt as createContextKey, s as initializePostHog, st as unregisterGlobal, t as logger, tt as createNoopMeter, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_STREAM_NAME, v as initializeOtelMetrics, w as createResource, x as createLegacyOtlpBrowserExportDelegate, z as ATTR_EXCEPTION_STACKTRACE } from "./logger-C3fw-NWP.js";
+import { $ as TraceFlags, A as ExportResultCode, B as ATTR_EXCEPTION_TYPE, C as createInstrumentationScope, D as defaultResource, E as OTLPExporterBase, F as isTimeInputHrTime, G as isTracingSuppressed, H as getNumberFromEnv, I as millisToHrTime, J as diag$1, K as suppressTracing, L as otperformance, M as hrTime, N as hrTimeDuration, O as resourceFromAttributes, P as isTimeInput, Q as INVALID_SPAN_CONTEXT, R as ATTR_EXCEPTION_MESSAGE, S as JSON_ENCODER, T as toAttributes, Tt as DrivingServiceMode, U as getStringFromEnv, V as ATTR_SERVICE_NAME, W as globalErrorHandler, X as isSpanContextValid, Y as context, Z as isValidTraceId, _ as cleanupOtelMetrics, a as clientContextFields, at as getGlobal, c as logEvent, ct as OTEL_LOGS_ENDPOINT, d as cleanupOtel, dt as OTEL_TRACES_ENDPOINT, et as ContextAPI, f as initializeOtel, ft as OTEL_TRACES_STREAM_NAME, g as fetchBootstrap, h as clockSync, ht as idManager, i as cleanupPostHog, it as DiagAPI, j as addHrTimes, k as BindOnceFuture, kt as LogLevel, lt as OTEL_PASSWORD, n as setLogLevel, nt as ROOT_CONTEXT, o as getLogsFeatureFlag, ot as registerGlobal, pt as OTEL_USERNAME, q as trace, r as logSink, rt as createContextKey, s as initializePostHog, st as unregisterGlobal, t as logger, tt as createNoopMeter, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_STREAM_NAME, v as initializeOtelMetrics, w as createResource, x as createLegacyOtlpBrowserExportDelegate, z as ATTR_EXCEPTION_STACKTRACE } from "./logger-fAU8oahT.js";
 //#region node_modules/.pnpm/@bufbuild+protobuf@2.10.1/node_modules/@bufbuild/protobuf/dist/esm/wire/varint.js
 /**
 * Read a 64 bit varint as two JS numbers.
@@ -4772,7 +4772,8 @@ function initializeOtelTrace(version, resourceAttrs) {
 				"sdk.package": "spatius-web-sdk",
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
-				"dsm": resourceAttrs.dsm
+				"dsm": resourceAttrs.dsm,
+				...clientContextFields()
 			}),
 			spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter({
 				url: OTEL_TRACES_ENDPOINT,
@@ -6320,7 +6321,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1-beta.4";
+	static _version = "1.3.1-beta.6";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -6486,7 +6487,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-C2JJVqKm.js").then((n) => n.n);
+			const { AvatarDownloader } = await import("./AvatarDownloader-Dfi7wtgQ.js").then((n) => n.n);
 			const templateResources = await new AvatarDownloader().loadUnifiedTemplate();
 			if (await this._avatarCore.loadTemplateResourcesFromBuffers(templateResources)) logger.log("[AvatarSDK] Template resources initialized successfully");
 			else logger.log("[AvatarSDK] Template resources already initialized, skipping...");

package/dist/{OpusCodec-Bv4kzdt8.js → OpusCodec-D9DcUV65.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll, r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-C3fw-NWP.js";
+import { t as logger } from "./logger-fAU8oahT.js";
 /** Opus granule positions are always in 48 kHz samples, regardless of input rate. */
 var OPUS_GRANULE_RATE = 48e3;
 /**

package/dist/{OpusDecoderProxy-BTWRku-I.js → OpusDecoderProxy-Ar_dFXRB.js}

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-C3fw-NWP.js";
+import { t as logger } from "./logger-fAU8oahT.js";
 //#region audio/OpusDecoderProxy.ts
 var OpusDecoderProxy = class OpusDecoderProxy {
 	worker = null;
@@ -21,7 +21,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 		} catch (err) {
 			logger.warn("[Opus][DecoderProxy] Worker unavailable, falling back to main-thread decode:", err instanceof Error ? err.message : String(err));
 		}
-		const { OggOpusDecoder } = await import("./OpusCodec-Bv4kzdt8.js").then((n) => n.n);
+		const { OggOpusDecoder } = await import("./OpusCodec-D9DcUV65.js").then((n) => n.n);
 		proxy.fallbackDecoder = new OggOpusDecoder();
 		proxy.backend = "main-thread";
 		return proxy;
@@ -32,7 +32,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"/assets/OpusDecoderWorker.worker-Bd4svkEs.js",
+					"/assets/OpusDecoderWorker.worker-B7R93nev.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{OpusEncoderProxy-_AWpY7N6.js → OpusEncoderProxy-9YIZ7nIt.js}

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-C3fw-NWP.js";
+import { t as logger } from "./logger-fAU8oahT.js";
 //#region audio/OpusEncoderProxy.ts
 var OpusEncoderProxy = class OpusEncoderProxy {
 	worker = null;
@@ -26,7 +26,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 		} catch (err) {
 			logger.warn("[Opus][Proxy] Worker unavailable, falling back to main-thread encode:", err instanceof Error ? err.message : String(err));
 		}
-		const { OggOpusEncoder } = await import("./OpusCodec-Bv4kzdt8.js").then((n) => n.n);
+		const { OggOpusEncoder } = await import("./OpusCodec-D9DcUV65.js").then((n) => n.n);
 		proxy.fallbackEncoder = new OggOpusEncoder(sampleRate, bitrate);
 		proxy.backend = "main-thread";
 		return proxy;
@@ -37,7 +37,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"/assets/OpusEncoderWorker.worker-BdxYhZZ9.js",
+					"/assets/OpusEncoderWorker.worker-BYWIV5xu.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{StreamingAudioPlayer-DmotFnXu.js → StreamingAudioPlayer-D4q7c1U0.js}

@@ -1,5 +1,5 @@
-import { c as logEvent, t as logger } from "./logger-C3fw-NWP.js";
-import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-PtNzUHiL.js";
+import { c as logEvent, t as logger } from "./logger-fAU8oahT.js";
+import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-CqKOrHrY.js";
 //#region audio/StreamingAudioPlayer.ts
 /**
 * Streaming Audio Player

package/dist/assets/{AvatarDownloader-C-CiIH1p.js → AvatarDownloader-D5GePpJ2.js}

@@ -1,5 +1,5 @@
-import { _ as recordHttpClientDuration, c as logEvent, dt as isDebugMode, l as logMetric, mt as AvatarError, pt as generateTraceId, t as logger, vt as ErrorCode } from "./logger-B-X9jUON.js";
-import { t as AvatarSDK } from "./AvatarSDK-RVj90oMR.js";
+import { _ as recordHttpClientDuration, c as logEvent, dt as isDebugMode, l as logMetric, mt as AvatarError, pt as generateTraceId, t as logger, vt as ErrorCode } from "./logger-D8rDVim7.js";
+import { t as AvatarSDK } from "./AvatarSDK-DR8dNylh.js";
 //#region config/app-config.ts
 const GLOBAL_FLAME_CDN_BASE = "https://cdn.spatialwalk.cloud/public";
 const CN_FLAME_CDN_BASE = "https://cdn.spatialwalk.top/public";

package/dist/assets/{AvatarSDK-RVj90oMR.js → AvatarSDK-DR8dNylh.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { $ as ROOT_CONTEXT, A as hrTimeDuration, B as getStringFromEnv, C as OTLPExporterBase, D as ExportResultCode, E as BindOnceFuture, F as ATTR_EXCEPTION_MESSAGE, G as diag$1, H as isTracingSuppressed, I as ATTR_EXCEPTION_STACKTRACE, J as isValidTraceId, K as context, L as ATTR_EXCEPTION_TYPE, M as isTimeInputHrTime, N as millisToHrTime, O as addHrTimes, P as otperformance, Q as createNoopMeter, R as ATTR_SERVICE_NAME, S as toAttributes, T as resourceFromAttributes, U as suppressTracing, V as globalErrorHandler, W as trace, X as TraceFlags, Y as INVALID_SPAN_CONTEXT, Z as ContextAPI, _t as DrivingServiceMode, a as clientContextFields, at as OTEL_LOGS_ENDPOINT, b as createInstrumentationScope, c as logEvent, ct as OTEL_TRACES_ENDPOINT, d as cleanupOtel, et as createContextKey, f as initializeOtel, ft as idManager, g as initializeOtelMetrics, h as cleanupOtelMetrics, i as cleanupPostHog, it as unregisterGlobal, j as isTimeInput, k as hrTime, lt as OTEL_TRACES_STREAM_NAME, m as fetchBootstrap, n as setLogLevel, nt as getGlobal, o as getLogsFeatureFlag, ot as OTEL_PASSWORD, p as clockSync, q as isSpanContextValid, r as logSink, rt as registerGlobal, s as initializePostHog, st as OTEL_STREAM_NAME, t as logger, tt as DiagAPI, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_USERNAME, v as createLegacyOtlpBrowserExportDelegate, w as defaultResource, x as createResource, y as JSON_ENCODER, yt as LogLevel, z as getNumberFromEnv } from "./logger-B-X9jUON.js";
+import { $ as ROOT_CONTEXT, A as hrTimeDuration, B as getStringFromEnv, C as OTLPExporterBase, D as ExportResultCode, E as BindOnceFuture, F as ATTR_EXCEPTION_MESSAGE, G as diag$1, H as isTracingSuppressed, I as ATTR_EXCEPTION_STACKTRACE, J as isValidTraceId, K as context, L as ATTR_EXCEPTION_TYPE, M as isTimeInputHrTime, N as millisToHrTime, O as addHrTimes, P as otperformance, Q as createNoopMeter, R as ATTR_SERVICE_NAME, S as toAttributes, T as resourceFromAttributes, U as suppressTracing, V as globalErrorHandler, W as trace, X as TraceFlags, Y as INVALID_SPAN_CONTEXT, Z as ContextAPI, _t as DrivingServiceMode, a as clientContextFields, at as OTEL_LOGS_ENDPOINT, b as createInstrumentationScope, c as logEvent, ct as OTEL_TRACES_ENDPOINT, d as cleanupOtel, et as createContextKey, f as initializeOtel, ft as idManager, g as initializeOtelMetrics, h as cleanupOtelMetrics, i as cleanupPostHog, it as unregisterGlobal, j as isTimeInput, k as hrTime, lt as OTEL_TRACES_STREAM_NAME, m as fetchBootstrap, n as setLogLevel, nt as getGlobal, o as getLogsFeatureFlag, ot as OTEL_PASSWORD, p as clockSync, q as isSpanContextValid, r as logSink, rt as registerGlobal, s as initializePostHog, st as OTEL_STREAM_NAME, t as logger, tt as DiagAPI, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_USERNAME, v as createLegacyOtlpBrowserExportDelegate, w as defaultResource, x as createResource, y as JSON_ENCODER, yt as LogLevel, z as getNumberFromEnv } from "./logger-D8rDVim7.js";
 //#region node_modules/.pnpm/@opentelemetry+api@1.9.1/node_modules/@opentelemetry/api/build/esm/baggage/internal/baggage-impl.js
 var BaggageImpl = class BaggageImpl {
 	constructor(entries) {
@@ -2344,7 +2344,8 @@ function initializeOtelTrace(version, resourceAttrs) {
 				"sdk.package": "spatius-web-sdk",
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
-				"dsm": resourceAttrs.dsm
+				"dsm": resourceAttrs.dsm,
+				...clientContextFields()
 			}),
 			spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter({
 				url: OTEL_TRACES_ENDPOINT,
@@ -6108,7 +6109,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1-beta.4";
+	static _version = "1.3.1-beta.6";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -6274,7 +6275,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-C-CiIH1p.js");
+			const { AvatarDownloader } = await import("./AvatarDownloader-D5GePpJ2.js");
 			const templateResources = await new AvatarDownloader().loadUnifiedTemplate();
 			if (await this._avatarCore.loadTemplateResourcesFromBuffers(templateResources)) logger.log("[AvatarSDK] Template resources initialized successfully");
 			else logger.log("[AvatarSDK] Template resources already initialized, skipping...");

package/dist/assets/{OpusDecoderWorker.worker-Bd4svkEs.js → OpusDecoderWorker.worker-B7R93nev.js}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-B-X9jUON.js";
+import { t as logger } from "./logger-D8rDVim7.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{OpusEncoderWorker.worker-BdxYhZZ9.js → OpusEncoderWorker.worker-BYWIV5xu.js}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-B-X9jUON.js";
+import { t as logger } from "./logger-D8rDVim7.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

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

@@ -13549,6 +13549,165 @@ const HTTP_NETWORK_BUCKETS_MS = [
 	4e3,
 	5e3
 ];
+/**
+* RTC playback 指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
+* 帧率只可能落在 0~25，缺帧数和卡顿次数几乎全部挤在第一个桶里，分位数因此毫无意义。
+* 桶按各指标的实际值域给：
+*
+* - 帧率：每帧一个桶。25fps 与 21fps 的观感差别正是要看的，5 档分级会把两者归成一类。
+* - 帧数：正常轮次对应播放时长桶、没上屏的帧对应卡顿时长桶，都按帧间隔换算。
+* - 卡顿次数：数的是次数不是帧，自成一组。
+* - 百分比：每 5% 一档，0~100。
+* - 时长：分两组——整轮播放是秒级，单次卡顿是一帧起步的毫秒级。
+*
+* 这些 metric 由 @spatius/avatarkit-rtc 发出（meter 名 spatius-avatarkit-rtc），
+* 但 view 只能配在创建 MeterProvider 的这一侧，所以桶定义留在这里。
+*/
+const RTC_FPS_BUCKETS = [
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	7,
+	8,
+	9,
+	10,
+	11,
+	12,
+	13,
+	14,
+	15,
+	16,
+	17,
+	18,
+	19,
+	20,
+	21,
+	22,
+	23,
+	24
+];
+/**
+* 一轮播出的帧数。档位是播放时长桶除以帧间隔（40ms），和时长视角一一对应：
+* 「播了 10s」与「播了 250 帧」落在同一档。
+*/
+const RTC_FRAME_COUNT_BUCKETS = [
+	0,
+	50,
+	125,
+	250,
+	375,
+	500,
+	750,
+	1500
+];
+/**
+* 没能上屏的帧数（丢失/跳过/丢弃/过渡缺帧）：与正常帧数差一个数量级，
+* 共用一组桶会让它们全挤在低位。档位是卡顿时长桶除以帧间隔（40ms），
+* 于是「卡了 320ms」和「丢了 8 帧」落在同一档，两个视角能直接对上。
+*/
+const RTC_LOST_FRAME_BUCKETS = [
+	0,
+	1,
+	2,
+	4,
+	8,
+	16,
+	32,
+	64,
+	128,
+	256
+];
+/**
+* 一轮里卡顿发生的次数。数的是次数不是帧，上面那套按帧间隔换算的档位对它没有意义。
+* 低位逐个分档、高位翻倍：一轮几次和一轮几十次是两种情况，都要看得出来。
+* 实测慢网络下一轮 35 次，因此高位必须留到三位数。
+*/
+const RTC_STALL_COUNT_BUCKETS = [
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	10,
+	20,
+	40,
+	80,
+	160,
+	320
+];
+const RTC_PERCENT_BUCKETS = [
+	0,
+	5,
+	10,
+	15,
+	20,
+	25,
+	30,
+	35,
+	40,
+	45,
+	50,
+	55,
+	60,
+	65,
+	70,
+	75,
+	80,
+	85,
+	90,
+	95,
+	100
+];
+/** 一轮播放的时长，秒级量级。 */
+const RTC_PLAYBACK_DURATION_BUCKETS_MS = [
+	0,
+	2e3,
+	5e3,
+	1e4,
+	15e3,
+	2e4,
+	3e4,
+	6e4
+];
+/**
+* 卡顿时长：一帧（40ms）起步逐档翻倍到 10240ms。用播放时长那组秒级的桶，
+* 绝大多数卡顿会挤进第一格。
+*/
+const RTC_STALL_DURATION_BUCKETS_MS = [
+	0,
+	40,
+	80,
+	160,
+	320,
+	640,
+	1280,
+	2560,
+	5120,
+	10240
+];
+/** metric 名 → 桶，供下面的 views 展开。 */
+const RTC_BUCKET_PROFILES = [
+	["rtc_playback_avg_fps", RTC_FPS_BUCKETS],
+	["rtc_playback_frame_count", RTC_FRAME_COUNT_BUCKETS],
+	["rtc_playback_skipped_frames", RTC_LOST_FRAME_BUCKETS],
+	["rtc_playback_tail_discarded", RTC_LOST_FRAME_BUCKETS],
+	["rtc_playback_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["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_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]
+];
 const METRIC_EXPORT_INTERVAL_MS = 1e4;
 let sdkVersion$2 = "1.0.0";
 let isInitialized$2 = false;
@@ -13594,7 +13753,13 @@ function initializeOtelMetrics(version, resourceAttrs) {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
 					options: { boundaries: HTTP_NETWORK_BUCKETS_MS }
 				}
-			}]
+			}, ...RTC_BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
+				instrumentName,
+				aggregation: {
+					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
+					options: { boundaries: [...boundaries] }
+				}
+			}))]
 		});
 		metrics.setGlobalMeterProvider(meterProvider);
 		isInitialized$2 = true;
@@ -14350,7 +14515,7 @@ function clientContextFields() {
 		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.language = navigator.language;
+			if (navigator.language) fields.locale = navigator.language;
 		}
 		if (typeof screen !== "undefined") {
 			if (screen.width) fields.screen_width = screen.width;
@@ -14950,7 +15115,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-RVj90oMR.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-DR8dNylh.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();

package/dist/{error-utils-PtNzUHiL.js → error-utils-CqKOrHrY.js}

@@ -1,4 +1,4 @@
-import { mt as isDebugMode } from "./logger-C3fw-NWP.js";
+import { mt as isDebugMode } from "./logger-fAU8oahT.js";
 //#region config/app-config.ts
 var GLOBAL_FLAME_CDN_BASE = "https://cdn.spatialwalk.cloud/public";
 var CN_FLAME_CDN_BASE = "https://cdn.spatialwalk.top/public";

package/dist/index.js

@@ -1,8 +1,8 @@
-import { a as avatarViewRegistry, c as Message, d as BinaryReader, f as BinaryWriter, i as buildTraceparent, l as MessageType, o as AudioFormat, r as startPlaybackTrace, s as EgressType, t as AvatarSDK, u as TransportCompression } from "./AvatarSDK-CuejGi0J.js";
-import { At as RENDER_QUALITY_PARAMS, Ct as DEFAULT_REGION, Dt as FrameStarvationMode, Et as ErrorCode, Mt as TransitionType, Ot as LoadProgress, St as DEFAULT_OPUS_BITRATE, Tt as DrivingServiceMode, _t as AnimationType, b as recordMetric, bt as ConnectionState, c as logEvent, h as clockSync, ht as idManager, jt as RenderQuality, kt as LogLevel, l as logMetric, m as resolveMarks, p as monoTimestamp, t as logger, vt as AvatarError, wt as DEFAULT_REGION_REQUEST, xt as ConversationState, yt as AvatarState } from "./logger-C3fw-NWP.js";
-import { n as APP_CONFIG } from "./error-utils-PtNzUHiL.js";
-import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-Bv4kzdt8.js";
-import { t as AvatarDownloader } from "./AvatarDownloader-C2JJVqKm.js";
+import { a as avatarViewRegistry, c as Message, d as BinaryReader, f as BinaryWriter, i as buildTraceparent, l as MessageType, o as AudioFormat, r as startPlaybackTrace, s as EgressType, t as AvatarSDK, u as TransportCompression } from "./AvatarSDK-CnZqa_X4.js";
+import { At as RENDER_QUALITY_PARAMS, Ct as DEFAULT_REGION, Dt as FrameStarvationMode, Et as ErrorCode, Mt as TransitionType, Ot as LoadProgress, St as DEFAULT_OPUS_BITRATE, Tt as DrivingServiceMode, _t as AnimationType, b as recordMetric, bt as ConnectionState, c as logEvent, h as clockSync, ht as idManager, jt as RenderQuality, kt as LogLevel, l as logMetric, m as resolveMarks, p as monoTimestamp, t as logger, vt as AvatarError, wt as DEFAULT_REGION_REQUEST, xt as ConversationState, yt as AvatarState } from "./logger-fAU8oahT.js";
+import { n as APP_CONFIG } from "./error-utils-CqKOrHrY.js";
+import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-D9DcUV65.js";
+import { t as AvatarDownloader } from "./AvatarDownloader-Dfi7wtgQ.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -309,8 +309,8 @@ var AnimationPlayer = class AnimationPlayer {
 	*/
 	async createAndInitializeStreamingPlayer() {
 		if (this.streamingPlayer) return;
-		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DmotFnXu.js");
-		const { AvatarSDK } = await import("./AvatarSDK-CuejGi0J.js").then((n) => n.n);
+		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-D4q7c1U0.js");
+		const { AvatarSDK } = await import("./AvatarSDK-CnZqa_X4.js").then((n) => n.n);
 		const audioFormat = AvatarSDK.getAudioFormat();
 		this.streamingPlayer = new StreamingAudioPlayer({
 			sampleRate: audioFormat.sampleRate,
@@ -1281,7 +1281,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			return;
 		}
 		try {
-			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-_AWpY7N6.js");
+			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-9YIZ7nIt.js");
 			const bitrate = opusBitrate ?? 48e3;
 			this.opusEncoder = await OpusEncoderProxy.create(sampleRate, bitrate);
 			this.uplinkIsOpus = true;
@@ -2628,7 +2628,7 @@ var AvatarController = class {
 		const { inputAudioFormat } = AvatarSDK.getAudioFormat();
 		if (inputAudioFormat !== "opus" || this.inputOpusDecoderProxy) return;
 		try {
-			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-BTWRku-I.js");
+			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-Ar_dFXRB.js");
 			this.inputOpusDecoderProxy = await OpusDecoderProxy.create();
 			this.inputDecodeChain = Promise.resolve();
 		} catch (error) {
@@ -2904,7 +2904,7 @@ var AvatarController = class {
 				isLast
 			});
 			this.notifyConversationState(AvatarState.active);
-			if (!this.isPlaying && !this.isStartingPlayback && this.currentKeyframes.length > 0) this.startStreamingPlayback().catch((error) => {
+			if (!this.isPlaying && !this.isStartingPlayback) this.startStreamingPlayback().catch((error) => {
 				this.isStartingPlayback = false;
 				logger.error("[AvatarController] Failed to start playback from audio arrival:", error instanceof Error ? error.message : String(error));
 			});
@@ -3016,7 +3016,7 @@ var AvatarController = class {
 			const arrayIndex = Math.round(audioTime * 25) - this.keyframesOffset;
 			if (arrayIndex >= 0 && arrayIndex < this.currentKeyframes.length) this.resumeAudioFromStarvation();
 		}
-		if (!this.isPlaying && !this.isStartingPlayback && this.pendingAudioChunks.length > 0 && this.currentKeyframes.length > 0) this.startStreamingPlayback().catch((error) => {
+		if (!this.isPlaying && !this.isStartingPlayback) this.startStreamingPlayback().catch((error) => {
 			this.isStartingPlayback = false;
 			logger.error("[AvatarController] Failed to auto-start playback:", error);
 			this.onError?.(new AvatarError("Failed to start playback", ErrorCode.playbackStartFailed));
@@ -3263,9 +3263,12 @@ var AvatarController = class {
 		}
 		if (this.isStartingPlayback) return;
 		this.isStartingPlayback = true;
+		if (this.pendingAudioChunks.length === 0) {
+			this.isStartingPlayback = false;
+			return;
+		}
 		if (!this.isFallbackMode && (!this.currentKeyframes || this.currentKeyframes.length === 0)) {
 			this.isStartingPlayback = false;
-			logger.warn("[AvatarController] No animation data to play");
 			return;
 		}
 		try {
@@ -3642,7 +3645,7 @@ var AvatarController = class {
 			isLast
 		});
 		if (this.isFallbackMode && !this.isPlaying && !this.isStartingPlayback) this.startFallbackPlayback();
-		else if (!this.isFallbackMode && !this.isPlaying && !this.isStartingPlayback && this.currentKeyframes.length > 0) this.startStreamingPlayback().catch((error) => {
+		else if (!this.isFallbackMode && !this.isPlaying && !this.isStartingPlayback) this.startStreamingPlayback().catch((error) => {
 			this.isStartingPlayback = false;
 			logger.error("[AvatarController] Failed to start playback from audio arrival:", error instanceof Error ? error.message : String(error));
 		});
@@ -3838,7 +3841,7 @@ var AvatarManager = class AvatarManager {
 			} else {
 				logger.log(`[AvatarManager] Avatar ${id} cache invalid: updatedAt=${cachedUpdatedAt}->${newUpdatedAt}, modelType=${cachedModelType}->${requestedModelType}, reloading...`);
 				this.avatarCache.delete(id);
-				const { PwaCacheManager } = await import("./pwa-cache-manager-D3nj4sd5.js").then((n) => n.n);
+				const { PwaCacheManager } = await import("./pwa-cache-manager-CwXaM3xR.js").then((n) => n.n);
 				await PwaCacheManager.clearCharacterCache(id);
 			}
 		}
@@ -6375,7 +6378,7 @@ var AvatarView = class {
 		*/
 		const scheduleNextTick = () => {
 			let delay = frameIntervalMs;
-			if (this.isConversationActive && !this.avatarController.getIsFallbackMode()) {
+			if (this.avatarController.getIsPlaying() && !this.avatarController.getIsFallbackMode()) {
 				const audioTime = this.avatarController.getAudioTime();
 				if (audioTime > 0) {
 					const remainingMs = ((Math.floor(audioTime * fps + 1e-6) + 1) / fps - audioTime) * 1e3;
@@ -6416,31 +6419,27 @@ var AvatarView = class {
 					scheduleNextTick();
 					return;
 				}
-				if (this.isConversationActive && !this.avatarController.getIsFallbackMode()) {
+				if (this.avatarController.getIsPlaying() && !this.avatarController.getIsFallbackMode()) {
 					const audioTime = this.avatarController.getAudioTime();
-					if (audioTime > 0) {
-						const frameIndex = Math.max(0, Math.floor(audioTime * fps + 1e-6));
-						if (frameIndex > this.lastRenderedFrameIndex) {
-							this.lastRenderedFrameIndex = frameIndex;
-							this.avatarController.monitorPlaybackTick(audioTime, frameIndex);
-							const keyframes = this.avatarController.getKeyframes();
-							let arrayIndex = frameIndex - this.avatarController.getKeyframesOffset();
-							if (arrayIndex < 0) arrayIndex = 0;
-							if (arrayIndex >= keyframes.length) arrayIndex = keyframes.length - 1;
-							if (arrayIndex >= 0 && arrayIndex < keyframes.length) {
-								const currentFrame = keyframes[arrayIndex];
-								this.currentFrame = currentFrame;
-								const wasmParams = convertProtoFlameToWasmParams(currentFrame);
-								computeInFlight = true;
-								avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0).then((splatData) => {
-									if (splatData && !this.isPureRenderingMode) this.doRender(splatData);
-								}).catch((e) => logger.warn("[AvatarView] Conversation frame compute failed:", e instanceof Error ? e.message : String(e))).finally(() => {
-									computeInFlight = false;
-								});
-							}
+					const frameIndex = Math.max(0, Math.floor(audioTime * fps + 1e-6));
+					if (frameIndex > this.lastRenderedFrameIndex) {
+						this.lastRenderedFrameIndex = frameIndex;
+						this.avatarController.monitorPlaybackTick(audioTime, frameIndex);
+						const keyframes = this.avatarController.getKeyframes();
+						let arrayIndex = frameIndex - this.avatarController.getKeyframesOffset();
+						if (arrayIndex < 0) arrayIndex = 0;
+						if (arrayIndex >= keyframes.length) arrayIndex = keyframes.length - 1;
+						if (arrayIndex >= 0 && arrayIndex < keyframes.length) {
+							const currentFrame = keyframes[arrayIndex];
+							this.currentFrame = currentFrame;
+							const wasmParams = convertProtoFlameToWasmParams(currentFrame);
+							computeInFlight = true;
+							avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0).then((splatData) => {
+								if (splatData && !this.isPureRenderingMode) this.doRender(splatData);
+							}).catch((e) => logger.warn("[AvatarView] Conversation frame compute failed:", e instanceof Error ? e.message : String(e))).finally(() => {
+								computeInFlight = false;
+							});
 						}
-						scheduleNextTick();
-						return;
 					}
 					scheduleNextTick();
 					return;

package/dist/internal-telemetry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Internal telemetry surface for the companion RTC SDK.
+ *
+ * `@spatius/avatarkit-rtc` reports into the same OpenObserve backend and shares
+ * this SDK's OTel providers, so its spans must sit on the same calibrated
+ * timeline. Without that, a client whose wall clock is off puts RTC spans at a
+ * time that does not line up with the server-side records they need to be read
+ * against.
+ *
+ * Deliberately NOT re-exported from the package root: this is a bridge between
+ * two first-party packages, not API for integrators. It exposes conversion only
+ * — nothing here can alter the clock baseline.
+ *
+ * NOTE: nothing in this file may be tagged `@internal`. The dts plugin runs with
+ * `stripInternal: true`, which erases such declarations from the emitted `.d.ts`
+ * — the entry would still export both functions at runtime while shipping an
+ * empty `export {}` type file, leaving the RTC package with no types.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Convert a `performance.now()` reading taken earlier into a timeline
+ * timestamp (epoch ms), preferring the server-calibrated baseline and falling
+ * back to the local clock until calibration completes.
+ *
+ * Collect marks on the monotonic clock and convert at report time: the wall
+ * clock and `performance.now()` drift apart while the main thread is blocked,
+ * and calibration may not have finished when the mark was taken.
+ *
+ * @param mono - the `performance.now()` value recorded at collection time
+ */
+export declare function resolveMonoTimestamp(mono: number): number;
+/**
+ * Whether clock calibration against the backend has completed. Timestamps
+ * resolve either way; this only reports whether they are server-aligned yet.
+ */
+export declare function isClockCalibrated(): boolean;

package/dist/internal-telemetry.js

@@ -0,0 +1,45 @@
+import { h as clockSync } from "./logger-fAU8oahT.js";
+//#region internal-telemetry.ts
+/**
+* Internal telemetry surface for the companion RTC SDK.
+*
+* `@spatius/avatarkit-rtc` reports into the same OpenObserve backend and shares
+* this SDK's OTel providers, so its spans must sit on the same calibrated
+* timeline. Without that, a client whose wall clock is off puts RTC spans at a
+* time that does not line up with the server-side records they need to be read
+* against.
+*
+* Deliberately NOT re-exported from the package root: this is a bridge between
+* two first-party packages, not API for integrators. It exposes conversion only
+* — nothing here can alter the clock baseline.
+*
+* NOTE: nothing in this file may be tagged `@internal`. The dts plugin runs with
+* `stripInternal: true`, which erases such declarations from the emitted `.d.ts`
+* — the entry would still export both functions at runtime while shipping an
+* empty `export {}` type file, leaving the RTC package with no types.
+*
+* @packageDocumentation
+*/
+/**
+* Convert a `performance.now()` reading taken earlier into a timeline
+* timestamp (epoch ms), preferring the server-calibrated baseline and falling
+* back to the local clock until calibration completes.
+*
+* Collect marks on the monotonic clock and convert at report time: the wall
+* clock and `performance.now()` drift apart while the main thread is blocked,
+* and calibration may not have finished when the mark was taken.
+*
+* @param mono - the `performance.now()` value recorded at collection time
+*/
+function resolveMonoTimestamp(mono) {
+	return clockSync.resolveMono(mono);
+}
+/**
+* Whether clock calibration against the backend has completed. Timestamps
+* resolve either way; this only reports whether they are server-aligned yet.
+*/
+function isClockCalibrated() {
+	return clockSync.isReady();
+}
+//#endregion
+export { isClockCalibrated, resolveMonoTimestamp };

package/dist/{logger-C3fw-NWP.js → logger-fAU8oahT.js}

@@ -13624,6 +13624,165 @@ var HTTP_NETWORK_BUCKETS_MS = [
 	4e3,
 	5e3
 ];
+/**
+* RTC playback 指标的桶。默认桶（0/5/10/25/50/…/10000）对这批指标毫无分辨率：
+* 帧率只可能落在 0~25，缺帧数和卡顿次数几乎全部挤在第一个桶里，分位数因此毫无意义。
+* 桶按各指标的实际值域给：
+*
+* - 帧率：每帧一个桶。25fps 与 21fps 的观感差别正是要看的，5 档分级会把两者归成一类。
+* - 帧数：正常轮次对应播放时长桶、没上屏的帧对应卡顿时长桶，都按帧间隔换算。
+* - 卡顿次数：数的是次数不是帧，自成一组。
+* - 百分比：每 5% 一档，0~100。
+* - 时长：分两组——整轮播放是秒级，单次卡顿是一帧起步的毫秒级。
+*
+* 这些 metric 由 @spatius/avatarkit-rtc 发出（meter 名 spatius-avatarkit-rtc），
+* 但 view 只能配在创建 MeterProvider 的这一侧，所以桶定义留在这里。
+*/
+var RTC_FPS_BUCKETS = [
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	7,
+	8,
+	9,
+	10,
+	11,
+	12,
+	13,
+	14,
+	15,
+	16,
+	17,
+	18,
+	19,
+	20,
+	21,
+	22,
+	23,
+	24
+];
+/**
+* 一轮播出的帧数。档位是播放时长桶除以帧间隔（40ms），和时长视角一一对应：
+* 「播了 10s」与「播了 250 帧」落在同一档。
+*/
+var RTC_FRAME_COUNT_BUCKETS = [
+	0,
+	50,
+	125,
+	250,
+	375,
+	500,
+	750,
+	1500
+];
+/**
+* 没能上屏的帧数（丢失/跳过/丢弃/过渡缺帧）：与正常帧数差一个数量级，
+* 共用一组桶会让它们全挤在低位。档位是卡顿时长桶除以帧间隔（40ms），
+* 于是「卡了 320ms」和「丢了 8 帧」落在同一档，两个视角能直接对上。
+*/
+var RTC_LOST_FRAME_BUCKETS = [
+	0,
+	1,
+	2,
+	4,
+	8,
+	16,
+	32,
+	64,
+	128,
+	256
+];
+/**
+* 一轮里卡顿发生的次数。数的是次数不是帧，上面那套按帧间隔换算的档位对它没有意义。
+* 低位逐个分档、高位翻倍：一轮几次和一轮几十次是两种情况，都要看得出来。
+* 实测慢网络下一轮 35 次，因此高位必须留到三位数。
+*/
+var RTC_STALL_COUNT_BUCKETS = [
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	10,
+	20,
+	40,
+	80,
+	160,
+	320
+];
+var RTC_PERCENT_BUCKETS = [
+	0,
+	5,
+	10,
+	15,
+	20,
+	25,
+	30,
+	35,
+	40,
+	45,
+	50,
+	55,
+	60,
+	65,
+	70,
+	75,
+	80,
+	85,
+	90,
+	95,
+	100
+];
+/** 一轮播放的时长，秒级量级。 */
+var RTC_PLAYBACK_DURATION_BUCKETS_MS = [
+	0,
+	2e3,
+	5e3,
+	1e4,
+	15e3,
+	2e4,
+	3e4,
+	6e4
+];
+/**
+* 卡顿时长：一帧（40ms）起步逐档翻倍到 10240ms。用播放时长那组秒级的桶，
+* 绝大多数卡顿会挤进第一格。
+*/
+var RTC_STALL_DURATION_BUCKETS_MS = [
+	0,
+	40,
+	80,
+	160,
+	320,
+	640,
+	1280,
+	2560,
+	5120,
+	10240
+];
+/** metric 名 → 桶，供下面的 views 展开。 */
+var RTC_BUCKET_PROFILES = [
+	["rtc_playback_avg_fps", RTC_FPS_BUCKETS],
+	["rtc_playback_frame_count", RTC_FRAME_COUNT_BUCKETS],
+	["rtc_playback_skipped_frames", RTC_LOST_FRAME_BUCKETS],
+	["rtc_playback_tail_discarded", RTC_LOST_FRAME_BUCKETS],
+	["rtc_playback_stall_count", RTC_STALL_COUNT_BUCKETS],
+	["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_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]
+];
 var METRIC_EXPORT_INTERVAL_MS = 1e4;
 var sdkVersion$2 = "1.0.0";
 var isInitialized$2 = false;
@@ -13670,7 +13829,13 @@ function initializeOtelMetrics(version, resourceAttrs) {
 					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
 					options: { boundaries: HTTP_NETWORK_BUCKETS_MS }
 				}
-			}]
+			}, ...RTC_BUCKET_PROFILES.map(([instrumentName, boundaries]) => ({
+				instrumentName,
+				aggregation: {
+					type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
+					options: { boundaries: [...boundaries] }
+				}
+			}))]
 		});
 		metrics.setGlobalMeterProvider(meterProvider);
 		isInitialized$2 = true;
@@ -14438,7 +14603,7 @@ function clientContextFields() {
 		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.language = navigator.language;
+			if (navigator.language) fields.locale = navigator.language;
 		}
 		if (typeof screen !== "undefined") {
 			if (screen.width) fields.screen_width = screen.width;
@@ -15038,7 +15203,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-CuejGi0J.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-CnZqa_X4.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();

package/dist/{pwa-cache-manager-D3nj4sd5.js → pwa-cache-manager-CwXaM3xR.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-C3fw-NWP.js";
+import { t as logger } from "./logger-fAU8oahT.js";
 //#region utils/pwa-cache-manager.ts
 /**
 * PWA Cache Manager

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.3.1-beta.4",
+  "version": "1.3.1-beta.6",
   "packageManager": "pnpm@10.18.2",
-  "description": "AvatarKit SDK - Real-time Avatar Rendering SDK for Web",
+  "description": "AvatarKit — real-time, audio-driven avatar rendering SDK for Web.",
+  "homepage": "https://spatius.ai/",
   "author": "AvatarKit Team",
   "license": "UNLICENSED",
   "keywords": [
@@ -26,6 +27,10 @@
       "types": "./next.d.ts",
       "import": "./next.js"
     },
+    "./internal-telemetry": {
+      "types": "./dist/internal-telemetry.d.ts",
+      "import": "./dist/internal-telemetry.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js"