@signageos/front-applet 8.2.0 → 8.2.2

package/docs/sos_management/time.md

@@ -6,11 +6,23 @@ sidebar_position: 0
 
 The `sos.management.time` API groups together methods for working with the system time.
 
+<details>
+    <summary>Time Management Capabilities</summary>
+		| Capability | Description |
+		|:------------|:-------------|
+		| `SET_TIME` | If the device can set the system time. |
+		| `SET_TIMEZONE` | If the device can set the system timezone. |
+		| `GET_TIMEZONE` | If the device can get the system timezone. |
+		| `NTP_TIME` | If the device can set the NTP server and system timezone. |
+
+		If you want to check if the device supports those capabilities, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+</details>
+
 ## Methods
 
 ### get()
 
-The `get()` method returns currently set time info.
+The `get()` method returns the currently set time from the device.
 
 ```ts expandable
 get(): Promise<IGetTime>;
@@ -23,6 +35,21 @@ interface IGetTime {
 
 ```
 
+#### Return value
+
+A promise that resolves to the current time with timezone.
+
+#### Possible errors
+
+If the time cannot be retrieved.
+
+#### Example
+
+```ts
+const currentTime = await sos.management.time.get();
+console.log(`Current time is: ${currentTime.currentDate} in timezone ${currentTime.timezone}`);
+```
+
 <Separator />
 
 ### setManual(dateTime, timezone)
@@ -30,12 +57,10 @@ interface IGetTime {
 The `setManual()` method sets the system time and the system timezone and disables NTP server settings.
 
 :::warning Setting NTP server and timezone has side effects
-
 - **Tizen**: After calling this API, display Reboots!
-  Tizen has limited set of available timezones. Read more here.
-- **RaspberryPi**: After calling this API, RPi Reboots backend server which can take up to 60 seconds! During the reboot no JS API is
+  Tizen has a limited set of available timezones. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405381271314-Tizen-Timezones-Limited-List-for-NTP).
+- **RaspberryPi**: After calling this API, RPi Reboots the backend server, which can take up to 60 seconds! During the reboot, no JS API is
   available. **Always wait for Promise resolution.**
-
 :::
 
 ```ts expandable
@@ -62,6 +87,32 @@ interface DateTime {
 | `dateTime` | `DateTime` |  <div>Yes</div>  | The date and time to set. |
 | `timezone` | `string`   |  <div>Yes</div>  | The timezone to set.      |
 
+#### Return value
+
+A promise that resolves when the time is successfully set.
+
+#### Possible errors
+
+
+- If `dateTime` is not a valid Date or DateTime object.
+- If `timezone` is not a valid string.
+- If the time cannot be set.
+
+#### Example
+
+```ts
+// Set the system time to 2023-10-01T12:00:00 in Europe/Prague timezone
+const dateTime = {
+    year: 2023,
+    month: 10,
+    day: 1,
+    hour: 12,
+    minute: 0,
+    second: 0,
+}
+await sos.management.time.setManual(dateTime, 'Europe/Prague');
+```
+
 <Separator />
 
 ### setNTP()
@@ -69,12 +120,10 @@ interface DateTime {
 The `setNTP()` method sets the NTP server and the system timezone.
 
 :::warning Setting NTP server and timezone has side effects
-
 - **Tizen / WebOS**: After calling this API, display Reboots!
-  Tizen has limited set of available timezones. Read more here.
-- **RaspberryPi**: After calling this API, RPi Reboots backend server which can take up to 60 seconds! During the reboot no JS API is
+  Tizen has a limited set of available timezones. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405381271314-Tizen-Timezones-Limited-List-for-NTP).
+- **RaspberryPi**: After calling this API, RPi Reboots the backend server, which can take up to 60 seconds! During the reboot, no JS API is
   available. **Always wait for Promise resolution.**
-
 :::
 
 ```ts expandable
@@ -88,6 +137,24 @@ setNTP(ntpServer: string, timezone: string): Promise<void>;
 | `ntpServer` | `string` |  <div>Yes</div>  | The NTP server to set. |
 | `timezone`  | `string` |  <div>Yes</div>  | The timezone to set.   |
 
