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

package/dist/transport/mqtt/biz-stream.d.ts

@@ -12,44 +12,41 @@ export declare const BIZ_PROTOCOL: {
     readonly LIVE_PHOTO: 43;
 };
 /**
- * The channels a map frame can arrive on, by id.
+ * The channels a map frame arrives on, by id, as a robot's own frames identify them.
  *
- * **The trap.** Ids 1–10 come from `Metadata.ChanIds` in `stream.proto`, where each *field* names a
- * message and each field's *value* is the id the device chose for it. The names below pair each
- * channel with its field NUMBER, because that is the numbering the vendor ships and the one a live
- * capture shows — but a device announcing a `Metadata` frame is announcing its own numbering, and a
- * firmware that renumbers would make this table wrong without making it look wrong. Anything that
- * *decodes* a channel's bytes must therefore prefer a device-declared mapping when one has been seen;
- * this table is the default to fall back on, not an authority.
+ * Each id is paired with the `stream.proto` message whose field layout its frames carry, which is not
+ * the field-number order of `Metadata.ChanIds`: the cell plane (`Map`) arrives on 2, its room outline
+ * on 4, the room list on 5, the restricted zones on 6, the robot's pose (`DynamicData`) on 7, the map's
+ * `MapDescription` on 60 and a whole `MapBackup` on 68. A `Metadata` frame would declare a device's own numbering; none has been seen,
+ * so none is read, and this table is the numbering every frame is read by.
  *
- * Channel 0 is the exception and is not in `ChanIds` at all: the app hard-codes it, routing it to a
- * scene-data event rather than a map one, and asks for the scene list on it by number. That one is
- * fixed.
+ * Only channels whose message is identified are listed. A channel whose frames carry too little to
+ * identify, or that carries a message nothing here reads, is absent.
+ *
+ * Channel 0 is not in `ChanIds` at all: the app hard-codes it, routing it to a scene-data event rather
+ * than a map one, and asks for the scene list on it by number.
  */
 export declare const BIZ_CHANNEL: {
     /** Scene (room-group) data. Hard-coded in the app, not part of `ChanIds`. */
     readonly SCENES: 0;
-    readonly MAP_INFO: 1;
-    readonly PATH: 2;
-    readonly ROOM_OUTLINE: 3;
-    readonly ROOM_PARAMS: 4;
-    readonly RESTRICTED_ZONE: 5;
-    readonly DYNAMIC_DATA: 6;
-    readonly TEMPORARY_DATA: 7;
-    readonly OBSTACLE_INFO: 8;
-    readonly MAP_DATA: 9;
-    readonly CRUISE_DATA: 10;
+    readonly MAP_DATA: 2;
+    readonly ROOM_OUTLINE: 4;
+    readonly ROOM_PARAMS: 5;
+    readonly RESTRICTED_ZONE: 6;
+    readonly DYNAMIC_DATA: 7;
+    readonly MAP_DESCRIPTION: 60;
+    readonly MAP_BACKUP: 68;
 };
-/** A channel's name under the default numbering — see the trap in {@link BIZ_CHANNEL}. */
+/** A channel's name under the {@link BIZ_CHANNEL} numbering. */
 export type BizChannel = keyof typeof BIZ_CHANNEL;
 /**
- * Name a channel id under the default numbering, or `undefined` for an id the vendor's table does not
- * list. Not a substitute for a device-declared mapping where one exists.
+ * Name a channel id under the {@link BIZ_CHANNEL} numbering, or `undefined` for an id it does not list.
+ * Not a substitute for a device-declared mapping where one exists.
  */
 export declare function bizChannelName(id: number): BizChannel | undefined;
 /** One frame off the map stream, unwrapped as far as its bytes but not decoded. */
 export interface BizMapFrame {
-    /** Which channel the bytes belong to. Compare against {@link BIZ_CHANNEL}, mindful of its trap. */
+    /** Which channel the bytes belong to. Compare against {@link BIZ_CHANNEL}. */
     readonly channelId: number;
     /**
      * The vendor's `clear_type`. Forwarded, not interpreted: the app passes it straight through to its

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

@@ -62,6 +62,8 @@ export interface P2PRouterDeps {
     onClose: (stationSn: string) => void;
     onError: (err: Error) => void;
     onLevel2Ready: (stationSn: string, cipherId: number) => void;
+    /** The station answered on its own session at `atMs` — a PONG or an ACK from the connected peer. */
+    onPeerAnswer?: (stationSn: string, atMs: number) => void;
     /** A raw decoded frame — the client emits the low-level `p2p` event + runs the semantic decode. */
     onFrame: (stationSn: string, frame: P2PFrame) => void;
     /**

package/dist/transport/p2p/p2p-session.d.ts

@@ -95,6 +95,12 @@ export interface P2PFrame extends P2PDataFrameHeader {
      * the values as device state without any per-capability decoder.
      */
     params?: Record<number, string>;
+    /**
+     * A station's camera-info table, one `param_type → param_value` map per channel it names (255 is the
+     * station). Set instead of {@link params} when the station answered on {@link STATION_CHANNEL}, so each
+     * channel's state can land on the device attached there.
+     */
+    channelParams?: Record<number, Record<number, string>>;
 }
 /**
  * A live PPCS session. Internal transport; a host drives cameras through the capability surface.
@@ -134,7 +140,12 @@ export declare class P2PSession extends EventEmitter {
     private audioStalled;
     private audioRetransmitTimer?;
     private lastPongData?;
-    /** When the selected peer last answered outbound P2P traffic on this connection. */
+    /**
+     * When the selected peer last answered outbound P2P traffic on this connection.
+     *
+     * Each answer also emits `peerAnswer` with this time: a PONG or an ACK from the connected address is the
+     * station replying on this connection now, which a heartbeat draws every {@link HEARTBEAT_MS}.
+     */
     private lastPeerAt?;
     /** Whether the silence has already been stated, so it is traced once per connection rather than per read. */
     private pathStaleTraced;

package/package.json

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