@fastybird/smart-panel-backend 0.12.0-alpha.0 → 1.0.0-beta.3

package/dist/modules/extensions/services/extension-action.interface.d.ts

@@ -1,3 +1,4 @@
+import { UserRole } from '../../users/users.constants';
 export type ActionMode = 'immediate' | 'interactive';
 export declare enum ActionParameterType {
     STRING = "string",
@@ -49,5 +50,7 @@ export interface IExtensionAction {
     mode: ActionMode;
     dangerous?: boolean;
     parameters?: IActionParameter[];
+    requiredRoles?: UserRole[];
     execute?(params: Record<string, unknown>): Promise<IActionResult>;
 }
+export declare const DEFAULT_ACTION_ROLES: UserRole[];

package/dist/modules/extensions/services/extension-action.interface.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionCategory = exports.ActionParameterType = void 0;
+exports.DEFAULT_ACTION_ROLES = exports.ActionCategory = exports.ActionParameterType = void 0;
+const users_constants_1 = require("../../users/users.constants");
 var ActionParameterType;
 (function (ActionParameterType) {
     ActionParameterType["STRING"] = "string";
@@ -17,4 +18,5 @@ var ActionCategory;
     ActionCategory["DIAGNOSTICS"] = "diagnostics";
     ActionCategory["MAINTENANCE"] = "maintenance";
 })(ActionCategory || (exports.ActionCategory = ActionCategory = {}));
+exports.DEFAULT_ACTION_ROLES = [users_constants_1.UserRole.OWNER, users_constants_1.UserRole.ADMIN];
 //# sourceMappingURL=extension-action.interface.js.map

package/dist/modules/extensions/services/extension-action.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-action.interface.js","sourceRoot":"","sources":["../../../../src/modules/extensions/services/extension-action.interface.ts"],"names":[],"mappings":";;;AAYA,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC9B,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,0CAAmB,CAAA;IACnB,wCAAiB,CAAA;IACjB,oDAA6B,CAAA;AAC9B,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAgDD,IAAY,cAMX;AAND,WAAY,cAAc;IACzB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,+BAAa,CAAA;IACb,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;AAC5B,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB"}
+{"version":3,"file":"extension-action.interface.js","sourceRoot":"","sources":["../../../../src/modules/extensions/services/extension-action.interface.ts"],"names":[],"mappings":";;;AAAA,iEAAuD;AAcvD,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC9B,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,0CAAmB,CAAA;IACnB,wCAAiB,CAAA;IACjB,oDAA6B,CAAA;AAC9B,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAgDD,IAAY,cAMX;AAND,WAAY,cAAc;IACzB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,+BAAa,CAAA;IACb,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;AAC5B,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB;AA+CY,QAAA,oBAAoB,GAAe,CAAC,0BAAQ,CAAC,KAAK,EAAE,0BAAQ,CAAC,KAAK,CAAC,CAAC"}

package/dist/modules/intents/intents.module.js

@@ -37,42 +37,43 @@ let IntentsModule = class IntentsModule {
             name: 'Intents',
             description: 'Intent orchestration for UI anti-jitter and optimistic updates',
             author: 'FastyBird',
-            readme: `# Intents Module
+            readme: `# Intents
 
-The Intents module provides intent orchestration for coordinating UI updates across multiple clients, preventing anti-jitter issues and enabling optimistic updates.
+> Module · by FastyBird
 
-## Features
+Coordinates UI updates across all connected clients (admin, panel displays, mobile) so optimistic actions stay in sync. An intent represents a user-initiated change with a TTL: clients show the expected value immediately and reconcile when the backend confirms the real outcome or the TTL elapses. This is what makes the panel feel instant even when the underlying device takes a second to respond.
+
+## What it gives you
 
-- **Intent Lifecycle Management** - Track intents from creation through completion or expiration
-- **Multi-Target Support** - Single intent can affect multiple devices/properties
-- **Optimistic Updates** - Clients can show expected values before confirmation
-- **Anti-Jitter Protection** - Prevents UI flickering when multiple clients update simultaneously
-- **WebSocket Integration** - Real-time intent status broadcasts to all connected clients
+- A "single source of truth" for in-flight user actions: every client sees the same pending change at the same time
+- Automatic anti-jitter — when two users tap the same switch from two clients, they don't fight each other
+- A short audit trail of recent user actions, queryable by the action observer used in dashboards and Buddy
 
-## How It Works
+## Features
 
-1. **Intent Creation** - When a client initiates an action (e.g., turn on light), an intent is created with a unique ID and TTL
-2. **Broadcasting** - The intent is broadcast to all connected clients via WebSocket
-3. **Target Tracking** - Each target (device/property) within the intent is tracked individually
-4. **Completion** - When backend confirms the change, intent is marked complete
-5. **Expiration** - If TTL expires before confirmation, intent is marked expired
+- **Intent lifecycle** — \`pending → confirmed | failed | expired\`, observable through the API and over WebSocket
+- **Multi-target** — a single intent can carry several device / property writes at once and is committed atomically from the UI's point of view
+- **Optimistic updates** — clients apply the expected value the instant the intent is created and revert if the backend reports failure or the TTL fires
+- **Anti-jitter** — coalesces near-simultaneous intents on the same target so the UI doesn't flicker between competing values
+- **WebSocket broadcast** — every state transition is pushed to every connected client; no polling needed
+- **Time-series log** — completed and failed intents are persisted briefly so dashboards and the assistant can answer "what just happened in this room?"
+- **Pluggable intent types** — modules can register their own intent kinds with their own validation and reconciliation logic
 
 ## Intent Types
 
-- \`light.toggle\` - Toggle light on/off
-- \`light.setBrightness\` - Set light brightness level
-- \`light.setColor\` - Set light RGB color
-- \`light.setColorTemp\` - Set light color temperature
-- \`device.setProperty\` - Generic property value change
-- \`scene.run\` - Execute a scene
+- \`light.toggle\` — toggle a light on/off
+- \`light.setBrightness\` — set light brightness
+- \`light.setColor\` — set light RGB colour
+- \`light.setColorTemp\` — set light colour temperature
+- \`device.setProperty\` — generic property value change
+- \`scene.run\` — execute a scene
 
-## Client Integration
+## Client Flow
 
-Clients should:
-1. Listen for intent events via WebSocket
-2. Apply optimistic updates when intent is created
-3. Revert if intent expires or fails
-4. Confirm when intent completes successfully`,
+1. User triggers an action — a client publishes an intent
+2. The intent is broadcast over WebSocket; every client applies the expected value
+3. The backend confirms the change → intent completes and clients keep the value
+4. If the TTL elapses without confirmation → intent expires and clients revert to the last known good value`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/modules/intents/intents.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"intents.module.js","sourceRoot":"","sources":["../../../src/modules/intents/intents.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAwC;AAExC,gGAA0F;AAC1F,kFAA8E;AAC9E,8DAA0D;AAC1D,+EAAiE;AAEjE,yEAAqE;AACrE,+DAAiE;AACjE,2DAI6B;AAC7B,wDAA2D;AAC3D,oFAA+E;AAC/E,gEAA4D;AAarD,IAAM,aAAa,GAAnB,MAAM,aAAa;IACzB,YACkB,iBAAoC,EACpC,oBAA8C;QAD9C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA0B;IAC7D,CAAC;IAEJ,YAAY;QAEX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAA6C;YACrF,IAAI,EAAE,uCAAmB;YACzB,KAAK,EAAE,iCAAkB;YACzB,SAAS,EAAE,0CAAsB;SACjC,CAAC,CAAC;QAGH,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,uCAAmB;YACzB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gEAAgE;YAC7E,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAmCmC;YAC3C,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AA9DY,sCAAa;wBAAb,aAAa;IAXzB,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,uCAAmB;QAC5B,WAAW,EAAE,+CAA2B;QACxC,WAAW,EAAE,sDAAkC;KAC/C,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,8BAAa,CAAC;QACxB,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,gCAAc,EAAE,mDAAuB,CAAC;QACpD,OAAO,EAAE,CAAC,gCAAc,EAAE,mDAAuB,CAAC;KAClD,CAAC;qCAGoC,sCAAiB;QACd,sDAAwB;GAHpD,aAAa,CA8DzB"}
+{"version":3,"file":"intents.module.js","sourceRoot":"","sources":["../../../src/modules/intents/intents.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAwC;AAExC,gGAA0F;AAC1F,kFAA8E;AAC9E,8DAA0D;AAC1D,+EAAiE;AAEjE,yEAAqE;AACrE,+DAAiE;AACjE,2DAI6B;AAC7B,wDAA2D;AAC3D,oFAA+E;AAC/E,gEAA4D;AAarD,IAAM,aAAa,GAAnB,MAAM,aAAa;IACzB,YACkB,iBAAoC,EACpC,oBAA8C;QAD9C,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,yBAAoB,GAApB,oBAAoB,CAA0B;IAC7D,CAAC;IAEJ,YAAY;QAEX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAA6C;YACrF,IAAI,EAAE,uCAAmB;YACzB,KAAK,EAAE,iCAAkB;YACzB,SAAS,EAAE,0CAAsB;SACjC,CAAC,CAAC;QAGH,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,uCAAmB;YACzB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gEAAgE;YAC7E,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4GAoCiG;YACzG,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AA/DY,sCAAa;wBAAb,aAAa;IAXzB,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,uCAAmB;QAC5B,WAAW,EAAE,+CAA2B;QACxC,WAAW,EAAE,sDAAkC;KAC/C,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,8BAAa,CAAC;QACxB,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,gCAAc,EAAE,mDAAuB,CAAC;QACpD,OAAO,EAAE,CAAC,gCAAc,EAAE,mDAAuB,CAAC;KAClD,CAAC;qCAGoC,sCAAiB;QACd,sDAAwB;GAHpD,aAAa,CA+DzB"}

package/dist/modules/mdns/mdns.module.js

@@ -44,38 +44,43 @@ let MdnsModule = class MdnsModule {
             name: 'mDNS',
             description: 'Multicast DNS service advertisement for network discovery',
             author: 'FastyBird',
-            readme: `# mDNS Module
+            readme: `# mDNS
 
-The mDNS (Multicast DNS) module enables automatic network discovery of the Smart Panel using Bonjour/Avahi protocols.
+> Module · by FastyBird
+
+Advertises the Smart Panel on the local network using Multicast DNS (Bonjour / Avahi) so admin browsers and panel displays can auto-discover the backend without a hard-coded IP address. This is what makes "just plug it in and find it on the LAN" actually work.
+
+## What it gives you
+
+- Newly flashed displays connect to the backend on first boot without any manual IP entry
+- The admin UI bookmarks survive DHCP IP changes — the hostname is what's resolved
+- Multiple Smart Panel installations can coexist on the same network and be told apart by hostname
 
 ## Features
 
-- **Service Advertisement** - Broadcasts Smart Panel presence on the local network
-- **Zero Configuration** - Clients can discover the panel without manual IP configuration
-- **Custom Naming** - Configure a custom hostname for the panel
+- **Zero-conf discovery** — clients find the panel automatically on the LAN by looking up the advertised service name
+- **Custom hostname** — pick the name advertised on the network; defaults to the system hostname
+- **Service metadata** — advertises the API base path, scheme (http/https) and version so clients can build URLs from the discovery record alone
+- **Toggleable** — disable advertisement on networks where mDNS is filtered or undesirable
+- **Live re-broadcast** — when the configuration changes the advertisement is updated without needing a restart
+
+## Configuration
 
-## How It Works
+| Option | Description | Default |
+|--------|-------------|---------|
+| \`enabled\` | Toggle mDNS advertisement | \`true\` |
+| \`hostname\` | Hostname advertised on the network | system hostname |
 
-When enabled, the Smart Panel advertises itself on the local network as:
+## Service Record
 
 \`\`\`
 _smart-panel._tcp.local
 \`\`\`
 
-This allows:
-- Mobile apps to auto-discover the panel
-- Other services to find the panel's IP address
-- Easy setup without manual network configuration
-
-## Configuration
-
-- **Enabled** - Toggle mDNS advertisement on/off
-- **Hostname** - Custom name for network identification
-
 ## Requirements
 
-- The Smart Panel must be on the same network segment as discovering clients
-- mDNS uses UDP port 5353`,
+- Discovering clients must share the same network segment as the panel
+- mDNS uses UDP port \`5353\` — make sure it isn't blocked by host or network firewalls`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/modules/mdns/mdns.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"mdns.module.js","sourceRoot":"","sources":["../../../src/modules/mdns/mdns.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,2CAAkE;AAElE,2DAAuD;AACvD,gGAA0F;AAC1F,uEAAmE;AACnE,kFAA8E;AAC9E,+EAAiE;AACjE,yGAAmG;AACnG,8DAA0D;AAE1D,+DAA8D;AAC9D,qDAAoD;AACpD,iDAAkE;AAClE,wDAAwD;AACxD,0DAAsD;AAY/C,IAAM,UAAU,GAAhB,MAAM,UAAU;IACtB,YACkB,oBAA8C,EAC9C,eAA6C,EAC7C,iBAAoC;QAFpC,yBAAoB,GAApB,oBAAoB,CAA0B;QAC9C,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAuC;YAC/E,IAAI,EAAE,iCAAgB;YACtB,KAAK,EAAE,8BAAe;YACtB,SAAS,EAAE,uCAAmB;SAC9B,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,+CAAgC,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAGD,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iCAAgB;YACtB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,2DAA2D;YACxE,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA+Be;YACvB,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AA9DY,gCAAU;qBAAV,UAAU;IAVtB,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iCAAgB;QACzB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,gEAAgE;KAC7E,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,qBAAgB,EAAE,4BAAY,EAAE,oCAAgB,EAAE,8BAAa,CAAC;QAC1E,SAAS,EAAE,CAAC,0BAAW,CAAC;QACxB,OAAO,EAAE,CAAC,0BAAW,CAAC;KACtB,CAAC;qCAGuC,sDAAwB;QAC7B,8DAA4B;QAC1B,sCAAiB;GAJ1C,UAAU,CA8DtB"}
+{"version":3,"file":"mdns.module.js","sourceRoot":"","sources":["../../../src/modules/mdns/mdns.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,2CAAkE;AAElE,2DAAuD;AACvD,gGAA0F;AAC1F,uEAAmE;AACnE,kFAA8E;AAC9E,+EAAiE;AACjE,yGAAmG;AACnG,8DAA0D;AAE1D,+DAA8D;AAC9D,qDAAoD;AACpD,iDAAkE;AAClE,wDAAwD;AACxD,0DAAsD;AAY/C,IAAM,UAAU,GAAhB,MAAM,UAAU;IACtB,YACkB,oBAA8C,EAC9C,eAA6C,EAC7C,iBAAoC;QAFpC,yBAAoB,GAApB,oBAAoB,CAA0B;QAC9C,oBAAe,GAAf,eAAe,CAA8B;QAC7C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAuC;YAC/E,IAAI,EAAE,iCAAgB;YACtB,KAAK,EAAE,8BAAe;YACtB,SAAS,EAAE,uCAAmB;SAC9B,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,+CAAgC,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAGD,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,iCAAgB;YACtB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,2DAA2D;YACxE,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wFAoC6E;YACrF,KAAK,EAAE;gBACN,aAAa,EAAE,wCAAwC;gBACvD,UAAU,EAAE,0CAA0C;aACtD;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAnEY,gCAAU;qBAAV,UAAU;IAVtB,IAAA,0BAAM,EAAC;QACP,OAAO,EAAE,iCAAgB;QACzB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,gEAAgE;KAC7E,CAAC;IACD,IAAA,eAAM,EAAC;QACP,OAAO,EAAE,CAAC,qBAAgB,EAAE,4BAAY,EAAE,oCAAgB,EAAE,8BAAa,CAAC;QAC1E,SAAS,EAAE,CAAC,0BAAW,CAAC;QACxB,OAAO,EAAE,CAAC,0BAAW,CAAC;KACtB,CAAC;qCAGuC,sDAAwB;QAC7B,8DAA4B;QAC1B,sCAAiB;GAJ1C,UAAU,CAmEtB"}

package/dist/modules/platform/dto/system-info.dto.d.ts

@@ -1,3 +1,4 @@
+import { NetworkMode } from '../../system/system.constants';
 import { NetworkStatsDto } from './network-stats.dto';
 import { TemperatureDto } from './temperature.dto';
 export declare class MemoryDto {
@@ -38,6 +39,7 @@ export declare class ProcessDto {
     uptime: number;
 }
 export declare class SystemInfoDto {
+    network_mode?: NetworkMode;
     cpu_load: number;
     memory: MemoryDto;
     storage: StorageDto[];

package/dist/modules/platform/dto/system-info.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SystemInfoDto = exports.ProcessDto = exports.DisplayDto = exports.DefaultNetworkDto = exports.OperatingSystemDto = exports.StorageDto = exports.MemoryDto = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const system_constants_1 = require("../../system/system.constants");
 const network_stats_dto_1 = require("./network-stats.dto");
 const temperature_dto_1 = require("./temperature.dto");
 class MemoryDto {
@@ -161,6 +162,12 @@ __decorate([
 class SystemInfoDto {
 }
 exports.SystemInfoDto = SystemInfoDto;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(system_constants_1.NetworkMode),
+    __metadata("design:type", String)
+], SystemInfoDto.prototype, "network_mode", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsNumber)(),

package/dist/modules/platform/dto/system-info.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-info.dto.js","sourceRoot":"","sources":["../../../../src/modules/platform/dto/system-info.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-info.dto.js","sourceRoot":"","sources":["../../../../src/modules/platform/dto/system-info.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAiD;AACjD,qDAAyF;AAEzF,oEAA4D;AAE5D,2DAAsD;AACtD,uDAAmD;AAEnD,MAAa,SAAS;CAYrB;AAZD,8BAYC;AATA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;wCACG;AAId;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;uCACE;AAIb;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;uCACE;AAGd,MAAa,UAAU;CAgBtB;AAhBD,gCAgBC;AAbA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;sCACA;AAIX;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;wCACE;AAIb;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;wCACE;AAIb;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;6CACO;AAGnB,MAAa,kBAAkB;CA6B9B;AA7BD,gDA6BC;AA1BA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;oDACM;AAIjB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;kDACI;AAIf;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;mDACK;AAIhB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;kDACI;AAIf;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;gDACE;AAKb;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;+CACQ;AAInB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;oDACM;AAGlB,MAAa,iBAAiB;CAoB7B;AApBD,8CAoBC;AAjBA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;oDACO;AAIlB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;8CACC;AAIZ;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;8CACC;AAIZ;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;8CACC;AAIZ;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;mDACM;AAGlB,MAAa,UAAU;CAgBtB;AAhBD,gCAgBC;AAbA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;gDACU;AAIrB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;gDACU;AAIrB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;iDACW;AAItB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;iDACW;AAGvB,MAAa,UAAU;CAQtB;AARD,gCAQC;AALA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;uCACC;AAIZ;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;0CACI;AAGhB,MAAa,aAAa;CAsDzB;AAtDD,sCAsDC;AAlDA;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,8BAAW,CAAC;;mDACO;AAI3B;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,0BAAQ,GAAE;;+CACM;AAKjB;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,SAAS,CAAC;8BACd,SAAS;6CAAC;AAKlB;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC;;8CACD;AAKtB;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC;8BACN,UAAU;sDAAC;AAK5B;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC;8BAC3B,kBAAkB;yCAAC;AAKvB;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,gCAAc,CAAC;8BACd,gCAAc;kDAAC;AAK5B;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,mCAAe,CAAC;;8CACD;AAK3B;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC;8BACb,iBAAiB;sDAAC;AAKnC;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC;8BACd,UAAU;8CAAC;AAKpB;IAHC,IAAA,0BAAM,GAAE;IACR,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC;8BACd,UAAU;8CAAC"}

package/dist/modules/platform/platform.module.js

@@ -33,30 +33,38 @@ let PlatformModule = class PlatformModule {
             name: 'Platform',
             description: 'Hardware platform detection, system power actions, and device monitoring',
             author: 'FastyBird',
-            readme: `# Platform Module
+            readme: `# Platform
 
-The Platform module handles hardware detection and platform-specific system operations.
+> Module · by FastyBird
+
+Auto-detects the underlying hardware / runtime and abstracts platform-specific system operations behind a uniform API. Other modules ask "reboot the device" or "set brightness to 50%" — this module decides whether that means \`systemctl\`, a Docker restart, a sysfs poke or a no-op.
+
+## What it gives you
+
+- A consistent abstraction so the rest of the codebase never branches on "are we on a Pi or in Docker?"
+- Multi-strategy fallback — when the preferred mechanism (systemctl, D-Bus, sudo) is unavailable the module tries the next best option before giving up
+- A safe sandbox for development where destructive actions become harmless equivalents (e.g. process exit instead of OS reboot)
 
 ## Features
 
-- **Platform Detection** - Auto-detects Raspberry Pi (including CM4-based boards like reTerminal), Docker, and generic Linux
-- **System Power** - Reboot and power off with multi-strategy fallback (systemctl, D-Bus, sudo)
-- **Throttle Monitoring** - CPU throttle status on Raspberry Pi (undervoltage, frequency capping, thermal)
-- **System Information** - CPU, memory, storage, network stats, and temperature readings
-- **Display Control** - Screen brightness and resolution management
-- **WiFi Management** - Network scanning and connection
+- **Auto-detection** — Raspberry Pi (incl. CM4 boards like reTerminal), Docker, Home Assistant add-on or generic Linux; a single env override lets you force any platform for testing
+- **Power actions** — reboot and power off with multi-strategy fallback (systemctl, D-Bus, sudo, container restart)
+- **Throttle monitoring** — CPU under-voltage, frequency capping and thermal flags on Raspberry Pi, exposed to the system module so the panel can warn the user
+- **System information** — CPU, memory, storage, network and temperature readings polled in the background and cached
+- **Display control** — screen brightness, screen blanking and resolution management on supported boards
+- **Wi-Fi management** — scan visible networks and connect to a chosen SSID with passphrase
+- **Time / locale** — timezone read and update where supported by the host
 
 ## Supported Platforms
 
-| Platform | Detection | Power Actions | Throttle | Display |
-|----------|-----------|---------------|----------|---------|
-| Raspberry Pi | Auto (device-tree) | Yes | Yes | Yes |
-| reTerminal (CM4) | Auto (device-tree) | Yes | Yes | Yes |
-| Docker | Env var | Container restart | No | No |
-| Home Assistant | Env var | Addon restart | No | No |
-| Generic Linux | Fallback | Limited | No | No |
-| Development | Env var | Process exit | No | No |
-`,
+| Platform | Detection | Power | Throttle | Display | Wi-Fi |
+|----------|-----------|-------|----------|---------|-------|
+| Raspberry Pi | device-tree | yes | yes | yes | yes |
+| reTerminal (CM4) | device-tree | yes | yes | yes | yes |
+| Docker | env var | container restart | no | no | no |
+| Home Assistant | env var | add-on restart | no | no | no |
+| Generic Linux | fallback | limited | no | limited | limited |
+| Development | env var | process exit | no | no | no |`,
             links: {
                 documentation: 'https://smart-panel.fastybird.com/docs/plugins/devices-module/reterminal',
                 repository: 'https://github.com/FastyBird/smart-panel',

package/dist/modules/platform/platform.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.module.js","sourceRoot":"","sources":["../../../src/modules/platform/platform.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,gGAA0F;AAC1F,kFAA8E;AAE9E,+DAAkE;AAClE,wDAA4D;AAC5D,6DAA4D;AAC5D,kEAA8D;AAMvD,IAAM,cAAc,GAApB,MAAM,cAAc;IAC1B,YACkB,oBAA8C,EAC9C,iBAAoC;QADpC,yBAAoB,GAApB,oBAAoB,CAA0B;QAC9C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAA+C;YACvF,IAAI,EAAE,yCAAoB;YAC1B,KAAK,EAAE,kCAAmB;YAC1B,SAAS,EAAE,2CAAuB;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yCAAoB;YAC1B,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,0EAA0E;YACvF,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBV;YACE,KAAK,EAAE;gBACN,aAAa,EAAE,0EAA0E;gBACzF,UAAU,EAAE,0CAA0C;gBACtD,QAAQ,EAAE,mCAAmC;aAC7C;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAjDY,wCAAc;yBAAd,cAAc;IAJ1B,IAAA,eAAM,EAAC;QACP,SAAS,EAAE,CAAC,kCAAe,CAAC;QAC5B,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC1B,CAAC;qCAGuC,sDAAwB;QAC3B,sCAAiB;GAH1C,cAAc,CAiD1B"}
+{"version":3,"file":"platform.module.js","sourceRoot":"","sources":["../../../src/modules/platform/platform.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AAEtD,gGAA0F;AAC1F,kFAA8E;AAE9E,+DAAkE;AAClE,wDAA4D;AAC5D,6DAA4D;AAC5D,kEAA8D;AAMvD,IAAM,cAAc,GAApB,MAAM,cAAc;IAC1B,YACkB,oBAA8C,EAC9C,iBAAoC;QADpC,yBAAoB,GAApB,oBAAoB,CAA0B;QAC9C,sBAAiB,GAAjB,iBAAiB,CAAmB;IACnD,CAAC;IAEJ,YAAY;QACX,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAA+C;YACvF,IAAI,EAAE,yCAAoB;YAC1B,KAAK,EAAE,kCAAmB;YAC1B,SAAS,EAAE,2CAAuB;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;YAC7C,IAAI,EAAE,yCAAoB;YAC1B,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,0EAA0E;YACvF,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA+B6C;YACrD,KAAK,EAAE;gBACN,aAAa,EAAE,0EAA0E;gBACzF,UAAU,EAAE,0CAA0C;gBACtD,QAAQ,EAAE,mCAAmC;aAC7C;SACD,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;AAzDY,wCAAc;yBAAd,cAAc;IAJ1B,IAAA,eAAM,EAAC;QACP,SAAS,EAAE,CAAC,kCAAe,CAAC;QAC5B,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC1B,CAAC;qCAGuC,sDAAwB;QAC3B,sCAAiB;GAH1C,cAAc,CAyD1B"}

package/dist/modules/platform/platforms/abstract.platform.d.ts

@@ -1,3 +1,5 @@
+import { Systeminformation } from 'systeminformation';
+import { NetworkMode } from '../../system/system.constants';
 import { NetworkStatsDto } from '../dto/network-stats.dto';
 import { StorageDto, SystemInfoDto } from '../dto/system-info.dto';
 import { TemperatureDto } from '../dto/temperature.dto';
@@ -5,6 +7,18 @@ import { ThrottleStatusDto } from '../dto/throttle-status.dto';
 import { WifiNetworksDto } from '../dto/wifi-networks.dto';
 export declare abstract class Platform {
     protected logger: import("../../../common/logger").ExtensionLoggerService;
+    private static readonly SLOW_CACHE_TTL_MS;
+    private static readonly STORAGE_CACHE_TTL_MS;
+    private siOsInfoCache;
+    private siGraphicsCache;
+    private siNetworkInterfacesCache;
+    private siFsSizeCache;
+    private networkModeCache;
+    private static readonly NETWORK_MODE_CACHE_TTL_MS;
+    protected cachedOsInfo(): Promise<Systeminformation.OsData>;
+    protected cachedGraphics(): Promise<Systeminformation.GraphicsData>;
+    protected cachedNetworkInterfaces(): Promise<Systeminformation.NetworkInterfacesData | Systeminformation.NetworkInterfacesData[]>;
+    protected cachedFsSize(): Promise<Systeminformation.FsSizeData[]>;
     abstract getSystemInfo(): Promise<SystemInfoDto>;
     abstract getThrottleStatus(): Promise<ThrottleStatusDto>;
     abstract getTemperature(): Promise<TemperatureDto>;
@@ -21,5 +35,35 @@ export declare abstract class Platform {
     abstract getNodeVersion(): Promise<string>;
     abstract getNpmVersion(): Promise<string | null>;
     abstract getPrimaryDisk(): Promise<StorageDto>;
+    protected static readonly THROTTLE_SYSFS_PATH = "/sys/devices/platform/soc/soc:firmware/get_throttled";
+    protected parseThrottleFlags(status: number): {
+        undervoltage: boolean;
+        frequencyCapping: boolean;
+        throttling: boolean;
+        softTempLimit: boolean;
+    };
+    protected readThrottleFromSysfs(): Promise<ThrottleStatusDto | null>;
+    protected readContainerMemory(): Promise<{
+        total: number;
+        used: number;
+        free: number;
+    } | null>;
+    protected readContainerCpuCount(): Promise<number>;
+    protected readContainerCpuLoad(): Promise<number | null>;
+    protected filterContainerStorage(fsList: Array<{
+        fs: string;
+        type: string;
+        mount: string;
+        size: number;
+        used: number;
+        available: number;
+    }>): Array<{
+        fs: string;
+        used: number;
+        size: number;
+        available: number;
+    }>;
+    protected getContainerSystemInfo(): Promise<SystemInfoDto>;
     protected validateDto<T extends object>(dtoClass: new () => T, rawData: unknown): Promise<T>;
+    protected detectNetworkMode(ip4: string): Promise<NetworkMode>;
 }