+#### Return value
+
+A promise that resolves when the NTP server and timezone are successfully set.
+
+#### Possible errors
+
+
+- If `ntpServer` is not a valid string.
+- If `timezone` is not a valid string.
+- If the NTP server and timezone cannot be set.
+
+#### Example
+
+```ts
+// Set the NTP server to `pool.ntp.org` and timezone to `Europe/Prague`
+await sos.management.time.setNTP('pool.ntp.org', 'Europe/Prague');
+```
+
 <Separator />
 
 ### ~set()~

package/docs/sos_management/wifi.md

@@ -4,40 +4,52 @@ sidebar_position: 0
 
 # wifi
 
-The `sos.management.wifi` API groups together methods for managing Wi-Fi.
-
-:::info
-
-Use `sos.management.supports('WIFI')` to check if the device supports managing Wi-Fi setup.
-
-:::
+The `sos.management.wifi` API groups together methods for managing Wi-Fi setup on the device.
 
 #### Internal state
 
 The `sos.management.wifi` API may be in 3 states:
 
 - `disabled` - Wi-Fi is disabled. This state is persistent between reboots.
-- `client` - Wi-Fi is in the client state, i.e. it is capable of connecting to a network, similarly to a phone or laptop. This state is persistent between reboots with all of its configuration.
-- `ap` - Wi-Fi is in access point state, i.e. it itself becomes a Wi-Fi network that others can connect to. This state is persistent between reboots and will be switched to DISABLED state.
+- `client` - Wi-Fi is in the client state, i.e., it is capable of connecting to a network, similarly to a phone or laptop. This state is persistent between reboots with all of its configuration.
+- `ap` - Wi-Fi is in access point state, i.e., it itself becomes a Wi-Fi network that others can connect to. This state persists between reboots and will be switched to the DISABLED state.
 
-You can use `enableClient()`/`disableClient()` method to enable
-or disable the `client` state or you can use `enableAP()`/`disableAP()` to enable or disable the `ap` state. It is **not** possible to go
+You can use `enableClient()`/`disable()` method to enable
+or disable the `client` state, or you can use `enableAP()`/`disableAP()` to turn on or off the `ap` state. It is **not** possible to go
 from `client` state to `ap` state directly, the state has to be `disabled` first.
 
+<details>
+    <summary>Wi-Fi Management Capabilities</summary>
+		| Capability | Description |
+		|:------------|:-------------|
+		| `WIFI` | If device supports Wi-Fi setup connection |
+		| `WIFI_SCAN` | If device supports Wi-Fi scanning |
+		| `WIFI_AP` | If device supports Wi-Fi Access Point setup |
+		| `WIFI_STRENGTH` | If device supports Wi-Fi signal strength measurement |
+		| `WIFI_COUNTRY` | If device supports Wi-Fi country code configuration |
+
+		If you want to check if the device supports those capabilities, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+</details>
+
 ## Methods
 
 ### connect()
 
-The `connect()` method connects the device to a specified network.
+The `connect()` method connects the device to a specified Wi-Fi network.
+
+:::danger
+On Tizen, make sure that the connection credentials are correct. If the device fails to connect, it will not retry automatically.
+Make sure that you have a backup script or a checking mechanism in place, which will allow you to recover from the situation if the connection fails.
+:::
 
 :::warning
-Connecting to a OPEN Wi-Fi network for Tizen and WebOS is different.
-- For Tizen, make sure that the `password` is an empty string (`''`) and in options you have selected `OPEN` as encryption type.
+Connecting to an OPEN Wi-Fi network for Tizen and WebOS is different.
+- For Tizen, make sure that the `password` is an empty string (`''`) and in the options you have selected `OPEN` as encryption type.
 - For WebOS, you can pass `undefined` as the `password` parameter.
 :::
 
 :::info
