@capgo/cli 8.43.0 → 8.45.0

package/README.md

@@ -178,6 +178,7 @@ Capgo continues to load the root config while writing only the selected source.
     - [Clear](#build-credentials-clear)
     - [Update](#build-credentials-update)
     - [Manage](#build-credentials-manage)
+    - [Export](#build-credentials-export)
     - [Migrate](#build-credentials-migrate)
 - 🔹 [Notifications](#notifications)
   - [Setup](#notifications-setup)
@@ -403,6 +404,7 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 | **--bundle-url** | <code>boolean</code> | Prints bundle URL into stdout |
 | **--no-key** | <code>boolean</code> | Ignore signing key and send clear update |
 | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
+| **--ignore-notify-app-ready** | <code>boolean</code> | Skip notifyAppReady() check (not recommended — updates may roll back) |
 | **--display-iv-session** | <code>boolean</code> | Show in the console the IV and session key used to encrypt the update |
 | **-b** | <code>string</code> | Bundle version number of the bundle to upload |
 | **--link** | <code>string</code> | Link to external resource (e.g. GitHub release) |
@@ -606,7 +608,7 @@ Prints base64 session key for verification.
 **Example:**
 
 ```bash
-npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM
+npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip IV_BASE64:SESSION_KEY_BASE64
 ```
 
 **Options:**
@@ -642,6 +644,7 @@ npx @capgo/cli@latest bundle zip com.example.app --path ./dist
 | **-n** | <code>string</code> | Name of the zip file |
 | **-j** | <code>boolean</code> | Output in JSON |
 | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
+| **--ignore-notify-app-ready** | <code>boolean</code> | Skip notifyAppReady() check (not recommended — updates may roll back) |
 | **--key-v2** | <code>boolean</code> | Use encryption v2 |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
 
@@ -1782,6 +1785,30 @@ Examples:
 | **--platform** | <code>string</code> | Platform to manage: ios or android (optional, prompts to pick if omitted) |
 | **--local** | <code>boolean</code> | Only browse local .capgo-credentials.json |
 
+#### <a id="build-credentials-export"></a> 🔹 **Export**
+
+```bash
+npx @capgo/cli@latest build credentials export
+```
+
+Export one saved Builder credential or configuration value.
+Raw mode prints only the exact stored value to stdout with no trailing newline.
+All failures are written to stderr and exit with status 1. Saved local/global
+configuration is used; environment variables are never exported.
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--app-id** | <code>string</code> | App ID whose saved Builder value will be exported (required) |
+| **--appId** | <code>string</code> | Compatibility alias for --app-id |
+| **--platform** | <code>string</code> | Platform: ios or android (required when saved platform values are ambiguous) |
+| **--local** | <code>boolean</code> | Export only from the project-local .capgo-credentials.json |
+| **--global** | <code>boolean</code> | Export only from ~/.capgo-credentials/credentials.json |
+| **--file** | <code>string</code> | Write the value to a new file; existing destinations are never overwritten |
+| **--raw** | <code>boolean</code> | Write only the exact stored value to stdout without a trailing newline |
+| **--decode-base64** | <code>boolean</code> | Decode Base64 before file output; valid only with --file |
+
 #### <a id="build-credentials-migrate"></a> 🔹 **Migrate**
 
 ```bash