@coffeerunhobby/mcp-ha-connect 2.2.1 → 2.4.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.
Files changed (293) hide show
  1. package/.env.example +1 -1
  2. package/README.md +24 -2
  3. package/dist/omadaClient/accessControl.d.ts +290 -0
  4. package/dist/omadaClient/accessControl.js +509 -0
  5. package/dist/omadaClient/accessControl.js.map +1 -0
  6. package/dist/omadaClient/client.d.ts +6 -1
  7. package/dist/omadaClient/client.js +12 -1
  8. package/dist/omadaClient/client.js.map +1 -1
  9. package/dist/omadaClient/diagnose.d.ts +68 -0
  10. package/dist/omadaClient/diagnose.js +164 -0
  11. package/dist/omadaClient/diagnose.js.map +1 -0
  12. package/dist/omadaClient/index.d.ts +9 -0
  13. package/dist/omadaClient/index.js +19 -0
  14. package/dist/omadaClient/index.js.map +1 -1
  15. package/dist/omadaClient/macGroups.d.ts +58 -0
  16. package/dist/omadaClient/macGroups.js +110 -0
  17. package/dist/omadaClient/macGroups.js.map +1 -0
  18. package/dist/omadaClient/serialize.d.ts +13 -0
  19. package/dist/omadaClient/serialize.js +29 -0
  20. package/dist/omadaClient/serialize.js.map +1 -0
  21. package/dist/omadaClient/timeRange.d.ts +41 -0
  22. package/dist/omadaClient/timeRange.js +109 -0
  23. package/dist/omadaClient/timeRange.js.map +1 -0
  24. package/dist/tools/infra/actions.d.ts +1 -1
  25. package/dist/tools/infra/actions.js +1 -1
  26. package/dist/tools/omada/accessControl.d.ts +151 -0
  27. package/dist/tools/omada/accessControl.js +158 -0
  28. package/dist/tools/omada/accessControl.js.map +1 -0
  29. package/dist/tools/omada/index.js +9 -0
  30. package/dist/tools/omada/index.js.map +1 -1
  31. package/dist/tools/omada/macGroups.d.ts +19 -0
  32. package/dist/tools/omada/macGroups.js +77 -0
  33. package/dist/tools/omada/macGroups.js.map +1 -0
  34. package/dist/tools/omada/namespace.js +16 -0
  35. package/dist/tools/omada/namespace.js.map +1 -1
  36. package/dist/version.d.ts +1 -1
  37. package/dist/version.js +1 -1
  38. package/package.json +5 -1
  39. package/.codex/review-rules.md +0 -16
  40. package/.dockerignore +0 -8
  41. package/.gitattributes +0 -30
  42. package/.github/workflows/ci.yml +0 -193
  43. package/AGENTS.md +0 -389
  44. package/Dockerfile +0 -50
  45. package/docker-compose.yml +0 -23
  46. package/docs/CHANGELOG.md +0 -341
  47. package/docs/COVERAGE.md +0 -219
  48. package/docs/QUICK_START.md +0 -240
  49. package/eslint.config.js +0 -33
  50. package/n8n/ai-agent-safety-monitor.json +0 -355
  51. package/openapi.json +0 -1259
  52. package/scripts/check-version-sync.mjs +0 -69
  53. package/scripts/generate-jwt.ts +0 -121
  54. package/src/config.ts +0 -440
  55. package/src/haClient/automations.ts +0 -261
  56. package/src/haClient/calendars.ts +0 -94
  57. package/src/haClient/config.ts +0 -52
  58. package/src/haClient/devices.ts +0 -653
  59. package/src/haClient/entities.ts +0 -128
  60. package/src/haClient/events.ts +0 -689
  61. package/src/haClient/history.ts +0 -73
  62. package/src/haClient/index.ts +0 -336
  63. package/src/haClient/request.ts +0 -142
  64. package/src/haClient/services.ts +0 -45
  65. package/src/haClient/states.ts +0 -60
  66. package/src/haClient/updates.ts +0 -58
  67. package/src/haClient/wsCommand.ts +0 -44
  68. package/src/index.ts +0 -164
  69. package/src/localAI/index.ts +0 -88
  70. package/src/localAI/prompts.ts +0 -50
  71. package/src/localAI/providers/base.ts +0 -120
  72. package/src/localAI/providers/ollama.ts +0 -78
  73. package/src/localAI/providers/openai.ts +0 -86
  74. package/src/localAI/types.ts +0 -67
  75. package/src/omadaClient/auth.ts +0 -178
  76. package/src/omadaClient/client.ts +0 -337
  77. package/src/omadaClient/device.ts +0 -118
  78. package/src/omadaClient/index.ts +0 -310
  79. package/src/omadaClient/network.ts +0 -284
  80. package/src/omadaClient/request.ts +0 -365
  81. package/src/omadaClient/security.ts +0 -51
  82. package/src/omadaClient/site.ts +0 -344
  83. package/src/ownerQuestions/service.ts +0 -536
  84. package/src/permissions/index.ts +0 -143
  85. package/src/resources/index.ts +0 -213
  86. package/src/server/auth.ts +0 -175
  87. package/src/server/chatFace.ts +0 -789
  88. package/src/server/chatSlice.ts +0 -57
  89. package/src/server/common.ts +0 -170
  90. package/src/server/eventSubscription.ts +0 -343
  91. package/src/server/http.ts +0 -626
  92. package/src/server/instructions.ts +0 -97
  93. package/src/server/rateLimiter.ts +0 -227
  94. package/src/server/stdio.ts +0 -41
  95. package/src/server/stream.ts +0 -205
  96. package/src/tools/ai/analyzeSensors.ts +0 -33
  97. package/src/tools/ai/index.ts +0 -20
  98. package/src/tools/common.ts +0 -442
  99. package/src/tools/homeassistant/askOwner.ts +0 -133
  100. package/src/tools/homeassistant/automationControls.ts +0 -66
  101. package/src/tools/homeassistant/calendar.ts +0 -97
  102. package/src/tools/homeassistant/callService.ts +0 -25
  103. package/src/tools/homeassistant/controlClimate.ts +0 -68
  104. package/src/tools/homeassistant/controlCover.ts +0 -48
  105. package/src/tools/homeassistant/controlFan.ts +0 -44
  106. package/src/tools/homeassistant/controlLight.ts +0 -38
  107. package/src/tools/homeassistant/controlMediaPlayer.ts +0 -50
  108. package/src/tools/homeassistant/createAutomation.ts +0 -35
  109. package/src/tools/homeassistant/deleteAutomation.ts +0 -24
  110. package/src/tools/homeassistant/entityAction.ts +0 -35
  111. package/src/tools/homeassistant/entityGuard.ts +0 -28
  112. package/src/tools/homeassistant/getAllSensors.ts +0 -46
  113. package/src/tools/homeassistant/getAutomationTrace.ts +0 -30
  114. package/src/tools/homeassistant/getDomainSummary.ts +0 -29
  115. package/src/tools/homeassistant/getEntitiesByDomain.ts +0 -56
  116. package/src/tools/homeassistant/getHistory.ts +0 -24
  117. package/src/tools/homeassistant/getState.ts +0 -24
  118. package/src/tools/homeassistant/getStates.ts +0 -46
  119. package/src/tools/homeassistant/getVersion.ts +0 -21
  120. package/src/tools/homeassistant/index.ts +0 -121
  121. package/src/tools/homeassistant/listAutomations.ts +0 -35
  122. package/src/tools/homeassistant/listEntities.ts +0 -44
  123. package/src/tools/homeassistant/listPersons.ts +0 -46
  124. package/src/tools/homeassistant/sceneAndScript.ts +0 -53
  125. package/src/tools/homeassistant/searchEntities.ts +0 -58
  126. package/src/tools/homeassistant/sendNotification.ts +0 -179
  127. package/src/tools/homeassistant/systemTools.ts +0 -52
  128. package/src/tools/homeassistant/triggerAutomation.ts +0 -24
  129. package/src/tools/index.ts +0 -78
  130. package/src/tools/infra/actions.ts +0 -95
  131. package/src/tools/infra/index.ts +0 -138
  132. package/src/tools/omada/blockClient.ts +0 -28
  133. package/src/tools/omada/cyclePoePort.ts +0 -32
  134. package/src/tools/omada/deleteClient.ts +0 -27
  135. package/src/tools/omada/disableClientRateLimit.ts +0 -23
  136. package/src/tools/omada/getClient.ts +0 -14
  137. package/src/tools/omada/getDevice.ts +0 -14
  138. package/src/tools/omada/getFirewallSetting.ts +0 -14
  139. package/src/tools/omada/getInternetInfo.ts +0 -14
  140. package/src/tools/omada/getLanNetworkList.ts +0 -14
  141. package/src/tools/omada/getLanProfileList.ts +0 -14
  142. package/src/tools/omada/getPortForwardingStatus.ts +0 -26
  143. package/src/tools/omada/getRateLimitProfiles.ts +0 -14
  144. package/src/tools/omada/getSiteNtpStatus.ts +0 -14
  145. package/src/tools/omada/getSsidDetail.ts +0 -22
  146. package/src/tools/omada/getSsidList.ts +0 -21
  147. package/src/tools/omada/getSwitchStackDetail.ts +0 -14
  148. package/src/tools/omada/getThreatList.ts +0 -42
  149. package/src/tools/omada/getWlanGroupList.ts +0 -14
  150. package/src/tools/omada/graph.ts +0 -187
  151. package/src/tools/omada/index.ts +0 -153
  152. package/src/tools/omada/listBlockedClients.ts +0 -17
  153. package/src/tools/omada/listClients.ts +0 -14
  154. package/src/tools/omada/listClientsActivity.ts +0 -25
  155. package/src/tools/omada/listClientsPastConnections.ts +0 -44
  156. package/src/tools/omada/listDevices.ts +0 -14
  157. package/src/tools/omada/listDevicesStats.ts +0 -41
  158. package/src/tools/omada/listMostActiveClients.ts +0 -14
  159. package/src/tools/omada/listSites.ts +0 -18
  160. package/src/tools/omada/namespace.ts +0 -1164
  161. package/src/tools/omada/searchDevices.ts +0 -20
  162. package/src/tools/omada/setClientRateLimit.ts +0 -26
  163. package/src/tools/omada/setClientRateLimitProfile.ts +0 -25
  164. package/src/tools/omada/setSiteNtpServers.ts +0 -36
  165. package/src/tools/omada/setSsidEnabled.ts +0 -38
  166. package/src/tools/omada/unblockClient.ts +0 -26
  167. package/src/tools/types.ts +0 -11
  168. package/src/tools/utils/pagination-schema.ts +0 -27
  169. package/src/types/ai/index.ts +0 -11
  170. package/src/types/ai/types.ts +0 -67
  171. package/src/types/homeassistant/automations.ts +0 -43
  172. package/src/types/homeassistant/calendars.ts +0 -26
  173. package/src/types/homeassistant/config.ts +0 -14
  174. package/src/types/homeassistant/entities.ts +0 -14
  175. package/src/types/homeassistant/errors.ts +0 -33
  176. package/src/types/homeassistant/haConfig.ts +0 -7
  177. package/src/types/homeassistant/history.ts +0 -13
  178. package/src/types/homeassistant/index.ts +0 -46
  179. package/src/types/homeassistant/request.ts +0 -6
  180. package/src/types/homeassistant/serviceCall.ts +0 -18
  181. package/src/types/homeassistant/states.ts +0 -58
  182. package/src/types/homeassistant/updates.ts +0 -28
  183. package/src/types/index.ts +0 -12
  184. package/src/types/omada/activeClientInfo.ts +0 -17
  185. package/src/types/omada/clientActivity.ts +0 -32
  186. package/src/types/omada/clientBlockStatus.ts +0 -11
  187. package/src/types/omada/clientPastConnection.ts +0 -82
  188. package/src/types/omada/index.ts +0 -14
  189. package/src/types/omada/omadaApiResponse.ts +0 -5
  190. package/src/types/omada/omadaClientInfo.ts +0 -11
  191. package/src/types/omada/omadaDeviceInfo.ts +0 -11
  192. package/src/types/omada/omadaDeviceStats.ts +0 -31
  193. package/src/types/omada/omadaSiteSummary.ts +0 -5
  194. package/src/types/omada/oswStackDetail.ts +0 -11
  195. package/src/types/omada/paginatedResult.ts +0 -6
  196. package/src/types/omada/rateLimitProfile.ts +0 -58
  197. package/src/types/omada/threatInfo.ts +0 -38
  198. package/src/types/omada/tokenResult.ts +0 -6
  199. package/src/types.ts +0 -2
  200. package/src/utils/config-validations.ts +0 -68
  201. package/src/utils/jwt.ts +0 -112
  202. package/src/utils/logger.ts +0 -121
  203. package/src/utils/plainText.ts +0 -48
  204. package/src/utils/redact.ts +0 -59
  205. package/src/utils/sanitizeError.ts +0 -18
  206. package/src/utils/tlsDispatcher.ts +0 -69
  207. package/src/version.ts +0 -5
  208. package/tests/bdd/automation-creation.spec.ts +0 -214
  209. package/tests/bdd/automation-management.spec.ts +0 -267
  210. package/tests/bdd/calendar.spec.ts +0 -190
  211. package/tests/bdd/configuration.spec.ts +0 -283
  212. package/tests/bdd/device-control.spec.ts +0 -344
  213. package/tests/bdd/entity-listing.spec.ts +0 -208
  214. package/tests/bdd/entity-search.spec.ts +0 -183
  215. package/tests/bdd/history-retrieval.spec.ts +0 -195
  216. package/tests/bdd/notifications.spec.ts +0 -238
  217. package/tests/bdd/service-calls.spec.ts +0 -144
  218. package/tests/bdd/state-retrieval.spec.ts +0 -204
  219. package/tests/bench/hotpaths.bench.ts +0 -68
  220. package/tests/config.test.ts +0 -355
  221. package/tests/features/automation-creation.feature +0 -36
  222. package/tests/features/automation-management.feature +0 -54
  223. package/tests/features/calendar.feature +0 -37
  224. package/tests/features/configuration.feature +0 -70
  225. package/tests/features/device-control.feature +0 -100
  226. package/tests/features/entity-listing.feature +0 -51
  227. package/tests/features/entity-search.feature +0 -44
  228. package/tests/features/history-retrieval.feature +0 -38
  229. package/tests/features/notifications.feature +0 -37
  230. package/tests/features/service-calls.feature +0 -35
  231. package/tests/features/state-retrieval.feature +0 -37
  232. package/tests/fixtures/openapi-default-slice.json +0 -290
  233. package/tests/haClient/automationTrace.test.ts +0 -59
  234. package/tests/haClient/automations.test.ts +0 -149
  235. package/tests/haClient/config.test.ts +0 -117
  236. package/tests/haClient/entities.test.ts +0 -188
  237. package/tests/haClient/events.test.ts +0 -455
  238. package/tests/haClient/eventsTls.test.ts +0 -52
  239. package/tests/haClient/history.test.ts +0 -228
  240. package/tests/haClient/index.test.ts +0 -243
  241. package/tests/haClient/request.test.ts +0 -217
  242. package/tests/haClient/services.test.ts +0 -120
  243. package/tests/haClient/states.test.ts +0 -119
  244. package/tests/haClient/updates.test.ts +0 -193
  245. package/tests/index.test.ts +0 -160
  246. package/tests/integration/homeassistant.test.ts +0 -144
  247. package/tests/integration/omada.test.ts +0 -167
  248. package/tests/integration/server.test.ts +0 -151
  249. package/tests/localAI/index.test.ts +0 -177
  250. package/tests/localAI/ollama.test.ts +0 -187
  251. package/tests/localAI/openai.test.ts +0 -257
  252. package/tests/omadaClient/actions.test.ts +0 -161
  253. package/tests/omadaClient/clientBlocks.test.ts +0 -170
  254. package/tests/omadaClient/ntp.test.ts +0 -381
  255. package/tests/omadaClient/site.test.ts +0 -37
  256. package/tests/ownerQuestions/service.test.ts +0 -499
  257. package/tests/ownerQuestions/tools.test.ts +0 -186
  258. package/tests/permissions/index.test.ts +0 -217
  259. package/tests/resources/index.test.ts +0 -288
  260. package/tests/scripts/generateJwt.test.ts +0 -44
  261. package/tests/security/accessControl.test.ts +0 -223
  262. package/tests/security/authentication.test.ts +0 -117
  263. package/tests/security/configuration.test.ts +0 -170
  264. package/tests/security/cryptoTransport.test.ts +0 -172
  265. package/tests/security/dependencies.test.ts +0 -152
  266. package/tests/security/injection.test.ts +0 -117
  267. package/tests/security/insecureDesign.test.ts +0 -121
  268. package/tests/security/logging.test.ts +0 -131
  269. package/tests/security/resourceConsumption.test.ts +0 -142
  270. package/tests/server/auth.test.ts +0 -249
  271. package/tests/server/chatFace.test.ts +0 -320
  272. package/tests/server/common.test.ts +0 -84
  273. package/tests/server/http.test.ts +0 -561
  274. package/tests/server/instructions.test.ts +0 -152
  275. package/tests/server/memoizeJsonSchema.test.ts +0 -71
  276. package/tests/server/stdio.test.ts +0 -99
  277. package/tests/server/stream.test.ts +0 -285
  278. package/tests/server/toolVisibility.http.test.ts +0 -111
  279. package/tests/server/toolVisibility.test.ts +0 -129
  280. package/tests/tools/ai/analyzeSensors.test.ts +0 -227
  281. package/tests/tools/common.test.ts +0 -123
  282. package/tests/tools/homeassistant/handlers.test.ts +0 -872
  283. package/tests/tools/infra/invokeAction.test.ts +0 -280
  284. package/tests/tools/omada/graph.test.ts +0 -385
  285. package/tests/tools/omada/handlers.test.ts +0 -897
  286. package/tests/tools/omada/namespace.test.ts +0 -483
  287. package/tests/tools/registry.test.ts +0 -168
  288. package/tests/utils/config-validations.test.ts +0 -352
  289. package/tests/utils/jwt.test.ts +0 -115
  290. package/tests/utils/logger.test.ts +0 -327
  291. package/tests/utils/redact.test.ts +0 -105
  292. package/tsconfig.json +0 -24
  293. package/vitest.config.ts +0 -38
