hotcodepush 0.1.0 → 0.2.0

package/dist/completion/hotcodepush.zsh

@@ -15,12 +15,12 @@ _hotcodepush() {
       'customer-portal-session:create'
       'device:delete, get, list, probe'
       'doctor:Check the project: its configuration, the hook wiring, the signing key, the hosts and the versions a bug report needs.'
-      'fingerprint:Print the project'\''s native fingerprint with the packages and the files under the extra fingerprint paths that contribute to it; local, no login.'
+      'fingerprint:Print the project'\''s native fingerprint with the packages and the files under the extra fingerprint paths that contribute to it. Runs locally without a login.'
       'init:Set a React Native, Expo, Capacitor or Cordova project up from sign-in to the first release, re-runnable at any step.'
       'invitation:accept, create, delete, list'
       'limit:list'
       'login:Log in by approving a one-time code in the browser.'
-      'logout:End the stored session and remove its token; HOTCODEPUSH_TOKEN, when set, stays what it is.'
+      'logout:End the stored session and remove its token. HOTCODEPUSH_TOKEN, when set, stays what it is.'
       'member:delete, get, list, update'
       'open:Open the app'\''s console page in the browser, or the channel'\''s, from hotcodepush.json.'
       'organization:create, delete, get, list, update'
@@ -42,7 +42,7 @@ _hotcodepush() {
       'app')
         completions=(
           'create:Create an app with its default channel, production.'
-          'delete:Delete an app with its channels, bundles and releases; support can restore it for seven days.'
+          'delete:Delete an app with its channels, bundles and releases. Support can restore it for seven days.'
           'get:Print an app, hotcodepush.json'\''s by default.'
           'list:List an organization'\''s apps, newest first.'
           'transfer:Move an app to the organization --organization names, one you are an Admin of.'
@@ -53,7 +53,7 @@ _hotcodepush() {
         ;;
       'audience')
         completions=(
-          'get:Preview the devices a release'\''s conditions would reach in a channel, before it exists, the project'\''s fingerprint among them; what release create --dry-run prints.'
+          'get:Preview the devices a release'\''s conditions would reach in a channel, before it exists, the project'\''s fingerprint among them. This is what release create --dry-run prints.'
         )
         _describe -t commands 'audience command' completions
         return
@@ -67,7 +67,7 @@ _hotcodepush() {
         ;;
       'binary')
         completions=(
-          'create:The build step of a store build: creates the binary with the embedded bundle it ships and writes the resource file the SDK reads, naming that bundle; every other build runs resource-file write. HOTCODEPUSH_OFFLINE=1 builds without the API, naming no channel unless it is given by id and creating no binary.'
+          'create:The build step of a store build: creates the binary with the embedded bundle it ships and writes the resource file the SDK reads, naming that bundle. Every other build runs resource-file write. HOTCODEPUSH_OFFLINE=1 builds without the API, naming no channel unless it is given by id and creating no binary.'
           'get:Print a binary, a store build whose build created it, with the bundle it ships and the devices running it.'
           'list:List the binaries, the store builds whose build created one, with the bundle each ships and the devices running it.'
         )
@@ -76,10 +76,10 @@ _hotcodepush() {
         ;;
       'bundle')
         completions=(
-          'delete:Delete a bundle now; one a release serves or a store build embeds is refused.'
+          'delete:Delete a bundle now. One a release serves or a store build embeds is refused.'
           'get:Print a bundle, by its number or id, with its deltas.'
           'list:List an app'\''s bundles, newest first: the uploaded ones by default, the ones binaries ship with --source binary, both with --source all.'
-          'upload:Upload a build as a bundle, signed where a key is configured: only the files the app lacks move, then the full pack; nothing is released.'
+          'upload:Upload a build as a bundle, signed where a key is configured. Only the files the app lacks move, then the full pack. Nothing is released.'
         )
         _describe -t commands 'bundle command' completions
         return
@@ -87,7 +87,7 @@ _hotcodepush() {
       'channel')
         completions=(
           'create:Create a channel in an app, with an expiry for a preview channel and its auto-pause policy.'
-          'delete:Delete a channel and its releases; devices on it keep what they have.'
+          'delete:Delete a channel and its releases. Devices on it keep what they have.'
           'get:Print a channel with its device counts, hotcodepush.json'\''s by default.'
           'list:List an app'\''s channels, newest first.'
           'pause:Pause a channel, the kill switch: it serves nothing new until resumed.'
@@ -113,9 +113,9 @@ _hotcodepush() {
         ;;
       'device')
         completions=(
-          'delete:Delete a device'\''s record, an erasure request; the device reports again with its next check.'
+          'delete:Delete a device'\''s record, an erasure request. The device reports again with its next check.'
           'get:Print what a device runs and reported last, with its outcome per release, newest first.'
-          'list:List the app'\''s devices, the newest report first, filtered by what they reported; support and QA, never a pipeline.'
+          'list:List the app'\''s devices, the newest report first, filtered by what they reported. It is for support and QA, never for a pipeline.'
           'probe:Answer why a device did not update: fetch the live index as a device would, evaluate it and mark every condition of every release.'
         )
         _describe -t commands 'device command' completions
@@ -123,7 +123,7 @@ _hotcodepush() {
         ;;
       'fingerprint')
         completions=(
-          'diff:Print the packages and extra fingerprint paths added, removed or moved between <file-a> and <file-b>, two files written by fingerprint --json, the earlier first; local, no login.'
+          'diff:Print the packages and extra fingerprint paths added, removed or moved between <file-a> and <file-b>, two files written by fingerprint --json, the earlier first. Runs locally without a login.'
         )
         _describe -t commands 'fingerprint command' completions
         return
@@ -131,8 +131,8 @@ _hotcodepush() {
       'invitation')
         completions=(
           'accept:Accept an invitation to an organization with the token from its mail.'
-          'create:Invite an address to the organization with a role; the invitation mail is valid for two days.'
-          'delete:Withdraw a pending invitation; the link in its mail stops working at once.'
+          'create:Invite an address to the organization with a role. The invitation mail is valid for two days.'
+          'delete:Withdraw a pending invitation. The link in its mail stops working at once.'
           'list:List the organization'\''s pending invitations, the ones a link can still accept, newest first.'
         )
         _describe -t commands 'invitation command' completions
@@ -147,7 +147,7 @@ _hotcodepush() {
         ;;
       'member')
         completions=(
-          'delete:Remove a member from the organization, or yourself to leave it; the Owner leaves only after transferring the ownership.'
+          'delete:Remove a member from the organization, or yourself to leave it. The Owner leaves only after transferring the ownership.'
           'get:Print a member of the organization with their role and how they sign in.'
           'list:List the organization'\''s members with their roles, newest first.'
           'update:Change a member'\''s role; --role owner transfers the ownership to them, makes you an admin and asks once, --yes confirming in scripts.'
@@ -158,7 +158,7 @@ _hotcodepush() {
       'organization')
         completions=(
           'create:Create an organization with you as its Owner.'
-          'delete:Delete an organization with everything in it; support can restore it for seven days.'
+          'delete:Delete an organization with everything in it. Support can restore it for seven days.'
           'get:Print an organization with its plan, spending cap and region.'
           'list:List your organizations with your role in each, newest first.'
           'update:Rename an organization or set its spending cap, which applies now.'
@@ -175,7 +175,7 @@ _hotcodepush() {
           'resume:Resume a paused release: devices get it again, and a new auto-pause window starts.'
           'revoke:Revoke releases for good: devices on them move to the newest older release they qualify for or the embedded bundle.'
           'rollback:Release the channel'\''s previous bundle again, or the one of --to-release, as a new release.'
-          'rollout:Set a release'\''s rollout percentage in either direction, or widen it step by step with --progression; a device that has the release keeps it.'
+          'rollout:Set a release'\''s rollout percentage in either direction, or widen it step by step with --progression. A device that has the release keeps it.'
           'update:Edit a published release in place: flip the mandatory flag, rewrite or clear the notes, change or clear an auto-pause override.'
         )
         _describe -t commands 'release command' completions
@@ -202,7 +202,7 @@ _hotcodepush() {
         completions=(
           'delete:Delete the organization'\''s SSO provider: password sign-in works again for its members, and the domain is forgotten.'
           'get:Print the organization'\''s SSO provider with its sign-in link and, until the domain is verified, the TXT record to set.'
-          'set:Set the organization'\''s OIDC or SAML provider and its email domain, replacing the one before; a new domain starts unverified.'
+          'set:Set the organization'\''s OIDC or SAML provider and its email domain, replacing the one before. A new domain starts unverified.'
           'verify:Look up the domain'\''s TXT record and mark the domain verified when it is there.'
         )
         _describe -t commands 'sso-provider command' completions
@@ -210,7 +210,7 @@ _hotcodepush() {
         ;;
       'statistics')
         completions=(
-          'get:Print one of the app'\''s statistics: the fleet, the devices seen in 30 days; the updates per day; or the usage the bill counts.'
+          'get:Print one of the app'\''s statistics: the fleet of devices seen in 30 days, the updates per day, or the usage the bill counts.'
         )
         _describe -t commands 'statistics command' completions
         return
@@ -225,20 +225,20 @@ _hotcodepush() {
         ;;
       'webhook')
         completions=(
-          'create:Create a webhook that posts the organization'\''s events to a URL, as signed JSON or as a Slack, Discord or Teams message; a raw webhook'\''s secret is printed this once.'
+          'create:Create a webhook that posts the organization'\''s events to a URL, as signed JSON or as a Slack, Discord or Teams message. A raw webhook'\''s secret is printed this once.'
           'delete:Delete a webhook and its delivery log.'
-          'get:Print a webhook: its URL, format, events, app filter and whether it is enabled; never its secret.'
+          'get:Print a webhook: its URL, format, events, app filter and whether it is enabled. The secret is never printed.'
           'list:List an organization'\''s webhooks, newest first.'
           'test:Send one sample event, webhook.test, to a webhook'\''s URL and print the receiver'\''s answer.'
-          'update:Rename a webhook or change its URL, events, app filter or whether it is enabled; the format and the secret never change.'
+          'update:Rename a webhook or change its URL, events, app filter or whether it is enabled. The format and the secret never change.'
         )
         _describe -t commands 'webhook command' completions
         return
         ;;
       'webhook-delivery')
         completions=(
-          'list:List a webhook'\''s deliveries, newest first, filtered by status and time, to find the ones worth redelivering; each is kept for 30 days.'
-          'redeliver:Deliver a webhook'\''s event again, once, and print the receiver'\''s answer; a pending delivery is taken from the retries.'
+          'list:List a webhook'\''s deliveries, newest first, filtered by status and time, to find the ones worth redelivering. Each is kept for 30 days.'
+          'redeliver:Deliver a webhook'\''s event again, once, and print the receiver'\''s answer. A pending delivery is taken from the retries.'
         )
         _describe -t commands 'webhook-delivery command' completions
         return
@@ -319,7 +319,7 @@ _hotcodepush() {
       ;;
     'audience get')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '*--attribute[An attribute the app sets that the device must carry, key=value, repeatable.]:attribute:_files' \
         '--binary-version[The app versions served, a semver range such as ">=2.3.0 <3.0.0".]:binary-version:_files' \
         '*--device[A device the release is limited to, by id, repeatable.]:device:_files' \
@@ -340,7 +340,7 @@ _hotcodepush() {
         '--offset[How many to skip: the offset the previous page ended with.]:offset:_files' \
         '--actor[The user who acted, by id.]:actor:_files' \
         '--actor-type[system for the rows no user wrote, user for the rest.]:actor-type:(system user)' \
-        '--app[The app, by id or name, to narrow the log to; the whole organization by default, never hotcodepush.json'\''s app.]:app:_files' \
+        '--app[The app, by id or name, to narrow the log to. Defaults to the whole organization, never to hotcodepush.json'\''s app.]:app:_files' \
         '--created-since[The earliest row, inclusive: an ISO 8601 timestamp or a duration ago such as 2h or 7d.]:created-since:_files' \
         '--created-until[The latest row, inclusive: an ISO 8601 timestamp or a duration ago such as 2h or 7d.]:created-until:_files' \
         '--type[The type, such as channel.created, or channel.* for every action on the object.]:type:_files' \
@@ -354,7 +354,7 @@ _hotcodepush() {
       ;;
     'binary create')
       _hotcodepush_arguments 2 \
-        '--embedded-bundle-path[The directory of the embedded bundle, the files the build puts into the app; the framework'\''s build output by default.]:embedded-bundle-path:_files' \
+        '--embedded-bundle-path[The directory of the embedded bundle, the files the build puts into the app. Defaults to the framework'\''s build output.]:embedded-bundle-path:_files' \
         '--platform[The platform being built, ios or android.]:platform:(android ios)' \
         '--resource-file-path[Where the resource file goes, in the app the build makes.]:resource-file-path:_files' \
         '--binary-build[The store build'\''s build number, from the build'\''s variables.]:binary-build:_files' \
@@ -423,7 +423,7 @@ _hotcodepush() {
         '--limit[How many to list, at most 100; 50 by default.]:limit:_files' \
         '--offset[How many to skip: the offset the previous page ended with.]:offset:_files' \
         '--bundle-version[Only the bundles carrying this version label.]:bundle-version:_files' \
-        '--source[upload, the bundles a release can carry, by default; binary, the ones binaries ship, which have no number; or all.]:source:(all binary upload)' \
+        '--source[upload is the bundles a release can carry, binary is the ones binaries ship, which have no number, and all is both. Defaults to upload.]:source:(all binary upload)' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -435,14 +435,14 @@ _hotcodepush() {
       ;;
     'bundle upload')
       _hotcodepush_arguments 2 \
-        '--bundle-version[The bundle'\''s version label; the project'\''s package.json version by default.]:bundle-version:_files' \
+        '--bundle-version[The bundle'\''s version label. Defaults to the project'\''s package.json version.]:bundle-version:_files' \
         '--git-message[The commit message subject to record, over the detected one.]:git-message:_files' \
         '--git-ref[The branch or tag to record, over the detected one.]:git-ref:_files' \
         '--git-sha[The commit to record, over the detected one.]:git-sha:_files' \
-        '--no-git[Detect no git provenance; the typed --git-* flags still apply.]' \
+        '--no-git[Detect no git provenance. The typed --git-* flags still apply.]' \
         '--path[The build to upload, the framework'\''s build output by default: on React Native and Expo one platform'\''s prepared bundle, Capacitor'\''s webDir or Cordova'\''s www.]:path:_files' \
         '--platform[The platforms the bundle serves, ios,android by default.]:platform:(android ios)' \
-        '--private-key-path[The private key file to sign with, as signing-key create wrote it; HOTCODEPUSH_SIGNING_KEY holds its content in CI.]:private-key-path:_files' \
+        '--private-key-path[The private key file to sign with, as signing-key create wrote it. In CI, HOTCODEPUSH_SIGNING_KEY holds its content.]:private-key-path:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -454,13 +454,13 @@ _hotcodepush() {
       ;;
     'channel create')
       _hotcodepush_arguments 2 \
-        '--discoverable[Whether the app'\''s setChannel finds the channel by its name; pass false to turn it off.]' \
-        '--expires-at[When the preview channel expires, an ISO 8601 timestamp; not on protected or default channels.]:expires-at:_files' \
+        '--discoverable[Whether the app'\''s setChannel finds the channel by its name. Pass false to turn it off.]' \
+        '--expires-at[When the preview channel expires, an ISO 8601 timestamp. Protected and default channels have none.]:expires-at:_files' \
         '--expires-in[How long until the preview channel expires, 14d or 12h.]:expires-in:_files' \
         '--failure-action[What auto-pause does when a release fails too often: pause, revoke, notify or none.]:failure-action:(none notify pause revoke)' \
         '--failure-minimum-update-count[The applied updates a release needs before auto-pause judges it.]:failure-minimum-update-count:_files' \
         '--failure-threshold-percent[The failure percentage at which auto-pause acts.]:failure-threshold-percent:_files' \
-        '--protected[Whether only Owners and Admins change what the channel serves; pass false to turn it off.]' \
+        '--protected[Whether only Owners and Admins change what the channel serves. Pass false to turn it off.]' \
         '--if-not-exists[Return the channel of that name when it exists instead of failing, for re-run pipelines.]' \
         '--name[The name: letters, digits, - and _, one to 64 characters, unique in the app.]:name:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
@@ -474,7 +474,7 @@ _hotcodepush() {
       ;;
     'channel delete')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--ignore-not-found[Succeed when the channel does not exist, for re-run pipelines.]' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -487,7 +487,7 @@ _hotcodepush() {
       ;;
     'channel get')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -512,7 +512,7 @@ _hotcodepush() {
       ;;
     'channel pause')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -524,7 +524,7 @@ _hotcodepush() {
       ;;
     'channel resume')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -540,14 +540,14 @@ _hotcodepush() {
         '--clear-failure-action[Sets the action back to null: the default policy applies.]' \
         '--clear-failure-minimum-update-count[Sets the minimum update count back to null: the default policy applies.]' \
         '--clear-failure-threshold-percent[Sets the threshold back to null: the default policy applies.]' \
-        '--discoverable[Whether the app'\''s setChannel finds the channel by its name; pass false to turn it off.]' \
-        '--expires-at[When the preview channel expires, an ISO 8601 timestamp; not on protected or default channels.]:expires-at:_files' \
+        '--discoverable[Whether the app'\''s setChannel finds the channel by its name. Pass false to turn it off.]' \
+        '--expires-at[When the preview channel expires, an ISO 8601 timestamp. Protected and default channels have none.]:expires-at:_files' \
         '--expires-in[How long until the preview channel expires, 14d or 12h.]:expires-in:_files' \
         '--failure-action[What auto-pause does when a release fails too often: pause, revoke, notify or none.]:failure-action:(none notify pause revoke)' \
         '--failure-minimum-update-count[The applied updates a release needs before auto-pause judges it.]:failure-minimum-update-count:_files' \
         '--failure-threshold-percent[The failure percentage at which auto-pause acts.]:failure-threshold-percent:_files' \
-        '--protected[Whether only Owners and Admins change what the channel serves; pass false to turn it off.]' \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--protected[Whether only Owners and Admins change what the channel serves. Pass false to turn it off.]' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--name[The channel'\''s new name: letters, digits, - and _, one to 64 characters.]:name:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -628,7 +628,7 @@ _hotcodepush() {
       ;;
     'device probe')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--device[The device, by the id it generated, as the debug screen and device list show it.]:device:_files' \
         '*--attribute[An attribute the app sets, key=value, repeatable.]:attribute:_files' \
         '--binary-build[The store build'\''s build number, CFBundleVersion or versionCode.]:binary-build:_files' \
@@ -829,14 +829,14 @@ _hotcodepush() {
       ;;
     'release create')
       _hotcodepush_arguments 2 \
