@mega-yfue/eufy-sdk 0.6.0-beta.27 → 0.6.0-beta.29

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

@@ -135,6 +135,14 @@ export declare class EufyMega extends EventEmitter {
      * {@link disconnect}.
      */
     private readonly stationReopens;
+    /**
+     * Refuse the one misnamed option that misroutes silently. `country` is not read — the account country
+     * is {@link EufyMegaOptions.countryCode}, which defaults to `"US"` — so a caller that passes `country`
+     * has it ignored. We throw only for the case that changes routing: a non-`"US"` `country` with no
+     * `countryCode`, which would run on the US shard (login succeeds, but the house list comes back an empty
+     * placeholder). `country: "US"` already matches the default route, so it is left to pass through.
+     */
+    private static assertCountryOption;
     constructor(opts: EufyMegaOptions);
     /**
      * Builds the inbound listener that converts ThingClips DP maps to realtime capability state.
@@ -327,7 +335,8 @@ export declare class EufyMega extends EventEmitter {
      * receives nothing until a command dials it again. The first reopen runs at once; one that fails is
      * retried after {@link STATION_REOPEN_MIN_MS}, doubling up to {@link STATION_REOPEN_MAX_MS}, until the
      * session connects or the generation ends. One reopen is pending per station at a time, and each failure
-     * is reported once, by {@link P2PCommandRouter.ensureStation}.
+     * is reported once, by {@link P2PCommandRouter.ensureStation}. A HomeBase S1 Pro (T9000) answers no P2P
+     * lookup, so it is never reopened.
      */
     private reopenWiredStation;
     /**
@@ -771,8 +780,9 @@ export declare class EufyMega extends EventEmitter {
      */
     keepStationWarm(stationSn: string): () => void;
     /** Eagerly open P2P sessions for WIRED stations only (persistent — they don't drain). Battery
-     *  stations stay closed until an on-demand open. Best-effort per station: one that fails is handed to
-     *  {@link reopenWiredStation}. */
+     *  stations stay closed until an on-demand open, and a HomeBase S1 Pro (T9000), which answers no P2P
+     *  lookup and is driven over RTC, is never opened here. Best-effort per station: one that fails is
+     *  handed to {@link reopenWiredStation}. */
     private warmWiredP2P;
     /**
      * A station's power tier for the P2P lifecycle: a HomeBase/station is `"wired"` (persistent); a
@@ -788,10 +798,11 @@ export declare class EufyMega extends EventEmitter {
      * semantic event in — so a stream or talkback opened right after a doorbell ring or a detection starts
      * warm instead of paying a cold open.
      *
-     * Four gates. `autoRealtime: false` means the SDK opens nothing on its own initiative at all;
+     * Five gates. `autoRealtime: false` means the SDK opens nothing on its own initiative at all;
      * {@link EufyMegaOptions.prewarmEvents} must name the event, and it names none by default, which is
-     * what makes pre-warm opt-in; the station must be one the account actually reports; and its power tier
-     * must be one {@link EufyMegaOptions.prewarmTiers} allows.
+     * what makes pre-warm opt-in; the station must be one the account actually reports; it must not be a
+     * HomeBase S1 Pro (T9000), which answers no P2P lookup and is driven over RTC; and its power tier must
+     * be one {@link EufyMegaOptions.prewarmTiers} allows.
      *
      * The tier is resolved for the STATION whose session would open, which is why an attached camera is
      * judged by its base — {@link P2PCommandRouter.stationKeyOf} is the single source of that mapping, and

package/dist/index.js

@@ -29572,7 +29572,7 @@ function readinessSnapshot(readiness, state = readiness.state) {
     wiredP2p: Object.freeze({ ...readiness.wiredP2p })
   });
 }
-var EufyMega = class extends EventEmitter14 {
+var EufyMega = class _EufyMega extends EventEmitter14 {
   opts;
   mega;
   /**
@@ -29669,9 +29669,24 @@ var EufyMega = class extends EventEmitter14 {
    * {@link disconnect}.
    */
   stationReopens = /* @__PURE__ */ new Map();
+  /**
+   * Refuse the one misnamed option that misroutes silently. `country` is not read — the account country
+   * is {@link EufyMegaOptions.countryCode}, which defaults to `"US"` — so a caller that passes `country`
+   * has it ignored. We throw only for the case that changes routing: a non-`"US"` `country` with no
+   * `countryCode`, which would run on the US shard (login succeeds, but the house list comes back an empty
+   * placeholder). `country: "US"` already matches the default route, so it is left to pass through.
+   */
+  static assertCountryOption(opts) {
+    if (!("country" in opts) || opts.countryCode !== void 0)
+      return;
+    if (String(opts.country ?? "").toUpperCase() === "US")
+      return;
+    throw new TypeError(`option "country" is not read; the account country is "countryCode". With "country" set and no "countryCode", this client would silently run as "US" \u2014 pass "countryCode" instead.`);
+  }
   constructor(opts) {
     super();
     this.opts = opts;
+    _EufyMega.assertCountryOption(opts);
     this.prewarmEvents = new Set(opts.prewarmEvents ?? []);
     this.prewarmTiers = new Set(opts.prewarmTiers ?? DEFAULT_PREWARM_TIERS);
     this.mega = new MegaHttpClient(opts);
@@ -30194,7 +30209,8 @@ var EufyMega = class extends EventEmitter14 {
    * receives nothing until a command dials it again. The first reopen runs at once; one that fails is
    * retried after {@link STATION_REOPEN_MIN_MS}, doubling up to {@link STATION_REOPEN_MAX_MS}, until the
    * session connects or the generation ends. One reopen is pending per station at a time, and each failure
-   * is reported once, by {@link P2PCommandRouter.ensureStation}.
+   * is reported once, by {@link P2PCommandRouter.ensureStation}. A HomeBase S1 Pro (T9000) answers no P2P
+   * lookup, so it is never reopened.
    */
   reopenWiredStation(sn) {
     const generation = this.realtimeGeneration;
@@ -30202,7 +30218,7 @@ var EufyMega = class extends EventEmitter14 {
       return;
     if (this.p2p.stationKeyOf(sn) !== sn || !this.registry.p2pDevices().some((d) => d.sn === sn))
       return;
-    if (this.stationPower(sn) !== "wired")
+    if (this.stationPower(sn) !== "wired" || this.stationOf(sn).t9000)
       return;
     const reopen = this.stationReopens.get(sn) ?? { timer: new Timer(), delayMs: 0 };
     this.stationReopens.set(sn, reopen);
@@ -31162,13 +31178,14 @@ var EufyMega = class extends EventEmitter14 {
     return this.rtc.keepWarm(route);
   }
   /** Eagerly open P2P sessions for WIRED stations only (persistent — they don't drain). Battery
-   *  stations stay closed until an on-demand open. Best-effort per station: one that fails is handed to
-   *  {@link reopenWiredStation}. */
+   *  stations stay closed until an on-demand open, and a HomeBase S1 Pro (T9000), which answers no P2P
+   *  lookup and is driven over RTC, is never opened here. Best-effort per station: one that fails is
+   *  handed to {@link reopenWiredStation}. */
   async warmWiredP2P(readiness = createPlaneReadiness(), signal) {
     const wired = /* @__PURE__ */ new Set();
     for (const d of this.registry.p2pDevices()) {
       const key = this.p2p.stationKeyOf(d.sn);
-      if (this.stationPower(key) === "wired")
+      if (this.stationPower(key) === "wired" && !this.stationOf(key).t9000)
         wired.add(key);
     }
     readiness.required = wired.size;
@@ -31213,10 +31230,11 @@ var EufyMega = class extends EventEmitter14 {
    * semantic event in — so a stream or talkback opened right after a doorbell ring or a detection starts
    * warm instead of paying a cold open.
    *
-   * Four gates. `autoRealtime: false` means the SDK opens nothing on its own initiative at all;
+   * Five gates. `autoRealtime: false` means the SDK opens nothing on its own initiative at all;
    * {@link EufyMegaOptions.prewarmEvents} must name the event, and it names none by default, which is
-   * what makes pre-warm opt-in; the station must be one the account actually reports; and its power tier
-   * must be one {@link EufyMegaOptions.prewarmTiers} allows.
+   * what makes pre-warm opt-in; the station must be one the account actually reports; it must not be a
+   * HomeBase S1 Pro (T9000), which answers no P2P lookup and is driven over RTC; and its power tier must
+   * be one {@link EufyMegaOptions.prewarmTiers} allows.
    *
    * The tier is resolved for the STATION whose session would open, which is why an attached camera is
    * judged by its base — {@link P2PCommandRouter.stationKeyOf} is the single source of that mapping, and
@@ -31236,6 +31254,8 @@ var EufyMega = class extends EventEmitter14 {
     const station = this.p2p.stationKeyOf(deviceSn);
     if (!this.registry.list().some((device) => device.sn === station))
       return;
+    if (this.stationOf(station).t9000)
+      return;
     if (!this.prewarmTiers.has(this.stationPower(station)))
       return;
     void this.p2p.prewarm(station, this.opts.prewarmMs);