mqtt2matter 0.0.0-stage → 0.2.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 (279) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +23 -0
  4. package/README.md +172 -2
  5. package/dist/app.d.ts +34 -0
  6. package/dist/app.js +157 -0
  7. package/dist/app.js.map +1 -0
  8. package/dist/commands/import-z2m.d.ts +20 -0
  9. package/dist/commands/import-z2m.js +173 -0
  10. package/dist/commands/import-z2m.js.map +1 -0
  11. package/dist/commands/install.d.ts +41 -0
  12. package/dist/commands/install.js +250 -0
  13. package/dist/commands/install.js.map +1 -0
  14. package/dist/commands/update.d.ts +14 -0
  15. package/dist/commands/update.js +109 -0
  16. package/dist/commands/update.js.map +1 -0
  17. package/dist/config/index.d.ts +2 -0
  18. package/dist/config/index.js +3 -0
  19. package/dist/config/index.js.map +1 -0
  20. package/dist/config/load.d.ts +57 -0
  21. package/dist/config/load.js +137 -0
  22. package/dist/config/load.js.map +1 -0
  23. package/dist/config/schema.d.ts +496 -0
  24. package/dist/config/schema.js +115 -0
  25. package/dist/config/schema.js.map +1 -0
  26. package/dist/engine/payload.d.ts +94 -0
  27. package/dist/engine/payload.js +515 -0
  28. package/dist/engine/payload.js.map +1 -0
  29. package/dist/engine/runtime.d.ts +79 -0
  30. package/dist/engine/runtime.js +438 -0
  31. package/dist/engine/runtime.js.map +1 -0
  32. package/dist/engine/template.d.ts +20 -0
  33. package/dist/engine/template.js +264 -0
  34. package/dist/engine/template.js.map +1 -0
  35. package/dist/engine/units.d.ts +9 -0
  36. package/dist/engine/units.js +42 -0
  37. package/dist/engine/units.js.map +1 -0
  38. package/dist/families/climate.d.ts +11 -0
  39. package/dist/families/climate.js +68 -0
  40. package/dist/families/climate.js.map +1 -0
  41. package/dist/families/color.d.ts +30 -0
  42. package/dist/families/color.js +152 -0
  43. package/dist/families/color.js.map +1 -0
  44. package/dist/families/cover.d.ts +17 -0
  45. package/dist/families/cover.js +308 -0
  46. package/dist/families/cover.js.map +1 -0
  47. package/dist/families/fan.d.ts +16 -0
  48. package/dist/families/fan.js +154 -0
  49. package/dist/families/fan.js.map +1 -0
  50. package/dist/families/index.d.ts +32 -0
  51. package/dist/families/index.js +162 -0
  52. package/dist/families/index.js.map +1 -0
  53. package/dist/families/light.d.ts +36 -0
  54. package/dist/families/light.js +258 -0
  55. package/dist/families/light.js.map +1 -0
  56. package/dist/families/lock.d.ts +10 -0
  57. package/dist/families/lock.js +31 -0
  58. package/dist/families/lock.js.map +1 -0
  59. package/dist/families/on-off.d.ts +7 -0
  60. package/dist/families/on-off.js +56 -0
  61. package/dist/families/on-off.js.map +1 -0
  62. package/dist/families/power-source.d.ts +12 -0
  63. package/dist/families/power-source.js +60 -0
  64. package/dist/families/power-source.js.map +1 -0
  65. package/dist/families/registry.d.ts +40 -0
  66. package/dist/families/registry.js +72 -0
  67. package/dist/families/registry.js.map +1 -0
  68. package/dist/families/rvc.d.ts +40 -0
  69. package/dist/families/rvc.js +83 -0
  70. package/dist/families/rvc.js.map +1 -0
  71. package/dist/families/switch.d.ts +19 -0
  72. package/dist/families/switch.js +94 -0
  73. package/dist/families/switch.js.map +1 -0
  74. package/dist/importers/actions.d.ts +19 -0
  75. package/dist/importers/actions.js +98 -0
  76. package/dist/importers/actions.js.map +1 -0
  77. package/dist/importers/ha/areas.d.ts +6 -0
  78. package/dist/importers/ha/areas.js +279 -0
  79. package/dist/importers/ha/areas.js.map +1 -0
  80. package/dist/importers/ha/generate.d.ts +51 -0
  81. package/dist/importers/ha/generate.js +1376 -0
  82. package/dist/importers/ha/generate.js.map +1 -0
  83. package/dist/importers/ha/index.d.ts +6 -0
  84. package/dist/importers/ha/index.js +7 -0
  85. package/dist/importers/ha/index.js.map +1 -0
  86. package/dist/importers/ha/source.d.ts +36 -0
  87. package/dist/importers/ha/source.js +95 -0
  88. package/dist/importers/ha/source.js.map +1 -0
  89. package/dist/importers/ha/sync.d.ts +29 -0
  90. package/dist/importers/ha/sync.js +132 -0
  91. package/dist/importers/ha/sync.js.map +1 -0
  92. package/dist/importers/ha/templates.d.ts +18 -0
  93. package/dist/importers/ha/templates.js +285 -0
  94. package/dist/importers/ha/templates.js.map +1 -0
  95. package/dist/importers/ha/types.d.ts +78 -0
  96. package/dist/importers/ha/types.js +479 -0
  97. package/dist/importers/ha/types.js.map +1 -0
  98. package/dist/importers/index.d.ts +5 -0
  99. package/dist/importers/index.js +8 -0
  100. package/dist/importers/index.js.map +1 -0
  101. package/dist/importers/patch.d.ts +50 -0
  102. package/dist/importers/patch.js +224 -0
  103. package/dist/importers/patch.js.map +1 -0
  104. package/dist/importers/sync.d.ts +112 -0
  105. package/dist/importers/sync.js +220 -0
  106. package/dist/importers/sync.js.map +1 -0
  107. package/dist/importers/twins.d.ts +10 -0
  108. package/dist/importers/twins.js +34 -0
  109. package/dist/importers/twins.js.map +1 -0
  110. package/dist/importers/z2m/generate.d.ts +81 -0
  111. package/dist/importers/z2m/generate.js +1171 -0
  112. package/dist/importers/z2m/generate.js.map +1 -0
  113. package/dist/importers/z2m/index.d.ts +5 -0
  114. package/dist/importers/z2m/index.js +6 -0
  115. package/dist/importers/z2m/index.js.map +1 -0
  116. package/dist/importers/z2m/source.d.ts +18 -0
  117. package/dist/importers/z2m/source.js +46 -0
  118. package/dist/importers/z2m/source.js.map +1 -0
  119. package/dist/importers/z2m/sync.d.ts +29 -0
  120. package/dist/importers/z2m/sync.js +92 -0
  121. package/dist/importers/z2m/sync.js.map +1 -0
  122. package/dist/importers/z2m/types.d.ts +72 -0
  123. package/dist/importers/z2m/types.js +46 -0
  124. package/dist/importers/z2m/types.js.map +1 -0
  125. package/dist/index.d.ts +5 -0
  126. package/dist/index.js +7 -0
  127. package/dist/index.js.map +1 -0
  128. package/dist/log.d.ts +17 -0
  129. package/dist/log.js +54 -0
  130. package/dist/log.js.map +1 -0
  131. package/dist/main.d.ts +2 -0
  132. package/dist/main.js +202 -0
  133. package/dist/main.js.map +1 -0
  134. package/dist/matter/bridge.d.ts +113 -0
  135. package/dist/matter/bridge.js +467 -0
  136. package/dist/matter/bridge.js.map +1 -0
  137. package/dist/matter/check.d.ts +11 -0
  138. package/dist/matter/check.js +116 -0
  139. package/dist/matter/check.js.map +1 -0
  140. package/dist/matter/cluster-defaults.d.ts +6 -0
  141. package/dist/matter/cluster-defaults.js +63 -0
  142. package/dist/matter/cluster-defaults.js.map +1 -0
  143. package/dist/matter/commissioning.d.ts +21 -0
  144. package/dist/matter/commissioning.js +88 -0
  145. package/dist/matter/commissioning.js.map +1 -0
  146. package/dist/matter/device-types.d.ts +44 -0
  147. package/dist/matter/device-types.js +230 -0
  148. package/dist/matter/device-types.js.map +1 -0
  149. package/dist/matter/ids.d.ts +31 -0
  150. package/dist/matter/ids.js +83 -0
  151. package/dist/matter/ids.js.map +1 -0
  152. package/dist/matter/index.d.ts +7 -0
  153. package/dist/matter/index.js +8 -0
  154. package/dist/matter/index.js.map +1 -0
  155. package/dist/matter/node-manager.d.ts +39 -0
  156. package/dist/matter/node-manager.js +161 -0
  157. package/dist/matter/node-manager.js.map +1 -0
  158. package/dist/matter/shards.d.ts +26 -0
  159. package/dist/matter/shards.js +93 -0
  160. package/dist/matter/shards.js.map +1 -0
  161. package/dist/model/attribute.d.ts +18 -0
  162. package/dist/model/attribute.js +28 -0
  163. package/dist/model/attribute.js.map +1 -0
  164. package/dist/model/catalog.d.ts +79 -0
  165. package/dist/model/catalog.js +223 -0
  166. package/dist/model/catalog.js.map +1 -0
  167. package/dist/model/index.d.ts +7 -0
  168. package/dist/model/index.js +8 -0
  169. package/dist/model/index.js.map +1 -0
  170. package/dist/model/migrate.d.ts +4 -0
  171. package/dist/model/migrate.js +39 -0
  172. package/dist/model/migrate.js.map +1 -0
  173. package/dist/model/options.d.ts +102 -0
  174. package/dist/model/options.js +88 -0
  175. package/dist/model/options.js.map +1 -0
  176. package/dist/model/presets.d.ts +37 -0
  177. package/dist/model/presets.js +105 -0
  178. package/dist/model/presets.js.map +1 -0
  179. package/dist/model/schema.d.ts +1747 -0
  180. package/dist/model/schema.js +243 -0
  181. package/dist/model/schema.js.map +1 -0
  182. package/dist/model/validate.d.ts +21 -0
  183. package/dist/model/validate.js +484 -0
  184. package/dist/model/validate.js.map +1 -0
  185. package/dist/mqtt/client.d.ts +38 -0
  186. package/dist/mqtt/client.js +94 -0
  187. package/dist/mqtt/client.js.map +1 -0
  188. package/dist/mqtt/index.d.ts +2 -0
  189. package/dist/mqtt/index.js +3 -0
  190. package/dist/mqtt/index.js.map +1 -0
  191. package/dist/mqtt/topic-cache.d.ts +20 -0
  192. package/dist/mqtt/topic-cache.js +58 -0
  193. package/dist/mqtt/topic-cache.js.map +1 -0
  194. package/dist/server/auth.d.ts +59 -0
  195. package/dist/server/auth.js +185 -0
  196. package/dist/server/auth.js.map +1 -0
  197. package/dist/server/catalog.d.ts +52 -0
  198. package/dist/server/catalog.js +96 -0
  199. package/dist/server/catalog.js.map +1 -0
  200. package/dist/server/compact.d.ts +3 -0
  201. package/dist/server/compact.js +105 -0
  202. package/dist/server/compact.js.map +1 -0
  203. package/dist/server/config-store.d.ts +36 -0
  204. package/dist/server/config-store.js +155 -0
  205. package/dist/server/config-store.js.map +1 -0
  206. package/dist/server/events.d.ts +50 -0
  207. package/dist/server/events.js +71 -0
  208. package/dist/server/events.js.map +1 -0
  209. package/dist/server/http.d.ts +27 -0
  210. package/dist/server/http.js +168 -0
  211. package/dist/server/http.js.map +1 -0
  212. package/dist/server/importers.d.ts +40 -0
  213. package/dist/server/importers.js +75 -0
  214. package/dist/server/importers.js.map +1 -0
  215. package/dist/server/index.d.ts +6 -0
  216. package/dist/server/index.js +8 -0
  217. package/dist/server/index.js.map +1 -0
  218. package/dist/server/log-buffer.d.ts +22 -0
  219. package/dist/server/log-buffer.js +55 -0
  220. package/dist/server/log-buffer.js.map +1 -0
  221. package/dist/server/presets.d.ts +17 -0
  222. package/dist/server/presets.js +55 -0
  223. package/dist/server/presets.js.map +1 -0
  224. package/dist/server/preview.d.ts +19 -0
  225. package/dist/server/preview.js +121 -0
  226. package/dist/server/preview.js.map +1 -0
  227. package/dist/server/server.d.ts +107 -0
  228. package/dist/server/server.js +810 -0
  229. package/dist/server/server.js.map +1 -0
  230. package/dist/server/update.d.ts +60 -0
  231. package/dist/server/update.js +191 -0
  232. package/dist/server/update.js.map +1 -0
  233. package/docs/api.md +128 -0
  234. package/docs/architecture.md +121 -0
  235. package/docs/config.md +538 -0
  236. package/docs/importers.md +241 -0
  237. package/example/mqtt2matter.json +276 -0
  238. package/package.json +90 -4
  239. package/presets/mqtt-smarthome/button.json +47 -0
  240. package/presets/mqtt-smarthome/contact.json +37 -0
  241. package/presets/mqtt-smarthome/cover.json +50 -0
  242. package/presets/mqtt-smarthome/dimmer.json +57 -0
  243. package/presets/mqtt-smarthome/humidity.json +38 -0
  244. package/presets/mqtt-smarthome/light.json +47 -0
  245. package/presets/mqtt-smarthome/occupancy.json +46 -0
  246. package/presets/mqtt-smarthome/switch.json +47 -0
  247. package/presets/mqtt-smarthome/temperature.json +38 -0
  248. package/presets/openbeken/color-light.json +64 -0
  249. package/presets/openbeken/ct-light.json +51 -0
  250. package/presets/openbeken/dimmer.json +47 -0
  251. package/presets/openbeken/humidity.json +37 -0
  252. package/presets/openbeken/relay.json +40 -0
  253. package/presets/openbeken/temperature.json +41 -0
  254. package/presets/shelly-gen1/dimmer.json +48 -0
  255. package/presets/shelly-gen1/door-window.json +43 -0
  256. package/presets/shelly-gen1/ht.json +43 -0
  257. package/presets/shelly-gen1/relay-pm.json +60 -0
  258. package/presets/shelly-gen1/relay.json +36 -0
  259. package/presets/shelly-gen1/roller.json +52 -0
  260. package/presets/shelly-gen2/cover.json +68 -0
  261. package/presets/shelly-gen2/dimmer.json +61 -0
  262. package/presets/shelly-gen2/ht.json +47 -0
  263. package/presets/shelly-gen2/i4.json +82 -0
  264. package/presets/shelly-gen2/switch-pm.json +101 -0
  265. package/presets/shelly-gen2/switch.json +47 -0
  266. package/presets/tasmota/climate.json +52 -0
  267. package/presets/tasmota/color-light.json +63 -0
  268. package/presets/tasmota/ct-light.json +50 -0
  269. package/presets/tasmota/dimmer.json +45 -0
  270. package/presets/tasmota/relay.json +39 -0
  271. package/presets/tasmota/shutter.json +46 -0
  272. package/presets/tasmota/temperature-humidity.json +42 -0
  273. package/presets/tasmota/temperature.json +32 -0
  274. package/presets/valetudo/vacuum.json +103 -0
  275. package/presets/wled/dimmer.json +46 -0
  276. package/presets/wled/light.json +59 -0
  277. package/ui/dist/assets/index-BDtT6bdH.js +10 -0
  278. package/ui/dist/assets/index-CHiG-aoU.css +1 -0
  279. package/ui/dist/index.html +18 -0