-        '--bundle-version[The bundle'\''s version label; the project'\''s package.json version by default.]:bundle-version:_files' \
+        '--bundle-version[The bundle'\''s version label. Defaults to the project'\''s package.json version.]:bundle-version:_files' \
         '--git-message[The commit message subject to record, over the detected one.]:git-message:_files' \
         '--git-ref[The branch or tag to record, over the detected one.]:git-ref:_files' \
         '--git-sha[The commit to record, over the detected one.]:git-sha:_files' \
-        '--no-git[Detect no git provenance; the typed --git-* flags still apply.]' \
+        '--no-git[Detect no git provenance. The typed --git-* flags still apply.]' \
         '--path[The build to upload, the framework'\''s build output by default: on React Native and Expo one platform'\''s prepared bundle, Capacitor'\''s webDir or Cordova'\''s www.]:path:_files' \
         '--platform[The platforms the bundle serves, ios,android by default.]:platform:(android ios)' \
-        '--private-key-path[The private key file to sign with, as signing-key create wrote it; HOTCODEPUSH_SIGNING_KEY holds its content in CI.]:private-key-path:_files' \
+        '--private-key-path[The private key file to sign with, as signing-key create wrote it. In CI, HOTCODEPUSH_SIGNING_KEY holds its content.]:private-key-path:_files' \
         '*--attribute[An attribute the app sets that the device must carry, key=value, repeatable.]:attribute:_files' \
         '--binary-version[The app versions served, a semver range such as ">=2.3.0 <3.0.0".]:binary-version:_files' \
         '*--device[A device the release is limited to, by id, repeatable.]:device:_files' \
@@ -848,12 +848,12 @@ _hotcodepush() {
         '--progression-minimum-seconds[The seconds a step lasts at least before the next one, with --progression; 3600 by default.]:progression-minimum-seconds:_files' \
         '--progression-minimum-update-count[The applied updates each step needs before the next one, with --progression; 50 by default.]:progression-minimum-update-count:_files' \
         '--progression-rollout-percents[The percentages the rollout widens through, rising, the last above the starting rollout, with --progression; 10,50,100 by default.]:progression-rollout-percents:_files' \
