@signageos/front-applet 8.7.0 → 8.8.0

package/docs/sos_management/index.md

@@ -121,7 +121,7 @@ For more information what are capabilities, see the description of the `supports
 ```ts expandable
 getCapabilities(): Promise<ManagementCapability[]>;
 // show-more
-type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | AnyString;
+type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | 'SEND_UDP' | 'WAKE_ON_LAN' | 'CLEAR_PACKAGE_DATA' | AnyString;
 
 type AnyString = string & {};
 
@@ -376,7 +376,7 @@ or check the **ManagementCapability** type in `supports()` method. It has a list
 ```ts expandable
 supports(capability: ManagementCapability): Promise<boolean>;
 // show-more
-type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | AnyString;
+type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | 'SEND_UDP' | 'WAKE_ON_LAN' | 'CLEAR_PACKAGE_DATA' | AnyString;
 
 type AnyString = string & {};
 

package/docs/sos_management/network.md

@@ -174,6 +174,79 @@ interfaces.forEach((iface) => {
 
 <Separator />
 
+### sendUdp()
+
+The `sendUdp()` method sends a raw UDP datagram to the specified IP address and port.
+This is a low-level network primitive that can be used for protocols like Wake-on-LAN.
+
+```ts expandable
+sendUdp(ip: string, port: number, data: number[]): Promise<void>;
+```
+
+#### Params
+
+| Name   | Type       | Required         | Description                                                                                                           |
+|--------|------------|------------------|-----------------------------------------------------------------------------------------------------------------------|
+| `ip`   | `string`   |  <div>Yes</div>  | The destination IP address. Use `'255.255.255.255'` for broadcast.                                                    |
+| `port` | `number`   |  <div>Yes</div>  | The destination UDP port number (1-65535).                                                                            |
+| `data` | `number[]` |  <div>Yes</div>  | The payload as a byte array. Each element must be an integer between 0 and 255. Maximum 1500 elements (Ethernet MTU). |
+
+#### Return value
+
+A promise that resolves when the UDP packet has been sent.
+
+#### Possible errors
+
+
+- If the parameters are invalid.
+- If the device does not support sending UDP packets.
+
+#### Example
+
+```ts
+// Send a Wake-on-LAN magic packet
+await sos.management.network.sendUdp('255.255.255.255', 9, [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, ...]);
+```
+
+<Separator />
+
+### sendWakeOnLan()
+
+The `sendWakeOnLan()` method sends a Wake-on-LAN magic packet to wake a device with the given MAC address.
+The target device must have Wake-on-LAN enabled and be on the same local network.
+
+Internally, this generates a 102-byte magic packet (6×0xFF + 16× MAC address) and sends it
+as a UDP broadcast to `255.255.255.255` on port 9 via `sendUdp()`.
+
+```ts expandable
+sendWakeOnLan(macAddress: string): Promise<void>;
+```
+
+#### Params
+
+| Name         | Type     | Required         | Description                                                                                                       |
+|--------------|----------|------------------|-------------------------------------------------------------------------------------------------------------------|
+| `macAddress` | `string` |  <div>Yes</div>  | The MAC address of the target device. Accepted formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`. |
+
+#### Return value
+
+A promise that resolves when the magic packet has been sent.
+
+#### Possible errors
+
+
+- If the MAC address format is invalid.
+- If the device does not support sending UDP packets.
+
+#### Example
+
+```ts
+// Wake a device by its MAC address
+await sos.management.network.sendWakeOnLan('AA:BB:CC:DD:EE:FF');
+```
+
+<Separator />
+
 ### setDHCP(interfaceName)
 
 The `setDHCP()` method configures a selected network interface to use DHCP.

package/docs/sos_management/package.md

@@ -18,6 +18,26 @@ The `sos.management.package` API groups together methods for installing custom A
 
 ## Methods
 
+### clearData()
+
+The `clearData()` method stops a certain package and clears its user data.
+
+```ts expandable
+clearData(packageName: string): Promise<void>;
+```
+
+#### Params
+
+| Name          | Type     | Required         | Description                 |
+|---------------|----------|------------------|-----------------------------|
+| `packageName` | `string` |  <div>Yes</div>  | Name of the android package |
+
+#### Return value
+
+Resolves if the package data was cleared.
+
+<Separator />
+
 ### install()
 
 The `install()` method installs a particular package from the specified URL.

