@homebridge-plugins/homebridge-ewelink 12.13.1-beta.2 → 12.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  All notable changes to `@homebridge-plugins/homebridge-ewelink` will be documented in this file.
4
4
 
5
+ ## v12.14.0 (2026-05-05)
6
+
7
+ ### Changed
8
+
9
+ - dependency updates
10
+
5
11
  ## v12.13.0 (2026-04-12)
6
12
 
7
13
  ### Changed
@@ -11,7 +11,7 @@ import { hasProperty, parseError, sleep } from '../utils/functions.js'
11
11
  const emitter = new events()
12
12
 
13
13
  export default class {
14
- constructor(platform, authData, httpClient) {
14
+ constructor(platform, authData) {
15
15
  // Set up variables from the platform
16
16
  this.appId = platform.config.appId || platformConsts.appId
17
17
  this.appSecret = platform.config.appSecret || platformConsts.appSecret
@@ -19,9 +19,6 @@ export default class {
19
19
  this.lang = platform.lang
20
20
  this.log = platform.log
21
21
 
22
- // HTTP client used to refresh the bearer token when a 406 invalidates the session
23
- this.httpClient = httpClient
24
-
25
22
  // Set up variables from the authData (from HTTP)
26
23
  this.httpHost = authData.httpHost
27
24
  this.aToken = authData.aToken
@@ -29,51 +26,6 @@ export default class {
29
26
 
30
27
  // Flag used to determine ws connection status
31
28
  this.wsIsConnected = false
32
-
33
- // Retry state — a single counter/timer serialises all reconnection paths
34
- this.retryCount = 0
35
- this.loginInProgress = false
36
- this.reconnectTimer = null
37
- }
38
-
39
- scheduleReconnect(reason) {
40
- // Another retry is already queued or a login is actively running — nothing to do
41
- if (this.reconnectTimer || this.loginInProgress) {
42
- return
43
- }
44
- if (this.retryCount >= 10) {
45
- this.log.warn('%s [giving up after %s attempts, reason: %s].', this.lang.wsLoginError, this.retryCount, reason)
46
- return
47
- }
48
- const delay = Math.min(5000 * 2 ** this.retryCount, 300000)
49
- this.retryCount += 1
50
- // Log recovery at info level — users need to see that retries are happening
51
- this.log('WS reconnect scheduled [%s] in %s ms (attempt %s).', reason, delay, this.retryCount)
52
- this.reconnectTimer = setTimeout(() => {
53
- this.reconnectTimer = null
54
- this.login().catch(() => {
55
- // login() schedules its own retry on internal failure — nothing to do here
56
- })
57
- }, delay)
58
- }
59
-
60
- async refreshHttpToken() {
61
- // Re-run HTTP login to get a fresh aToken; a 406 means the old one is invalidated.
62
- // This does NOT re-fetch homes/devices — only the bearer token changes.
63
- if (!this.httpClient) {
64
- return false
65
- }
66
- try {
67
- const authData = await this.httpClient.login()
68
- this.aToken = authData.aToken
69
- this.apiKey = authData.apiKey
70
- this.httpHost = authData.httpHost
71
- this.log('HTTP token refreshed after 406.')
72
- return true
73
- } catch (err) {
74
- this.log.warn('%s %s.', 'HTTP token refresh failed:', parseError(err))
75
- return false
76
- }
77
29
  }
78
30
 
79
31
  async getHost(attempt = 0) {
@@ -129,21 +81,17 @@ export default class {
129
81
  }
130
82
 
131
83
  async login() {
132
- // Used to create the web socket connection and authenticate.
133
- // All reconnection paths (onClose, onError, 406, open-fail) funnel through
134
- // scheduleReconnect(), which guards against concurrent logins via loginInProgress.
135
- if (this.loginInProgress) {
136
- return
137
- }
138
- this.loginInProgress = true
139
-
140
- // Cancel any pending reconnect — we're attempting a login right now
141
- if (this.reconnectTimer) {
142
- clearTimeout(this.reconnectTimer)
143
- this.reconnectTimer = null
144
- }
145
-
84
+ // Used to create the web socket connection and authenticate
146
85
  try {
86
+ // This may be called onClose and onError, we just want it to run once
87
+ if (this.debounce) {
88
+ return
89
+ }
90
+ this.debounce = true
91
+ setTimeout(() => {
92
+ this.debounce = false
93
+ }, 4000)
94
+
147
95
  // Close any existing web socket connection
148
96
  await this.closeConnection()
149
97
 
@@ -211,19 +159,20 @@ export default class {
211
159
  }
212
160
  }, (res.config.hbInterval + 7) * 1000)
213
161
 
214
- // Login was successful — reset the retry counter and log if appropriate
215
- this.retryCount = 0
162
+ // Login was successful and log if appropriate
163
+ this.authRetries = 0
216
164
  if (this.debug) {
217
165
  this.log('%s.', this.lang.wsLoginSuccess)
218
166
  }
219
167
  } else if (res.error === 406) {
220
- // Token invalidated (e.g. concurrent session from the mobile app).
221
- // Re-sending userOnline with the same aToken will keep returning 406,
222
- // so refresh the HTTP token first, then reconnect with backoff.
168
+ // Token invalidated (e.g. concurrent session), re-authenticate with backoff
223
169
  this.log.warn(this.lang.wsLogin406)
224
- await this.refreshHttpToken()
225
- await this.closeConnection()
226
- this.scheduleReconnect('406')
170
+ const delay = Math.min(5000 * 2 ** (this.authRetries || 0), 300000)
171
+ this.authRetries = (this.authRetries || 0) + 1
172
+ if (this.authRetries <= 10) {
173
+ await sleep(delay)
174
+ await this.login()
175
+ }
227
176
  } else {
228
177
  // There was a problem with the authentication response
229
178
  const str = JSON.stringify(res, null, 2)
@@ -232,8 +181,6 @@ export default class {
232
181
  } catch (err) {
233
182
  // Catch any errors authenticating the WS connection
234
183
  this.log.warn('%s %s.', this.lang.wsLoginError, parseError(err))
235
- await this.closeConnection()
236
- this.scheduleReconnect('auth-error')
237
184
  }
238
185
  })
239
186
 
@@ -320,14 +267,14 @@ export default class {
320
267
  msg.params.updateSource = 'WS'
321
268
  emitter.emit('update', { deviceid: msg.deviceid, params: msg.params })
322
269
  }
323
- } else if (msg.error !== 406) {
270
+ } else {
324
271
  // WS message received has an unknown action
325
272
  this.log.warn('%s.\n%s', this.lang.wsUnkCmd, JSON.stringify(msg, null, 2))
326
273
  }
327
274
  })