-Security type of Wi-Fi is mandatory for Tizen.
+The security type of Wi-Fi is mandatory for Tizen.
 :::
 
 ```ts expandable
@@ -54,33 +66,40 @@ type WifiEncryptionType = 'OPEN' | 'WEP' | 'WPA2' | 'WPA2_WPA_MIXED' | 'WPA3' |
 
 #### Params
 
-| Name       | Type                  | Required         | Description                                                                |
-|------------|-----------------------|------------------|----------------------------------------------------------------------------|
-| `ssid`     | `string`              |  <div>Yes</div>  | Name of the network, max. allowed length is 32 characters.                 |
-| `password` | `string`              |  <div>No</div>   | Password of the device, must be between 8 and 32 characters.               |
-| `options`  | `IWifiConnectOptions` |  <div>No</div>   | Additional options for the connection, such as `hidden` or `securityType`. |
+| Name                   | Type                  | Required         | Description                                                  |
+|------------------------|-----------------------|------------------|--------------------------------------------------------------|
+| `ssid`                 | `string`              |  <div>Yes</div>  | Name of the network, max. allowed length is 32 characters.   |
+| `password`             | `string`              |  <div>No</div>   | Password of the device, must be between 8 and 32 characters. |
+| `options`              | `IWifiConnectOptions` |  <div>No</div>   | Additional options for the connection.                       |
+| `options.hidden`       | `boolean`             |  <div>No</div>   | If the network is hidden, defaults to `false`.               |
+| `options.securityType` | `WifiEncryptionType`  |  <div>No</div>   | The security type of the network.                            |
 
 #### Return value
 
-A promise that resolves when the connection is established or if connection fails.
+A promise that resolves when the connection is established or if the connection fails.
 
 #### Possible errors
 
-Error If the Wi-Fi state is not in the `client` state.
+
+- Error If the Wi-Fi state is not in the `client` state.
+- Error If the `ssid` is not a string or is empty.
+- Error If the `password` is not a string or is empty (if required).
+- Error If the `options` is not an object or does not match the expected schema.
+- Error If the `securityType` is not one of the allowed values.
 
 #### Example
 
 ```ts
-// To connect on open Wi-Fi network ex. WebOS
+// To connect to an open Wi-Fi network, e.g., WebOS
 await sos.management.wifi.connect('MyOpenNetwork');
 
-// To connect on open Wi-Fi network with empty password (Tizen)
+// To connect an open Wi-Fi network with an empty password (Tizen)
 await sos.management.wifi.connect('MyOpenNetwork', '', { securityType: 'OPEN' });
 
 // If the network is hidden
 await sos.management.wifi.connect('MyOpenNetwork', undefined, { hidden: true });
 
-// To connect on encrypted Wi-Fi network with WPA2 security
+// To connect to an encrypted Wi-Fi network with WPA2 security
 await sos.management.wifi.connect('MyEncryptedNetwork', 'my-password', { securityType: 'WPA2' });
 ```
 
@@ -88,7 +107,7 @@ await sos.management.wifi.connect('MyEncryptedNetwork', 'my-password', { securit
 
 ### disable()
 
-The `disable()` method switches the Wi-Fi state to `disabled` and disconnect from connected Wi-Fi.
+The `disable()` method switches the Wi-Fi state to `disabled` and disconnects from the connected Wi-Fi.
 
 All previously configured networks will be forgotten.
 
@@ -96,28 +115,55 @@ All previously configured networks will be forgotten.
 disable(): Promise<void>;
 ```
 
+#### Return value
+
+A promise that resolves when the Wi-Fi is disabled.
+
+#### Possible errors
+
+Error If the Wi-Fi state is in the `client` or `ap` state.
+
+#### Example
+
+```ts
+await sos.management.wifi.disable();
+```
+
 <Separator />
 
 ### disconnect()
 
-The `disconnect()` method disconnects the device from Wi-Fi network.
+The `disconnect()` method disconnects the device from the Wi-Fi network.
+This method will not disable the Wi-Fi client; it will just disconnect from the currently connected network.
 
 ```ts expandable
 disconnect(): Promise<void>;
 ```
 
+#### Return value
+
+A promise that resolves when the device is disconnected from the network.
+
 #### Possible errors
 
 Error If the Wi-Fi state is not in the `client` state.
 
+#### Example
+
+```ts
+await sos.management.wifi.disconnect();
+```
+
 <Separator />
 
 ### enableAP()
 