package/es6/FrontApplet/Management/IManagement.d.ts

@@ -1,7 +1,7 @@
 import INetworkInfo from './Network/INetworkInfo';
 import IBatteryStatus from './IBatteryStatus';
 import { AnyString } from '../../utils/types';
-export type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | AnyString;
+export type ManagementCapability = 'MODEL' | 'SERIAL_NUMBER' | 'BRAND' | 'OS_VERSION' | 'BATTERY_STATUS' | 'STORAGE_UNITS' | 'TEMPERATURE' | 'SCREENSHOT_UPLOAD' | 'NETWORK_INFO' | 'WIFI' | 'WIFI_SCAN' | 'WIFI_AP' | 'WIFI_STRENGTH' | 'TIMERS_PROPRIETARY' | 'BRIGHTNESS_SCHEDULING' | 'TIMERS_NATIVE' | 'SET_BRIGHTNESS' | 'GET_BRIGHTNESS' | 'SCREEN_RESIZE' | 'SET_TIME' | 'SET_TIMEZONE' | 'GET_TIMEZONE' | 'NTP_TIME' | 'APP_UPGRADE' | 'FIRMWARE_UPGRADE' | 'PACKAGE_INSTALL' | 'SET_VOLUME' | 'GET_VOLUME' | 'SET_REMOTE_CONTROL_ENABLED' | 'SET_DEBUG' | 'SYSTEM_REBOOT' | 'APP_RESTART' | 'DISPLAY_POWER' | 'SERVLET' | 'HARDWARE_LED_SET_COLOR' | 'PROXIMITY_SENSOR' | 'FACTORY_RESET' | 'ORIENTATION_LANDSCAPE' | 'ORIENTATION_PORTRAIT' | 'ORIENTATION_LANDSCAPE_FLIPPED' | 'ORIENTATION_PORTRAIT_FLIPPED' | 'ORIENTATION_AUTO' | 'SCHEDULE_POWER_ACTION' | 'EXTENDED_MANAGEMENT' | 'SYSTEM_CPU' | 'SYSTEM_MEMORY' | 'PROXY' | 'AUTO_RECOVERY' | 'PEER_RECOVERY' | 'FILE_SYSTEM_WIPEOUT' | 'REMOTE_DESKTOP' | 'HOTEL_MODE' | 'VPN' | 'CUSTOM_SCRIPTS' | 'NATIVE_COMMANDS_MDC' | 'DEVICE_OWNER' | 'ACCESSIBILITY_SERVICE' | 'DISPLAY_MANAGER' | 'SECRETS' | 'HARDWARE_ACCELERATION' | 'WIFI_COUNTRY' | 'STOP_PACKAGE' | 'SEND_UDP' | 'WAKE_ON_LAN' | 'CLEAR_PACKAGE_DATA' | AnyString;
 export default interface IManagement {
     supports(capability: ManagementCapability): Promise<boolean>;
     getModel(): Promise<string>;

package/es6/FrontApplet/Management/Network/INetwork.d.ts

@@ -22,6 +22,8 @@ export default interface INetwork {
     setDHCP(interfaceName: string): Promise<void>;
     disableInterface(interfaceName: string): Promise<void>;
     importCertificate(details: CertificateEapDetails): Promise<void>;
+    sendUdp(ip: string, port: number, data: number[]): Promise<void>;
+    sendWakeOnLan(macAddress: string): Promise<void>;
 }
 export declare const VCertificateEapDetails: {
     type: {

package/es6/FrontApplet/Management/Network/INetwork.js.map

@@ -1 +1 @@
-{"version":3,"file":"INetwork.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Network/INetwork.ts"],"names":[],"mappings":";;;AA4Ba,QAAA,sBAAsB,GAAG;IACrC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IACzC,aAAa,EAAE,SAAS;IACxB,iBAAiB,EAAE,SAAS;IAC5B,SAAS,EAAE,SAAS;IACpB,yBAAyB,EAAE,SAAS;CACpC,CAAC"}
+{"version":3,"file":"INetwork.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Network/INetwork.ts"],"names":[],"mappings":";;;AA8Ba,QAAA,sBAAsB,GAAG;IACrC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IACzC,aAAa,EAAE,SAAS;IACxB,iBAAiB,EAAE,SAAS;IAC5B,SAAS,EAAE,SAAS;IACpB,yBAAyB,EAAE,SAAS;CACpC,CAAC"}

package/es6/FrontApplet/Management/Network/Network.d.ts

@@ -136,5 +136,40 @@ export default class Network implements INetwork {
      * await sos.management.network.importCertificate(certDetailsEapTtls);
      */
     importCertificate(details: CertificateEapDetails): Promise<void>;
+    /**
+     * The `sendUdp()` method sends a raw UDP datagram to the specified IP address and port.
+     * This is a low-level network primitive that can be used for protocols like Wake-on-LAN.
+     *
+     * @param ip The destination IP address. Use `'255.255.255.255'` for broadcast.
+     * @param port The destination UDP port number (1-65535).
+     * @param data The payload as a byte array. Each element must be an integer between 0 and 255. Maximum 1500 elements (Ethernet MTU).
+     * @returns {Promise<void>} A promise that resolves when the UDP packet has been sent.
+     * @throws {Error} If the parameters are invalid.
+     * @throws {Error} If the device does not support sending UDP packets.
+     * @since 9.0.0
+     *
+     * @example
+     * // Send a Wake-on-LAN magic packet
+     * await sos.management.network.sendUdp('255.255.255.255', 9, [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, ...]);
+     */
+    sendUdp(ip: string, port: number, data: number[]): Promise<void>;
+    /**
+     * The `sendWakeOnLan()` method sends a Wake-on-LAN magic packet to wake a device with the given MAC address.
+     * The target device must have Wake-on-LAN enabled and be on the same local network.
+     *
+     * Internally, this generates a 102-byte magic packet (6×0xFF + 16× MAC address) and sends it
+     * as a UDP broadcast to `255.255.255.255` on port 9 via `sendUdp()`.
+     *
+     * @param macAddress The MAC address of the target device. Accepted formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`.
+     * @returns {Promise<void>} A promise that resolves when the magic packet has been sent.
+     * @throws {Error} If the MAC address format is invalid.
+     * @throws {Error} If the device does not support sending UDP packets.
+     * @since 9.0.0
+     *
+     * @example
+     * // Wake a device by its MAC address
+     * await sos.management.network.sendWakeOnLan('AA:BB:CC:DD:EE:FF');
+     */
+    sendWakeOnLan(macAddress: string): Promise<void>;
     private getMessage;
 }

package/es6/FrontApplet/Management/Network/Network.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const INetworkInfo_1 = require("./INetworkInfo");
 const Validate_1 = __importDefault(require("../../Validate/Validate"));
 const INetwork_1 = require("./INetwork");
+const wakeOnLan_1 = require("./wakeOnLan");
 /**
  * The `sos.management.network` API groups together networking methods. For Wi-Fi setup, use the [Wi-Fi API](https://developers.signageos.io/sdk/sos_management/wifi).
  *
@@ -168,6 +169,73 @@ class Network {
             details,
         });
     }
+    /**
+     * The `sendUdp()` method sends a raw UDP datagram to the specified IP address and port.
+     * This is a low-level network primitive that can be used for protocols like Wake-on-LAN.
+     *
+     * @param ip The destination IP address. Use `'255.255.255.255'` for broadcast.
+     * @param port The destination UDP port number (1-65535).
+     * @param data The payload as a byte array. Each element must be an integer between 0 and 255. Maximum 1500 elements (Ethernet MTU).
+     * @returns {Promise<void>} A promise that resolves when the UDP packet has been sent.
+     * @throws {Error} If the parameters are invalid.
+     * @throws {Error} If the device does not support sending UDP packets.
+     * @since 9.0.0
+     *
+     * @example
+     * // Send a Wake-on-LAN magic packet
+     * await sos.management.network.sendUdp('255.255.255.255', 9, [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, ...]);
+     */
+    async sendUdp(ip, port, data) {
+        (0, Validate_1.default)({ ip })
+            .required()
+            .string()
+            .lengthMin(1)
+            .own((subject) => {
+            const IP_REGEX = /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+            return IP_REGEX.test(subject.subject) || 'must be a valid IPv4 address';
+        });
+        (0, Validate_1.default)({ port }).required().number().min(1).max(65535);
+        (0, Validate_1.default)({ data })
+            .required()
+            .array('number')
+            .lengthMax(1500)
+            .own((subject) => {
+            for (const byte of subject.subject) {
+                if (byte < 0 || byte > 255 || !Number.isInteger(byte)) {
+                    return 'each element must be an integer between 0 and 255';
+                }
+            }
+            return true;
+        });
+        await this.postMessage({
+            type: this.getMessage('send_udp'),
+            ip,
+            port,
+            data,
+        });
+    }
+    /**
+     * The `sendWakeOnLan()` method sends a Wake-on-LAN magic packet to wake a device with the given MAC address.
+     * The target device must have Wake-on-LAN enabled and be on the same local network.
+     *
+     * Internally, this generates a 102-byte magic packet (6×0xFF + 16× MAC address) and sends it
+     * as a UDP broadcast to `255.255.255.255` on port 9 via `sendUdp()`.
+     *
+     * @param macAddress The MAC address of the target device. Accepted formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`.
+     * @returns {Promise<void>} A promise that resolves when the magic packet has been sent.
+     * @throws {Error} If the MAC address format is invalid.
+     * @throws {Error} If the device does not support sending UDP packets.
+     * @since 9.0.0
+     *
+     * @example
+     * // Wake a device by its MAC address
+     * await sos.management.network.sendWakeOnLan('AA:BB:CC:DD:EE:FF');
+     */
+    async sendWakeOnLan(macAddress) {
+        (0, Validate_1.default)({ macAddress }).required().string().lengthMin(1);
+        const magicPacket = (0, wakeOnLan_1.createMagicPacket)(macAddress);
+        await this.sendUdp('255.255.255.255', 9, magicPacket);
+    }
     getMessage(name) {
         return this.messagePrefix + '.' + name;
     }

package/es6/FrontApplet/Management/Network/Network.js.map

@@ -1 +1 @@
-{"version":3,"file":"Network.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Network/Network.ts"],"names":[],"mappings":";;;;;AACA,iDAQwB;AACxB,uEAA+C;AAC/C,yCAAqF;AAErF;;;;;;;;;;;GAWG;AACH,MAAqB,OAAO;IAGlB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ,yEAAyE;IAClE,KAAK,CAAC,aAAa;QACzB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC9C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;SACzC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,cAAc;QAC1B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAAC;SAC/C,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACnB,CAAC;IAyBD,gBAAgB;IACT,KAAK,CAAC,SAAS,CAAC,GAAG,IAAyD;QAClF,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;YACtC,IAAA,kBAAQ,EAAC,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;YAChD,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,+BAAgB,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,WAAW,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC;gBAC9C,aAAa;gBACb,OAAO;aACP,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;YACvB,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,qCAAsB,CAAC,CAAC;YAChE,MAAM,IAAI,CAAC,WAAW,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBAC3C,OAAO;aACP,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAqBD,gBAAgB;IACT,KAAK,CAAC,OAAO,CAAC,GAAG,IAAmC;QAC1D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YAClD,MAAM,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;YAChC,IAAA,kBAAQ,EAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,gCAAiB,CAAC,CAAC;YACpE,MAAM,IAAI,CAAC,WAAW,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;gBACzC,gBAAgB;aAChB,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;YAC7B,IAAA,kBAAQ,EAAC,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,CAAC,WAAW,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC;gBAC5C,aAAa;aACb,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,KAAK,CAAC,gBAAgB,CAAC,aAAqB;QAClD,IAAA,kBAAQ,EAAC,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAChD,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,2BAA2B,CAAC;YAClD,aAAa;SACb,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACI,KAAK,CAAC,iBAAiB,CAAC,OAA8B;QAC5D,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,iCAAsB,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAC3C,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAvMD,0BAuMC"}
+{"version":3,"file":"Network.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Network/Network.ts"],"names":[],"mappings":"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"}

