@spatius/avatarkit 1.3.4 → 1.3.5

package/dist/internal-telemetry.d.ts

@@ -48,7 +48,26 @@ export interface SpanGroup {
  * what lets the backend's spans join a round without threading state through;
  * reproducing that separately would mean two definitions of one wire contract.
  */
-export declare function startPlaybackTrace(conversationId: string, startTimeMs?: number, attrs?: Attributes): PlaybackTrace;
+export declare function startPlaybackTrace(conversationId: string, startTimeMs?: number, attrs?: Attributes, serverTraceparent?: string): PlaybackTrace;
+/**
+ * Read the W3C traceparent the driving service stamped on an animation
+ * message, without decoding its frames. Undefined when the message carries
+ * none, or is not parseable.
+ *
+ * For transports that hand the SDK an opaque animation payload and never see a
+ * request id — RTC being the case this exists for. There the round's id is
+ * minted locally and never travels upstream, so a trace_id derived from it has
+ * nothing to do with the server's, and one round reports as two unrelated
+ * traces. The traceparent riding the animation is what joins them; pass the
+ * result to `startPlaybackTrace`.
+ *
+ * Kept separate from decoding rather than folded into it: callers need this
+ * once per round while frames are decoded continuously.
+ *
+ * @param rawMessage the same bytes handed to the renderer — a serialized
+ *   `driveningress.v2.Message`.
+ */
+export declare function peekTraceparent(rawMessage: Uint8Array): string | undefined;
 /**
  * Record one measurement onto avatarkit's metric pipeline.
  *

package/dist/internal-telemetry.js

@@ -1,5 +1,4 @@
-import { C as recordMetric$1, E as setSdkIdentity$1, g as clockSync } from "./logger-B_tTFAYq.js";
-import { o as startPlaybackTrace$1 } from "./otel-trace-DmmQrXv-.js";
+import { A as clockSync, I as recordMetric$1, o as startPlaybackTrace$1, u as Message, z as setSdkIdentity$1 } from "./otel-trace-CdspSqI0.js";
 //#region internal-telemetry.ts
 /**
 * Internal telemetry surface for the companion RTC SDK.
@@ -50,8 +49,33 @@ function isClockCalibrated() {
 * what lets the backend's spans join a round without threading state through;
 * reproducing that separately would mean two definitions of one wire contract.
 */
-function startPlaybackTrace(conversationId, startTimeMs, attrs = {}) {
-	return startPlaybackTrace$1(conversationId, startTimeMs, attrs);
+function startPlaybackTrace(conversationId, startTimeMs, attrs = {}, serverTraceparent) {
+	return startPlaybackTrace$1(conversationId, startTimeMs, attrs, serverTraceparent);
+}
+/**
+* Read the W3C traceparent the driving service stamped on an animation
+* message, without decoding its frames. Undefined when the message carries
+* none, or is not parseable.
+*
+* For transports that hand the SDK an opaque animation payload and never see a
+* request id — RTC being the case this exists for. There the round's id is
+* minted locally and never travels upstream, so a trace_id derived from it has
+* nothing to do with the server's, and one round reports as two unrelated
+* traces. The traceparent riding the animation is what joins them; pass the
+* result to `startPlaybackTrace`.
+*
+* Kept separate from decoding rather than folded into it: callers need this
+* once per round while frames are decoded continuously.
+*
+* @param rawMessage the same bytes handed to the renderer — a serialized
+*   `driveningress.v2.Message`.
+*/
+function peekTraceparent(rawMessage) {
+	try {
+		return Message.decode(rawMessage).serverResponseAnimation?.traceContext?.traceparent || void 0;
+	} catch {
+		return;
+	}
 }
 /**
 * Record one measurement onto avatarkit's metric pipeline.
@@ -93,4 +117,4 @@ function setSdkIdentity(identity) {
 	setSdkIdentity$1(identity);
 }
 //#endregion
-export { isClockCalibrated, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };
+export { isClockCalibrated, peekTraceparent, recordMetric, resolveMonoTimestamp, setSdkIdentity, startPlaybackTrace };