hotcodepush 0.1.0 → 0.2.0

package/dist/commands/invitation/delete.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { InvalidParameterError } from '../../utils/errors.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
@@ -8,7 +8,7 @@ import { fetchAllPages } from '../../utils/pagination.js';
 import { confirmConsequence, promptSelect } from '../../utils/prompts.js';
 import { fetchOrganizationId } from '../../utils/resource-resolution.js';
 export default defineCommand({
-    description: 'Withdraw a pending invitation; the link in its mail stops working at once.',
+    description: 'Withdraw a pending invitation. The link in its mail stops working at once.',
     examples: [
         'hotcodepush invitation delete --invitation anna@example.com',
         'hotcodepush invitation delete --invitation 4c8e2a6f-1d3b-4e97-a5c0-8f2d6b4a1e93 --yes --json',

package/dist/commands/invitation/list.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson, printTable, resolveDate } from '../../utils/output.js';
 import { paginationShape, resolveNextOffset } from '../../utils/pagination.js';

package/dist/commands/limit/list.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson, printTable } from '../../utils/output.js';
 import { fetchOrganizationId } from '../../utils/resource-resolution.js';

package/dist/commands/login.js

@@ -1,23 +1,12 @@
-import { setTimeout } from 'node:timers/promises';
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
-import { CLI_CLIENT_ID } from '../config/consts.js';
-import { createApiAuthClient, fetchSession, resolveResponseData, } from '../utils/auth-client.js';
-import { openBrowser } from '../utils/browser.js';
-import { isInteractive } from '../utils/environment.js';
-import { resolveApiError } from '../utils/error-mapping.js';
-import { LoginDeniedError, LoginExpiredError, NotLoggedInError, } from '../utils/errors.js';
+import { defineCommand } from '../utils/command.js';
 import { defineCommandOptions } from '../utils/global-options.js';
+import { logIn } from '../utils/login.js';
 import { printJson } from '../utils/output.js';
-import { writeToken } from '../utils/token-store.js';
 import { readUserConfig, writeUserConfig } from '../utils/user-config.js';
-// RFC 8628, section 3.2: without an interval from the server, a client polls every five seconds.
-const DEFAULT_INTERVAL_SECONDS = 5;
-const DEVICE_CODE_GRANT_TYPE = 'urn:ietf:params:oauth:grant-type:device_code';
-// RFC 8628, section 3.5: each slow_down adds five seconds to this and every later interval.
-const SLOW_DOWN_INCREMENT_SECONDS = 5;
 export default defineCommand({
     description: 'Log in by approving a one-time code in the browser.',
+    authentication: 'optional',
     examples: [
         'hotcodepush login',
         'hotcodepush login --api-url https://api.example.com --json',
@@ -30,7 +19,7 @@ export default defineCommand({
         })
             .transform(apiUrl => apiUrl.replace(/\/+$/, ''))
             .optional()
-            .describe('The API to log in to, kept in config.json for every later command; the one kept there otherwise.'),
+            .describe('The API to log in to, kept in config.json for every later command. Defaults to the one kept there.'),
     }),
     action: async (options) => {
         if (options.apiUrl !== undefined) {
@@ -45,141 +34,3 @@ export default defineCommand({
         }
     },
 });
-// The page and the code go to stderr, so the stdout of the calling command stays its own.
-export async function logIn(options) {
-    const authClient = createApiAuthClient();
-    const sessionToken = await fetchSessionToken(authClient, isInteractive(options));
-    const { session, user } = await fetchSession(createApiAuthClient(sessionToken));
-    writeToken(sessionToken);
-    deletePendingDeviceAuthorization();
-    writeUserConfig({ ...readUserConfig(), sessionId: session.id });
-    return { email: user.email, id: user.id, name: user.name };
-}
-// A request without an answer or with a transient status is polled again, since the person may be approving meanwhile.
-async function fetchApprovedSessionToken(authClient, deviceAuthorization) {
-    let currentIntervalSeconds = deviceAuthorization.intervalSeconds;
-    for (;;) {
-        await setTimeout(currentIntervalSeconds * 1000);
-        if (isDeviceAuthorizationExpired(deviceAuthorization)) {
-            throw new LoginExpiredError();
-        }
-        const response = await fetchDeviceToken(authClient, deviceAuthorization.deviceCode).catch(() => undefined);
-        if (response === undefined) {
-            continue;
-        }
-        const { data, error } = response;
-        if (error === null) {
-            return data.access_token;
-        }
-        switch (error.error) {
-            case 'access_denied':
-                throw new LoginDeniedError();
-            case 'authorization_pending':
-                break;
-            case 'expired_token':
-                throw new LoginExpiredError();
-            case 'slow_down':
-                currentIntervalSeconds += SLOW_DOWN_INCREMENT_SECONDS;
-                break;
-            default:
-                if (!isTransientStatus(error.status)) {
-                    throw resolveApiError(error);
-                }
-        }
-    }
-}
-async function fetchDeviceAuthorization(authClient) {
-    const { device_code, expires_in, interval, user_code, verification_uri_complete, } = resolveResponseData(await authClient.device.code({ client_id: CLI_CLIENT_ID }));
-    return {
-        deviceCode: device_code,
-        expiresAt: new Date(Date.now() + expires_in * 1000).toISOString(),
-        intervalSeconds: interval,
-        userCode: user_code,
-        verificationUrl: verification_uri_complete,
-    };
-}
-function fetchDeviceToken(authClient, deviceCode) {
-    return authClient.device.token({
-        client_id: CLI_CLIENT_ID,
-        device_code: deviceCode,
-        grant_type: DEVICE_CODE_GRANT_TYPE,
-    });
-}
-// A code that a non-interactive login kept is redeemed first, with one token request.
-// While pending it is shown again. Denied, expired or unknown, it gives way to a new one.
-async function fetchSessionToken(authClient, isLoginInteractive) {
-    const pendingDeviceAuthorization = readPendingDeviceAuthorization();
-    if (pendingDeviceAuthorization !== undefined &&
-        !isDeviceAuthorizationExpired(pendingDeviceAuthorization)) {
-        const { data, error } = await fetchDeviceToken(authClient, pendingDeviceAuthorization.deviceCode);
-        if (error === null) {
-            return data.access_token;
-        }
-        switch (error.error) {
-            case 'access_denied':
-            case 'expired_token':
-            case 'invalid_grant':
-                break;
-            case 'authorization_pending':
-            case 'slow_down':
-                return fetchSessionTokenOnApproval(authClient, pendingDeviceAuthorization, isLoginInteractive);
-            default:
-                throw resolveApiError(error);
-        }
-    }
-    deletePendingDeviceAuthorization();
-    return fetchSessionTokenOnApproval(authClient, await fetchDeviceAuthorization(authClient), isLoginInteractive);
-}
-// The code is kept, so the next login redeems one that ended before the approval.
-async function fetchSessionTokenOnApproval(authClient, deviceAuthorization, isLoginInteractive) {
-    writePendingDeviceAuthorization(deviceAuthorization);
-    if (!isLoginInteractive) {
-        throw new NotLoggedInError(deviceAuthorization);
-    }
-    process.stderr.write(`Open ${deviceAuthorization.verificationUrl} and approve the code ${deviceAuthorization.userCode}.\nWaiting for the approval…\n`);
-    await openBrowser(deviceAuthorization.verificationUrl);
-    return fetchApprovedSessionToken(authClient, deviceAuthorization);
-}
-function deletePendingDeviceAuthorization() {
-    const userConfig = readUserConfig();
-    if (userConfig.pendingDeviceCode === undefined) {
-        return;
-    }
-    delete userConfig.pendingDeviceCode;
-    delete userConfig.pendingDeviceCodeExpiresAt;
-    delete userConfig.pendingUserCode;
-    delete userConfig.pendingVerificationUrl;
-    writeUserConfig(userConfig);
-}
-function isDeviceAuthorizationExpired({ expiresAt, }) {
-    return new Date(expiresAt) <= new Date();
-}
-// The statuses the Node client also retries: a timeout, the rate limit or a server error.
-function isTransientStatus(status) {
-    return status === 408 || status === 429 || status >= 500;
-}
-function readPendingDeviceAuthorization() {
-    const { pendingDeviceCode, pendingDeviceCodeExpiresAt, pendingUserCode, pendingVerificationUrl, } = readUserConfig();
-    if (pendingDeviceCode === undefined ||
-        pendingDeviceCodeExpiresAt === undefined ||
-        pendingUserCode === undefined ||
-        pendingVerificationUrl === undefined) {
-        return undefined;
-    }
-    return {
-        deviceCode: pendingDeviceCode,
-        expiresAt: pendingDeviceCodeExpiresAt,
-        intervalSeconds: DEFAULT_INTERVAL_SECONDS,
-        userCode: pendingUserCode,
-        verificationUrl: pendingVerificationUrl,
-    };
-}
-function writePendingDeviceAuthorization({ deviceCode, expiresAt, userCode, verificationUrl, }) {
-    writeUserConfig({
-        ...readUserConfig(),
-        pendingDeviceCode: deviceCode,
-        pendingDeviceCodeExpiresAt: expiresAt,
-        pendingUserCode: userCode,
-        pendingVerificationUrl: verificationUrl,
-    });
-}

package/dist/commands/logout.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiAuthClient } from '../utils/auth-client.js';
+import { defineCommand } from '../utils/command.js';
 import { resolveApiError } from '../utils/error-mapping.js';
 import { NotLoggedInError } from '../utils/errors.js';
 import { defineCommandOptions } from '../utils/global-options.js';
@@ -8,7 +8,8 @@ import { deleteToken, readStoredToken } from '../utils/token-store.js';
 import { readUserConfig, writeUserConfig } from '../utils/user-config.js';
 const UNAUTHORIZED_STATUS = 401;
 export default defineCommand({
-    description: 'End the stored session and remove its token; HOTCODEPUSH_TOKEN, when set, stays what it is.',
+    description: 'End the stored session and remove its token. HOTCODEPUSH_TOKEN, when set, stays what it is.',
+    authentication: 'optional',
     examples: ['hotcodepush logout', 'hotcodepush logout --json'],
     options: defineCommandOptions({}),
     action: async (options) => {
@@ -30,19 +31,20 @@ export default defineCommand({
             throw resolveApiError(error);
         }
         deleteToken();
-        const storedSessionId = deleteSessionId();
+        const storedSessionId = deleteStoredSession();
         printEnded({
             id: knownSession?.session.id ?? storedSessionId ?? null,
             name: knownSession?.user.name ?? null,
         }, options.json);
     },
 });
-function deleteSessionId() {
+function deleteStoredSession() {
     const userConfig = readUserConfig();
     const { sessionId } = userConfig;
-    if (sessionId === undefined) {
+    if (sessionId === undefined && userConfig.sessionExpiresAt === undefined) {
         return undefined;
     }
+    delete userConfig.sessionExpiresAt;
     delete userConfig.sessionId;
     writeUserConfig(userConfig);
     return sessionId;

package/dist/commands/member/delete.js

@@ -1,12 +1,12 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { fetchMember, memberOptionShape, resolveMemberEmail, } from '../../utils/member-resolution.js';
 import { printJson } from '../../utils/output.js';
 import { confirmConsequence } from '../../utils/prompts.js';
 import { fetchOrganizationId } from '../../utils/resource-resolution.js';
 export default defineCommand({
-    description: 'Remove a member from the organization, or yourself to leave it; the Owner leaves only after transferring the ownership.',
+    description: 'Remove a member from the organization, or yourself to leave it. The Owner leaves only after transferring the ownership.',
     examples: [
         'hotcodepush member delete --member bob@example.com',
         'hotcodepush member delete --member 5e8a2c71-0b4d-4f39-9a6e-3c1d7b2f8e40 --yes --json',

package/dist/commands/member/get.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { fetchMember, memberOptionShape, resolveMemberEmail, } from '../../utils/member-resolution.js';
 import { printDetails, printJson } from '../../utils/output.js';

package/dist/commands/member/list.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { resolveMemberEmail } from '../../utils/member-resolution.js';
 import { printJson, printTable, resolveDate } from '../../utils/output.js';

package/dist/commands/member/update.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { fetchMember, memberOptionShape, resolveMemberEmail, } from '../../utils/member-resolution.js';
 import { printJson } from '../../utils/output.js';
@@ -33,7 +33,7 @@ export default defineCommand({
             (await promptSelect('--role', 'Which role does the member get?', MEMBER_ROLES.map(role => ({ label: role, value: role })), options));
         const email = resolveMemberEmail(fetchedMember);
         if (role === 'owner') {
-            const isConfirmed = await confirmConsequence(`transfers the ownership of the organization to ${email} and makes you an admin; only the new owner can transfer it back`, options);
+            const isConfirmed = await confirmConsequence(`transfers the ownership of the organization to ${email} and makes you an admin, and only the new owner can transfer it back`, options);
             if (!isConfirmed) {
                 return;
             }

package/dist/commands/open.js

@@ -1,6 +1,6 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../utils/api-client.js';
 import { openBrowser } from '../utils/browser.js';
+import { defineCommand } from '../utils/command.js';
 import { defineCommandOptions } from '../utils/global-options.js';
 import { resolveConsoleBaseUrl } from '../utils/hosts.js';
 import { printJson } from '../utils/output.js';

package/dist/commands/organization/create.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { promptText } from '../../utils/prompts.js';

package/dist/commands/organization/delete.js

@@ -1,11 +1,11 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson, resolveQuantityText } from '../../utils/output.js';
 import { confirmConsequence } from '../../utils/prompts.js';
 import { fetchApps, fetchOrganizationId, } from '../../utils/resource-resolution.js';
 export default defineCommand({
-    description: 'Delete an organization with everything in it; support can restore it for seven days.',
+    description: 'Delete an organization with everything in it. Support can restore it for seven days.',
     examples: [
         'hotcodepush organization delete --organization Acme',
         'hotcodepush organization delete --organization Acme --yes --json',

package/dist/commands/organization/get.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printDetails, printJson } from '../../utils/output.js';
 import { fetchOrganizationId } from '../../utils/resource-resolution.js';

package/dist/commands/organization/list.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { resolveMemberRole } from '../../utils/member-resolution.js';
 import { printJson, printTable, resolveDate } from '../../utils/output.js';

package/dist/commands/organization/update.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { confirmConsequence, promptText } from '../../utils/prompts.js';

package/dist/commands/release/create.js

@@ -1,10 +1,10 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { resolveAudienceText } from '../../utils/audience.js';
 import { booleanFlagSchema } from '../../utils/boolean-flag.js';
 import { fetchBundle, resolveBundleLabel, } from '../../utils/bundle-resolution.js';
 import { failurePolicyShape, resolveFailurePolicy, } from '../../utils/channel-fields.js';
+import { defineCommand } from '../../utils/command.js';
 import { withTemporaryDirectory } from '../../utils/compressed-files.js';
 import { InvalidParameterError } from '../../utils/errors.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
@@ -32,15 +32,15 @@ export default defineCommand({
         bundle: z
             .string()
             .optional()
-            .describe('A bundle already uploaded, by number or id; without it the build is uploaded first.'),
+            .describe('A bundle already uploaded, by number or id. Without it the build is uploaded first.'),
         channel: z
             .array(z.string())
             .optional()
-            .describe("The channel, by id or name, repeatable; hotcodepush.json's channel by default."),
+            .describe("The channel, by id or name, repeatable. Defaults to hotcodepush.json's channel."),
         dryRun: z
             .boolean()
             .optional()
-            .describe('Validate and print the audience the release would reach; nothing is signed, uploaded or published, so no private key is needed.'),
+            .describe('Validate and print the audience the release would reach. Nothing is signed, uploaded or published, so no private key is needed.'),
         fromChannel: z
             .string()
             .optional()
@@ -51,7 +51,7 @@ export default defineCommand({
         notes: z
             .string()
             .optional()
-            .describe('The release notes; they ride the public index.'),
+            .describe('The release notes. They ride the public index.'),
         rolloutPercent: z.coerce
             .number()
             .int()

package/dist/commands/release/get.js

@@ -1,6 +1,6 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { resolveEffectiveFailurePolicy, resolveFailurePolicyDetails, } from '../../utils/channel-fields.js';
+import { defineCommand } from '../../utils/command.js';
 import { resolveReleaseDeviceCount } from '../../utils/fleet.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printDetails, printJson } from '../../utils/output.js';

package/dist/commands/release/list.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { resolveReleaseDeviceCount } from '../../utils/fleet.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson, printTable, resolveDate } from '../../utils/output.js';

package/dist/commands/release/pause.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { confirmConsequence } from '../../utils/prompts.js';

package/dist/commands/release/resume.js

@@ -1,5 +1,5 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { confirmConsequence } from '../../utils/prompts.js';

package/dist/commands/release/revoke.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { fetchBundle } from '../../utils/bundle-resolution.js';
+import { defineCommand } from '../../utils/command.js';
+import { printWarning } from '../../utils/diagnostics.js';
 import { InvalidParameterError } from '../../utils/errors.js';
 import { resolveReleaseDeviceCount } from '../../utils/fleet.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
@@ -25,11 +26,11 @@ export default defineCommand({
         all: z
             .boolean()
             .optional()
-            .describe('Every release of the channel; its devices return to the embedded bundle.'),
+            .describe('Every release of the channel. Its devices return to the embedded bundle.'),
         bundle: z
             .string()
             .optional()
-            .describe("Every release of this bundle, by number or id, across the app's channels; without --channel."),
+            .describe("Every release of this bundle, by number or id, across the app's channels. Takes no --channel."),
         releaseFrom: z.coerce
             .number()
             .int()
@@ -50,7 +51,7 @@ export default defineCommand({
             appId: firstRevocation.channel.appId,
         });
         for (const pausedText of resolvePausedLandingTexts(revocations, fleet)) {
-            process.stderr.write(`Warning: ${pausedText}\n`);
+            printWarning(pausedText);
         }
         const isConfirmed = await confirmConsequence(resolveRevocationConsequence(revocations, fleet), options);
         if (!isConfirmed) {

package/dist/commands/release/rollback.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { booleanFlagSchema } from '../../utils/boolean-flag.js';
+import { defineCommand } from '../../utils/command.js';
 import { InvalidParameterError } from '../../utils/errors.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
@@ -19,11 +19,11 @@ export default defineCommand({
         ...channelOptionShape,
         mandatory: booleanFlagSchema
             .optional()
-            .describe('Devices apply the rollback at once and restart, the default for an incident fix; pass false to let them wait.'),
+            .describe('Devices apply the rollback at once and restart, the default for an incident fix. Pass false to let them wait.'),
         toRelease: z
             .string()
             .optional()
-            .describe("The release whose bundle comes back, by number or id; the channel's previous one by default."),
+            .describe("The release whose bundle comes back, by number or id. Defaults to the channel's previous one."),
     }),
     action: async (options) => {
         const hotCodePush = createApiClient();

package/dist/commands/release/rollout.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { progressionShape, resolveProgression, resolveProgressionText, } from '../../utils/progression.js';
@@ -10,7 +10,7 @@ import { fetchReleaseInChannel, releaseOptionShape, } from '../../utils/release-
 import { channelOptionShape } from '../../utils/resource-resolution.js';
 const rolloutPercentSchema = z.coerce.number().int().min(0).max(100);
 export default defineCommand({
-    description: "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.",
+    description: "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.",
     examples: [
         'hotcodepush release rollout --release 43 --rollout-percent 50',
         'hotcodepush release rollout --channel staging --release 43 --rollout-percent 10 --progression --yes',
@@ -21,7 +21,7 @@ export default defineCommand({
         ...releaseOptionShape,
         rolloutPercent: rolloutPercentSchema
             .optional()
-            .describe("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."),
+            .describe("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."),
     }),
     action: async (options) => {
         const hotCodePush = createApiClient();
@@ -58,6 +58,6 @@ function resolveRolloutConsequence(release, channelName, rolloutPercent, progres
     if (progression !== null) {
         return `progresses ${releaseText} from ${rolloutPercent} percent through ${resolveProgressionText(progression)}: devices already on it keep it`;
     }
-    const progressionEndText = release.progression === null ? '' : '; its progression ends';
+    const progressionEndText = release.progression === null ? '' : ', and its progression ends';
     return `sets ${releaseText} to ${rolloutPercent} percent: devices already on it keep it, and no new device above ${rolloutPercent} percent gets it${progressionEndText}`;
 }

package/dist/commands/release/update.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { booleanFlagSchema } from '../../utils/boolean-flag.js';
 import { failurePolicyShape, releaseFailurePolicyClearShape, resolveFailurePolicy, } from '../../utils/channel-fields.js';
+import { defineCommand } from '../../utils/command.js';
 import { MissingParameterError } from '../../utils/errors.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { resolveNullableField } from '../../utils/nullable-field.js';
@@ -25,7 +25,7 @@ export default defineCommand({
         clearNotes: z.boolean().optional().describe('Sets the notes back to null.'),
         mandatory: booleanFlagSchema
             .optional()
-            .describe('Whether devices apply the release at once and restart; pass false to turn it off.'),
+            .describe('Whether devices apply the release at once and restart. Pass false to turn it off.'),
         notes: z.string().optional().describe('The new release notes.'),
     }),
     action: async (options) => {

package/dist/commands/resource-file/write.js

@@ -1,6 +1,7 @@
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
 import { buildStepShape, fetchChannelId, readBuildStep, resolveChannelIdByShape, resolveFailureText, resolveOfflineCause, writeBuildResourceFile, } from '../../utils/build-step.js';
+import { defineCommand } from '../../utils/command.js';
+import { printNotice, printWarning } from '../../utils/diagnostics.js';
 import { CliError } from '../../utils/errors.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
@@ -8,6 +9,7 @@ import { printJson } from '../../utils/output.js';
 const UNVERSIONED_BUNDLE_VERSION = '';
 export default defineCommand({
     description: 'The build step of every build that is no store build: writes the resource file the SDK reads, listing the embedded bundle, and creates no binary. Without a token, offline or with an API that cannot be reached, the channel name stays unresolved and one warning says so, in CI too.',
+    authentication: 'optional',
     examples: [
         'hotcodepush resource-file write --platform ios --embedded-bundle-path build/App.app/public --resource-file-path build/App.app/hotcodepush.json',
         'hotcodepush resource-file write --platform android --embedded-bundle-path build/assets/public --resource-file-path build/assets/hotcodepush.json --json',
@@ -18,7 +20,7 @@ export default defineCommand({
         const { embeddedFiles, platform, resourceFilePath } = buildStep;
         if (embeddedFiles === undefined) {
             writeBuildResourceFile(buildStep, resolveChannelIdByShape(buildStep.channelReference), null);
-            process.stderr.write(`The ${platform} build bundled no JavaScript, as a debug build served by the development server does. Wrote ${resourceFilePath} without an embedded bundle: over-the-air (OTA) updates are off in this build.\n`);
+            printNotice(`The ${platform} build bundled no JavaScript, as a debug build served by the development server does. Wrote ${resourceFilePath} without an embedded bundle: over-the-air (OTA) updates are off in this build.`);
             if (options.json) {
                 printJson({ resourceFilePath });
             }
@@ -31,7 +33,7 @@ export default defineCommand({
             id: null,
         });
         if (skippedReason !== null) {
-            process.stderr.write(`Warning: ${skippedReason}\n`);
+            printWarning(skippedReason);
         }
         if (options.json) {
             printJson({ resourceFilePath });
@@ -65,12 +67,12 @@ async function resolveChannel(buildStep) {
         }
         return {
             channelId: null,
-            skippedReason: `the channel could not be resolved, so the build names none and takes no OTA updates: ${resolveFailureText(error)}`,
+            skippedReason: `The channel could not be resolved, so the build names none and takes no OTA updates: ${resolveFailureText(error)}`,
         };
     }
 }
 function resolveOfflineText(offlineCause) {
     return offlineCause === 'offline-switch'
-        ? 'HOTCODEPUSH_OFFLINE is set, so the channel name was not resolved: the build names no channel and takes no OTA updates.'
-        : 'not logged in, so the channel name was not resolved: the build names no channel and takes no OTA updates; run "hotcodepush login" or set HOTCODEPUSH_TOKEN.';
+        ? 'HOTCODEPUSH_OFFLINE is set, so the channel name was not resolved. The build names no channel and takes no OTA updates.'
+        : 'Not logged in, so the channel name was not resolved. The build names no channel and takes no OTA updates. Run "hotcodepush login" or set HOTCODEPUSH_TOKEN.';
 }

package/dist/commands/signing-key/add.js

@@ -1,7 +1,7 @@
 import { resolve } from 'node:path';
 import { z } from 'zod';
-import { defineCommand } from 'zodline';
 import { createApiClient } from '../../utils/api-client.js';
+import { defineCommand } from '../../utils/command.js';
 import { defineCommandOptions } from '../../utils/global-options.js';
 import { printJson } from '../../utils/output.js';
 import { locateProjectConfig } from '../../utils/project-config.js';
@@ -19,7 +19,7 @@ export default defineCommand({
         privateKeyPath: z
             .string()
             .optional()
-            .describe('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.'),
+            .describe('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.'),
     }),
     action: async (options) => {
         const privateKeyPath = resolve(options.privateKeyPath ??