-The `enableAP()` method switches the Wi-Fi state from `disabled` to `ap` state.
+Sets Wi-Fi to AP state, meaning the device will become a Wi-Fi network that other devices can connect to. It will run in WPA-Personal mode. As such, it requires an SSID (network name) and a password that different devices will use to connect.
 
-:::info
-Use `sos.management.supports('WIFI_AP')` to check if the device is able to be in the `ap` mode.
+:::note
+- This method is only available on the Linux platform.
+- It is not allowed to call this method when in the CLIENT state. You must first switch to the **DISABLED** state.
+- Before calling this method, make sure the device supports Wi-Fi AP via `sos.management.supports("WIFI_AP")`
 :::
 
 ```ts expandable
@@ -131,10 +177,20 @@ enableAP(ssid: string, password: string): Promise<void>;
 | `ssid`     | `string` |  <div>Yes</div>  | Name of the network, max. allowed length is 32 characters.   |
 | `password` | `string` |  <div>Yes</div>  | Password of the device, must be between 8 and 32 characters. |
 
+#### Return value
+
+A promise that resolves when the Wi-Fi is enabled in AP mode.
+
 #### Possible errors
 
 Error If the Wi-Fi state is in the `client` state.
 
+:::note[GitHub Example]
+
+- [ Example applet with Wi-Fi access point](https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/wifi-access-point)
+
+:::
+
 <Separator />
 
 ### enableClient()
@@ -145,6 +201,10 @@ The `enabledClient()` method switches the Wi-Fi state from `disabled` to `client
 enableClient(): Promise<void>;
 ```
 
+#### Return value
+
+A promise that resolves when the Wi-Fi is enabled in client mode.
+
 #### Possible errors
 
 Error If the Wi-Fi state is in the `ap` state.
@@ -153,7 +213,7 @@ Error If the Wi-Fi state is in the `ap` state.
 
 ### getConnectedTo()
 
-The `getConnectedTo()` method returns a network the device is currently connected to.
+The `getConnectedTo()` method returns the network the device is currently connected to.
 
 ```ts expandable
 getConnectedTo(): Promise<IWifiDevice | null>;