package/es6/FrontApplet/Management/Network/wakeOnLan.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Parses a MAC address string into an array of 6 bytes.
+ * Accepts formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`.
+ *
+ * @param macAddress The MAC address string to parse.
+ * @returns An array of 6 bytes (numbers 0-255).
+ * @throws {Error} If the MAC address format is invalid.
+ */
+export declare function parseMacAddress(macAddress: string): number[];
+/**
+ * Creates a Wake-on-LAN magic packet for the given MAC address.
+ * The packet is 102 bytes: 6 bytes of 0xFF followed by the MAC address repeated 16 times.
+ *
+ * @param macAddress The target MAC address (formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`).
+ * @returns The magic packet as a number array (102 bytes, each 0-255).
+ * @throws {Error} If the MAC address format is invalid.
+ */
+export declare function createMagicPacket(macAddress: string): number[];

package/es6/FrontApplet/Management/Network/wakeOnLan.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMacAddress = parseMacAddress;
+exports.createMagicPacket = createMagicPacket;
+const MAC_REGEX = /^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$|^([0-9A-Fa-f]{2}-){5}[0-9A-Fa-f]{2}$|^[0-9A-Fa-f]{12}$/;
+/**
+ * Parses a MAC address string into an array of 6 bytes.
+ * Accepts formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`.
+ *
+ * @param macAddress The MAC address string to parse.
+ * @returns An array of 6 bytes (numbers 0-255).
+ * @throws {Error} If the MAC address format is invalid.
+ */
+function parseMacAddress(macAddress) {
+    if (!macAddress || !MAC_REGEX.test(macAddress)) {
+        throw new Error(`Invalid MAC address: "${macAddress}". Expected format: AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, or AABBCCDDEEFF`);
+    }
+    const hex = macAddress.replace(/[:-]/g, '');
+    const bytes = [];
+    for (let i = 0; i < 12; i += 2) {
+        bytes.push(parseInt(hex.substring(i, i + 2), 16));
+    }
+    return bytes;
+}
+const MAGIC_PACKET_HEADER = [0xff, 0xff, 0xff, 0xff, 0xff, 0xff];
+const MAC_REPETITIONS = 16;
+/**
+ * Creates a Wake-on-LAN magic packet for the given MAC address.
+ * The packet is 102 bytes: 6 bytes of 0xFF followed by the MAC address repeated 16 times.
+ *
+ * @param macAddress The target MAC address (formats: `AA:BB:CC:DD:EE:FF`, `AA-BB-CC-DD-EE-FF`, `AABBCCDDEEFF`).
+ * @returns The magic packet as a number array (102 bytes, each 0-255).
+ * @throws {Error} If the MAC address format is invalid.
+ */
+function createMagicPacket(macAddress) {
+    const macBytes = parseMacAddress(macAddress);
+    const packet = [...MAGIC_PACKET_HEADER];
+    for (let i = 0; i < MAC_REPETITIONS; i++) {
+        packet.push(...macBytes);
+    }
+    return packet;
+}
+//# sourceMappingURL=wakeOnLan.js.map

