@mega-yfue/eufy-sdk 0.2.0-beta.18 → 0.2.0-beta.19

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

@@ -247,7 +247,11 @@ export interface CommandContext extends AvailabilityContext {
     adminUserId?: string;
     /** The acting member's short id (`member.short_user_id`, hex, e.g. `"0003"`) — the lock cmd `A5` field. */
     shortUserId?: string;
-    /** The logged-in account's display name (email local-part) — the lock cmd acting-username `A4` field. */
+    /**
+     * The acting name a command attributes itself to — the lock cmd acting-username `A4` field, and the
+     * `user_name` of the guard-mode and HomeBase-alarm writes. The logged-in account's display name
+     * (email local-part) unless the client pins a different label for it.
+     */
     accountName?: string;
     /**
      * Whether the device has a usable P2P endpoint (a non-empty `p2p_did`). A HomeBase-attached lock

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

@@ -32,6 +32,14 @@ export interface MegaClientConfig {
      * an explicit value pins a fixed one. Not the account identity — that's `phoneModel`.
      */
     mediaUserAgent?: string;
+    /**
+     * Acting name written into the commands that carry an actor field — guard mode and HomeBase alarm
+     * output (`user_name`), a lock's acting username. Trimmed, and blank counts as unset: the default
+     * is the login email's local-part (the whole string when it has no `@`). Attribution only — the
+     * device stores it for its own activity record, and no captured frame shows it being validated
+     * against the account.
+     */
+    accountName?: string;
     /** Persist + reuse the session (token + session key) across runs. Default: in-memory. */
     store?: SessionStore;
     /** Diagnostics sink. Omit for silence; pass a `Logger` (or `new ConsoleLogger()`) to see logs. */
@@ -238,10 +246,15 @@ 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 logged-in account's display name — the login email's local-part (e.g. `someone+tag` for
-     * `someone+tag@example.com`). This is the string the app writes into the ff09 command's acting
-     * "username" field (verified against a captured T8531 unlock frame). Falls back to the whole email
-     * if it has no `@`.
+     * The name commands attribute themselves to — {@link MegaClientConfig.accountName} when the config
+     * pins one (trimmed; blank counts as unset), otherwise the logged-in account's display name, which
+     * is the login email's local-part (e.g. `someone+tag` for `someone+tag@example.com`) and falls back
+     * to the whole email if it has no `@`.
+     *
+     * The local-part is the string the app writes into the ff09 command's acting "username" field
+     * (verified against a captured T8531 unlock frame), so it is the faithful default. An override is a
+     * different LABEL for the same account, not a different identity: the session authenticates on the
+     * token and the device record's member ids, neither of which this touches.
      */
     get accountName(): string;
     /**

package/package.json

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