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.
- package/CHANGELOG.md +76 -0
- package/LICENSE +202 -0
- package/NOTICE +23 -0
- package/README.md +172 -2
- package/dist/app.d.ts +34 -0
- package/dist/app.js +157 -0
- package/dist/app.js.map +1 -0
- package/dist/commands/import-z2m.d.ts +20 -0
- package/dist/commands/import-z2m.js +173 -0
- package/dist/commands/import-z2m.js.map +1 -0
- package/dist/commands/install.d.ts +41 -0
- package/dist/commands/install.js +250 -0
- package/dist/commands/install.js.map +1 -0
- package/dist/commands/update.d.ts +14 -0
- package/dist/commands/update.js +109 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.js +3 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/load.d.ts +57 -0
- package/dist/config/load.js +137 -0
- package/dist/config/load.js.map +1 -0
- package/dist/config/schema.d.ts +496 -0
- package/dist/config/schema.js +115 -0
- package/dist/config/schema.js.map +1 -0
- package/dist/engine/payload.d.ts +94 -0
- package/dist/engine/payload.js +515 -0
- package/dist/engine/payload.js.map +1 -0
- package/dist/engine/runtime.d.ts +79 -0
- package/dist/engine/runtime.js +438 -0
- package/dist/engine/runtime.js.map +1 -0
- package/dist/engine/template.d.ts +20 -0
- package/dist/engine/template.js +264 -0
- package/dist/engine/template.js.map +1 -0
- package/dist/engine/units.d.ts +9 -0
- package/dist/engine/units.js +42 -0
- package/dist/engine/units.js.map +1 -0
- package/dist/families/climate.d.ts +11 -0
- package/dist/families/climate.js +68 -0
- package/dist/families/climate.js.map +1 -0
- package/dist/families/color.d.ts +30 -0
- package/dist/families/color.js +152 -0
- package/dist/families/color.js.map +1 -0
- package/dist/families/cover.d.ts +17 -0
- package/dist/families/cover.js +308 -0
- package/dist/families/cover.js.map +1 -0
- package/dist/families/fan.d.ts +16 -0
- package/dist/families/fan.js +154 -0
- package/dist/families/fan.js.map +1 -0
- package/dist/families/index.d.ts +32 -0
- package/dist/families/index.js +162 -0
- package/dist/families/index.js.map +1 -0
- package/dist/families/light.d.ts +36 -0
- package/dist/families/light.js +258 -0
- package/dist/families/light.js.map +1 -0
- package/dist/families/lock.d.ts +10 -0
- package/dist/families/lock.js +31 -0
- package/dist/families/lock.js.map +1 -0
- package/dist/families/on-off.d.ts +7 -0
- package/dist/families/on-off.js +56 -0
- package/dist/families/on-off.js.map +1 -0
- package/dist/families/power-source.d.ts +12 -0
- package/dist/families/power-source.js +60 -0
- package/dist/families/power-source.js.map +1 -0
- package/dist/families/registry.d.ts +40 -0
- package/dist/families/registry.js +72 -0
- package/dist/families/registry.js.map +1 -0
- package/dist/families/rvc.d.ts +40 -0
- package/dist/families/rvc.js +83 -0
- package/dist/families/rvc.js.map +1 -0
- package/dist/families/switch.d.ts +19 -0
- package/dist/families/switch.js +94 -0
- package/dist/families/switch.js.map +1 -0
- package/dist/importers/actions.d.ts +19 -0
- package/dist/importers/actions.js +98 -0
- package/dist/importers/actions.js.map +1 -0
- package/dist/importers/ha/areas.d.ts +6 -0
- package/dist/importers/ha/areas.js +279 -0
- package/dist/importers/ha/areas.js.map +1 -0
- package/dist/importers/ha/generate.d.ts +51 -0
- package/dist/importers/ha/generate.js +1376 -0
- package/dist/importers/ha/generate.js.map +1 -0
- package/dist/importers/ha/index.d.ts +6 -0
- package/dist/importers/ha/index.js +7 -0
- package/dist/importers/ha/index.js.map +1 -0
- package/dist/importers/ha/source.d.ts +36 -0
- package/dist/importers/ha/source.js +95 -0
- package/dist/importers/ha/source.js.map +1 -0
- package/dist/importers/ha/sync.d.ts +29 -0
- package/dist/importers/ha/sync.js +132 -0
- package/dist/importers/ha/sync.js.map +1 -0
- package/dist/importers/ha/templates.d.ts +18 -0
- package/dist/importers/ha/templates.js +285 -0
- package/dist/importers/ha/templates.js.map +1 -0
- package/dist/importers/ha/types.d.ts +78 -0
- package/dist/importers/ha/types.js +479 -0
- package/dist/importers/ha/types.js.map +1 -0
- package/dist/importers/index.d.ts +5 -0
- package/dist/importers/index.js +8 -0
- package/dist/importers/index.js.map +1 -0
- package/dist/importers/patch.d.ts +50 -0
- package/dist/importers/patch.js +224 -0
- package/dist/importers/patch.js.map +1 -0
- package/dist/importers/sync.d.ts +112 -0
- package/dist/importers/sync.js +220 -0
- package/dist/importers/sync.js.map +1 -0
- package/dist/importers/twins.d.ts +10 -0
- package/dist/importers/twins.js +34 -0
- package/dist/importers/twins.js.map +1 -0
- package/dist/importers/z2m/generate.d.ts +81 -0
- package/dist/importers/z2m/generate.js +1171 -0
- package/dist/importers/z2m/generate.js.map +1 -0
- package/dist/importers/z2m/index.d.ts +5 -0
- package/dist/importers/z2m/index.js +6 -0
- package/dist/importers/z2m/index.js.map +1 -0
- package/dist/importers/z2m/source.d.ts +18 -0
- package/dist/importers/z2m/source.js +46 -0
- package/dist/importers/z2m/source.js.map +1 -0
- package/dist/importers/z2m/sync.d.ts +29 -0
- package/dist/importers/z2m/sync.js +92 -0
- package/dist/importers/z2m/sync.js.map +1 -0
- package/dist/importers/z2m/types.d.ts +72 -0
- package/dist/importers/z2m/types.js +46 -0
- package/dist/importers/z2m/types.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/log.d.ts +17 -0
- package/dist/log.js +54 -0
- package/dist/log.js.map +1 -0
- package/dist/main.d.ts +2 -0
- package/dist/main.js +202 -0
- package/dist/main.js.map +1 -0
- package/dist/matter/bridge.d.ts +113 -0
- package/dist/matter/bridge.js +467 -0
- package/dist/matter/bridge.js.map +1 -0
- package/dist/matter/check.d.ts +11 -0
- package/dist/matter/check.js +116 -0
- package/dist/matter/check.js.map +1 -0
- package/dist/matter/cluster-defaults.d.ts +6 -0
- package/dist/matter/cluster-defaults.js +63 -0
- package/dist/matter/cluster-defaults.js.map +1 -0
- package/dist/matter/commissioning.d.ts +21 -0
- package/dist/matter/commissioning.js +88 -0
- package/dist/matter/commissioning.js.map +1 -0
- package/dist/matter/device-types.d.ts +44 -0
- package/dist/matter/device-types.js +230 -0
- package/dist/matter/device-types.js.map +1 -0
- package/dist/matter/ids.d.ts +31 -0
- package/dist/matter/ids.js +83 -0
- package/dist/matter/ids.js.map +1 -0
- package/dist/matter/index.d.ts +7 -0
- package/dist/matter/index.js +8 -0
- package/dist/matter/index.js.map +1 -0
- package/dist/matter/node-manager.d.ts +39 -0
- package/dist/matter/node-manager.js +161 -0
- package/dist/matter/node-manager.js.map +1 -0
- package/dist/matter/shards.d.ts +26 -0
- package/dist/matter/shards.js +93 -0
- package/dist/matter/shards.js.map +1 -0
- package/dist/model/attribute.d.ts +18 -0
- package/dist/model/attribute.js +28 -0
- package/dist/model/attribute.js.map +1 -0
- package/dist/model/catalog.d.ts +79 -0
- package/dist/model/catalog.js +223 -0
- package/dist/model/catalog.js.map +1 -0
- package/dist/model/index.d.ts +7 -0
- package/dist/model/index.js +8 -0
- package/dist/model/index.js.map +1 -0
- package/dist/model/migrate.d.ts +4 -0
- package/dist/model/migrate.js +39 -0
- package/dist/model/migrate.js.map +1 -0
- package/dist/model/options.d.ts +102 -0
- package/dist/model/options.js +88 -0
- package/dist/model/options.js.map +1 -0
- package/dist/model/presets.d.ts +37 -0
- package/dist/model/presets.js +105 -0
- package/dist/model/presets.js.map +1 -0
- package/dist/model/schema.d.ts +1747 -0
- package/dist/model/schema.js +243 -0
- package/dist/model/schema.js.map +1 -0
- package/dist/model/validate.d.ts +21 -0
- package/dist/model/validate.js +484 -0
- package/dist/model/validate.js.map +1 -0
- package/dist/mqtt/client.d.ts +38 -0
- package/dist/mqtt/client.js +94 -0
- package/dist/mqtt/client.js.map +1 -0
- package/dist/mqtt/index.d.ts +2 -0
- package/dist/mqtt/index.js +3 -0
- package/dist/mqtt/index.js.map +1 -0
- package/dist/mqtt/topic-cache.d.ts +20 -0
- package/dist/mqtt/topic-cache.js +58 -0
- package/dist/mqtt/topic-cache.js.map +1 -0
- package/dist/server/auth.d.ts +59 -0
- package/dist/server/auth.js +185 -0
- package/dist/server/auth.js.map +1 -0
- package/dist/server/catalog.d.ts +52 -0
- package/dist/server/catalog.js +96 -0
- package/dist/server/catalog.js.map +1 -0
- package/dist/server/compact.d.ts +3 -0
- package/dist/server/compact.js +105 -0
- package/dist/server/compact.js.map +1 -0
- package/dist/server/config-store.d.ts +36 -0
- package/dist/server/config-store.js +155 -0
- package/dist/server/config-store.js.map +1 -0
- package/dist/server/events.d.ts +50 -0
- package/dist/server/events.js +71 -0
- package/dist/server/events.js.map +1 -0
- package/dist/server/http.d.ts +27 -0
- package/dist/server/http.js +168 -0
- package/dist/server/http.js.map +1 -0
- package/dist/server/importers.d.ts +40 -0
- package/dist/server/importers.js +75 -0
- package/dist/server/importers.js.map +1 -0
- package/dist/server/index.d.ts +6 -0
- package/dist/server/index.js +8 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/log-buffer.d.ts +22 -0
- package/dist/server/log-buffer.js +55 -0
- package/dist/server/log-buffer.js.map +1 -0
- package/dist/server/presets.d.ts +17 -0
- package/dist/server/presets.js +55 -0
- package/dist/server/presets.js.map +1 -0
- package/dist/server/preview.d.ts +19 -0
- package/dist/server/preview.js +121 -0
- package/dist/server/preview.js.map +1 -0
- package/dist/server/server.d.ts +107 -0
- package/dist/server/server.js +810 -0
- package/dist/server/server.js.map +1 -0
- package/dist/server/update.d.ts +60 -0
- package/dist/server/update.js +191 -0
- package/dist/server/update.js.map +1 -0
- package/docs/api.md +128 -0
- package/docs/architecture.md +121 -0
- package/docs/config.md +538 -0
- package/docs/importers.md +241 -0
- package/example/mqtt2matter.json +276 -0
- package/package.json +90 -4
- package/presets/mqtt-smarthome/button.json +47 -0
- package/presets/mqtt-smarthome/contact.json +37 -0
- package/presets/mqtt-smarthome/cover.json +50 -0
- package/presets/mqtt-smarthome/dimmer.json +57 -0
- package/presets/mqtt-smarthome/humidity.json +38 -0
- package/presets/mqtt-smarthome/light.json +47 -0
- package/presets/mqtt-smarthome/occupancy.json +46 -0
- package/presets/mqtt-smarthome/switch.json +47 -0
- package/presets/mqtt-smarthome/temperature.json +38 -0
- package/presets/openbeken/color-light.json +64 -0
- package/presets/openbeken/ct-light.json +51 -0
- package/presets/openbeken/dimmer.json +47 -0
- package/presets/openbeken/humidity.json +37 -0
- package/presets/openbeken/relay.json +40 -0
- package/presets/openbeken/temperature.json +41 -0
- package/presets/shelly-gen1/dimmer.json +48 -0
- package/presets/shelly-gen1/door-window.json +43 -0
- package/presets/shelly-gen1/ht.json +43 -0
- package/presets/shelly-gen1/relay-pm.json +60 -0
- package/presets/shelly-gen1/relay.json +36 -0
- package/presets/shelly-gen1/roller.json +52 -0
- package/presets/shelly-gen2/cover.json +68 -0
- package/presets/shelly-gen2/dimmer.json +61 -0
- package/presets/shelly-gen2/ht.json +47 -0
- package/presets/shelly-gen2/i4.json +82 -0
- package/presets/shelly-gen2/switch-pm.json +101 -0
- package/presets/shelly-gen2/switch.json +47 -0
- package/presets/tasmota/climate.json +52 -0
- package/presets/tasmota/color-light.json +63 -0
- package/presets/tasmota/ct-light.json +50 -0
- package/presets/tasmota/dimmer.json +45 -0
- package/presets/tasmota/relay.json +39 -0
- package/presets/tasmota/shutter.json +46 -0
- package/presets/tasmota/temperature-humidity.json +42 -0
- package/presets/tasmota/temperature.json +32 -0
- package/presets/valetudo/vacuum.json +103 -0
- package/presets/wled/dimmer.json +46 -0
- package/presets/wled/light.json +59 -0
- package/ui/dist/assets/index-BDtT6bdH.js +10 -0
- package/ui/dist/assets/index-CHiG-aoU.css +1 -0
- package/ui/dist/index.html +18 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;6DAG6D;AAE7D,OAAO,EAAC,YAAY,EAA4B,MAAM,WAAW,CAAC;AAElE,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AACrC,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAKxE,OAAO,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAC,YAAY,EAAuC,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAa,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAC,WAAW,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AACtD,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AACrC,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,IAAI,EAAE,YAAY,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAgB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAC,MAAM,WAAW,CAAC;AACjF,OAAO,EAAC,OAAO,EAAC,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AACzC,OAAO,EAAC,cAAc,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAoD3D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEnF,wEAAwE;AACxE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAC9B,eAAe;IACf,qBAAqB;IACrB,sBAAsB;IACtB,WAAW;IACX,YAAY;IACZ,iBAAiB;CACpB,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,uFAAuF;AACvF,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAExG,SAAS,IAAI,CAAC,OAAgB;IAC1B,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,OAAO,MAAM;IACN,OAAO,CAAgB;IACf,GAAG,CAAM;IACT,KAAK,CAAc;IACnB,GAAG,CAAS;IACZ,GAAG,CAAW;IACd,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IACtB,IAAI,CAAa;IACjB,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,WAAW,GAAmB,EAAE,CAAC;IACjC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,CAAO;IACX,OAAO,CAAU;IAElC,YAAY,OAAsB;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,OAAO,CAAC,EAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC;QACxG,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;YACtE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAC,KAAK,EAAE,yBAAyB,EAAC,CAAC,CAAC;oBAC5D,OAAO;gBACX,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CACxC,CAAC,OAAO,EAAE,EAAE;oBACR,IAAI,CAAC,OAAO,EAAE,CAAC;wBACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAC,KAAK,EAAE,YAAY,IAAI,EAAE,EAAC,CAAC,CAAC;oBACzD,CAAC;gBACL,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;oBACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC;oBAChE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;wBACxB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAC,KAAK,EAAE,gBAAgB,EAAC,CAAC,CAAC;oBACvD,CAAC;gBACL,CAAC,CACJ,CAAC;gBACF,OAAO;YACX,CAAC;YACD,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC3E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;YACtE,IAAI,IAAI,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;YAC9F,CAAC;iBAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAwB,CAAC;QAC1D,OAAO,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;QAC5C,MAAM,IAAI,OAAO,CAAO,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;gBAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/B,aAAa,EAAE,CAAC;YACpB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,KAAK;QACP,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;QACL,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACtC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACD,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACzC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,QAAQ,QAAQ,CAAC,IAAI,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACxF,CAAC;YACL,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,MAAe,EAAQ,EAAE;YACxE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;gBACf,IAAI,EAAE,MAAM;gBACZ,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;gBAClD,MAAM;gBACN,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;aACjB,CAAC,CAAC;YACH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACtC,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,YAAY,EAAC,CAAC,CAAC;gBAC7C,CAAC;YACL,CAAC;QACL,CAAC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE;YACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,GAAS,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;QACrD,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACvB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;QACtD,CAAC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE;YACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,IAAI,CACjB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACrC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CACL,CAAC;QACF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,SAAS;YACb,CAAC;YACD,MAAM,MAAM,GAAG,GAAS,EAAE;gBACtB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;YAC1C,CAAC,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,EAAE,CAAC;QACV,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,OAAO,CAAO,CAAC,YAAY,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;gBACjB,YAAY,EAAE,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,8EAA8E;IACtE,OAAO,CAAC,GAAW,EAAE,MAAoB;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,MAAM,IAAI,GAAmB,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACpB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CACrF,CAAC;YACF,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAA6D,CAAC;YAC/F,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;gBACvD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9C,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;wBACnC,SAAS;oBACb,CAAC;oBACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,SAAS,UAAU,CACkB,CAAC;oBACjF,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;wBAClE,SAAS;oBACb,CAAC;oBACD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAQ,EAAE;wBACtC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAC,CAAC,CAAC;oBAClG,CAAC,CAAC;oBACF,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;wBACX,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,SAAS,CAAC,GAAW;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,GAAG,EAAE,CAAC;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,iGAAiG;IAEzF,SAAS;QACb,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4E,CAAC;QAChG,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAChC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,EAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAC,CAAC,CAAC;YACjG,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAEO,WAAW;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;YACjE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,CAAC,6BAA6B,EAAE,SAAS,CAAC;YACzE,OAAO;gBACH,GAAG;gBACH,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,EAAE;gBACnD,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM;gBACvC,MAAM,EAAE,MAAM,EAAE,MAAM;gBACtB,SAAS,EAAE,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBACjE,KAAK,EAAE,MAAM,KAAK,SAAS;gBAC3B,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC;gBACnC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;gBAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;aACnC,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,GAAW;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAY,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3D,KAAK,MAAM,EAAC,UAAU,EAAE,SAAS,EAAC,IAAI,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC;gBACR,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,aAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,GAAG;gBAC5E,OAAO,EAAE,GAAG,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,WAAW,MAAM,SAAS,CAAC,MAAM,EAAE;aACvG,CAAC,CAAC;QACP,CAAC;QACD,OAAO;YACH,GAAG;YACH,MAAM;YACN,MAAM;YACN,KAAK,EAAE,MAAM,KAAK,SAAS;YAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM;YAC1D,MAAM,EAAE,MAAM,EAAE,MAAM;YACtB,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SACnE,CAAC;IACN,CAAC;IAEO,SAAS,CAAC,MAAoB;QAClC,MAAM,GAAG,GAAiE,EAAE,CAAC;QAC7E,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,KAAK,GAA4C,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,CACpB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CACrF,CAAC;YACF,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBACxB,SAAS;gBACb,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAC9E,CAAC;YACN,CAAC;YACD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,GAAY;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,uBAAuB,EAAE;gBAC9C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACxC,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;oBACtC,OAAO,EAAE,KAAK,CAAC,OAAO;iBACzB,CAAC,CAAC;aACN,CAAC,CAAC;QACP,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,GAAW;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;IAC1C,CAAC;IAED,kGAAkG;IAE1F,WAAW;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/B,MAAM,OAAO,GACT,IAAI,KAAK,SAAS;gBACd,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACpC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;oBAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,YAAY;oBACxB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBACxB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;iBAC/B,CAAC,CAAC,CAAC;YACd,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACD,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,YAAY,CAAC;gBACjE,CAAC;gBAAC,MAAM,CAAC;oBACL,YAAY,GAAG,CAAC,CAAC;gBACrB,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO;gBACH,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC5B,OAAO;gBACP,YAAY;aACf,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU,CAAC,EAAU;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kGAAkG;IAE1F,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IACxC,CAAC;IAEO,QAAQ,CAAC,IAAY;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,0FAA0F;IAClF,WAAW;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAA0B,CAAC;QACtD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAC,CAAC,CAAC,CAC/E,CAAC;IACN,CAAC;IAED,mGAAmG;IAC3F,KAAK,CAAC,aAAa,CACvB,MAAoB,EACpB,KAAmB,EACnB,IAA0B;QAE1B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,SAAS;YACb,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,SAAS;YACb,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,kGAAkG;IAE1F,UAAU;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;YACzD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,iCAAiC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC;YACrF,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;YACvD,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAClG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;YAC/C,CAAC;YACD,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YACvE,OAAO,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YACpD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3E,OAAO,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAC,CAAC;QAChH,CAAC,CAAC,CAAC;QACH,yGAAyG;QACzG,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC7D,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAC,GAAG,QAAQ,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,GAA4B,EAAC,IAAI,EAAC,CAAC;YAC5C,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,cAAc,CAAU,EAAE,CAAC;gBAC3E,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACxD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACrB,CAAC;YACL,CAAC;YACD,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YAClC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;gBACtD,IAAI,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACtB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACrB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;gBAC/D,CAAC;gBACD,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,oCAAoC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1G,CAAC;YACD,8EAA8E;YAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YACvC,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9E,MAAM,IAAI,SAAS,CACf,GAAG,EACH,+BAA+B,MAAM,2CAA2C,CACnF,CAAC;YACN,CAAC;YACD,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;YAClB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC3E,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACtB,2CAA2C;gBAC3C,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAC5F,CAAC;YACD,OAAO,EAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,kGAAkG;IAE1F,MAAM;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAEtB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;YACxD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO;YACzB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC3B,IAAI,EAAE,EAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAC;YACzE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE;YAC3B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;YACpD,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9C,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;SAC7B,CAAC,CAAC,CAAC;QAEJ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;YAC7D,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACxD,OAAO,EAAC,SAAS,EAAE,OAAO,EAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC/C,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;YAC1D,OAAO,EAAC,UAAU,EAAE,IAAI,EAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAClC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,SAAS,EAAE;gBACP,IAAI,EAAE;oBACF,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI;oBACvB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;iBAC5E;gBACD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO;gBAChC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG;gBACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ;gBAClC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS;gBACpC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO;gBAChC,MAAM,EAAE;oBACJ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM;oBACzB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;iBACzB;gBACD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO;gBAChC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS;aACvC;SACJ,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1C,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,EAAC,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAChD,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACnD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YACvC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;oBACH,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACxC,KAAK,EAAE,OAAO;wBACd,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;wBACtC,OAAO,EAAE,KAAK,CAAC,OAAO;qBACzB,CAAC,CAAC;iBACN,CAAC;YACN,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,EAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACrC,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnB,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAClB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,EAAE,EAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC;oBACxF,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC/B,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;YAChE,OAAO,EAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC5F,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACxG,CAAC;YACD,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,oCAAoC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;gBAChD,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC5F,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAC,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,GAAG,EAAC,CAAC,CAAC;YAChF,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK;iBACrB,MAAM,EAAE;iBACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;iBAC3C,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACX,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/C,OAAO;oBACH,KAAK;oBACL,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE;oBACjE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;oBAChC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC;iBACvB,CAAC;YACN,CAAC,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,6BAA6B,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAEjG,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE;YACpC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3D,OAAO;gBACH,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAC,EAAE,EAAE,CAAC,CAAC;oBACvD,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,OAAO;oBACP,IAAI;iBACP,CAAC,CAAC;gBACH,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC7B,CAAC;QACN,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtD,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACpC,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,WAAW,CACtB,KAAK,CAAC,MAAM,EACZ,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACrG,CAAC;gBACF,OAAO,EAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,EAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,IAAI,SAAS,CAAC,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACJ,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9F,MAAM,YAAY,CAAC,uBAAuB,CAAC,EAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAC,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,iCAAiC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,CAAC;YACxF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,KAAK,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9B,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE;SAC9B,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,EAAE;YAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAiB,CAAC;gBACtE,MAAM,EAAC,OAAO,EAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAAC;gBACjF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,EAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAC,CAAC;QAClG,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;YAC/B,MAAM,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAiB,CAAC;YACtE,MAAM,EAAC,OAAO,EAAE,MAAM,EAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE;gBAC7C,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,KAAK;gBACb,KAAK;gBACL,OAAO;aACV,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/D,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,uBAAuB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpF,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,IAAI,SAAS,CACf,GAAG,EACH,GAAG,GAAG,0BAA0B,KAAK,CAAC,OAAO,IAAI,GAAG,6CAA6C;oBAC7F,sEAAsE,EAC1E,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,EAAC,CACrD,CAAC;YACN,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACnG,OAAO,EAAC,GAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAY,EAAE,KAAK,EAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACpB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC;gBACjD,CAAC;gBACD,QAAQ,CAAC,SAAS,CAAC,qBAAqB,EAAE,yBAAyB,GAAG,QAAQ,CAAC,CAAC;gBAChF,OAAO,EAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAC,CAAC;YACxB,CAAC;YACD,QAAQ,CAAC,SAAS,CAAC,qBAAqB,EAAE,yCAAyC,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC/B,CAAC,CAAC,CAAC,CAAC,OAAO;gBACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAClB,CAAC,CAAE,CAAC,CAAC,MAA8B,CAAC,OAAO;oBAC3C,CAAC,CAAC,SAAS,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,yDAAyD,CAAC,CAAC;YACxF,CAAC;YACD,mDAAmD;YACnD,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAClB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,EAAE;wBACjD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;4BACxC,KAAK,EAAE,OAAO;4BACd,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;4BAClD,OAAO,EAAE,KAAK,CAAC,OAAO;yBACzB,CAAC,CAAC;qBACN,CAAC,CAAC;gBACP,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;wBACpB,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;oBACrC,CAAC;gBACL,CAAC;YACL,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBACnC,OAAO,EAAE,CAAC;YACd,CAAC;YACD,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAC3B,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACvF,CAAC;YACN,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,CAAC;YACtC,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EACpC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACrC,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { RESTART_EXIT_CODE } from '../commands/install.ts';
|
|
2
|
+
export { RESTART_EXIT_CODE };
|
|
3
|
+
/** the registry's latest version; undefined when the package is not published */
|
|
4
|
+
export type FetchLatest = () => Promise<string | undefined>;
|
|
5
|
+
export declare const npmLatest: FetchLatest;
|
|
6
|
+
/** -1, 0, 1 over x.y.z; a pre-release sorts before its release */
|
|
7
|
+
export declare function compareVersions(a: string, b: string): number;
|
|
8
|
+
export interface UpdaterOptions {
|
|
9
|
+
current: string;
|
|
10
|
+
/** `systemd` when the unit restarts the process on RESTART_EXIT_CODE */
|
|
11
|
+
supervisor?: string | undefined;
|
|
12
|
+
/** where the update request goes (the path unit watches it) */
|
|
13
|
+
updateDir?: string | undefined;
|
|
14
|
+
fetchLatest?: FetchLatest;
|
|
15
|
+
now?: () => number;
|
|
16
|
+
}
|
|
17
|
+
export interface UpdateStatus {
|
|
18
|
+
current: string;
|
|
19
|
+
/** the registry's latest; absent when not published or not checked */
|
|
20
|
+
latest?: string;
|
|
21
|
+
published: boolean | undefined;
|
|
22
|
+
newer: boolean;
|
|
23
|
+
checkedAt?: string;
|
|
24
|
+
error?: string;
|
|
25
|
+
restart: {
|
|
26
|
+
available: boolean;
|
|
27
|
+
reason?: string;
|
|
28
|
+
};
|
|
29
|
+
update: {
|
|
30
|
+
available: boolean;
|
|
31
|
+
reason?: string;
|
|
32
|
+
requested?: string;
|
|
33
|
+
log: string[];
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
export declare class Updater {
|
|
37
|
+
private readonly options;
|
|
38
|
+
private readonly fetchLatest;
|
|
39
|
+
private readonly now;
|
|
40
|
+
private latest;
|
|
41
|
+
private published;
|
|
42
|
+
private checkedAt;
|
|
43
|
+
private error;
|
|
44
|
+
private checking;
|
|
45
|
+
constructor(options: UpdaterOptions);
|
|
46
|
+
get restartReason(): string | undefined;
|
|
47
|
+
/** the latest version seen, without asking the registry (for /api/status) */
|
|
48
|
+
get known(): {
|
|
49
|
+
latest?: string;
|
|
50
|
+
newer: boolean;
|
|
51
|
+
};
|
|
52
|
+
/** ask the registry when the last answer is older than the interval (or `force`) */
|
|
53
|
+
check(force?: boolean): Promise<void>;
|
|
54
|
+
private updateReason;
|
|
55
|
+
private readLog;
|
|
56
|
+
private pending;
|
|
57
|
+
status(): Promise<UpdateStatus>;
|
|
58
|
+
/** write the request for the root helper; the reason it cannot be done, or undefined */
|
|
59
|
+
request(version: string): Promise<string | undefined>;
|
|
60
|
+
}
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
/* Restart and update from the UI.
|
|
2
|
+
|
|
3
|
+
- Restart: under systemd (`--install` writes `MQTT2MATTER_SUPERVISOR=systemd` and `RestartForceExitStatus=75`
|
|
4
|
+
into the unit) the process stops cleanly and exits with 75, and systemd starts it again. Anywhere else there
|
|
5
|
+
is nothing that would bring it back, so the UI says so instead of exiting.
|
|
6
|
+
- Update: the registry's `latest` of the package, checked at most every few hours; "not published" while there
|
|
7
|
+
is none. Installing needs root (the global npm prefix), so the service writes the version into the request
|
|
8
|
+
file of `MQTT2MATTER_UPDATE_DIR`; the root oneshot `mqtt2matter --apply-update` (commands/update.ts), started
|
|
9
|
+
by the path unit `--install` sets up, installs it, logs into the same directory and restarts the service. */
|
|
10
|
+
import { readFile, rename, stat, writeFile } from 'node:fs/promises';
|
|
11
|
+
import { join } from 'node:path';
|
|
12
|
+
import { RESTART_EXIT_CODE } from "../commands/install.js";
|
|
13
|
+
import { PACKAGE, UPDATE_LOG, UPDATE_REQUEST, VERSION_PATTERN } from "../commands/update.js";
|
|
14
|
+
export { RESTART_EXIT_CODE };
|
|
15
|
+
const CHECK_INTERVAL_MS = 6 * 3600 * 1000;
|
|
16
|
+
export const npmLatest = async () => {
|
|
17
|
+
const response = await fetch(`https://registry.npmjs.org/${PACKAGE}/latest`, {
|
|
18
|
+
headers: { accept: 'application/json' },
|
|
19
|
+
signal: AbortSignal.timeout(10_000),
|
|
20
|
+
});
|
|
21
|
+
if (response.status === 404) {
|
|
22
|
+
return undefined;
|
|
23
|
+
}
|
|
24
|
+
if (!response.ok) {
|
|
25
|
+
throw new Error(`the registry answered ${response.status}`);
|
|
26
|
+
}
|
|
27
|
+
const body = (await response.json());
|
|
28
|
+
return typeof body.version === 'string' ? body.version : undefined;
|
|
29
|
+
};
|
|
30
|
+
/** -1, 0, 1 over x.y.z; a pre-release sorts before its release */
|
|
31
|
+
export function compareVersions(a, b) {
|
|
32
|
+
const parse = (v) => {
|
|
33
|
+
const [core = '', pre = ''] = v.split('-', 2);
|
|
34
|
+
return [core.split('.').map((n) => Number(n) || 0), pre];
|
|
35
|
+
};
|
|
36
|
+
const [ca, pa] = parse(a);
|
|
37
|
+
const [cb, pb] = parse(b);
|
|
38
|
+
for (let i = 0; i < 3; i++) {
|
|
39
|
+
const d = (ca[i] ?? 0) - (cb[i] ?? 0);
|
|
40
|
+
if (d !== 0) {
|
|
41
|
+
return Math.sign(d);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
if (pa === pb) {
|
|
45
|
+
return 0;
|
|
46
|
+
}
|
|
47
|
+
if (pa === '') {
|
|
48
|
+
return 1;
|
|
49
|
+
}
|
|
50
|
+
if (pb === '') {
|
|
51
|
+
return -1;
|
|
52
|
+
}
|
|
53
|
+
return pa < pb ? -1 : 1;
|
|
54
|
+
}
|
|
55
|
+
export class Updater {
|
|
56
|
+
options;
|
|
57
|
+
fetchLatest;
|
|
58
|
+
now;
|
|
59
|
+
latest;
|
|
60
|
+
published;
|
|
61
|
+
checkedAt;
|
|
62
|
+
error;
|
|
63
|
+
checking;
|
|
64
|
+
constructor(options) {
|
|
65
|
+
this.options = options;
|
|
66
|
+
this.fetchLatest = options.fetchLatest ?? npmLatest;
|
|
67
|
+
this.now = options.now ?? Date.now;
|
|
68
|
+
}
|
|
69
|
+
get restartReason() {
|
|
70
|
+
return this.options.supervisor === 'systemd'
|
|
71
|
+
? undefined
|
|
72
|
+
: 'not running as the systemd service (mqtt2matter --install): nothing would start it again';
|
|
73
|
+
}
|
|
74
|
+
/** the latest version seen, without asking the registry (for /api/status) */
|
|
75
|
+
get known() {
|
|
76
|
+
return {
|
|
77
|
+
...(this.latest === undefined ? {} : { latest: this.latest }),
|
|
78
|
+
newer: this.latest !== undefined && compareVersions(this.latest, this.options.current) > 0,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/** ask the registry when the last answer is older than the interval (or `force`) */
|
|
82
|
+
async check(force = false) {
|
|
83
|
+
if (!force && this.checkedAt !== undefined && this.now() - this.checkedAt < CHECK_INTERVAL_MS) {
|
|
84
|
+
return;
|
|
85
|
+
}
|
|
86
|
+
this.checking ??= (async () => {
|
|
87
|
+
try {
|
|
88
|
+
this.latest = await this.fetchLatest();
|
|
89
|
+
this.published = this.latest !== undefined;
|
|
90
|
+
this.error = undefined;
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
this.error = error instanceof Error ? error.message : String(error);
|
|
94
|
+
}
|
|
95
|
+
finally {
|
|
96
|
+
this.checkedAt = this.now();
|
|
97
|
+
this.checking = undefined;
|
|
98
|
+
}
|
|
99
|
+
})();
|
|
100
|
+
await this.checking;
|
|
101
|
+
}
|
|
102
|
+
async updateReason() {
|
|
103
|
+
const dir = this.options.updateDir;
|
|
104
|
+
if (this.options.supervisor !== 'systemd' || dir === undefined) {
|
|
105
|
+
return 'installed without the systemd service (mqtt2matter --install): update with npm or deploy.sh';
|
|
106
|
+
}
|
|
107
|
+
try {
|
|
108
|
+
if (!(await stat(dir)).isDirectory()) {
|
|
109
|
+
return `${dir} is not a directory`;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return `${dir} is missing: run mqtt2matter --install again`;
|
|
114
|
+
}
|
|
115
|
+
return undefined;
|
|
116
|
+
}
|
|
117
|
+
async readLog() {
|
|
118
|
+
if (this.options.updateDir === undefined) {
|
|
119
|
+
return [];
|
|
120
|
+
}
|
|
121
|
+
try {
|
|
122
|
+
const text = await readFile(join(this.options.updateDir, UPDATE_LOG), 'utf8');
|
|
123
|
+
return text
|
|
124
|
+
.split('\n')
|
|
125
|
+
.filter((line) => line !== '')
|
|
126
|
+
.slice(-200);
|
|
127
|
+
}
|
|
128
|
+
catch {
|
|
129
|
+
return [];
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
async pending() {
|
|
133
|
+
if (this.options.updateDir === undefined) {
|
|
134
|
+
return undefined;
|
|
135
|
+
}
|
|
136
|
+
try {
|
|
137
|
+
return (await readFile(join(this.options.updateDir, UPDATE_REQUEST), 'utf8')).trim();
|
|
138
|
+
}
|
|
139
|
+
catch {
|
|
140
|
+
return undefined;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
async status() {
|
|
144
|
+
const restartReason = this.restartReason;
|
|
145
|
+
const updateReason = await this.updateReason();
|
|
146
|
+
const requested = await this.pending();
|
|
147
|
+
return {
|
|
148
|
+
current: this.options.current,
|
|
149
|
+
...(this.latest === undefined ? {} : { latest: this.latest }),
|
|
150
|
+
published: this.published,
|
|
151
|
+
newer: this.known.newer,
|
|
152
|
+
...(this.checkedAt === undefined ? {} : { checkedAt: new Date(this.checkedAt).toISOString() }),
|
|
153
|
+
...(this.error === undefined ? {} : { error: this.error }),
|
|
154
|
+
restart: {
|
|
155
|
+
available: restartReason === undefined,
|
|
156
|
+
...(restartReason === undefined ? {} : { reason: restartReason }),
|
|
157
|
+
},
|
|
158
|
+
update: {
|
|
159
|
+
available: updateReason === undefined,
|
|
160
|
+
...(updateReason === undefined ? {} : { reason: updateReason }),
|
|
161
|
+
...(requested === undefined ? {} : { requested }),
|
|
162
|
+
log: await this.readLog(),
|
|
163
|
+
},
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
/** write the request for the root helper; the reason it cannot be done, or undefined */
|
|
167
|
+
async request(version) {
|
|
168
|
+
const reason = await this.updateReason();
|
|
169
|
+
if (reason !== undefined) {
|
|
170
|
+
return reason;
|
|
171
|
+
}
|
|
172
|
+
if (!VERSION_PATTERN.test(version)) {
|
|
173
|
+
return 'not a version';
|
|
174
|
+
}
|
|
175
|
+
if (this.latest === undefined) {
|
|
176
|
+
return this.published === false
|
|
177
|
+
? `${PACKAGE} is not published on npm yet`
|
|
178
|
+
: 'no version known yet: check first';
|
|
179
|
+
}
|
|
180
|
+
if (version !== this.latest || compareVersions(version, this.options.current) <= 0) {
|
|
181
|
+
return `only the newer latest version ${this.latest} can be installed`;
|
|
182
|
+
}
|
|
183
|
+
const dir = this.options.updateDir ?? '';
|
|
184
|
+
const tmp = join(dir, `.${UPDATE_REQUEST}.${process.pid}`);
|
|
185
|
+
await writeFile(tmp, `${version}\n`, { mode: 0o640 });
|
|
186
|
+
// the rename makes the path unit see a complete file
|
|
187
|
+
await rename(tmp, join(dir, UPDATE_REQUEST));
|
|
188
|
+
return undefined;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=update.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/server/update.ts"],"names":[],"mappings":"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"}
|
package/docs/api.md
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# The API
|
|
2
|
+
|
|
3
|
+
The web UI talks to the bridge through this API and nothing else; it is the contract between `ui/` and
|
|
4
|
+
`src/server/`. REST under `/api/`, JSON both ways; one WebSocket at `/api/events`. The server listens
|
|
5
|
+
on `server.host:server.port` (`0.0.0.0:8282` by default, see [config.md](config.md)) and serves the built
|
|
6
|
+
UI for every other path.
|
|
7
|
+
|
|
8
|
+
**Access** is `server.auth` ([config.md](config.md#access)): with `none` (the default) every route is open;
|
|
9
|
+
with `password` or `proxy` every route but the three under `/api/auth` answers `401` without a session cookie or
|
|
10
|
+
the proxy's header, and the WebSocket upgrade of `/api/events` is refused with `401`.
|
|
11
|
+
|
|
12
|
+
## Authentication
|
|
13
|
+
|
|
14
|
+
| Route | Answer |
|
|
15
|
+
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
16
|
+
| `GET /api/auth` | open; `{mode, authenticated, user?, logoutUrl?}` — `user` and `logoutUrl` in proxy mode |
|
|
17
|
+
| `POST /api/auth/login` | open; `{password}` → `{mode, authenticated: true}` and the session cookie `mqtt2matter_session`; `401` for a wrong password, `429` after ten failures from the address within 15 minutes, `400` outside password mode |
|
|
18
|
+
| `POST /api/auth/logout` | open; ends the session and clears the cookie |
|
|
19
|
+
| `PUT /api/auth` | `{mode, password?, proxyHeader?, proxyLogoutUrl?}`: the access settings, written to the file (the password as its hash) and applied at once; every session ends, the caller gets a new one in password mode. `400` for password mode without a password (none set before), `409` for proxy mode on a request without the header, or when the environment sets the mode |
|
|
20
|
+
|
|
21
|
+
## Conventions
|
|
22
|
+
|
|
23
|
+
- A request body is JSON (`content-type: application/json`), at most 8 MB.
|
|
24
|
+
- A success is `200` with a JSON body, or `204` without one. An error is `4xx`/`5xx` with
|
|
25
|
+
`{"error": "<message>", "details"?: …}`; a device that does not parse comes back as `400` with
|
|
26
|
+
`details.issues: [{level, path, message}]`, the same shape the validator uses.
|
|
27
|
+
- Values matter.js hands out as bigints are strings in JSON; byte arrays are hex.
|
|
28
|
+
- A **device** in a request or response is a device entry of [config.md](config.md) — the parsed form
|
|
29
|
+
(every field present, defaults filled) in responses; a request may leave the defaults out. The file is
|
|
30
|
+
written in the compact form (no defaults).
|
|
31
|
+
- `:key` is a device key, `:id` a bridge id.
|
|
32
|
+
|
|
33
|
+
## Status and configuration
|
|
34
|
+
|
|
35
|
+
| Route | Answer |
|
|
36
|
+
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
37
|
+
| `GET /api/status` | `{version, uptime (s), running, configPath, mqtt: {url, connected}, bridges: [bridge…], devices: n, importers: ["z2m", …], update: {latest?, newer}}` |
|
|
38
|
+
| `GET /api/config` | `{path, settings, overridden, effective}` — `settings` is the file's top level without `devices` (what the editor saves back), `overridden` the paths the environment sets (`["mqtt.url"]`), `effective` the running values with the MQTT password masked |
|
|
39
|
+
| `PUT /api/config` | body: the `settings` object (`mqtt`, `storage`, `log`, `vendorId`, `productId`, `bridges`, `server`, `presets`, `importers`); validated as a whole; `409` when a path the environment owns would change; answers `{saved: true, restartNeeded: true}` — settings apply at the next start |
|
|
40
|
+
| `GET /api/update` | `?check=1` asks the registry now (else at most every 6 hours); `{current, latest?, published, newer, checkedAt?, error?, restart: {available, reason?}, update: {available, reason?, requested?, log}}` — `published: false` while the package is not on npm, `log` the last lines of the update helper's log |
|
|
41
|
+
| `POST /api/update` | `{version}`: the registry's newer latest version only; writes the request the root helper takes (README "Restart and update from the UI"); `409` with the reason otherwise (not under the service, not published, not the latest) |
|
|
42
|
+
| `POST /api/restart` | `{restarting: true}`, then a clean stop with exit code 75, which the service's unit restarts on; `409` when not running as that service |
|
|
43
|
+
|
|
44
|
+
## Devices
|
|
45
|
+
|
|
46
|
+
| Route | Answer |
|
|
47
|
+
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
48
|
+
| `GET /api/devices` | `[{key, name, enabled, deviceTypes, endpoints: n, source, bridge, number, reachable, built, violations, errors, warnings}]` — `number` is the Matter endpoint number, `built` whether the endpoint exists in a bridge, `errors`/`warnings` the static validator's counts |
|
|
49
|
+
| `GET /api/devices/:key` | `{key, device, issues: [{level, path, message}], built, bridge, number, state}` — `issues` are the static ones plus the running endpoint's conformance violations; `state` as below, or absent when not built |
|
|
50
|
+
| `PUT /api/devices/:key` | body: the device. Creates or replaces: the file is written, the old endpoint (if any) is removed, the new one built and wired without a restart — the endpoint number stays with the key. A device with validation errors is saved but not built. Answers like `GET` |
|
|
51
|
+
| `DELETE /api/devices/:key` | removes the device from the file and the bridge; `204` |
|
|
52
|
+
| `GET /api/devices/:key/state` | `{<endpointId>: {number, state: {<Cluster>: {<attribute>: value}}}}` — the live Matter state of every endpoint of the device; `404` when not built |
|
|
53
|
+
| `POST /api/validate` | body `{device}`; answers `{ok, issues}` from the schema and the static validator, nothing is saved |
|
|
54
|
+
| `POST /api/check` | body `{}` for the whole configuration or `{devices: {<key>: device}}`; runs the strict dry run of `mqtt2matter --check` (a throw-away node, no network) and answers `{ok, devices: {<key>: issues[]}}` — only devices with issues are listed |
|
|
55
|
+
|
|
56
|
+
## The mapping editor
|
|
57
|
+
|
|
58
|
+
| Route | Answer |
|
|
59
|
+
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
60
|
+
| `POST /api/preview` | `{direction: "status", half, payload, attribute?, topic?}` → the payload through the status half's steps; `{direction: "command", half, value, attribute?, fields?}` → the value through the command half's. Answers `{ok, stages: [{step, ok, value?, reason?}], result?, reason?}`; the stages are `extract`, `template`, `map`, `unit`, `scale`, `attribute` (status) and `value`, `scale`, `format`, `wrap`, `payload` (command), only those the half uses. `attribute` (`Cluster.attribute`) gives the attribute's shape (enum names, bitmaps) |
|
|
61
|
+
| `POST /api/publish` | `{topic, payload, retain?, qos?}` → publishes; `{published: true}` |
|
|
62
|
+
| `GET /api/topics` | `?prefix=` optional; `[{topic, payload, retain, ts}]` — the topic cache: every topic seen on the subscriptions (`server.topics` plus the mappings'), payloads cut at 16 kB, sorted |
|
|
63
|
+
|
|
64
|
+
## The catalogue
|
|
65
|
+
|
|
66
|
+
| Route | Answer |
|
|
67
|
+
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
68
|
+
| `GET /api/catalog` | `{deviceTypes: [{name, id, classification, clusters: [{cluster, mandatory, features}]}], clusters: [name…], composites: {"ColorControl.colorHs": {cluster, fields, features, description}, …}, units: [name…], eventChannels: ["Switch"]}` |
|
|
69
|
+
| `GET /api/catalog/clusters/:name` | `{name, id, features: [{code, title}], attributes: [{name, id, metatype, nullable, writable, enumMembers?, bitFields?, min?, max?, conformance}], commands: [{name, id, fields}], events: [name…]}` |
|
|
70
|
+
|
|
71
|
+
## Presets
|
|
72
|
+
|
|
73
|
+
| Route | Answer |
|
|
74
|
+
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
75
|
+
| `GET /api/presets` | `{presets: [{id, name, description, vendor, variables, shipped, file}], problems: [{file, message}]}` — the shipped presets and every `*.json` below the `presets` directories, read on each call |
|
|
76
|
+
| `POST /api/presets/:id/apply` | body `{values: {<variable>: "…"}}`; answers `{device, issues}` — the device the preset yields (`source.kind` `preset`), not saved: `PUT /api/devices/:key` saves it |
|
|
77
|
+
|
|
78
|
+
## Bridges
|
|
79
|
+
|
|
80
|
+
| Route | Answer |
|
|
81
|
+
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
82
|
+
| `GET /api/bridges` | `[{id, port, online, commissioned, pairingCodes: {manualPairingCode, qrPairingCode}, devices: n, fabrics: [{index, label, vendorId, nodeId, fabricId}], windowStatus}]` — `windowStatus` 0 closed, 1 enhanced window open, 2 basic window open |
|
|
83
|
+
| `POST /api/bridges/:id/commissioning` | `{open: true, minutes?}` opens a basic commissioning window with the bridge's passcode (≤ 15 minutes, the default); `{open: false}` closes it; answers the bridge |
|
|
84
|
+
| `DELETE /api/bridges/:id/fabrics/:index` | removes a fabric (the controller loses the bridge); `204` |
|
|
85
|
+
|
|
86
|
+
## Adopt
|
|
87
|
+
|
|
88
|
+
The importers ([importers.md](importers.md)) describe devices from a source; the server subscribes their topics
|
|
89
|
+
(`zigbee2mqtt/bridge/devices`, `…/groups`, `homeassistant/#`), hands them every message, and asks them for the report over the
|
|
90
|
+
devices as they stand in the file. The server moves results into the file and the running bridge; the logic —
|
|
91
|
+
baseline, the user's edits, conflicts, orphaning — is the importer's.
|
|
92
|
+
|
|
93
|
+
| Route | Answer |
|
|
94
|
+
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
95
|
+
| `GET /api/adopt` | `{importers: [kind…], entries: [SyncEntry…]}` — the importer's `diff` over the file's devices; each entry is `{importer, key, kind: "device" \| "group", name, status, conflicts: [{path, user, before, now, applied}], edits, unmapped, notes, area?, native?, covered?, twins?}` with `status` one of `new`, `unchanged`, `updated`, `restored`, `orphaned`, `invalid`, `unsupported`, `covered`; `area` is the source's suggested area, `native` the key of another importer's native description of the same device, `covered` what covers a `covered` entry, `twins` the configured devices for the same physical device |
|
|
96
|
+
| `POST /api/adopt/resync` | runs `adopt` with every importer over the file (`resync: true`, `orphan: true`, no new keys): updated and restored devices take the new baseline with the user's edits reapplied, missing ones are marked `source.orphaned`; every device that changed is written and rebuilt. Answers `{importers, entries, written: [key…]}` |
|
|
97
|
+
| `POST /api/adopt/:kind/:key` | body `{force?, replace?}`; adopts one entry: a `new` one is added, an `updated` or `restored` one re-synced; nothing else is touched (`orphan: false`). A `covered` one (the same device as another importer's, see importers.md) is `409` with `details: {covered, twins}` unless `force: true`; `replace: true` also disables its twins. `409` for an `unsupported` or `invalid` entry, `404` for an unknown one. Answers the device like `GET /api/devices/:key` plus `entry` |
|
|
98
|
+
|
|
99
|
+
An orphaned device is never removed by the bridge: removing it is `DELETE /api/devices/:key`.
|
|
100
|
+
|
|
101
|
+
## Import and export
|
|
102
|
+
|
|
103
|
+
| Route | Answer |
|
|
104
|
+
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
105
|
+
| `GET /api/export` | the configuration file as it is (`content-disposition: attachment`); `?device=<key>` gives `{<key>: device}` for one device |
|
|
106
|
+
| `POST /api/import` | `{devices: {<key>: device}}` or `{config: {devices: …}}`, with `replace: true` to drop every device not in the body; each device is validated first, then saved and built one by one; `{imported: n}` |
|
|
107
|
+
|
|
108
|
+
## Log
|
|
109
|
+
|
|
110
|
+
| Route | Answer |
|
|
111
|
+
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
|
112
|
+
| `GET /api/log` | `?limit=500&after=<id>`; `[{id, ts, level, scope, message}]`, oldest first — the last 2000 lines of the bridge's own log (not matter.js') |
|
|
113
|
+
|
|
114
|
+
## The event stream
|
|
115
|
+
|
|
116
|
+
`GET /api/events` upgrades to a WebSocket; every event is one JSON text frame. A client may send
|
|
117
|
+
`{"type": "subscribe", "mqtt": false}` to stop receiving MQTT events (and `true` to resume).
|
|
118
|
+
|
|
119
|
+
| Event | Fields | When |
|
|
120
|
+
| ------------ | ------------------------------------------ | -------------------------------------------------------------------- |
|
|
121
|
+
| `hello` | `version` | right after the connection |
|
|
122
|
+
| `mqtt` | `topic, payload, retain, ts` | every message on a subscribed topic (payload cut at 16 kB) |
|
|
123
|
+
| `attribute` | `key, endpoint, cluster, attribute, value` | an attribute of a device's endpoint changed (a status, a controller) |
|
|
124
|
+
| `log` | `entry: {id, ts, level, scope, message}` | a log line |
|
|
125
|
+
| `devices` | — | the device list changed (created, replaced, removed, imported) |
|
|
126
|
+
| `bridges` | — | commissioning state or fabrics changed, a window opened or closed |
|
|
127
|
+
| `discovered` | — | an importer's view of its source changed |
|
|
128
|
+
| `status` | `mqtt: boolean` | the broker connection came or went |
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Architecture
|
|
2
|
+
|
|
3
|
+
mqtt2matter is one package with internal module boundaries. The manual device model is the core;
|
|
4
|
+
everything else generates it (importers), renders it (UI) or runs it (engine, families, matter).
|
|
5
|
+
|
|
6
|
+
```
|
|
7
|
+
src/
|
|
8
|
+
config/ the configuration file and the environment: schema, loading, defaults
|
|
9
|
+
model/ the manual model — devices, endpoints, mappings, family options — the @matter/model catalogue,
|
|
10
|
+
the static validator, the preset format
|
|
11
|
+
engine/ the payload engine (pure functions over the model's halves: extract, template, map, unit, scale,
|
|
12
|
+
wrap …), the Jinja templates, the mapping runtime (availability, expire, get, coalescing)
|
|
13
|
+
families/ cluster semantics that live in code: the servers that route controller commands, the status
|
|
14
|
+
hooks (colour composites, the cover's movement, fan consistency, battery levels), switch events
|
|
15
|
+
mqtt/ the broker connection and the topic cache (last payload per topic)
|
|
16
|
+
matter/ the node manager (n ≥ 1 bridges), one bridge = ServerNode + aggregator, the model-driven endpoint
|
|
17
|
+
builder, the strict dry run, ids, the shard map
|
|
18
|
+
importers/ foreign descriptions → model devices: patch.ts (baseline + edits), sync.ts (the report, the
|
|
19
|
+
re-sync, orphaning — shared), actions.ts (press kinds — shared), z2m/ (zigbee2mqtt), ha/ (Home
|
|
20
|
+
Assistant MQTT discovery) — docs/importers.md
|
|
21
|
+
commands/ the command line's subcommands beyond start and --check (`--import-z2m`, `--install`)
|
|
22
|
+
server/ node:http + ws: the REST API and the event stream of docs/api.md, the config file as the UI
|
|
23
|
+
edits it (compact, atomic writes), the catalogue as JSON, the preview of a mapping's halves,
|
|
24
|
+
the importers as the server runs them, the built UI as static files
|
|
25
|
+
app.ts wiring and lifecycle; devices are added and removed while it runs
|
|
26
|
+
main.ts the command line entry (`--check` is the dry run)
|
|
27
|
+
log.ts the leveled, scoped logger
|
|
28
|
+
ui/ the Svelte 5 app (Vite, TypeScript strict, svelte-check): built into ui/dist, served by
|
|
29
|
+
src/server; it talks to the server through docs/api.md only
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Data flow
|
|
33
|
+
|
|
34
|
+
MQTT message → `mqtt/` (cache) → `engine/runtime` finds the mappings on that topic → `engine/payload`
|
|
35
|
+
decodes (extract, template, map, type, unit, scale, offset, invert, round, then the attribute's shape from the
|
|
36
|
+
model: enum names, bitmap fields, integers) → the endpoint handle in `matter/` hands the value to the
|
|
37
|
+
cluster's family (a composite, a state machine) or sets the attribute.
|
|
38
|
+
|
|
39
|
+
Controller command → the family server in `families/` (e.g. `LevelControlServer.moveToLevelLogic`) →
|
|
40
|
+
`route()` finds the handler the runtime registered for the key → `engine/payload` encodes (numeric steps
|
|
41
|
+
inverted, format, template, wrap) → `mqtt/` publishes (coalesced per topic when the endpoint asks) → the family
|
|
42
|
+
applies the value locally only when the mapping is optimistic (its default without a status half, or without
|
|
43
|
+
a related one); otherwise the device's status report sets it.
|
|
44
|
+
|
|
45
|
+
Controller write of a writable attribute → matter.js applies it → the endpoint handle's observer sees the
|
|
46
|
+
change with an online context → the same handler publishes it → the family keeps the cluster consistent (a
|
|
47
|
+
fan's mode from its percent).
|
|
48
|
+
|
|
49
|
+
## Dependency rules
|
|
50
|
+
|
|
51
|
+
Enforced by `no-restricted-imports` in `eslint.config.js` per folder:
|
|
52
|
+
|
|
53
|
+
- `importers/` depend on `model/` and `mqtt/` only — never on `matter/`, `families/`, `engine/`, `config/`,
|
|
54
|
+
`server/`. An importer writes `config.devices` entries with `source` metadata; the runtime does not know
|
|
55
|
+
where a device came from. `commands/` wires an importer to the configuration file and the broker for the
|
|
56
|
+
command line; the server does the same for the UI.
|
|
57
|
+
- `families/` depend on `engine/` outputs, `model/` and matter.js — never on an importer, config loading,
|
|
58
|
+
`mqtt/` or the server.
|
|
59
|
+
- `engine/` and `model/` are pure: no matter.js node, no MQTT, no files. They use `@matter/model` (the data
|
|
60
|
+
model) for lookups; the model's catalogue is the only place that reads it.
|
|
61
|
+
- `mqtt/` knows nothing above it.
|
|
62
|
+
- `server/` may use everything below it; `ui/` (outside `src/`, its own tsconfig, type-checked by svelte-check)
|
|
63
|
+
talks to `server/` through the documented REST/WS contract only — nothing from `src/` is imported there.
|
|
64
|
+
|
|
65
|
+
## The model-driven endpoint
|
|
66
|
+
|
|
67
|
+
`matter/device-types.ts` builds an endpoint type from matter.js' own device definitions (every `*Device` it
|
|
68
|
+
ships, plus the utility `PowerSource`) and `@matter/model`: the first device type is the endpoint's type, the
|
|
69
|
+
others go into the Descriptor's device type list with their mandatory clusters; the clusters are the device
|
|
70
|
+
types' mandatory ones, the optional ones a mapping or the config names, and any other cluster a mapping names;
|
|
71
|
+
each cluster's server is the family's class (it routes commands) with the device type's alterations re-applied
|
|
72
|
+
(read off the requirement's schema: `remainingTime` mandatory on colour lights, `currentLevel` 1–254 on
|
|
73
|
+
dimmable ones), else matter.js' default; the features are the union of what the device type requires, what
|
|
74
|
+
the mappings imply and what the config asks for. `matter/cluster-defaults.ts` holds the few mandatory
|
|
75
|
+
attributes the model gives no default for. There is no table of device types.
|
|
76
|
+
|
|
77
|
+
## Validation
|
|
78
|
+
|
|
79
|
+
Two layers: `model/validate.ts` checks a device statically against the model — device types,
|
|
80
|
+
clusters, attributes, features, conformance under the endpoint's features, map and format values against the
|
|
81
|
+
attribute's shape, templates — and the app refuses to build a device with errors; `matter/check.ts` builds every
|
|
82
|
+
device in a throw-away `ServerNode` of its own `Environment` with `endpoint.validation=strict` and memory
|
|
83
|
+
storage, never online, and reports what matter.js refuses plus the `DeviceTypeConformanceService`'s violations
|
|
84
|
+
(`mqtt2matter --check`). Production runs matter.js' `warn` mode and logs each endpoint's violations once.
|
|
85
|
+
|
|
86
|
+
## Identity and persistence
|
|
87
|
+
|
|
88
|
+
- A device's key in `config.devices` is its Matter endpoint id. matter.js persists endpoint numbers per id,
|
|
89
|
+
so numbers survive restarts and config edits as long as the key stays. Renaming a device changes `name`,
|
|
90
|
+
never the key.
|
|
91
|
+
- Child endpoints are `<key>~<endpoint id>`, parts of the device's endpoint.
|
|
92
|
+
- `BridgedDeviceBasicInformation.uniqueId` is a hash of the bridge id and the device key.
|
|
93
|
+
- Each bridge is a `ServerNode` with its own id, storage directory (under `storage`), port, passcode and
|
|
94
|
+
discriminator; the mDNS service is shared process-wide. Passcode and discriminator are random on the
|
|
95
|
+
first start unless configured, and persisted in `storage/commissioning.json` (matter.js keeps none), so
|
|
96
|
+
the pairing code survives restarts.
|
|
97
|
+
- `storage/shards.json` maps device keys to bridge ids: written once, never rebalanced. 1.0 runs one
|
|
98
|
+
bridge; the map exists so the multi-bridge split (1.1) moves no device between nodes.
|
|
99
|
+
|
|
100
|
+
## A rule learned the hard way
|
|
101
|
+
|
|
102
|
+
matter.js does not await every hook it calls: `WindowCoveringServer.handleMovement` and `handleStopMovement`
|
|
103
|
+
are workers; the command's transaction commits while they run. A behavior that writes `this.state` after an
|
|
104
|
+
`await` in such a hook hits a committed transaction, and that error is fatal for the whole node. Family code
|
|
105
|
+
writes through `endpoint.set()` (a transaction of its own) after any `await` in a hook it does not know to be
|
|
106
|
+
awaited; `lock()` + `this.state` is only for the hooks matter.js awaits (`on`/`off`, `moveToLevelLogic`, the
|
|
107
|
+
colour logic, `lockDoor`).
|
|
108
|
+
|
|
109
|
+
## Testing
|
|
110
|
+
|
|
111
|
+
- Unit tests over the pure parts (engine steps, templates, units, the runtime with fakes, the validator,
|
|
112
|
+
presets, the endpoint builder, config, topic cache, shard map) with vitest.
|
|
113
|
+
- `test/check.test.ts` runs the strict dry run; `test/e2e.test.ts` and `test/families.e2e.test.ts` start an
|
|
114
|
+
in-process aedes broker on an ephemeral port and a real matter.js `ServerNode` on a free UDP port, drive it
|
|
115
|
+
through the node's own interaction API (`endpoint.act`) and, for attribute writes, emit the attribute's change
|
|
116
|
+
with an online context. Nothing binds a fixed port.
|
|
117
|
+
- `test/server.test.ts` runs the whole API against the real application (broker, node, the config file in a
|
|
118
|
+
temporary directory, the zigbee2mqtt importer with the test corpus); `ui/test/e2e/` are the Playwright
|
|
119
|
+
tests of the UI, against the same stack started by `ui/test/serve.ts` on an ephemeral port (the global
|
|
120
|
+
setup starts it and hands the address to the tests). The UI's own unit tests (`ui/src/**/*.test.ts`, run
|
|
121
|
+
with `ui/vitest.config.ts`) check among other things that every string has both languages.
|