@signageos/front-applet 7.1.1 → 8.0.0

package/es6/FrontApplet/Management/Management.js

@@ -1,32 +1,52 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const Firmware_1 = require("./Firmware/Firmware");
-const Audio_1 = require("./Audio/Audio");
-const Screen_1 = require("./Screen/Screen");
-const RemoteControl_1 = require("./RemoteControl/RemoteControl");
-const Time_1 = require("./Time/Time");
-const App_1 = require("./App/App");
-const OS_1 = require("./OS/OS");
-const Debug_1 = require("./Debug/Debug");
-const Package_1 = require("./Package/Package");
-const Power_1 = require("./Power/Power");
-const Network_1 = require("./Network/Network");
-const Wifi_1 = require("./Wifi/Wifi");
-const Security_1 = require("./Security/Security");
-const Validate_1 = require("../Validate/Validate");
-const Proxy_1 = require("./Proxy/Proxy");
-const PeerRecovery_1 = require("./PeerRecovery/PeerRecovery");
-const AutoRecovery_1 = require("./AutoRecovery/AutoRecovery");
+const Validate_1 = __importDefault(require("../Validate/Validate"));
+const App_1 = __importDefault(require("./App/App"));
+const Audio_1 = __importDefault(require("./Audio/Audio"));
+const AutoRecovery_1 = __importDefault(require("./AutoRecovery/AutoRecovery"));
+const Debug_1 = __importDefault(require("./Debug/Debug"));
+const Firmware_1 = __importDefault(require("./Firmware/Firmware"));
+const Network_1 = __importDefault(require("./Network/Network"));
+const OS_1 = __importDefault(require("./OS/OS"));
+const Package_1 = __importDefault(require("./Package/Package"));
+const PeerRecovery_1 = __importDefault(require("./PeerRecovery/PeerRecovery"));
+const Power_1 = __importDefault(require("./Power/Power"));
+const Proxy_1 = __importDefault(require("./Proxy/Proxy"));
+const RemoteControl_1 = __importDefault(require("./RemoteControl/RemoteControl"));
+const Screen_1 = __importDefault(require("./Screen/Screen"));
+const Security_1 = __importDefault(require("./Security/Security"));
+const Time_1 = __importDefault(require("./Time/Time"));
+const Wifi_1 = __importDefault(require("./Wifi/Wifi"));
+/**
+ * The `sos.management` API group provides methods for managing the device. Through this API things like device firmware,
+ * battery status, brightness, network information, remote control, power, time or volume can be monitored.
+ *
+ * @example // {@link https://developers.signageos.io/sdk/management/js-management-management Example of the App API}
+ */
 class Management {
+    messagePrefix;
+    postMessage;
+    static MESSAGE_PREFIX = 'management';
+    app;
+    os;
+    audio;
+    debug;
+    firmware;
+    package;
+    power;
+    remoteControl;
+    screen;
+    time;
+    network;
+    wifi;
+    security;
+    proxy;
+    autoRecovery;
+    peerRecovery;
+    /** @internal */
     constructor(messagePrefix, postMessage) {
         this.messagePrefix = messagePrefix;
         this.postMessage = postMessage;
@@ -47,109 +67,168 @@ class Management {
         this.autoRecovery = new AutoRecovery_1.default(this.getMessagePrefix(), this.postMessage);
         this.peerRecovery = new PeerRecovery_1.default(this.getMessagePrefix(), this.postMessage);
     }
-    supports(capability) {
-        return __awaiter(this, void 0, void 0, function* () {
-            Validate_1.default({ capability }).required().string();
-            const { supports } = yield this.postMessage({
-                type: this.getMessage('supports'),
-                capability,
-            });
-            return supports;
+    /**
+     * The `supports()` method determines whether a queried capability is supported.
+     *
+     * @param capability The capability to check for support.
+     *
+     * @since 2.0.0
+     */
+    async supports(capability) {
+        (0, Validate_1.default)({ capability }).required().string();
+        const { supports } = await this.postMessage({
+            type: this.getMessage('supports'),
+            capability,
         });
-    }
-    getModel() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { model } = yield this.postMessage({
-                type: this.getMessage('get_model'),
-            });
-            return model;
+        return supports;
+    }
+    /**
+     * The `getModel()` method returns the model of the device.
+     *
+     * @since 2.0.0
+     */
+    async getModel() {
+        const { model } = await this.postMessage({
+            type: this.getMessage('get_model'),
         });
-    }
-    getSerialNumber() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { serialNumber } = yield this.postMessage({
-                type: this.getMessage('get_serial_number'),
-            });
-            return serialNumber;
+        return model;
+    }
+    /**
+     * The `getSerialNumber()` method returns the serial number of the device.
+     *
+     * @since 2.1.0
+     */
+    async getSerialNumber() {
+        const { serialNumber } = await this.postMessage({
+            type: this.getMessage('get_serial_number'),
         });
-    }
-    /** @deprecated Use sos.management.network.getActiveInfo() instead */
-    getNetworkInfo() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.network.getActiveInfo();
+        return serialNumber;
+    }
+    /** @deprecated Use `sos.management.network.listInterfaces()` instead. */
+    async getNetworkInfo() {
+        return await this.network.getActiveInfo();
+    }
+    /**
+     * The `getBatteryStatus()` method returns information about the battery of the device.
+     *
+     * @since 2.1.0
+     */
+    async getBatteryStatus() {
+        const { batteryStatus } = await this.postMessage({
+            type: this.getMessage('get_battery_status'),
         });
-    }
-    getBatteryStatus() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { batteryStatus } = yield this.postMessage({
-                type: this.getMessage('get_battery_status'),
-            });
-            return batteryStatus;
+        return batteryStatus;
+    }
+    /**
+     * The `getTemperature()` method returns the temperature of the device (in 0-100 range of degrees Celsius).
+     *
+     * @since 3.0.0
+     */
+    async getTemperature() {
+        const { currentTemperature } = await this.postMessage({
+            type: this.getMessage('get_current_temperature'),
         });
-    }
-    getTemperature() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { currentTemperature } = yield this.postMessage({
-                type: this.getMessage('get_current_temperature'),
-            });
-            return currentTemperature;
+        return currentTemperature;
+    }
+    /**
+     * The `getBrand()` method returns the manufacturer brand of the device.
+     *
+     * @since 5.7.0
+     */
+    async getBrand() {
+        const { brand } = await this.postMessage({
+            type: this.getMessage('get_brand'),
         });
-    }
-    getBrand() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { brand } = yield this.postMessage({
-                type: this.getMessage('get_brand'),
-            });
-            return brand;
-        });
-    }
-    resetSettings() {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.postMessage({
-                type: this.getMessage('reset_settings'),
-            });
+        return brand;
+    }
+    // TODO: Used only by NEC, can be eventually removed?
+    /**
+     * The `resetSettings()` method initializes the reset of the specific device settings.
+     *
+     * :::info
+     *
+     * This is currently only implemented on Linux platform.
+     *
+     * :::
+     *
+     * @since 4.0.0
+     */
+    async resetSettings() {
+        await this.postMessage({
+            type: this.getMessage('reset_settings'),
         });
     }
