@signageos/front-applet 8.2.1 → 8.2.4

package/es6/FrontApplet/Input/Input.js

@@ -58,7 +58,7 @@ class Input {
     /** @internal */
     handleMessageData(data) {
         switch (data.type) {
-            case this.getMessage('keyup'):
+            case this.getMessage('keyup'): {
                 const keyupEvent = {
                     type: 'keyup',
                     keyCode: data.keyCode,
@@ -66,6 +66,7 @@ class Input {
                 };
                 this.emitKeyUpEvent(keyupEvent);
                 break;
+            }
             default:
         }
     }

package/es6/FrontApplet/Input/Input.js.map

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

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

@@ -2,6 +2,15 @@ import IPostMessage from '../../IPostMessage';
 import IApp, { AppType } from './IApp';
 /**
  * The `sos.management.app` API groups together methods for managing the signageOS application installed on the system.
+ *
+ * <details>
+ *     <summary>App Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `APP_UPGRADE` | If the signageOS application can upgrade itself to a specific version |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 export default class App implements IApp {
     private messagePrefix;
@@ -9,38 +18,47 @@ export default class App implements IApp {
     /** @internal */
     constructor(messagePrefix: string, postMessage: IPostMessage<any>);
     /**
-     * The `getType()` method returns type of the platform the application is running on.
+     * The `getType()` method returns the type of the platform the application is running on.
      *
      * :::info
-     *
-     * If you need to get specific Android brand or Raspberry Pi model, use the `sos.management.firmware.getType()`.
-     *
+     * - If you need to get a specific Android brand or Raspberry Pi model, use the `sos.management.firmware.getType()`.
+     * - `default` type is always Emulator.
      * :::
      *
+     * @returns {Promise<AppType>} Resolves to the type of the application platform.
      * @since 4.0.0
+     *
+     * @example
+     * const appType = await sos.management.app.getType();
+     * console.log(appType); // tizen, linux, webos, etc.
      */
     getType(): Promise<AppType>;
     /**
-     * The `getVersion()` method returns version of the application currently running.
-     *
-     * :::info
-     *
-     * This API is only available for Applets deployed via Timing from Box or REST API.
-     *
-     * :::
+     * The `getVersion()` method returns the version of the Core App that is currently running on the device.
      *
+     * @returns {Promise<string>} Resolves to the version of the Core application.
      * @since 4.0.0
+     *
+     * @example
+     * const version = await sos.management.app.getVersion();
+     * console.log(`Current application version is: ${version}`); // e.g. '4.0.0', '5.2.1', etc.
      */
     getVersion(): Promise<string>;
     /**
-     * The `upgrade(version, baseUrl?)` method upgrades the signageOS application using version and baseUrl. Platform users can install general
-     * application version directly with passing just version number. Optionally, the baseUrl can be passed as argument to specify server
+     * The `upgrade(version, baseUrl?)` method upgrades the signageOS application using version and baseUrl. Platform users can install the general
+     * application version directly with passing just the version number. Optionally, the baseUrl can be passed as an argument to specify the server
      * where the application files are accessible.
      *
      * @param version The version of the application being installed.
      * @param [baseUrl='https://2.signageos.io'] Optional server URL where application files are located.
-     *
+     * @returns {Promise<void>} A promise that resolves when the upgrade starts.
+     * @throws {Error} If the upgrade fails.
      * @since 4.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/app-upgrade | How to upgrade application via applets}
+     *
+     * @example
+     * await sos.management.app.upgrade('4.0.0', 'https://2.signageos.io')
      */
     upgrade(version: string, baseUrl?: string): Promise<void>;
     /**
@@ -55,8 +73,8 @@ export default class App implements IApp {
      */
     upgrade(baseUrl: string, version: string): Promise<void>;
     /**
-     * The `upgrade(appUri)` method upgrades the signageOS application with provided appUri. Open users can upgrade app passing FQN
-     * uri where the application main file is located.
+     * The `upgrade(appUri)` method upgrades the signageOS application with the provided `appUri`. Open users can upgrade the app passing FQN
+     * URI where the application's main file is located.
      *
      * This file type/extension differs for every platform. E.g.:
      * - SSSP: http://example.com/apps/sssp_config.xml or http://example.com/apps/ApplicationName.zip
@@ -66,10 +84,28 @@ export default class App implements IApp {
      * - Brightsign: http://example.com/apps/ApplicationName.zip
      * - Linux: http://example.com/apps/ApplicationName.apk
      * - Android: http://example.com/apps/ApplicationName.apk
+     * - ChromeOS: Not supported
      *
-     * @param appUri FQN uri where the application main file is located.
+     * :::tip
+     * Check our latest versions in our [changelogs](https://docs.signageos.io/hc/en-us/sections/4409161443730-Core-Apps).
+     * :::
      *
+     * @param appUri FQN uri where the application's main file is located.
+     * @returns {Promise<void>} A promise that resolves when the upgrade starts.
+     * @throws {Error} If the upgrade fails.
      * @since 4.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/app-upgrade | How to upgrade application via applets}
+     *
+     * @example
+     * // Upgrade the application to a specific version
+     * await sos.management.app.upgrade('http://example.com/apps/ApplicationName.zip')
+     *  .then(() => {
+     * 		console.log('Application upgrade started successfully.');
+     *  })
+     *  .catch((error) => {
+     * 		console.error('Failed to start application upgrade:', error);
+     *  });
      */
     upgrade(appUri: string): Promise<void>;
     private getMessage;

package/es6/FrontApplet/Management/App/App.js

@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const UpgradeHelper_1 = require("../helpers/UpgradeHelper");
 /**
  * The `sos.management.app` API groups together methods for managing the signageOS application installed on the system.
+ *
+ * <details>
+ *     <summary>App Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `APP_UPGRADE` | If the signageOS application can upgrade itself to a specific version |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 class App {
     messagePrefix;
@@ -13,15 +22,19 @@ class App {
         this.postMessage = postMessage;
     }
     /**
-     * The `getType()` method returns type of the platform the application is running on.
+     * The `getType()` method returns the type of the platform the application is running on.
      *
      * :::info
-     *
-     * If you need to get specific Android brand or Raspberry Pi model, use the `sos.management.firmware.getType()`.
-     *
+     * - If you need to get a specific Android brand or Raspberry Pi model, use the `sos.management.firmware.getType()`.
+     * - `default` type is always Emulator.
      * :::
      *
+     * @returns {Promise<AppType>} Resolves to the type of the application platform.
      * @since 4.0.0
+     *
+     * @example
+     * const appType = await sos.management.app.getType();
+     * console.log(appType); // tizen, linux, webos, etc.
      */
     async getType() {
         const { applicationType } = await this.postMessage({
@@ -29,17 +42,15 @@ class App {
         });
         return applicationType;
     }
-    // TODO: unify box/cloud control
     /**
-     * The `getVersion()` method returns version of the application currently running.
-     *
-     * :::info
-     *
-     * This API is only available for Applets deployed via Timing from Box or REST API.
-     *
-     * :::
+     * The `getVersion()` method returns the version of the Core App that is currently running on the device.
      *
+     * @returns {Promise<string>} Resolves to the version of the Core application.
      * @since 4.0.0
+     *
+     * @example
+     * const version = await sos.management.app.getVersion();
+     * console.log(`Current application version is: ${version}`); // e.g. '4.0.0', '5.2.1', etc.
      */
     async getVersion() {
         const { applicationVersion } = await this.postMessage({

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

@@ -1 +1 @@
-{"version":3,"file":"App.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/App/App.ts"],"names":[],"mappings":";;AACA,4DAAiE;AAGjE;;GAEG;AACH,MAAqB,GAAG;IAGd;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;OAUG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,eAAe,CAAC;IACxB,CAAC;IAED,gCAAgC;IAChC;;;;;;;;;;OAUG;IACI,KAAK,CAAC,UAAU;QACtB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC;SAChD,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC;IAC3B,CAAC;IA6CD,gBAAgB;IACT,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAa;QAC/C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAA,qCAAqB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YACpC,OAAO;YACP,OAAO;YACP,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAvGD,sBAuGC"}
+{"version":3,"file":"App.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/App/App.ts"],"names":[],"mappings":";;AACA,4DAAiE;AAGjE;;;;;;;;;;;GAWG;AACH,MAAqB,GAAG;IAGd;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,eAAe,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,UAAU;QACtB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC;SAChD,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC;IAC3B,CAAC;IAqED,gBAAgB;IACT,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAa;QAC/C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAA,qCAAqB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YACpC,OAAO;YACP,OAAO;YACP,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAjID,sBAiIC"}

package/es6/FrontApplet/Management/App/IApp.d.ts

@@ -1,4 +1,7 @@
 import { AnyString } from '../../../utils/types';
+/**
+ * All available app types
+ */
 export type AppType = 'android' | 'brightsign' | 'default' | 'linux' | 'sssp' | 'tizen' | 'webos' | 'windows' | 'chromeos' | AnyString;
 export default interface IApp {
     getType(): Promise<AppType>;

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

@@ -2,6 +2,16 @@ import IPostMessage from '../../IPostMessage';
 import IAudio from './IAudio';
 /**
  * The `sos.management.audio` API groups methods for managing audio settings.
+ *
+ * <details>
+ *     <summary>Volume Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `SET_VOLUME` | If device can set volume level |
+ * 		| `GET_VOLUME` | If device can get current volume level |
+ *
+ * 		If you want to check if the device supports those capabilities, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 export default class Audio implements IAudio {
     private messagePrefix;
@@ -9,17 +19,28 @@ export default class Audio implements IAudio {
     /** @internal */
     constructor(messagePrefix: string, postMessage: IPostMessage<any>);
     /**
-     * The `getVolume()` method returns current volume level of the device.
+     * The `getVolume()` method returns the current volume level of the device.
      *
+     * @returns {Promise<number>} A promise that resolves to the current volume level, which is a value between 0 and 100.
      * @since 2.0.0
+     *
+     * @example
+     * const currentVolume = await sos.management.audio.getVolume();
+     * console.log(`Current volume level is: ${currentVolume}`); // e.g. 75
      */
     getVolume(): Promise<number>;
     /**
-     * The `getVolume()` method set the volume level of the device.
+     * The `setVolume()` method sets the volume level of the device.
      *
      * @param volume Value between 0 and 100.
-     *
+     * @returns {Promise<void>} A promise that resolves when the volume is set.
+     * @throws {Error} If the volume is not a number or is outside the range of 0 to 100.
      * @since 2.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/volume | Example applet with setting volume}
+     *
+     * @example
+     * await sos.management.audio.setVolume(50);
      */
     setVolume(volume: number): Promise<void>;
     private getMessage;

package/es6/FrontApplet/Management/Audio/Audio.js

@@ -6,6 +6,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const Validate_1 = __importDefault(require("../../Validate/Validate"));
 /**
  * The `sos.management.audio` API groups methods for managing audio settings.
+ *
+ * <details>
+ *     <summary>Volume Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `SET_VOLUME` | If device can set volume level |
+ * 		| `GET_VOLUME` | If device can get current volume level |
+ *
+ * 		If you want to check if the device supports those capabilities, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 class Audio {
     messagePrefix;
@@ -16,9 +26,14 @@ class Audio {
         this.postMessage = postMessage;
     }
     /**
-     * The `getVolume()` method returns current volume level of the device.
+     * The `getVolume()` method returns the current volume level of the device.
      *
+     * @returns {Promise<number>} A promise that resolves to the current volume level, which is a value between 0 and 100.
      * @since 2.0.0
+     *
+     * @example
+     * const currentVolume = await sos.management.audio.getVolume();
+     * console.log(`Current volume level is: ${currentVolume}`); // e.g. 75
      */
     async getVolume() {
         const { volume } = await this.postMessage({
@@ -27,11 +42,17 @@ class Audio {
         return volume;
     }
     /**
-     * The `getVolume()` method set the volume level of the device.
+     * The `setVolume()` method sets the volume level of the device.
      *
      * @param volume Value between 0 and 100.
-     *
+     * @returns {Promise<void>} A promise that resolves when the volume is set.
+     * @throws {Error} If the volume is not a number or is outside the range of 0 to 100.
      * @since 2.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/volume | Example applet with setting volume}
+     *
+     * @example
+     * await sos.management.audio.setVolume(50);
      */
     async setVolume(volume) {
         (0, Validate_1.default)({ volume }).required().number().min(0).max(100);

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

@@ -1 +1 @@
-{"version":3,"file":"Audio.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Audio/Audio.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;GAEG;AACH,MAAqB,KAAK;IAGhB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,SAAS;QACrB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;SACnC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,MAAc;QACpC,IAAA,kBAAQ,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YACnC,MAAM;SACN,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AArCD,wBAqCC"}
+{"version":3,"file":"Audio.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Audio/Audio.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;;;;;;;;;;;GAYG;AACH,MAAqB,KAAK;IAGhB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;OASG;IACI,KAAK,CAAC,SAAS;QACrB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;SACnC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,SAAS,CAAC,MAAc;QACpC,IAAA,kBAAQ,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YACnC,MAAM;SACN,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAhDD,wBAgDC"}

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

@@ -1,14 +1,60 @@
 import IPostMessage from '../../IPostMessage';
 import IAutoRecovery, { IAutoRecoveryConfiguration } from './IAutoRecovery';
-/** @todo */
+/**
+ * The `sos.management.autoRecovery` API provides methods for managing the auto-recovery feature of the signageOS app.
+ *
+ * The Auto Recovery feature is designed to automatically recover the signageOS app in case of a crash or unexpected shutdown
+ * or switching input to a different value, e.g., HDMI.
+ *
+ * <details>
+ *     <summary>Auto Recovery Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `AUTO_RECOVERY` | If the device can enable or disable the auto recovery function. |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
+ */
 export default class AutoRecovery implements IAutoRecovery {
     private messagePrefix;
     private postMessage;
     /** @internal */
     constructor(messagePrefix: string, postMessage: IPostMessage<IAutoRecoveryConfiguration>);
-    /** @internal */
+    /**
+     * The `get()` method retrieves the current auto-recovery configuration.
+     *
+     * @returns {Promise<IAutoRecoveryConfiguration>} A promise that resolves to the current auto-recovery configuration.
+     * @since 5.0.0
+     *
+     * @example
+     * const autoRecoveryConfig = await sos.management.autoRecovery.get();
+     * if (autoRecoveryConfig.enabled) {
+     *   console.log(`Auto-recovery is enabled with a healthcheck interval of ${autoRecoveryConfig.healthcheckIntervalMs} ms.`);
+     * }
+     */
     get(): Promise<IAutoRecoveryConfiguration>;
-    /** @internal */
+    /**
+     * The `set()` method allows to enable or disable the auto-recovery feature and configure its settings.
+     *
+     * :::note
+     * The configuration object has different properties depending on if enabled is true or false.
+     * :::
+     *
+     * @param configuration The configuration object for auto-recovery settings.
+     * @param configuration.enabled A boolean to set auto-recovery to enabled or disabled state.
+     * @param configuration.autoEnableTimeoutMs The timeout in milliseconds after which the auto-recovery will be automatically enabled if it was disabled.
+     * @param configuration.healthcheckIntervalMs The interval in milliseconds for the health check if application is running in foreground.
+     * @returns {Promise<void>} A promise that resolves when the auto-recovery settings are successfully set.
+     * @throws {Error} If the configuration is invalid.
+     * @since 5.0.0
+     *
+     * @example
+     * // Enable auto-recovery with a healthcheck interval of 5000 ms
+     * await sos.management.autoRecovery.set({
+     * 	enabled: true,
+     * 	healthcheckIntervalMs: 5000,
+     * });
+     */
     set(configuration: IAutoRecoveryConfiguration): Promise<void>;
     private getMessage;
 }

package/es6/FrontApplet/Management/AutoRecovery/AutoRecovery.js

@@ -2,7 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const lodash_1 = require("lodash");
 const IAutoRecovery_1 = require("./IAutoRecovery");
-/** @todo */
+/**
+ * The `sos.management.autoRecovery` API provides methods for managing the auto-recovery feature of the signageOS app.
+ *
+ * The Auto Recovery feature is designed to automatically recover the signageOS app in case of a crash or unexpected shutdown
+ * or switching input to a different value, e.g., HDMI.
+ *
+ * <details>
+ *     <summary>Auto Recovery Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `AUTO_RECOVERY` | If the device can enable or disable the auto recovery function. |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
+ */
 class AutoRecovery {
     messagePrefix;
     postMessage;
@@ -11,7 +25,18 @@ class AutoRecovery {
         this.messagePrefix = messagePrefix;
         this.postMessage = postMessage;
     }
-    /** @internal */
+    /**
+     * The `get()` method retrieves the current auto-recovery configuration.
+     *
+     * @returns {Promise<IAutoRecoveryConfiguration>} A promise that resolves to the current auto-recovery configuration.
+     * @since 5.0.0
+     *
+     * @example
+     * const autoRecoveryConfig = await sos.management.autoRecovery.get();
+     * if (autoRecoveryConfig.enabled) {
+     *   console.log(`Auto-recovery is enabled with a healthcheck interval of ${autoRecoveryConfig.healthcheckIntervalMs} ms.`);
+     * }
+     */
     async get() {
         const settings = await this.postMessage({ type: this.getMessage('get_auto_recovery') });
         if (!settings.enabled) {
@@ -19,7 +44,28 @@ class AutoRecovery {
         }
         return (0, lodash_1.pick)(settings, ['enabled', 'healthcheckIntervalMs']);
     }
-    /** @internal */
+    /**
+     * The `set()` method allows to enable or disable the auto-recovery feature and configure its settings.
+     *
+     * :::note
+     * The configuration object has different properties depending on if enabled is true or false.
+     * :::
+     *
+     * @param configuration The configuration object for auto-recovery settings.
+     * @param configuration.enabled A boolean to set auto-recovery to enabled or disabled state.
+     * @param configuration.autoEnableTimeoutMs The timeout in milliseconds after which the auto-recovery will be automatically enabled if it was disabled.
+     * @param configuration.healthcheckIntervalMs The interval in milliseconds for the health check if application is running in foreground.
+     * @returns {Promise<void>} A promise that resolves when the auto-recovery settings are successfully set.
+     * @throws {Error} If the configuration is invalid.
+     * @since 5.0.0
+     *
+     * @example
+     * // Enable auto-recovery with a healthcheck interval of 5000 ms
+     * await sos.management.autoRecovery.set({
+     * 	enabled: true,
+     * 	healthcheckIntervalMs: 5000,
+     * });
+     */
     async set(configuration) {
         (0, IAutoRecovery_1.validateAutoRecoveryConfiguration)(configuration);
         await this.postMessage({ type: this.getMessage('set_auto_recovery'), ...configuration });

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

@@ -1 +1 @@
-{"version":3,"file":"AutoRecovery.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/AutoRecovery/AutoRecovery.ts"],"names":[],"mappings":";;AAAA,mCAA8B;AAE9B,mDAA+G;AAE/G,YAAY;AACZ,MAAqB,YAAY;IAGvB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAAqD;QADrD,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAA0C;IAC3D,CAAC;IAEJ,gBAAgB;IACT,KAAK,CAAC,GAAG;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,IAAA,aAAI,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAA,aAAI,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,gBAAgB;IACT,KAAK,CAAC,GAAG,CAAC,aAAyC;QACzD,IAAA,iDAAiC,EAAC,aAAa,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAzBD,+BAyBC"}
+{"version":3,"file":"AutoRecovery.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/AutoRecovery/AutoRecovery.ts"],"names":[],"mappings":";;AAAA,mCAA8B;AAE9B,mDAA+G;AAE/G;;;;;;;;;;;;;;GAcG;AACH,MAAqB,YAAY;IAGvB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAAqD;QADrD,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAA0C;IAC3D,CAAC;IAEJ;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,GAAG;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,IAAA,aAAI,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAA,aAAI,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,KAAK,CAAC,GAAG,CAAC,aAAyC;QACzD,IAAA,iDAAiC,EAAC,aAAa,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAzDD,+BAyDC"}

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

@@ -1,7 +1,20 @@
 import IPostMessage from '../../IPostMessage';
 import IDebug from './IDebug';
 /**
- * The `sos.management.debug` API groups together method for working with native debug mode.
+ * The `sos.management.debug` API groups together methods for working with native debug mode.
+ *
+ * :::note
+ * Some modern systems might require additional steps to enable the native debug mode. Please refer to the [native debug documentation](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) for more information.
+ * :::
+ *
+ * <details>
+ *     <summary>Debug Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `SET_DEBUG` | If the device can enable or disable the native debug mode. |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 export default class Debug implements IDebug {
     private messagePrefix;
@@ -11,21 +24,50 @@ export default class Debug implements IDebug {
     /**
      * The `enable()` method enables the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode.
      *
+     * @returns {Promise<void>} A promise that resolves when the debug mode is enabled.
      * @since 3.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/debug | Example applet with activating debug mode}
+     *
+     * @example
+     * await sos.management.debug.enable();
      */
     enable(): Promise<void>;
     /**
      * The `enable()` method disables the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode.
      *
+     * @returns {Promise<void>} A promise that resolves when the debug mode is disabled.
      * @since 3.0.0
+     *
+     * @example
+     * await sos.management.debug.disable();
      */
     disable(): Promise<void>;
     /**
      * The `isEnabled()` method returns whether the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode is enabled.
      *
+     * @returns {Promise<boolean>} A promise that resolves to `true` if the debug mode is enabled, otherwise `false`.
      * @since 4.1.0
+     *
+     * @example
+     * const isDebugEnabled = await sos.management.debug.isEnabled();
+     * console.log(`Native debug mode is ${isDebugEnabled ? 'enabled' : 'disabled'}.`);
      */
     isEnabled(): Promise<boolean>;
-    private setDebug;
+    /**
+     * The `setDebug(enabled)` method sets the native debug mode to the specified state.
+     *
+     * @param enabled `true` to enable the debug mode, `false` to disable it.
+     * @returns {Promise<void>} A promise that resolves when the debug mode is set.
+     * @throws {Error} If the `enabled` parameter is not a boolean.
+     * @since 4.1.0
+     *
+     * @example
+     * const enabled = await sos.management.debug.isEnabled();
+     * if (!enabled) {
+     *  await sos.management.debug.setDebug(true);
+     * }
+     */
+    setDebug(enabled: boolean): Promise<void>;
     private getMessage;
 }

package/es6/FrontApplet/Management/Debug/Debug.js

@@ -5,7 +5,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const Validate_1 = __importDefault(require("../../Validate/Validate"));
 /**
- * The `sos.management.debug` API groups together method for working with native debug mode.
+ * The `sos.management.debug` API groups together methods for working with native debug mode.
+ *
+ * :::note
+ * Some modern systems might require additional steps to enable the native debug mode. Please refer to the [native debug documentation](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) for more information.
+ * :::
+ *
+ * <details>
+ *     <summary>Debug Management Capabilities</summary>
+ * 		| Capability | Description |
+ * 		|:------------|:-------------|
+ * 		| `SET_DEBUG` | If the device can enable or disable the native debug mode. |
+ *
+ * 		If you want to check if the device supports this capability, use [`sos.management.supports()`](https://developers.signageos.io/sdk/sos_management/#supports).
+ * </details>
  */
 class Debug {
     messagePrefix;
@@ -18,7 +31,13 @@ class Debug {
     /**
      * The `enable()` method enables the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode.
      *
+     * @returns {Promise<void>} A promise that resolves when the debug mode is enabled.
      * @since 3.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/management-js-api/debug | Example applet with activating debug mode}
+     *
+     * @example
+     * await sos.management.debug.enable();
      */
     async enable() {
         await this.setDebug(true);
@@ -26,7 +45,11 @@ class Debug {
     /**
      * The `enable()` method disables the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode.
      *
+     * @returns {Promise<void>} A promise that resolves when the debug mode is disabled.
      * @since 3.0.0
+     *
+     * @example
+     * await sos.management.debug.disable();
      */
     async disable() {
         await this.setDebug(false);
@@ -34,7 +57,12 @@ class Debug {
     /**
      * The `isEnabled()` method returns whether the [native debug](https://docs.signageos.io/hc/en-us/articles/4413935787154-Applet-Native-Device-Debug) mode is enabled.
      *
+     * @returns {Promise<boolean>} A promise that resolves to `true` if the debug mode is enabled, otherwise `false`.
      * @since 4.1.0
+     *
+     * @example
+     * const isDebugEnabled = await sos.management.debug.isEnabled();
+     * console.log(`Native debug mode is ${isDebugEnabled ? 'enabled' : 'disabled'}.`);
      */
     async isEnabled() {
         const { isEnabled } = await this.postMessage({
@@ -42,6 +70,20 @@ class Debug {
         });
         return isEnabled;
     }
+    /**
+     * The `setDebug(enabled)` method sets the native debug mode to the specified state.
+     *
+     * @param enabled `true` to enable the debug mode, `false` to disable it.
+     * @returns {Promise<void>} A promise that resolves when the debug mode is set.
+     * @throws {Error} If the `enabled` parameter is not a boolean.
+     * @since 4.1.0
+     *
+     * @example
+     * const enabled = await sos.management.debug.isEnabled();
+     * if (!enabled) {
+     *  await sos.management.debug.setDebug(true);
+     * }
+     */
     async setDebug(enabled) {
         (0, Validate_1.default)({ enabled }).required().boolean();
         await this.postMessage({

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

@@ -1 +1 @@
-{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Debug/Debug.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;GAEG;AACH,MAAqB,KAAK;IAGhB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS;QACrB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;SACnC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,OAAgB;QACtC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAClC,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AAjDD,wBAiDC"}
+{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../../../../src/FrontApplet/Management/Debug/Debug.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAG/C;;;;;;;;;;;;;;;GAeG;AACH,MAAqB,KAAK;IAGhB;IACA;IAHT,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;OAUG;IACI,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,SAAS;QACrB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;SACnC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,QAAQ,CAAC,OAAgB;QACrC,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAClC,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,CAAC;CACD;AA9ED,wBA8EC"}