node-red-contrib-padavan 1.0.1 → 2.0.0

package/README.md

@@ -1,265 +1,88 @@
-Router management with Padavan firmware
+# node-red-contrib-padavan
 
+[[RU]](./docs/ru/README.md) | [EN]
 
-## Install
+A set of [Node-RED](https://nodered.org/) nodes for managing routers running
+**Padavan** firmware.
 
-``` shell
-npm install node-red-contrib-padavan
-```
-
-
-## Nodes
-
-- [Configuration](#configuration)
-- [SpeedTest](#speedtest)
-- [Devices](#devices)
-- [History](#history)
-- [Updates](#updates)
-- [Status](#status)
-- [Parameters](#parameters)
-
-
-
-## Configuration
-
-### Input
-
-| credentials   | Description
-| ---           | ---
-| *`repo`*      | Repository where firmware builds are hosted
-| *`branch`*    | Branch for the device
-| *`token`*     | Access token for GitHub
-| `host`        | Router IP address
-| `username`    | Username for router access
-| `password`    | Password for router access
-
-
-## SpeedTest
-
-Measure download and upload speeds
-
-
-### Output
-
-| outputs       | Description
-| ---           | ---
-| `result`      | Result
-| `history`     | Result with date and timestamp
-| `progress`    | Test start and end
-
-
-| result.msg    | type      | Value
-| ---           | ---       | ---
-| `topic`       | string    | NetworkControl
-| `payload`     | object    |
-
-
-| payload                   | Description
-| ---                       | ---
-| `networkDownloadSpeedMbps`| Download speed
-| `networkUploadSpeedMbps`  | Upload speed
-
-
-## Devices
-
-Get the list of connected devices
-
-
-### Output
-
-| msg                   | type
-| ---                   | ---
-| `payload`             | array
-| `numConnectedDevices` | integer
-
-
-| payload       |
-| ---           |
-| `hostname`    |
-| `ip`          |
-| `mac`         |
-| `rssi`        |
-
-
-## History
-
-Retrieve traffic history
-
-
-### Output
-
-| msg               | type
-| ---               | ---
-| `payload`         | object
-| `networkUsage`    | string
-| `networkUsageMB`  | integer
+This package uses the `padavan` library to interact with the router via its
+web interface (HTTP). It provides tools for monitoring, configuration,
+diagnostics, and firmware management.
 
+## Features
 
-| payload           | type  | Description
-| ---               | ---   | ---
-| `daily_history`   | array | Daily
-| `monthly_history` | array | Monthly
+- **Full Control**: Manage NVRAM settings, services, and power state via
+  HTTP.
+- **Monitoring**: Get real-time traffic history (daily/monthly) and system
+  status (CPU/RAM/Uptime).
+- **Device Tracking**: Retrieve connected clients with smart filtering for
+  "ghost" connections (ARP caching).
+- **Diagnostics**: Built-in Wi-Fi Scanner and **"Wi-Fi Doctor"** for
+  analyzing interference and finding the best channel.
+- **Firmware Management**: Check for updates, trigger builds in GitHub
+  Actions, and flash the router directly from Node-RED.
 
+## Installation
 
-| \*\_history   | Description
-| ---           | ---
-| `0`           | Year, month, day
-| `1`           | Download
-| `2`           | Upload
-
-
-## Updates
-
-Manage firmware updates
-
-
-### Input
-
-| msg       | type
-| ---       | ---
-| `topic`   | string
-
-
-| topic         | Description
-| ---           | ---
-| *`build`*     | Build firmware
-| *`changelog`* | List of changes
-| *`upgrade`*   | Install firmware
-
-
-### Output
-
-| msg       | type      | Value
-| ---       | ---       | ---
-| `topic`   | string    | changelog
-| `error`   | string    |
-| `payload` | object    |
-
-
-| payload   | Description
-| ---       | ---
-| `from_id` | Current firmware
-| `to_id`   | Built firmware
-| `data`    | Array of changes
-
-
-## Status
-
-Retrieve and manage router status
-
-
-### Input
-
-| msg       | type
-| ---       | ---
-| `topic`   | string
-
-
-| topic         | Description
-| ---           | ---
-| *`status`*    | Get current status
-| *`log`*       | Get logs
-| *`reboot`*    | Reboot
-
-
-### Output
-
-| msg       | type      | Value
-| ---       | ---       | ---
-| `topic`   | string    | status
-| `payload` | object    |
-
-
-| payload   | Description
-| ---       | ---
-| `lavg`    | System load average over the last 1, 5, and 15 minutes
-| `uptime`  | Router uptime
-| `ram`     | RAM usage information
-| `swap`    | Swap memory status
-| `cpu`     | CPU load information
-| `wifi2`   | Wi-Fi status on the 2.4 GHz band
-| `wifi5`   | Wi-Fi status on the 5 GHz band
-| `logmt`   | Timestamp of the last log modification
-
-
-| uptime    |
-| ---       |
-| `days`    |
-| `hours`   |
-| `minutes` |
-
-
-| ram       | Description
-| ---       | ---
-| `total`   | Total RAM (in KB)
-| `used`    | Used RAM
-| `free`    | Free RAM
-| `buffers` | RAM used for buffers
-| `cached`  | RAM used for cache
-
-
-| swap      |
-| ---       |
-| `total`   |
-| `used`    |
-| `free`    |
+Install via the Node-RED Manage Palette or run the following command in your
+Node-RED user directory:
 
+```bash
+npm install node-red-contrib-padavan
+```
 
-| cpu       | Description
-| ---       | ---
-| `busy`    | Total time the CPU has been busy
-| `user`    | Time spent on user processes
-| `nice`    | Time spent on processes with modified priority
-| `system`  | Time spent on system processes
-| `idle`    | Idle time when the CPU was not busy
-| `iowait`  | Time spent waiting for I/O operations
-| `irq`     | Time spent on hardware interrupt handling
-| `sirq`    | Time spent on software interrupt handling
-| `total`   | Total units of time since the system started
+## Nodes
 
+### ⚙️ Configuration (`padavan-config`)
 
-| wifi\*    | Description
-| ---       | ---
-| `state`   | Network state
-| `guest`   | Guest network state
+Configures the connection to the router (IP, Login, Password) and optionally
+to GitHub (for firmware updates). Supports secure credential storage.
 
+### 🖥️ System (`padavan-system`)
 
-## Parameters
+Performs system operations and diagnostics.
 
-Retrieve and modify parameters
+- **Get Status**: CPU load, RAM usage, Uptime.
+- **Get Log**: Fetch system logs.
+- **Reboot**: Restart the router.
+- **Scan Wi-Fi**: Perform a Site Survey (2.4GHz / 5GHz).
+- **Wi-Fi Doctor**: Analyze the environment and recommend the optimal channel.
 
+### 📱 Devices (`padavan-devices`)
 
-### Input
+Lists connected clients.
 
-| msg           | type
-| ---           | ---
-| *`payload`*   | object
-| `topic`       | string
+- Returns IP, MAC, Hostname, Connection Type, and RSSI.
+- Calculates changes (added/removed/changed devices) since the last check.
+- Filters out temporary Ethernet "ghosts" when devices switch from Wi-Fi.
 
+### 📊 History (`padavan-history`)
 
-| topic     | Description
-| ---       | ---
-| *`list`*  | Retrieve all parameters
-| *`get`*   | Retrieve specific parameters
-| *`set`*   | Modify parameters
+Retrieves traffic usage statistics.
 
+- Prioritizes **Monthly** stats for billing cycles.
+- Falls back to **Daily** stats if monthly data is missing.
+- Provides pre-calculated `networkUsageMB` for easy integration with voice
+  assistants (e.g., Google Home).
 
-| payload           |
-| ---               |
-| *`sid_list`*      |
-| *`action_mode`*   |
+### 🔧 Params (`padavan-params`)
 
+Low-level access to router settings (NVRAM).
 
-### Output
+- **List**: Dump all NVRAM variables.
+- **Get**: Read specific variables.
+- **Set**: Change variables with support for `sid_list` (service restart) and
+  custom action modes.
 
-| msg       | type
-| ---       | ---
-| `topic`   | string
-| `payload` | object
+### ☁️ Upgrade (`padavan-upgrade`)
 
+Manages the firmware lifecycle via GitHub Actions.
 
-### Details
+- **Check Updates**: Compare current version with the latest artifact.
+- **Build**: Trigger a new build workflow in your repository.
+- **Flash**: Download the artifact and upgrade the router.
 
-If `sid_list` is specified, changes will be sent via the web panel.
+## Migration
 
-If `action_mode` is not specified, it will be sent as ` Apply `.
+Upgrading from v1? Check the [Migration Guide](../../docs/MIGRATION.md) for
+details on breaking changes and removed features (like SpeedTest).

package/dist/nodes/config.html

@@ -0,0 +1,44 @@
+<script type="text/javascript">
+var RED=window.RED;function onchangerepo(event){let regexp=/https:\/\/github\.com\/?([^\/]+\/[^\/]+)(?:\/tree\/(.+))?/,[repo,branch]=event.target.value.match(regexp)?.slice(1)||[];if(repo)$("#node-config-input-repo").val(repo);if(branch)$("#node-config-input-branch").val(branch)}RED.nodes.registerType("padavan-config",{category:"config",defaults:{name:{value:""},host:{value:""},repo:{value:""},branch:{value:""},debug:{value:!1}},credentials:{username:{type:"text"},password:{type:"password"},token:{type:"password"}},label:function(){return this.name||this.host||"Padavan"},oneditprepare:function(){$("#node-config-input-repo").on("change",onchangerepo)}});
+</script>
+
+<script type="text/html" data-template-name="padavan-config">
+<div class="form-row">
+	<label for="node-config-input-name"><i class="fa fa-tag"></i> <span data-i18n="config.label.name"></span></label>
+	<input type="text" id="node-config-input-name" data-i18n="[placeholder]config.placeholder.name">
+</div>
+<div class="form-row">
+	<label style="width:auto" for="node-config-input-debug"><i class="fa fa-bug"></i> <span data-i18n="config.label.debug"></span></label>
+	<input type="checkbox" id="node-config-input-debug" style="display:inline-block; width:auto; vertical-align:top;" />
+</div>
+<fieldset>
+	<legend data-i18n="config.label.router"></legend>
+	<div class="form-row">
+		<label for="node-config-input-host"><i class="fa fa-globe"></i> <span data-i18n="config.label.host"></span></label>
+		<input type="text" id="node-config-input-host" data-i18n="[placeholder]config.placeholder.host">
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-username"><i class="fa fa-user"></i> <span data-i18n="config.label.username"></span></label>
+		<input type="text" id="node-config-input-username">
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-password"><i class="fa fa-key"></i> <span data-i18n="config.label.password"></span></label>
+		<input type="password" id="node-config-input-password">
+	</div>
+</fieldset>
+<fieldset>
+	<legend data-i18n="config.label.github"></legend>
+	<div class="form-row">
+		<label for="node-config-input-repo"><i class="fa fa-github"></i> <span data-i18n="config.label.repo"></span></label>
+		<input type="text" id="node-config-input-repo" data-i18n="[placeholder]config.placeholder.repo">
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-branch"><i class="fa fa-code-fork"></i> <span data-i18n="config.label.branch"></span></label>
+		<input type="text" id="node-config-input-branch" data-i18n="[placeholder]config.placeholder.branch">
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-token"><i class="fa fa-key"></i> <span data-i18n="config.label.token"></span></label>
+		<input type="password" id="node-config-input-token">
+	</div>
+</fieldset>
+</script>

package/dist/nodes/config.js

@@ -0,0 +1 @@
+import x from"padavan";class w{#j;#q;#k;constructor(j,k){this.#j=j,this.#q=k,this.#j.on("close",this.#w.bind(this))}get client(){if(!this.#k)this.#k=new x({credentials:{...this.#q,...this.#j.credentials},logLevel:this.#q.debug?"debug":"none"});return this.#k}async#w(j,k){this.#j.debug(`Closing config node ${this.#j.id} (removed: ${!!j})`),this.#k=null,k()}}function z(j){j.nodes.registerType("padavan-config",function(k){j.nodes.createNode(this,k);let q=this;q.instance=new w(q,k)},{credentials:{username:{type:"text"},password:{type:"password"},token:{type:"password"}}})}export{z as default,w as ConfigNode};

package/dist/nodes/devices.html

@@ -0,0 +1,14 @@
+<script type="text/javascript">
+var RED=window.RED;RED.nodes.registerType("padavan-devices",{category:"Padavan",defaults:{settings:{value:"",type:"padavan-config",required:!0},name:{value:""}},icon:"font-awesome/fa-list-ul",inputs:1,outputs:1,color:"#49AFCD",paletteLabel:"Devices",label:function(){return this.name||"Devices"}});
+</script>
+
+<script type="text/html" data-template-name="padavan-devices">
+<div class="form-row">
+	<label for="node-input-settings"><i class="fa fa-cog"></i> <span data-i18n="devices.label.settings"></span></label>
+	<input id="node-input-settings" />
+</div>
+<div class="form-row">
+	<label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="devices.label.name"></span></label>
+	<input type="text" id="node-input-name" data-i18n="[placeholder]devices.placeholder.name" />
+</div>
+</script>

package/dist/nodes/devices.js

@@ -0,0 +1 @@
+class J{#b;#k;#j=new Map;constructor(j,q,l){this.#b=j;let x=l.nodes.getNode(q.settings);if(x)this.#k=x.instance;else this.#b.warn("Config node not found or configured.");this.#b.on("input",this.#l.bind(this)),this.#b.on("close",()=>this.#j.clear())}get client(){if(!this.#k)throw Error("Client is not initialized. Check configuration.");return this.#k.client}async#l(j,q,l){try{this.#b.status({fill:"blue",shape:"dot",text:"Fetching..."});let x=await this.client.getDevices(),z=new Map,B=[],F=[],G=x.map((b)=>{let k=this.#j.get(b.mac);if(k&&b.type==="eth"&&["wifi","2.4GHz","5GHz"].includes(k.type))b.type=k.type;if(z.set(b.mac,b),!k)B.push(b);else if(k.ip!==b.ip||k.type!==b.type||k.hostname!==b.hostname)F.push(b);return b}),H=[];for(let[b,k]of this.#j)if(!z.has(b))H.push(k);this.#j=z,j.payload=G,j.numConnectedDevices=G.length,j.changes={added:B,removed:H,changed:F,hasChanges:B.length>0||H.length>0||F.length>0},this.#b.status({fill:"green",shape:"dot",text:`Found: ${G.length}`}),q(j),l()}catch(x){this.#b.status({fill:"red",shape:"ring",text:"Error"}),l(x)}}}function K(j){j.nodes.registerType("padavan-devices",function(q){j.nodes.createNode(this,q);let l=this;l.instance=new J(l,q,j)})}export{K as default,J as DevicesNode};

package/dist/nodes/history.html

@@ -0,0 +1,14 @@
+<script type="text/javascript">
+var RED=window.RED;RED.nodes.registerType("padavan-history",{category:"Padavan",defaults:{settings:{value:"",type:"padavan-config",required:!0},name:{value:""}},icon:"font-awesome/fa-history",inputs:1,outputs:1,color:"#49AFCD",paletteLabel:"History",label:function(){return this.name||"History"}});
+</script>
+
+<script type="text/html" data-template-name="padavan-history">
+<div class="form-row">
+	<label for="node-input-settings"><i class="fa fa-cog"></i> <span data-i18n="history.label.settings"></span></label>
+	<input id="node-input-settings" />
+</div>
+<div class="form-row">
+	<label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="history.label.name"></span></label>
+	<input type="text" id="node-input-name" data-i18n="[placeholder]history.placeholder.name" />
+</div>
+</script>

package/dist/nodes/history.js

@@ -0,0 +1 @@
+import{formatBytes as Q}from"padavan/utils/formatting.js";class M{#k;#q;constructor(q,z,w){this.#k=q;let k=w.nodes.getNode(z.settings);if(k)this.#q=k.instance;else this.#k.warn("Config node not found or configured.");this.#k.on("input",this.#w.bind(this))}get client(){if(!this.#q)throw Error("Client is not initialized. Check configuration.");return this.#q.client}async#w(q,z,w){if(!this.#q){w(Error("Config node not configured"));return}try{this.#k.status({fill:"blue",shape:"dot",text:"Fetching..."});let k=await this.client.getHistory(),F=null,G="No data";if(k.monthly&&k.monthly.length>0)F=k.monthly[k.monthly.length-1],G="Month";else if(k.daily&&k.daily.length>0)F=k.daily[k.daily.length-1],G="Today";let J=F?F.download+F.upload:0;q.networkUsage=Q(J*1024),q.networkUsageMB=Math.floor(J/1024),q.payload=k;let O=J>0?`${G}: ${q.networkUsage}`:G;this.#k.status({fill:"green",shape:"dot",text:O}),z(q),w()}catch(k){this.#k.status({fill:"red",shape:"ring",text:"Error"}),w(k)}}}function S(q){q.nodes.registerType("padavan-history",function(z){q.nodes.createNode(this,z);let w=this;w.instance=new M(w,z,q)})}export{S as default,M as HistoryNode};

package/dist/nodes/locales/en-US/config.html

@@ -0,0 +1,21 @@
+<script type="text/markdown" data-help-name="padavan-config" data-lang="en-US">
+Configures connections to the router and GitHub repository.
+
+### Router
+
+Settings for connecting to the Padavan web interface.
+
+- **Host**: IP address or hostname of the router (e.g., `192.168.1.1`).
+- **Username**: Administrator username (usually `admin`).
+- **Password**: Administrator password.
+
+### Github
+
+Settings for firmware updates and builds. Required only for the `Upgrade` node.
+
+- **Repo**: Repository URL or `owner/repo` string (e.g.,
+  `alex2844/padavan-builder`).
+- **Branch**: The branch to use for builds and checks (e.g., `main`).
+- **Token**: GitHub Personal Access Token (PAT) with access to Actions and
+  Artifacts.
+</script>

package/dist/nodes/locales/en-US/config.json

@@ -0,0 +1,22 @@
+{
+	"config": {
+		"label": {
+			"name": "Name",
+			"debug": "Enable debug",
+			"github": "Github",
+			"repo": "Repo",
+			"branch": "Branch",
+			"token": "Token",
+			"router": "Router",
+			"host": "Host",
+			"username": "Username",
+			"password": "Password"
+		},
+		"placeholder": {
+			"name": "e.g., My Router",
+			"repo": "owner/repository or GitHub URL",
+			"branch": "e.g., main",
+			"host": "e.g., 192.168.1.1"
+		}
+	}
+}

package/dist/nodes/locales/en-US/devices.html

@@ -0,0 +1,30 @@
+<script type="text/markdown" data-help-name="padavan-devices" data-lang="en-US">
+Retrieves the list of currently connected devices from the router.
+
+### Outputs
+
+1. **Standard Output**
+   - `msg.payload` (`array`): An array of current device objects. Each object
+     contains:
+     - `hostname`: Device name.
+     - `ip`: IP address.
+     - `mac`: MAC address.
+     - `type`: Connection type (`eth`, `2.4GHz`, `5GHz`).
+     - `rssi`: Signal strength (for Wi-Fi clients).
+   - `msg.numConnectedDevices` (`number`): The total count of connected
+     devices.
+   - `msg.changes` (`object`): A summary of changes since the last check.
+     - `hasChanges` (`boolean`): `true` if any change occurred.
+     - `added` (`array`): List of new devices.
+     - `removed` (`array`): List of disconnected devices.
+     - `changed` (`array`): List of devices with changed properties (IP, name,
+       type).
+
+### Details
+
+Any message sent to this node triggers a fresh lookup.
+
+The node implements **smart caching** to filter out "ghost" entries (e.g.,
+when a device switches from Wi-Fi to Ethernet in the ARP table momentarily
+during disconnection).
+</script>

package/dist/nodes/locales/en-US/devices.json

@@ -0,0 +1,11 @@
+{
+	"devices": {
+		"label": {
+			"settings": "Config",
+			"name": "Name"
+		},
+		"placeholder": {
+			"name": "Devices"
+		}
+	}
+}

package/dist/nodes/locales/en-US/history.html

@@ -0,0 +1,24 @@
+<script type="text/markdown" data-help-name="padavan-history" data-lang="en-US">
+Retrieves traffic usage statistics.
+
+### Outputs
+
+1. **Standard Output**
+   - `msg.payload` (`object`): The raw history object from the router
+     (`daily` and `monthly` arrays).
+   - `msg.networkUsage` (`string`): Total traffic for the current period
+     (Month or Day) in a human-readable format (e.g., "15.2 GB").
+   - `msg.networkUsageMB` (`number`): Total traffic in Megabytes (integer).
+
+### Details
+
+This node automatically prioritizes **Monthly** statistics.
+
+1. If monthly history is available, `networkUsage` reflects the current
+   month's total.
+2. If monthly history is missing (e.g., after a reset), it falls back to
+   **Daily** statistics for the current day.
+
+This data structure is optimized for integration with voice assistants (like
+Google Home `NetworkControl` trait) and dashboards.
+</script>

package/dist/nodes/locales/en-US/history.json

@@ -0,0 +1,11 @@
+{
+	"history": {
+		"label": {
+			"settings": "Config",
+			"name": "Name"
+		},
+		"placeholder": {
+			"name": "History"
+		}
+	}
+}

package/dist/nodes/locales/en-US/params.html

@@ -0,0 +1,30 @@
+<script type="text/markdown" data-help-name="padavan-params" data-lang="en-US">
+Reads or modifies NVRAM parameters and settings.
+
+### Inputs
+
+- **Action** (`msg.topic`):
+  - `list`: Get all NVRAM parameters.
+  - `get`: Get specific parameters defined in `msg.payload`.
+  - `set`: Apply settings defined in `msg.payload`.
+- **Payload** (`msg.payload`):
+  - For `get`: A string (key) or array of strings (keys).
+  - For `set`: An object `{ key: value }`.
+- **Options**:
+  - `msg.page`: Current ASP page (helper for finding Service IDs).
+  - `msg.sid`: Service ID list (required for restarting services).
+  - `msg.group`: Group ID (required for list operations).
+  - `msg.script`: Action script to execute.
+  - `msg.action`: Action mode (e.g., `' Apply '`, `' Add '`, `' Reboot '`).
+
+### Outputs
+
+- `msg.payload`: The requested parameters (for `get`/`list`) or the applied
+  configuration (for `set`).
+
+### Details
+
+Use the **Action Mode** field in the editor (or `msg.action`) to control how
+parameters are applied (e.g., just change NVRAM, apply changes to a service,
+or reboot).
+</script>

package/dist/nodes/locales/en-US/params.json

@@ -0,0 +1,26 @@
+{
+	"params": {
+		"label": {
+			"settings": "Config",
+			"name": "Name",
+			"topic": "Action",
+			"payload": "Payload",
+			"page": "ASP Page",
+			"sid": "Service IDs",
+			"group": "Group ID",
+			"script": "Action Script",
+			"action": "Action Mode"
+		},
+		"placeholder": {
+			"name": "Params",
+			"page": "e.g., Advanced_DHCP_Content.asp",
+			"sid": "e.g., WLANConfig11b",
+			"group": "e.g., ManualDHCPList"
+		},
+		"action": {
+			"list": "Get All (NVRAM)",
+			"get": "Get Specific",
+			"set": "Set Parameters"
+		}
+	}
+}

package/dist/nodes/locales/en-US/system.html

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="padavan-system" data-lang="en-US">
+Performs system diagnostics and control operations.
+
+### Inputs
+
+- **Action** (`msg.topic`):
+  - `status`: Get system status (CPU, RAM, Uptime).
+  - `log`: Get the system log.
+  - `reboot`: Reboot the router.
+  - `scan`: Scan for Wi-Fi networks (Site Survey).
+  - `doctor`: Analyze Wi-Fi environment and recommend the best channel.
+- **Band** (`msg.band`):
+  - Used for `scan` and `doctor`.
+  - Values: `'2.4'` or `'5'`.
+
+### Outputs
+
+- `msg.payload`: The result of the operation (JSON object for status/doctor,
+  array for scan, string for log).
+
+### Details
+
+The **Wi-Fi Doctor** action analyzes all visible networks, calculates
+interference scores, and suggests the optimal channel for your router.
+</script>

package/dist/nodes/locales/en-US/system.json

@@ -0,0 +1,20 @@
+{
+	"system": {
+		"label": {
+			"settings": "Config",
+			"name": "Name",
+			"topic": "Action",
+			"band": "Band"
+		},
+		"placeholder": {
+			"name": "System"
+		},
+		"action": {
+			"status": "Get Status",
+			"log": "Get Log",
+			"reboot": "Reboot",
+			"scan": "Scan Wi-Fi",
+			"doctor": "Wi-Fi Doctor"
+		}
+	}
+}

package/dist/nodes/locales/en-US/upgrade.html

@@ -0,0 +1,21 @@
+<script type="text/markdown" data-help-name="padavan-upgrade" data-lang="en-US">
+Manages firmware lifecycle via GitHub Actions.
+
+### Actions (`msg.topic`)
+
+- **Check Updates** (`changelog`):
+  - Checks if a newer firmware version is available in the GitHub repository.
+  - Output: Object with `from` (current), `to` (latest), and `messages`
+    (commit list).
+- **Build Firmware** (`build`):
+  - Triggers a new workflow run in the configured GitHub repository.
+- **Flash Firmware** (`upgrade`):
+  - Downloads the latest successful artifact.
+  - Uploads it to the router.
+  - Flashes the firmware and reboots the router.
+
+### Requirements
+
+Requires valid **Github** credentials (Repo, Branch, Token) in the
+Configuration node.
+</script>