-        '--bundle[A bundle already uploaded, by number or id; without it the build is uploaded first.]:bundle:_files' \
-        '*--channel[The channel, by id or name, repeatable; hotcodepush.json'\''s channel by default.]:channel:_files' \
-        '--dry-run[Validate and print the audience the release would reach; nothing is signed, uploaded or published, so no private key is needed.]' \
+        '--bundle[A bundle already uploaded, by number or id. Without it the build is uploaded first.]:bundle:_files' \
+        '*--channel[The channel, by id or name, repeatable. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
+        '--dry-run[Validate and print the audience the release would reach. Nothing is signed, uploaded or published, so no private key is needed.]' \
         '--from-channel[Release what this channel serves, by id or name, instead of a bundle or a build.]:from-channel:_files' \
         '--mandatory[Devices apply the release at once and restart.]' \
-        '--notes[The release notes; they ride the public index.]:notes:_files' \
+        '--notes[The release notes. They ride the public index.]:notes:_files' \
         '--rollout-percent[The share of devices the release reaches, 0 to 100; 100 by default, the schedule'\''s first percentage with --progression.]:rollout-percent:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -866,7 +866,7 @@ _hotcodepush() {
       ;;
     'release get')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -879,7 +879,7 @@ _hotcodepush() {
       ;;
     'release list')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--limit[How many to list, at most 100; 50 by default.]:limit:_files' \
         '--offset[How many to skip: the offset the previous page ended with.]:offset:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
