@spatius/avatarkit 1.3.6 → 1.3.7

package/CHANGELOG.md

@@ -5,6 +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.7] - 2026-08-17
+
+### Fixed
+- Internal telemetry only, no change to public API or runtime behaviour: diagnostic records now carry this SDK's own version alongside the reporting one. A companion SDK built on top of this one declares its own identity, which replaced the version outright, so records from those integrations gave no indication of which renderer produced them.
+- Internal telemetry only, no change to public API or runtime behaviour: the client environment fields (page host, locale, screen and viewport size) are now available to companion SDKs, whose records previously carried none of them.
+
 ## [1.3.6] - 2026-08-15
 
 ### Fixed

package/dist/index.js

@@ -1,5 +1,5 @@
 import { n as __toESM, t as __commonJSMin } from "./rolldown-runtime-FDOR9p9I.js";
-import { $ as DEFAULT_REGION, A as clockSync, B as OTEL_LOGS_ENDPOINT, C as logMetric, D as monoMarkFrom, E as initializeOtel, F as recordHttpClientDuration, G as idManager, H as OTEL_STREAM_NAME, I as recordMetric, J as AvatarError, K as generateTraceId, L as getSdkPackage, M as hostOf, N as cleanupOtelMetrics, O as monoTimestamp, P as initializeOtelMetrics, Q as DEFAULT_OPUS_BITRATE, R as resolveSdkVersion, S as logEvent, T as cleanupOtel, U as OTEL_USERNAME, V as OTEL_PASSWORD, W as isDebugMode, X as ConnectionState, Y as AvatarState, Z as ConversationState, _ as logSink, a as startLoadTrace, at as LogLevel, b as getLogsFeatureFlag, c as AudioFormat, ct as TransitionType, d as MessageType, et as DEFAULT_REGION_REQUEST, f as TransportCompression, g as setLogLevel, h as logger, i as startInitTrace, it as LoadProgress, j as fetchBootstrap, k as resolveMarks, l as EgressType, lt as requireSDK, m as BinaryWriter, n as initializeOtelTrace, nt as ErrorCode, o as startPlaybackTrace, ot as RENDER_QUALITY_PARAMS, p as BinaryReader, q as AnimationType, r as startConnectTrace, rt as FrameStarvationMode, s as buildTraceparent, st as RenderQuality, t as cleanupOtelTrace, tt as DrivingServiceMode, u as Message, ut as setSDKRef, v as cleanupPostHog, w as updatePostHogPersonPropertiesForFlags, x as initializePostHog, y as clientContextFields } from "./otel-trace-B4E2lODB.js";
+import { $ as DEFAULT_REGION, A as clockSync, B as OTEL_LOGS_ENDPOINT, C as logMetric, D as monoMarkFrom, E as initializeOtel, F as recordHttpClientDuration, G as idManager, H as OTEL_STREAM_NAME, I as recordMetric, J as AvatarError, K as generateTraceId, L as getSdkPackage, M as hostOf, N as cleanupOtelMetrics, O as monoTimestamp, P as initializeOtelMetrics, Q as DEFAULT_OPUS_BITRATE, R as resolveSdkVersion, S as logEvent, T as cleanupOtel, U as OTEL_USERNAME, V as OTEL_PASSWORD, W as isDebugMode, X as ConnectionState, Y as AvatarState, Z as ConversationState, _ as logSink, a as startLoadTrace, at as LogLevel, b as getLogsFeatureFlag, c as AudioFormat, ct as TransitionType, d as MessageType, et as DEFAULT_REGION_REQUEST, f as TransportCompression, g as setLogLevel, h as logger, i as startInitTrace, it as LoadProgress, j as fetchBootstrap, k as resolveMarks, l as EgressType, lt as requireSDK, m as BinaryWriter, n as initializeOtelTrace, nt as ErrorCode, o as startPlaybackTrace, ot as RENDER_QUALITY_PARAMS, p as BinaryReader, q as AnimationType, r as startConnectTrace, rt as FrameStarvationMode, s as buildTraceparent, st as RenderQuality, t as cleanupOtelTrace, tt as DrivingServiceMode, u as Message, ut as setSDKRef, v as cleanupPostHog, w as updatePostHogPersonPropertiesForFlags, x as initializePostHog, y as clientContextFields } from "./otel-trace-Y_BtH06z.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -45730,7 +45730,7 @@ var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.6";
+	static _version = "1.3.7";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;

