@spatius/avatarkit 1.3.4-beta.1 → 1.3.5-beta.1

package/CHANGELOG.md

@@ -5,11 +5,12 @@ 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.4-beta.1] - 2026-08-10
+## [1.3.4] - 2026-08-11
 
 ### Fixed
 - **The Opus uplink encoder now actually runs off the main thread.** Asset URLs were emitted as absolute paths (`/assets/…`), so any app not served from the domain root — a Vite dev server included — got HTML back for the worker request. The SDK logged `Worker unavailable, falling back to main-thread encode` and encoded every chunk on the main thread, stalling rendering for the whole of playback. URLs are now relative to the referencing chunk.
 - **Next.js builds no longer fail on the Opus workers.** `withAvatarkit` now copies the pre-built workers (and the sibling chunks they import) into `public/assets/`, and tells webpack to leave those files alone. Previously the bundler re-processed the ESM worker and Terser rejected it with `'import' and 'export' cannot be used outside of module code`, breaking `next build` outright on 1.3.1 and later.
+- Internal telemetry only, no change to public API or runtime behaviour: `http.client.request.duration` no longer records a data point when an asset is served entirely from cache. Those entries carried a hardcoded `statusCode=200` and an empty `server.address`, and their sub-millisecond durations skewed the real network latency distribution. Cache hit rate and cache-hit latency remain available through `download_avatar_assets_latency` and `template_resources_load_measure`, both of which carry `cache_hit` and `cache_type`.
 
 ## [1.3.3] - 2026-08-08
 

package/dist/{AvatarDownloader-BZWkn3GG.js → AvatarDownloader-BLERPef7.js}

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-B-1-B7_t.js";
-import { t as AvatarSDK } from "./AvatarSDK-kP9209qH.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-B-m_sm-g.js";
-import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-CSFsFRMn.js";
-import { t as PwaCacheManager } from "./pwa-cache-manager-DYYf1j5t.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-BCrlTIt2.js";
+import { n as APP_CONFIG, r as getFlameCdnBase, t as errorToMessage } from "./error-utils-CX5P3vnW.js";
+import { t as AvatarSDK } from "./AvatarSDK-DCYDBMwd.js";
+import { t as PwaCacheManager } from "./pwa-cache-manager-C7su6HpW.js";
 //#region core/AvatarDownloader.ts
 var AvatarDownloader_exports = /* @__PURE__ */ __exportAll({ AvatarDownloader: () => AvatarDownloader });
 /**
@@ -167,7 +167,8 @@ var AvatarDownloader = class {
 			logMetric("template_resources_load_measure", duration, {
 				file_count: 1,
 				cache_hit: true,
-				cache_type: "pwa"
+				cache_type: "pwa",
+				result: "success"
 			});
 			return { unifiedModel: cached };
 		}
@@ -193,7 +194,8 @@ var AvatarDownloader = class {
 				logMetric("template_resources_load_measure", Date.now() - startTime, {
 					file_count: 1,
 					cache_hit: false,
-					cache_type: "none"
+					cache_type: "none",
+					result: "success"
 				});
 				recordAssetTransaction(templateOutcomes, Date.now() - startTime, TEMPLATE_OPERATION);
 				return { unifiedModel: buffer };
@@ -203,6 +205,16 @@ var AvatarDownloader = class {
 			}
 		}
 		recordAssetTransaction(templateOutcomes, Date.now() - startTime, TEMPLATE_OPERATION);
+		const lastStatus = templateOutcomes[0]?.statusCode;
+		logMetric("template_resources_load_measure", Date.now() - startTime, {
+			file_count: 1,
+			cache_hit: false,
+			cache_type: "none",
+			result: lastStatus !== void 0 && lastStatus >= 200 && lastStatus < 400 ? "decode_failed" : "download_failed"
+		}, {
+			description: lastError?.message ?? "unknown",
+			...lastStatus !== void 0 ? { last_status_code: lastStatus } : {}
+		});
 		throw lastError || /* @__PURE__ */ new Error(`Failed to download unified template after ${maxRetries} attempts`);
 	}
 	/**
@@ -333,6 +345,19 @@ var AvatarDownloader = class {
 		});
 		try {
 			await Promise.all(downloadPromises);
+		} catch (error) {
+			if (!(error instanceof Error && (error.name === "AbortError" || error.message === "Download cancelled"))) logMetric("download_avatar_assets_latency", Date.now() - totalStartTime, {
+				resolution: "default",
+				use_compressed_model: useCompressedModel,
+				file_count: filesToLoad.length,
+				cache_hit: false,
+				cache_type: "none",
+				result: "download_failed"
+			}, {
+				avatar_id: characterMeta.characterId ?? "unknown",
+				description: error instanceof Error ? error.message : String(error)
+			});
+			throw error;
 		} finally {
 			recordAssetTransaction(httpOutcomes, Date.now() - totalStartTime);
 		}
@@ -340,6 +365,17 @@ var AvatarDownloader = class {
 		const totalDuration = Date.now() - totalStartTime;
 		if (!characterData.shape || !characterData.pointCloud) {
 			const reason = "Failed to load character data";
+			logMetric("download_avatar_assets_latency", totalDuration, {
+				resolution: "default",
+				use_compressed_model: useCompressedModel,
+				file_count: filesToLoad.length,
+				cache_hit: false,
+				cache_type: "none",
+				result: "incomplete_data"
+			}, {
+				avatar_id: characterMeta.characterId ?? "unknown",
+				description: reason
+			});
 			logEvent("download_avatar_assets_failed", "error", {
 				avatar_id: characterMeta.characterId ?? "unknown",
 				description: reason
@@ -356,7 +392,8 @@ var AvatarDownloader = class {
 			use_compressed_model: useCompressedModel,
 			file_count: filesToLoad.length,
 			cache_hit: cacheHit,
-			cache_type: cacheType
+			cache_type: cacheType,
+			result: "success"
 		}, {
 			avatar_id: characterMeta.characterId ?? "unknown",
 			parallel_duration: parallelDuration,
@@ -532,7 +569,7 @@ var AvatarDownloader = class {
 				const firstError = response.errors[0];
 				throw new AvatarError(`${firstError.code || firstError.status || "SERVER_ERROR"}: ${firstError.detail || firstError.title || firstError.message || "Unknown server error"}`, ErrorCode.failedToFetchAvatarMetadata);
 			}
-			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, {}, {
+			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: "success" }, {
 				avatar_id: characterId,
 				trace_id: traceId
 			});
@@ -547,6 +584,11 @@ var AvatarDownloader = class {
 			}
 			logger.error("Failed to fetch character:", error);
 			if (error instanceof AvatarError) {
+				logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: error.code }, {
+					avatar_id: characterId,
+					trace_id: traceId,
+					description: error.message
+				});
 				logEvent("fetch_avatar_metadata_failed", "error", {
 					avatar_id: characterId ?? "unknown",
 					description: error.message,
@@ -556,6 +598,11 @@ var AvatarDownloader = class {
 			}
 			const errorMessage = error && typeof error === "object" && "message" in error ? String(error.message) : "Failed to fetch character";
 			const dataMessage = error && typeof error === "object" && "data" in error && typeof error.data === "object" && error.data?.message ? String(error.data.message) : null;
+			logMetric("fetch_avatar_metadata_latency", Date.now() - startTime, { result: "network_error" }, {
+				avatar_id: characterId,
+				trace_id: traceId,
+				description: dataMessage || errorMessage
+			});
 			logEvent("fetch_avatar_metadata_failed", "error", {
 				avatar_id: characterId ?? "unknown",
 				description: dataMessage || errorMessage,