matterbridge 3.1.2 → 3.1.3-dev-20250712-616f7ed

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.
Files changed (207) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/dist/cli.js +2 -91
  3. package/dist/cliEmitter.js +0 -30
  4. package/dist/clusters/export.js +0 -2
  5. package/dist/defaultConfigSchema.js +0 -24
  6. package/dist/deviceManager.js +1 -94
  7. package/dist/devices/batteryStorage.js +1 -48
  8. package/dist/devices/evse.js +10 -74
  9. package/dist/devices/export.js +0 -2
  10. package/dist/devices/heatPump.js +2 -50
  11. package/dist/devices/laundryDryer.js +6 -83
  12. package/dist/devices/laundryWasher.js +7 -91
  13. package/dist/devices/roboticVacuumCleaner.js +6 -89
  14. package/dist/devices/solarPower.js +0 -38
  15. package/dist/devices/waterHeater.js +2 -82
  16. package/dist/frontend.js +16 -417
  17. package/dist/globalMatterbridge.js +0 -47
  18. package/dist/helpers.js +0 -53
  19. package/dist/index.js +1 -30
  20. package/dist/logger/export.js +0 -1
  21. package/dist/matter/behaviors.js +0 -2
  22. package/dist/matter/clusters.js +0 -2
  23. package/dist/matter/devices.js +0 -2
  24. package/dist/matter/endpoints.js +0 -2
  25. package/dist/matter/export.js +0 -3
  26. package/dist/matter/types.js +0 -3
  27. package/dist/matterbridge.js +54 -803
  28. package/dist/matterbridgeAccessoryPlatform.js +0 -36
  29. package/dist/matterbridgeBehaviors.js +1 -61
  30. package/dist/matterbridgeDeviceTypes.js +15 -579
  31. package/dist/matterbridgeDynamicPlatform.js +0 -36
  32. package/dist/matterbridgeEndpoint.js +51 -1053
  33. package/dist/matterbridgeEndpointHelpers.js +12 -322
  34. package/dist/matterbridgePlatform.js +0 -233
  35. package/dist/matterbridgeTypes.js +0 -25
  36. package/dist/pluginManager.js +3 -269
  37. package/dist/shelly.js +7 -168
  38. package/dist/storage/export.js +0 -1
  39. package/dist/update.js +0 -54
  40. package/dist/utils/colorUtils.js +2 -263
  41. package/dist/utils/commandLine.js +0 -54
  42. package/dist/utils/copyDirectory.js +1 -38
  43. package/dist/utils/createDirectory.js +0 -33
  44. package/dist/utils/createZip.js +2 -47
  45. package/dist/utils/deepCopy.js +0 -39
  46. package/dist/utils/deepEqual.js +1 -72
  47. package/dist/utils/export.js +0 -1
  48. package/dist/utils/hex.js +0 -58
  49. package/dist/utils/isvalid.js +0 -101
  50. package/dist/utils/network.js +5 -83
  51. package/dist/utils/spawn.js +0 -18
  52. package/dist/utils/wait.js +9 -62
  53. package/npm-shrinkwrap.json +5 -5
  54. package/package.json +1 -2
  55. package/dist/cli.d.ts +0 -26
  56. package/dist/cli.d.ts.map +0 -1
  57. package/dist/cli.js.map +0 -1
  58. package/dist/cliEmitter.d.ts +0 -34
  59. package/dist/cliEmitter.d.ts.map +0 -1
  60. package/dist/cliEmitter.js.map +0 -1
  61. package/dist/clusters/export.d.ts +0 -2
  62. package/dist/clusters/export.d.ts.map +0 -1
  63. package/dist/clusters/export.js.map +0 -1
  64. package/dist/defaultConfigSchema.d.ts +0 -28
  65. package/dist/defaultConfigSchema.d.ts.map +0 -1
  66. package/dist/defaultConfigSchema.js.map +0 -1
  67. package/dist/deviceManager.d.ts +0 -112
  68. package/dist/deviceManager.d.ts.map +0 -1
  69. package/dist/deviceManager.js.map +0 -1
  70. package/dist/devices/batteryStorage.d.ts +0 -48
  71. package/dist/devices/batteryStorage.d.ts.map +0 -1
  72. package/dist/devices/batteryStorage.js.map +0 -1
  73. package/dist/devices/evse.d.ts +0 -75
  74. package/dist/devices/evse.d.ts.map +0 -1
  75. package/dist/devices/evse.js.map +0 -1
  76. package/dist/devices/export.d.ts +0 -9
  77. package/dist/devices/export.d.ts.map +0 -1
  78. package/dist/devices/export.js.map +0 -1
  79. package/dist/devices/heatPump.d.ts +0 -47
  80. package/dist/devices/heatPump.d.ts.map +0 -1
  81. package/dist/devices/heatPump.js.map +0 -1
  82. package/dist/devices/laundryDryer.d.ts +0 -87
  83. package/dist/devices/laundryDryer.d.ts.map +0 -1
  84. package/dist/devices/laundryDryer.js.map +0 -1
  85. package/dist/devices/laundryWasher.d.ts +0 -242
  86. package/dist/devices/laundryWasher.d.ts.map +0 -1
  87. package/dist/devices/laundryWasher.js.map +0 -1
  88. package/dist/devices/roboticVacuumCleaner.d.ts +0 -110
  89. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  90. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  91. package/dist/devices/solarPower.d.ts +0 -40
  92. package/dist/devices/solarPower.d.ts.map +0 -1
  93. package/dist/devices/solarPower.js.map +0 -1
  94. package/dist/devices/waterHeater.d.ts +0 -111
  95. package/dist/devices/waterHeater.d.ts.map +0 -1
  96. package/dist/devices/waterHeater.js.map +0 -1
  97. package/dist/frontend.d.ts +0 -303
  98. package/dist/frontend.d.ts.map +0 -1
  99. package/dist/frontend.js.map +0 -1
  100. package/dist/globalMatterbridge.d.ts +0 -59
  101. package/dist/globalMatterbridge.d.ts.map +0 -1
  102. package/dist/globalMatterbridge.js.map +0 -1
  103. package/dist/helpers.d.ts +0 -48
  104. package/dist/helpers.d.ts.map +0 -1
  105. package/dist/helpers.js.map +0 -1
  106. package/dist/index.d.ts +0 -33
  107. package/dist/index.d.ts.map +0 -1
  108. package/dist/index.js.map +0 -1
  109. package/dist/logger/export.d.ts +0 -2
  110. package/dist/logger/export.d.ts.map +0 -1
  111. package/dist/logger/export.js.map +0 -1
  112. package/dist/matter/behaviors.d.ts +0 -2
  113. package/dist/matter/behaviors.d.ts.map +0 -1
  114. package/dist/matter/behaviors.js.map +0 -1
  115. package/dist/matter/clusters.d.ts +0 -2
  116. package/dist/matter/clusters.d.ts.map +0 -1
  117. package/dist/matter/clusters.js.map +0 -1
  118. package/dist/matter/devices.d.ts +0 -2
  119. package/dist/matter/devices.d.ts.map +0 -1
  120. package/dist/matter/devices.js.map +0 -1
  121. package/dist/matter/endpoints.d.ts +0 -2
  122. package/dist/matter/endpoints.d.ts.map +0 -1
  123. package/dist/matter/endpoints.js.map +0 -1
  124. package/dist/matter/export.d.ts +0 -5
  125. package/dist/matter/export.d.ts.map +0 -1
  126. package/dist/matter/export.js.map +0 -1
  127. package/dist/matter/types.d.ts +0 -3
  128. package/dist/matter/types.d.ts.map +0 -1
  129. package/dist/matter/types.js.map +0 -1
  130. package/dist/matterbridge.d.ts +0 -450
  131. package/dist/matterbridge.d.ts.map +0 -1
  132. package/dist/matterbridge.js.map +0 -1
  133. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -42
  134. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  135. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  136. package/dist/matterbridgeBehaviors.d.ts +0 -1340
  137. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  138. package/dist/matterbridgeBehaviors.js.map +0 -1
  139. package/dist/matterbridgeDeviceTypes.d.ts +0 -709
  140. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  141. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  142. package/dist/matterbridgeDynamicPlatform.d.ts +0 -42
  143. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  144. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  145. package/dist/matterbridgeEndpoint.d.ts +0 -1196
  146. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  147. package/dist/matterbridgeEndpoint.js.map +0 -1
  148. package/dist/matterbridgeEndpointHelpers.d.ts +0 -3198
  149. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  150. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  151. package/dist/matterbridgePlatform.d.ts +0 -310
  152. package/dist/matterbridgePlatform.d.ts.map +0 -1
  153. package/dist/matterbridgePlatform.js.map +0 -1
  154. package/dist/matterbridgeTypes.d.ts +0 -192
  155. package/dist/matterbridgeTypes.d.ts.map +0 -1
  156. package/dist/matterbridgeTypes.js.map +0 -1
  157. package/dist/pluginManager.d.ts +0 -291
  158. package/dist/pluginManager.d.ts.map +0 -1
  159. package/dist/pluginManager.js.map +0 -1
  160. package/dist/shelly.d.ts +0 -174
  161. package/dist/shelly.d.ts.map +0 -1
  162. package/dist/shelly.js.map +0 -1
  163. package/dist/storage/export.d.ts +0 -2
  164. package/dist/storage/export.d.ts.map +0 -1
  165. package/dist/storage/export.js.map +0 -1
  166. package/dist/update.d.ts +0 -59
  167. package/dist/update.d.ts.map +0 -1
  168. package/dist/update.js.map +0 -1
  169. package/dist/utils/colorUtils.d.ts +0 -117
  170. package/dist/utils/colorUtils.d.ts.map +0 -1
  171. package/dist/utils/colorUtils.js.map +0 -1
  172. package/dist/utils/commandLine.d.ts +0 -59
  173. package/dist/utils/commandLine.d.ts.map +0 -1
  174. package/dist/utils/commandLine.js.map +0 -1
  175. package/dist/utils/copyDirectory.d.ts +0 -33
  176. package/dist/utils/copyDirectory.d.ts.map +0 -1
  177. package/dist/utils/copyDirectory.js.map +0 -1
  178. package/dist/utils/createDirectory.d.ts +0 -34
  179. package/dist/utils/createDirectory.d.ts.map +0 -1
  180. package/dist/utils/createDirectory.js.map +0 -1
  181. package/dist/utils/createZip.d.ts +0 -39
  182. package/dist/utils/createZip.d.ts.map +0 -1
  183. package/dist/utils/createZip.js.map +0 -1
  184. package/dist/utils/deepCopy.d.ts +0 -32
  185. package/dist/utils/deepCopy.d.ts.map +0 -1
  186. package/dist/utils/deepCopy.js.map +0 -1
  187. package/dist/utils/deepEqual.d.ts +0 -54
  188. package/dist/utils/deepEqual.d.ts.map +0 -1
  189. package/dist/utils/deepEqual.js.map +0 -1
  190. package/dist/utils/export.d.ts +0 -12
  191. package/dist/utils/export.d.ts.map +0 -1
  192. package/dist/utils/export.js.map +0 -1
  193. package/dist/utils/hex.d.ts +0 -49
  194. package/dist/utils/hex.d.ts.map +0 -1
  195. package/dist/utils/hex.js.map +0 -1
  196. package/dist/utils/isvalid.d.ts +0 -103
  197. package/dist/utils/isvalid.d.ts.map +0 -1
  198. package/dist/utils/isvalid.js.map +0 -1
  199. package/dist/utils/network.d.ts +0 -76
  200. package/dist/utils/network.d.ts.map +0 -1
  201. package/dist/utils/network.js.map +0 -1
  202. package/dist/utils/spawn.d.ts +0 -11
  203. package/dist/utils/spawn.d.ts.map +0 -1
  204. package/dist/utils/spawn.js.map +0 -1
  205. package/dist/utils/wait.d.ts +0 -56
  206. package/dist/utils/wait.d.ts.map +0 -1
  207. package/dist/utils/wait.js.map +0 -1
