@mega-yfue/eufy-sdk 0.5.0-beta.79 → 0.5.0-beta.80

package/dist/transport/p2p/live-trace.d.ts

@@ -11,6 +11,7 @@
  *
  * @module p2p/live-trace
  */
+import type { LiveStreamStartFailureReason, LiveStreamStartStage } from "../../core/contracts.js";
 import type { Logger } from "../../core/logger.js";
 /** The message every startup trace is logged under. */
 export declare const LIVE_TRACE_MESSAGE = "[live] start trace";
@@ -245,6 +246,19 @@ export type LiveTrace =
     phase: "channel-silent";
     silentMs: number;
     outcome: "reasserted" | "declined";
+}
+/**
+ * A live start failed, with the facts of the `LiveStreamStartError` it was refused with.
+ *
+ * `errorName` is the upstream error's class name, present for `source-error` only; its message is never
+ * carried, because an upstream message can name a station.
+ */
+ | {
+    phase: "start-failed";
+    reason: LiveStreamStartFailureReason;
+    stage: LiveStreamStartStage;
+    attempts: number;
+    errorName?: string;
 };
 /**
  * Record one startup observation at debug level.

package/dist/transport/p2p/shared-live-source.d.ts

@@ -343,7 +343,8 @@ export declare class SharedLiveSource {
      * at all, audio without a single video frame, or access units a decoder cannot begin at.
      *
      * Video takes precedence when both arrived: audio alongside video says nothing a caller needs, while video
-     * without a keyframe does.
+     * without a keyframe does. Every failed start is built here, so this is where its `start-failed` trace is
+     * emitted.
      */
     private startFailure;
     private onVideo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.79",
+  "version": "0.5.0-beta.80",
   "description": "One typed TypeScript client for the Anker eufy v6 cloud — capability-driven devices, realtime events over P2P/MQTT/push, and live media",
   "license": "Apache-2.0",
   "author": "mega-yfue",