Release Candidate 1.2.0

.github/workflows/publish-dev.yml

@@ -1,35 +1,36 @@
 name: Publish DEV
 
 on:
-  release:
-    types: [published]
+  push:
+    branches:
+      - dev
 
 jobs:
   test:
-    if: "github.event.release.prerelease"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20.x
+          cache: npm
       - run: | 
-          npm install
+          npm i
           npm run build
           npm run test
 
   build-publish:
-    if: "github.event.release.prerelease"
     needs: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20.x
+          cache: npm
           registry-url: https://registry.npmjs.org/
-      - run: | 
-          npm install
+      - run: |
+          npm i
           npm run build
           npm publish --access public --tag dev
         env:

.github/workflows/publish.yml

@@ -9,10 +9,11 @@ jobs:
     if: "!github.event.release.prerelease"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20.x
+          cache: npm
       - run: | 
           npm install
           npm run build
@@ -23,10 +24,11 @@ jobs:
     needs: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20.x
+          cache: npm
           registry-url: https://registry.npmjs.org/
       - run: | 
           npm install

.gitignore

@@ -173,9 +173,6 @@ typings/
 # Optional npm cache directory
 .npm
 
-# Optional eslint cache
-.eslintcache
-
 # Optional REPL history
 .node_repl_history
 
@@ -310,4 +307,5 @@ $RECYCLE.BIN/
 .vscode
 
 build/**/*.js
+build/**/*.d.ts
 .npm-upgrade.json

README.md

@@ -2,33 +2,49 @@
 
 <img width="770" alt="image" src="https://user-images.githubusercontent.com/38265886/125874556-df4a9d8e-11da-4a18-a11a-c12717afe11e.png">
 
-### * What is this contrib? Why is it different?
-This project will give access to all known UniFi http and websocket API endpoints. It is specifically focused on **UniFI OS** consoles, it is not expected to work with older UniFi hardware. The data (tons of it) is passed into Node-RED as JSON data from the HTTP request and WebSocket connection nodes. The internals assist with login cookies and credentials handling. All data from the API is sent on to the user.
+###   * What is this contrib? Why is it different?
+
+This project will give access to all known UniFi http and websocket API endpoints. It is specifically focused on **UniFI
+OS** consoles, it is not expected to work with older UniFi hardware. The data (tons of it) is passed into Node-RED as
+JSON data from the HTTP request and WebSocket connection nodes. The internals help with login cookies and credentials
+handling. All data from the API is sent on to the user.
 
 Be warned, it is a lot of data. It will be up to the user to build filters and find the JSON data they are looking for.
 
-### * Current Status
+###   * Current Status
+
 Updated July 15, 2021.
 
