@mega-yfue/eufy-sdk 0.1.2 → 0.2.0-beta.1

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

@@ -186,8 +186,16 @@ export declare class MegaHttpClient {
      *  restored-session short-circuit must NOT treat it as a usable session. Cleared on Ok/reset. */
     private pending2fa;
     private tokenExpiresAt;
-    /** Stable per-install device id — the auth token is bound to it. */
-    private openudid;
+    /**
+     * Stable per-install device id: `openudid` as configured, as restored from the session store, or as
+     * derived from the ACCOUNT when neither supplied one — two clients that configure none therefore
+     * share it, and are one install as far as everything keyed on this is concerned.
+     *
+     * Two things are keyed on it, and both fail the same way when it is shared: the auth token is bound
+     * to it, so each login displaces the other's session, and the secure-MQTT client id is built from it,
+     * so each connection evicts the other's channel.
+     */
+    readonly openudid: string;
     /** The device model reported to the cloud (explicit `phoneModel`, else a stable random one). */
     private readonly phoneModel;
     /** The `user-agent` for the media-download path (explicit `mediaUserAgent`, else derived from the model). */

package/dist/transport/mqtt/app-client-id.d.ts

@@ -11,6 +11,12 @@ export interface AppClientIdInput {
 }
 /** Build a client_id shaped like `android-{appName}-{uid}-{mqttUuid}-{timestamp}`. */
 export declare function buildAppShapedClientId(input: AppClientIdInput): string;
-/** A fresh stable-looking install UUID (16 hex chars) — generate ONCE per identity and persist it
- * (a new random value on every connect defeats the point of "stable"). */
-export declare function generateMqttUuid(): string;
+/**
+ * The `mqttUuid` segment for a client bound to `installId`, hashed to the 16-hex shape
+ * {@link buildAppShapedClientId} expects. Deterministic, so a client keeps its id across restarts and
+ * takes its own stale session over rather than doubling up beside it; one-way, so the id it is derived
+ * from is not recoverable from a client_id that travels the wire in clear.
+ *
+ * Two clients are distinguished exactly as far as their `installId` is: equal ids in, equal ids out.
+ */
+export declare function mqttUuidFrom(installId: string): string;

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

@@ -87,9 +87,6 @@ export interface MqttRouterDeps {
 export declare class MqttCommandRouter {
     private readonly deps;
     private readonly logger;
-    /** Stable per-process install id for the app-shaped MQTT client_id (see {@link buildAppShapedClientId}) —
-     * generated once, reused for every security-MQTT connect this router makes. */
-    private mqttUuid?;
     constructor(deps: MqttRouterDeps);
     /**
      * Whether this transport stack drives `dev`'s `ff09-*` commands — a **eufy-cloud device**

package/dist/transport/mqtt/secure-mqtt.d.ts

@@ -14,6 +14,16 @@
 import { EventEmitter } from "node:events";
 import type { EufyDevice, RealtimeTransport } from "../../core/types.js";
 import { type Logger } from "../../core/logger.js";
+/**
+ * Whether a connect failed because the broker REFUSED the client — a CONNACK return code the client
+ * cannot retry its way out of, as `mqtt.js` words it (`Connection refused: not authorized`). A socket
+ * that dies without an answer is not this: it is the same request, unanswered, and retrying it is the
+ * only way to learn which of the two happened.
+ *
+ * A refusal that arrives as a dropped connection instead of a CONNACK reads here as the transport
+ * failure it is indistinguishable from.
+ */
+export declare function isNotAuthorized(err: unknown): boolean;
 /**
  * Per-user mTLS credentials as returned by get_user_mqtt_info.
  *

package/package.json

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