@@ -0,0 +1,243 @@
1
+ /* The manual model: what a user (or an importer) writes to describe one Matter device and how its
2
+ attributes map onto MQTT. This file is the schema of `config.devices`; docs/config.md describes it
3
+ in prose and is the contract the importers and the UI build on. Objects are strict: a misspelt key is
4
+ an error, not a silently ignored option. The shape: device = bridged node with endpoints; endpoint =
5
+ device type names + cluster features + family options; mapping = one attribute, command or event ↔
6
+ MQTT with independent `status` (device → Matter) and `command` (Matter → device) halves. */
7
+ import { z } from 'zod';
8
+ import { OptionsSchema } from "./options.js";
9
+ /** a device key: the stable Matter endpoint id, so Matter endpoint numbers stay stable across restarts */
10
+ export const DEVICE_KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9:._-]{0,63}$/;
11
+ /** `Cluster.attribute` in matter.js' names, e.g. `OnOff.onOff`, `LevelControl.currentLevel` */
12
+ export const ATTRIBUTE_PATTERN = /^[A-Z][A-Za-z0-9]*\.[a-z][A-Za-z0-9]*$/;
13
+ /** `Cluster.command` in matter.js' names, e.g. `WindowCovering.stopMotion`, `Identify.identify` */
14
+ export const COMMAND_PATTERN = ATTRIBUTE_PATTERN;
15
+ /** an event channel a family owns; 1.0 knows `Switch` (press kinds → GenericSwitch events) */
16
+ export const EVENT_PATTERN = /^[A-Z][A-Za-z0-9]*$/;
17
+ export const ScalarSchema = z.union([z.boolean(), z.number(), z.string()]);
18
+ export const ValueTypeSchema = z.enum(['boolean', 'number', 'string']);
19
+ /** the named conversions between a device's unit and the Matter attribute's unit (docs/config.md) */
20
+ export const UnitSchema = z.enum([
21
+ /** °C → Matter 0.01 °C (temperatures, setpoints) */
22
+ 'celsius',
23
+ /** °F → Matter 0.01 °C */
24
+ 'fahrenheit',
25
+ /** kelvin → mireds (colour temperature) */
26
+ 'kelvin',
27
+ /** 0–100 % → Matter 0–10000 (humidity, covers) */
28
+ 'percent100ths',
29
+ /** 0–100 % → Matter 0–200 (battery percentage) */
30
+ 'halfPercent',
31
+ /** 0–100 % → Matter level 1–254 (brightness) */
32
+ 'percentLevel',
33
+ /** 0–255 → Matter level 1–254 (brightness as HA sends it) */
34
+ 'byteLevel',
35
+ /** lux → Matter illuminance (10000·log10(lux) + 1) */
36
+ 'lux',
37
+ /** volt → millivolt (battery voltage) */
38
+ 'volt',
39
+ /** 0–360° → Matter hue 0–254 */
40
+ 'degrees254',
41
+ /** 0–100 % → Matter saturation 0–254 */
42
+ 'percent254',
43
+ /** seconds → Matter tenths of a second (transition times) */
44
+ 'seconds10ths',
45
+ ]);
46
+ export const ScaleSchema = z
47
+ .object({
48
+ /** the device's range */
49
+ from: z.tuple([z.number(), z.number()]),
50
+ /** the attribute's range; reversed bounds invert */
51
+ to: z.tuple([z.number(), z.number()]),
52
+ /** clamp into the target range; default true */
53
+ clamp: z.boolean().default(true),
54
+ })
55
+ .strict();
56
+ /** the numeric steps both halves share, applied in the order listed on the way in and inverted on the way out */
57
+ const NumericSteps = {
58
+ /** a named conversion into the attribute's unit (status) or out of it (command) */
59
+ unit: UnitSchema.optional(),
60
+ /** linear range mapping with clamp */
61
+ scale: ScaleSchema.optional(),
62
+ /** added after scaling (status), subtracted before (command) */
63
+ offset: z.number().optional(),
64
+ /** booleans: not; numbers: mirrored within `scale.from` (status) / `scale.to` (command) */
65
+ invert: z.boolean().optional(),
66
+ /** decimals to round to; integer attributes are rounded to 0 decimals in any case */
67
+ round: z.number().int().min(0).max(10).optional(),
68
+ };
69
+ export const CodecSchema = z
70
+ .object({
71
+ /** a JavaScript module exporting `decode(payload, context)` and/or `encode(value, context)` */
72
+ module: z.string().min(1),
73
+ /** anything the module wants to know (passed as `context.options`) */
74
+ options: z.unknown().optional(),
75
+ })
76
+ .strict();
77
+ /** a get request published at start and after a reconnect so the device reports its state (z2m `/get`) */
78
+ export const GetSchema = z
79
+ .object({
80
+ topic: z.string().min(1),
81
+ payload: z.string().default(''),
82
+ })
83
+ .strict();
84
+ /** device → Matter: how a payload on `topic` becomes the attribute's value */
85
+ export const StatusHalfSchema = z
86
+ .object({
87
+ topic: z.string().min(1),
88
+ /** a JSON path into the payload (`$.POWER`, `state.on`, `$.a[0]`); absent = the whole payload */
89
+ extract: z.string().min(1).optional(),
90
+ /** a Jinja template over `value` (the extracted value or the payload text) and `value_json` */
91
+ template: z.string().optional(),
92
+ /** the payload's type when there is no map; no guessing: a payload that does not parse is ignored */
93
+ type: ValueTypeSchema.optional(),
94
+ /**
95
+ * extracted value (as text) → attribute value; an unmapped value is ignored unless `default` is set. `null`
96
+ * clears a nullable attribute (`FanControl.percentSetting` while the fan runs in Auto)
97
+ */
98
+ map: z.record(z.string(), ScalarSchema.nullable()).optional(),
99
+ /** the value for an unmapped key (`null` as in `map`) */
100
+ default: ScalarSchema.nullable().optional(),
101
+ ...NumericSteps,
102
+ /** seconds without a message on this topic after which the device is unreachable */
103
+ expire: z.number().positive().optional(),
104
+ get: GetSchema.optional(),
105
+ /** the escape hatch: replaces every step above */
106
+ codec: CodecSchema.optional(),
107
+ })
108
+ .strict();
109
+ /** Matter → device: how a value a controller wrote becomes a payload on `topic` */
110
+ export const CommandHalfSchema = z
111
+ .object({
112
+ topic: z.string().min(1),
113
+ ...NumericSteps,
114
+ /** decimals the number is printed with */
115
+ precision: z.number().int().min(0).max(10).optional(),
116
+ /** attribute value (as text) → payload; absent = the value as text */
117
+ format: z.record(z.string(), z.string()).optional(),
118
+ /** a fixed payload (commands without a value, e.g. `WindowCovering.stopMotion`) */
119
+ payload: z.string().optional(),
120
+ /** a Jinja template over `value` and the family's fields; its result is the payload */
121
+ template: z.string().optional(),
122
+ /** a JSON path: the payload becomes `{a: {b: value}}` (`$.a.b`), merged by `coalesce` */
123
+ wrap: z.string().min(1).optional(),
124
+ retain: z.boolean().default(false),
125
+ qos: z.union([z.literal(0), z.literal(1), z.literal(2)]).default(0),
126
+ /** apply the value locally right after publishing; default: only when there is no status half */
127
+ optimistic: z.boolean().optional(),
128
+ codec: CodecSchema.optional(),
129
+ })
130
+ .strict();
131
+ const MappingBase = {
132
+ status: StatusHalfSchema.optional(),
133
+ command: CommandHalfSchema.optional(),
134
+ /** free text for the user; importers put the source field here */
135
+ comment: z.string().optional(),
136
+ };
137
+ export const AttributeMappingSchema = z
138
+ .object({
139
+ attribute: z.string().regex(ATTRIBUTE_PATTERN, 'an attribute is written Cluster.attribute, e.g. OnOff.onOff'),
140
+ ...MappingBase,
141
+ })
142
+ .strict();
143
+ export const CommandMappingSchema = z
144
+ .object({
145
+ /** a command that is not an attribute write; the command half publishes `payload` or `template` */
146
+ invoke: z
147
+ .string()
148
+ .regex(COMMAND_PATTERN, 'a command is written Cluster.command, e.g. WindowCovering.stopMotion'),
149
+ ...MappingBase,
150
+ })
151
+ .strict();
152
+ export const EventMappingSchema = z
153
+ .object({
154
+ /** a family's event channel: `Switch` — the status half yields a press kind */
155
+ event: z.string().regex(EVENT_PATTERN, 'an event channel is a cluster name, e.g. Switch'),
156
+ ...MappingBase,
157
+ })
158
+ .strict();
159
+ export const MappingSchema = z
160
+ .union([AttributeMappingSchema, CommandMappingSchema, EventMappingSchema])
161
+ .refine((b) => b.status !== undefined || b.command !== undefined, {
162
+ message: 'a mapping needs a status half, a command half or both',
163
+ });
164
+ /** `attribute`, `invoke` or `event` — what the mapping is about */
165
+ export function mappingTarget(mapping) {
166
+ if ('attribute' in mapping) {
167
+ return { kind: 'attribute', name: mapping.attribute };
168
+ }
169
+ if ('invoke' in mapping) {
170
+ return { kind: 'invoke', name: mapping.invoke };
171
+ }
172
+ return { kind: 'event', name: mapping.event };
173
+ }
174
+ export const EndpointSchema = z
175
+ .object({
176
+ /** the endpoint's id within the device; `main` is the bridged node itself, others are children */
177
+ id: z.string().regex(DEVICE_KEY_PATTERN).default('main'),
178
+ /** matter.js device type names, e.g. `OnOffPlugInUnit`, `DimmableLight`; the first is the endpoint's type */
179
+ deviceTypes: z.array(z.string().min(1)).min(1),
180
+ /** cluster features to enable on top of the device types' defaults, e.g. `{PowerSource: ['Battery']}` */
181
+ features: z.record(z.string(), z.array(z.string())).optional(),
182
+ /** attribute defaults and fixed values, e.g. `{PowerSource: {description: 'AA'}}` */
183
+ attributes: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
184
+ mappings: z.array(MappingSchema).default([]),
185
+ /** family options (light, cover, climate, fan, switch …), see options.ts */
186
+ options: OptionsSchema.prefault({}),
187
+ /** ms: command payloads to one topic within this window are merged into one message */
188
+ coalesce: z.number().int().min(0).max(5000).default(0),
189
+ })
190
+ .strict();
191
+ export const SourceSchema = z
192
+ .object({
193
+ kind: z.enum(['manual', 'z2m', 'ha-discovery', 'preset']),
194
+ key: z.string().optional(),
195
+ version: z.string().optional(),
196
+ raw: z.unknown().optional(),
197
+ /** the discovered description disappeared; the device stays until removed by hand */
198
+ orphaned: z.boolean().optional(),
199
+ })
200
+ .strict();
201
+ export const AvailabilityTopicSchema = z
202
+ .object({
203
+ topic: z.string().min(1),
204
+ /** a JSON path into the payload; absent = the whole payload */
205
+ extract: z.string().min(1).optional(),
206
+ template: z.string().optional(),
207
+ online: z.string().default('online'),
208
+ offline: z.string().default('offline'),
209
+ })
210
+ .strict();
211
+ export const AvailabilitySchema = z
212
+ .object({
213
+ topics: z.array(AvailabilityTopicSchema).min(1),
214
+ /** `all`: reachable when every topic says online; `any`: when one does; `latest`: the last message decides */
215
+ mode: z.enum(['all', 'any', 'latest']).default('latest'),
216
+ })
217
+ .strict();
218
+ /** one topic in short form, or the full object */
219
+ export const AvailabilityInputSchema = z.union([
220
+ AvailabilityTopicSchema.transform((topic) => ({ topics: [topic], mode: 'latest' })),
221
+ AvailabilitySchema,
222
+ ]);
223
+ export const DeviceSchema = z
224
+ .object({
225
+ name: z.string().min(1).max(32),
226
+ vendor: z.string().max(32).optional(),
227
+ model: z.string().max(32).optional(),
228
+ /** shown as the bridged device's serial number; default: the device key */
229
+ serial: z.string().max(32).optional(),
230
+ enabled: z.boolean().default(true),
231
+ /** the bridge this device lives in; default: assigned once and remembered (matter/shards) */
232
+ bridge: z.string().optional(),
233
+ source: SourceSchema.prefault({ kind: 'manual' }),
234
+ availability: AvailabilityInputSchema.optional(),
235
+ endpoints: z.array(EndpointSchema).min(1),
236
+ })
237
+ .strict()
238
+ .refine((d) => new Set(d.endpoints.map((e) => e.id)).size === d.endpoints.length, {
239
+ message: 'endpoint ids within a device must be unique',
240
+ path: ['endpoints'],
241
+ });
242
+ export const DevicesSchema = z.record(z.string().regex(DEVICE_KEY_PATTERN, 'a device key is 1–64 characters of A–Z a–z 0–9 : . _ -'), DeviceSchema);
243
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/model/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type DeviceConfig, type EndpointConfig } from './schema.ts';
2
+ export interface Issue {
3
+ level: 'error' | 'warning';
4
+ /** `endpoints[0].mappings[2].status.map` */
5
+ path: string;
6
+ message: string;
7
+ }
8
+ export interface ValidationResult {
9
+ issues: Issue[];
10
+ errors: Issue[];
11
+ warnings: Issue[];
12
+ ok: boolean;
13
+ }
14
+ /** the feature set an endpoint's cluster will run with: device type requirements ∪ implied ∪ configured */
15
+ export declare function effectiveFeatures(endpoint: EndpointConfig, cluster: string, bound: ReadonlySet<string>): Set<string>;
16
+ /** validate one endpoint */
17
+ export declare function validateEndpoint(endpoint: EndpointConfig, path: string): Issue[];
18
+ /** validate a device: every endpoint, plus the device-level checks */
19
+ export declare function validateDevice(device: DeviceConfig): ValidationResult;
20
+ /** validate every device of a config: device key → result (only devices with issues) */
21
+ export declare function validateDevices(devices: Readonly<Record<string, DeviceConfig>>): Map<string, ValidationResult>;