@spatius/avatarkit 1.3.1 → 1.3.3

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.3] - 2026-08-08
+
+### Fixed
+- Internal telemetry only, no change to public API or runtime behaviour: sessions driven through the companion RTC SDK are now attributed to that SDK and its version, matching how the Android and iOS SDKs already report. Previously such sessions were indistinguishable from a plain AvatarKit integration on the dashboards.
+
+## [1.3.2] - 2026-08-08
+
+### Fixed
+- Internal telemetry only, no change to public API or runtime behaviour: fixed the diagnostics the SDK reports to Spatius. Connection setup is now reported as two separate steps (handshake and session confirmation) instead of a single total, steps faster than a millisecond no longer come back out of order, and cache lookups that complete instantly are no longer reported as loads.
+
 ## [1.3.1] - 2026-08-07
 
 Rolls up everything from the 1.3.1 beta line.

package/dist/{AvatarDownloader-DyhenPKd.js → AvatarDownloader-DNeU2n5w.js}

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as AvatarSDK } from "./AvatarSDK-DgPvHU4L.js";
-import { S as recordHttpClientDuration, c as logEvent, kt as ErrorCode, l as logMetric, t as logger, v as hostOf, xt as AvatarError, yt as generateTraceId } from "./logger-BOpQ7u0w.js";
-import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-BogEllAd.js";
-import { t as PwaCacheManager } from "./pwa-cache-manager-C7NbU52Q.js";
+import { t as AvatarSDK } from "./AvatarSDK-BbqaBxdV.js";
+import { Mt as ErrorCode, S as recordHttpClientDuration, St as generateTraceId, c as logEvent, l as logMetric, t as logger, v as hostOf, wt as AvatarError } from "./logger-pANhsT4J.js";
+import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-DAqUlC0I.js";
+import { t as PwaCacheManager } from "./pwa-cache-manager-M3XsMhvz.js";
 //#region core/AvatarDownloader.ts
 var AvatarDownloader_exports = /* @__PURE__ */ __exportAll({ AvatarDownloader: () => AvatarDownloader });
 /**

package/dist/{AvatarSDK-DgPvHU4L.js → AvatarSDK-BbqaBxdV.js}

@@ -1,6 +1,6 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { Mt as LogLevel, Ot as DrivingServiceMode, _ as fetchBootstrap, a as clientContextFields, b as cleanupOtelMetrics, c as logEvent, d as cleanupOtel, dt as OTEL_LOGS_ENDPOINT, f as initializeOtel, ft as OTEL_PASSWORD, g as clockSync, gt as OTEL_USERNAME, i as cleanupPostHog, n as setLogLevel, o as getLogsFeatureFlag, pt as OTEL_STREAM_NAME, r as logSink, s as initializePostHog, t as logger, u as updatePostHogPersonPropertiesForFlags, vt as idManager, x as initializeOtelMetrics } from "./logger-BOpQ7u0w.js";
-import { n as initializeOtelTrace, r as startInitTrace, t as cleanupOtelTrace } from "./otel-trace-Ct4T48nC.js";
+import { Ft as LogLevel, T as resolveSdkVersion, _ as fetchBootstrap, a as clientContextFields, b as cleanupOtelMetrics, c as logEvent, d as cleanupOtel, f as initializeOtel, g as clockSync, gt as OTEL_STREAM_NAME, ht as OTEL_PASSWORD, i as cleanupPostHog, jt as DrivingServiceMode, mt as OTEL_LOGS_ENDPOINT, n as setLogLevel, o as getLogsFeatureFlag, r as logSink, s as initializePostHog, t as logger, u as updatePostHogPersonPropertiesForFlags, w as getSdkPackage, x as initializeOtelMetrics, xt as idManager, yt as OTEL_USERNAME } from "./logger-pANhsT4J.js";
+import { i as startInitTrace, n as initializeOtelTrace, t as cleanupOtelTrace } from "./otel-trace-DBN8K91J.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.
@@ -2526,9 +2526,9 @@ function emitInitErrorLog(params) {
 		const nowNanos = String(Math.round(performance.timeOrigin + performance.now()) * 1e6);
 		const resourceAttrs = [
 			kv("service.name", "avatarkit"),
-			kv("sdk.version", sdkVersion),
+			kv("sdk.version", resolveSdkVersion(sdkVersion)),
 			kv("sdk.platform", "web"),
-			kv("sdk.package", "spatius-web-sdk"),
+			kv("sdk.package", getSdkPackage()),
 			kv("app_id", appId),
 			kv("region", region),
 			kv("dsm", dsm)
@@ -3900,7 +3900,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1";
+	static _version = "1.3.3";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -4089,7 +4089,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-DyhenPKd.js").then((n) => n.n);
+			const { AvatarDownloader } = await import("./AvatarDownloader-DNeU2n5w.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-CXU7ysrU.js → OpusCodec-TzsHzMqb.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-BOpQ7u0w.js";
+import { t as logger } from "./logger-pANhsT4J.js";
 /** Opus granule positions are always in 48 kHz samples, regardless of input rate. */
 var OPUS_GRANULE_RATE = 48e3;
 /**

package/dist/{OpusDecoderProxy-Cq8Z_MZY.js → OpusDecoderProxy-D4J2CfRQ.js}

@@ -1,4 +1,4 @@
-import { t as logger } from "./logger-BOpQ7u0w.js";
+import { t as logger } from "./logger-pANhsT4J.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-CXU7ysrU.js").then((n) => n.n);
+		const { OggOpusDecoder } = await import("./OpusCodec-TzsHzMqb.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-C2T0afkj.js",
+					"/assets/OpusDecoderWorker.worker-ChLjIgER.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{OpusEncoderProxy-CzY-VckE.js → OpusEncoderProxy-bLEToi2R.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as logger } from "./logger-BOpQ7u0w.js";
+import { t as logger } from "./logger-pANhsT4J.js";
 //#region audio/OpusEncoderProxy.ts
 var OpusEncoderProxy_exports = /* @__PURE__ */ __exportAll({
 	OpusEncoderProxy: () => OpusEncoderProxy,
@@ -43,7 +43,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-CXU7ysrU.js").then((n) => n.n);
+		const { OggOpusEncoder } = await import("./OpusCodec-TzsHzMqb.js").then((n) => n.n);
 		proxy.fallbackEncoder = new OggOpusEncoder(sampleRate, bitrate);
 		proxy.backend = "main-thread";
 		return proxy;
@@ -54,7 +54,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"/assets/OpusEncoderWorker.worker-DLYO9vPK.js",
+					"/assets/OpusEncoderWorker.worker-bjAyiJ3b.js",
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {

package/dist/{StreamingAudioPlayer-CIJmBp3z.js → StreamingAudioPlayer-CCg4uoVV.js}

@@ -1,5 +1,5 @@
-import { c as logEvent, t as logger } from "./logger-BOpQ7u0w.js";
-import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-BogEllAd.js";
+import { c as logEvent, t as logger } from "./logger-pANhsT4J.js";
+import { n as APP_CONFIG, t as errorToMessage } from "./error-utils-DAqUlC0I.js";
 //#region audio/StreamingAudioPlayer.ts
 /**
 * Streaming Audio Player

package/dist/assets/{AvatarDownloader-G5FO1bVl.js → AvatarDownloader-Cy2QvOfT.js}

@@ -1,5 +1,5 @@
-import { bt as ErrorCode, c as logEvent, gt as AvatarError, h as hostOf, ht as generateTraceId, l as logMetric, pt as isDebugMode, t as logger, y as recordHttpClientDuration } from "./logger-YPooEAbA.js";
-import { t as AvatarSDK } from "./AvatarSDK-C_Anluwp.js";
+import { St as ErrorCode, _t as generateTraceId, c as logEvent, h as hostOf, ht as isDebugMode, l as logMetric, t as logger, vt as AvatarError, y as recordHttpClientDuration } from "./logger-DI85eKqW.js";
+import { t as AvatarSDK } from "./AvatarSDK-Bdz1V7pz.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-C_Anluwp.js → AvatarSDK-Bdz1V7pz.js}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { $ as ContextAPI, A as addHrTimes, B as ATTR_SERVICE_NAME, C as createResource, D as resourceFromAttributes, E as defaultResource, F as millisToHrTime, G as suppressTracing, H as getStringFromEnv, I as otperformance, J as context, K as trace, L as ATTR_EXCEPTION_MESSAGE, M as hrTimeDuration, N as isTimeInput, O as BindOnceFuture, P as isTimeInputHrTime, Q as TraceFlags, R as ATTR_EXCEPTION_STACKTRACE, S as createInstrumentationScope, T as OTLPExporterBase, U as globalErrorHandler, V as getNumberFromEnv, W as isTracingSuppressed, X as isValidTraceId, Y as isSpanContextValid, Z as INVALID_SPAN_CONTEXT, _ as cleanupOtelMetrics, a as clientContextFields, at as registerGlobal, b as createLegacyOtlpBrowserExportDelegate, c as logEvent, ct as OTEL_PASSWORD, d as cleanupOtel, dt as OTEL_TRACES_STREAM_NAME, et as createNoopMeter, f as initializeOtel, ft as OTEL_USERNAME, g as observeExporter, i as cleanupPostHog, it as getGlobal, j as hrTime, k as ExportResultCode, lt as OTEL_STREAM_NAME, m as fetchBootstrap, mt as idManager, n as setLogLevel, nt as createContextKey, o as getLogsFeatureFlag, ot as unregisterGlobal, p as clockSync, q as diag$1, r as logSink, rt as DiagAPI, s as initializePostHog, st as OTEL_LOGS_ENDPOINT, t as logger, tt as ROOT_CONTEXT, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_TRACES_ENDPOINT, v as initializeOtelMetrics, w as toAttributes, x as JSON_ENCODER, xt as LogLevel, yt as DrivingServiceMode, z as ATTR_EXCEPTION_TYPE } from "./logger-YPooEAbA.js";
+import { $ as INVALID_SPAN_CONTEXT, A as BindOnceFuture, B as ATTR_EXCEPTION_STACKTRACE, C as JSON_ENCODER, Ct as LogLevel, D as OTLPExporterBase, E as toAttributes, F as isTimeInput, G as globalErrorHandler, H as ATTR_SERVICE_NAME, I as isTimeInputHrTime, J as trace, K as isTracingSuppressed, L as millisToHrTime, M as addHrTimes, N as hrTime, O as defaultResource, P as hrTimeDuration, Q as isValidTraceId, R as otperformance, S as createLegacyOtlpBrowserExportDelegate, T as createResource, U as getNumberFromEnv, V as ATTR_EXCEPTION_TYPE, W as getStringFromEnv, X as context, Y as diag$1, Z as isSpanContextValid, _ as cleanupOtelMetrics, a as clientContextFields, at as DiagAPI, b as getSdkPackage, c as logEvent, ct as unregisterGlobal, d as cleanupOtel, dt as OTEL_STREAM_NAME, et as TraceFlags, f as initializeOtel, ft as OTEL_TRACES_ENDPOINT, g as observeExporter, gt as idManager, i as cleanupPostHog, it as createContextKey, j as ExportResultCode, k as resourceFromAttributes, lt as OTEL_LOGS_ENDPOINT, m as fetchBootstrap, mt as OTEL_USERNAME, n as setLogLevel, nt as createNoopMeter, o as getLogsFeatureFlag, ot as getGlobal, p as clockSync, pt as OTEL_TRACES_STREAM_NAME, q as suppressTracing, r as logSink, rt as ROOT_CONTEXT, s as initializePostHog, st as registerGlobal, t as logger, tt as ContextAPI, u as updatePostHogPersonPropertiesForFlags, ut as OTEL_PASSWORD, v as initializeOtelMetrics, w as createInstrumentationScope, x as resolveSdkVersion, xt as DrivingServiceMode, z as ATTR_EXCEPTION_MESSAGE } from "./logger-DI85eKqW.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) {
@@ -2382,9 +2382,9 @@ function initializeOtelTrace(version, resourceAttrs) {
 		tracerProvider = new WebTracerProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion,
+				"sdk.version": resolveSdkVersion(sdkVersion),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm,
@@ -2460,7 +2460,7 @@ function startInitTrace(sessionId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) sp.setStatus({ code: SpanStatusCode.ERROR });
-					sp.end(endMs);
+					sp.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -2535,9 +2535,9 @@ function emitInitErrorLog(params) {
 		const nowNanos = String(Math.round(performance.timeOrigin + performance.now()) * 1e6);
 		const resourceAttrs = [
 			kv("service.name", "avatarkit"),
-			kv("sdk.version", sdkVersion),
+			kv("sdk.version", resolveSdkVersion(sdkVersion)),
 			kv("sdk.platform", "web"),
-			kv("sdk.package", "spatius-web-sdk"),
+			kv("sdk.package", getSdkPackage()),
 			kv("app_id", appId),
 			kv("region", region),
 			kv("dsm", dsm)
@@ -6223,7 +6223,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.1";
+	static _version = "1.3.3";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -6412,7 +6412,7 @@ var AvatarSDK = class {
 		logger.log("[AvatarSDK] Loading template resources...");
 		logEvent("template_init_start", "info", { stage: "sdk_init" });
 		try {
-			const { AvatarDownloader } = await import("./AvatarDownloader-G5FO1bVl.js");
+			const { AvatarDownloader } = await import("./AvatarDownloader-Cy2QvOfT.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-C2T0afkj.js → OpusDecoderWorker.worker-ChLjIgER.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-YPooEAbA.js";
+import { t as logger } from "./logger-DI85eKqW.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

package/dist/assets/{OpusEncoderWorker.worker-DLYO9vPK.js → OpusEncoderWorker.worker-bjAyiJ3b.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-YPooEAbA.js";
+import { t as logger } from "./logger-DI85eKqW.js";
 //#region __vite-browser-external
 var require___vite_browser_external = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {};

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

@@ -13434,6 +13434,22 @@ var OTLPMetricExporter = class extends OTLPMetricExporterBase {
 	}
 };
 //#endregion
+//#region utils/otel-identity.ts
+let sdkPackage = "spatius-web-sdk";
+/** 当前归属包名,供各通道构建 Resource 时读取。@internal */
+function getSdkPackage() {
+	return sdkPackage;
+}
+/**
+* Resource 上应上报的版本号。
+*
+* @param hostVersion - 主库自己的版本,未被上层 SDK 声明时用它。
+* @internal
+*/
+function resolveSdkVersion(hostVersion) {
+	return hostVersion;
+}
+//#endregion
 //#region utils/otel-metrics.ts
 /**
 * OpenTelemetry Metrics Tracker (Browser Version)
@@ -13812,9 +13828,9 @@ function initializeOtelMetrics(version, resourceAttrs) {
 		meterProvider = new MeterProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion$2,
+				"sdk.version": resolveSdkVersion(sdkVersion$2),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -14542,9 +14558,9 @@ function initializeOtel(version, resourceAttrs) {
 		loggerProvider = new LoggerProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion$1,
+				"sdk.version": resolveSdkVersion(sdkVersion$1),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -15434,7 +15450,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-C_Anluwp.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-Bdz1V7pz.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();
@@ -15524,4 +15540,4 @@ function captureErrorContext(level, error) {
 	});
 }
 //#endregion
-export { ContextAPI as $, addHrTimes as A, ATTR_SERVICE_NAME as B, createResource as C, resourceFromAttributes as D, defaultResource as E, millisToHrTime as F, suppressTracing as G, getStringFromEnv as H, otperformance as I, context as J, trace as K, ATTR_EXCEPTION_MESSAGE as L, hrTimeDuration as M, isTimeInput as N, BindOnceFuture as O, isTimeInputHrTime as P, TraceFlags as Q, ATTR_EXCEPTION_STACKTRACE as R, createInstrumentationScope as S, OTLPExporterBase as T, globalErrorHandler as U, getNumberFromEnv as V, isTracingSuppressed as W, isValidTraceId as X, isSpanContextValid as Y, INVALID_SPAN_CONTEXT as Z, cleanupOtelMetrics as _, DEFAULT_REGION as _t, clientContextFields as a, registerGlobal as at, createLegacyOtlpBrowserExportDelegate as b, ErrorCode as bt, logEvent as c, OTEL_PASSWORD as ct, cleanupOtel as d, OTEL_TRACES_STREAM_NAME as dt, createNoopMeter as et, initializeOtel as f, OTEL_USERNAME as ft, observeExporter as g, AvatarError as gt, hostOf as h, generateTraceId as ht, cleanupPostHog as i, getGlobal as it, hrTime as j, ExportResultCode as k, logMetric as l, OTEL_STREAM_NAME as lt, fetchBootstrap as m, idManager as mt, setLogLevel as n, createContextKey as nt, getLogsFeatureFlag as o, unregisterGlobal as ot, clockSync as p, isDebugMode as pt, diag as q, logSink as r, DiagAPI as rt, initializePostHog as s, OTEL_LOGS_ENDPOINT as st, logger as t, ROOT_CONTEXT as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_TRACES_ENDPOINT as ut, initializeOtelMetrics as v, DEFAULT_REGION_REQUEST as vt, toAttributes$1 as w, JSON_ENCODER as x, LogLevel as xt, recordHttpClientDuration as y, DrivingServiceMode as yt, ATTR_EXCEPTION_TYPE as z };
+export { INVALID_SPAN_CONTEXT as $, BindOnceFuture as A, ATTR_EXCEPTION_STACKTRACE as B, JSON_ENCODER as C, LogLevel as Ct, OTLPExporterBase as D, toAttributes$1 as E, isTimeInput as F, globalErrorHandler as G, ATTR_SERVICE_NAME as H, isTimeInputHrTime as I, trace as J, isTracingSuppressed as K, millisToHrTime as L, addHrTimes as M, hrTime as N, defaultResource as O, hrTimeDuration as P, isValidTraceId as Q, otperformance as R, createLegacyOtlpBrowserExportDelegate as S, ErrorCode as St, createResource as T, getNumberFromEnv as U, ATTR_EXCEPTION_TYPE as V, getStringFromEnv as W, context as X, diag as Y, isSpanContextValid as Z, cleanupOtelMetrics as _, generateTraceId as _t, clientContextFields as a, DiagAPI as at, getSdkPackage as b, DEFAULT_REGION_REQUEST as bt, logEvent as c, unregisterGlobal as ct, cleanupOtel as d, OTEL_STREAM_NAME as dt, TraceFlags as et, initializeOtel as f, OTEL_TRACES_ENDPOINT as ft, observeExporter as g, idManager as gt, hostOf as h, isDebugMode as ht, cleanupPostHog as i, createContextKey as it, ExportResultCode as j, resourceFromAttributes as k, logMetric as l, OTEL_LOGS_ENDPOINT as lt, fetchBootstrap as m, OTEL_USERNAME as mt, setLogLevel as n, createNoopMeter as nt, getLogsFeatureFlag as o, getGlobal as ot, clockSync as p, OTEL_TRACES_STREAM_NAME as pt, suppressTracing as q, logSink as r, ROOT_CONTEXT as rt, initializePostHog as s, registerGlobal as st, logger as t, ContextAPI as tt, updatePostHogPersonPropertiesForFlags as u, OTEL_PASSWORD as ut, initializeOtelMetrics as v, AvatarError as vt, createInstrumentationScope as w, resolveSdkVersion as x, DrivingServiceMode as xt, recordHttpClientDuration as y, DEFAULT_REGION as yt, ATTR_EXCEPTION_MESSAGE as z };

package/dist/{error-utils-BogEllAd.js → error-utils-DAqUlC0I.js}

@@ -1,4 +1,4 @@
-import { _t as isDebugMode } from "./logger-BOpQ7u0w.js";
+import { bt as isDebugMode } from "./logger-pANhsT4J.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,10 +1,10 @@
-import { a as EgressType, c as TransportCompression, i as AudioFormat, l as BinaryReader, o as Message, r as avatarViewRegistry, s as MessageType, t as AvatarSDK, u as BinaryWriter } from "./AvatarSDK-DgPvHU4L.js";
-import { At as FrameStarvationMode, C as recordMetric, Ct as ConnectionState, Dt as DEFAULT_REGION_REQUEST, Et as DEFAULT_REGION, Ft as TransitionType, Mt as LogLevel, Nt as RENDER_QUALITY_PARAMS, Ot as DrivingServiceMode, Pt as RenderQuality, St as AvatarState, Tt as DEFAULT_OPUS_BITRATE, bt as AnimationType, c as logEvent, g as clockSync, h as resolveMarks, jt as LoadProgress, kt as ErrorCode, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, vt as idManager, wt as ConversationState, xt as AvatarError } from "./logger-BOpQ7u0w.js";
-import { a as startPlaybackTrace, i as startLoadTrace, o as buildTraceparent } from "./otel-trace-Ct4T48nC.js";
-import { n as APP_CONFIG } from "./error-utils-BogEllAd.js";
-import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-CXU7ysrU.js";
-import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-CzY-VckE.js";
-import { t as AvatarDownloader } from "./AvatarDownloader-DyhenPKd.js";
+import { a as EgressType, c as TransportCompression, i as AudioFormat, l as BinaryReader, o as Message, r as avatarViewRegistry, s as MessageType, t as AvatarSDK, u as BinaryWriter } from "./AvatarSDK-BbqaBxdV.js";
+import { At as DEFAULT_REGION_REQUEST, C as recordMetric, Ct as AnimationType, Dt as ConversationState, Et as ConnectionState, Ft as LogLevel, It as RENDER_QUALITY_PARAMS, Lt as RenderQuality, Mt as ErrorCode, Nt as FrameStarvationMode, Ot as DEFAULT_OPUS_BITRATE, Pt as LoadProgress, Rt as TransitionType, Tt as AvatarState, c as logEvent, g as clockSync, h as resolveMarks, jt as DrivingServiceMode, kt as DEFAULT_REGION, l as logMetric, m as monoTimestamp, p as monoMarkFrom, t as logger, wt as AvatarError, xt as idManager } from "./logger-pANhsT4J.js";
+import { a as startLoadTrace, o as startPlaybackTrace, r as startConnectTrace, s as buildTraceparent } from "./otel-trace-DBN8K91J.js";
+import { n as APP_CONFIG } from "./error-utils-DAqUlC0I.js";
+import { r as OggMuxer, t as OggPageSplitter } from "./OpusCodec-TzsHzMqb.js";
+import { n as setOpusEncodeFrameSink } from "./OpusEncoderProxy-bLEToi2R.js";
+import { t as AvatarDownloader } from "./AvatarDownloader-DNeU2n5w.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -311,8 +311,8 @@ var AnimationPlayer = class AnimationPlayer {
 	*/
 	async createAndInitializeStreamingPlayer() {
 		if (this.streamingPlayer) return;
-		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CIJmBp3z.js");
-		const { AvatarSDK } = await import("./AvatarSDK-DgPvHU4L.js").then((n) => n.n);
+		const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CCg4uoVV.js");
+		const { AvatarSDK } = await import("./AvatarSDK-BbqaBxdV.js").then((n) => n.n);
 		const audioFormat = AvatarSDK.getAudioFormat();
 		this.streamingPlayer = new StreamingAudioPlayer({
 			sampleRate: audioFormat.sampleRate,
@@ -952,6 +952,15 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	sessionConfigured = false;
 	connectionStartTime = 0;
 	/**
+	* 连接发起时刻（`new WebSocket()` 之前）。
+	*
+	* `ws_connect_latency` 与 connect trace 都以它为起点。与 `connectionStartTime`
+	* 分开：那个是「连接建立成功」的时刻，用来算 session 时长，语义不同。
+	*/
+	connectStartMs = 0;
+	/** 握手完成（onopen）时刻，用来把连接拆成握手 / 会话确认两段。 */
+	wsOpenMs = 0;
+	/**
 	* Opus encoder proxy, created only when the SDK-decided uplink is Opus. Null
 	* means audio is sent as raw PCM. Scoped to one connection: created
 	* on connect, destroyed on disconnect. Runs the encode off the main thread via
@@ -1343,7 +1352,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			return;
 		}
 		try {
-			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-CzY-VckE.js").then((n) => n.t);
+			const { OpusEncoderProxy } = await import("./OpusEncoderProxy-bLEToi2R.js").then((n) => n.t);
 			const bitrate = opusBitrate ?? 48e3;
 			this.opusEncoder = await OpusEncoderProxy.create(sampleRate, bitrate);
 			this.uplinkIsOpus = true;
@@ -1399,19 +1408,39 @@ var AnimationWebSocketClient = class extends EventEmitter {
 		if (connectionId) url.searchParams.set("connection_id", connectionId);
 		return url.toString();
 	}
+	/**
+	* 发一条建连 trace：`connect` 下挂 `ws_handshake` / `session_confirm` 两段。
+	*
+	* 在会话确认时一次性回填（两段的时刻都已知），而不是实时开 span——建连全程只有
+	* 两个边界点，回填式更简单，也与 init / load trace 的做法一致。
+	*/
+	emitConnectTrace(confirmMs) {
+		const start = this.connectStartMs;
+		const open = this.wsOpenMs;
+		if (start <= 0 || open <= 0) return;
+		const t = startConnectTrace(start, {
+			connection_id: idManager.getConnectionId() ?? "",
+			region: AvatarSDK.configuration?.region ?? ""
+		});
+		t.span("ws_handshake", start, open, { dur_ms: open - start });
+		t.span("session_confirm", open, confirmMs, { dur_ms: confirmMs - open });
+		t.end(true, confirmMs, { dur_ms: confirmMs - start });
+		this.wsOpenMs = 0;
+	}
 	connectWebSocket(url) {
 		return new Promise((resolve, reject) => {
 			try {
 				const urlForLog = this.sanitizeUrlForLog(url);
 				logger.log(`[AnimationWebSocketClient] Connecting to WebSocket: ${urlForLog}`);
-				const connectStartMs = Date.now();
+				this.connectStartMs = Date.now();
+				this.wsOpenMs = 0;
 				this.ws = new WebSocket(url);
 				this.ws.onopen = () => {
 					this.isConnecting = false;
 					this.currentRetryCount = 0;
 					this.isManuallyDisconnected = false;
 					this.connectionStartTime = Date.now();
-					logMetric("ws_connect_latency", this.connectionStartTime - connectStartMs, {}, { connection_id: idManager.getConnectionId() || "" });
+					this.wsOpenMs = this.connectionStartTime;
 					logger.log(`[AnimationWebSocketClient] WebSocket connected successfully`);
 					this.configureSession();
 					this.emit("connected");
@@ -1586,6 +1615,12 @@ var AnimationWebSocketClient = class extends EventEmitter {
 						idManager.setConnectionId(connectionId);
 						logger.log(`[AnimationWebSocketClient] Session confirmed, connection_id updated: ${connectionId}`);
 					} else logger.log("[AnimationWebSocketClient] Session confirmed by server");
+					if (this.connectStartMs > 0) {
+						const confirmMs = Date.now();
+						logMetric("ws_connect_latency", confirmMs - this.connectStartMs, {}, { connection_id: idManager.getConnectionId() || "" });
+						this.emitConnectTrace(confirmMs);
+						this.connectStartMs = 0;
+					}
 					this.flushPendingAudio();
 					this.emit("sessionConfirmed", connectionId);
 					return;
@@ -2759,7 +2794,7 @@ var AvatarController = class {
 		const { inputAudioFormat } = AvatarSDK.getAudioFormat();
 		if (inputAudioFormat !== "opus" || this.inputOpusDecoderProxy) return;
 		try {
-			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-Cq8Z_MZY.js");
+			const { OpusDecoderProxy } = await import("./OpusDecoderProxy-D4J2CfRQ.js");
 			this.inputOpusDecoderProxy = await OpusDecoderProxy.create();
 			this.inputDecodeChain = Promise.resolve();
 		} catch (error) {
@@ -4059,7 +4094,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-C7NbU52Q.js").then((n) => n.n);
+				const { PwaCacheManager } = await import("./pwa-cache-manager-M3XsMhvz.js").then((n) => n.n);
 				await PwaCacheManager.clearCharacterCache(id);
 			}
 		}
@@ -4138,13 +4173,7 @@ var AvatarManager = class AvatarManager {
 	* @returns Avatar instance, or undefined if not in cache
 	*/
 	retrieve(id) {
-		const trace = startLoadTrace(id, Date.now(), { source: "cache" });
-		const cached = this.avatarCache.get(id);
-		trace.end(true, Date.now(), {
-			result: cached ? "hit" : "miss",
-			cache_hit: cached !== void 0
-		});
-		return cached;
+		return this.avatarCache.get(id);
 	}
 	/**
 	* Clear cached avatar for specified ID

package/dist/internal-telemetry.d.ts

@@ -60,3 +60,30 @@ export declare function startPlaybackTrace(conversationId: string, startTimeMs?:
  * dropped before it is sent.
  */
 export declare function recordMetric(name: string, value: number, attributes?: Attributes): void;
+/**
+ * Declare which SDK these records come from, as the `sdk.package` and
+ * `sdk.version` resource attributes.
+ *
+ * Without it every RTC record is attributed to the host SDK and carries the
+ * host's version, so the backend — which splits RTC traffic by exactly these
+ * fields — cannot tell an RTC session from a plain AvatarKit integration, and
+ * this SDK's own version is absent from the data entirely. The native SDKs
+ * declare the same pair, through a ContentProvider (Android) and a claim at
+ * construction (iOS).
+ *
+ * Each field applies independently: passing only one leaves the other as it
+ * was. The version overrides the Resource's `sdk.version`; instrumentation
+ * scope versions come from elsewhere and are unaffected.
+ *
+ * Must be called before `AvatarSDK.initialize()`: the values are read when the
+ * OTel Resource is built and are fixed from then on. Sharing a module graph
+ * with the host makes that ordering straightforward here, so unlike the native
+ * SDKs no rebuild of the signal providers is needed.
+ *
+ * @param identity - `sdkPackage` e.g. `spatius-web-rtc`; `sdkVersion` that
+ *   package's own version. Empty values are ignored.
+ */
+export declare function setSdkIdentity(identity: {
+    sdkPackage?: string;
+    sdkVersion?: string;
+}): void;

package/dist/internal-telemetry.js

@@ -1,5 +1,5 @@
-import { C as recordMetric$1, g as clockSync } from "./logger-BOpQ7u0w.js";
-import { a as startPlaybackTrace$1 } from "./otel-trace-Ct4T48nC.js";
+import { C as recordMetric$1, E as setSdkIdentity$1, g as clockSync } from "./logger-pANhsT4J.js";
+import { o as startPlaybackTrace$1 } from "./otel-trace-DBN8K91J.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.
@@ -66,5 +66,31 @@ function startPlaybackTrace(conversationId, startTimeMs, attrs = {}) {
 function recordMetric(name, value, attributes = {}) {
 	recordMetric$1(name, value, attributes);
 }
+/**
+* Declare which SDK these records come from, as the `sdk.package` and
+* `sdk.version` resource attributes.
+*
+* Without it every RTC record is attributed to the host SDK and carries the
+* host's version, so the backend — which splits RTC traffic by exactly these
+* fields — cannot tell an RTC session from a plain AvatarKit integration, and
+* this SDK's own version is absent from the data entirely. The native SDKs
+* declare the same pair, through a ContentProvider (Android) and a claim at
+* construction (iOS).
+*
+* Each field applies independently: passing only one leaves the other as it
+* was. The version overrides the Resource's `sdk.version`; instrumentation
+* scope versions come from elsewhere and are unaffected.
+*
+* Must be called before `AvatarSDK.initialize()`: the values are read when the
+* OTel Resource is built and are fixed from then on. Sharing a module graph
+* with the host makes that ordering straightforward here, so unlike the native
+* SDKs no rebuild of the signal providers is needed.
+*
+* @param identity - `sdkPackage` e.g. `spatius-web-rtc`; `sdkVersion` that
+*   package's own version. Empty values are ignored.
+*/
+function setSdkIdentity(identity) {
+	setSdkIdentity$1(identity);
+}
 //#endregion
-export { isClockCalibrated, recordMetric, resolveMonoTimestamp, startPlaybackTrace };
+export { isClockCalibrated, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };

package/dist/{logger-BOpQ7u0w.js → logger-pANhsT4J.js}

@@ -13509,6 +13509,38 @@ var OTLPMetricExporter = class extends OTLPMetricExporterBase {
 	}
 };
 //#endregion
+//#region utils/otel-identity.ts
+var sdkPackage = "spatius-web-sdk";
+var injectedSdkVersion = null;
+/**
+* 声明本次上报的归属身份。
+*
+* 与 Android `AvatarSDK.inject` 同语义:两个字段各自独立生效,只传其一时另一个
+* 保持原值。版本覆盖的是 Resource 上的 `sdk.version`(scope 上的版本号另有来源,
+* 不受影响)。
+*
+* @param identity - `sdkPackage` 形如 `spatius-web-rtc`;`sdkVersion` 为该包
+*   自身的版本。空值忽略,避免误清成空字符串后整批记录失去归属。
+* @internal
+*/
+function setSdkIdentity(identity) {
+	if (identity.sdkPackage) sdkPackage = identity.sdkPackage;
+	if (identity.sdkVersion) injectedSdkVersion = identity.sdkVersion;
+}
+/** 当前归属包名,供各通道构建 Resource 时读取。@internal */
+function getSdkPackage() {
+	return sdkPackage;
+}
+/**
+* Resource 上应上报的版本号。
+*
+* @param hostVersion - 主库自己的版本,未被上层 SDK 声明时用它。
+* @internal
+*/
+function resolveSdkVersion(hostVersion) {
+	return injectedSdkVersion ?? hostVersion;
+}
+//#endregion
 //#region utils/otel-metrics.ts
 /**
 * OpenTelemetry Metrics Tracker (Browser Version)
@@ -13888,9 +13920,9 @@ function initializeOtelMetrics(version, resourceAttrs) {
 		meterProvider = new MeterProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion$2,
+				"sdk.version": resolveSdkVersion(sdkVersion$2),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -14647,9 +14679,9 @@ function initializeOtel(version, resourceAttrs) {
 		loggerProvider = new LoggerProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion$1,
+				"sdk.version": resolveSdkVersion(sdkVersion$1),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -15539,7 +15571,7 @@ async function writeToLocalLog(message, level, extra = {}) {
 	try {
 		const { shouldPersist, sanitized } = sanitizeForLocalLog(message);
 		if (!shouldPersist) return;
-		const { AvatarSDK } = await import("./AvatarSDK-DgPvHU4L.js").then((n) => n.n);
+		const { AvatarSDK } = await import("./AvatarSDK-BbqaBxdV.js").then((n) => n.n);
 		const version = AvatarSDK.version;
 		const appId = idManager.getAppId();
 		const userId = idManager.getUserId();
@@ -15627,4 +15659,4 @@ function captureErrorContext(level, error) {
 	});
 }
 //#endregion
-export { isSpanContextValid as $, defaultResource as A, FrameStarvationMode as At, otperformance as B, recordMetric as C, ConnectionState as Ct, createResource as D, DEFAULT_REGION_REQUEST as Dt, createInstrumentationScope as E, DEFAULT_REGION as Et, hrTime as F, TransitionType as Ft, getNumberFromEnv as G, ATTR_EXCEPTION_STACKTRACE as H, hrTimeDuration as I, isTracingSuppressed as J, getStringFromEnv as K, isTimeInput as L, BindOnceFuture as M, LogLevel as Mt, ExportResultCode as N, RENDER_QUALITY_PARAMS as Nt, toAttributes$1 as O, DrivingServiceMode as Ot, addHrTimes as P, RenderQuality as Pt, context as Q, isTimeInputHrTime as R, recordHttpClientDuration as S, AvatarState as St, JSON_ENCODER as T, DEFAULT_OPUS_BITRATE as Tt, ATTR_EXCEPTION_TYPE as U, ATTR_EXCEPTION_MESSAGE as V, ATTR_SERVICE_NAME as W, trace as X, suppressTracing as Y, diag as Z, fetchBootstrap as _, isDebugMode as _t, clientContextFields as a, ROOT_CONTEXT as at, cleanupOtelMetrics as b, AnimationType as bt, logEvent as c, getGlobal as ct, cleanupOtel as d, OTEL_LOGS_ENDPOINT as dt, isValidTraceId as et, initializeOtel as f, OTEL_PASSWORD as ft, clockSync as g, OTEL_USERNAME as gt, resolveMarks as h, OTEL_TRACES_STREAM_NAME as ht, cleanupPostHog as i, createNoopMeter as it, resourceFromAttributes as j, LoadProgress as jt, OTLPExporterBase as k, ErrorCode as kt, logMetric as l, registerGlobal as lt, monoTimestamp as m, OTEL_TRACES_ENDPOINT as mt, setLogLevel as n, TraceFlags as nt, getLogsFeatureFlag as o, createContextKey as ot, monoMarkFrom as p, OTEL_STREAM_NAME as pt, globalErrorHandler as q, logSink as r, ContextAPI as rt, initializePostHog as s, DiagAPI as st, logger as t, INVALID_SPAN_CONTEXT as tt, updatePostHogPersonPropertiesForFlags as u, unregisterGlobal as ut, hostOf as v, idManager as vt, createLegacyOtlpBrowserExportDelegate as w, ConversationState as wt, initializeOtelMetrics as x, AvatarError as xt, observeExporter as y, generateTraceId as yt, millisToHrTime as z };
+export { trace as $, createResource as A, DEFAULT_REGION_REQUEST as At, isTimeInput as B, recordMetric as C, AnimationType as Ct, createLegacyOtlpBrowserExportDelegate as D, ConversationState as Dt, setSdkIdentity as E, ConnectionState as Et, BindOnceFuture as F, LogLevel as Ft, ATTR_EXCEPTION_STACKTRACE as G, millisToHrTime as H, ExportResultCode as I, RENDER_QUALITY_PARAMS as It, getNumberFromEnv as J, ATTR_EXCEPTION_TYPE as K, addHrTimes as L, RenderQuality as Lt, OTLPExporterBase as M, ErrorCode as Mt, defaultResource as N, FrameStarvationMode as Nt, JSON_ENCODER as O, DEFAULT_OPUS_BITRATE as Ot, resourceFromAttributes as P, LoadProgress as Pt, suppressTracing as Q, hrTime as R, TransitionType as Rt, recordHttpClientDuration as S, generateTraceId as St, resolveSdkVersion as T, AvatarState as Tt, otperformance as U, isTimeInputHrTime as V, ATTR_EXCEPTION_MESSAGE as W, globalErrorHandler as X, getStringFromEnv as Y, isTracingSuppressed as Z, fetchBootstrap as _, OTEL_TRACES_ENDPOINT as _t, clientContextFields as a, TraceFlags as at, cleanupOtelMetrics as b, isDebugMode as bt, logEvent as c, ROOT_CONTEXT as ct, cleanupOtel as d, getGlobal as dt, diag as et, initializeOtel as f, registerGlobal as ft, clockSync as g, OTEL_STREAM_NAME as gt, resolveMarks as h, OTEL_PASSWORD as ht, cleanupPostHog as i, INVALID_SPAN_CONTEXT as it, toAttributes$1 as j, DrivingServiceMode as jt, createInstrumentationScope as k, DEFAULT_REGION as kt, logMetric as l, createContextKey as lt, monoTimestamp as m, OTEL_LOGS_ENDPOINT as mt, setLogLevel as n, isSpanContextValid as nt, getLogsFeatureFlag as o, ContextAPI as ot, monoMarkFrom as p, unregisterGlobal as pt, ATTR_SERVICE_NAME as q, logSink as r, isValidTraceId as rt, initializePostHog as s, createNoopMeter as st, logger as t, context as tt, updatePostHogPersonPropertiesForFlags as u, DiagAPI as ut, hostOf as v, OTEL_TRACES_STREAM_NAME as vt, getSdkPackage as w, AvatarError as wt, initializeOtelMetrics as x, idManager as xt, observeExporter as y, OTEL_USERNAME as yt, hrTimeDuration as z };

package/dist/{otel-trace-Ct4T48nC.js → otel-trace-DBN8K91J.js}

@@ -1,4 +1,4 @@
-import { $ as isSpanContextValid, A as defaultResource, B as otperformance, D as createResource, E as createInstrumentationScope, F as hrTime, G as getNumberFromEnv, H as ATTR_EXCEPTION_STACKTRACE, I as hrTimeDuration, J as isTracingSuppressed, K as getStringFromEnv, L as isTimeInput, M as BindOnceFuture, N as ExportResultCode, O as toAttributes, P as addHrTimes, Q as context, R as isTimeInputHrTime, T as JSON_ENCODER, U as ATTR_EXCEPTION_TYPE, V as ATTR_EXCEPTION_MESSAGE, W as ATTR_SERVICE_NAME, X as trace, Y as suppressTracing, Z as diag$1, a as clientContextFields, at as ROOT_CONTEXT, ct as getGlobal, et as isValidTraceId, ft as OTEL_PASSWORD, gt as OTEL_USERNAME, ht as OTEL_TRACES_STREAM_NAME, it as createNoopMeter, j as resourceFromAttributes, k as OTLPExporterBase, lt as registerGlobal, mt as OTEL_TRACES_ENDPOINT, nt as TraceFlags, ot as createContextKey, q as globalErrorHandler, rt as ContextAPI, st as DiagAPI, t as logger, tt as INVALID_SPAN_CONTEXT, ut as unregisterGlobal, vt as idManager, w as createLegacyOtlpBrowserExportDelegate, y as observeExporter, z as millisToHrTime } from "./logger-BOpQ7u0w.js";
+import { $ as trace, A as createResource, B as isTimeInput, D as createLegacyOtlpBrowserExportDelegate, F as BindOnceFuture, G as ATTR_EXCEPTION_STACKTRACE, H as millisToHrTime, I as ExportResultCode, J as getNumberFromEnv, K as ATTR_EXCEPTION_TYPE, L as addHrTimes, M as OTLPExporterBase, N as defaultResource, O as JSON_ENCODER, P as resourceFromAttributes, Q as suppressTracing, R as hrTime, T as resolveSdkVersion, U as otperformance, V as isTimeInputHrTime, W as ATTR_EXCEPTION_MESSAGE, X as globalErrorHandler, Y as getStringFromEnv, Z as isTracingSuppressed, _t as OTEL_TRACES_ENDPOINT, a as clientContextFields, at as TraceFlags, ct as ROOT_CONTEXT, dt as getGlobal, et as diag$1, ft as registerGlobal, ht as OTEL_PASSWORD, it as INVALID_SPAN_CONTEXT, j as toAttributes, k as createInstrumentationScope, lt as createContextKey, nt as isSpanContextValid, ot as ContextAPI, pt as unregisterGlobal, q as ATTR_SERVICE_NAME, rt as isValidTraceId, st as createNoopMeter, t as logger, tt as context, ut as DiagAPI, vt as OTEL_TRACES_STREAM_NAME, w as getSdkPackage, xt as idManager, y as observeExporter, yt as OTEL_USERNAME, z as hrTimeDuration } from "./logger-pANhsT4J.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) {
@@ -2321,9 +2321,9 @@ function initializeOtelTrace(version, resourceAttrs) {
 		tracerProvider = new WebTracerProvider({
 			resource: resourceFromAttributes({
 				[ATTR_SERVICE_NAME]: "avatarkit",
-				"sdk.version": sdkVersion,
+				"sdk.version": resolveSdkVersion(sdkVersion),
 				"sdk.platform": "web",
-				"sdk.package": "spatius-web-sdk",
+				"sdk.package": getSdkPackage(),
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm,
@@ -2399,7 +2399,7 @@ function startInitTrace(sessionId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) sp.setStatus({ code: SpanStatusCode.ERROR });
-					sp.end(endMs);
+					sp.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -2436,7 +2436,7 @@ function startLoadTrace(avatarId, startTimeMs, attrs = {}) {
 						attributes: spanAttrs
 					}, rootCtx);
 					if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
-					s.end(endMs);
+					s.end(Math.max(endMs, startMs + 1));
 				} catch {}
 			},
 			group: () => NOOP_GROUP,
@@ -2454,6 +2454,52 @@ function startLoadTrace(avatarId, startTimeMs, attrs = {}) {
 	}
 }
 /**
+* 开一条建连 trace。root span 名 `connect`，下挂 `ws_handshake` / `session_confirm` 两段。
+*
+* 与 `ws_connect_latency` 互补：那条 metric 只给出总耗时，而慢在哪一段——TLS/网络握手，
+* 还是服务端校验 token、分配资源——只有拆开才看得出。两段的边界就是 `onopen`。
+*
+* 与 load / playback 是三条独立 trace，靠 session_id 关联。
+* @param startTimeMs root span 起点（发起连接那一刻，epoch ms）。
+* @internal
+*/
+function startConnectTrace(startTimeMs, attrs = {}) {
+	if (!tracer || !tracerProvider) return NOOP_TRACE;
+	try {
+		const root = tracer.startSpan("connect", {
+			startTime: startTimeMs,
+			attributes: {
+				session_id: idManager.getSessionId(),
+				...attrs
+			}
+		}, ROOT_CONTEXT);
+		const rootCtx = trace.setSpan(ROOT_CONTEXT, root);
+		return {
+			span(name, startMs, endMs, spanAttrs = {}, isError = false) {
+				try {
+					const s = tracer.startSpan(name, {
+						startTime: startMs,
+						attributes: spanAttrs
+					}, rootCtx);
+					if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
+					s.end(Math.max(endMs, startMs + 1));
+				} catch {}
+			},
+			group: () => NOOP_GROUP,
+			end(ok = true, endTimeMs, endAttrs = {}) {
+				try {
+					for (const [k, v] of Object.entries(endAttrs)) root.setAttribute(k, v);
+					root.setStatus({ code: ok ? SpanStatusCode.OK : SpanStatusCode.ERROR });
+					root.end(endTimeMs);
+				} catch {}
+			}
+		};
+	} catch (error) {
+		logger.warn("[OTel-Trace] Failed to start connect trace:", error instanceof Error ? error.message : String(error));
+		return NOOP_TRACE;
+	}
+}
+/**
 * 开一条播放 trace。root span 名 `playback`，trace_id 由 conversation_id 确定性派生，
 * conversation_id 同时作为 span 属性（无论是否与后端串成一条 trace，都能按它关联查询）。
 * @param startTimeMs root span 起点（首包音频 tap_0 的真实时刻，epoch ms）；省略则用当前时刻。
@@ -2497,7 +2543,7 @@ function startPlaybackTrace(conversationId, startTimeMs, attrs = {}) {
 					startTime: startMs
 				}, ctx);
 				if (isError) s.setStatus({ code: SpanStatusCode.ERROR });
-				s.end(endMs);
+				s.end(Math.max(endMs, startMs + 1));
 			} catch {}
 		};
 		return {
@@ -2562,4 +2608,4 @@ function cleanupOtelTrace() {
 	}
 }
 //#endregion
-export { startPlaybackTrace as a, startLoadTrace as i, initializeOtelTrace as n, buildTraceparent as o, startInitTrace as r, cleanupOtelTrace as t };
+export { startLoadTrace as a, startInitTrace as i, initializeOtelTrace as n, startPlaybackTrace as o, startConnectTrace as r, buildTraceparent as s, cleanupOtelTrace as t };

package/dist/{pwa-cache-manager-C7NbU52Q.js → pwa-cache-manager-M3XsMhvz.js}

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit — real-time, audio-driven avatar rendering SDK for Web.",
   "homepage": "https://spatius.ai/",