@signageos/front-applet 8.1.3 → 8.2.0

package/es6/FrontApplet/Offline/Cache/Cache.js

@@ -8,15 +8,14 @@ const ErrorCodes_1 = __importDefault(require("../../Error/ErrorCodes"));
 const AppletOfflineCacheError_1 = __importDefault(require("../../Error/AppletOfflineCacheError"));
 const Validate_1 = __importDefault(require("../../Validate/Validate"));
 /**
- * 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
  */
 class Cache {
     messagePrefix;
@@ -32,9 +31,20 @@ class Cache {
         this.savedContents = {};
     }
     /**
-     * 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']
      */
     async listFiles() {
         const response = await this.postMessage({
@@ -45,9 +55,18 @@ class Cache {
     /**
      * 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' }
      */
     async loadFile(uid) {
         (0, Validate_1.default)({ uid }).required().string();
@@ -59,17 +78,35 @@ class Cache {
         return response.loadedFile;
     }
     /**
-     * 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);
+     * });
      */
     async saveFile(uid, uri, headers) {
         this.checkUidValidity(uid);
@@ -89,9 +126,39 @@ class Cache {
         this.savedFiles[uid] = response.savedFile;
     }
     /**
-     * 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);
+     * });
      */
     async loadOrSaveFile(uid, uri, headers) {
         (0, Validate_1.default)({ uid }).required().string();
@@ -110,11 +177,19 @@ class Cache {
         }
     }
     /**
-     * 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');
      */
     async deleteFile(uid) {
         this.checkUidValidity(uid);
@@ -127,8 +202,17 @@ class Cache {
     /**
      * 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']
      */
     async listContents() {
         const response = await this.postMessage({
@@ -139,8 +223,22 @@ class Cache {
     /**
      * 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
      */
     async loadContent(uid) {
         const response = await this.postMessage({
@@ -151,10 +249,31 @@ class Cache {
         return response.loadedContent;
     }
     /**
-     * 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
+     * })
      */
     async saveContent(uid, content) {
         this.checkUidValidity(uid);
@@ -167,10 +286,33 @@ class Cache {
         this.savedContents[uid] = response.savedContent;
     }
     /**
-     * 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); });
      */
     async deleteContent(uid) {
         this.checkUidValidity(uid);
@@ -183,9 +325,20 @@ class Cache {
     /**
      * 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');
      */
     async validateChecksumFile(uid, hash, hashType) {
         this.checkUidValidity(uid);
@@ -202,9 +355,18 @@ class Cache {
     /**
      * 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
      */
     async getChecksumFile(uid, hashType) {
         this.checkUidValidity(uid);
@@ -219,9 +381,24 @@ class Cache {
     /**
      * 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); });
      */
     async decompressFile(uid, destinationUid, method) {
         this.checkUidValidity(uid);

package/es6/FrontApplet/Offline/Cache/Cache.js.map

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

package/es6/FrontApplet/Offline/IAddFont.js.map

@@ -1 +1 @@
-{"version":3,"file":"IAddFont.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/IAddFont.ts"],"names":[],"mappings":";;;AA0Ba,QAAA,aAAa,GAAG;IAC5B,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACd,CAAC;AAEW,QAAA,oBAAoB,GAAG;IACnC,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;CACvB,CAAC;AAEW,QAAA,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,4BAAoB,EAAE;IAC5D,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,qBAAa;CACtB,CAAC,CAAC"}
+{"version":3,"file":"IAddFont.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/IAddFont.ts"],"names":[],"mappings":";;;AAgCa,QAAA,aAAa,GAAG;IAC5B,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACd,CAAC;AAEW,QAAA,oBAAoB,GAAG;IACnC,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;CACvB,CAAC;AAEW,QAAA,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,4BAAoB,EAAE;IAC5D,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,qBAAa;CACtB,CAAC,CAAC"}

package/es6/FrontApplet/Offline/IFileType.js.map

@@ -1 +1 @@
-{"version":3,"file":"IFileType.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/IFileType.ts"],"names":[],"mappings":";;;AAGa,QAAA,UAAU,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"IFileType.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/IFileType.ts"],"names":[],"mappings":";;;AAMa,QAAA,UAAU,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC"}

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

@@ -1,6 +1,9 @@
 import IFileType from './IFileType';
 import IFlag from './Flags/IFlag';
 import ErrorCodes from '../Error/ErrorCodes';
+/**
+ * Interface represents a file that can be saved to cache and loaded into applet resources.
+ */
 interface ISaveFile {
     uid: string;
     uri: string;

package/es6/FrontApplet/Offline/ISaveFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"ISaveFile.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/ISaveFile.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAoD;AACpD,yCAA8C;AAC9C,qEAA6C;AAC7C,qFAA6D;AAWhD,QAAA,UAAU,GAAG;IACzB,GAAG,EAAE;QACJ,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE;YACN,IAAI,EAAE,oBAAU,CAAC,sBAAsB;YACvC,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,sBAAsB,CAAC;SAC9D;KACD;IACD,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE;QACL,MAAM,EAAE,sBAAU;QAClB,KAAK,EAAE;YACN,IAAI,EAAE,oBAAU,CAAC,2BAA2B;YAC5C,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,2BAA2B,CAAC;SACnE;KACD;IACD,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE;QACN,QAAQ,EAAE;YACT,MAAM,EAAE,cAAM;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAU,CAAC,uBAAuB,EAAE,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,uBAAuB,CAAC,EAAE;SACpH;KACD;CACD,CAAC"}
+{"version":3,"file":"ISaveFile.js","sourceRoot":"","sources":["../../../src/FrontApplet/Offline/ISaveFile.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAoD;AACpD,yCAA8C;AAC9C,qEAA6C;AAC7C,qFAA6D;AAmBhD,QAAA,UAAU,GAAG;IACzB,GAAG,EAAE;QACJ,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE;YACN,IAAI,EAAE,oBAAU,CAAC,sBAAsB;YACvC,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,sBAAsB,CAAC;SAC9D;KACD;IACD,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE;QACL,MAAM,EAAE,sBAAU;QAClB,KAAK,EAAE;YACN,IAAI,EAAE,oBAAU,CAAC,2BAA2B;YAC5C,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,2BAA2B,CAAC;SACnE;KACD;IACD,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE;QACN,QAAQ,EAAE;YACT,MAAM,EAAE,cAAM;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAU,CAAC,uBAAuB,EAAE,OAAO,EAAE,4BAAkB,CAAC,oBAAU,CAAC,uBAAuB,CAAC,EAAE;SACpH;KACD;CACD,CAAC"}

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

@@ -10,15 +10,23 @@ type FlagControllers = {
     append: AppendFlagController;
 };
 /**
- * The `sos.offline` API groups together methods for storing and using JS, CSS and font files.
+ * Web-based applications often require additional assets to function, but downloading them every time is undesirable. The JS Applet SDK offers a wide range of APIs for storing different kinds of assets.
  *
- * :::warning
+ * Generally, there are four types of assets:
+ * - CSS & JavaScript files
+ * - Fonts
+ * - Audio-visual content (image, video, and audio files)
+ * - Arbitrary data (e.g., JSON files, plain text, binary data)
  *
- * Emulator has certain limitations while handling offline files. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405238997138)
+ * And the SDK also provides two different APIs:
+ * - `sos.offline` & `sos.offline.cache`: A file system abstraction for caching files that are removed when the applet configuration is changed or the applet is reloaded. This method is usually preferred if the files can be re-downloaded.
+ * - `sos.fileSystem`: Direct access to the file system. All files are stored permanently and are not removed when the applet configuration changes.
  *
- * :::
+ * Using the `sos.offline` and `sos.offline.cache` APIs allows you to ship an applet without content, including only basic bootstrapping code, and load the content dynamically. The content will then be available even when the device is offline.
  *
- * @tutorial https://developers.signageos.io/docs/applets/api-guides/offline-content#caching-css--javascript-sosoffline
+ * :::warning
+ * Emulator has certain limitations while handling offline files. [Read more here](https://docs.signageos.io/hc/en-us/articles/4405238997138)
+ * :::
  */
 export default class Offline {
     private messagePrefix;
@@ -29,16 +37,23 @@ export default class Offline {
     readonly types: ITypes;
     readonly loadFile: ILoadFile;
     readonly flags: IFlags<FlagControllers>;
-    private flagControllers;
+    private readonly flagControllers;
     private FlagControllers;
     private LoadFileControllers;
     /** @internal */
     constructor(messagePrefix: string, window: Window, postMessage: IPostMessage<any>);
     /**
-     * The `addFiles()` method downloads the specified files and stores them locally. The order in which the files are downloaded and stored is **not** guaranteed.
+     * The `addFiles()` method downloads the specified files and stores them locally.
+     * The order in which the files are downloaded and stored is **not** guaranteed.
      *
+     * CSS and JavaScript files are specific because they must be loaded with an HTML tag. The `sos.offline` API methods download, save, and append the resource to the web page. When adding a file, choose a unique identifier (`uid`) that should not change for the resource. The file will be overwritten if another file is added with the same `uid`.
+     *
+     * @param files Array of files to be downloaded and stored locally.
+     * @returns {Promise<Awaited<void>>} Resolves when all files are added.
+     * @throws {Error} If the `files` parameter is not an array of objects.
      * @since 1.0.0
      *
+     * @example // {@link https://github.com/signageos/applet-examples/blob/master/examples/content-js-api/offline-resources | Example of Applet that save files and load them in one file}
      * @example
      * await sos.offline.addFile([{
      * 	uri: 'https://unpkg.com/normalize.css@8.0.1/normalize.css',
@@ -52,27 +67,52 @@ export default class Offline {
      * 	flags: [sos.offline.flags.append(document.body)],
      * }]);
      */
-    addFiles(files: ISaveFile[]): Promise<void[]>;
+    addFiles(files: ISaveFile[]): Promise<Awaited<void>[]>;
     /**
-     * The `addFilesSync()` method downloads the specified files and stores them locally. The order in which the files are downloaded and stored **is** guaranteed.
+     * Method `addFile()` will allow you to load single resource into applet. If you want to load more resource, use `addFiles()`.
+     *
+     * The order in which the files are downloaded and stored **is** guaranteed.
      *
+     * @param files Array of files to be downloaded and stored locally.
+     * @returns {Promise<void>} Resolves when all files are added and the files are appended to the document when flags are used.
+     * @throws {Error} If the `files` parameter is not an array of objects
      * @since 1.0.0
+     *
+     * @example
+     * const file = { // File that will be loaded into an applet
+     *     "uri": "https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js",
+     *     "uid": "jquery-2.2.4.min.js",
+     *     "type": sos.offline.types.javascript,
+     *     "flags": [sos.offline.flags.append(document.body)]
+     * }
+     *
+     * await sos.offline.addFile(file); // And finally load file
      */
     addFilesSync(files: ISaveFile[]): Promise<void>;
     /**
      * The `addFile()` method downloads the specified file and stores it locally.
      *
+     * CSS and JavaScript files are specific because they must be loaded with an HTML tag. The `sos.offline` API methods download, save, and append the resource to the web page. When adding a file, choose a unique identifier (`uid`) that should not change for the resource. The file will be overwritten if another file is added with the same `uid`.
+     *
+     * :::info
+     * The file URL must point to a file. If your URI leads to a redirect (e.g. from http to https), the API will not work.
+     * :::
+     *
+     * @param file URI of the file to be downloaded.
+     * @param file.uid Unique file identifier is used for later file retrieval, must contain a-z,A-Z,0-9 characters.
+     * @param file.type Type of the file, e.g. 'javascript', 'css', etc.
+     * @param file.headers HTTP headers to be sent with the request for the file.
+     * @param file.flags Additional flags for appending stored files to the DOM or other operations
+     * @returns {Promise<void>} Resolves when the file is added and the file is appended to the document when flags are used.
+     * @throws {Error} If the `file` parameter is not an object.
+     * @throws {Error} If the `file` parameter does not contain a valid parameters.
      * @since 1.0.0
      *
      * @example
      * await sos.offline.addFile({
-     * 	// Source URL
      * 	uri: 'https://code.jquery.com/jquery-3.7.1.slim.min.js',
-     * 	// Unique identifier of the resource
      * 	uid: 'jquery-3.7.1.slim.min.js',
-     * 	// Indicate that the downloaded file is a JavaScript file
      * 	type: sos.offline.types.javascript,
-     * 	// After the file is downloaded, it will be appended to document.body
      * 	flags: [sos.offline.flags.append(document.body)],
      * });
      */
@@ -88,10 +128,13 @@ export default class Offline {
      * @param font.fontStretch Allows you to make text wider or narrower.
      * @param font.fontStyle Specifies the font style for a text. (Either `normal`, `italic`, `oblique`, `initial` or `inherit`)
      * @param font.fontWeight Sets how thick or thin characters in text should be displayed
-     * @param font.unicodeRange Defines the range of unicode characters the font supports, default value is "U+0-10FFFF"
+     * @param font.unicodeRange Defines the range of Unicode characters the font supports, default value is "U+0-10FFFF"
      * @param font.formats Dictionary of supported formats with its files
-     *
+     * @throws {Error} If the `font` parameter is not an object.
+     * @returns {Promise<void>} Resolves when the font is added and the style element is appended to the document.
      * @since 2.0.0
+     *
+     * @example // {@link https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/fonts | Example of Applet that loads custom font}
      */
     addFont(font: IAddFont): Promise<void>;
     private handleFileFlag;