@mega-yfue/eufy-sdk 0.6.0-beta.31 → 0.6.0-beta.32

package/dist/transport/http/mega-client.d.ts

@@ -212,6 +212,8 @@ export declare class MegaHttpClient {
     private region;
     /** The host `estimate_domain` answered, persisted with the session. */
     private estimatedDomain;
+    /** The in-flight (then settled, so cached) RTC-sign shard request from {@link portalShard}. */
+    private portalShardInFlight?;
     private bootstrapDomain?;
     private sessionKey?;
     /** Per-host ECDH session keys for non-mega gateways (e.g. eufylife) keyed by host. */
@@ -283,11 +285,19 @@ export declare class MegaHttpClient {
     /** The active region shard (e.g. `"eu-pr"`, `"us-pr"`), set after {@link login} or a region override. */
     get regionShard(): RegionShard;
     /**
-     * The shard the RTC signalling signs on: the regional prefix of the estimated domain
-     * (`…-ie-…`/`…-ie.` → `ie-pr`), else {@link regionShard}. The eu/us classification cannot name shards
-     * like `ie-pr`, whose accounts need the IE sign host and cluster.
+     * The shard the estimated domain names (`…-ie-…`/`…-ie.` → `ie-pr`), else {@link regionShard}. The
+     * eu/us classification cannot name shards like `ie-pr`.
      */
     get rtcShard(): string;
+    /**
+     * The shard the RTC signalling signs on, from `estimate_domain` asked with the portal's WEB identity
+     * (`Model-Type: WEB`, `App-Name: eufy_mega`) — the identity the sign itself is sent with, which can name
+     * a different shard than the PHONE identity does for one account. The in-flight request is shared by
+     * concurrent first callers, and once it settles to a shard the resolved promise is the cache; a call
+     * that fails or names no shard answers {@link rtcShard}, clears the field and is asked again next time.
+     */
+    portalShard(): Promise<string>;
+    private fetchPortalShard;
     /**
      * The credentials the RTC signalling needs; `undefined` while logged out. The sign is refused
      * ("gtoken not equal userid") unless its gtoken is the one every authed HTTP call carries.
@@ -334,6 +344,8 @@ export declare class MegaHttpClient {
      * raw text. Never throws on HTTP status (the callers classify the envelope themselves). 20s timeout.
      */
     private httpPost;
+    /** POST `estimate_domain` with the given identity headers. */
+    private estimateDomainRequest;
     /** Step 1: discover the account's region shard (and the bootstrap host). */
     estimateDomain(): Promise<void>;
     /**

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

@@ -61,8 +61,8 @@ export interface RtcLiveRoute extends RtcRoute {
 export interface RtcCommandRouterDeps {
     /** The logged-in session's credentials; `undefined` while logged out. */
     identity: () => RtcIdentity | undefined;
-    /** The mega shard the account signs on (`"ie-pr"`, `"eu-pr"`, `"us-pr"`); picks the smart host. */
-    shard: () => string;
+    /** The signing shard for the route (`"ie-pr"`, `"eu-pr"`, `"us-pr"`); picks the smart host. */
+    shard: (route: RtcRoute) => string | Promise<string>;
     /** ISO country sent on the sign request (default `US`). */
     country?: string;
     logger?: Logger;
@@ -78,6 +78,8 @@ export declare class RtcCommandRouter {
     private readonly warm;
     private readonly callSources;
     private lastTransaction;
+    /** The latest shard each `call` source resolved, read by its `makeStream` (see {@link callMediaProviderFor}). */
+    private readonly callShards;
     constructor(deps: RtcCommandRouterDeps);
     dispatchCommand(route: RtcRoute, cmd: Command): Promise<void>;
     /**
@@ -132,7 +134,13 @@ export declare class RtcCommandRouter {
     trackMediaProviderFor(route: RtcRoute): MediaProvider;
     /** NVR media uses a dedicated call per camera, independent of station commands. */
     nvrMediaProviderFor(route: RtcLiveRoute, views: readonly number[]): MediaProvider;
-    /** Share a dedicated-call source and its consumer operations under one route key. */
+    /**
+     * Share a dedicated-call source and its consumer operations under one route key.
+     *
+     * `SharedLiveSource` calls `makeStream` synchronously, so the shard cannot be awaited inside it. Each
+     * async entry point resolves the shard and records it in {@link callShards} before touching the source;
+     * `makeStream` reads the latest recorded value.
+     */
     private callMediaProviderFor;
     /**
      * Tear down every station session (logout / shutdown). Each live source is disposed before its session
@@ -174,6 +182,14 @@ export declare class RtcCommandRouter {
      */
     private sendAwaitAck;
     private newSession;
+    /** A connected session for `sn` to reuse, or undefined (dropping a dead one). */
+    private reusable;
+    /**
+     * Get or open the station's session. A connected session is reused before the shard is awaited, so a
+     * command on an already-connected station never waits on the unauthenticated `estimate_domain` round
+     * trip — only the create path awaits it. After the await the map is re-checked, with no `await` between
+     * the lookup and `this.sessions.set`, so concurrent creators still share one session.
+     */
     private stationSession;
     /**
      * One bounded bring-up: the session is up when its command channel opens, and it fails, with the

package/package.json

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