package/dist/internal-telemetry.d.ts

@@ -79,6 +79,24 @@ export declare function peekTraceparent(rawMessage: Uint8Array): string | undefi
  * dropped before it is sent.
  */
 export declare function recordMetric(name: string, value: number, attributes?: Attributes): void;
+/**
+ * The client environment fields this SDK stamps on every OTel log record —
+ * `host`, `domain`, `url`, `pathname`, `referrer`, `user_agent`, `locale`,
+ * screen/viewport size and `timezone`.
+ *
+ * Shared with the RTC SDK rather than re-derived there. These are record-level
+ * fields, not Resource attributes: they are read from `window.location` at emit
+ * time because `url`/`pathname` change as a single-page app routes. Sharing the
+ * OTel providers therefore does not carry them across — the RTC SDK emits
+ * through its own logger and would report no `host` at all, which is what
+ * prompted this export. Re-implementing the collection on that side would let
+ * the two drift apart in field names and in how each value is read, and the
+ * backend aggregates on exactly these names.
+ *
+ * Call at emit time, once per record; spread the result before the caller's own
+ * properties so an explicit value at the call site still wins.
+ */
+export declare function clientContextFields(): Record<string, string | number>;
 /**
  * Declare which SDK these records come from, as the `sdk.package` and
  * `sdk.version` resource attributes.

package/dist/internal-telemetry.js

@@ -1,4 +1,4 @@
-import { A as clockSync, I as recordMetric$1, o as startPlaybackTrace$1, u as Message, z as setSdkIdentity$1 } from "./otel-trace-B4E2lODB.js";
+import { A as clockSync, I as recordMetric$1, o as startPlaybackTrace$1, u as Message, y as clientContextFields$1, z as setSdkIdentity$1 } from "./otel-trace-Y_BtH06z.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.
@@ -91,6 +91,26 @@ function recordMetric(name, value, attributes = {}) {
 	recordMetric$1(name, value, attributes);
 }
 /**
+* The client environment fields this SDK stamps on every OTel log record —
+* `host`, `domain`, `url`, `pathname`, `referrer`, `user_agent`, `locale`,
+* screen/viewport size and `timezone`.
+*
+* Shared with the RTC SDK rather than re-derived there. These are record-level
+* fields, not Resource attributes: they are read from `window.location` at emit
+* time because `url`/`pathname` change as a single-page app routes. Sharing the
+* OTel providers therefore does not carry them across — the RTC SDK emits
+* through its own logger and would report no `host` at all, which is what
+* prompted this export. Re-implementing the collection on that side would let
+* the two drift apart in field names and in how each value is read, and the
+* backend aggregates on exactly these names.
+*
+* Call at emit time, once per record; spread the result before the caller's own
+* properties so an explicit value at the call site still wins.
+*/
+function clientContextFields() {
+	return clientContextFields$1();
+}
+/**
 * Declare which SDK these records come from, as the `sdk.package` and
 * `sdk.version` resource attributes.
 *
@@ -117,4 +137,4 @@ function setSdkIdentity(identity) {
 	setSdkIdentity$1(identity);
 }
 //#endregion
-export { isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };
+export { clientContextFields, isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };

package/dist/{otel-trace-B4E2lODB.js → otel-trace-Y_BtH06z.js}

@@ -14960,6 +14960,7 @@ function initializeOtelMetrics(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion$3),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion$3,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -15718,6 +15719,7 @@ function initializeOtel(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion$2),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion$2,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm
@@ -20389,6 +20391,7 @@ function initializeOtelTrace(version, resourceAttrs) {
 				"sdk.version": resolveSdkVersion(sdkVersion),
 				"sdk.platform": "web",
 				"sdk.package": getSdkPackage(),
+				"render_sdk_version": sdkVersion,
 				"app_id": resourceAttrs.appId || "",
 				"region": resourceAttrs.region,
 				"dsm": resourceAttrs.dsm,

package/package.json

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