@mega-yfue/eufy-sdk 0.2.0-beta.10 → 0.2.0-beta.11

package/dist/client/eufy-mega.d.ts

@@ -393,9 +393,9 @@ export declare class EufyMega extends EventEmitter {
     /**
      * Combine explicit P2P media with the optional passive push-thumbnail provider.
      *
-     * The retained still also becomes the answer for a live still that could not be captured. A station
-     * serves one camera at a time and a live view outranks a tile, so a still asked for while a sibling is
-     * being watched is refused at the transport. Answering the retained bytes answers the read rather than
+     * The retained still also becomes the answer for a live still that could not be captured. One session
+     * serves one camera at a time and a live view outranks a tile — a still does not open a connection of its
+     * own — so a still asked for while a sibling is being watched is refused at the transport. Answering the retained bytes answers the read rather than
      * failing it, marked {@link MediaProvider.snapshotLive} `retained` so the caller knows they are not
      * current. With nothing retained the refusal stands.
      */
@@ -752,10 +752,15 @@ export declare class EufyMega extends EventEmitter {
      */
     private sendRealtimeInit;
     /**
-     * Stations with a live P2P session. P2P is auto-managed: wired stations are warmed at login, battery
+     * The open P2P sessions, by key. P2P is auto-managed: wired stations are warmed at login, battery
      * stations open on demand (command / stream, or an opted-in event pre-warm) and idle-detach — so this
-     * map grows and shrinks over time. `p2pConnect(stationSn)` / `p2pClose(stationSn)` events track the
-     * changes.
+     * map grows and shrinks over time.
+     *
+     * A station's own session is keyed by its serial, and `p2pConnect(stationSn)` / `p2pClose(stationSn)`
+     * track those. A station serving more than one camera at once also holds a session per extra camera,
+     * keyed `<stationSn>#live:<channel>` — these carry media alone and raise no connection events, because
+     * a station announces its state to every client that connects and reporting each copy would double
+     * every event the station's own session already delivers.
      */
     getP2pSessions(): Map<string, P2PSession>;
     /**

package/dist/core/contracts.d.ts

@@ -129,32 +129,6 @@ export declare class StationUnreachableError extends Error {
         cause?: unknown;
     });
 }
-/**
- * A live stream was refused: the station is already serving another of its cameras to a viewer.
- *
- * A station fans several cameras out over one session and serves ONE of them at a time. Accepting a second
- * live pull does not make it serve two: measured on a base carrying three attached cameras, each opened
- * stream took the station from the others in turn and all three received their media in bursts. So a second
- * viewer is refused rather than admitted and degraded, which is the difference between a caller being told
- * the constraint and a caller watching every picture stutter.
- *
- * Which camera deserves the station is the caller's decision, not the SDK's, so nothing is queued or
- * pre-empted here.
- *
- * A still is not refused: it yields the station instead, and answers with the retained image where one is
- * held. Only pulls that deliver continuous media contend for a viewer's place.
- */
-export declare class StationBusyError extends Error {
-    /** The channel the station is already serving. */
-    readonly servingChannel: number;
-    /** Always true: the station is busy now, and stops being busy when the other stream is released. */
-    readonly retryable = true;
-    constructor(
-    /** The channel the station is already serving. */
-    servingChannel: number, options?: {
-        cause?: unknown;
-    });
-}
 /**
  * How a live stream ended before its first video keyframe: the warm-up deadline elapsed, the source
  * reported an error, or the source ended on its own.
@@ -739,8 +713,9 @@ export interface MediaProvider {
         /**
          * Present and `true` only when these bytes are the RETAINED still rather than a fresh capture.
          *
-         * A live still is refused while a sibling camera on the same station is being watched, because a
-         * station serves one camera at a time and the live view is the picture someone is looking at. Answering
+         * A live still is refused while a sibling camera on the same station is being watched, because one
+         * session serves one camera at a time, a still does not open a connection of its own, and the live view
+         * is the picture someone is looking at. Answering
          * the retained still there answers the call instead of failing it, and this says the bytes are not
          * current. Absent means freshly captured.
          */
@@ -749,12 +724,12 @@ export interface MediaProvider {
     /**
      * Open a managed live stream.
      *
-     * Several cameras behind one station may stream at the same time only where the station serves them at
-     * the same time. Where it serves one camera at a time, a second viewer is refused with
-     * {@link StationBusyError} rather than admitted and degraded: accepting it does not make the station
-     * serve two, it makes both stutter. Which camera deserves the station is the caller's decision, so
-     * nothing is queued or pre-empted. Each handle receives only the frames the station tagged for ITS
-     * camera.
+     * Several cameras behind one station stream at the same time, each over its own connection to it. One
+     * connection serves one camera — a station answers the most recent start on a session, so two cameras
+     * sharing one take it from each other in turn — so a camera asked for while its station is already
+     * serving another gets a connection of its own. Measured on a base carrying two attached cameras, one
+     * at 3840x2160: both held full frame rate at once. Each handle receives only the frames the station
+     * tagged for ITS camera.
      *
      * @example
      * ```ts