328
275
 
329
276
  // Add a listener for when the web socket closes for any reason
330
- this.wsClient.onClose.addListener((e) => {
277
+ this.wsClient.onClose.addListener(async (e) => {
331
278
  // Don't continue further with logging/reconnection if it's a wanted closure
332
279
  if (e === 1005) {
333
280
  return
@@ -337,23 +284,30 @@ export default class {
337
284
  this.log.warn('%s [%s].', this.lang.wsReconnectError, e)
338
285
  }
339
286
 
340
- this.wsIsConnected = false
341
- this.scheduleReconnect(`close-${e}`)
287
+ // Reconnect with exponential backoff
288
+ this.reconnectAttempts = (this.reconnectAttempts || 0) + 1
289
+ const delay = Math.min(5000 * 2 ** (this.reconnectAttempts - 1), 300000)
290
+ await sleep(delay)
291
+ await this.login()
342
292
  })
343
293
 
344
294
  // Add a listener for when the web socket throws an error
345
- this.wsClient.onError.addListener((e) => {
295
+ this.wsClient.onError.addListener(async (e) => {
346
296
  if (this.debug) {
347
297
  this.log.warn('%s [%s].', this.lang.wsReconnectClose, e)
348
298
  }
349
299
 
350
- this.scheduleReconnect('error')
300
+ this.reconnectAttempts = (this.reconnectAttempts || 0) + 1
301
+ const delay = Math.min(5000 * 2 ** (this.reconnectAttempts - 1), 300000)
302
+ await sleep(delay)
303
+ await this.login()
351
304
  })
352
305
 
353
- // Open the web socket connection.
354
- // NB: retryCount is reset only on successful auth, not on TCP handshake —
355
- // otherwise a repeated auth-failure loop would reset backoff every cycle.
306
+ // Open the web socket connection
356
307
  await this.wsClient.open()
308
+
309
+ // Reset reconnect counter on successful connection
310
+ this.reconnectAttempts = 0
357
311
  } catch (err) {
358
312
  const errToShow = parseError(err)
359
313
 
@@ -361,9 +315,10 @@ export default class {
361
315
  this.log('%s: %s.', this.lang.wsLoginErrRecon, errToShow)
362
316
  }
363
317
 
364
- this.scheduleReconnect('open-failed')
365
- } finally {
366
- this.loginInProgress = false
318
+ this.reconnectAttempts = (this.reconnectAttempts || 0) + 1
319
+ const delay = Math.min(5000 * 2 ** (this.reconnectAttempts - 1), 300000)
320
+ await sleep(delay)
321
+ await this.login()
367
322
  }
368
323
  }
369
324
 
@@ -464,8 +419,7 @@ export default class {
464
419
  }
465
420
 
466
421
  async closeConnection() {
467
- // This is called when refreshing connection or if Homebridge shuts down.
468
- // Idempotent — safe to call regardless of current connection state.
422
+ // This is called when refreshing connection or if Homebridge shuts down
469
423
 
470
424
  // Clear any existing ping interval
471
425
  if (this.hbInterval) {
@@ -475,22 +429,21 @@ export default class {
475
429
 
476
430
  // Check the ws client is set up
477
431
  if (this.wsClient) {
478
- const wasConnected = this.wsIsConnected
479
-
480
- // Remove any existing listeners so onClose/onError don't retrigger reconnection
432
+ // Remove any existing listeners
481
433
  this.wsClient.removeAllListeners()
482
- this.wsIsConnected = false
483
434
 
484
- // Always attempt to close the underlying socket — auth-failure paths (e.g. 406)
485
- // leave wsIsConnected=false but the TCP/WS socket is still open.
486
- try {
435
+ // Close the web socket connection
436
+ if (this.wsIsConnected) {
437
+ // Set the connection flag to false
438
+ this.wsIsConnected = false
439
+
440
+ // Close the connection
487
441
  await this.wsClient.close()
488
- } catch {
489
- // Already closed, never fully opened, or close threw — nothing actionable
490
- }
491
442
 
492
- if (wasConnected && this.debug) {
493
- this.log('%s.', this.lang.stoppedWS)
443
+ // Log if appropriate
444
+ if (this.debug) {
445
+ this.log('%s.', this.lang.stoppedWS)
446
+ }
494
447
  }
495
448
  }
496
449
  }
package/lib/platform.js CHANGED
@@ -513,7 +513,7 @@ export default class {
513
513
 
514
514
  // Set up the WS client, get the user WS host and login
515
515
  if (this.config.mode !== 'lan') {
516
- this.wsClient = new wsClient(this, authData, this.httpClient)
516
+ this.wsClient = new wsClient(this, authData)
517
517
  await this.wsClient.login()
518
518
 
519
519
  // Refresh the WS connection every 60 minutes
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "displayName": "Homebridge eWeLink",
4
4
  "alias": "eWeLink",
5
5
  "type": "module",
6
- "version": "12.13.1-beta.2",
6
+ "version": "12.14.0",
7
7
  "description": "Homebridge plugin to integrate eWeLink devices into HomeKit.",
8
8
  "author": {
9
9
  "name": "bwp91",
@@ -53,8 +53,8 @@
53
53
  ],
54
54
  "main": "lib/index.js",
55
55
  "engines": {
56
- "homebridge": "^1.6.0 || ^2.0.0-beta.0",
57
- "node": "^22 || ^24"
56
+ "homebridge": "^1.6.0 || ^2.0.0",
57
+ "node": "^22.12.0 || ^24.0.0"
58
58
  },
59
59
  "scripts": {
60
60
  "lint": "eslint . --max-warnings=0",
@@ -62,9 +62,9 @@
62
62
  },
63
63
  "dependencies": {
64
64
  "@homebridge/plugin-ui-utils": "^2.2.3",
65
- "axios": "^1.15.1",
65
+ "axios": "^1.16.0",
66
66
  "node-persist": "^4.0.4",
67
- "p-queue": "^9.1.2",
67
+ "p-queue": "^9.2.0",
68
68
  "websocket-as-promised": "^3.0.1",
69
69
  "ws": "^8.20.0"
70
70
  },