@capgo/cli 7.7.2 → 7.9.7

package/README.md

@@ -195,8 +195,10 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 | **--zip** | <code>boolean</code> | Upload the bundle using zip to Capgo cloud (legacy) |
 | **--tus** | <code>boolean</code> | Upload the bundle using TUS to Capgo cloud |
 | **--tus-chunk-size** | <code>string</code> | Chunk size for the TUS upload |
-| **--partial** | <code>boolean</code> | Upload partial files to Capgo cloud |
-| **--partial-only** | <code>boolean</code> | Upload only partial files to Capgo cloud, skip the zipped file, useful for big bundle |
+| **--partial** | <code>boolean</code> | Upload partial files to Capgo cloud (deprecated, use --delta instead) |
+| **--partial-only** | <code>boolean</code> | Upload only partial files to Capgo cloud, skip the zipped file, useful for big bundle (deprecated, use --delta-only instead) |
+| **--delta** | <code>boolean</code> | Upload delta update to Capgo cloud (old name: --partial) |
+| **--delta-only** | <code>boolean</code> | Upload only delta update to Capgo cloud, skip the zipped file, useful for big bundle (old name: --partial-only) |
 | **--encrypted-checksum** | <code>string</code> | An encrypted checksum (signature). Used only when uploading an external bundle. |
 | **--auto-set-bundle** | <code>boolean</code> | Set the bundle in capacitor.config.json |
 | **--dry-upload** | <code>boolean</code> | Dry upload the bundle process, mean it will not upload the files but add the row in database (Used by Capgo for internal testing) |
@@ -206,6 +208,8 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 | **--delete-linked-bundle-on-upload** | <code>boolean</code> | Locates the currently linked bundle in the channel you are trying to upload to, and deletes it |
 | **--no-brotli-patterns** | <code>string</code> | Glob patterns for files to exclude from brotli compression (comma-separated) |
 | **--disable-brotli** | <code>boolean</code> | Completely disable brotli compression even if updater version supports it |
+| **--version-exists-ok** | <code>boolean</code> | Exit successfully if bundle version already exists, useful for CI/CD workflows with monorepos |
+| **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel, this will update the channel, if not provided it will leave the channel as is |
 | **--supa-host** | <code>string</code> | Supabase host URL, for self-hosted Capgo or testing |
 | **--supa-anon** | <code>string</code> | Supabase anon token, for self-hosted Capgo or testing |
 
@@ -320,6 +324,8 @@ npx @capgo/cli@latest bundle encrypt
 
 🔒 Encrypt a zip bundle using the new encryption method for secure external storage or testing.
 Used with external sources or for testing, prints ivSessionKey for upload or decryption.
+The command will return the ivSessionKey for upload or decryption.
+The checksum is the checksum of the zip file, you can get it with the --json option of the zip command.
 
 **Example:**
 
@@ -366,6 +372,7 @@ npx @capgo/cli@latest bundle zip
 
 🗜️ Create a zip file of your app bundle for upload or local storage.
 Useful for preparing bundles before encryption or upload.
+The command will return the checksum of the zip file, you can use it to encrypt the zip file with the --key-v2 option.
 
 **Example:**
 
@@ -563,6 +570,7 @@ npx @capgo/cli@latest channel add production com.example.app --default
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
 | **-d,** | <code>string</code> | Set the channel as default |
+| **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel |
 | **-a,** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Supabase host URL, for self-hosted Capgo or testing |
 | **--supa-anon** | <code>string</code> | Supabase anon token, for self-hosted Capgo or testing |
@@ -696,13 +704,13 @@ npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --st
 npx @capgo/cli@latest key save
 ```
 
-💾 Save a base64 encryption key in the Capacitor config, useful for CI environments.
+💾 Save the public key in the Capacitor config, useful for CI environments.
 Recommended not to commit the key for security.
 
 **Example:**
 
 ```bash
-npx @capgo/cli@latest key save --key ./path/to/key
+npx @capgo/cli@latest key save --key ./path/to/key.pub
 ```
 
 **Options:**
@@ -721,6 +729,10 @@ npx @capgo/cli@latest key create
 
 🔨 Create a new encryption key pair for end-to-end encryption in Capgo Cloud.
 Do not commit or share the private key; save it securely.
+This command will create a new key pair with the name .capgo_key_v2 and .capgo_key_v2.pub in the root of the project.
+The public key is used to decrypt the zip file in the mobile app.
+The public key will also be stored in the capacitor config. This is the one used in the mobile app. The file is just a backup.
+The private key is used to encrypt the zip file in the CLI.
 
 **Example:**