@@ -1,25 +1,3 @@
1
- /**
2
- * @description This file contains the RoboticVacuumCleaner class.
3
- * @file src/devices/roboticVacuumCleaner.ts
4
- * @author Luca Liguori
5
- * @created 2025-05-01
6
- * @version 1.1.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
1
  import { RvcRunModeServer } from '@matter/main/behaviors/rvc-run-mode';
24
2
  import { RvcOperationalStateServer } from '@matter/main/behaviors/rvc-operational-state';
25
3
  import { RvcCleanModeServer } from '@matter/main/behaviors/rvc-clean-mode';
@@ -29,29 +7,10 @@ import { RvcCleanMode } from '@matter/main/clusters/rvc-clean-mode';
29
7
  import { RvcOperationalState } from '@matter/main/clusters/rvc-operational-state';
30
8
  import { ModeBase } from '@matter/main/clusters/mode-base';
31
9
  import { OperationalState } from '@matter/main/clusters/operational-state';
32
- // Matterbridge
33
10
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
34
11
  import { powerSource, roboticVacuumCleaner } from '../matterbridgeDeviceTypes.js';
35
12
  import { MatterbridgeServer, MatterbridgeServiceAreaServer } from '../matterbridgeBehaviors.js';
36
13
  export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
37
- /**
38
- * Creates an instance of the RoboticVacuumCleaner class.
39
- *
40
- * @param {string} name - The name of the robotic vacuum cleaner.
41
- * @param {string} serial - The serial number of the robotic vacuum cleaner.
42
- * @param {'server' | 'matter' | undefined} [mode] - The mode of the robotic vacuum cleaner. Defaults to undefined. Use 'server' or 'matter' if you want Apple Home compatibility.
43
- * @param {number} [currentRunMode] - The current run mode of the robotic vacuum cleaner. Defaults to 1 (Idle).
44
- * @param {RvcRunMode.ModeOption[]} [supportedRunModes] - The supported run modes for the robotic vacuum cleaner. Defaults to a predefined set of modes.
45
- * @param {number} [currentCleanMode] - The current clean mode of the robotic vacuum cleaner. Defaults to 1 (Vacuum).
46
- * @param {RvcCleanMode.ModeOption[]} [supportedCleanModes] - The supported clean modes for the robotic vacuum cleaner. Defaults to a predefined set of modes.
47
- * @param {number | null} [currentPhase] - The current phase of the robotic vacuum cleaner. Defaults to null.
48
- * @param {string[] | null} [phaseList] - The list of phases for the robotic vacuum cleaner. Defaults to null.
49
- * @param {RvcOperationalState.OperationalState} [operationalState] - The current operational state of the robotic vacuum cleaner. Defaults to Docked.
50
- * @param {RvcOperationalState.OperationalStateStruct[]} [operationalStateList] - The list of operational states for the robotic vacuum cleaner. Defaults to a predefined set of states.
51
- * @param {ServiceArea.Area[]} [supportedAreas] - The supported areas for the robotic vacuum cleaner. Defaults to a predefined set of areas.
52
- * @param {number[]} [selectedAreas] - The selected areas for the robotic vacuum cleaner. Defaults to an empty array (all areas allowed).
53
- * @param {number} [currentArea] - The current area of the robotic vacuum cleaner. Defaults to 1 (Living).
54
- */
55
14
  constructor(name, serial, mode = undefined, currentRunMode, supportedRunModes, currentCleanMode, supportedCleanModes, currentPhase = null, phaseList = null, operationalState, operationalStateList, supportedAreas, selectedAreas, currentArea) {
56
15
  super([roboticVacuumCleaner, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}`, mode }, true);
57
16
  this.createDefaultIdentifyClusterServer()
@@ -62,17 +21,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
62
21
  .createDefaultRvcOperationalStateClusterServer(phaseList, currentPhase, operationalStateList, operationalState)
63
22
  .createDefaultServiceAreaClusterServer(supportedAreas, selectedAreas, currentArea);
64
23
  }
65
- /**
66
- * Creates a default RvcRunMode Cluster Server.
67
- *
68
- * @param {number} [currentMode] - The current mode of the RvcRunMode cluster. Defaults to 1 (Idle).
69
- * @param {RvcRunMode.ModeOption[]} [supportedModes] - The supported modes for the RvcRunMode cluster. Defaults to a predefined set of modes.
70
- *
71
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
72
- *
73
- * @remarks
74
- * - supportedModes is a fixed attribute that defines the run modes available for the robotic vacuum cleaner.
75
- */
76
24
  createDefaultRvcRunModeClusterServer(currentMode, supportedModes) {
77
25
  this.behaviors.require(MatterbridgeRvcRunModeServer, {
78
26
  supportedModes: supportedModes ?? [
@@ -85,17 +33,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
85
33
  });
86
34
  return this;
87
35
  }
88
- /**
89
- * Creates a default RvcCleanMode Cluster Server.
90
- *
91
- * @param {number} [currentMode] - The current mode of the RvcCleanMode cluster. Defaults to 1 (Vacuum).
92
- * @param {RvcCleanMode.ModeOption[]} [supportedModes] - The supported modes for the RvcCleanMode cluster. Defaults to a predefined set of modes.
93
- *
94
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
95
- *
96
- * @remarks
97
- * - supportedModes is a fixed attribute that defines the clean modes available for the robotic vacuum cleaner.
98
- */
99
36
  createDefaultRvcCleanModeClusterServer(currentMode, supportedModes) {
100
37
  this.behaviors.require(MatterbridgeRvcCleanModeServer, {
101
38
  supportedModes: supportedModes ?? [
@@ -107,14 +44,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
107
44
  });
108
45
  return this;
109
46
  }
110
- /**
111
- * Creates a default ServiceArea Cluster Server.
112
- *
113
- * @param {ServiceArea.Area[]} [supportedAreas] - The supported areas for the ServiceArea cluster. Defaults to a predefined set of areas.
114
- * @param {number[]} [selectedAreas] - The selected areas for the ServiceArea cluster. Defaults to an empty array (all areas allowed).
115
- * @param {number} [currentArea] - The current areaId (not the index in the array!) of the ServiceArea cluster. Defaults to 1 (Living).
116
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
117
- */
118
47
  createDefaultServiceAreaClusterServer(supportedAreas, selectedAreas, currentArea) {
119
48
  this.behaviors.require(MatterbridgeServiceAreaServer, {
120
49
  supportedAreas: supportedAreas ?? [
@@ -145,16 +74,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
145
74
  });
146
75
  return this;
147
76
  }
148
- /**
149
- * Creates a default RvcOperationalState Cluster Server.
150
- *
151
- * @param {string[] | null} [phaseList] - The list of phases for the RvcOperationalState cluster. Defaults to null.
152
- * @param {number | null} [currentPhase] - The current phase (the index of the phaseList) of the RvcOperationalState cluster. Defaults to null.
153
- * @param {RvcOperationalState.OperationalStateStruct[]} [operationalStateList] - The list of operational states for the RvcOperationalState cluster. Defaults to a predefined set of states.
154
- * @param {RvcOperationalState.OperationalState} [operationalState] - The current operationalStateId of the RvcOperationalState cluster. Defaults to Docked.
155
- * @param {RvcOperationalState.ErrorStateStruct} [operationalError] - The current operational error of the RvcOperationalState cluster. Defaults to NoError.
156
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
157
- */
158
77
  createDefaultRvcOperationalStateClusterServer(phaseList = null, currentPhase = null, operationalStateList, operationalState, operationalError) {
159
78
  this.behaviors.require(MatterbridgeRvcOperationalStateServer, {
160
79
  phaseList,
@@ -164,9 +83,9 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
164
83
  { operationalStateId: RvcOperationalState.OperationalState.Running, operationalStateLabel: 'Running' },
165
84
  { operationalStateId: RvcOperationalState.OperationalState.Paused, operationalStateLabel: 'Paused' },
166
85
  { operationalStateId: RvcOperationalState.OperationalState.Error, operationalStateLabel: 'Error' },
167
- { operationalStateId: RvcOperationalState.OperationalState.SeekingCharger, operationalStateLabel: 'SeekingCharger' }, // Y RVC Pause Compatibility N RVC Resume Compatibility
168
- { operationalStateId: RvcOperationalState.OperationalState.Charging, operationalStateLabel: 'Charging' }, // N RVC Pause Compatibility Y RVC Resume Compatibility
169
- { operationalStateId: RvcOperationalState.OperationalState.Docked, operationalStateLabel: 'Docked' }, // N RVC Pause Compatibility Y RVC Resume Compatibility
86
+ { operationalStateId: RvcOperationalState.OperationalState.SeekingCharger, operationalStateLabel: 'SeekingCharger' },
87
+ { operationalStateId: RvcOperationalState.OperationalState.Charging, operationalStateLabel: 'Charging' },
88
+ { operationalStateId: RvcOperationalState.OperationalState.Docked, operationalStateLabel: 'Docked' },
170
89
  ],
171
90
  operationalState: operationalState ?? RvcOperationalState.OperationalState.Docked,
172
91
  operationalError: operationalError ?? { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' },
@@ -221,7 +140,7 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
221
140
  device.log.info(`Pause (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
222
141
  device.commandHandler.executeHandler('pause', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
223
142
  device.log.debug('MatterbridgeRvcOperationalStateServer: pause called setting operational state to Paused and currentMode to Idle');
224
- this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1; // RvcRunMode.ModeTag.Idle
143
+ this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1;
225
144
  this.state.operationalState = RvcOperationalState.OperationalState.Paused;
226
145
  this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
227
146
  return {
@@ -233,7 +152,7 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
233
152
  device.log.info(`Resume (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
234
153
  device.commandHandler.executeHandler('resume', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
235
154
  device.log.debug('MatterbridgeRvcOperationalStateServer: resume called setting operational state to Running and currentMode to Cleaning');
236
- this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 2; // RvcRunMode.ModeTag.Cleaning
155
+ this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 2;
237
156
  this.state.operationalState = RvcOperationalState.OperationalState.Running;
238
157
  this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
239
158
  return {
@@ -241,12 +160,11 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
241
160
  };
242
161
  }
243
162
  goHome() {
244
- // const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
245
163
  const device = this.endpoint.stateOf(MatterbridgeServer);
246
164
  device.log.info(`GoHome (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
247
165
  device.commandHandler.executeHandler('goHome', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
248
166
  device.log.debug('MatterbridgeRvcOperationalStateServer: goHome called setting operational state to Docked and currentMode to Idle');
249
- this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1; // RvcRunMode.ModeTag.Idle
167
+ this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1;
250
168
  this.state.operationalState = RvcOperationalState.OperationalState.Docked;
251
169
  this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
252
170
  return {
@@ -254,4 +172,3 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
254
172
  };
255
173
  }
256
174
  }
257
- //# sourceMappingURL=roboticVacuumCleaner.js.map
@@ -1,45 +1,8 @@
1
- /**
2
- * @description This file contains the SolarPower class.
3
- * @file src/devices/solarPower.ts
4
- * @author Luca Liguori
5
- * @contributor Ludovic BOUÉ
6
- * @created 2025-06-14
7
- * @version 1.0.0
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2025, 2026, 2027 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
- // @matter
25
1
  import { PowerSourceTag } from '@matter/main';
26
2
  import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
27
- // Matterbridge
28
3
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
29
4
  import { deviceEnergyManagement, electricalSensor, solarPower, powerSource } from '../matterbridgeDeviceTypes.js';
30
5
  export class SolarPower extends MatterbridgeEndpoint {
31
- /**
32
- * Creates an instance of the SolarPower class.
33
- *
34
- * @param {string} name - The name of the SolarPower.
35
- * @param {string} serial - The serial number of the SolarPower.
36
- * @param {number} voltage - The voltage value in millivolts.
37
- * @param {number} current - The current value in milliamperes.
38
- * @param {number} power - The power value in milliwatts.
39
- * @param {number} energyExported - The total production value in mW/h.
40
- * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
41
- * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
42
- */
43
6
  constructor(name, serial, voltage = null, current = null, power = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
44
7
  super([solarPower, powerSource, electricalSensor, deviceEnergyManagement], {
45
8
  tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Solar.namespaceId, tag: PowerSourceTag.Solar.tag, label: null }],
@@ -56,4 +19,3 @@ export class SolarPower extends MatterbridgeEndpoint {
56
19
  .addRequiredClusterServers();
57
20
  }
58
21
  }
59
- //# sourceMappingURL=solarPower.js.map
@@ -1,26 +1,3 @@
1
- /**
2
- * @description This file contains the WaterHeater class.
3
- * @file src/devices/waterHeater.ts
4
- * @author Luca Liguori
5
- * @contributor Ludovic BOUÉ
6
- * @created 2025-05-18
7
- * @version 1.1.0
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2025, 2026, 2027 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
1
  import { ModeBase } from '@matter/main/clusters/mode-base';
25
2
  import { WaterHeaterManagement } from '@matter/main/clusters/water-heater-management';
26
3
  import { WaterHeaterMode } from '@matter/main/clusters/water-heater-mode';
@@ -31,29 +8,6 @@ import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
31
8
  import { electricalSensor, powerSource, waterHeater } from '../matterbridgeDeviceTypes.js';
32
9
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
33
10
  export class WaterHeater extends MatterbridgeEndpoint {
34
- /**
35
- * Creates an instance of the WaterHeater class.
36
- *
37
- * @param {string} name - The name of the water heater.
38
- * @param {string} serial - The serial number of the water heater.
39
- * @param {number} [waterTemperature] - The current water temperature. Defaults to 50.
40
- * @param {number} [targetWaterTemperature] - The target water temperature. Defaults to 55.
41
- * @param {number} [minHeatSetpointLimit] - The minimum heat setpoint limit. Defaults to 20.
42
- * @param {number} [maxHeatSetpointLimit] - The maximum heat setpoint limit. Defaults to 80.
43
- * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
44
- * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
45
- * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
46
- * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
47
- * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
48
- * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
49
- * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 90.
50
- * @param {number} [voltage] - The voltage value in millivolts. Defaults to null if not provided.
51
- * @param {number} [current] - The current value in milliamperes. Defaults to null if not provided.
52
- * @param {number} [power] - The power value in milliwatts. Defaults to null if not provided.
53
- * @param {number} [energy] - The total consumption value in mW/h. Defaults to null if not provided.
54
- * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
55
- * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
56
- */
57
11
  constructor(name, serial, waterTemperature = 50, targetWaterTemperature = 55, minHeatSetpointLimit = 20, maxHeatSetpointLimit = 80, heaterTypes = { immersionElement1: true }, tankPercentage = 90, voltage = null, current = null, power = null, energy = null, absMinPower = 0, absMaxPower = 0) {
58
12
  super([waterHeater, powerSource, electricalSensor], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
59
13
  this.createDefaultIdentifyClusterServer()
@@ -68,42 +22,15 @@ export class WaterHeater extends MatterbridgeEndpoint {
68
22
  .createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.WaterHeating, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
69
23
  .createDefaultDeviceEnergyManagementModeClusterServer();
70
24
  }
71
- /**
72
- * Creates a default WaterHeaterManagement Cluster Server.
73
- *
74
- * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
75
- * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
76
- * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
77
- * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
78
- * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
79
- * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
80
- * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heatDemand] - Indicates if the water heater is heating water. Defaults to all heat sources unset.
81
- * @param {boolean} heatDemand.immersionElement1 - Indicates if the water heater is heating water with immersion element 1. Defaults to false.
82
- * @param {boolean} heatDemand.immersionElement2 - Indicates if the water heater is heating water with immersion element 2.
83
- * @param {boolean} heatDemand.heatPump - Indicates if the water heater is heating water with a heat pump.
84
- * @param {boolean} heatDemand.boiler - Indicates if the water heater is heating water with a boiler.
85
- * @param {boolean} heatDemand.other - Indicates if the water heater is heating water with other types of heating sources.
86
- * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 100.
87
- * @param {WaterHeaterManagement.BoostState} [boostState] - The current boost state of the WaterHeaterManagement cluster. Defaults to Inactive.
88
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
89
- */
90
25
  createDefaultWaterHeaterManagementClusterServer(heaterTypes, heatDemand, tankPercentage, boostState) {
91
26
  this.behaviors.require(MatterbridgeWaterHeaterManagementServer.with(WaterHeaterManagement.Feature.TankPercent), {
92
- heaterTypes: heaterTypes ?? { immersionElement1: true }, // Fixed attribute
27
+ heaterTypes: heaterTypes ?? { immersionElement1: true },
93
28
  heatDemand: heatDemand ?? {},
94
29
  tankPercentage: tankPercentage ?? 100,
95
30
  boostState: boostState ?? WaterHeaterManagement.BoostState.Inactive,
96
31
  });
97
32
  return this;
98
33
  }
99
- /**
100
- * Creates a default WaterHeaterMode Cluster Server.
101
- *
102
- * @param {number} [currentMode] - The current mode of the WaterHeaterMode cluster. Defaults to mode 1 (WaterHeaterMode.ModeTag.Auto).
103
- * @param {WaterHeaterMode.ModeOption[]} [supportedModes] - The supported modes for the WaterHeaterMode cluster. Defaults all cluster modes.
104
- *
105
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
106
- */
107
34
  createDefaultWaterHeaterModeClusterServer(currentMode, supportedModes) {
108
35
  this.behaviors.require(MatterbridgeWaterHeaterModeServer, {
109
36
  supportedModes: supportedModes ?? [
@@ -120,7 +47,7 @@ export class WaterHeater extends MatterbridgeEndpoint {
120
47
  { label: 'Off', mode: 11, modeTags: [{ value: WaterHeaterMode.ModeTag.Off }] },
121
48
  { label: 'Manual', mode: 12, modeTags: [{ value: WaterHeaterMode.ModeTag.Manual }] },
122
49
  { label: 'Timed', mode: 13, modeTags: [{ value: WaterHeaterMode.ModeTag.Timed }] },
123
- ], // Fixed attribute
50
+ ],
124
51
  currentMode: currentMode ?? 1,
125
52
  });
126
53
  return this;
@@ -133,9 +60,6 @@ export class MatterbridgeWaterHeaterManagementServer extends WaterHeaterManageme
133
60
  device.commandHandler.executeHandler('boost', { request, cluster: WaterHeaterManagementServer.id, attributes: this.state, endpoint: this.endpoint });
134
61
  device.log.debug(`MatterbridgeWaterHeaterManagementServer boost called with: ${JSON.stringify(request)}`);
135
62
  this.state.boostState = WaterHeaterManagement.BoostState.Active;
136
- // The implementation is responsible for setting the device accordingly with the boostInfo of the boost command
137
- // super.boost({ boostInfo });
138
- // boost is not implemented in matter.js
139
63
  }
140
64
  cancelBoost() {
141
65
  const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -143,9 +67,6 @@ export class MatterbridgeWaterHeaterManagementServer extends WaterHeaterManageme
143
67
  device.commandHandler.executeHandler('cancelBoost', { request: {}, cluster: WaterHeaterManagementServer.id, attributes: this.state, endpoint: this.endpoint });
144
68
  device.log.debug(`MatterbridgeWaterHeaterManagementServer cancelBoost called`);
145
69
  this.state.boostState = WaterHeaterManagement.BoostState.Inactive;
146
- // The implementation is responsible for setting the device accordingly with the cancelBoost command
147
- // super.cancelBoost();
148
- // cancelBoost is not implemented in matter.js
149
70
  }
150
71
  }
151
72
  export class MatterbridgeWaterHeaterModeServer extends WaterHeaterModeServer {
@@ -163,4 +84,3 @@ export class MatterbridgeWaterHeaterModeServer extends WaterHeaterModeServer {
163
84
  return { status: ModeBase.ModeChangeStatus.Success, statusText: 'Success' };
164
85
  }
165
86
  }
166
- //# sourceMappingURL=waterHeater.js.map