@@ -187,9 +247,9 @@ console.log(`Connected to SSID: ${connectedTo?.ssid}, Strength: ${connectedTo?.s
 
 ### getCountry()
 
-The `getCountry()` method returns the 2-letter country code to which Wi-Fi regulations the device adheres to. Different countries may
-have different regulations, when it comes to the Wi-Fi networks. Under normal circumstances, everything should work with default
-settings. However, if you experience any problems, you might want to try changing Wi-Fi country configuration to your country.
+The `getCountry()` method returns the 2-letter country code to which Wi-Fi regulations the device adheres. Different countries may
+have different regulations when it comes to the Wi-Fi networks. Under normal circumstances, everything should work with the default
+settings. However, if you experience any problems, you might want to try changing the Wi-Fi country configuration to your country.
 
 ```ts expandable
 getCountry(): Promise<string | null>;
@@ -197,12 +257,19 @@ getCountry(): Promise<string | null>;
 
 #### Return value
 
-The 2-letter country code from the ISO 3166 standard, or `null` if not set.
+A promise that resolves to the 2-letter country code from the ISO 3166 standard, or `null` if not set.
 
 #### Possible errors
 
 Error If the Wi-Fi state is not in the `client` state.
 
+#### Example
+
+```ts
+const countryCode = await sos.management.wifi.getCountry();
+console.log(`Current Wi-Fi country code is: ${countryCode}`); // e.g. 'US', 'CZ', etc.
+```
+
 <Separator />
 
 ### isAPEnabled()
@@ -215,7 +282,7 @@ isAPEnabled(): Promise<boolean>;
 
 #### Return value
 
-if AP mode is enabled.
+If AP mode is enabled.
 
 <Separator />
 
@@ -235,6 +302,15 @@ if client mode is enabled.
 
 Error If the Wi-Fi state is in the `ap` state.
 
+#### Example
+
+```ts
+const isClientEnabled = await sos.management.wifi.isClientEnabled();
+if (!isClientEnabled) {
+	await sos.management.wifi.enableClient();
+}
+```
+
 <Separator />
 
 ### on()
@@ -273,6 +349,25 @@ enum WifiEvent {
 
 ```
 
+#### Params
+
+| Name       | Type         | Required         | Description                                          |
+|------------|--------------|------------------|------------------------------------------------------|
+| `event`    | `WifiEvent`  |  <div>Yes</div>  | The event for which to set up the listener.          |
+| `listener` | `() => void` |  <div>Yes</div>  | The listener function to call when the event occurs. |
+
+#### Return value
+
+Resolves when the listener is set up.
+
+#### Example
+
+```ts
+sos.management.wifi.on(WifiEvent.CLIENT_ENABLED, () => {
+  console.log('Wi-Fi client is enabled');
+});
+```
+
 <Separator />
 
 ### once()
@@ -311,11 +406,30 @@ enum WifiEvent {
 
 ```
 
+#### Params
+
+| Name       | Type         | Required         | Description                                          |
+|------------|--------------|------------------|------------------------------------------------------|
+| `event`    | `WifiEvent`  |  <div>Yes</div>  | The event for which to set up the listener.          |
+| `listener` | `() => void` |  <div>Yes</div>  | The listener function to call when the event occurs. |
+
+#### Return value
+
+Resolves when the listener is set up.
+
+#### Example
+
+```ts
+sos.management.wifi.once(WifiEvent.CLIENT_CONNECTED, () => {
+	console.log('Wi-Fi client is connected');
+});
+```
+
 <Separator />
 
 ### removeAllListeners()
 
-The `removeAllListeners()` method removes all listeners for a specified event or for all events.
+The `removeAllListeners()` method removes all listeners for a specified event or all events.
 
 ```ts expandable
 removeAllListeners(event?: WifiEvent): void;
@@ -349,6 +463,16 @@ enum WifiEvent {
 
 ```
 
+#### Params
+
+| Name    | Type        | Required        | Description                                                                                                  |
+|---------|-------------|-----------------|--------------------------------------------------------------------------------------------------------------|
+| `event` | `WifiEvent` |  <div>No</div>  | The event for which to remove all listeners. If not specified, all listeners for all events will be removed. |
+
+#### Return value
+
+Resolves when all listeners are removed.
+
 <Separator />
 
 ### removeListener()
@@ -387,19 +511,29 @@ enum WifiEvent {
 
 ```
 
+#### Params
+
+| Name       | Type         | Required         | Description                                 |
+|------------|--------------|------------------|---------------------------------------------|
+| `event`    | `WifiEvent`  |  <div>Yes</div>  | The event for which to remove the listener. |
+| `listener` | `() => void` |  <div>Yes</div>  | The listener function to remove.            |
+
+#### Return value
+
+Resolves when the listener is removed.
+
 <Separator />
 
 ### scanDevices()
 
 The `scanDevices()` method initializes a new network scan and available networks.
 
-:::info
-Use `sos.management.supports('WIFI_SCAN')` to check if the device supports scanning for devices.
-:::
-
 ```ts expandable
 scanDevices(): Promise<IScannedDevice[]>;
 // show-more
+/**
+ * Interface representing a scanned Wi-Fi device.
+ */
 interface IScannedDevice {
     ssid: string;
     encrypted: boolean;
@@ -407,17 +541,34 @@ interface IScannedDevice {
 
 ```
 
+#### Return value
+
+A promise that resolves to an array of scanned devices.
+
 #### Possible errors
 
 Error If the Wi-Fi state is not in the `client` state.
 
+#### Example
+
+```ts
+const scannedDevices = await sos.management.wifi.scanDevices();
+scannedDevices.forEach(device => {
+	console.log(`Found Wi-Fi network: ${device.ssid}, Encrypted: ${device.encrypted}`);
+});
+```
+
 <Separator />
 
 ### setCountry()
 
-The `getCountry()` method sets the 2-letter country code for the Wi-Fi settings. Different countries may
-have different regulations, when it comes to the Wi-Fi networks. Under normal circumstances, everything should work with default
-settings. However, if you experience any problems, you might want to try changing Wi-Fi country configuration to your country.
+The `setCountry()` method sets the 2-letter country code for the Wi-Fi settings. Different countries may
+have different regulations when it comes to the Wi-Fi networks. Under normal circumstances, everything should work with the default
+settings. However, if you experience any problems, you might want to try changing the Wi-Fi country configuration to your country.
+
+:::note
+This method is only available on the Linux platform.
+:::
 
 ```ts expandable
 setCountry(countryCode: string): Promise<void>;
@@ -429,6 +580,17 @@ setCountry(countryCode: string): Promise<void>;
 |---------------|----------|------------------|---------------------------------------------------|
 | `countryCode` | `string` |  <div>Yes</div>  | 2-letter country code from the ISO 3166 standard. |
 
+#### Return value
+
+A promise that resolves when the country code is set.
+
 #### Possible errors
 
-Error If the Wi-Fi state is not in the `client` state.
+Error If the Wi-Fi state is not in the `client` state.
+
+#### Example
+
+```ts
+// To set the country code to the United States
+await sos.management.wifi.setCountry('US');
+```

package/es6/FrontApplet/Browser/Browser.d.ts

@@ -4,20 +4,28 @@ import IOpenLinkOptions, { IDeprecatedOpenLinkOptions } from './IOpenLinkOptions
 import { IBrowserMessage } from './messages';
 import IBrowser from './IBrowser';
 /**
- * There are several use-cases when you need to open a web browser on a touch-enabled device (also known as a tablet). For these cases, you can use a custom web browser we built. Default URL can be opened and even the whitelisting/blacklisting of certain domains is supported.
+ * There are several use cases when you need to open a web browser on a touch-enabled device (also known as a tablet). For these cases, you can use a custom web browser we built. Default URL can be opened and even the whitelisting/blacklisting of certain domains is supported.
  *
  * :::info
  *
  * **This API is currently available on:**
  * - Android devices with Android 5+ (Philips, Benq, Sharp, generic Android device)
  *
- * **With some limitation you can use this API also on**
+ * **With some limitations, you can also use this API on**
  * - Samsung Tizen (SSSP 4 and above); where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - LG webOS (webOS 3.0 and above); where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - Linux (Fedora, Ubuntu), Raspberry Pi, NEC Compute Module; where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - BrightSign; where the website is just in fullscreen without an address bar or theme options (headless mode)
- *
  * :::
+ *
+ * <details>
+ *     <summary>Device Browser Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `BROWSER` | If device can open browser with custom URL |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.display.supports()`](https://developers.signageos.io/sdk/sos/display#supports).
+ * </details>
  */
 export default class Browser implements IBrowser {
     private readonly exchange;

package/es6/FrontApplet/Browser/Browser.js

@@ -8,20 +8,28 @@ const Validate_1 = __importDefault(require("../Validate/Validate"));
 const events_2 = require("./events");
 const IOpenLinkOptions_1 = require("./IOpenLinkOptions");
 /**
- * There are several use-cases when you need to open a web browser on a touch-enabled device (also known as a tablet). For these cases, you can use a custom web browser we built. Default URL can be opened and even the whitelisting/blacklisting of certain domains is supported.
+ * There are several use cases when you need to open a web browser on a touch-enabled device (also known as a tablet). For these cases, you can use a custom web browser we built. Default URL can be opened and even the whitelisting/blacklisting of certain domains is supported.
  *
  * :::info
  *
  * **This API is currently available on:**
  * - Android devices with Android 5+ (Philips, Benq, Sharp, generic Android device)
  *
- * **With some limitation you can use this API also on**
+ * **With some limitations, you can also use this API on**
  * - Samsung Tizen (SSSP 4 and above); where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - LG webOS (webOS 3.0 and above); where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - Linux (Fedora, Ubuntu), Raspberry Pi, NEC Compute Module; where the website is just in fullscreen without an address bar or theme options (headless mode)
  * - BrightSign; where the website is just in fullscreen without an address bar or theme options (headless mode)
- *
  * :::
+ *
+ * <details>
+ *     <summary>Device Browser Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `BROWSER` | If device can open browser with custom URL |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.display.supports()`](https://developers.signageos.io/sdk/sos/display#supports).
+ * </details>
  */
 class Browser {
     exchange;

package/es6/FrontApplet/Browser/Browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"Browser.js","sourceRoot":"","sources":["../../../src/FrontApplet/Browser/Browser.ts"],"names":[],"mappings":";;;;;AAAA,mCAAsC;AAEtC,oEAA4C;AAC5C,qCAA8D;AAC9D,yDAAqG;AAIrG;;;;;;;;;;;;;;;GAeG;AACH,MAAqB,OAAO;IAIE;IAHZ,MAAM,GAAiB,IAAI,qBAAY,EAAE,CAAC;IAE3D,gBAAgB;IAChB,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACI,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,UAA4B,EAAE;QAC5D,IAAA,kBAAQ,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACnC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,oCAAiB,CAAC,CAAC;QAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QAClD,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,GAAG;YACH,GAAG,OAAO;YACV,YAAY;YACZ,IAAI,EAAE,MAAM;SACZ,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,KAAK;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,IAAI,EAAE,OAAO;SACb,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,QAAqC;QACnD,IAAA,kBAAQ,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,kBAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC,CAAC;IACH,CAAC;IAED,gBAAgB;IACT,iBAAiB,CAAC,IAAqB;QAC7C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC;gBAC7C,MAAM,KAAK,GAAe;oBACzB,IAAI,EAAE,kBAAS,CAAC,KAAK;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAqB;iBAClC,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,UAAsC,EAAE;QAC1E,OAAO,CAAC,IAAI,CAAC,kHAAkH,CAAC,CAAC;QAEjI,IAAA,kBAAQ,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACnC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAE1C,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,GAAG;YACH,GAAG,OAAO;YACV,YAAY,EAAE,KAAK;YACnB,IAAI,EAAE,WAAW;SACjB,CAAC,CAAC;IACJ,CAAC;CACD;AA1HD,0BA0HC"}
+{"version":3,"file":"Browser.js","sourceRoot":"","sources":["../../../src/FrontApplet/Browser/Browser.ts"],"names":[],"mappings":";;;;;AAAA,mCAAsC;AAEtC,oEAA4C;AAC5C,qCAA8D;AAC9D,yDAAqG;AAIrG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAqB,OAAO;IAIE;IAHZ,MAAM,GAAiB,IAAI,qBAAY,EAAE,CAAC;IAE3D,gBAAgB;IAChB,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACI,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,UAA4B,EAAE;QAC5D,IAAA,kBAAQ,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACnC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,oCAAiB,CAAC,CAAC;QAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QAClD,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,GAAG;YACH,GAAG,OAAO;YACV,YAAY;YACZ,IAAI,EAAE,MAAM;SACZ,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,KAAK;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,IAAI,EAAE,OAAO;SACb,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,QAAqC;QACnD,IAAA,kBAAQ,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,kBAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC,CAAC;IACH,CAAC;IAED,gBAAgB;IACT,iBAAiB,CAAC,IAAqB;QAC7C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC;gBAC7C,MAAM,KAAK,GAAe;oBACzB,IAAI,EAAE,kBAAS,CAAC,KAAK;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAqB;iBAClC,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,UAAsC,EAAE;QAC1E,OAAO,CAAC,IAAI,CAAC,kHAAkH,CAAC,CAAC;QAEjI,IAAA,kBAAQ,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;QACnC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAE1C,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,GAAG;YACH,GAAG,OAAO;YACV,YAAY,EAAE,KAAK;YACnB,IAAI,EAAE,WAAW;SACjB,CAAC,CAAC;IACJ,CAAC;CACD;AA1HD,0BA0HC"}

package/es6/FrontApplet/Command/Command.js

@@ -23,6 +23,7 @@ class Command {
         this.messagePrefix = messagePrefix;
         this.postMessage = postMessage;
         this.eventEmitter = new events_1.EventEmitter();
+        this.eventEmitter.setMaxListeners(40);
     }
     /**
      * The `dispatch()` method dispatches a new log record to the signageOS.

package/es6/FrontApplet/Command/Command.js.map

@@ -1 +1 @@
-{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../src/FrontApplet/Command/Command.ts"],"names":[],"mappings":";;;;;AAAA,mCAAsC;AAItC,qFAA6D;AAC7D,qEAA6C;AAC7C,iFAAyD;AACzD,oEAA4C;AAG5C;;;;GAIG;AACH,MAAqB,OAAO;IAOlB;IACA;IAPF,MAAM,CAAC,cAAc,GAAW,SAAS,CAAC;IAEzC,YAAY,CAAe;IAEnC,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA+B;QAD/B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAoB;QAEvC,IAAI,CAAC,YAAY,GAAG,IAAI,qBAAY,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,KAAK,CAAC,QAAQ,CAA4B,OAAiB;QACjE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACjC,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,SAAS,CAAC,QAA0C;QAC1D,IAAA,kBAAQ,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB;IACT,iBAAiB,CAAC,IAAqC;QAC7D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBACzC,MAAM,YAAY,GAAG;oBACpB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO;iBACrB,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gBAChD,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,OAAO,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACvE,CAAC;IAEO,iBAAiB,CAAC,IAAY;QACrC,MAAM,KAAK,GAAG,sBAAsB,CAAC;QAErC,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC;aAChB,QAAQ,CACR,IAAI,4BAAkB,CAAC;YACtB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,mCAAmC;YAC5C,IAAI,EAAE,oBAAU,CAAC,sBAAsB;YACvC,UAAU,EAAE,0BAAgB,CAAC,sBAAsB;SACnD,CAAC,CACF;aACA,QAAQ,EAAE;aACV,MAAM,EAAE;aACR,WAAW,CAAC,KAAK,CAAC,CAAC;QAErB,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC;aAChB,QAAQ,CACR,IAAI,4BAAkB,CAAC;YACtB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,qCAAqC;YAC9C,IAAI,EAAE,oBAAU,CAAC,wBAAwB;SACzC,CAAC,CACF;aACA,SAAS,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;;AAzGF,0BA0GC"}
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../src/FrontApplet/Command/Command.ts"],"names":[],"mappings":";;;;;AAAA,mCAAsC;AAItC,qFAA6D;AAC7D,qEAA6C;AAC7C,iFAAyD;AACzD,oEAA4C;AAG5C;;;;GAIG;AACH,MAAqB,OAAO;IAOlB;IACA;IAPF,MAAM,CAAC,cAAc,GAAW,SAAS,CAAC;IAEzC,YAAY,CAAe;IAEnC,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA+B;QAD/B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAoB;QAEvC,IAAI,CAAC,YAAY,GAAG,IAAI,qBAAY,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,KAAK,CAAC,QAAQ,CAA4B,OAAiB;QACjE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACjC,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,SAAS,CAAC,QAA0C;QAC1D,IAAA,kBAAQ,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB;IACT,iBAAiB,CAAC,IAAqC;QAC7D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBACzC,MAAM,YAAY,GAAG;oBACpB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO;iBACrB,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gBAChD,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,OAAO,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACvE,CAAC;IAEO,iBAAiB,CAAC,IAAY;QACrC,MAAM,KAAK,GAAG,sBAAsB,CAAC;QAErC,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC;aAChB,QAAQ,CACR,IAAI,4BAAkB,CAAC;YACtB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,mCAAmC;YAC5C,IAAI,EAAE,oBAAU,CAAC,sBAAsB;YACvC,UAAU,EAAE,0BAAgB,CAAC,sBAAsB;SACnD,CAAC,CACF;aACA,QAAQ,EAAE;aACV,MAAM,EAAE;aACR,WAAW,CAAC,KAAK,CAAC,CAAC;QAErB,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC;aAChB,QAAQ,CACR,IAAI,4BAAkB,CAAC;YACtB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,qCAAqC;YAC9C,IAAI,EAAE,oBAAU,CAAC,wBAAwB;SACzC,CAAC,CACF;aACA,SAAS,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;;AA1GF,0BA2GC"}