@capgo/cli 7.104.0 → 7.105.0

package/README.md

@@ -74,6 +74,7 @@ Follow the documentation here: https://capacitorjs.com/docs/getting-started/
   - [Needed](#build-needed)
   - [Init](#build-init)
   - [Request](#build-request)
+  - [Last-output](#build-last-output)
   - [Credentials](#build-credentials)
     - [Save](#build-credentials-save)
     - [List](#build-credentials-list)
@@ -1157,6 +1158,11 @@ npx @capgo/cli@latest organisation delete
    Save your credentials first:
    npx @capgo/cli build credentials save --appId <your-app-id> --platform ios
    npx @capgo/cli build credentials save --appId <your-app-id> --platform android
+📤 CAPTURE THE OUTPUT URL FROM CI:
+   Pass --output-record to persist the download URL + QR code, then read it
+   back with `build last-output`:
+   npx @capgo/cli build request <appId> --platform android --output-upload --output-record /tmp/build.json
+   URL=$(npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl)
 
 ### <a id="build-needed"></a> 🔹 **Needed**
 
@@ -1252,6 +1258,7 @@ npx @capgo/cli@latest build request com.example.app --platform ios --path .
 | **--output-upload** | <code>boolean</code> | Override output upload behavior for this build only (enable). Precedence: CLI > env > saved credentials |
 | **--no-output-upload** | <code>boolean</code> | Override output upload behavior for this build only (disable). Precedence: CLI > env > saved credentials |
 | **--output-retention** | <code>string</code> | Override output link TTL for this build only (1h to 7d). Examples: 1h, 6h, 2d. Precedence: CLI > env > saved credentials |
+| **--output-record** | <code>string</code> | After a successful build, write a JSON record (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) to <path>. A PNG QR code is also written next to it as <path>.qr.png. Read fields back with `build last-output`. |
 | **--skip-build-number-bump** | <code>boolean</code> | Skip automatic build number/version code incrementing. Uses whatever version is already in the project files. |
 | **--no-skip-build-number-bump** | <code>boolean</code> | Override saved credentials to re-enable automatic build number incrementing for this build only. |
 | **-a** | <code>string</code> | API key to link to your account |
@@ -1259,6 +1266,29 @@ npx @capgo/cli@latest build request com.example.app --platform ios --path .
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
 
+### <a id="build-last-output"></a> 🔹 **Last-output**
+
+```bash
+npx @capgo/cli@latest build last-output
+```
+
+Read the build output record written by a previous `build request --output-record`.
+Prints the full JSON by default, a single field with --field, or the ASCII QR
+code with --qr. Useful in CI to grab the download URL or QR for posting back
+to a PR or issue.
+Examples:
+  npx @capgo/cli build last-output --path /tmp/build.json
+  npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl
+  npx @capgo/cli build last-output --path /tmp/build.json --qr
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--path** | <code>string</code> | Path to the JSON record written by --output-record (required) |
+| **--field** | <code>string</code> | Print a single field (one of: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
+| **--qr** | <code>boolean</code> | Print the rendered ASCII QR code (shortcut for --field qrCodeAscii) |
+
 ### <a id="build-credentials"></a> 🔹 **Credentials**
 
 Manage build credentials stored locally on your machine.