@mega-yfue/eufy-sdk 0.6.0-beta.26 → 0.6.0-beta.28

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.

package/dist/index.js

@@ -4779,6 +4779,9 @@ var BATTERY_MEMBERS = cellGated({
    * The headline percentage, and this capability's detection evidence: reporting 1101 is what proves a
    * device is battery-powered, which is also the fact `MediaProvider` reads to decide a stream needs a
    * power budget. Published flat as `battery` — `level` alone is claimed by `suction` too.
+   *
+   * Withheld on a device that resolved `lock`, whose own `battery` member reads the same param 1101 and
+   * owns the `battery` property there, so the two do not both claim it.
    */
   level: {
     param: BATTERY_PARAM.BATTERY,
@@ -4787,6 +4790,7 @@ var BATTERY_MEMBERS = cellGated({
     unit: "%",
     kind: "percent",
     provenance: "verified",
+    available: (ctx) => !hasCapability(ctx, "lock"),
     description: "Battery level 0-100 (verified: param 1101)."
   },
   /**
@@ -29568,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;
   /**
@@ -29665,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);