@signageos/front-applet 8.1.2 → 8.1.4

package/es6/FrontApplet/Input/Input.js

@@ -5,6 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const events_1 = require("events");
 const Validate_1 = __importDefault(require("../Validate/Validate"));
+/**
+ * The `sos.input` API groups together all input-related functionality, such as remote control key events. With this API, you can
+ * listen to key events from the remote control and handle them in your application.
+ */
 class Input {
     window;
     messagePrefix;
@@ -32,11 +36,19 @@ class Input {
         }
     }
     /**
-     * The `onKeyUp` method sets up a listeners, which is called on every key stroke of the remote controller. For the specific logic of an
+     * The `onKeyUp` method sets up a listeners, which is called on every keystroke of the remote controller. For the specific logic of an
      * application (games for example), binding the remote control inputs can be helpful. Only a subset of all remote control keys is
      * supported on the specific device. Only numerical digits are guaranteed to be supported.
      *
+     * :::note
      * This feature must be tested by users on real devices.
+     * :::
+     *
+     * @param listener The listener function that will be called on every key up event.
+     * @returns {void} Resolves when the listener is successfully set up.
+     * @throws {Error} If listener is not valid function.
+     * @throws {Error} If listener is unregistered.
+     * @since 1.3.0
      */
     onKeyUp(listener) {
         this.checkAlive();
@@ -65,6 +77,10 @@ class Input {
     }
     /**
      * The `removeEventListener()` method removes all event listeners for a specific event (only `keyup` is supported).
+     *
+     * @param event The name of the event to remove the listener for. Currently, only `keyup` is supported.
+     * @param listener The listener function to remove.
+     * @returns {void} Resolves when the listener is successfully removed.
      */
     removeEventListener(event, listener) {
         this.eventEmitter.removeListener(event, listener);

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

@@ -1 +1 @@
-{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../../src/FrontApplet/Input/Input.ts"],"names":[],"mappings":";;;;;AAAA,mCAAsC;AAGtC,oEAA4C;AAG5C,MAAqB,KAAK;IAUR;IACC;IAVX,MAAM,CAAU,cAAc,GAAW,OAAO,CAAC;IAEvC,YAAY,GAAiB,IAAI,qBAAY,EAAE,CAAC;IAChD,sBAAsB,GAAY,KAAK,CAAC;IAEjD,KAAK,GAAY,IAAI,CAAC;IAE9B,gBAAgB;IAChB,YACiB,MAAc,EACb,aAAqB;QADtB,WAAM,GAAN,MAAM,CAAQ;QACb,kBAAa,GAAb,aAAa,CAAQ;QAEtC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAC7D,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnE,CAAC;IACF,CAAC;IAED,gBAAgB;IACT,OAAO;QACb,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBACjC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACtE,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,QAAsC;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAA,kBAAQ,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB;IACT,iBAAiB,CAAC,IAAsB;QAC9C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAC5B,MAAM,UAAU,GAAgB;oBAC/B,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,OAAO,EAAE,IAAI,CAAC,OAAqC;iBACnD,CAAC;gBACF,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBAChC,MAAM;YACP,QAAQ;QACT,CAAC;IACF,CAAC;IAED;;OAEG;IACI,oBAAoB;QAC1B,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,KAAc,EAAE,QAAkC;QAC5E,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB;IACT,cAAc,CAAC,KAAkB;QACvC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAEO,eAAe;QACtB,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,CAAC;IAEO,qBAAqB;QAC5B,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,SAAS,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;gBAC/B,yEAAyE;gBACzE,8FAA8F;gBAC9F,yFAAyF;gBACzF,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;gBAClD,OAAO,KAAK,CAAC;YACd,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,CAAC;YACT,CAAC;QACF,CAAC;IACF,CAAC;IAEO,qBAAqB,GAAG,CAAC,KAAoB,EAAE,EAAE;QACxD,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;gBACjC,0DAA0D;gBAC1D,oDAAoD;gBACpD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,CAAC;YACT,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IAEM,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,KAAK,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACrE,CAAC;IAEO,UAAU;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;;AA5HF,wBA6HC"}
+{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../../src/FrontApplet/Input/Input.ts"],"names":[],"mappings":"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"}

package/es6/FrontApplet/Monitors/Monitors.d.ts

@@ -2,6 +2,10 @@ import IPostMessage from '../IPostMessage';
 import IMonitor, { IConnectedMonitor } from './IMonitor';
 /**
  * The `sos.monitors` API groups together methods for providing information about monitors connected to the device.
+ *
+ * :::note
+ * This API is available only on Linux devices.
+ * :::
  */
 declare class Monitors implements IMonitor {
     private messagePrefix;
@@ -12,6 +16,7 @@ declare class Monitors implements IMonitor {
     /**
      * The `getList()` method returns a list of monitors currently connected to the device.
      *
+     * @returns {Promise<IConnectedMonitor[]>} A promise that resolves to an array of connected monitors.
      * @since 4.0.0
      */
     getList(): Promise<IConnectedMonitor[]>;

package/es6/FrontApplet/Monitors/Monitors.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * The `sos.monitors` API groups together methods for providing information about monitors connected to the device.
+ *
+ * :::note
+ * This API is available only on Linux devices.
+ * :::
  */
 class Monitors {
     messagePrefix;
@@ -15,6 +19,7 @@ class Monitors {
     /**
      * The `getList()` method returns a list of monitors currently connected to the device.
      *
+     * @returns {Promise<IConnectedMonitor[]>} A promise that resolves to an array of connected monitors.
      * @since 4.0.0
      */
     async getList() {

package/es6/FrontApplet/Monitors/Monitors.js.map

@@ -1 +1 @@
-{"version":3,"file":"Monitors.js","sourceRoot":"","sources":["../../../src/FrontApplet/Monitors/Monitors.ts"],"names":[],"mappings":";;AAGA;;GAEG;AACH,MAAM,QAAQ;IAKJ;IACA;IALF,MAAM,CAAC,cAAc,GAAW,UAAU,CAAC;IAElD,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;SACjC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,QAAQ,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACxE,CAAC;;AAGF,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"Monitors.js","sourceRoot":"","sources":["../../../src/FrontApplet/Monitors/Monitors.ts"],"names":[],"mappings":";;AAGA;;;;;;GAMG;AACH,MAAM,QAAQ;IAKJ;IACA;IALF,MAAM,CAAC,cAAc,GAAW,UAAU,CAAC;IAElD,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;OAKG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAC3C,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;SACjC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,QAAQ,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACxE,CAAC;;AAGF,kBAAe,QAAQ,CAAC"}

package/es6/FrontApplet/NativeCommands/MDC/INativeMdcCommands.d.ts

@@ -2,4 +2,5 @@ import { IMDCResponse, IpAddressType } from './Mdc';
 import { CodesMDC } from './CodesMDC';
 export default interface INativeMdcCommands {
     sendOne(ipAddress: IpAddressType, command: CodesMDC, data?: number[] | []): Promise<IMDCResponse>;
+    sendOneRaw(ipAddress: IpAddressType, data: number[] | []): Promise<IMDCResponse>;
 }

package/es6/FrontApplet/NativeCommands/MDC/Mdc.d.ts

@@ -1,25 +1,39 @@
 import IPostMessage from '../../IPostMessage';
 import { CodesMDC } from './CodesMDC';
 import INativeMdcCommands from './INativeMdcCommands';
+/**
+ * Type representing the IP address to which MDC commands can be sent.
+ * It can be either 'localhost' or a valid string representing an IP address.
+ */
 export type IpAddressType = 'localhost' | string;
+/**
+ * Response object returned by Tizen Core App.
+ */
 export interface IMDCResponse {
+    /**
+     * The type of the response, either 'ACK' for acknowledgment or 'NACK' for negative acknowledgment.
+     */
     type: 'ACK' | 'NACK';
+    /**
+     * The command type that was executed, represented as a number.
+     * Should match the command number in {@link CodesMDC}.
+     */
     commandType: number;
+    /**
+     * The result of the command execution, represented as a number.
+     * This value can vary depending on the command executed.
+     */
     result: number;
 }
 /**
  * The `sos.native.mdc` API groups together methods for controlling Tizen devices using MDC commands.
  *
  * :::warning
- *
  * This API is currently available on Tizen devices only.
- *
  * :::
  *
  * :::info
- *
  * You can ensure that the device supports MDC commands via `sos.management.supports("NATIVE_COMMANDS_MDC")`.
- *
  * :::
  */
 export default class Mdc implements INativeMdcCommands {
@@ -32,18 +46,21 @@ export default class Mdc implements INativeMdcCommands {
      * The `sendOne()` method sends an MDC command to another Tizen device on the same network or to the localhost.
      *
      * @param ipAddress The IP address of the device to send the command to.
-     * @param command The MDC command to send.
+     * @param command The MDC command to send {@link CodesMDC}.
      * @param data The optional data to send with the command.
-     *
+     * @throws {Error} If the `ipAddress` is not a valid string or if the `command` is not a valid number.
+     * @throws {Error} If the `data` is not an array of numbers.
+     * @throws {Error} If any error occurs during the command execution.
+     * @returns {Promise<IMDCResponse>} MDC response object containing the result of the command execution.
      * @since 6.5.1
      *
      * @example
-     * await sos.native.mdc.sendOne('localhost', CodesMDC.BRIGHTNESS_CONTROL); // Promise<IMDCResponse>
-     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.VOLUME_CONTROL, [50]); // Promise<IMDCResponse>
-     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.PICTURE_CONTROL, [0x54, 0x03]); // Promise<IMDCResponse>
+     * await sos.native.mdc.sendOne('localhost', CodesMDC.BRIGHTNESS_CONTROL);
+     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.VOLUME_CONTROL, [50]);
+     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.PICTURE_CONTROL, [0x54, 0x03]);
      *
      * // You can also send custom number if we don't have predefined command in our enum
-     * await sos.native.mdc.sendOne('192.168.0.10', 0x01, []); // Promise<IMDCResponse>
+     * await sos.native.mdc.sendOne('192.168.0.10', 0x01, []);
      */
     sendOne(ipAddress: IpAddressType, command: CodesMDC, data?: number[]): Promise<IMDCResponse>;
     /**
@@ -51,7 +68,11 @@ export default class Mdc implements INativeMdcCommands {
      * but without explicitly specifying the command.
      *
      * @param ipAddress The IP address of the device to send the command to.
-     * @param data The data to send with the command.
+     * @param data The data as array of numbers to send with the command. It can be also empty array.
+     * @throws {Error} If the `ipAddress` is not a valid string or if the `command` is not a valid number.
+     * @throws {Error} If the `data` is not an array of numbers.
+     * @throws {Error} If any error occurs during the command execution.
+     * @returns {Promise<IMDCResponse>} MDC response object containing the result of the command execution.
      *
      * @since 6.5.1
      *

package/es6/FrontApplet/NativeCommands/MDC/Mdc.js

@@ -8,15 +8,11 @@ const Validate_1 = __importDefault(require("../../Validate/Validate"));
  * The `sos.native.mdc` API groups together methods for controlling Tizen devices using MDC commands.
  *
  * :::warning
- *
  * This API is currently available on Tizen devices only.
- *
  * :::
  *
  * :::info
- *
  * You can ensure that the device supports MDC commands via `sos.management.supports("NATIVE_COMMANDS_MDC")`.
- *
  * :::
  */
 class Mdc {
@@ -32,18 +28,21 @@ class Mdc {
      * The `sendOne()` method sends an MDC command to another Tizen device on the same network or to the localhost.
      *
      * @param ipAddress The IP address of the device to send the command to.
-     * @param command The MDC command to send.
+     * @param command The MDC command to send {@link CodesMDC}.
      * @param data The optional data to send with the command.
-     *
+     * @throws {Error} If the `ipAddress` is not a valid string or if the `command` is not a valid number.
+     * @throws {Error} If the `data` is not an array of numbers.
+     * @throws {Error} If any error occurs during the command execution.
+     * @returns {Promise<IMDCResponse>} MDC response object containing the result of the command execution.
      * @since 6.5.1
      *
      * @example
-     * await sos.native.mdc.sendOne('localhost', CodesMDC.BRIGHTNESS_CONTROL); // Promise<IMDCResponse>
-     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.VOLUME_CONTROL, [50]); // Promise<IMDCResponse>
-     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.PICTURE_CONTROL, [0x54, 0x03]); // Promise<IMDCResponse>
+     * await sos.native.mdc.sendOne('localhost', CodesMDC.BRIGHTNESS_CONTROL);
+     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.VOLUME_CONTROL, [50]);
+     * await sos.native.mdc.sendOne('192.168.0.10', CodesMDC.PICTURE_CONTROL, [0x54, 0x03]);
      *
      * // You can also send custom number if we don't have predefined command in our enum
-     * await sos.native.mdc.sendOne('192.168.0.10', 0x01, []); // Promise<IMDCResponse>
+     * await sos.native.mdc.sendOne('192.168.0.10', 0x01, []);
      */
     async sendOne(ipAddress, command, data) {
         (0, Validate_1.default)({ ipAddress }).required().string();
@@ -67,7 +66,11 @@ class Mdc {
      * but without explicitly specifying the command.
      *
      * @param ipAddress The IP address of the device to send the command to.
-     * @param data The data to send with the command.
+     * @param data The data as array of numbers to send with the command. It can be also empty array.
+     * @throws {Error} If the `ipAddress` is not a valid string or if the `command` is not a valid number.
+     * @throws {Error} If the `data` is not an array of numbers.
+     * @throws {Error} If any error occurs during the command execution.
+     * @returns {Promise<IMDCResponse>} MDC response object containing the result of the command execution.
      *
      * @since 6.5.1
      *

package/es6/FrontApplet/NativeCommands/MDC/Mdc.js.map

@@ -1 +1 @@
-{"version":3,"file":"Mdc.js","sourceRoot":"","sources":["../../../../src/FrontApplet/NativeCommands/MDC/Mdc.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAW/C;;;;;;;;;;;;;;GAcG;AACH,MAAqB,GAAG;IAKd;IACA;IALF,MAAM,CAAC,cAAc,GAAW,KAAK,CAAC;IAE7C,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,OAAO,CAAC,SAAwB,EAAE,OAAiB,EAAE,IAAe;QAChF,IAAA,kBAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;QAED,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACjC,SAAS;YACT,OAAO;YACP,IAAI;SACJ,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,KAAK,CAAC,UAAU,CAAC,SAAwB,EAAE,IAAmB;QACpE,IAAA,kBAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACrC,SAAS;YACT,IAAI;SACJ,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,gBAAgB,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;IAC7C,CAAC;IAEO,gBAAgB;QACvB,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC;IACtD,CAAC;;AAlFF,sBAmFC"}
+{"version":3,"file":"Mdc.js","sourceRoot":"","sources":["../../../../src/FrontApplet/NativeCommands/MDC/Mdc.ts"],"names":[],"mappings":";;;;;AACA,uEAA+C;AAgC/C;;;;;;;;;;GAUG;AACH,MAAqB,GAAG;IAKd;IACA;IALF,MAAM,CAAC,cAAc,GAAW,KAAK,CAAC;IAE7C,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;OAmBG;IACI,KAAK,CAAC,OAAO,CAAC,SAAwB,EAAE,OAAiB,EAAE,IAAe;QAChF,IAAA,kBAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAA,kBAAQ,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;QAED,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACjC,SAAS;YACT,OAAO;YACP,IAAI;SACJ,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,KAAK,CAAC,UAAU,CAAC,SAAwB,EAAE,IAAmB;QACpE,IAAA,kBAAQ,EAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAA,kBAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACrC,SAAS;YACT,IAAI;SACJ,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,gBAAgB,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;IAC7C,CAAC;IAEO,gBAAgB;QACvB,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC;IACtD,CAAC;;AAzFF,sBA0FC"}

package/es6/FrontApplet/OSD/OSD.d.ts

@@ -1,7 +1,9 @@
 import IPostMessage from '../IPostMessage';
 import IOSD from './IOSD';
 /**
- * The `sos.osd` API groups together methods for working with the OSD (On Screen Display).
+ * The `sos.osd` API groups together methods for working with the signageOS OSD (On Screen Display).
+ *
+ * More information about the OSD can be found in the [OSD Introduction](https://docs.signageos.io/hc/en-us/articles/4405231839890-OSD-menu-by-signageOS)
  */
 export default class OSD implements IOSD {
     private messagePrefix;
@@ -11,7 +13,9 @@ export default class OSD implements IOSD {
     constructor(messagePrefix: string, postMessage: IPostMessage<any>);
     /**
      * The `showOSD()` method opens the OSD without typing the pin.
+     * Note: The OSD will be opened after 6 seconds.
      *
+     * @returns {Promise<void>} A promise that resolves when the OSD is shown.
      * @since 5.5.0
      */
     showOSD(): Promise<void>;

package/es6/FrontApplet/OSD/OSD.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
- * The `sos.osd` API groups together methods for working with the OSD (On Screen Display).
+ * The `sos.osd` API groups together methods for working with the signageOS OSD (On Screen Display).
+ *
+ * More information about the OSD can be found in the [OSD Introduction](https://docs.signageos.io/hc/en-us/articles/4405231839890-OSD-menu-by-signageOS)
  */
 class OSD {
     messagePrefix;
@@ -14,7 +16,9 @@ class OSD {
     }
     /**
      * The `showOSD()` method opens the OSD without typing the pin.
+     * Note: The OSD will be opened after 6 seconds.
      *
+     * @returns {Promise<void>} A promise that resolves when the OSD is shown.
      * @since 5.5.0
      */
     async showOSD() {

package/es6/FrontApplet/OSD/OSD.js.map

@@ -1 +1 @@
-{"version":3,"file":"OSD.js","sourceRoot":"","sources":["../../../src/FrontApplet/OSD/OSD.ts"],"names":[],"mappings":";;AAGA;;GAEG;AACH,MAAqB,GAAG;IAKd;IACA;IALF,MAAM,CAAC,cAAc,GAAW,KAAK,CAAC;IAE7C,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;SACjC,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACnE,CAAC;;AAtBF,sBAuBC"}
+{"version":3,"file":"OSD.js","sourceRoot":"","sources":["../../../src/FrontApplet/OSD/OSD.ts"],"names":[],"mappings":";;AAGA;;;;GAIG;AACH,MAAqB,GAAG;IAKd;IACA;IALF,MAAM,CAAC,cAAc,GAAW,KAAK,CAAC;IAE7C,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;OAMG;IACI,KAAK,CAAC,OAAO;QACnB,MAAM,IAAI,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;SACjC,CAAC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;IACnE,CAAC;;AAxBF,sBAyBC"}

package/es6/FrontApplet/Offline/Cache/Cache.d.ts

@@ -11,15 +11,14 @@ import IChecksumMessage from './IChecksumMessage';
 import IOfflineCache from './IOfflineCache';
 import { HashAlgorithm } from '../../FileSystem/HashAlgorithm';
 /**
- * The `sos.offline` API groups together methods used to download and save arbitrary files, which can be accessed even if the device is offline.
+ * The `sos.offline.cache` API groups together methods used to download and save arbitrary files, which can be accessed even if the device is offline.
  *
- * :::warning
+ * > Please refer to difference between `sos.offline.cache` and `sos.fileSystem` APIs in our [documentation](http://localhost:3000/sdk/sos/offline/).
  *
+ * :::warning
  * Emulator has certain limitations while handling offline files. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405238997138)
- *
  * :::
  *
- * @tutorial https://developers.signageos.io/docs/applets/api-guides/offline-content#caching-audio-visual-content-or-arbitrary-data-sosofflinecache
  */
 export default class Cache implements IOfflineCache {
     private messagePrefix;
@@ -30,101 +29,279 @@ export default class Cache implements IOfflineCache {
     /** @internal */
     constructor(messagePrefix: string, postMessage: IPostMessage<ISavedFileMessage & ISavedContentMessage & ILoadedFileMessage & ILoadedContentMessage & IListedFilesMessage & IListedContentsMessage & IChecksumMessage & IValidatedChecksumMessage>);
     /**
-     * The `listFiles()` method list all currently cached files.
+     * The `listFiles()` method list all currently cached files in internal storage, which was previously saved by `saveFile()` or `loadOrSaveFile()` methods.
      *
+     * @returns {Promise<string[]>} A promise that resolves to an array of unique identifiers (uids) of the saved files.
+     * @throws Error If any error occurs during listing files.
+     * @throws Error If the files cannot be listed.
      * @since 2.0.0
+     *
+     * @example
+     * await sos.offline.cache.saveFile('example-file.mp4', 'https://example.com/path/to/your/file.mp4');
+     * await sos.offline.cache.saveFile('another-file.jpg', 'https://example.com/path/to/your/image.jpg');
+     *
+     * // Later list the saved files
+     * const files = await sos.offline.cache.listFiles();
+     * console.log('Saved files:', files); // Output: Saved files: ['example-file.mp4', 'another-file.jpg']
      */
     listFiles(): Promise<string[]>;
     /**
      * The `loadFile()` method loads cached file, which was previously saved by `saveFile()` or `loadOrSaveFile()` methods.
      *
-     * @throws If the uid does not exists
-     *
+     * @param uid Unique identifier of the file to be loaded.
+     * @returns {Promise<IFile>} A promise that resolves to the loaded file.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the uid does not exist
      * @since 1.0.3
+     *
+     * @example
+     * // Save a file
+     * await sos.offline.cache.saveFile('example-file.mp4', 'https://example.com/path/to/your/file.mp4');
+     * // Later load the file
+     * const file = await sos.offline.cache.loadFile('example-file.mp4');
+     * console.log('Loaded file:', file); // Output: Loaded file: { uid: 'example-file.mp4', uri: 'file://path/to/your/file.mp4' }
      */
     loadFile(uid: string): Promise<IFile>;
     /**
-     * The `saveFile()` method downloads file from `uri` and saves it to the offline cache.
-     *
-     * :::warning
-     *
-     * `uid` should have the same file extension (e.g.: mp4, svg, jpg) as the original file.
+     * Method `saveFile()` is used to save files from remote a destination into the device internal memory.
      *
+     * :::info
+     * - Local device file path differs from device to device. It can point to `file://` or `http://localhost` etc.
      * :::
      *
-     * @throws If the network request fails or a file with the same uid is already cached
+     * :::warning
+     * - headers has to be a JSON object. If you are passing the value, make sure you use JSON.parse().
+     * - `uid` should have the same file extension (e.g.: mp4, svg, jpg) as the original file.
+     * :::
      *
+     * @param uid Unique identifier of the file to be saved.
+     * @param uri URI of the file to be downloaded.
+     * @param headers Key, value pairs of HTTP headers to send along with the request. Used when the target file is protected by a password or if any other specific headers are needed to access it.
+     * @throws Error If the network request fails.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the uri is not a valid URI.
+     * @throws Error File with the same uid is already cached.
+     * @throws Error If the headers are not a valid object with string values.
      * @since 1.0.3
+     *
+     * @example
+     * await sos.offline.cache.saveFile('example-file.mp4', 'https://example.com/path/to/your/file.mp4')
+     * 	.then(() => {
+     * 		console.log('File saved successfully');
+     *  })
+     *  .catch((error) => {
+     * 		console.error('Error saving file:', error);
+     * });
      */
     saveFile(uid: string, uri: string, headers?: {
         [key: string]: string;
     }): Promise<void>;
     /**
-     * The loadOrSaveFile() method loads the file from the cache, or downloads it if it's not already cached.
+     * Method `loadOrSaveFile()` is used for individual file retrieval & save in case when file is not saved in local storage yet. To get file from internal memory & save it when not yet exists we prepared `loadOrSaveFile()` method.
+     *
+     * :::info
+     * - The file URI has to return the file. If your URI leads to a 303 redirect (e.g. from http to https), the API will not work.
+     * - Emulator has certain limitations while handling offline files. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405238997138).
+     * - Local device file path differs from device to device. It can point to `file://` or `http://localhost` etc.
+     * :::
+     *
+     * :::warning
+     * `uid` should have the same file extension (e.g.: mp4, svg, jpg) as the original file
+     * :::
      *
+     * @param uid Unique identifier of the file to be loaded or saved.
+     * @param uri URI of the file to be downloaded if not cached.
+     * @param headers Key, value pairs of HTTP headers to send along with the request. Used when the target file is protected by a password or if any other specific headers are needed to access it.
+     * @returns {Promise<IFile>} A promise that resolves to the loaded or saved file.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the uri is not a valid URI.
+     * @throws Error If the headers are not a valid object with string values.
+     * @throws Error If the file cannot be loaded or saved.
+     * @throws AppletOfflineCacheError If the headers are not valid.
      * @since 1.0.9
+     * @example // {@link https://github.com/signageos/applet-examples/blob/master/examples/content-js-api/offline-files | Example Applet with Offline Files}
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/video-loop-offline | Example Applet with Video Loop Offline}
+     *
+     * @example
+     * await sos.offline.cache.loadOrSaveFile('example-file.mp4', 'https://example.com/path/to/your/file.mp4')
+     * 	.then((file) => {
+     * 		console.log('File loaded or saved:', file);
+     * 	})
+     * 	.catch((error) => {
+     * 		console.error('Error loading or saving file:', error);
+     * });
      */
     loadOrSaveFile(uid: string, uri: string, headers?: {
         [key: string]: string;
     }): Promise<IFile>;
     /**
-     * The `deleteFile()` method removes the file specified by `uid`.
+     * The `deleteFile()` method removes the file specified by `uid` from cache storage.
      *
+     * @param uid Unique identifier of the file to be deleted.
+     * @returns {Promise<void>} A promise that resolves when the file is deleted.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the uid is not found in the cache.
      * @since 2.0.0
      *
-     * @throws If the uid does not exist.
+     * @example
+     * // Save a file
+     * await sos.offline.cache.saveFile('example-file.mp4', 'https://example.com/path/to/your/file.mp4');
+     * // Later delete the file
+     * await sos.offline.cache.deleteFile('example-file.mp4');
      */
     deleteFile(uid: string): Promise<void>;
     /**
      * The `listContent()` method lists all values saved by `saveContent()` method.
      *
+     * @returns {Promise<string[]>} A promise that resolves to an array of saved content.
      * @since 2.0.0
-     * @tutorial https://developers.signageos.io/docs/applets/api-guides/key-value-storage
+     *
+     * @example
+     * // Save some content and list all saved contents
+     * await sos.offline.cache.saveContent('ApplicationSecret', '123SuperSecretHash');
+     * await sos.offline.cache.saveContent('UserToken', 'abc123xyz');
+     *
+     * // Later list the saved contents
+     * const contents = await sos.offline.cache.listContents();
+     * console.log('Saved contents:', contents); // Output: Saved contents: ['ApplicationSecret', 'UserToken']
      */
     listContents(): Promise<string[]>;
     /**
      * The `loadContent()` method gets the value specified by `uid`, which was previously saved by `saveContent()`.
      *
+     * @param uid Unique identifier of the content to be loaded.
+     * @returns {Promise<string>} A promise that resolves to the loaded content.
+     * @throws Error If the uid does not exist.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the content is not a valid string.
+     * @throws Error If any other error occurs during loading.
      * @since 1.0.3
-     * @tutorial https://developers.signageos.io/docs/applets/api-guides/key-value-storage
+     * @tutorial https://developers.signageos.io/docs/sos-guides/key-value-storage
+     *
+     * @example
+     * // Previously saved content with uid 'ApplicationSecret'
+     * await sos.offline.cache.saveContent('ApplicationSecret', '123SuperSecretHash');
+     *
+     * // Load the content
+     * const content = await sos.offline.cache.loadContent('ApplicationSecret');
+     * console.log('Loaded content:', content); // Output: Loaded content: 123SuperSecretHash
      */
     loadContent(uid: string): Promise<string>;
     /**
-     * The `saveContent()` method saves a string value to the cache.
+     * The `saveContent()` method saves a string value to the cache with specified `uid`.
      *
+     * Use when you need to save some data into local memory. This API provides you with approach similar to the HTML5's Local Storage, but implemented internally via native device API and completely device-agnostic.
+     *
+     * @param uid Unique identifier of the content to be saved.
+     * @param content The string content to be saved.
+     * @returns {Promise<void>} A promise that resolves when the content is saved.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If the content is not a valid string.
+     * @throws Error If the uid already exists.
+     * @throws Error If any other error occurs during saving.
      * @since 1.0.3
-     * @tutorial https://developers.signageos.io/docs/applets/api-guides/key-value-storage
+     * @tutorial https://developers.signageos.io/docs/sos-guides/key-value-storage
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/offline-content | Example of Applet using saveContent()}
+     *
+     * @example
+     * sos.offline.cache.saveContent('ApplicationSecret', '123SuperSecretHash')
+     * .then(() => {
+     *     //Content was successfully saved, retrieve it.
+     *     return sos.offline.cache.loadContent('ApplicationSecret');
+     * })
+     * .then((content) => {
+     *     console.log('Loaded', content); // print 123SuperSecretHash
+     * })
      */
     saveContent(uid: string, content: string): Promise<void>;
     /**
-     * The `deleteContent() method removes the value specified by `uid` key.
+     * The `deleteContent()` method removes the value specified by `uid` key from the cache storage.
      *
+     * @param uid Unique identifier of the content to be deleted.
+     * @returns {Promise<void>} A promise that resolves when the content is deleted.
+     * @throws Error If the uid does not exist.
+     * @throws Error If the uid is not a valid string.
+     * @throws Error If any other error occurs during deletion.
      * @since 2.0.0
-     * @tutorial https://developers.signageos.io/docs/applets/api-guides/key-value-storage
+     * @tutorial https://developers.signageos.io/docs/sos-guides/key-value-storage
+     *
+     * @example
+     * //Store
+     * sos.offline.cache.saveContent('ApplicationSecret', '123SuperSecretHash')
+     * .then(() => {
+     *     //Content was successfully saved, retrieve it.
+     *     return sos.offline.cache.loadContent('ApplicationSecret');
+     * })
+     * .then((content) => {
+     *     console.log('Loaded', content); // print 123SuperSecretHash
+     *
+     *     // Let's delete the content now
+     *     return sos.offline.cache.deleteContent('ApplicationSecret')
+     * })
+     * .then(() => {
+     *     console.log("Deleted");
+     * })
+     * .catch((error) => { console.error(error); });
      */
     deleteContent(uid: string): Promise<void>;
     /**
      * The `validateChecksumFile()` method validates whether the file, specified by `uid`, has the correct checksum.
      *
-     * @throws If the uid does not exist or the hashing algorithm is not supported.
-     *
+     * @param uid Unique file identifier of a previously downloaded file.
+     * @param hash The expected checksum of the file.
+     * @param hashType The hashing algorithm to use. Supported algorithms are 'md5' and `crc32`.
+     * @returns {Promise<boolean>} A promise that resolves to `true` if the checksum is valid, otherwise `false`.
+     * @throws Error If the uid does not exist or the hashing algorithm is not supported.
+     * @throws Error If the hash is not a valid string.
+     * @throws Error If the hashType is not a valid string.
      * @since 2.0.0
+     *
+     * @example
+     * // Validate the checksum of a file
+     * const expectedHash = 'd41d8cd98f00b204e9800998ecf8427e'; // Example MD5 hash
+     * // Previously saved file with uid 'example-file.mp4'
+     * const isValid = await sos.offline.cache.validateChecksumFile('example-file.mp4', expectedHash, 'md5');
      */
     validateChecksumFile(uid: string, hash: string, hashType: HashAlgorithm): Promise<boolean>;
     /**
      * The `getChecksumFile()` computes a checksum of the file specified by `uid`.
      *
-     * @throws If the uid does not exist or the hashing algorithm is not supported.
-     *
+     * @param uid Unique file identifier of a previously downloaded file.
+     * @param hashType The hashing algorithm to use. Supported algorithms are `md5` and `crc32`.
+     * @returns {Promise<string>} A promise that resolves to the computed checksum of the file.
+     * @throws Error If the uid does not exist.
+     * @throws Error If the hashing algorithm is not supported.
      * @since 2.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/md5-checksum | Example Applet with MD5 Checksum}
+     *
+     * @example
+     * const checksum = await sos.offline.cache.getChecksumFile('example-file.mp4', 'md5');
+     * console.log('MD5 Checksum:', checksum); // Output: MD5 Checksum: d41d8cd98f00b204e9800998ecf8427e
      */
     getChecksumFile(uid: string, hashType: HashAlgorithm): Promise<string>;
     /**
      * The `decompressFile()` decompresses the file specified by `uid` into a new file specified by `destinationUid`.
      *
-     * @throws If the uid does not exist.
-     *
+     * @param uid Unique file identifier of a previously downloaded ZIP file.
+     * @param destinationUid Unique directory identifier (prefix of file) to extract ZIP file.
+     * @param method The decompression method to use. Currently, only 'zip' is supported.
+     * @returns {Promise<void>} A promise that resolves when the file is decompressed.
+     * @throws Error If the uid does not exist.
+     * @throws Error If the destinationUid is not a valid string.
+     * @throws Error If the method is not supported.
      * @since 2.1.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/blob/master/examples/content-js-api/offline-zip-decompress | Example Applet with Offline ZIP Decompression}
+     * @example
+     * // Save the ZIP file
+     * await sos.offline.cache.saveFile('example-zip-file.zip', 'https://example.com/path/to/your/file.zip');
+     *
+     * // Decompress the ZIP file into a directory
+     * await sos.offline.cache.decompressFile('example-zip-file.zip', 'extracted-files/', 'zip');
+     * 	.then(() => { console.log('ZIP file extracted'); })
+     * 	.catch((error) => { console.error(error); });
      */
     decompressFile(uid: string, destinationUid: string, method: 'zip'): Promise<void>;
     private getCachedFile;