package/es6/FrontApplet/Management/Network/wakeOnLan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeOnLan.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Network/wakeOnLan.ts"],"names":[],"mappings":";;AAUA,0CAYC;AAaD,8CASC;AA5CD,MAAM,SAAS,GAAG,6FAA6F,CAAC;AAEhH;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,UAAkB;IACjD,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,2EAA2E,CAAC,CAAC;IACjI,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACjE,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAa,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/es6/FrontApplet/Management/Package/Package.d.ts

@@ -41,5 +41,14 @@ export default class Package implements IPackage {
      * @since 8.2.0
      */
     stop(packageName: string): Promise<boolean>;
+    /**
+     * The `clearData()` method stops a certain package and clears its user data.
+     *
+     * @param packageName Name of the android package
+     *
+     * @returns {Promise<void>} Resolves if the package data was cleared.
+     * @since 8.8.0
+     */
+    clearData(packageName: string): Promise<void>;
     private getMessage;
 }

package/es6/FrontApplet/Management/Package/Package.js

@@ -67,6 +67,21 @@ class Package {
         });
         return stopped;
     }
+    /**
+     * The `clearData()` method stops a certain package and clears its user data.
+     *
+     * @param packageName Name of the android package
+     *
+     * @returns {Promise<void>} Resolves if the package data was cleared.
+     * @since 8.8.0
+     */
+    async clearData(packageName) {
+        (0, Validate_1.default)({ packageName }).required().string();
+        await this.postMessage({
+            type: this.getMessage('clear_package_data'),
+            packageName,
+        });
+    }
     getMessage(name) {
         return this.messagePrefix + '.' + name;
     }

