@capawesome/cli 4.26.0 → 4.27.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [4.27.0](https://github.com/capawesome-team/cli/compare/v4.26.1...v4.27.0) (2026-10-09)
+
+
+### Features
+
+* **apps:** add `--apple-api-key-id` to `apps:destinations:create` ([#249](https://github.com/capawesome-team/cli/issues/249)) ([f8efdd8](https://github.com/capawesome-team/cli/commit/f8efdd8ff401ab4dbb1eb954db5ca044b6819501))
+
+
+### Bug Fixes
+
+* **apps:** upload Apple API key file only after all destination options are validated ([#250](https://github.com/capawesome-team/cli/issues/250)) ([ad0fadf](https://github.com/capawesome-team/cli/commit/ad0fadfa9b38792764d962ad7a5803448082ff1b))
+
+## [4.26.1](https://github.com/capawesome-team/cli/compare/v4.26.0...v4.26.1) (2026-10-07)
+
+
+### Bug Fixes
+
+* **apps:liveupdates:generate-signing-key:** show actionable error message if key files cannot be written ([#246](https://github.com/capawesome-team/cli/issues/246)) ([14f477e](https://github.com/capawesome-team/cli/commit/14f477e5ac84bb3a62d94c959c30f84cbf524e84))
+
 ## [4.26.0](https://github.com/capawesome-team/cli/compare/v4.25.0...v4.26.0) (2026-10-05)
 
 

package/dist/commands/apps/automations/create.js

@@ -1,7 +1,7 @@
 import appAutomationsService from '../../../services/app-automations.js';
 import appsService from '../../../services/apps.js';
 import { withAuth } from '../../../utils/auth.js';
-import { parseListOption } from '../../../utils/cli-options.js';
+import { parseListOption, stringOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import consola from 'consola';
@@ -11,18 +11,15 @@ export default defineCommand({
     description: 'Create a new app automation.',
     options: defineOptions(z.object({
         appId: z.string().optional().describe('ID of the app.'),
-        certificate: z.string().optional().describe('The name of the certificate to use for the build.'),
+        certificate: stringOption.describe('The name of the certificate to use for the build.'),
         channel: z
             .array(z.string())
             .optional()
             .describe('The name of a channel to deploy to (Web only). Can be specified multiple times or comma-separated.'),
-        commitMessagePattern: z
-            .string()
-            .optional()
-            .describe('Only trigger for commits whose message matches this pattern (branch triggers only).'),
-        configuration: z.string().optional().describe('The name of the native configuration (Android/iOS only).'),
-        destination: z.string().optional().describe('The name of the destination to deploy to (Android/iOS only).'),
-        environment: z.string().optional().describe('The name of the environment to use for the build.'),
+        commitMessagePattern: stringOption.describe('Only trigger for commits whose message matches this pattern (branch triggers only).'),
+        configuration: stringOption.describe('The name of the native configuration (Android/iOS only).'),
+        destination: stringOption.describe('The name of the destination to deploy to (Android/iOS only).'),
+        environment: stringOption.describe('The name of the environment to use for the build.'),
         json: z.boolean().optional().describe('Output in JSON format.'),
         name: z.string().optional().describe('Name of the automation.'),
         platform: z

package/dist/commands/apps/automations/update.js

@@ -1,6 +1,6 @@
 import appAutomationsService from '../../../services/app-automations.js';
 import { withAuth } from '../../../utils/auth.js';
-import { clearableValue, parseListOption } from '../../../utils/cli-options.js';
+import { clearableStringOption, clearableValue, parseListOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import consola from 'consola';
@@ -12,30 +12,15 @@ export default defineCommand({
     options: defineOptions(z.object({
         appId: z.string().optional().describe('ID of the app.'),
         automationId: z.string().optional().describe('ID of the automation.'),
-        certificate: z
-            .string()
-            .optional()
-            .describe('The name of the certificate to use for the build. Pass an empty string to clear it.'),
+        certificate: clearableStringOption.describe('The name of the certificate to use for the build. Pass an empty string to clear it.'),
         channel: z
             .array(z.string())
             .optional()
             .describe('The name of a channel to deploy to (Web only). Can be specified multiple times or comma-separated. Pass an empty string to clear them.'),
-        commitMessagePattern: z
-            .string()
-            .optional()
-            .describe('Only trigger for commits whose message matches this pattern (branch triggers only). Pass an empty string to clear it.'),
-        configuration: z
-            .string()
-            .optional()
-            .describe('The name of the native configuration (Android/iOS only). Pass an empty string to clear it.'),
-        destination: z
-            .string()
-            .optional()
-            .describe('The name of the destination to deploy to (Android/iOS only). Pass an empty string to clear it.'),
-        environment: z
-            .string()
-            .optional()
-            .describe('The name of the environment to use for the build. Pass an empty string to clear it.'),
+        commitMessagePattern: clearableStringOption.describe('Only trigger for commits whose message matches this pattern (branch triggers only). Pass an empty string to clear it.'),
+        configuration: clearableStringOption.describe('The name of the native configuration (Android/iOS only). Pass an empty string to clear it.'),
+        destination: clearableStringOption.describe('The name of the destination to deploy to (Android/iOS only). Pass an empty string to clear it.'),
+        environment: clearableStringOption.describe('The name of the environment to use for the build. Pass an empty string to clear it.'),
         json: z.boolean().optional().describe('Output in JSON format.'),
         name: z.string().optional().describe('Name of the automation.'),
         platform: z
@@ -94,16 +79,16 @@ export default defineCommand({
             });
         }
         await appAutomationsService.update({
-            appCertificateName: clearableValue(options.certificate),
+            appCertificateName: options.certificate,
             appChannelNames: parseListOption(options.channel),
-            appConfigurationName: clearableValue(options.configuration),
-            appDestinationName: clearableValue(options.destination),
-            appEnvironmentName: clearableValue(options.environment),
+            appConfigurationName: options.configuration,
+            appDestinationName: options.destination,
+            appEnvironmentName: options.environment,
             appId,
             automationId,
             buildStack: clearableValue(options.stack),
             buildType: options.type,
-            commitMessagePattern: clearableValue(options.commitMessagePattern),
+            commitMessagePattern: options.commitMessagePattern,
             name: options.name,
             platform: options.platform,
             triggerPatterns: clearableValues(options.triggerPattern),

package/dist/commands/apps/automations/update.test.js

@@ -59,7 +59,12 @@ describe('apps-automations-update', () => {
     it('should clear a reference when an empty string is passed', async () => {
         const appId = 'app-123';
         const automationId = 'automation-456';
-        const options = { appId, automationId, certificate: '', triggerPattern: [''] };
+        const options = updateAutomationCommand.options.schema.parse({
+            appId,
+            automationId,
+            certificate: '',
+            triggerPattern: [''],
+        });
         const scope = nock(DEFAULT_API_BASE_URL)
             .patch(`/v1/apps/${appId}/automations/${automationId}`, {
             appCertificateName: null,
@@ -71,6 +76,18 @@ describe('apps-automations-update', () => {
         expect(scope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Automation updated successfully.');
     });
+    it('should clear a reference when a whitespace-only string is passed', async () => {
+        const appId = 'app-123';
+        const automationId = 'automation-456';
+        const options = updateAutomationCommand.options.schema.parse({ appId, automationId, certificate: '   ' });
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}/automations/${automationId}`, { appCertificateName: null })
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(204);
+        await updateAutomationCommand.action(options, undefined);
+        expect(scope.isDone()).toBe(true);
+        expect(mockConsola.success).toHaveBeenCalledWith('Automation updated successfully.');
+    });
     it('should send the channels as appChannelNames', async () => {
         const appId = 'app-123';
         const automationId = 'automation-456';

package/dist/commands/apps/builds/create.js

@@ -10,7 +10,7 @@ import { getAppBuildShareUrls } from '../../../utils/app-build-shares.js';
 import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
 import { createBufferFromPath } from '../../../utils/buffer.js';
-import { parseListOption } from '../../../utils/cli-options.js';
+import { parseListOption, stringOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { offerJobFailureSummary } from '../../../utils/job-failure-summary.js';
 import { isDirectory, isReadable } from '../../../utils/file.js';
@@ -46,18 +46,18 @@ export default defineCommand({
         })
             .optional()
             .describe('App ID to create the build for.'),
-        certificate: z.string().optional().describe('The name of the certificate to use for the build.'),
+        certificate: stringOption.describe('The name of the certificate to use for the build.'),
         channel: z
             .array(z.string())
             .optional()
             .describe('The name of a channel to deploy to (Web only). Can be specified multiple times or comma-separated.'),
-        configuration: z.string().optional().describe('The name of the native configuration (Android/iOS only).'),
-        destination: z.string().optional().describe('The name of the destination to deploy to (Android/iOS only).'),
+        configuration: stringOption.describe('The name of the native configuration (Android/iOS only).'),
+        destination: stringOption.describe('The name of the destination to deploy to (Android/iOS only).'),
         detached: z
             .boolean()
             .optional()
             .describe('Exit immediately after creating the build without waiting for completion.'),
-        environment: z.string().optional().describe('The name of the environment to use for the build.'),
+        environment: stringOption.describe('The name of the environment to use for the build.'),
         failureSummary: z
             .boolean()
             .optional()

package/dist/commands/apps/builds/create.test.js

@@ -164,6 +164,22 @@ describe('apps-builds-create', () => {
         expect(buildScope.isDone()).toBe(true);
         expect(mockConsola.error).not.toHaveBeenCalled();
     });
+    it('should not send an empty environment', async () => {
+        const options = createCommand.options.schema.parse({
+            appId: validAppId,
+            platform: 'web',
+            gitRef: 'main',
+            environment: '',
+            detached: true,
+        });
+        const buildScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${validAppId}/builds`, (body) => !('appEnvironmentName' in body))
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: buildId, jobId: 'job-1', numberAsString: '42' });
+        await createCommand.action(options, undefined);
+        expect(buildScope.isDone()).toBe(true);
+        expect(mockConsola.error).not.toHaveBeenCalled();
+    });
     it('should accept --channel combined with --detached', async () => {
         const options = { appId, platform: 'web', gitRef: 'main', channel: ['beta'], detached: true };
         const buildScope = nock(DEFAULT_API_BASE_URL)

package/dist/commands/apps/deployments/create.js

@@ -3,6 +3,7 @@ import appDeploymentsService from '../../../services/app-deployments.js';
 import appDestinationsService from '../../../services/app-destinations.js';
 import configService from '../../../services/config.js';
 import { withAuth } from '../../../utils/auth.js';
+import { stringOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { offerJobFailureSummary } from '../../../utils/job-failure-summary.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
@@ -27,8 +28,8 @@ export default defineCommand({
             .optional()
             .describe('Build ID to deploy.'),
         buildNumber: z.string().optional().describe('Build number to deploy (e.g., "1", "42").'),
-        channel: z.string().optional().describe('The name of the channel to deploy to (Web only).'),
-        destination: z.string().optional().describe('The name of the destination to deploy to (Android/iOS only).'),
+        channel: stringOption.describe('The name of the channel to deploy to (Web only).'),
+        destination: stringOption.describe('The name of the destination to deploy to (Android/iOS only).'),
         detached: z
             .boolean()
             .optional()

package/dist/commands/apps/destinations/create.js

@@ -3,7 +3,7 @@ import appDestinationsService from '../../../services/app-destinations.js';
 import appGoogleServiceAccountKeysService from '../../../services/app-google-service-account-keys.js';
 import appsService from '../../../services/apps.js';
 import { withAuth } from '../../../utils/auth.js';
-import { parseListOption } from '../../../utils/cli-options.js';
+import { parseListOption, stringOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { isReadable } from '../../../utils/file.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
@@ -34,6 +34,7 @@ export default defineCommand({
         appleTeamId: z.string().optional().describe('Apple Team ID for the destination.'),
         appleAppPassword: z.string().optional().describe('Apple app-specific password for the destination.'),
         appleApiKeyFile: z.string().optional().describe('Path to the Apple API key (.p8) file.'),
+        appleApiKeyId: z.string().optional().describe('Apple API Key ID for the destination.'),
         appleIssuerId: z.string().optional().describe('Apple Issuer ID for the destination.'),
         appleBetaGroup: z
             .array(z.string())
@@ -74,18 +75,14 @@ export default defineCommand({
             .string()
             .optional()
             .describe('Huawei AppGallery Connect API client secret for the destination.'),
-        defaultLanguage: z
-            .string()
-            .optional()
-            .describe('Language of the default release notes text, e.g. `en-US` (Google Play and Huawei AppGallery only).'),
+        defaultLanguage: stringOption.describe('Language of the default release notes text, e.g. `en-US` (Google Play and Huawei AppGallery only).'),
     })),
     action: withAuth(async (options, args) => {
-        let { appId, json, name, platform, type, appleId, appleAppId, appleTeamId, appleAppPassword, appleApiKeyFile, appleIssuerId, appleBetaGroup, appleSubmitForReview, appleReleaseType, appleRejectIfPossible, androidPackageName, androidBuildArtifactType, androidReleaseStatus, googleServiceAccountKeyFile, googlePlayTrack, firebaseAppId, firebaseTesterGroup, huaweiAppId, huaweiClientId, huaweiClientSecret, defaultLanguage, } = options;
+        let { appId, json, name, platform, type, appleId, appleAppId, appleTeamId, appleAppPassword, appleApiKeyFile, appleApiKeyId, appleIssuerId, appleBetaGroup, appleSubmitForReview, appleReleaseType, appleRejectIfPossible, androidPackageName, androidBuildArtifactType, androidReleaseStatus, googleServiceAccountKeyFile, googlePlayTrack, firebaseAppId, firebaseTesterGroup, huaweiAppId, huaweiClientId, huaweiClientSecret, defaultLanguage, } = options;
         if (type === 'app-store-connect') {
             consola.warn('The destination type `app-store-connect` is deprecated. Use `apple-app-store-connect` instead.');
             type = 'apple-app-store-connect';
         }
-        let appleApiKeyId;
         let appAppleApiKeyId;
         let appGoogleServiceAccountKeyId;
         // 1. Select organization and app
@@ -234,7 +231,7 @@ export default defineCommand({
         if (type === 'apple-app-store-connect') {
             // 9. Ask for authentication method
             let authMethod;
-            if (appleApiKeyFile || appleIssuerId) {
+            if (appleApiKeyFile || appleApiKeyId || appleIssuerId) {
                 authMethod = 'apiKey';
             }
             else if (appleId || appleAppId || appleAppPassword) {
@@ -255,7 +252,7 @@ export default defineCommand({
                 }
             }
             else {
-                consola.error('You must provide authentication options when running in non-interactive environment. Either pass --apple-api-key-file and --apple-issuer-id for API Key authentication or --apple-id, --apple-app-id, and --apple-app-password for Password authentication.');
+                consola.error('You must provide authentication options when running in non-interactive environment. Either pass --apple-api-key-file, --apple-api-key-id, and --apple-issuer-id for API Key authentication or --apple-id, --apple-app-id, and --apple-app-password for Password authentication.');
                 process.exit(1);
             }
             if (authMethod === 'apiKey') {
@@ -273,20 +270,6 @@ export default defineCommand({
                         process.exit(1);
                     }
                 }
-                // Upload Apple API key file
-                const appleApiKeyFileReadable = await isReadable(appleApiKeyFile);
-                if (!appleApiKeyFileReadable) {
-                    consola.error(`The Apple API key file does not exist or is not accessible: ${appleApiKeyFile}`);
-                    process.exit(1);
-                }
-                const buffer = fs.readFileSync(appleApiKeyFile);
-                const fileName = path.basename(appleApiKeyFile);
-                const key = await appAppleApiKeysService.create({
-                    appId,
-                    buffer,
-                    fileName,
-                });
-                appAppleApiKeyId = key.id;
                 // 11. Ask for key ID
                 if (!appleApiKeyId) {
                     if (!isInteractive()) {
@@ -362,6 +345,9 @@ export default defineCommand({
                     process.exit(1);
                 }
             }
+            if (appleApiKeyFile) {
+                appAppleApiKeyId = await uploadAppleApiKeyFile(appId, appleApiKeyFile);
+            }
         }
         const response = await appDestinationsService.create({
             appId,
@@ -494,3 +480,18 @@ const uploadGoogleServiceAccountKeyFile = async (appId, googleServiceAccountKeyF
     });
     return key.id;
 };
+const uploadAppleApiKeyFile = async (appId, appleApiKeyFile) => {
+    const appleApiKeyFileReadable = await isReadable(appleApiKeyFile);
+    if (!appleApiKeyFileReadable) {
+        consola.error(`The Apple API key file does not exist or is not accessible: ${appleApiKeyFile}`);
+        process.exit(1);
+    }
+    const buffer = fs.readFileSync(appleApiKeyFile);
+    const fileName = path.basename(appleApiKeyFile);
+    const key = await appAppleApiKeysService.create({
+        appId,
+        buffer,
+        fileName,
+    });
+    return key.id;
+};

package/dist/commands/apps/destinations/create.test.js

@@ -25,7 +25,7 @@ describe('apps-destinations-create', () => {
     const appId = 'app-123';
     const destinationId = 'destination-456';
     const googleServiceAccountKeyId = 'key-789';
-    const appleApiKeyId = 'apple-key-012';
+    const appAppleApiKeyId = 'apple-key-012';
     const testToken = 'test-token';
     let tempDirectory;
     let googleServiceAccountKeyFile;
@@ -100,7 +100,7 @@ describe('apps-destinations-create', () => {
         const keyScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/apple-api-keys`)
             .matchHeader('Authorization', `Bearer ${testToken}`)
-            .reply(201, { id: appleApiKeyId });
+            .reply(201, { id: appAppleApiKeyId });
         const destinationScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/destinations`, {
             appId,
@@ -110,7 +110,7 @@ describe('apps-destinations-create', () => {
             appleTeamId: 'team-id',
             appleApiKeyId: 'ABC123DEFG',
             appleIssuerId: 'issuer-id',
-            appAppleApiKeyId: appleApiKeyId,
+            appAppleApiKeyId,
             appleBetaGroups: ['External Testers', 'QA'],
             appleRejectIfPossible: false,
             appleReleaseType: 'after-approval',
@@ -123,6 +123,70 @@ describe('apps-destinations-create', () => {
         expect(destinationScope.isDone()).toBe(true);
         expect(mockPrompt).toHaveBeenCalledTimes(1);
     });
+    it('should create an App Store Connect destination with the Apple API key ID non-interactively', async () => {
+        const appleApiKeyFile = path.join(tempDirectory, 'AuthKey.p8');
+        await fs.writeFile(appleApiKeyFile, 'private-key');
+        const options = {
+            appId,
+            name: 'App Store',
+            platform: 'ios',
+            type: 'apple-app-store-connect',
+            appleApiKeyFile,
+            appleApiKeyId: 'ABC123DEFG',
+            appleIssuerId: 'issuer-id',
+            appleTeamId: 'team-id',
+        };
+        const keyScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/apple-api-keys`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: appAppleApiKeyId });
+        const destinationScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/destinations`, {
+            appId,
+            name: 'App Store',
+            platform: 'ios',
+            type: 'apple-app-store-connect',
+            appleTeamId: 'team-id',
+            appleApiKeyId: 'ABC123DEFG',
+            appleIssuerId: 'issuer-id',
+            appAppleApiKeyId,
+        })
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: destinationId });
+        await createDestinationCommand.action(options, undefined);
+        expect(keyScope.isDone()).toBe(true);
+        expect(destinationScope.isDone()).toBe(true);
+        expect(mockPrompt).not.toHaveBeenCalled();
+    });
+    it('should require the Apple API key file when only the Apple API key ID is provided non-interactively', async () => {
+        const options = {
+            appId,
+            name: 'App Store',
+            platform: 'ios',
+            type: 'apple-app-store-connect',
+            appleApiKeyId: 'ABC123DEFG',
+        };
+        await expect(createDestinationCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
+        expect(mockConsola.error).toHaveBeenCalledWith('You must provide the Apple API key file when running in non-interactive environment.');
+    });
+    it('should not upload the Apple API key file when required options are missing non-interactively', async () => {
+        const appleApiKeyFile = path.join(tempDirectory, 'AuthKey.p8');
+        await fs.writeFile(appleApiKeyFile, 'private-key');
+        const options = {
+            appId,
+            name: 'App Store',
+            platform: 'ios',
+            type: 'apple-app-store-connect',
+            appleApiKeyFile,
+            appleApiKeyId: 'ABC123DEFG',
+            appleIssuerId: 'issuer-id',
+        };
+        const keyScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/apple-api-keys`)
+            .reply(201, { id: appAppleApiKeyId });
+        await expect(createDestinationCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
+        expect(keyScope.isDone()).toBe(false);
+    });
     it('should map the deprecated destination type app-store-connect to apple-app-store-connect', async () => {
         mockIsInteractive.mockReturnValue(true);
         mockPrompt.mockResolvedValueOnce('ABC123DEFG');
@@ -144,7 +208,7 @@ describe('apps-destinations-create', () => {
         const keyScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/apple-api-keys`)
             .matchHeader('Authorization', `Bearer ${testToken}`)
-            .reply(201, { id: appleApiKeyId });
+            .reply(201, { id: appAppleApiKeyId });
         const destinationScope = nock(DEFAULT_API_BASE_URL)
             .post(`/v1/apps/${appId}/destinations`, {
             appId,
@@ -154,7 +218,7 @@ describe('apps-destinations-create', () => {
             appleTeamId: 'team-id',
             appleApiKeyId: 'ABC123DEFG',
             appleIssuerId: 'issuer-id',
-            appAppleApiKeyId: appleApiKeyId,
+            appAppleApiKeyId,
             appleBetaGroups: ['External Testers', 'QA'],
             appleRejectIfPossible: false,
             appleReleaseType: 'after-approval',

package/dist/commands/apps/destinations/update.js

@@ -1,6 +1,6 @@
 import appDestinationsService from '../../../services/app-destinations.js';
 import { withAuth } from '../../../utils/auth.js';
-import { clearableValue, parseListOption } from '../../../utils/cli-options.js';
+import { clearableStringOption, parseListOption } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import consola from 'consola';
@@ -61,10 +61,7 @@ export default defineCommand({
             .string()
             .optional()
             .describe('Huawei AppGallery Connect API client secret for the destination.'),
-        defaultLanguage: z
-            .string()
-            .optional()
-            .describe('Language of the default release notes text, e.g. `en-US` (Google Play and Huawei AppGallery only). Pass `--default-language=` to clear it.'),
+        defaultLanguage: clearableStringOption.describe('Language of the default release notes text, e.g. `en-US` (Google Play and Huawei AppGallery only). Pass `--default-language=` to clear it.'),
     })),
     action: withAuth(async (options, args) => {
         let { appId, destinationId, name, appleId, appleAppId, appleTeamId, appleAppPassword, appleApiKeyId, appleIssuerId, appAppleApiKeyId, appleBetaGroup, appleSubmitForReview, appleReleaseType, appleRejectIfPossible, androidPackageName, androidBuildArtifactType, androidReleaseStatus, appGoogleServiceAccountKeyId, googlePlayTrack, firebaseAppId, firebaseTesterGroup, huaweiAppId, huaweiClientId, huaweiClientSecret, defaultLanguage, } = options;
@@ -108,7 +105,7 @@ export default defineCommand({
             huaweiAppId,
             huaweiClientId,
             huaweiClientSecret,
-            defaultLanguage: clearableValue(defaultLanguage),
+            defaultLanguage,
         });
         consola.success('Destination updated successfully.');
     }),

package/dist/commands/apps/destinations/update.test.js

@@ -92,7 +92,7 @@ describe('apps-destinations-update', () => {
         expect(scope.isDone()).toBe(true);
     });
     it('should clear the default language when `--default-language=` is passed', async () => {
-        const options = { appId, destinationId, defaultLanguage: '' };
+        const options = updateDestinationCommand.options.schema.parse({ appId, destinationId, defaultLanguage: '' });
         const scope = nock(DEFAULT_API_BASE_URL)
             .patch(`/v1/apps/${appId}/destinations/${destinationId}`, { appId, destinationId, defaultLanguage: null })
             .matchHeader('Authorization', `Bearer ${testToken}`)

package/dist/commands/apps/liveupdates/create.js

@@ -6,6 +6,7 @@ import appEnvironmentsService from '../../../services/app-environments.js';
 import configService from '../../../services/config.js';
 import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
+import { parseListOption, stringOption } from '../../../utils/cli-options.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { isReadable } from '../../../utils/file.js';
@@ -29,17 +30,17 @@ export default defineCommand({
         })
             .optional()
             .describe('App ID to create the live update for.'),
-        certificate: z.string().optional().describe('The name of the certificate to use for the build.'),
+        certificate: stringOption.describe('The name of the certificate to use for the build.'),
         channel: z
             .array(z.string())
             .optional()
-            .describe('The name of the channel to deploy to. Can be specified multiple times.'),
+            .describe('The name of the channel to deploy to. Can be specified multiple times or comma-separated.'),
         customProperty: z
             .array(z.string().min(1).max(100))
             .max(10)
             .optional()
             .describe('A custom property to assign to the build. Must be in the format `key=value`. Can be specified multiple times.'),
-        environment: z.string().optional().describe('The name of the environment to use for the build.'),
+        environment: stringOption.describe('The name of the environment to use for the build.'),
         gitRef: z.string().optional().describe('The Git reference (branch, tag, or commit SHA) to build.'),
         iosEq: z.string().optional().describe('The exact iOS CFBundleVersion for the live update.'),
         iosMax: z.string().optional().describe('The maximum iOS CFBundleVersion for the live update.'),
@@ -71,7 +72,8 @@ export default defineCommand({
         yes: z.boolean().optional().describe('Skip confirmation prompts.'),
     }), { y: 'yes' }),
     action: withAuth(async (options) => {
-        let { appId, certificate, channel, gitRef, environment, json, stack, path: sourcePath, url } = options;
+        let { appId, certificate, gitRef, environment, json, stack, path: sourcePath, url } = options;
+        let channel = parseListOption(options.channel);
         // Validate that path, url, and gitRef cannot be used together
         if (sourcePath && gitRef) {
             consola.error('The --path and --git-ref flags cannot be used together.');

package/dist/commands/apps/liveupdates/generate-signing-key.js

@@ -3,6 +3,7 @@ import { promises as fs } from 'fs';
 import pathModule from 'path';
 import { z } from 'zod';
 import { isInteractive } from '../../../utils/environment.js';
+import { writeFile } from '../../../utils/file.js';
 import { prompt } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from 'zodline';
 const APP_TYPES = ['capacitor', 'cordova'];
@@ -54,8 +55,8 @@ export default defineCommand({
             await fs.mkdir(pathModule.dirname(absolutePublicKeyPath), { recursive: true });
             await fs.mkdir(pathModule.dirname(absolutePrivateKeyPath), { recursive: true });
             // Write the keys to files
-            await fs.writeFile(absolutePublicKeyPath, publicKey, 'utf8');
-            await fs.writeFile(absolutePrivateKeyPath, privateKey, 'utf8');
+            await writeFile(absolutePublicKeyPath, publicKey);
+            await writeFile(absolutePrivateKeyPath, privateKey);
             consola.log('');
             consola.log('Public key saved to:  ' + absolutePublicKeyPath);
             consola.log('Private key saved to: ' + absolutePrivateKeyPath);

package/dist/commands/apps/liveupdates/register.js

@@ -2,6 +2,7 @@ import appBundlesService from '../../../services/app-bundles.js';
 import appsService from '../../../services/apps.js';
 import configService from '../../../services/config.js';
 import { withAuth } from '../../../utils/auth.js';
+import { stringOption } from '../../../utils/cli-options.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { createBufferFromPath, createBufferFromString, isPrivateKeyContent } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
@@ -38,7 +39,7 @@ export default defineCommand({
         })
             .optional()
             .describe('App ID to deploy to.'),
-        channel: z.string().optional().describe('Channel to associate the bundle with.'),
+        channel: stringOption.describe('Channel to associate the bundle with.'),
         commitMessage: z
             .string()
             .optional()

package/dist/commands/apps/liveupdates/upload.js

@@ -4,6 +4,7 @@ import appBundlesService from '../../../services/app-bundles.js';
 import appsService from '../../../services/apps.js';
 import configService from '../../../services/config.js';
 import { withAuth } from '../../../utils/auth.js';
+import { stringOption } from '../../../utils/cli-options.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { defineCommand, defineOptions } from 'zodline';
 import { createBufferFromPath, createBufferFromReadStream, createBufferFromString, isPrivateKeyContent, } from '../../../utils/buffer.js';
@@ -50,7 +51,7 @@ export default defineCommand({
             .optional()
             .describe('The type of artifact to deploy. Must be either `manifest` or `zip`. The default is `zip`.')
             .default('zip'),
-        channel: z.string().optional().describe('Channel to associate the bundle with.'),
+        channel: stringOption.describe('Channel to associate the bundle with.'),
         commitMessage: z
             .string()
             .optional()

package/dist/commands/apps/update.js

@@ -1,6 +1,6 @@
 import appsService from '../../services/apps.js';
 import { withAuth } from '../../utils/auth.js';
-import { clearableValue } from '../../utils/cli-options.js';
+import { clearableStringOption, clearableValue } from '../../utils/cli-options.js';
 import { isInteractive } from '../../utils/environment.js';
 import { promptAppSelection, promptOrganizationSelection } from '../../utils/prompt.js';
 import consola from 'consola';
@@ -10,24 +10,15 @@ export default defineCommand({
     description: 'Update an existing app.',
     options: defineOptions(z.object({
         appId: z.string().optional().describe('ID of the app.'),
-        channel: z
-            .string()
-            .optional()
-            .describe('The name of the default channel for live updates. Pass an empty string to clear it.'),
+        channel: clearableStringOption.describe('The name of the default channel for live updates. Pass an empty string to clear it.'),
         channelDiscovery: z
             .union([z.boolean(), z.stringbool()], {
             message: 'Channel discovery must be either `true` or `false`.',
         })
             .optional()
             .describe('Enable or disable channel discovery. Supported values are `true` and `false`.'),
-        configuration: z
-            .string()
-            .optional()
-            .describe('The name of the default native configuration. Pass an empty string to clear it.'),
-        environment: z
-            .string()
-            .optional()
-            .describe('The name of the default environment. Pass an empty string to clear it.'),
+        configuration: clearableStringOption.describe('The name of the default native configuration. Pass an empty string to clear it.'),
+        environment: clearableStringOption.describe('The name of the default environment. Pass an empty string to clear it.'),
         json: z.boolean().optional().describe('Output in JSON format.'),
         name: z.string().optional().describe('Name of the app.'),
         nextBuildNumber: z.coerce
@@ -60,9 +51,9 @@ export default defineCommand({
         }
         const app = await appsService.update({
             appChannelDiscoveryEnabled: options.channelDiscovery,
-            appChannelName: clearableValue(options.channel),
-            appConfigurationName: clearableValue(options.configuration),
-            appEnvironmentName: clearableValue(options.environment),
+            appChannelName: options.channel,
+            appConfigurationName: options.configuration,
+            appEnvironmentName: options.environment,
             appId,
             buildStack: clearableValue(options.stack),
             name: options.name,

package/dist/commands/apps/update.test.js

@@ -61,7 +61,7 @@ describe('apps-update', () => {
     });
     it('should clear defaults when an empty string is passed', async () => {
         const appId = 'app-123';
-        const options = { appId, channel: '', environment: '', stack: '' };
+        const options = updateAppCommand.options.schema.parse({ appId, channel: '', environment: '', stack: '' });
         const scope = nock(DEFAULT_API_BASE_URL)
             .patch(`/v1/apps/${appId}`, {
             appChannelName: null,

package/dist/utils/cli-options.js

@@ -1,3 +1,14 @@
+import { z } from 'zod';
+export const stringOption = z
+    .string()
+    .trim()
+    .transform((value) => value || undefined)
+    .optional();
+export const clearableStringOption = z
+    .string()
+    .trim()
+    .transform((value) => value || null)
+    .optional();
 export const clearableValue = (value) => value === '' ? null : value;
 export const parseListOption = (values) => {
     return values

package/dist/utils/cli-options.test.js

@@ -1,5 +1,33 @@
 import { describe, expect, it } from 'vitest';
-import { parseListOption } from './cli-options.js';
+import { clearableStringOption, parseListOption, stringOption } from './cli-options.js';
+describe('stringOption', () => {
+    it('should return undefined if the option is not passed', () => {
+        expect(stringOption.parse(undefined)).toBeUndefined();
+    });
+    it('should return undefined for an empty value', () => {
+        expect(stringOption.parse('')).toBeUndefined();
+    });
+    it('should return undefined for a whitespace-only value', () => {
+        expect(stringOption.parse('   ')).toBeUndefined();
+    });
+    it('should trim the value', () => {
+        expect(stringOption.parse('  production ')).toBe('production');
+    });
+});
+describe('clearableStringOption', () => {
+    it('should return undefined if the option is not passed', () => {
+        expect(clearableStringOption.parse(undefined)).toBeUndefined();
+    });
+    it('should return null for an empty value', () => {
+        expect(clearableStringOption.parse('')).toBeNull();
+    });
+    it('should return null for a whitespace-only value', () => {
+        expect(clearableStringOption.parse('   ')).toBeNull();
+    });
+    it('should trim the value', () => {
+        expect(clearableStringOption.parse('  production ')).toBe('production');
+    });
+});
 describe('parseListOption', () => {
     it('should return undefined if the option is not passed', () => {
         expect(parseListOption(undefined)).toBeUndefined();

package/dist/utils/file.js

@@ -4,12 +4,13 @@ import pathModule from 'path';
 import { createBufferFromPath } from './buffer.js';
 import { getCodeFromUnknownError, UserError } from './error.js';
 const concurrentModificationHint = 'Make sure that no other process (e.g. a build or file sync client) modifies the folder while the command is running.';
-const permissionHint = 'Make sure that you have permission to read the file.';
+const readPermissionHint = 'Make sure that you have permission to read the file.';
+const writePermissionHint = 'Make sure that you have permission to write to the folder or choose a different path.';
 const unreadableFileErrorHints = {
-    EACCES: permissionHint,
+    EACCES: readPermissionHint,
     EBUSY: concurrentModificationHint,
     ENOENT: concurrentModificationHint,
-    EPERM: permissionHint,
+    EPERM: readPermissionHint,
 };
 export const getFilesInDirectoryAndSubdirectories = async (path) => {
     const files = [];
@@ -95,14 +96,14 @@ export const isDirectory = async (path) => {
     });
 };
 export const writeFile = async (path, data) => {
-    return new Promise((resolve, reject) => {
-        fs.writeFile(path, data, (err) => {
-            if (err) {
-                reject(err);
-            }
-            else {
-                resolve(undefined);
-            }
-        });
-    });
+    try {
+        await fs.promises.writeFile(path, data);
+    }
+    catch (error) {
+        const code = getCodeFromUnknownError(error);
+        if (code === 'EACCES' || code === 'EPERM') {
+            throw new UserError(`The file could not be written: ${path}. ${writePermissionHint}`);
+        }
+        throw error;
+    }
 };

package/dist/utils/file.test.js

@@ -3,7 +3,7 @@ import os from 'os';
 import pathModule from 'path';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { UserError } from './error.js';
-import { readFileFromDirectory } from './file.js';
+import { readFileFromDirectory, writeFile } from './file.js';
 const { mockCreateBufferFromPath } = vi.hoisted(() => ({ mockCreateBufferFromPath: vi.fn() }));
 vi.mock('./buffer.js', async (importOriginal) => {
     const actual = await importOriginal();
@@ -44,3 +44,30 @@ describe('readFileFromDirectory', () => {
         await expect(readFileFromDirectory(pathModule.join(directory, 'assets'))).rejects.toBe(error);
     });
 });
+describe('writeFile', () => {
+    let directory;
+    beforeEach(() => {
+        directory = fs.mkdtempSync(pathModule.join(os.tmpdir(), 'file-'));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        fs.rmSync(directory, { force: true, recursive: true });
+    });
+    it('should write the file', async () => {
+        const path = pathModule.join(directory, 'public.pem');
+        await writeFile(path, 'key');
+        expect(fs.readFileSync(path, 'utf8')).toBe('key');
+    });
+    it.each(['EACCES', 'EPERM'])('should throw a user error if the file is not writable (%s)', async (code) => {
+        const path = pathModule.join(directory, 'public.pem');
+        vi.spyOn(fs.promises, 'writeFile').mockRejectedValueOnce(createErrorWithCode(code));
+        const promise = writeFile(path, 'key');
+        await expect(promise).rejects.toThrow(UserError);
+        await expect(promise).rejects.toThrow(`The file could not be written: ${path}. Make sure that you have permission to write to the folder or choose a different path.`);
+    });
+    it('should rethrow errors that are not related to permissions', async () => {
+        const error = createErrorWithCode('EISDIR');
+        vi.spyOn(fs.promises, 'writeFile').mockRejectedValueOnce(error);
+        await expect(writeFile(directory, 'key')).rejects.toBe(error);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "4.26.0",
+  "version": "4.27.0",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {