@capawesome/capacitor-live-update 6.6.0 → 6.7.1

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/options/SetNextBundleOptions.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes.options;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.PluginCall;
+
+public class SetNextBundleOptions {
+
+    @Nullable
+    private final String bundleId;
+
+    public SetNextBundleOptions(@NonNull PluginCall call) {
+        this.bundleId = call.getString("bundleId");
+    }
+
+    @Nullable
+    public String getBundleId() {
+        return bundleId;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/options/SyncOptions.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes.options;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.PluginCall;
+
+public class SyncOptions {
+
+    @Nullable
+    private final String channel;
+
+    public SyncOptions(@NonNull PluginCall call) {
+        this.channel = call.getString("channel", null);
+    }
+
+    @Nullable
+    public String getChannel() {
+        return channel;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/results/FetchLatestBundleResult.java

@@ -1,22 +1,41 @@
 package io.capawesome.capacitorjs.plugins.liveupdate.classes.results;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.liveupdate.enums.ArtifactType;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 import org.json.JSONObject;
 
 public class FetchLatestBundleResult implements Result {
 
     @Nullable
-    private String bundleId;
+    private final ArtifactType artifactType;
 
-    public FetchLatestBundleResult(@Nullable String bundleId) {
+    @Nullable
+    private final String bundleId;
+
+    @Nullable
+    private final String downloadUrl;
+
+    public FetchLatestBundleResult(@Nullable ArtifactType artifactType, @Nullable String bundleId, @Nullable String downloadUrl) {
+        this.artifactType = artifactType;
         this.bundleId = bundleId;
+        this.downloadUrl = downloadUrl;
     }
 
+    @NonNull
     public JSObject toJSObject() {
         JSObject result = new JSObject();
+        if (artifactType == ArtifactType.MANIFEST) {
+            result.put("artifactType", "manifest");
+        } else if (artifactType == ArtifactType.ZIP) {
+            result.put("artifactType", "zip");
+        }
         result.put("bundleId", bundleId == null ? JSONObject.NULL : bundleId);
+        if (downloadUrl != null) {
+            result.put("downloadUrl", downloadUrl);
+        }
         return result;
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/results/GetCurrentBundleResult.java

@@ -0,0 +1,22 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes.results;
+
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
+import org.json.JSONObject;
+
+public class GetCurrentBundleResult implements Result {
+
+    @Nullable
+    private String bundleId;
+
+    public GetCurrentBundleResult(@Nullable String bundleId) {
+        this.bundleId = bundleId;
+    }
+
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("bundleId", bundleId == null ? JSONObject.NULL : bundleId);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/results/GetNextBundleResult.java

@@ -0,0 +1,22 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes.results;
+
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
+import org.json.JSONObject;
+
+public class GetNextBundleResult implements Result {
+
+    @Nullable
+    private String bundleId;
+
+    public GetNextBundleResult(@Nullable String bundleId) {
+        this.bundleId = bundleId;
+    }
+
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("bundleId", bundleId == null ? JSONObject.NULL : bundleId);
+        return result;
+    }
+}

package/dist/docs.json

@@ -53,8 +53,14 @@
       },
       {
         "name": "fetchLatestBundle",
-        "signature": "() => Promise<FetchLatestBundleResult>",
-        "parameters": [],
+        "signature": "(options?: FetchLatestBundleOptions | undefined) => Promise<FetchLatestBundleResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "FetchLatestBundleOptions | undefined"
+          }
+        ],
         "returns": "Promise<FetchLatestBundleResult>",
         "tags": [
           {
@@ -64,7 +70,8 @@
         ],
         "docs": "Fetch the latest bundle using the [Capawesome Cloud](https://capawesome.io/cloud/).\n\nOnly available on Android and iOS.",
         "complexTypes": [
-          "FetchLatestBundleResult"
+          "FetchLatestBundleResult",
+          "FetchLatestBundleOptions"
         ],
         "slug": "fetchlatestbundle"
       },
@@ -77,6 +84,10 @@
           {
             "name": "since",
             "text": "5.0.0"
+          },
+          {
+            "name": "deprecated",
+            "text": "Use `getCurrentBundle()` instead."
           }
         ],
         "docs": "Get the active bundle identifier.\n\nOnly available on Android and iOS.",
@@ -113,12 +124,29 @@
             "text": "5.0.0"
           }
         ],
-        "docs": "Get the channel of the app.\n\nOnly available on Android and iOS.",
+        "docs": "Get the channel that is used for the update.\n\nOnly available on Android and iOS.",
         "complexTypes": [
           "GetChannelResult"
         ],
         "slug": "getchannel"
       },
+      {
+        "name": "getCurrentBundle",
+        "signature": "() => Promise<GetCurrentBundleResult>",
+        "parameters": [],
+        "returns": "Promise<GetCurrentBundleResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.7.0"
+          }
+        ],
+        "docs": "Get the bundle identifier of the current bundle.\nThe current bundle is the bundle that is currently used by the app.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "GetCurrentBundleResult"
+        ],
+        "slug": "getcurrentbundle"
+      },
       {
         "name": "getCustomId",
         "signature": "() => Promise<GetCustomIdResult>",
@@ -130,7 +158,7 @@
             "text": "5.0.0"
           }
         ],
-        "docs": "Get the custom identifier of the app.\n\nOnly available on Android and iOS.",
+        "docs": "Get the custom identifier of the device.\n\nOnly available on Android and iOS.",
         "complexTypes": [
           "GetCustomIdResult"
         ],
@@ -147,12 +175,29 @@
             "text": "5.0.0"
           }
         ],
-        "docs": "Get the device identifier of the app.\n\nOnly available on Android and iOS.",
+        "docs": "Get the unique device identifier.\n\nOnly available on Android and iOS.",
         "complexTypes": [
           "GetDeviceIdResult"
         ],
         "slug": "getdeviceid"
       },
+      {
+        "name": "getNextBundle",
+        "signature": "() => Promise<GetNextBundleResult>",
+        "parameters": [],
+        "returns": "Promise<GetNextBundleResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.7.0"
+          }
+        ],
+        "docs": "Get the bundle identifier of the next bundle.\nThe next bundle is the bundle that will be used after calling `reload()`\nor restarting the app.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "GetNextBundleResult"
+        ],
+        "slug": "getnextbundle"
+      },
       {
         "name": "getVersionCode",
         "signature": "() => Promise<GetVersionCodeResult>",
@@ -247,6 +292,10 @@
           {
             "name": "since",
             "text": "5.0.0"
+          },
+          {
+            "name": "deprecated",
+            "text": "Use `setNextBundle()` instead."
           }
         ],
         "docs": "Set the next bundle to use for the app.\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.",
@@ -272,7 +321,7 @@
             "text": "5.0.0"
           }
         ],
-        "docs": "Set the channel of the app.\n\nOnly available on Android and iOS.",
+        "docs": "Set the channel to use for the update.\n\nOnly available on Android and iOS.",
         "complexTypes": [
           "SetChannelOptions"
         ],
@@ -295,16 +344,45 @@
             "text": "5.0.0"
           }
         ],
-        "docs": "Set the custom identifier of the app.\n\nOnly available on Android and iOS.",
+        "docs": "Set the custom identifier of the device.\n\nOnly available on Android and iOS.",
         "complexTypes": [
           "SetCustomIdOptions"
         ],
         "slug": "setcustomid"
       },
+      {
+        "name": "setNextBundle",
+        "signature": "(options: SetNextBundleOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "SetNextBundleOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.7.0"
+          }
+        ],
+        "docs": "Set the next bundle to use for the app.\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "SetNextBundleOptions"
+        ],
+        "slug": "setnextbundle"
+      },
       {
         "name": "sync",
-        "signature": "() => Promise<SyncResult>",
-        "parameters": [],
+        "signature": "(options?: SyncOptions | undefined) => Promise<SyncResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "SyncOptions | undefined"
+          }
+        ],
         "returns": "Promise<SyncResult>",
         "tags": [
           {
@@ -314,7 +392,8 @@
         ],
         "docs": "Automatically download and set the latest bundle for the app using the [Capawesome Cloud](https://capawesome.io/cloud/).\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.",
         "complexTypes": [
-          "SyncResult"
+          "SyncResult",
+          "SyncOptions"
         ],
         "slug": "sync"
       }
@@ -441,6 +520,18 @@
       ],
       "methods": [],
       "properties": [
+        {
+          "name": "artifactType",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The artifact type of the bundle.",
+          "complexTypes": [],
+          "type": "'manifest' | 'zip' | undefined"
+        },
         {
           "name": "bundleId",
           "tags": [
@@ -452,6 +543,44 @@
           "docs": "The unique identifier of the latest bundle.\n\nIf `null`, no bundle is available.",
           "complexTypes": [],
           "type": "string | null"
+        },
+        {
+          "name": "downloadUrl",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The URL of the latest bundle to download.\nPass this URL to the `downloadBundle(...)` method to download the bundle.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "FetchLatestBundleOptions",
+      "slug": "fetchlatestbundleoptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.7.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "channel",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The name of the channel where the latest bundle is fetched from.",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },
@@ -535,7 +664,33 @@
               "name": "example"
             }
           ],
-          "docs": "The channel of the app.\n\nIf `null`, the app is using the default channel.",
+          "docs": "The channel name.\n\nIf `null`, the app is using the default channel.",
+          "complexTypes": [],
+          "type": "string | null"
+        }
+      ]
+    },
+    {
+      "name": "GetCurrentBundleResult",
+      "slug": "getcurrentbundleresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.7.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundleId",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The unique identifier of the current bundle.\n\nIf `null`, the default bundle is being used.",
           "complexTypes": [],
           "type": "string | null"
         }
@@ -565,7 +720,7 @@
               "name": "example"
             }
           ],
-          "docs": "The custom identifier of the app.\n\nIf `null`, no custom identifier is set.",
+          "docs": "The custom identifier of the device.\n\nIf `null`, no custom identifier is set.",
           "complexTypes": [],
           "type": "string | null"
         }
@@ -601,6 +756,32 @@
         }
       ]
     },
+    {
+      "name": "GetNextBundleResult",
+      "slug": "getnextbundleresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.7.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundleId",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The unique identifier of the next bundle.\n\nIf `null`, the default bundle is being used.",
+          "complexTypes": [],
+          "type": "string | null"
+        }
+      ]
+    },
     {
       "name": "GetVersionCodeResult",
       "slug": "getversioncoderesult",
@@ -711,7 +892,7 @@
               "name": "since"
             }
           ],
-          "docs": "The channel of the app.\n\nSet `null` to remove the channel.",
+          "docs": "The channel name.\n\nSet `null` to remove the channel.",
           "complexTypes": [],
           "type": "string | null"
         }
@@ -737,7 +918,37 @@
               "name": "since"
             }
           ],
-          "docs": "The custom identifier of the app.\n\nSet `null` to remove the custom identifier.",
+          "docs": "The custom identifier of the device.\n\nSet `null` to remove the custom identifier.",
+          "complexTypes": [],
+          "type": "string | null"
+        }
+      ]
+    },
+    {
+      "name": "SetNextBundleOptions",
+      "slug": "setnextbundleoptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.7.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundleId",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            },
+            {
+              "text": "'1.0.0'",
+              "name": "example"
+            }
+          ],
+          "docs": "The unique identifier of the bundle to use.\n\nSet `null` to use the default bundle (same as calling `reset()`).",
           "complexTypes": [],
           "type": "string | null"
         }
@@ -768,6 +979,32 @@
           "type": "string | null"
         }
       ]
+    },
+    {
+      "name": "SyncOptions",
+      "slug": "syncoptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "6.7.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "channel",
+          "tags": [
+            {
+              "text": "6.7.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The name of the channel where the latest bundle is fetched from.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
     }
   ],
   "enums": [],
@@ -873,8 +1110,8 @@
               "name": "example"
             },
             {
-              "text": "https ://capawesome.io/cloud/live-updates/advanced/privacy/",
-              "name": "see"
+              "text": "This option will be removed in the future.",
+              "name": "deprecated"
             }
           ],
           "docs": "The location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).",