@mega-yfue/eufy-sdk 0.5.0-beta.60 → 0.5.0-beta.62

package/dist/transport/p2p/command-router.d.ts

@@ -509,11 +509,11 @@ export declare class P2PCommandRouter {
      */
     private onLiveStartFailed;
     /**
-     * Replace the session under a warming source whose media start nothing acknowledged, and warm again on it.
+     * Replace the session under a warming source it is not serving, and warm again on it.
      *
      * Only a STANDALONE device's session is replaced, for the reason {@link onLiveStartFailed} gives: an attached
      * camera shares its HomeBase session with every other camera on it, and closing that to recover one would
-     * drop the rest. Such a source keeps the re-issue it always had.
+     * drop the rest. Such a source keeps the re-issue it always had, which the answer (false) tells it.
      *
      * The source is left warming throughout, holding the deadline it started, so this either produces a stream
      * within that window or fails exactly as it would have. A replacement that cannot be opened leaves the

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

@@ -83,12 +83,13 @@ export interface SharedLiveSourceOptions {
      */
     onStopped?: () => void;
     /**
-     * A media start was abandoned unacknowledged before anything was delivered, so this session is not being
-     * heard. The owner is asked for a replacement and calls {@link SharedLiveSource.rewarm} once it has one.
+     * This session is not serving the warm-up: a media start was abandoned unacknowledged, or forced starts went
+     * unanswered by any media, before anything was delivered. The owner answers whether it is replacing the
+     * session, and calls {@link SharedLiveSource.rewarm} once it has the replacement.
      *
-     * Asked at most once per warm-up: further abandonments are the same session saying the same thing.
+     * Asked at most once per warm-up: further evidence is the same session saying the same thing.
      */
-    onSessionUnreachable?: () => void;
+    onSessionUnreachable?: () => boolean;
 }
 /**
  * A single consumer of a {@link SharedLiveSource}. A {@link LiveStreamConsumer} (so `live()` can hand it
@@ -251,18 +252,17 @@ export declare class SharedLiveSource {
      */
     private warm;
     /**
-     * A start was abandoned unacknowledged. Ask for a replacement session where nothing has been delivered yet.
+     * Ask the owner for a replacement session where nothing has been delivered yet, answering whether one is coming.
      *
-     * The abandonment is roughly twenty byte-identical sends with no reply, against acknowledgement latencies of
-     * 4–37 ms awake and 238 ms waking, so it is the session that is not being heard rather than a slow device —
-     * `P2PSession` says as much: the camera was never told to stream, so this warm-up can only time out. Where
-     * media has already flowed the abandonment means something else and this does nothing.
+     * An unacknowledged start is roughly twenty byte-identical sends with no reply, against acknowledgement latencies
+     * of 4–37 ms awake and 238 ms waking, so it is the session that is not being heard rather than a slow device: the
+     * camera was never told to stream. Where media has already flowed the abandonment means something else and this
+     * does nothing. The DEADLINE is left running: the window belongs to the attempt, not to the session it started on.
      *
-     * The retry ticker is stopped while a replacement is awaited, because every tick it issues goes to the same
-     * unheard session. The DEADLINE is left running: the window belongs to the attempt, not to the session it
-     * started on.
+     * The retry ticker is stopped only once the owner has said it is replacing the session: an owner that cannot
+     * (an attached camera shares its HomeBase session) leaves the source re-issuing as it always did.
      */
-    private onStartUnacknowledged;
+    private askForFreshSession;
     /**
      * Warm again on a session the owner has replaced, inside the deadline the first attempt started.
      *
@@ -290,6 +290,11 @@ export declare class SharedLiveSource {
      * {@link fruitlessReissues} for why one is not enough and why what the stream delivered earlier is not
      * evidence. Once media arrives the keepalive is what is wanted, and an attached camera re-sends a full start
      * either way.
+     *
+     * A forced start that a whole interval later has still produced nothing is a session that acknowledges and
+     * does not serve: a fresh session on the same camera delivers a keyframe within a second, so a warm-up asks
+     * for one rather than forcing starts onto this one until its deadline. Wired only: a cold battery camera is
+     * slow rather than deaf, measured at about 8 s to first media, and replacing its session would cost a wake.
      */
     private reissueStart;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.60",
+  "version": "0.5.0-beta.62",
   "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",