@@ -893,7 +893,7 @@ _hotcodepush() {
       ;;
     'release pause')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -906,7 +906,7 @@ _hotcodepush() {
       ;;
     'release resume')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -919,10 +919,10 @@ _hotcodepush() {
       ;;
     'release revoke')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
-        '--all[Every release of the channel; its devices return to the embedded bundle.]' \
-        '--bundle[Every release of this bundle, by number or id, across the app'\''s channels; without --channel.]:bundle:_files' \
+        '--all[Every release of the channel. Its devices return to the embedded bundle.]' \
+        '--bundle[Every release of this bundle, by number or id, across the app'\''s channels. Takes no --channel.]:bundle:_files' \
         '--release-from[The first release revoked, by number, inclusive: that one and every newer one of the channel.]:release-from:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -935,9 +935,9 @@ _hotcodepush() {
       ;;
     'release rollback')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
-        '--mandatory[Devices apply the rollback at once and restart, the default for an incident fix; pass false to let them wait.]' \
-        '--to-release[The release whose bundle comes back, by number or id; the channel'\''s previous one by default.]:to-release:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
+        '--mandatory[Devices apply the rollback at once and restart, the default for an incident fix. Pass false to let them wait.]' \
+        '--to-release[The release whose bundle comes back, by number or id. Defaults to the channel'\''s previous one.]:to-release:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -949,13 +949,13 @@ _hotcodepush() {
       ;;
     'release rollout')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--progression[Widen the rollout step by step while the release stays healthy: 10, 50 and 100 percent by default, each step after at least an hour and 50 applied updates.]' \
         '--progression-minimum-seconds[The seconds a step lasts at least before the next one, with --progression; 3600 by default.]:progression-minimum-seconds:_files' \
         '--progression-minimum-update-count[The applied updates each step needs before the next one, with --progression; 50 by default.]:progression-minimum-update-count:_files' \
         '--progression-rollout-percents[The percentages the rollout widens through, rising, the last above the starting rollout, with --progression; 10,50,100 by default.]:progression-rollout-percents:_files' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