-Currently, we have what appears to be a fully functioning setup. We are still looking for errors and bugs from more edge case testing, please report if you find something.
+Currently, we have what appears to be a fully functioning setup. We are still looking for errors and bugs from more edge
+case testing, please report if you find something.
+
+The HTTP endpoints [listed here](https://ubntwiki.com/products/software/UniFi-controller/api) should all be working
+properly. GET, POST, and PUT requests should all be functioning and able to pass commands from Node-RED into the UniFi
+API.
 
-The HTTP endpoints [listed here](https://ubntwiki.com/products/software/UniFi-controller/api) should all be working properly. GET, POST, and PUT requests should all be functioning and able to pass commands from Node-RED into the UniFi API.
+The WebSocket endpoints are fully functional as well, including push updates from UniFi OS, the Network app, and the
+Protect app. We have not tested Talk or Access apps - simply because none of us have that hardware, should work fine
+though.
 
-The WebSocket endpoints are fully functional as well, including push updates from UniFi OS, the Network app, and the Protect app. We have not tested Talk or Access apps - simply because none of us have that hardware, should work fine though.
+###   * Initial Setup
 
-### * Initial Setup
+It is recommended that you create a local admin on your UniFi OS console. This will enable simple login (not 2FA) and
+allow a local connection between your Node-RED instance and your UniFi console. To add a local user, go
+to your UniFi console's user management screen and add a new user, selecting "Local Access" under Account Type.
 
-It is recommended that you create a local admin on your UniFi OS console. This will enable simple login (not 2FA) and allow a local connection between your Node-RED instance and your UniFi console. In order to add a local user, simply go to your UniFi console's user management screen and add a new user, selecting "Local Access" under Account Type.
+As you place your first UniFi node, you will need to create a new config node. This is where you will put your UniFi
+Console IP address, username, and password. No further work is required to log into your console.
 
-As you place your first UniFi node, you will need to create a new config node. This is where you will put your UniFi Console IP address, username, and password. No further work is required to log into your console.
+###   * How to Use HTTP Request Node
 
-### * How to Use HTTP Request Node
+HTTP request nodes can do all the things [listed here](https://ubntwiki.com/products/software/UniFi-controller/api).
 
-HTTP request nodes can do all the things [listed here](https://ubntwiki.com/products/software/UniFi-controller/api). 
+The configuration may be set either by typing into the node's setup fields or by sending payloads including
+`msg.payload.endpoint`, `msg.payload.method`, and `msg.payload.data`.
 
-The configuration may be set either by typing into the node's setup fields or by sending payloads including `msg.payload.endpoint`, `msg.payload.method`, and `msg.payload.data`.
+The format of these nodes is a bit different from the list linked above. Here is a very incomplete list of tested
+endpoints to get started with:
 
-The format of these nodes is a bit different from the list linked above. Here is a very incomplete list of tested endpoints to get started with:
 ```
 /proxy/network/api/s/default/stat/health
 /proxy/protect/api/bootstrap
@@ -37,43 +53,57 @@ The format of these nodes is a bit different from the list linked above. Here is
 /proxy/network/api/s/default/cmd/stat
 ```
 
-Here is an example payload which maybe sent if you would like to send data (POST) to the UniFi Console. This example will reset the DPI counters on your system. **DATA WILL BE REMOVED FROM YOUR UNIFI CONSOLE WHEN SENDING THIS MESSAGE**
+Here is an example payload which maybe sent if you would like to send data (POST) to the UniFi Console. This example
+will reset the DPI counters on your system. **DATA WILL BE REMOVED FROM YOUR UNIFI CONSOLE WHEN SENDING THIS MESSAGE**
+
 ```json
 {
   "payload": {
     "endpoint": "/proxy/network/api/s/default/cmd/stat",
     "method": "POST",
-    "data": {"cmd":"reset-dpi"}
+    "data": {
+      "cmd": "reset-dpi"
+    }
   }
 }
 ```
 
-Please use [this excellent list](https://ubntwiki.com/products/software/UniFi-controller/api) to learn all the fun things you might like to send to the HTTP node.
+Please use [this excellent list](https://ubntwiki.com/products/software/UniFi-controller/api) to learn all the fun
+things you might like to send to the HTTP node.
 
-### * How to Use WebSocket Node
+###   * How to Use WebSocket Node
 
-The UniFi Consoles are *very talkative*. The websocket nodes are easy to set up, simply put the endpoint into the setup field and deploy. Then watch the data flow.
+The UniFi Consoles are *very talkative*. The websocket nodes are straightforward to set up, simply put the endpoint into the setup
+field and deploy. Then watch the data flow.
 
 Here is a short list of known WebSocket endpoints, please create an issue or share on Discord if you know of more
+
 ```
 /proxy/network/wss/s/default/events
 /api/ws/system
 /proxy/protect/ws/updates?[QUERY-STRING]
 ```
 
-That last one is special. It needs a query string from the bootstrap HTTP endpoint. But it's also the most important part of this node. When set up properly it will provide real-time UniFi Protect data into your Node-RED flows. This includes motion detection, doorbell buttons, and smart detections. See the following section for more about this setup.
+That last one is special. It needs a query string from the bootstrap HTTP endpoint. But it's also the most important
+part of this node. When set up properly, it will provide real-time UniFi Protect data into your Node-RED flows. This
+includes motion detection, doorbell buttons, and smart detections. See the following section for more about this setup.
 
-### * Real-Time UniFi Protect API Connection
+###   * Real-Time UniFi Protect API Connection
 
 This connection is a two-part setup.
 
-- Step 1: obtain a `bootstrap` payload from the HTTP node. This will come from the endpoint `/proxy/protect/api/bootstrap`. The response from `bootstrap` should have a part called `msg.payload.lastUpdateId` - that is what you will need for the next piece.
-- Step 2: connect to a WebSocket endpoint using the `lastUpdateId` obtained in (Step 1) `/proxy/protect/ws/updates?lastUpdateId=${msg.payload.lastUpdateId}`. This websocket will pump out live unifi protect payloads.
+- Step 1: obtain a `bootstrap` payload from the HTTP node. This will come from the endpoint
+  `/proxy/protect/api/bootstrap`. The response from `bootstrap` should have a part called `msg.payload.lastUpdateId` -
+  that is what you will need for the next piece.
+- Step 2: connect to a WebSocket endpoint using the `lastUpdateId` obtained in (Step 1)
+  `/proxy/protect/ws/updates?lastUpdateId=${msg.payload.lastUpdateId}`. This websocket will pump out live unifi protect
+  payloads.
 
 Here is a screenshot of how this looks in practice:
 <img width="962" alt="image" src="https://user-images.githubusercontent.com/38265886/125873952-4b956296-f4fb-4547-ac62-ab382ae21da9.png">
 
 The function node is quite simple, it looks like this inside:
+
 ```js
 if ("lastUpdateId" in msg.payload) {
     return {
@@ -84,11 +114,15 @@ if ("lastUpdateId" in msg.payload) {
 }
 ```
 
-Re-authentication *may* be needed after some time. The second output on your WebSocket node will provide any errors due to this connection. Readme will be updated soon (soon after July 15, 2021) with some options for using these errors in re-connect.
+Re-authentication *may* be needed after some time. The second output on your WebSocket node will provide any errors due
+to this connection. Readme will be updated soon (soon after July 15, 2021) with some options for using these errors in
+re-connecting.
 
 ### Problems, Testing, and Development
 
-If you have questions, problems, or suggestions please open a topic [here](https://github.com/NRCHKB/node-red-contrib-unifi-os/discussions). Note this is a very new node with limited testing. Please, please open an issue or discussion if you find any problems.
+If you have questions, problems, or suggestions please open a
+topic [here](https://github.com/NRCHKB/node-red-contrib-unifi-os/discussions). Note this is a very new node with limited
+testing. Please, please open an issue or discussion if you find any problems.
 Thanks!
 
 Additionally, please find us at the `#unifi` channel at our [Discord server](https://discord.gg/RCH3g22YCg)

biome.json

@@ -0,0 +1,74 @@
+{
+    "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
+    "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+    "files": { "ignoreUnknown": false },
+    "formatter": {
+        "enabled": true,
+        "formatWithErrors": false,
+        "indentStyle": "space",
+        "indentWidth": 4,
+        "lineEnding": "lf",
+        "lineWidth": 80,
+        "attributePosition": "auto",
+        "bracketSameLine": false,
+        "bracketSpacing": true,
+        "expand": "auto",
+        "useEditorconfig": true
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "recommended": false,
+            "complexity": {
+                "noBannedTypes": "error",
+                "noUselessTypeConstraint": "error"
+            },
+            "correctness": {
+                "noPrecisionLoss": "error",
+                "noUnusedVariables": "error"
+            },
+            "style": {
+                "noInferrableTypes": "error",
+                "noNamespace": "error",
+                "noNonNullAssertion": "warn",
+                "useArrayLiterals": "error",
+                "useAsConstAssertion": "error",
+                "useBlockStatements": "off"
+            },
+            "suspicious": {
+                "noEmptyBlockStatements": "error",
+                "noExplicitAny": "off",
+                "noExtraNonNullAssertion": "error",
+                "noMisleadingInstantiator": "error",
+                "noNonNullAssertedOptionalChain": "error",
+                "noPrototypeBuiltins": "off",
+                "useAdjacentOverloadSignatures": "error",
+                "useNamespaceKeyword": "error"
+            }
+        }
+    },
+    "javascript": {
+        "formatter": {
+            "jsxQuoteStyle": "double",
+            "quoteProperties": "asNeeded",
+            "trailingCommas": "es5",
+            "semicolons": "asNeeded",
+            "arrowParentheses": "always",
+            "bracketSameLine": false,
+            "quoteStyle": "single",
+            "attributePosition": "auto",
+            "bracketSpacing": true
+        },
+        "globals": ["SharedArrayBuffer", "Atomics"]
+    },
+    "html": {
+        "formatter": {
+            "indentScriptAndStyle": false,
+            "selfCloseVoidElements": "always"
+        }
+    },
+    "assist": {
+        "enabled": true,
+        "actions": { "source": { "organizeImports": "on" } }
+    }
+}