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

package/dist/model/capabilities/camera.d.ts

@@ -263,6 +263,8 @@ export type CameraActions = Surface<typeof CAMERA_MEMBERS> & {
 };
 /** T8442 has a binary night-vision wire, unlike cameras with the three-mode 1277 control. */
 declare function isT8442(ctx: AvailabilityContext): boolean;
+/** A C30/C31 has reported no 1716 and no doorbell LED write was tried on it, so it keeps 1045. */
+declare const doorbellLed: (ctx: AvailabilityContext) => boolean;
 /**
  * Every `camera` feature, declared once. The property schema, the typed getters, the derived setters,
  * the intent routes, the media methods and the descriptions all come out of this table.
@@ -566,7 +568,7 @@ export declare const CAMERA_MEMBERS: {
         readonly readAvailable: (ctx: AvailabilityContext) => boolean;
         readonly readAliases: readonly [{
             readonly paramType: 1716;
-            readonly available: (ctx: AvailabilityContext) => boolean;
+            readonly available: typeof doorbellLed;
         }];
         readonly requiresRead: true;
         readonly description: "Camera status LED. Video doorbells report the same state under their button-ring LED parameter.";

package/dist/model/capabilities/doorbell.d.ts

@@ -1,5 +1,7 @@
 import { type Surface } from "./members.js";
-import type { CapabilityModule } from "./types.js";
+import type { AvailabilityContext, CapabilityModule } from "./types.js";
+/** No doorbell write has been tried on a C30/C31, so only their ring event binds. */
+declare const writable: (ctx: AvailabilityContext) => boolean;
 /**
  * The P2P **feature-command ids** this doorbell capability drives. Capability-owned wire vocabulary
  * (transport forwards `cmd.param` opaquely; full id→name catalog in the generated
@@ -191,6 +193,7 @@ export declare const DOORBELL_MEMBERS: {
      */
     readonly chimeSwitch: {
         readonly param: 1702;
+        readonly available: typeof writable;
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
@@ -203,6 +206,7 @@ export declare const DOORBELL_MEMBERS: {
      */
     readonly mechanicalChimeSwitch: {
         readonly param: 1703;
+        readonly available: typeof writable;
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
@@ -212,6 +216,7 @@ export declare const DOORBELL_MEMBERS: {
     /** Same reasoning and the same capture session as {@link DOORBELL_MEMBERS.mechanicalChimeSwitch}. */
     readonly wdrSwitch: {
         readonly param: 1704;
+        readonly available: typeof writable;
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
@@ -242,6 +247,7 @@ export declare const DOORBELL_MEMBERS: {
      */
     readonly dingdongVolume: {
         readonly param: 1717;
+        readonly available: typeof writable;
         readonly type: "number";
         readonly unit: "%";
         readonly kind: "percent";
@@ -259,6 +265,7 @@ export declare const DOORBELL_MEMBERS: {
      */
     readonly dingdongRingtone: {
         readonly param: 1718;
+        readonly available: typeof writable;
         readonly type: "number";
         readonly kind: "enum";
         readonly enumValues: Record<number, string>;
@@ -313,7 +320,9 @@ export declare const DOORBELL_MEMBERS: {
      * reads {@link DOORBELL_MEMBERS.videoQuality} and {@link DOORBELL_MEMBERS.highCompressionEncoding}
      * and passes what it wants, instead of the SDK guessing from a stale copy.
      */
-    readonly setVideoQuality: import("./members.js").MethodMember<(quality: DoorbellVideoQualityValue, highCompression: boolean) => Promise<void>>;
+    readonly setVideoQuality: import("./members.js").MethodMember<(quality: DoorbellVideoQualityValue, highCompression: boolean) => Promise<void>> & {
+        available: (ctx: import("./types.js").CommandContext) => boolean;
+    };
     /**
      * A config blob the device reports WHOLE, so it is typed `string` and handed back unparsed — three
      * settings live inside it (motion notifications, ring notifications, notification style) and the SDK
@@ -339,7 +348,9 @@ export declare const DOORBELL_MEMBERS: {
      */
     readonly playQuickResponse: import("./members.js").MethodMember<(voiceId: number, opts?: {
         engage?: boolean;
-    }) => Promise<void>>;
+    }) => Promise<void>> & {
+        available: (ctx: import("./types.js").CommandContext) => boolean;
+    };
     /**
      * Fetch the doorbell's quick-response list — a P2P request/reply query that returns data, so it
      * exists only on a device bound to a media provider that offers one.
@@ -352,3 +363,4 @@ export declare const DOORBELL_MEMBERS: {
     }) => Promise<QuickResponse[]>) | undefined>;
 };
 export declare const DOORBELL: CapabilityModule;
+export {};

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.33",
   "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",