package/es6/FrontApplet/Management/Package/Package.js.map

@@ -1 +1 @@
-{"version":3,"file":"Package.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Package/Package.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;;;;;;;;;;;GAYG;AACH,MAAqB,OAAO;IAGlB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,WAAmB,EAAE,OAAe,EAAE,KAAoB;QAC/F,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACvC,IAAA,kBAAQ,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAA,kBAAQ,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QACpD,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;YACxC,OAAO;YACP,WAAW;YACX,OAAO;YACP,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,IAAI,CAAC,WAAmB;QACpC,IAAA,kBAAQ,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC1C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACrC,WAAW;SACX,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IAChB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAvDD,0BAuDC"}
+{"version":3,"file":"Package.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Package/Package.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;;;;;;;;;;;GAYG;AACH,MAAqB,OAAO;IAGlB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,WAAmB,EAAE,OAAe,EAAE,KAAoB;QAC/F,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACvC,IAAA,kBAAQ,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAA,kBAAQ,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QACpD,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;YACxC,OAAO;YACP,WAAW;YACX,OAAO;YACP,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,IAAI,CAAC,WAAmB;QACpC,IAAA,kBAAQ,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC1C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACrC,WAAW;SACX,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,SAAS,CAAC,WAAmB;QACzC,IAAA,kBAAQ,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAC3C,WAAW;SACX,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAvED,0BAuEC"}