-        '--rollout-percent[The share of devices the release reaches from now on, 0 to 100; with --progression where the schedule starts, the release'\''s own percentage by default.]:rollout-percent:_files' \
+        '--rollout-percent[The share of devices the release reaches from now on, 0 to 100. With --progression it is where the schedule starts. Defaults to the release'\''s own percentage.]:rollout-percent:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -967,7 +967,7 @@ _hotcodepush() {
       ;;
     'release update')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--failure-action[What auto-pause does when a release fails too often: pause, revoke, notify or none.]:failure-action:(none notify pause revoke)' \
         '--failure-minimum-update-count[The applied updates a release needs before auto-pause judges it.]:failure-minimum-update-count:_files' \
         '--failure-threshold-percent[The failure percentage at which auto-pause acts.]:failure-threshold-percent:_files' \
@@ -976,7 +976,7 @@ _hotcodepush() {
         '--clear-failure-threshold-percent[Sets the threshold back to null: the channel'\''s value applies.]' \
         '--release[The release, by its number in the channel or by its id.]:release:_files' \
         '--clear-notes[Sets the notes back to null.]' \
-        '--mandatory[Whether devices apply the release at once and restart; pass false to turn it off.]' \
+        '--mandatory[Whether devices apply the release at once and restart. Pass false to turn it off.]' \
         '--notes[The new release notes.]:notes:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -989,7 +989,7 @@ _hotcodepush() {
       ;;
     'resource-file write')
       _hotcodepush_arguments 2 \
-        '--embedded-bundle-path[The directory of the embedded bundle, the files the build puts into the app; the framework'\''s build output by default.]:embedded-bundle-path:_files' \
+        '--embedded-bundle-path[The directory of the embedded bundle, the files the build puts into the app. Defaults to the framework'\''s build output.]:embedded-bundle-path:_files' \
         '--platform[The platform being built, ios or android.]:platform:(android ios)' \
         '--resource-file-path[Where the resource file goes, in the app the build makes.]:resource-file-path:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
@@ -1003,7 +1003,7 @@ _hotcodepush() {
       ;;
     'signing-key add')
       _hotcodepush_arguments 2 \
-        '--private-key-path[The private key file of the pair, a PEM of PKCS #8 or PKCS #1, read on this machine; its public key is derived from it.]:private-key-path:_files' \
+        '--private-key-path[The private key file of the pair, a PEM of PKCS #8 or PKCS #1, read on this machine. Its public key is derived from it.]:private-key-path:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -1107,10 +1107,10 @@ _hotcodepush() {
       ;;
     'statistics get')
       _hotcodepush_arguments 2 \
-        '--channel[The channel, by id or name, to narrow the fleet or the updates to; the whole app by default.]:channel:_files' \
+        '--channel[The channel, by id or name, to narrow the fleet or the updates to. Defaults to the whole app.]:channel:_files' \
         '--period-since[The first UTC day of the updates or the usage, YYYY-MM-DD, inclusive; 30 days before --period-until by default.]:period-since:_files' \
-        '--period-until[The last UTC day of the updates or the usage, YYYY-MM-DD, inclusive; today by default.]:period-until:_files' \
-        '--type[The statistics to print: fleet, the devices seen in 30 days; updates, per day; usage, the monthly active devices and the traffic.]:type:(fleet updates usage)' \
+        '--period-until[The last UTC day of the updates or the usage, YYYY-MM-DD, inclusive. Defaults to today.]:period-until:_files' \
+        '--type[The statistics to print. fleet is the devices seen in 30 days, updates is the updates per day, and usage is the monthly active devices and the traffic.]:type:(fleet updates usage)' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -1122,7 +1122,7 @@ _hotcodepush() {
       ;;
     'usage get')
       _hotcodepush_arguments 2 \
-        '--month[The month, YYYY-MM; the current one by default.]:month:_files' \
+        '--month[The month, YYYY-MM. Defaults to the current one.]:month:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -1134,7 +1134,7 @@ _hotcodepush() {
       ;;
     'usage list')
       _hotcodepush_arguments 2 \
-        '--month[The month, YYYY-MM; the current one by default.]:month:_files' \
+        '--month[The month, YYYY-MM. Defaults to the current one.]:month:_files' \
         '--limit[How many to list, at most 100; 50 by default.]:limit:_files' \
         '--offset[How many to skip: the offset the previous page ended with.]:offset:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
@@ -1148,7 +1148,7 @@ _hotcodepush() {
       ;;
     'webhook create')
       _hotcodepush_arguments 2 \
-        '--app[The app, by id or name, whose events alone the webhook receives; every app'\''s and the organization'\''s by default, never hotcodepush.json'\''s app.]:app:_files' \
+        '--app[The app, by id or name, whose events alone the webhook receives. Defaults to every app'\''s and the organization'\''s events, never to hotcodepush.json'\''s app.]:app:_files' \
         '*--event[An event type the webhook receives, such as release.created, repeatable.]:event:_files' \
         '--format[raw for HotCodePush'\''s signed JSON, slack, discord or teams for a message to that service'\''s incoming-webhook URL.]:format:(raw slack discord teams)' \
         '--name[The name, unique in the organization.]:name:_files' \
@@ -1212,11 +1212,11 @@ _hotcodepush() {
       ;;
     'webhook update')
       _hotcodepush_arguments 2 \
-        '--app[The app, by id or name, whose events alone the webhook receives; every app'\''s and the organization'\''s by default, never hotcodepush.json'\''s app.]:app:_files' \
+        '--app[The app, by id or name, whose events alone the webhook receives. Defaults to every app'\''s and the organization'\''s events, never to hotcodepush.json'\''s app.]:app:_files' \
         '*--event[An event type the webhook receives, such as release.created, repeatable.]:event:_files' \
         '--webhook[The webhook, by id or name.]:webhook:_files' \
         '--clear-app[Sets the app filter back to null: the webhook receives every app'\''s events and the organization'\''s.]' \
-        '--enabled[Whether the webhook delivers; turning it on again restarts the count of failures that disables it. Pass false to turn it off.]' \
+        '--enabled[Whether the webhook delivers. Turning it on again restarts the count of failures that disables it. Pass false to turn it off.]' \
         '--name[The webhook'\''s new name.]:name:_files' \
         '--url[The https URL the events are posted to.]:url:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
@@ -1308,7 +1308,7 @@ _hotcodepush() {
       ;;
     'login '*)
       _hotcodepush_arguments 1 \
-        '--api-url[The API to log in to, kept in config.json for every later command; the one kept there otherwise.]:api-url:_files' \
+        '--api-url[The API to log in to, kept in config.json for every later command. Defaults to the one kept there.]:api-url:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \
@@ -1331,7 +1331,7 @@ _hotcodepush() {
       ;;
     'open '*)
       _hotcodepush_arguments 1 \
-        '--channel[The channel, by id or name; hotcodepush.json'\''s channel by default.]:channel:_files' \
+        '--channel[The channel, by id or name. Defaults to hotcodepush.json'\''s channel.]:channel:_files' \
         '--app[The app, by id or name, when no hotcodepush.json is found or another app is meant.]:app:_files' \
         '--config[The hotcodepush.json to use, when it is not the nearest one up from the working directory.]:config:_files' \
         '--help[Print this help.]' \

package/dist/utils/audience.js

@@ -2,7 +2,7 @@ export function resolveAudienceText(audience, channelName, rolloutPercent) {
     const reachText = `reaches ${resolveCountText(audience.reachedDeviceCount)} of ${resolveCountText(audience.deviceCount)} active devices in ${channelName}`;
     return rolloutPercent === 100
         ? reachText
-        : `${reachText}; about ${resolveCountText(audience.estimatedDeviceCount)} at a ${rolloutPercent} percent rollout`;
+        : `${reachText}, about ${resolveCountText(audience.estimatedDeviceCount)} at a ${rolloutPercent} percent rollout`;
 }
 function resolveCountText(count) {
     return count.toLocaleString('en-US');

package/dist/utils/authentication.js

@@ -0,0 +1,60 @@
+import { createApiAuthClient, fetchSession } from './auth-client.js';
+import { printSuccess, printWarning } from './diagnostics.js';
+import { isInteractive } from './environment.js';
+import { CliError, ExitCode, NotLoggedInError } from './errors.js';
+import { logIn } from './login.js';
+import { promptYesNo } from './prompts.js';
+import { isEnvironmentToken, readStoredToken, readToken, } from './token-store.js';
+import { readUserConfig, writeStoredSession } from './user-config.js';
+// Authentication is a precondition of the command, never an error inside it, so nothing is retried.
+// A non-interactive run cannot log in, so it checks only that a token exists and leaves its validity to the API.
+export async function ensureAuthentication(options) {
+    if (!isInteractive(options)) {
+        if (readToken() === undefined) {
+            throw new NotLoggedInError();
+        }
+        return;
+    }
+    const sessionState = await readSessionState();
+    if (sessionState === 'usable') {
+        return;
+    }
+    printWarning(sessionState === 'expired'
+        ? 'Your session has expired.'
+        : 'You are not logged in.');
+    if (!(await promptYesNo('Log in now?', options))) {
+        throw new NotLoggedInError();
+    }
+    const user = await logIn(options);
+    printSuccess(`Logged in as ${user.name} (${user.email}).`);
+}
+// `HOTCODEPUSH_TOKEN` is taken as it is. Its validity is the API's to judge.
+// A session slides while in use, so a stored expiry that has passed is a hint, checked with one request before anyone is asked.
+export async function readSessionState() {
+    if (isEnvironmentToken()) {
+        return 'usable';
+    }
+    const storedToken = readStoredToken();
+    if (storedToken === undefined) {
+        return 'missing';
+    }
+    const { sessionExpiresAt } = readUserConfig();
+    if (sessionExpiresAt === undefined ||
+        new Date(sessionExpiresAt) > new Date()) {
+        return 'usable';
+    }
+    return (await refreshStoredSession(storedToken)) ? 'usable' : 'expired';
+}
+async function refreshStoredSession(storedToken) {
+    try {
+        const { session } = await fetchSession(createApiAuthClient(storedToken));
+        writeStoredSession(session);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof CliError && error.exitCode === ExitCode.NotLoggedIn) {
+            return false;
+        }
+        throw error;
+    }
+}

package/dist/utils/build-step.js

@@ -21,7 +21,7 @@ export const buildStepShape = {
     embeddedBundlePath: z
         .string()
         .optional()
-        .describe("The directory of the embedded bundle, the files the build puts into the app; the framework's build output by default."),
+        .describe("The directory of the embedded bundle, the files the build puts into the app. Defaults to the framework's build output."),
     platform: z
         .enum(PLATFORMS)
         .optional()