@signageos/front-applet 8.1.1 → 8.1.2

package/docs/sos/fileSystem.md

@@ -46,7 +46,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the parent directory does not exist or the `filePath` is a directory.
+If the parent directory does not exist or the `filePath` is a directory.
 
 <Separator />
 
@@ -84,7 +84,7 @@ interface ICopyFileOptions {
 
 #### Possible errors
 
-The method throws an error if the source file does not exists or parent of the destination file path does not exists. It also throws if the
+If the source file does not exists or parent of the destination file path does not exists. It also throws if the
 `options.overwrite` is not set and the destination file path already exists.
 
 <Separator />
@@ -143,7 +143,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the directory already exists or its parent directory does not exist.
+If the directory already exists or its parent directory does not exist.
 
 <Separator />
 
@@ -171,7 +171,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the file does not exists or if `recursive` is set to false and the file path is a directory.
+If the file does not exists or if `recursive` is set to false and the file path is a directory.
 
 <Separator />
 
@@ -241,7 +241,7 @@ interface IHeaders {
 
 #### Possible errors
 
-The method throws an error if the network request fails, parent directory does not exist, or the file path is a directory.
+If the network request fails, parent directory does not exist, or the file path is a directory.
 
 <Separator />
 
@@ -293,7 +293,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the archive file path does not exist, it is not a valid archive file or the destination directory does not exist.
+If the archive file path does not exist, it is not a valid archive file or the destination directory does not exist.
 
 <Separator />
 
@@ -359,7 +359,7 @@ type AnyString = string & {};
 
 #### Possible errors
 
-The method throws an error if the file does not exist or it is a directory.
+If the file does not exist or it is a directory.
 
 <Separator />
 
@@ -387,7 +387,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the file path does not exist.
+If the file path does not exist.
 
 <Separator />
 
@@ -439,7 +439,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the path does not exist or it is a file.
+If the path does not exist or it is a file.
 
 <Separator />
 
@@ -510,7 +510,7 @@ interface IMoveFileOptions {
 
 #### Possible errors
 
-The method throws an error if the source file does not exists or parent of the destination file path does not exists. It also throws if the
+If the source file does not exists or parent of the destination file path does not exists. It also throws if the
 `options.overwrite` is not set and the destination file path already exists.
 
 <Separator />
@@ -550,7 +550,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the file does not exist.
+If the file does not exist.
 
 <Separator />
 
@@ -614,7 +614,7 @@ interface IStorageUnit {
 
 #### Possible errors
 
-The method throws an error if the parent directory does not exist or the `filePath` is a directory.
+If the parent directory does not exist or the `filePath` is a directory.
 
 ## API Example
 

package/docs/sos/index.md

@@ -4,11 +4,22 @@ sidebar_position: 0
 
 # sos
 
-<Admonition type="info" icon="" title="">
-  Learn more about using this API [here](https://developers.signageos.io/docs/applets/getting-started/#using-the-sos-sdk)
-</Admonition>
+The `sos` API groups together all functionality the \@signageos/front-applet offers. This is a basic object that provides you with access to
+all the applet functionality, such as device information, display control, video playback, and more.
 
-The `sos` API groups together all functionality the \@signageos/front-applet offers.
+:::warning
+All calls to the sos object need to happen after `sos.onReady()` is resolved. After the sOS object is ready, there are global properties available, which can be used for applet customization and device identification.
+:::
+
+```ts
+// Simple example of using the sos API to play a video.
+import sos from '@signageos/front-applet';
+
+sos.onReady().then(async function () {
+  startYourApplet(); // Example method to run
+  // Any other code
+}
+```
 
 ## Properties
 
@@ -23,7 +34,7 @@ readonly appletVersion: string;
 ### authHash
 
 <Admonition type="info" icon="" title="">
-  Learn more about using this API [here](https://developers.signageos.io/docs/applets/api-guides/device-identification)
+  Learn more about using this API [here](https://developers.signageos.io/docs/sos-guides/device-identification)
 </Admonition>
 
 The `authHash` property is an alternative device identifier, which is designed for secure pairing and locating devices through
@@ -39,11 +50,7 @@ readonly authHash: string;
 
 ### config
 
-<Admonition type="info" icon="" title="">
-  Learn more about using this API [here](https://developers.signageos.io/docs/applets/configuration/)
-</Admonition>
-
-The `config` property is a Key-value dictionary of the applet configuration.
+The `config` property is a Key-value dictionary of the applet configuration. It is assigned on the device with timing via Box or SDK/Rest API.
 
 ```ts expandable
 readonly config: Record<string, number | string | boolean>;
@@ -60,6 +67,16 @@ which is resolved at the same time as the listener.
 onReady(listener?: () => void): Promise<void>;
 ```
 
+#### Params
+
+| Name                    | Type         | Description                                                  |
+|-------------------------|--------------|--------------------------------------------------------------|
+| `listener` *(optional)* | `() => void` | Optional listener which is called when the sos API is ready. |
+
+#### Return value
+
+Promise which is resolved when the sos API is ready.
+
 #### Example
 
 ```ts
@@ -76,12 +93,16 @@ sos.onReady(async function () {
 
 ### refresh()
 
-The `refresh()` method initializes refresh of the applet. Similar to window.location.reload(), but the applet is not downloaded again.
+The `refresh()` method initializes the refresh of the applet. Similar to window.location.reload(), but the applet is not downloaded again.
 
 ```ts expandable
 refresh(): Promise<void>;
 ```
 
+#### Return value
+
+Promise that is resolved when the refresh is completed.
+
 #### Example
 
 ```ts
@@ -106,5 +127,8 @@ restore(): void;
 #### Example
 
 ```ts
-sos.restore();
+sos.onReady(async function () {
+  // Some function which is called when the applet is ready
+  sos.restore();
+});
 ```

package/docs/sos/offline/cache.md

@@ -28,7 +28,7 @@ decompressFile(uid: string, destinationUid: string, method: 'zip'): Promise<void
 
 #### Possible errors
 
-The method throws an error if the uid does not exist.
+If the uid does not exist.
 
 <Separator />
 
@@ -56,7 +56,7 @@ deleteFile(uid: string): Promise<void>;
 
 #### Possible errors
 
-The method throws an error if the uid does not exist.
+If the uid does not exist.
 
 <Separator />
 
@@ -75,7 +75,7 @@ type AnyString = string & {};
 
 #### Possible errors
 
-The method throws an error if the uid does not exist or the hashing algorithm is not supported.
+If the uid does not exist or the hashing algorithm is not supported.
 
 <Separator />
 
@@ -132,7 +132,7 @@ interface IFile {
 
 #### Possible errors
 
-The method throws an error if the uid does not exists
+If the uid does not exists
 
 <Separator />
 
@@ -185,7 +185,7 @@ saveFile(uid: string, uri: string, headers?: {
 
 #### Possible errors
 
-The method throws an error if the network request fails or a file with the same uid is already cached
+If the network request fails or a file with the same uid is already cached
 
 <Separator />
 
@@ -204,4 +204,4 @@ type AnyString = string & {};
 
 #### Possible errors
 
-The method throws an error if the uid does not exist or the hashing algorithm is not supported.
+If the uid does not exist or the hashing algorithm is not supported.