package/es6/Monitoring/Management/Network/handleManagementNetworkRequests.js

@@ -32,6 +32,20 @@ function handleManagementNetworkRequests(onCommand, dispatch, frontApplet) {
                     result: {},
                 });
                 break;
+            case managementNetworkCommands_1.ManagementNetworkSendUdpRequest:
+                await frontApplet.management.network.sendUdp(commandEvent.command.ip, commandEvent.command.port, commandEvent.command.data);
+                await dispatch({
+                    type: managementNetworkCommands_1.ManagementNetworkSendUdpResult,
+                    result: {},
+                });
+                break;
+            case managementNetworkCommands_1.ManagementNetworkSendWakeOnLanRequest:
+                await frontApplet.management.network.sendWakeOnLan(commandEvent.command.macAddress);
+                await dispatch({
+                    type: managementNetworkCommands_1.ManagementNetworkSendWakeOnLanResult,
+                    result: {},
+                });
+                break;
             default:
         }
     });

package/es6/Monitoring/Management/Network/handleManagementNetworkRequests.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleManagementNetworkRequests.js","sourceRoot":"","sources":["../../../../src/Monitoring/Management/Network/handleManagementNetworkRequests.ts"],"names":[],"mappings":";;AAeA,0EAqCC;AAjDD,2EAUqC;AAErC,SAAgB,+BAA+B,CAC9C,SAA6G,EAC7G,QAAyE,EACzE,WAAwB;IAExB,SAAS,CAAC,KAAK,EAAE,YAA2D,EAAE,EAAE;QAC/E,QAAQ,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,KAAK,kEAAsC;gBAC1C,MAAM,QAAQ,CAAwC;oBACrD,IAAI,EAAE,iEAAqC;oBAC3C,MAAM,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE;iBAC7D,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,6DAAiC;gBACrC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACjH,MAAM,QAAQ,CAAmC;oBAChD,IAAI,EAAE,4DAAgC;oBACtC,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,iEAAqC;gBACzC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACjF,MAAM,QAAQ,CAAuC;oBACpD,IAAI,EAAE,gEAAoC;oBAC1C,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,oEAAwC;gBAC5C,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBAC1F,MAAM,QAAQ,CAA0C;oBACvD,IAAI,EAAE,mEAAuC;oBAC7C,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"handleManagementNetworkRequests.js","sourceRoot":"","sources":["../../../../src/Monitoring/Management/Network/handleManagementNetworkRequests.ts"],"names":[],"mappings":";;AAmBA,0EAmDC;AAnED,2EAcqC;AAErC,SAAgB,+BAA+B,CAC9C,SAA6G,EAC7G,QAAyE,EACzE,WAAwB;IAExB,SAAS,CAAC,KAAK,EAAE,YAA2D,EAAE,EAAE;QAC/E,QAAQ,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,KAAK,kEAAsC;gBAC1C,MAAM,QAAQ,CAAwC;oBACrD,IAAI,EAAE,iEAAqC;oBAC3C,MAAM,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE;iBAC7D,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,6DAAiC;gBACrC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACjH,MAAM,QAAQ,CAAmC;oBAChD,IAAI,EAAE,4DAAgC;oBACtC,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,iEAAqC;gBACzC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACjF,MAAM,QAAQ,CAAuC;oBACpD,IAAI,EAAE,gEAAoC;oBAC1C,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,oEAAwC;gBAC5C,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBAC1F,MAAM,QAAQ,CAA0C;oBACvD,IAAI,EAAE,mEAAuC;oBAC7C,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,2DAA+B;gBACnC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5H,MAAM,QAAQ,CAAiC;oBAC9C,IAAI,EAAE,0DAA8B;oBACpC,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,KAAK,iEAAqC;gBACzC,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACpF,MAAM,QAAQ,CAAuC;oBACpD,IAAI,EAAE,gEAAoC;oBAC1C,MAAM,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/es6/Monitoring/Management/Network/managementNetworkCommands.d.ts

