@capgo/cli 8.24.6 → 8.25.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -165,6 +165,8 @@ Join the [discord](https://discord.gg/VnYRvBfgA6) to get help.
165
165
  - [Update](#build-credentials-update)
166
166
  - [Manage](#build-credentials-manage)
167
167
  - [Migrate](#build-credentials-migrate)
168
+ - 🔹 [Notifications](#notifications)
169
+ - [Setup](#notifications-setup)
168
170
  - 🔹 [Probe](#probe)
169
171
  - 🔹 [Generate-docs](#generate-docs)
170
172
  - 🔹 [Mcp](#mcp)
@@ -364,6 +366,9 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
364
366
  | **-a** | <code>string</code> | API key to link to your account |
365
367
  | **-p** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
366
368
  | **-c** | <code>string</code> | Channel to link to. Use commas for multiple channels, for example production,beta |
369
+ | **--rollout** | <code>string</code> | Set the uploaded bundle as this channel's rollout target at a percentage from 0 to 100 |
370
+ | **--rollout-percentage-bps** | <code>string</code> | Set the uploaded bundle rollout percentage in basis points from 0 to 10000 |
371
+ | **--rollout-cache-ttl-seconds** | <code>string</code> | Cloudflare rollout decision cache TTL in seconds |
367
372
  | **-e** | <code>string</code> | Link to external URL instead of upload to Capgo Cloud |
368
373
  | **--iv-session-key** | <code>string</code> | Set the IV and session key for bundle URL external |
369
374
  | **--s3-region** | <code>string</code> | Region for your S3 bucket |
@@ -922,6 +927,25 @@ npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --st
922
927
  | **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel |
923
928
  | **--no-self-assign** | <code>boolean</code> | Disable devices to self-assign to this channel |
924
929
  | **--disable-auto-update** | <code>string</code> | Block updates by type: major, minor, metadata, patch, or none (allows all) |
930
+ | **--rollout-bundle** | <code>string</code> | Bundle version to release gradually on this channel |
931
+ | **--rollout-percentage** | <code>string</code> | Rollout percentage from 0 to 100 |
932
+ | **--rollout-percentage-bps** | <code>string</code> | Rollout percentage in basis points from 0 to 10000 |
933
+ | **--rollout-enable** | <code>boolean</code> | Enable the configured rollout |
934
+ | **--rollout-disable** | <code>boolean</code> | Disable the configured rollout |
935
+ | **--rollout-pause** | <code>boolean</code> | Pause rollout exposure without rolling back selected devices |
936
+ | **--rollout-resume** | <code>boolean</code> | Resume a paused rollout |
937
+ | **--rollout-rollback** | <code>boolean</code> | Clear rollout state and return devices to stable |
938
+ | **--rollout-promote** | <code>boolean</code> | Promote rollout target to stable and clear rollout state |
939
+ | **--rollout-cache-ttl-seconds** | <code>string</code> | Cloudflare rollout decision cache TTL in seconds |
940
+ | **--auto-pause-enabled** | <code>boolean</code> | Enable rollout auto-pause policy |
941
+ | **--auto-pause-disabled** | <code>boolean</code> | Disable rollout auto-pause policy |
942
+ | **--auto-pause-window-minutes** | <code>string</code> | Stats window for rollout auto-pause |
943
+ | **--auto-pause-failure-rate-bps** | <code>string</code> | Failure-rate threshold in basis points |
944
+ | **--auto-pause-confidence** | <code>string</code> | Confidence level between 0 and 1 |
945
+ | **--auto-pause-min-attempts** | <code>string</code> | Minimum install plus fail attempts before auto-pause can trigger |
946
+ | **--auto-pause-min-failures** | <code>string</code> | Minimum failures before auto-pause can trigger |
947
+ | **--auto-pause-action** | <code>string</code> | Auto-pause action: pause, rollback, or notify |
948
+ | **--auto-pause-cooldown-minutes** | <code>string</code> | Cooldown before auto-pause can trigger again |
925
949
  | **--dev** | <code>boolean</code> | Allow sending update to development devices |
926
950
  | **--no-dev** | <code>boolean</code> | Disable sending update to development devices |
927
951
  | **--prod** | <code>boolean</code> | Allow sending update to production devices |
@@ -1706,6 +1730,36 @@ Example:
1706
1730
  | **--local** | <code>boolean</code> | Migrate from local .capgo-credentials.json instead of global |
1707
1731
 
1708
1732
 
1733
+ ## <a id="notifications"></a> 🔹 **Notifications**
1734
+
1735
+ 🔔 Set up Capgo native notifications in your Capacitor app.
1736
+
1737
+ ### <a id="notifications-setup"></a> ⚙️ **Setup**
1738
+
1739
+ ```bash
1740
+ npx @capgo/cli@latest notifications setup
1741
+ ```
1742
+
1743
+ Install the Capgo notifications plugin, add Capacitor config, create a helper file, and run Capacitor sync.
1744
+ Before sending production notifications, configure Android and iOS push credentials in the Capgo app Notifications tab.
1745
+
1746
+ **Example:**
1747
+
1748
+ ```bash
1749
+ npx @capgo/cli@latest notifications setup com.example.app
1750
+ ```
1751
+
1752
+ **Options:**
1753
+
1754
+ | Param | Type | Description |
1755
+ | -------------- | ------------- | -------------------- |
1756
+ | **--server-url** | <code>string</code> | Capgo API server URL |
1757
+ | **--file** | <code>string</code> | Helper file to create (default: src/capgo-notifications.ts) |
1758
+ | **--force** | <code>boolean</code> | Overwrite the helper file if it already exists |
1759
+ | **--no-install** | <code>boolean</code> | Skip installing the notifications package |
1760
+ | **--no-sync** | <code>boolean</code> | Skip Capacitor sync |
1761
+
1762
+
1709
1763
  ## <a id="probe"></a> 🔹 **Probe**
1710
1764
 
1711
1765
  ```bash