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,285 @@
1
+ /* Can the payload engine run a Home Assistant template? The engine renders Jinja through
2
+ `@huggingface/jinja` with Home Assistant's filters added (docs/config.md, "Templates"); what it cannot
3
+ do — `states()`, `now()`, `this`, the time and regex helpers, `int(base=…)`, macros — must not become a
4
+ mapping that fails at runtime. The importer parses the template with the same library and walks the
5
+ program: every filter, test, called function and free name has to be one the engine provides; a
6
+ `*_template` that is not leaves its mapping unadopted, listed with the template. The names here mirror
7
+ the engine's (test/ha-templates.test.ts checks that the two agree). */
8
+ import * as jinjaModule from '@huggingface/jinja';
9
+ /* the library's declaration files import without extensions, which the type-aware lint cannot resolve */
10
+ const jinja = jinjaModule;
11
+ /** the filters the engine renders: the library's built-ins plus the Home Assistant ones it adds */
12
+ export const FILTERS = new Set([
13
+ 'abs',
14
+ 'bool',
15
+ 'capitalize',
16
+ 'default',
17
+ 'd',
18
+ 'dictsort',
19
+ 'first',
20
+ 'float',
21
+ 'iif',
22
+ 'indent',
23
+ 'int',
24
+ 'is_defined',
25
+ 'is_number',
26
+ 'items',
27
+ 'join',
28
+ 'last',
29
+ 'length',
30
+ 'list',
31
+ 'lower',
32
+ 'map',
33
+ 'max',
34
+ 'min',
35
+ 'multiply',
36
+ 'rejectattr',
37
+ 'replace',
38
+ 'reverse',
39
+ 'round',
40
+ 'safe',
41
+ 'selectattr',
42
+ 'sort',
43
+ 'string',
44
+ 'strip',
45
+ 'title',
46
+ 'tojson',
47
+ 'trim',
48
+ 'unique',
49
+ 'upper',
50
+ ]);
51
+ /** the tests (`is …`) the library knows */
52
+ export const TESTS = new Set([
53
+ 'boolean',
54
+ 'callable',
55
+ 'defined',
56
+ 'eq',
57
+ 'equalto',
58
+ 'even',
59
+ 'false',
60
+ 'integer',
61
+ 'iterable',
62
+ 'lower',
63
+ 'mapping',
64
+ 'none',
65
+ 'number',
66
+ 'odd',
67
+ 'sequence',
68
+ 'string',
69
+ 'true',
70
+ 'undefined',
71
+ 'upper',
72
+ ]);
73
+ /** the functions the engine provides as globals */
74
+ export const FUNCTIONS = new Set(['float', 'iif', 'int', 'is_number', 'max', 'min']);
75
+ /** the names every template sees */
76
+ const GLOBALS = new Set(['true', 'false', 'none', 'True', 'False', 'None', 'loop', 'topic']);
77
+ /** the variables of a status half's template */
78
+ export const STATUS_VARIABLES = new Set(['value', 'value_json']);
79
+ /** the variables of a command half's template: the value, an enum's member name, the families' fields */
80
+ export const COMMAND_VARIABLES = new Set([
81
+ 'value',
82
+ 'name',
83
+ 'level',
84
+ 'brightness',
85
+ 'percent',
86
+ 'transition',
87
+ 'hue',
88
+ 'saturation',
89
+ 'h',
90
+ 's',
91
+ 'x',
92
+ 'y',
93
+ 'red',
94
+ 'green',
95
+ 'blue',
96
+ 'r',
97
+ 'g',
98
+ 'b',
99
+ 'mireds',
100
+ 'kelvin',
101
+ 'position',
102
+ 'open',
103
+ 'percent100ths',
104
+ 'mode',
105
+ 'speed',
106
+ 'action',
107
+ ]);
108
+ /** keyword arguments the engine's filters do not implement (a silent wrong result otherwise) */
109
+ const UNSUPPORTED_KEYWORDS = { int: ['base'], float: ['base'] };
110
+ function isNode(value) {
111
+ return typeof value === 'object' && value !== null && typeof value.type === 'string';
112
+ }
113
+ function identifierName(node) {
114
+ return isNode(node) && node.type === 'Identifier' ? node.value : undefined;
115
+ }
116
+ class Walker {
117
+ problems = [];
118
+ bound = new Set();
119
+ variables;
120
+ constructor(variables) {
121
+ this.variables = variables;
122
+ }
123
+ problem(text) {
124
+ if (!this.problems.includes(text)) {
125
+ this.problems.push(text);
126
+ }
127
+ }
128
+ bind(node) {
129
+ const name = identifierName(node);
130
+ if (name !== undefined) {
131
+ this.bound.add(name);
132
+ }
133
+ else if (isNode(node) && node.type === 'TupleLiteral') {
134
+ for (const item of node.value) {
135
+ this.bind(item);
136
+ }
137
+ }
138
+ }
139
+ walk(node) {
140
+ if (Array.isArray(node)) {
141
+ for (const item of node) {
142
+ this.walk(item);
143
+ }
144
+ return;
145
+ }
146
+ if (!isNode(node)) {
147
+ return;
148
+ }
149
+ switch (node.type) {
150
+ case 'Identifier': {
151
+ const name = node.value;
152
+ if (!this.variables.has(name) && !GLOBALS.has(name) && !this.bound.has(name) && !FUNCTIONS.has(name)) {
153
+ this.problem(`"${name}" is not available`);
154
+ }
155
+ return;
156
+ }
157
+ case 'FilterExpression': {
158
+ this.walk(node.operand);
159
+ this.checkFilter(node.filter);
160
+ return;
161
+ }
162
+ case 'FilterStatement': {
163
+ this.checkFilter(node.filter);
164
+ this.walk(node.body);
165
+ return;
166
+ }
167
+ case 'TestExpression': {
168
+ this.walk(node.operand);
169
+ const test = identifierName(node.test);
170
+ if (test !== undefined && !TESTS.has(test)) {
171
+ this.problem(`the test "${test}" is not available`);
172
+ }
173
+ return;
174
+ }
175
+ case 'CallExpression': {
176
+ const callee = node.callee;
177
+ const name = identifierName(callee);
178
+ if (name !== undefined) {
179
+ if (!FUNCTIONS.has(name) && !this.bound.has(name)) {
180
+ this.problem(`"${name}()" is not available`);
181
+ }
182
+ }
183
+ else {
184
+ // a method on a value (`value_json.get('x')`, `'a,b'.split(',')`): the library's business
185
+ this.walk(callee);
186
+ }
187
+ this.walk(node.args);
188
+ return;
189
+ }
190
+ case 'MemberExpression': {
191
+ this.walk(node.object);
192
+ if (node.computed === true) {
193
+ this.walk(node.property);
194
+ }
195
+ return;
196
+ }
197
+ case 'Set': {
198
+ this.walk(node.value);
199
+ this.walk(node.body);
200
+ this.bind(node.assignee);
201
+ return;
202
+ }
203
+ case 'For': {
204
+ this.walk(node.iterable);
205
+ this.bind(node.loopvar);
206
+ this.walk(node.body);
207
+ this.walk(node.defaultBlock);
208
+ return;
209
+ }
210
+ case 'Macro':
211
+ case 'CallStatement': {
212
+ this.problem('macros are not available');
213
+ return;
214
+ }
215
+ case 'BinaryExpression': {
216
+ // the operator is a token, not a name to look up
217
+ this.walk(node.left);
218
+ this.walk(node.right);
219
+ return;
220
+ }
221
+ case 'UnaryExpression': {
222
+ this.walk(node.argument);
223
+ return;
224
+ }
225
+ case 'ObjectLiteral': {
226
+ // the library renders dictionaries with string keys only
227
+ const entries = node.value instanceof Map ? [...node.value.entries()] : [];
228
+ for (const [key, value] of entries) {
229
+ if (isNode(key) && key.type !== 'StringLiteral') {
230
+ this.problem('a dictionary with non-string keys is not available');
231
+ }
232
+ this.walk(key);
233
+ this.walk(value);
234
+ }
235
+ return;
236
+ }
237
+ default: {
238
+ for (const [key, value] of Object.entries(node)) {
239
+ if (key !== 'type') {
240
+ this.walk(value);
241
+ }
242
+ }
243
+ }
244
+ }
245
+ }
246
+ checkFilter(filter) {
247
+ let name = identifierName(filter);
248
+ let args = [];
249
+ if (name === undefined && isNode(filter) && filter.type === 'CallExpression') {
250
+ name = identifierName(filter.callee);
251
+ args = filter.args;
252
+ }
253
+ if (name === undefined) {
254
+ return;
255
+ }
256
+ if (!FILTERS.has(name)) {
257
+ this.problem(`the filter "${name}" is not available`);
258
+ }
259
+ const unsupported = UNSUPPORTED_KEYWORDS[name];
260
+ for (const arg of args) {
261
+ if (isNode(arg) && arg.type === 'KeywordArgumentExpression') {
262
+ const key = identifierName(arg.key);
263
+ if (key !== undefined && unsupported?.includes(key) === true) {
264
+ this.problem(`"${name}(${key}=…)" is not available`);
265
+ }
266
+ }
267
+ this.walk(arg);
268
+ }
269
+ }
270
+ }
271
+ /** can the engine render this template with the variables of that side? */
272
+ export function checkTemplate(source, side, extra = []) {
273
+ let program;
274
+ try {
275
+ program = jinja.parse(jinja.tokenize(source, { lstrip_blocks: true, trim_blocks: true }));
276
+ }
277
+ catch (error) {
278
+ return { ok: false, reason: `does not parse: ${error.message}` };
279
+ }
280
+ const variables = new Set([...(side === 'status' ? STATUS_VARIABLES : COMMAND_VARIABLES), ...extra]);
281
+ const walker = new Walker(variables);
282
+ walker.walk(program.body);
283
+ return walker.problems.length === 0 ? { ok: true } : { ok: false, reason: walker.problems.join('; ') };
284
+ }
285
+ //# sourceMappingURL=templates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/importers/ha/templates.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ /** the entity abbreviations (`ABBREVIATIONS` in abbreviations.py) */
2
+ export declare const ABBREVIATIONS: Readonly<Record<string, string>>;
3
+ /** the `device` block's abbreviations (`DEVICE_ABBREVIATIONS`) */
4
+ export declare const DEVICE_ABBREVIATIONS: Readonly<Record<string, string>>;
5
+ /** the `origin` block's abbreviations (`ORIGIN_ABBREVIATIONS`) */
6
+ export declare const ORIGIN_ABBREVIATIONS: Readonly<Record<string, string>>;
7
+ export interface DeviceInfo {
8
+ /** one identifier or a list; Home Assistant accepts both */
9
+ identifiers?: string | string[];
10
+ /** `[["mac", "02:5b:…"]]` */
11
+ connections?: [string, string][];
12
+ name?: string;
13
+ manufacturer?: string;
14
+ model?: string;
15
+ model_id?: string;
16
+ sw_version?: string;
17
+ hw_version?: string;
18
+ serial_number?: string;
19
+ suggested_area?: string;
20
+ via_device?: string;
21
+ configuration_url?: string;
22
+ [key: string]: unknown;
23
+ }
24
+ export interface Origin {
25
+ name?: string;
26
+ sw_version?: string;
27
+ support_url?: string;
28
+ [key: string]: unknown;
29
+ }
30
+ export interface AvailabilityEntry {
31
+ topic: string;
32
+ payload_available?: string;
33
+ payload_not_available?: string;
34
+ value_template?: string;
35
+ }
36
+ /** an entity's config with the long key names; the importer reads the fields it knows, keeps the rest */
37
+ export interface EntityConfig {
38
+ platform?: string;
39
+ name?: string | null;
40
+ unique_id?: string;
41
+ object_id?: string;
42
+ device?: DeviceInfo;
43
+ origin?: Origin;
44
+ availability?: AvailabilityEntry[];
45
+ availability_topic?: string;
46
+ availability_mode?: string;
47
+ availability_template?: string;
48
+ payload_available?: string;
49
+ payload_not_available?: string;
50
+ state_topic?: string;
51
+ command_topic?: string;
52
+ value_template?: string;
53
+ device_class?: string | null;
54
+ entity_category?: string | null;
55
+ enabled_by_default?: boolean;
56
+ expire_after?: number;
57
+ optimistic?: boolean;
58
+ unit_of_measurement?: string | null;
59
+ [key: string]: unknown;
60
+ }
61
+ /** every abbreviation expanded and `~` substituted, in the entity itself, its availability list, device and origin */
62
+ export declare function expandEntity(raw: Record<string, unknown>, inherited?: Record<string, unknown>): EntityConfig;
63
+ /** the device-based form: `components` each with a `platform`; returns the entities with the shared fields applied */
64
+ export declare function expandDevicePayload(raw: Record<string, unknown>): {
65
+ components: Record<string, EntityConfig>;
66
+ device?: DeviceInfo;
67
+ origin?: Origin;
68
+ };
69
+ export interface DiscoveryTopic {
70
+ /** the component, or `device` for the device-based form */
71
+ component: string;
72
+ nodeId?: string;
73
+ objectId: string;
74
+ }
75
+ /** `<prefix>/<component>/[<node_id>/]<object_id>/config`, or undefined for any other topic under the prefix */
76
+ export declare function parseDiscoveryTopic(prefix: string, topic: string): DiscoveryTopic | undefined;
77
+ /** the device key material: the first identifier, else the first connection (`mac:…`) */
78
+ export declare function deviceIdentity(device: DeviceInfo | undefined): string | undefined;