@@ -1,6 +1,6 @@
 import { INetworkInterface, INetworkOptions } from '../../../FrontApplet/Management/Network/INetworkInfo';
 import { EmptyObject } from '../../EmptyObject';
-export type ManagementNetworkRequests = ManagementNetworkListInterfacesRequest | ManagementNetworkSetManualRequest | ManagementNetworkSetDHCPServerRequest | ManagementNetworkDisableInterfaceRequest;
+export type ManagementNetworkRequests = ManagementNetworkListInterfacesRequest | ManagementNetworkSetManualRequest | ManagementNetworkSetDHCPServerRequest | ManagementNetworkDisableInterfaceRequest | ManagementNetworkSendUdpRequest | ManagementNetworkSendWakeOnLanRequest;
 export declare const ManagementNetworkListInterfacesRequest = "sos.Monitoring.Management.Network.ListInterfacesRequest";
 export interface ManagementNetworkListInterfacesRequest {
     type: typeof ManagementNetworkListInterfacesRequest;
@@ -41,3 +41,25 @@ export interface ManagementNetworkDisableInterfaceResult {
     type: typeof ManagementNetworkDisableInterfaceResult;
     result: EmptyObject;
 }
+export declare const ManagementNetworkSendUdpRequest = "sos.Monitoring.Management.Network.SendUdpRequest";
+export interface ManagementNetworkSendUdpRequest {
+    type: typeof ManagementNetworkSendUdpRequest;
+    ip: string;
+    port: number;
+    data: number[];
+}
+export declare const ManagementNetworkSendUdpResult = "sos.Monitoring.Management.Network.SendUdpResult";
+export interface ManagementNetworkSendUdpResult {
+    type: typeof ManagementNetworkSendUdpResult;
+    result: EmptyObject;
+}
+export declare const ManagementNetworkSendWakeOnLanRequest = "sos.Monitoring.Management.Network.SendWakeOnLanRequest";
+export interface ManagementNetworkSendWakeOnLanRequest {
+    type: typeof ManagementNetworkSendWakeOnLanRequest;
+    macAddress: string;
+}
+export declare const ManagementNetworkSendWakeOnLanResult = "sos.Monitoring.Management.Network.SendWakeOnLanResult";
+export interface ManagementNetworkSendWakeOnLanResult {
+    type: typeof ManagementNetworkSendWakeOnLanResult;
+    result: EmptyObject;
+}

package/es6/Monitoring/Management/Network/managementNetworkCommands.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ManagementNetworkDisableInterfaceResult = exports.ManagementNetworkDisableInterfaceRequest = exports.ManagementNetworkSetDHCPServerResult = exports.ManagementNetworkSetDHCPServerRequest = exports.ManagementNetworkSetManualResult = exports.ManagementNetworkSetManualRequest = exports.ManagementNetworkListInterfacesResult = exports.ManagementNetworkListInterfacesRequest = void 0;
+exports.ManagementNetworkSendWakeOnLanResult = exports.ManagementNetworkSendWakeOnLanRequest = exports.ManagementNetworkSendUdpResult = exports.ManagementNetworkSendUdpRequest = exports.ManagementNetworkDisableInterfaceResult = exports.ManagementNetworkDisableInterfaceRequest = exports.ManagementNetworkSetDHCPServerResult = exports.ManagementNetworkSetDHCPServerRequest = exports.ManagementNetworkSetManualResult = exports.ManagementNetworkSetManualRequest = exports.ManagementNetworkListInterfacesResult = exports.ManagementNetworkListInterfacesRequest = void 0;
 exports.ManagementNetworkListInterfacesRequest = 'sos.Monitoring.Management.Network.ListInterfacesRequest';
 exports.ManagementNetworkListInterfacesResult = 'sos.Monitoring.Management.Network.ListInterfacesResult';
 exports.ManagementNetworkSetManualRequest = 'sos.Monitoring.Management.Network.SetManualRequest';
@@ -9,4 +9,8 @@ exports.ManagementNetworkSetDHCPServerRequest = 'sos.Monitoring.Management.Netwo
 exports.ManagementNetworkSetDHCPServerResult = 'sos.Monitoring.Management.Network.SetDHCPServerResult';
 exports.ManagementNetworkDisableInterfaceRequest = 'sos.Monitoring.Management.Network.DisableInterfaceRequest';
 exports.ManagementNetworkDisableInterfaceResult = 'sos.Monitoring.Management.Network.DisableInterfaceResult';
+exports.ManagementNetworkSendUdpRequest = 'sos.Monitoring.Management.Network.SendUdpRequest';
+exports.ManagementNetworkSendUdpResult = 'sos.Monitoring.Management.Network.SendUdpResult';
+exports.ManagementNetworkSendWakeOnLanRequest = 'sos.Monitoring.Management.Network.SendWakeOnLanRequest';
+exports.ManagementNetworkSendWakeOnLanResult = 'sos.Monitoring.Management.Network.SendWakeOnLanResult';
 //# sourceMappingURL=managementNetworkCommands.js.map

package/es6/Monitoring/Management/Network/managementNetworkCommands.js.map

@@ -1 +1 @@
-{"version":3,"file":"managementNetworkCommands.js","sourceRoot":"","sources":["../../../../src/Monitoring/Management/Network/managementNetworkCommands.ts"],"names":[],"mappings":";;;AASa,QAAA,sCAAsC,GAAG,yDAAyD,CAAC;AAKnG,QAAA,qCAAqC,GAAG,wDAAwD,CAAC;AAMjG,QAAA,iCAAiC,GAAG,oDAAoD,CAAC;AAOzF,QAAA,gCAAgC,GAAG,mDAAmD,CAAC;AAMvF,QAAA,qCAAqC,GAAG,wDAAwD,CAAC;AAMjG,QAAA,oCAAoC,GAAG,uDAAuD,CAAC;AAM/F,QAAA,wCAAwC,GAAG,2DAA2D,CAAC;AAMvG,QAAA,uCAAuC,GAAG,0DAA0D,CAAC"}
+{"version":3,"file":"managementNetworkCommands.js","sourceRoot":"","sources":["../../../../src/Monitoring/Management/Network/managementNetworkCommands.ts"],"names":[],"mappings":";;;AAWa,QAAA,sCAAsC,GAAG,yDAAyD,CAAC;AAKnG,QAAA,qCAAqC,GAAG,wDAAwD,CAAC;AAMjG,QAAA,iCAAiC,GAAG,oDAAoD,CAAC;AAOzF,QAAA,gCAAgC,GAAG,mDAAmD,CAAC;AAMvF,QAAA,qCAAqC,GAAG,wDAAwD,CAAC;AAMjG,QAAA,oCAAoC,GAAG,uDAAuD,CAAC;AAM/F,QAAA,wCAAwC,GAAG,2DAA2D,CAAC;AAMvG,QAAA,uCAAuC,GAAG,0DAA0D,CAAC;AAMrG,QAAA,+BAA+B,GAAG,kDAAkD,CAAC;AAQrF,QAAA,8BAA8B,GAAG,iDAAiD,CAAC;AAMnF,QAAA,qCAAqC,GAAG,wDAAwD,CAAC;AAMjG,QAAA,oCAAoC,GAAG,uDAAuD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signageos/front-applet",
-  "version": "8.7.0",
+  "version": "8.8.0",
   "main": "dist/bundle.js",
   "types": "es6/bundle.d.ts",
   "files": [