@@ -1,344 +0,0 @@
1
- /**
2
- * BDD tests for Device Control
3
- * Uses vitest-cucumber for Gherkin syntax
4
- */
5
-
6
- import { loadFeature, describeFeature } from '@amiceli/vitest-cucumber';
7
- import { expect, vi } from 'vitest';
8
- import { DeviceOperations } from '../../src/haClient/devices.js';
9
- import type { ServiceOperations } from '../../src/haClient/services.js';
10
- import type { StateOperations } from '../../src/haClient/states.js';
11
-
12
- const feature = await loadFeature('tests/features/device-control.feature');
13
-
14
- describeFeature(feature, ({ Scenario }) => {
15
- // Shared test state
16
- let mockServiceOps: ServiceOperations;
17
- let mockStateOps: StateOperations;
18
- let deviceOps: DeviceOperations;
19
- let entityId: string;
20
- let lastServiceCall: { domain: string; service: string; data: Record<string, unknown> } | null;
21
-
22
- function setupMocks() {
23
- lastServiceCall = null;
24
- mockServiceOps = {
25
- callService: vi.fn().mockImplementation(async (data) => {
26
- lastServiceCall = {
27
- domain: data.domain,
28
- service: data.service,
29
- data: { ...data.service_data, entity_id: data.target?.entity_id },
30
- };
31
- return { context: { id: 'test-ctx' } };
32
- }),
33
- } as unknown as ServiceOperations;
34
-
35
- mockStateOps = {
36
- getState: vi.fn().mockResolvedValue({
37
- entity_id: entityId,
38
- state: 'off',
39
- attributes: {},
40
- }),
41
- } as unknown as StateOperations;
42
-
43
- deviceOps = new DeviceOperations(mockServiceOps, mockStateOps);
44
- }
45
-
46
- // ===== Light Control =====
47
-
48
- Scenario('Turn on a light', ({ Given, When, Then, And }) => {
49
- Given('a light entity "light.living_room" that is "off"', () => {
50
- entityId = 'light.living_room';
51
- setupMocks();
52
- });
53
-
54
- When('I turn on the light', async () => {
55
- await deviceOps.turnOnLight(entityId);
56
- });
57
-
58
- Then('the light service "turn_on" should be called', () => {
59
- expect(lastServiceCall?.domain).toBe('light');
60
- expect(lastServiceCall?.service).toBe('turn_on');
61
- });
62
-
63
- And('the target should be "light.living_room"', () => {
64
- expect(lastServiceCall?.data.entity_id).toBe('light.living_room');
65
- });
66
- });
67
-
68
- Scenario('Turn on a light with brightness', ({ Given, When, Then, And }) => {
69
- Given('a light entity "light.bedroom"', () => {
70
- entityId = 'light.bedroom';
71
- setupMocks();
72
- });
73
-
74
- When('I turn on the light with brightness 75%', async () => {
75
- await deviceOps.setLightBrightness(entityId, 75);
76
- });
77
-
78
- Then('the light service "turn_on" should be called', () => {
79
- expect(lastServiceCall?.service).toBe('turn_on');
80
- });
81
-
82
- And('the service data should include brightness_pct 75', () => {
83
- expect(lastServiceCall?.data.brightness_pct).toBe(75);
84
- });
85
- });
86
-
87
- Scenario('Set light color temperature', ({ Given, When, Then, And }) => {
88
- Given('a light entity "light.kitchen"', () => {
89
- entityId = 'light.kitchen';
90
- setupMocks();
91
- });
92
-
93
- When('I set the color temperature to 4000K', async () => {
94
- await deviceOps.setLightColorTemp(entityId, 4000);
95
- });
96
-
97
- Then('the light service "turn_on" should be called', () => {
98
- expect(lastServiceCall?.service).toBe('turn_on');
99
- });
100
-
101
- And('the service data should include color_temp_kelvin 4000', () => {
102
- expect(lastServiceCall?.data.color_temp_kelvin).toBe(4000);
103
- });
104
- });
105
-
106
- Scenario('Set light RGB color', ({ Given, When, Then, And }) => {
107
- Given('a light entity "light.office"', () => {
108
- entityId = 'light.office';
109
- setupMocks();
110
- });
111
-
112
- When('I set the RGB color to red (255, 0, 0)', async () => {
113
- await deviceOps.setLightColor(entityId, [255, 0, 0]);
114
- });
115
-
116
- Then('the light service "turn_on" should be called', () => {
117
- expect(lastServiceCall?.service).toBe('turn_on');
118
- });
119
-
120
- And('the service data should include rgb_color [255, 0, 0]', () => {
121
- expect(lastServiceCall?.data.rgb_color).toEqual([255, 0, 0]);
122
- });
123
- });
124
-
125
- // ===== Climate Control =====
126
-
127
- Scenario('Set thermostat temperature', ({ Given, When, Then, And }) => {
128
- Given('a climate entity "climate.living_room"', () => {
129
- entityId = 'climate.living_room';
130
- setupMocks();
131
- });
132
-
133
- When('I set the temperature to 22 degrees', async () => {
134
- await deviceOps.setClimateTemperature(entityId, 22);
135
- });
136
-
137
- Then('the climate service "set_temperature" should be called', () => {
138
- expect(lastServiceCall?.domain).toBe('climate');
139
- expect(lastServiceCall?.service).toBe('set_temperature');
140
- });
141
-
142
- And('the service data should include temperature 22', () => {
143
- expect(lastServiceCall?.data.temperature).toBe(22);
144
- });
145
- });
146
-
147
- Scenario('Set HVAC mode to heat', ({ Given, When, Then, And }) => {
148
- Given('a climate entity "climate.bedroom"', () => {
149
- entityId = 'climate.bedroom';
150
- setupMocks();
151
- });
152
-
153
- When('I set the HVAC mode to "heat"', async () => {
154
- await deviceOps.setClimateMode(entityId, 'heat');
155
- });
156
-
157
- Then('the climate service "set_hvac_mode" should be called', () => {
158
- expect(lastServiceCall?.service).toBe('set_hvac_mode');
159
- });
160
-
161
- And('the service data should include hvac_mode "heat"', () => {
162
- expect(lastServiceCall?.data.hvac_mode).toBe('heat');
163
- });
164
- });
165
-
166
- Scenario('Set climate preset mode', ({ Given, When, Then, And }) => {
167
- Given('a climate entity "climate.office"', () => {
168
- entityId = 'climate.office';
169
- setupMocks();
170
- });
171
-
172
- When('I set the preset mode to "eco"', async () => {
173
- await deviceOps.setClimatePreset(entityId, 'eco');
174
- });
175
-
176
- Then('the climate service "set_preset_mode" should be called', () => {
177
- expect(lastServiceCall?.service).toBe('set_preset_mode');
178
- });
179
-
180
- And('the service data should include preset_mode "eco"', () => {
181
- expect(lastServiceCall?.data.preset_mode).toBe('eco');
182
- });
183
- });
184
-
185
- // ===== Media Player Control =====
186
-
187
- Scenario('Play media player', ({ Given, When, Then }) => {
188
- Given('a media player entity "media_player.living_room"', () => {
189
- entityId = 'media_player.living_room';
190
- setupMocks();
191
- });
192
-
193
- When('I play the media player', async () => {
194
- await deviceOps.mediaPlay(entityId);
195
- });
196
-
197
- Then('the media_player service "media_play" should be called', () => {
198
- expect(lastServiceCall?.domain).toBe('media_player');
199
- expect(lastServiceCall?.service).toBe('media_play');
200
- });
201
- });
202
-
203
- Scenario('Pause media player', ({ Given, When, Then }) => {
204
- Given('a media player entity "media_player.bedroom"', () => {
205
- entityId = 'media_player.bedroom';
206
- setupMocks();
207
- });
208
-
209
- When('I pause the media player', async () => {
210
- await deviceOps.mediaPause(entityId);
211
- });
212
-
213
- Then('the media_player service "media_pause" should be called', () => {
214
- expect(lastServiceCall?.service).toBe('media_pause');
215
- });
216
- });
217
-
218
- Scenario('Set media player volume', ({ Given, When, Then, And }) => {
219
- Given('a media player entity "media_player.kitchen"', () => {
220
- entityId = 'media_player.kitchen';
221
- setupMocks();
222
- });
223
-
224
- When('I set the volume to 50%', async () => {
225
- await deviceOps.setMediaVolume(entityId, 0.5);
226
- });
227
-
228
- Then('the media_player service "volume_set" should be called', () => {
229
- expect(lastServiceCall?.service).toBe('volume_set');
230
- });
231
-
232
- And('the service data should include volume_level 0.5', () => {
233
- expect(lastServiceCall?.data.volume_level).toBe(0.5);
234
- });
235
- });
236
-
237
- // ===== Cover Control =====
238
-
239
- Scenario('Open a cover', ({ Given, When, Then }) => {
240
- Given('a cover entity "cover.garage_door"', () => {
241
- entityId = 'cover.garage_door';
242
- setupMocks();
243
- });
244
-
245
- When('I open the cover', async () => {
246
- await deviceOps.openCover(entityId);
247
- });
248
-
249
- Then('the cover service "open_cover" should be called', () => {
250
- expect(lastServiceCall?.domain).toBe('cover');
251
- expect(lastServiceCall?.service).toBe('open_cover');
252
- });
253
- });
254
-
255
- Scenario('Close a cover', ({ Given, When, Then }) => {
256
- Given('a cover entity "cover.blinds"', () => {
257
- entityId = 'cover.blinds';
258
- setupMocks();
259
- });
260
-
261
- When('I close the cover', async () => {
262
- await deviceOps.closeCover(entityId);
263
- });
264
-
265
- Then('the cover service "close_cover" should be called', () => {
266
- expect(lastServiceCall?.service).toBe('close_cover');
267
- });
268
- });
269
-
270
- Scenario('Set cover position', ({ Given, When, Then, And }) => {
271
- Given('a cover entity "cover.living_room_blinds"', () => {
272
- entityId = 'cover.living_room_blinds';
273
- setupMocks();
274
- });
275
-
276
- When('I set the cover position to 50%', async () => {
277
- await deviceOps.setCoverPosition(entityId, 50);
278
- });
279
-
280
- Then('the cover service "set_cover_position" should be called', () => {
281
- expect(lastServiceCall?.service).toBe('set_cover_position');
282
- });
283
-
284
- And('the service data should include position 50', () => {
285
- expect(lastServiceCall?.data.position).toBe(50);
286
- });
287
- });
288
-
289
- // ===== Fan Control =====
290
-
291
- Scenario('Turn on a fan', ({ Given, When, Then }) => {
292
- Given('a fan entity "fan.bedroom"', () => {
293
- entityId = 'fan.bedroom';
294
- setupMocks();
295
- });
296
-
297
- When('I turn on the fan', async () => {
298
- await deviceOps.turnOnFan(entityId);
299
- });
300
-
301
- Then('the fan service "turn_on" should be called', () => {
302
- expect(lastServiceCall?.domain).toBe('fan');
303
- expect(lastServiceCall?.service).toBe('turn_on');
304
- });
305
- });
306
-
307
- Scenario('Set fan speed', ({ Given, When, Then, And }) => {
308
- Given('a fan entity "fan.living_room"', () => {
309
- entityId = 'fan.living_room';
310
- setupMocks();
311
- });
312
-
313
- When('I set the fan speed to 75%', async () => {
314
- await deviceOps.setFanSpeed(entityId, 75);
315
- });
316
-
317
- Then('the fan service "set_percentage" should be called', () => {
318
- expect(lastServiceCall?.service).toBe('set_percentage');
319
- });
320
-
321
- And('the service data should include percentage 75', () => {
322
- expect(lastServiceCall?.data.percentage).toBe(75);
323
- });
324
- });
325
-
326
- Scenario('Toggle fan oscillation', ({ Given, When, Then, And }) => {
327
- Given('a fan entity "fan.office"', () => {
328
- entityId = 'fan.office';
329
- setupMocks();
330
- });
331
-
332
- When('I enable oscillation', async () => {
333
- await deviceOps.setFanOscillation(entityId, true);
334
- });
335
-
336
- Then('the fan service "oscillate" should be called', () => {
337
- expect(lastServiceCall?.service).toBe('oscillate');
338
- });
339
-
340
- And('the service data should include oscillating true', () => {
341
- expect(lastServiceCall?.data.oscillating).toBe(true);
342
- });
343
- });
344
- });
@@ -1,208 +0,0 @@
1
- /**
2
- * BDD tests for Entity Listing
3
- * Uses vitest-cucumber for Gherkin syntax
4
- */
5
-
6
- import { loadFeature, describeFeature } from '@amiceli/vitest-cucumber';
7
- import { expect, vi } from 'vitest';
8
- import { EntityOperations } from '../../src/haClient/entities.js';
9
- import type { StateOperations } from '../../src/haClient/states.js';
10
- import type { Entity, DomainSummary } from '../../src/types/index.js';
11
-
12
- const feature = await loadFeature('tests/features/entity-listing.feature');
13
-
14
- describeFeature(feature, ({ Scenario }) => {
15
- // Shared test state
16
- let mockStateOps: StateOperations;
17
- let entityOps: EntityOperations;
18
- let listResults: Entity[];
19
- let summary: DomainSummary;
20
-
21
- const mockEntities: Entity[] = [
22
- {
23
- entity_id: 'light.living_room',
24
- state: 'on',
25
- attributes: { friendly_name: 'Living Room Light', brightness: 255 },
26
- last_changed: '2026-01-08T10:00:00.000Z',
27
- last_updated: '2026-01-08T10:00:00.000Z',
28
- context: { id: 'ctx-1', parent_id: null, user_id: null },
29
- },
30
- {
31
- entity_id: 'light.bedroom',
32
- state: 'off',
33
- attributes: { friendly_name: 'Bedroom Light' },
34
- last_changed: '2026-01-08T09:00:00.000Z',
35
- last_updated: '2026-01-08T10:00:00.000Z',
36
- context: { id: 'ctx-2', parent_id: null, user_id: null },
37
- },
38
- {
39
- entity_id: 'sensor.temperature',
40
- state: '22.5',
41
- attributes: { friendly_name: 'Temperature', unit_of_measurement: '°C' },
42
- last_changed: '2026-01-08T10:00:00.000Z',
43
- last_updated: '2026-01-08T10:00:00.000Z',
44
- context: { id: 'ctx-3', parent_id: null, user_id: null },
45
- },
46
- {
47
- entity_id: 'switch.kitchen',
48
- state: 'on',
49
- attributes: { friendly_name: 'Kitchen Switch' },
50
- last_changed: '2026-01-08T08:00:00.000Z',
51
- last_updated: '2026-01-08T10:00:00.000Z',
52
- context: { id: 'ctx-4', parent_id: null, user_id: null },
53
- },
54
- ];
55
-
56
- function setupMocks() {
57
- mockStateOps = {
58
- getStates: vi.fn().mockResolvedValue(mockEntities),
59
- } as unknown as StateOperations;
60
- entityOps = new EntityOperations(mockStateOps);
61
- listResults = [];
62
- }
63
-
64
- Scenario('List all entities without filters', ({ Given, When, Then }) => {
65
- Given('a Home Assistant instance with multiple entities', () => {
66
- setupMocks();
67
- });
68
-
69
- When('I list all entities', async () => {
70
- listResults = await entityOps.listEntities();
71
- });
72
-
73
- Then('I should get all 4 entities', () => {
74
- expect(listResults).toHaveLength(4);
75
- });
76
- });
77
-
78
- Scenario('Filter entities by domain', ({ Given, When, Then, And }) => {
79
- Given('a Home Assistant instance with multiple entities', () => {
80
- setupMocks();
81
- });
82
-
83
- When('I list entities filtered by domain "light"', async () => {
84
- listResults = await entityOps.listEntities({ domain: 'light' });
85
- });
86
-
87
- Then('I should only get light entities', () => {
88
- expect(listResults.every(e => e.entity_id.startsWith('light.'))).toBe(true);
89
- });
90
-
91
- And('the count should be 2', () => {
92
- expect(listResults).toHaveLength(2);
93
- });
94
- });
95
-
96
- Scenario('Filter entities by state', ({ Given, When, Then, And }) => {
97
- Given('a Home Assistant instance with multiple entities', () => {
98
- setupMocks();
99
- });
100
-
101
- When('I list entities filtered by state "on"', async () => {
102
- listResults = await entityOps.listEntities({ state: 'on' });
103
- });
104
-
105
- Then('I should only get entities that are "on"', () => {
106
- expect(listResults.every(e => e.state === 'on')).toBe(true);
107
- });
108
-
109
- And('the count should be 2', () => {
110
- expect(listResults).toHaveLength(2);
111
- });
112
- });
113
-
114
- Scenario('Filter entities by search query', ({ Given, When, Then, And }) => {
115
- Given('a Home Assistant instance with multiple entities', () => {
116
- setupMocks();
117
- });
118
-
119
- When('I list entities filtered by search "room"', async () => {
120
- listResults = await entityOps.listEntities({ search: 'room' });
121
- });
122
-
123
- Then('I should only get entities matching "room"', () => {
124
- expect(listResults.every(e =>
125
- e.entity_id.includes('room') ||
126
- (e.attributes.friendly_name as string)?.toLowerCase().includes('room')
127
- )).toBe(true);
128
- });
129
-
130
- And('the count should be 2', () => {
131
- expect(listResults).toHaveLength(2);
132
- });
133
- });
134
-
135
- Scenario('Apply limit to entity list', ({ Given, When, Then }) => {
136
- Given('a Home Assistant instance with multiple entities', () => {
137
- setupMocks();
138
- });
139
-
140
- When('I list entities with limit 2', async () => {
141
- listResults = await entityOps.listEntities({ limit: 2 });
142
- });
143
-
144
- Then('I should get at most 2 entities', () => {
145
- expect(listResults.length).toBeLessThanOrEqual(2);
146
- });
147
- });
148
-
149
- Scenario('Combine multiple filters', ({ Given, When, Then, And }) => {
150
- Given('a Home Assistant instance with multiple entities', () => {
151
- setupMocks();
152
- });
153
-
154
- When('I list entities filtered by domain "light" and state "on"', async () => {
155
- listResults = await entityOps.listEntities({ domain: 'light', state: 'on' });
156
- });
157
-
158
- Then('I should only get lights that are on', () => {
159
- expect(listResults.every(e =>
160
- e.entity_id.startsWith('light.') && e.state === 'on'
161
- )).toBe(true);
162
- });
163
-
164
- And('the count should be 1', () => {
165
- expect(listResults).toHaveLength(1);
166
- });
167
- });
168
-
169
- Scenario('Get domain summary', ({ Given, When, Then, And }) => {
170
- Given('a Home Assistant instance with multiple entities', () => {
171
- setupMocks();
172
- });
173
-
174
- When('I get the summary for domain "light"', async () => {
175
- summary = await entityOps.getDomainSummary('light');
176
- });
177
-
178
- Then('the summary should show domain "light"', () => {
179
- expect(summary.domain).toBe('light');
180
- });
181
-
182
- And('the total count should be 2', () => {
183
- expect(summary.count).toBe(2);
184
- });
185
-
186
- And('the state breakdown should show 1 "on" and 1 "off"', () => {
187
- expect(summary.states).toEqual({ on: 1, off: 1 });
188
- });
189
- });
190
-
191
- Scenario('Get domain summary for non-existent domain', ({ Given, When, Then, And }) => {
192
- Given('a Home Assistant instance with multiple entities', () => {
193
- setupMocks();
194
- });
195
-
196
- When('I get the summary for domain "vacuum"', async () => {
197
- summary = await entityOps.getDomainSummary('vacuum');
198
- });
199
-
200
- Then('the summary should show domain "vacuum"', () => {
201
- expect(summary.domain).toBe('vacuum');
202
- });
203
-
204
- And('the total count should be 0', () => {
205
- expect(summary.count).toBe(0);
206
- });
207
- });
208
- });