@coffeerunhobby/mcp-ha-connect 2.2.1 → 2.3.1

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 (281) hide show
  1. package/.env.example +1 -1
  2. package/README.md +11 -2
  3. package/dist/omadaClient/client.d.ts +6 -1
  4. package/dist/omadaClient/client.js +12 -1
  5. package/dist/omadaClient/client.js.map +1 -1
  6. package/dist/omadaClient/diagnose.d.ts +68 -0
  7. package/dist/omadaClient/diagnose.js +164 -0
  8. package/dist/omadaClient/diagnose.js.map +1 -0
  9. package/dist/omadaClient/index.d.ts +6 -0
  10. package/dist/omadaClient/index.js +15 -0
  11. package/dist/omadaClient/index.js.map +1 -1
  12. package/dist/omadaClient/macGroups.d.ts +58 -0
  13. package/dist/omadaClient/macGroups.js +124 -0
  14. package/dist/omadaClient/macGroups.js.map +1 -0
  15. package/dist/tools/infra/actions.d.ts +1 -1
  16. package/dist/tools/infra/actions.js +1 -1
  17. package/dist/tools/omada/index.js +6 -0
  18. package/dist/tools/omada/index.js.map +1 -1
  19. package/dist/tools/omada/macGroups.d.ts +19 -0
  20. package/dist/tools/omada/macGroups.js +77 -0
  21. package/dist/tools/omada/macGroups.js.map +1 -0
  22. package/dist/tools/omada/namespace.js +8 -0
  23. package/dist/tools/omada/namespace.js.map +1 -1
  24. package/dist/version.d.ts +1 -1
  25. package/dist/version.js +1 -1
  26. package/package.json +5 -1
  27. package/.codex/review-rules.md +0 -16
  28. package/.dockerignore +0 -8
  29. package/.gitattributes +0 -30
  30. package/.github/workflows/ci.yml +0 -193
  31. package/AGENTS.md +0 -389
  32. package/Dockerfile +0 -50
  33. package/docker-compose.yml +0 -23
  34. package/docs/CHANGELOG.md +0 -341
  35. package/docs/COVERAGE.md +0 -219
  36. package/docs/QUICK_START.md +0 -240
  37. package/eslint.config.js +0 -33
  38. package/n8n/ai-agent-safety-monitor.json +0 -355
  39. package/openapi.json +0 -1259
  40. package/scripts/check-version-sync.mjs +0 -69
  41. package/scripts/generate-jwt.ts +0 -121
  42. package/src/config.ts +0 -440
  43. package/src/haClient/automations.ts +0 -261
  44. package/src/haClient/calendars.ts +0 -94
  45. package/src/haClient/config.ts +0 -52
  46. package/src/haClient/devices.ts +0 -653
  47. package/src/haClient/entities.ts +0 -128
  48. package/src/haClient/events.ts +0 -689
  49. package/src/haClient/history.ts +0 -73
  50. package/src/haClient/index.ts +0 -336
  51. package/src/haClient/request.ts +0 -142
  52. package/src/haClient/services.ts +0 -45
  53. package/src/haClient/states.ts +0 -60
  54. package/src/haClient/updates.ts +0 -58
  55. package/src/haClient/wsCommand.ts +0 -44
  56. package/src/index.ts +0 -164
  57. package/src/localAI/index.ts +0 -88
  58. package/src/localAI/prompts.ts +0 -50
  59. package/src/localAI/providers/base.ts +0 -120
  60. package/src/localAI/providers/ollama.ts +0 -78
  61. package/src/localAI/providers/openai.ts +0 -86
  62. package/src/localAI/types.ts +0 -67
  63. package/src/omadaClient/auth.ts +0 -178
  64. package/src/omadaClient/client.ts +0 -337
  65. package/src/omadaClient/device.ts +0 -118
  66. package/src/omadaClient/index.ts +0 -310
  67. package/src/omadaClient/network.ts +0 -284
  68. package/src/omadaClient/request.ts +0 -365
  69. package/src/omadaClient/security.ts +0 -51
  70. package/src/omadaClient/site.ts +0 -344
  71. package/src/ownerQuestions/service.ts +0 -536
  72. package/src/permissions/index.ts +0 -143
  73. package/src/resources/index.ts +0 -213
  74. package/src/server/auth.ts +0 -175
  75. package/src/server/chatFace.ts +0 -789
  76. package/src/server/chatSlice.ts +0 -57
  77. package/src/server/common.ts +0 -170
  78. package/src/server/eventSubscription.ts +0 -343
  79. package/src/server/http.ts +0 -626
  80. package/src/server/instructions.ts +0 -97
  81. package/src/server/rateLimiter.ts +0 -227
  82. package/src/server/stdio.ts +0 -41
  83. package/src/server/stream.ts +0 -205
  84. package/src/tools/ai/analyzeSensors.ts +0 -33
  85. package/src/tools/ai/index.ts +0 -20
  86. package/src/tools/common.ts +0 -442
  87. package/src/tools/homeassistant/askOwner.ts +0 -133
  88. package/src/tools/homeassistant/automationControls.ts +0 -66
  89. package/src/tools/homeassistant/calendar.ts +0 -97
  90. package/src/tools/homeassistant/callService.ts +0 -25
  91. package/src/tools/homeassistant/controlClimate.ts +0 -68
  92. package/src/tools/homeassistant/controlCover.ts +0 -48
  93. package/src/tools/homeassistant/controlFan.ts +0 -44
  94. package/src/tools/homeassistant/controlLight.ts +0 -38
  95. package/src/tools/homeassistant/controlMediaPlayer.ts +0 -50
  96. package/src/tools/homeassistant/createAutomation.ts +0 -35
  97. package/src/tools/homeassistant/deleteAutomation.ts +0 -24
  98. package/src/tools/homeassistant/entityAction.ts +0 -35
  99. package/src/tools/homeassistant/entityGuard.ts +0 -28
  100. package/src/tools/homeassistant/getAllSensors.ts +0 -46
  101. package/src/tools/homeassistant/getAutomationTrace.ts +0 -30
  102. package/src/tools/homeassistant/getDomainSummary.ts +0 -29
  103. package/src/tools/homeassistant/getEntitiesByDomain.ts +0 -56
  104. package/src/tools/homeassistant/getHistory.ts +0 -24
  105. package/src/tools/homeassistant/getState.ts +0 -24
  106. package/src/tools/homeassistant/getStates.ts +0 -46
  107. package/src/tools/homeassistant/getVersion.ts +0 -21
  108. package/src/tools/homeassistant/index.ts +0 -121
  109. package/src/tools/homeassistant/listAutomations.ts +0 -35
  110. package/src/tools/homeassistant/listEntities.ts +0 -44
  111. package/src/tools/homeassistant/listPersons.ts +0 -46
  112. package/src/tools/homeassistant/sceneAndScript.ts +0 -53
  113. package/src/tools/homeassistant/searchEntities.ts +0 -58
  114. package/src/tools/homeassistant/sendNotification.ts +0 -179
  115. package/src/tools/homeassistant/systemTools.ts +0 -52
  116. package/src/tools/homeassistant/triggerAutomation.ts +0 -24
  117. package/src/tools/index.ts +0 -78
  118. package/src/tools/infra/actions.ts +0 -95
  119. package/src/tools/infra/index.ts +0 -138
  120. package/src/tools/omada/blockClient.ts +0 -28
  121. package/src/tools/omada/cyclePoePort.ts +0 -32
  122. package/src/tools/omada/deleteClient.ts +0 -27
  123. package/src/tools/omada/disableClientRateLimit.ts +0 -23
  124. package/src/tools/omada/getClient.ts +0 -14
  125. package/src/tools/omada/getDevice.ts +0 -14
  126. package/src/tools/omada/getFirewallSetting.ts +0 -14
  127. package/src/tools/omada/getInternetInfo.ts +0 -14
  128. package/src/tools/omada/getLanNetworkList.ts +0 -14
  129. package/src/tools/omada/getLanProfileList.ts +0 -14
  130. package/src/tools/omada/getPortForwardingStatus.ts +0 -26
  131. package/src/tools/omada/getRateLimitProfiles.ts +0 -14
  132. package/src/tools/omada/getSiteNtpStatus.ts +0 -14
  133. package/src/tools/omada/getSsidDetail.ts +0 -22
  134. package/src/tools/omada/getSsidList.ts +0 -21
  135. package/src/tools/omada/getSwitchStackDetail.ts +0 -14
  136. package/src/tools/omada/getThreatList.ts +0 -42
  137. package/src/tools/omada/getWlanGroupList.ts +0 -14
  138. package/src/tools/omada/graph.ts +0 -187
  139. package/src/tools/omada/index.ts +0 -153
  140. package/src/tools/omada/listBlockedClients.ts +0 -17
  141. package/src/tools/omada/listClients.ts +0 -14
  142. package/src/tools/omada/listClientsActivity.ts +0 -25
  143. package/src/tools/omada/listClientsPastConnections.ts +0 -44
  144. package/src/tools/omada/listDevices.ts +0 -14
  145. package/src/tools/omada/listDevicesStats.ts +0 -41
  146. package/src/tools/omada/listMostActiveClients.ts +0 -14
  147. package/src/tools/omada/listSites.ts +0 -18
  148. package/src/tools/omada/namespace.ts +0 -1164
  149. package/src/tools/omada/searchDevices.ts +0 -20
  150. package/src/tools/omada/setClientRateLimit.ts +0 -26
  151. package/src/tools/omada/setClientRateLimitProfile.ts +0 -25
  152. package/src/tools/omada/setSiteNtpServers.ts +0 -36
  153. package/src/tools/omada/setSsidEnabled.ts +0 -38
  154. package/src/tools/omada/unblockClient.ts +0 -26
  155. package/src/tools/types.ts +0 -11
  156. package/src/tools/utils/pagination-schema.ts +0 -27
  157. package/src/types/ai/index.ts +0 -11
  158. package/src/types/ai/types.ts +0 -67
  159. package/src/types/homeassistant/automations.ts +0 -43
  160. package/src/types/homeassistant/calendars.ts +0 -26
  161. package/src/types/homeassistant/config.ts +0 -14
  162. package/src/types/homeassistant/entities.ts +0 -14
  163. package/src/types/homeassistant/errors.ts +0 -33
  164. package/src/types/homeassistant/haConfig.ts +0 -7
  165. package/src/types/homeassistant/history.ts +0 -13
  166. package/src/types/homeassistant/index.ts +0 -46
  167. package/src/types/homeassistant/request.ts +0 -6
  168. package/src/types/homeassistant/serviceCall.ts +0 -18
  169. package/src/types/homeassistant/states.ts +0 -58
  170. package/src/types/homeassistant/updates.ts +0 -28
  171. package/src/types/index.ts +0 -12
  172. package/src/types/omada/activeClientInfo.ts +0 -17
  173. package/src/types/omada/clientActivity.ts +0 -32
  174. package/src/types/omada/clientBlockStatus.ts +0 -11
  175. package/src/types/omada/clientPastConnection.ts +0 -82
  176. package/src/types/omada/index.ts +0 -14
  177. package/src/types/omada/omadaApiResponse.ts +0 -5
  178. package/src/types/omada/omadaClientInfo.ts +0 -11
  179. package/src/types/omada/omadaDeviceInfo.ts +0 -11
  180. package/src/types/omada/omadaDeviceStats.ts +0 -31
  181. package/src/types/omada/omadaSiteSummary.ts +0 -5
  182. package/src/types/omada/oswStackDetail.ts +0 -11
  183. package/src/types/omada/paginatedResult.ts +0 -6
  184. package/src/types/omada/rateLimitProfile.ts +0 -58
  185. package/src/types/omada/threatInfo.ts +0 -38
  186. package/src/types/omada/tokenResult.ts +0 -6
  187. package/src/types.ts +0 -2
  188. package/src/utils/config-validations.ts +0 -68
  189. package/src/utils/jwt.ts +0 -112
  190. package/src/utils/logger.ts +0 -121
  191. package/src/utils/plainText.ts +0 -48
  192. package/src/utils/redact.ts +0 -59
  193. package/src/utils/sanitizeError.ts +0 -18
  194. package/src/utils/tlsDispatcher.ts +0 -69
  195. package/src/version.ts +0 -5
  196. package/tests/bdd/automation-creation.spec.ts +0 -214
  197. package/tests/bdd/automation-management.spec.ts +0 -267
  198. package/tests/bdd/calendar.spec.ts +0 -190
  199. package/tests/bdd/configuration.spec.ts +0 -283
  200. package/tests/bdd/device-control.spec.ts +0 -344
  201. package/tests/bdd/entity-listing.spec.ts +0 -208
  202. package/tests/bdd/entity-search.spec.ts +0 -183
  203. package/tests/bdd/history-retrieval.spec.ts +0 -195
  204. package/tests/bdd/notifications.spec.ts +0 -238
  205. package/tests/bdd/service-calls.spec.ts +0 -144
  206. package/tests/bdd/state-retrieval.spec.ts +0 -204
  207. package/tests/bench/hotpaths.bench.ts +0 -68
  208. package/tests/config.test.ts +0 -355
  209. package/tests/features/automation-creation.feature +0 -36
  210. package/tests/features/automation-management.feature +0 -54
  211. package/tests/features/calendar.feature +0 -37
  212. package/tests/features/configuration.feature +0 -70
  213. package/tests/features/device-control.feature +0 -100
  214. package/tests/features/entity-listing.feature +0 -51
  215. package/tests/features/entity-search.feature +0 -44
  216. package/tests/features/history-retrieval.feature +0 -38
  217. package/tests/features/notifications.feature +0 -37
  218. package/tests/features/service-calls.feature +0 -35
  219. package/tests/features/state-retrieval.feature +0 -37
  220. package/tests/fixtures/openapi-default-slice.json +0 -290
  221. package/tests/haClient/automationTrace.test.ts +0 -59
  222. package/tests/haClient/automations.test.ts +0 -149
  223. package/tests/haClient/config.test.ts +0 -117
  224. package/tests/haClient/entities.test.ts +0 -188
  225. package/tests/haClient/events.test.ts +0 -455
  226. package/tests/haClient/eventsTls.test.ts +0 -52
  227. package/tests/haClient/history.test.ts +0 -228
  228. package/tests/haClient/index.test.ts +0 -243
  229. package/tests/haClient/request.test.ts +0 -217
  230. package/tests/haClient/services.test.ts +0 -120
  231. package/tests/haClient/states.test.ts +0 -119
  232. package/tests/haClient/updates.test.ts +0 -193
  233. package/tests/index.test.ts +0 -160
  234. package/tests/integration/homeassistant.test.ts +0 -144
  235. package/tests/integration/omada.test.ts +0 -167
  236. package/tests/integration/server.test.ts +0 -151
  237. package/tests/localAI/index.test.ts +0 -177
  238. package/tests/localAI/ollama.test.ts +0 -187
  239. package/tests/localAI/openai.test.ts +0 -257
  240. package/tests/omadaClient/actions.test.ts +0 -161
  241. package/tests/omadaClient/clientBlocks.test.ts +0 -170
  242. package/tests/omadaClient/ntp.test.ts +0 -381
  243. package/tests/omadaClient/site.test.ts +0 -37
  244. package/tests/ownerQuestions/service.test.ts +0 -499
  245. package/tests/ownerQuestions/tools.test.ts +0 -186
  246. package/tests/permissions/index.test.ts +0 -217
  247. package/tests/resources/index.test.ts +0 -288
  248. package/tests/scripts/generateJwt.test.ts +0 -44
  249. package/tests/security/accessControl.test.ts +0 -223
  250. package/tests/security/authentication.test.ts +0 -117
  251. package/tests/security/configuration.test.ts +0 -170
  252. package/tests/security/cryptoTransport.test.ts +0 -172
  253. package/tests/security/dependencies.test.ts +0 -152
  254. package/tests/security/injection.test.ts +0 -117
  255. package/tests/security/insecureDesign.test.ts +0 -121
  256. package/tests/security/logging.test.ts +0 -131
  257. package/tests/security/resourceConsumption.test.ts +0 -142
  258. package/tests/server/auth.test.ts +0 -249
  259. package/tests/server/chatFace.test.ts +0 -320
  260. package/tests/server/common.test.ts +0 -84
  261. package/tests/server/http.test.ts +0 -561
  262. package/tests/server/instructions.test.ts +0 -152
  263. package/tests/server/memoizeJsonSchema.test.ts +0 -71
  264. package/tests/server/stdio.test.ts +0 -99
  265. package/tests/server/stream.test.ts +0 -285
  266. package/tests/server/toolVisibility.http.test.ts +0 -111
  267. package/tests/server/toolVisibility.test.ts +0 -129
  268. package/tests/tools/ai/analyzeSensors.test.ts +0 -227
  269. package/tests/tools/common.test.ts +0 -123
  270. package/tests/tools/homeassistant/handlers.test.ts +0 -872
  271. package/tests/tools/infra/invokeAction.test.ts +0 -280
  272. package/tests/tools/omada/graph.test.ts +0 -385
  273. package/tests/tools/omada/handlers.test.ts +0 -897
  274. package/tests/tools/omada/namespace.test.ts +0 -483
  275. package/tests/tools/registry.test.ts +0 -168
  276. package/tests/utils/config-validations.test.ts +0 -352
  277. package/tests/utils/jwt.test.ts +0 -115
  278. package/tests/utils/logger.test.ts +0 -327
  279. package/tests/utils/redact.test.ts +0 -105
  280. package/tsconfig.json +0 -24
  281. 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
- });