-    factoryReset() {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.postMessage({
-                type: this.getMessage('factory_reset'),
-            });
+    /**
+     * The `factoryReset()` method initializes the factory reset of the device.
+     *
+     * @since 4.0.0
+     */
+    async factoryReset() {
+        await this.postMessage({
+            type: this.getMessage('factory_reset'),
         });
     }
-    getExtendedManagementUrl() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { url } = yield this.postMessage({
-                type: this.getMessage('get_extendedmanagement_url'),
-            });
-            return url;
+    /**
+     * The `getExtendedManagementUrl()` method returns the management url of the device.
+     *
+     * :::info
+     *
+     * This is currently only implemented for the MagicInfo on Tizen platform.
+     *
+     * :::
+     *
+     * @since 6.2.0
+     */
+    async getExtendedManagementUrl() {
+        const { url } = await this.postMessage({
+            type: this.getMessage('get_extendedmanagement_url'),
         });
-    }
-    setExtendedManagementUrl(url) {
-        return __awaiter(this, void 0, void 0, function* () {
-            Validate_1.default({ url }).string().canBeNull();
-            yield this.postMessage({
-                type: this.getMessage('set_extendedmanagement_url'),
-                url,
-            });
+        return url;
+    }
+    /**
+     * The `getExtendedManagementUrl()` set the management url of the device.
+     *
+     * :::info
+     *
+     * This is currently only implemented for the MagicInfo on Tizen platform.
+     *
+     * :::
+     *
+     * @param url The management URL to set.
+     *
+     * @since 6.2.0
+     */
+    async setExtendedManagementUrl(url) {
+        (0, Validate_1.default)({ url }).string().canBeNull();
+        await this.postMessage({
+            type: this.getMessage('set_extendedmanagement_url'),
+            url,
         });
     }
-    setHardwareAcceleration(enabled) {
-        return __awaiter(this, void 0, void 0, function* () {
-            Validate_1.default({ enabled }).required().boolean();
-            yield this.postMessage({
-                type: this.getMessage('set_hardware_acceleration'),
-                enabled,
-            });
+    /**
+     * The `setHardwareAcceleration()` method enables or disables hardware acceleration.
+     *
+     * @param enabled Whether hardware acceleration should be enabled.
+     *
+     * @since 7.1.0
+     */
+    async setHardwareAcceleration(enabled) {
+        (0, Validate_1.default)({ enabled }).required().boolean();
+        await this.postMessage({
+            type: this.getMessage('set_hardware_acceleration'),
+            enabled,
         });
     }
-    isHardwareAccelerationEnabled() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { enabled } = yield this.postMessage({
-                type: this.getMessage('is_hardware_acceleration_enabled'),
-            });
-            return enabled;
+    /**
+     * The `isHardwareAccelerationEnabled()` method returns whether hardware acceleration is enabled.
+     *
+     * @since 7.1.0
+     */
+    async isHardwareAccelerationEnabled() {
+        const { enabled } = await this.postMessage({
+            type: this.getMessage('is_hardware_acceleration_enabled'),
         });
+        return enabled;
     }
     getMessage(name) {
         return this.getMessagePrefix() + '.' + name;
@@ -159,5 +238,4 @@ class Management {
     }
 }
 exports.default = Management;
-Management.MESSAGE_PREFIX = 'management';
 //# sourceMappingURL=Management.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Management.js","sourceRoot":"","sources":["../../../src/FrontApplet/Management/Management.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Management.js","sourceRoot":"","sources":["../../../src/FrontApplet/Management/Management.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,7 @@
-export declare type NetworkInterface = 'wifi' | 'ethernet';
+export type NetworkInterface = 'wifi' | 'ethernet';
 export declare const VNetworkInterface: string[];
 /**
- * @deprecated use INetworkInterface instead
+ * @deprecated use `INetworkInterface` instead
  */
 export default interface INetworkInfo {
     localAddress: string;

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

@@ -1,28 +1,76 @@
 import IPostMessage from '../../IPostMessage';
 import INetworkInfo, { INetworkInterface, INetworkOptions, INetworkOptionsLegacy, NetworkInterface } from './INetworkInfo';
 import INetwork from './INetwork';
+/**
+ * The `sos.management.network` API groups together methods for networking.
+ *
+ * :::info
+ *
+ * Use `sos.management.supports('NETWORK_INFO')` to check if the device supports managing the network setup.
+ *
+ * :::
+ */
 export default class Network implements INetwork {
     private messagePrefix;
     private postMessage;
+    /** @internal */
     constructor(messagePrefix: string, postMessage: IPostMessage<any>);
-    /** @deprecated use sos.management.network.listInterfaces() instead */
+    /** @deprecated Use `sos.management.network.listInterfaces()` instead. */
     getActiveInfo(): Promise<INetworkInfo>;
+    /**
+     * The `listInterface()` method returns list of all network interfaces, and their information like MAC address, IP address, etc. Wifi
+     * connection strength is described as percentage in range from 0 to 100, linearly converted from dBm -90 to -30 respectively based on
+     * platform.
+     *
+     * @since 4.9.0
+     */
     listInterfaces(): Promise<INetworkInterface[]>;
-    /** @deprecated use sos.management.network.setManual2() instead */
+    /** @deprecated Use `sos.management.network.setManual(interfaceName, options)` instead. */
     setManual(options: INetworkOptionsLegacy): Promise<void>;
     /**
-     * Manually configure a network interface
-     * @param interfaceName can be retrieved from the list of interfaces returned by listInterfaces()
-     * @param options
+     * The `setManual()` method manually configures a network interface.
+     *
+     * :::warning
+     *
+     * Wi-Fi interface can be configured with this method but it has to be first enabled via the [Wi-Fi API](./wifi#enableClient).
+     *
+     * :::
+     *
+     * @param interfaceName The interface name which can be retrieved from the list of interfaces returned by listInterfaces()
+     * @param options The network configuration options.
+     *
+     * @since 4.0.0
      */
     setManual(interfaceName: string, options: INetworkOptions): Promise<void>;
-    /** @deprecated use sos.management.network.setDHCP2() instead */
+    /** @deprecated Use `sos.management.network.setDHCP(interfaceName)` instead. */
     setDHCP(networkInterface: NetworkInterface): Promise<void>;
     /**
-     * Configure a network interface to use DHCP
-     * @param interfaceName can be retrieved from the list of interfaces returned by listInterfaces()
+     * The `setDHCP()` method configures a network interface to use DHCP.
+     *
+     * :::warning
+     *
+     * Wi-Fi interface can be configured with this method but it has to be first enabled via the [Wi-Fi API](./wifi#enableClient).
+     *
+     * :::
+     *
+     * @param interfaceName The interface name which can be retrieved from the list of interfaces returned by listInterfaces()
+     *
+     * @since 4.0.0
      */
     setDHCP(interfaceName: string): Promise<void>;
+    /**
+     * The `disableInterface()` disables a network interface.
+     *
+     * :::warning
+     *
+     * Don't use this method to disable Wi-Fi. Use [Wi-Fi API](./wifi) to enable/disable Wi-Fi.
+     *
+     * :::
+     *
+     * @param interfaceName The interface name which can be retrieved from the list of interfaces returned by listInterfaces()
+     *
+     * @since 4.13.0
+     */
     disableInterface(interfaceName: string): Promise<void>;
     private getMessage;
 }

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

@@ -1,87 +1,105 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const INetworkInfo_1 = require("./INetworkInfo");
-const Validate_1 = require("../../Validate/Validate");
+const Validate_1 = __importDefault(require("../../Validate/Validate"));
+/**
+ * The `sos.management.network` API groups together methods for networking.
+ *
+ * :::info
+ *
+ * Use `sos.management.supports('NETWORK_INFO')` to check if the device supports managing the network setup.
+ *
+ * :::
+ */
 class Network {
+    messagePrefix;
+    postMessage;
+    /** @internal */
     constructor(messagePrefix, postMessage) {
         this.messagePrefix = messagePrefix;
         this.postMessage = postMessage;
     }
-    /** @deprecated use sos.management.network.listInterfaces() instead */
-    getActiveInfo() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { networkInfo } = yield this.postMessage({
-                type: this.getMessage('get_network_info'),
-            });
-            return networkInfo;
+    /** @deprecated Use `sos.management.network.listInterfaces()` instead. */
+    async getActiveInfo() {
+        const { networkInfo } = await this.postMessage({
+            type: this.getMessage('get_network_info'),
         });
+        return networkInfo;
     }
-    listInterfaces() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { interfaces } = yield this.postMessage({
-                type: this.getMessage('get_network_interfaces'),
-            });
-            return interfaces;
+    /**
+     * The `listInterface()` method returns list of all network interfaces, and their information like MAC address, IP address, etc. Wifi
+     * connection strength is described as percentage in range from 0 to 100, linearly converted from dBm -90 to -30 respectively based on
+     * platform.
+     *
+     * @since 4.9.0
+     */
+    async listInterfaces() {
+        const { interfaces } = await this.postMessage({
+            type: this.getMessage('get_network_interfaces'),
         });
+        return interfaces;
     }
-    setManual(...args) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (typeof args[0] === 'string') {
-                const [interfaceName, options] = args;
-                Validate_1.default({ interfaceName }).required().string();
-                Validate_1.default({ options }).required().object(INetworkInfo_1.VINetworkOptions);
-                yield this.postMessage({
-                    type: this.getMessage('set_network_manual_v2'),
-                    interfaceName,
-                    options,
-                });
-            }
-            else {
-                const [options] = args;
-                Validate_1.default({ options }).required().object(INetworkInfo_1.VINetworkOptionsLegacy);
-                yield this.postMessage({
-                    type: this.getMessage('set_network_manual'),
-                    options,
-                });
-            }
-        });
-    }
-    setDHCP(...args) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (args[0] === 'ethernet' || args[0] === 'wifi') {
-                const [networkInterface] = args;
-                Validate_1.default({ networkInterface }).required().string(INetworkInfo_1.VNetworkInterface);
-                yield this.postMessage({
-                    type: this.getMessage('set_network_dhcp'),
-                    networkInterface,
-                });
-            }
-            else {
-                const [interfaceName] = args;
-                Validate_1.default({ interfaceName }).required().string();
-                yield this.postMessage({
-                    type: this.getMessage('set_network_dhcp_v2'),
-                    interfaceName,
-                });
-            }
-        });
+    /** @internal */
+    async setManual(...args) {
+        if (typeof args[0] === 'string') {
+            const [interfaceName, options] = args;
+            (0, Validate_1.default)({ interfaceName }).required().string();
+            (0, Validate_1.default)({ options }).required().object(INetworkInfo_1.VINetworkOptions);
+            await this.postMessage({
+                type: this.getMessage('set_network_manual_v2'),
+                interfaceName,
+                options,
+            });
+        }
+        else {
+            const [options] = args;
+            (0, Validate_1.default)({ options }).required().object(INetworkInfo_1.VINetworkOptionsLegacy);
+            await this.postMessage({
+                type: this.getMessage('set_network_manual'),
+                options,
+            });
+        }
     }
-    disableInterface(interfaceName) {
-        return __awaiter(this, void 0, void 0, function* () {
-            Validate_1.default({ interfaceName }).required().string();
-            yield this.postMessage({
-                type: this.getMessage('disable_network_interface'),
+    /** @internal */
+    async setDHCP(...args) {
+        if (args[0] === 'ethernet' || args[0] === 'wifi') {
+            const [networkInterface] = args;
+            (0, Validate_1.default)({ networkInterface }).required().string(INetworkInfo_1.VNetworkInterface);
+            await this.postMessage({
+                type: this.getMessage('set_network_dhcp'),
+                networkInterface,
+            });
+        }
+        else {
+            const [interfaceName] = args;
+            (0, Validate_1.default)({ interfaceName }).required().string();
+            await this.postMessage({
+                type: this.getMessage('set_network_dhcp_v2'),
                 interfaceName,
             });
+        }
+    }
+    /**
+     * The `disableInterface()` disables a network interface.
+     *
+     * :::warning
+     *
+     * Don't use this method to disable Wi-Fi. Use [Wi-Fi API](./wifi) to enable/disable Wi-Fi.
+     *
+     * :::
+     *
+     * @param interfaceName The interface name which can be retrieved from the list of interfaces returned by listInterfaces()
+     *
+     * @since 4.13.0
+     */
+    async disableInterface(interfaceName) {
+        (0, Validate_1.default)({ interfaceName }).required().string();
+        await this.postMessage({
+            type: this.getMessage('disable_network_interface'),
+            interfaceName,
         });
     }
     getMessage(name) {