@mega-yfue/eufy-sdk 0.2.0-beta.12 → 0.2.0-beta.14

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

@@ -28,10 +28,12 @@ import { FragmentRecording } from "./fragment-recording.js";
  * when these change.
  *
  * `connect` applies to every call on a station, because nothing can be addressed to one before its session is
- * up. `level2Grace` applies twice where the key is required: the negotiation is re-prompted once.
+ * up, and it is the session's own connect deadline: a session that reaches it closes itself, so waiting past it
+ * waits on a connection that can no longer answer. `level2Grace` applies twice where the key is required: the
+ * negotiation is re-prompted once.
  */
 export declare const P2P_STATION_WAITS: {
-    readonly connect: 20000;
+    readonly connect: 15000;
     readonly level2Grace: 25000;
     readonly level2Settle: 8000;
 };

package/dist/transport/p2p/live-trace.d.ts

@@ -63,6 +63,20 @@ export type LiveTrace =
     phase: "sequence-restart";
     dataType: number;
 }
+/**
+ * Which lookup channels a connection can ask for the station on, before it asks.
+ *
+ * A station is found by a local lookup, by a cloud lookup, or by both, and each needs something the other
+ * does not: the local one needs the station on this link, the cloud one needs both a key for the station and
+ * an address to ask. A connect that had one channel failed for that channel's reason alone, and a connect
+ * that had neither could not have succeeded — outcomes a station that is switched off is otherwise
+ * indistinguishable from, because nothing else in a failed connect states what was even attempted.
+ */
+ | {
+    phase: "lookup-channels";
+    local: boolean;
+    cloud: boolean;
+}
 /**
  * Work on a station is holding for its session to connect, with the milliseconds it will wait.
  *
@@ -150,17 +164,21 @@ export type LiveTrace =
 /**
  * A station was resolved for a call, stating what the caller's device is on it and whose station it is.
  *
- * Emitted before anything is sent, so it is the only account of the intended topology on a call that fails
- * during resolution: an attached camera's media start has no unencrypted form, so whether a device was taken
- * as attached decides what its failure means. `stationAdmin` states whether the signed-in account is the
- * station's administrator, which is what a key the account cannot resolve turns on; `unstated` is a device
- * record that names no administrator, which is not the same as naming another.
+ * Emitted before the session is waited on, so a station that is never reached still has this record: an
+ * attached camera's media start has no unencrypted form, so whether a device was taken as attached decides
+ * what its failure means. `stationAdmin` states whether the signed-in account is the station's
+ * administrator, which is what a key the account cannot resolve turns on; `unstated` is a device record
+ * that names no administrator, which is not the same as naming another. `stationModel` is the model of the
+ * station the call resolved — the base's for an attached camera, the device's own where it is its own
+ * station — absent where that record states none; without it a base this SDK reaches differently is
+ * indistinguishable from one that is switched off.
  */
  | {
     phase: "station-resolved";
     topology: "attached" | "own";
     channel: number;
     stationAdmin: "self" | "other" | "unstated";
+    stationModel?: string;
 }
 /** A shared source began warming, with the interval it re-issues on and the deadline it fails at. */
  | {

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

@@ -16,6 +16,15 @@
 import { EventEmitter } from "node:events";
 import { type Address, type P2PDataFrameHeader } from "./codec.js";
 import { type Logger } from "../../core/logger.js";
+/**
+ * How long a station is given to answer a lookup before the connection gives up on it and closes.
+ *
+ * The whole deadline for reaching a station: the lookups are re-sent every second until one is answered, and
+ * a connection that reaches this closes itself, so nothing addressed to that station can succeed afterwards.
+ * Published because it bounds every wait on a session connecting — a second number for the same deadline
+ * elsewhere would outlive the connection it waits on and charge the difference to every failure.
+ */
+export declare const CONNECT_TIMEOUT_MS = 15000;
 /**
  * The channel a command addresses the station itself on, rather than one of its cameras, and the value a
  * session's channel-taking methods resolve an omitted channel to.

package/package.json

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