@capawesome/cli 4.25.0 → 4.26.1

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.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)
+
+
+### Features
+
+* add Electron app version constraint flags for live update bundles ([#185](https://github.com/capawesome-team/cli/issues/185)) ([b1109d6](https://github.com/capawesome-team/cli/commit/b1109d6b40c01325e35cbd9f0a2aa0d6c8123e7a))
+
+
+### Bug Fixes
+
+* use the configured console URL in printed links ([#241](https://github.com/capawesome-team/cli/issues/241)) ([511d220](https://github.com/capawesome-team/cli/commit/511d2201643aed8733f36a1ca9edef67b24cd850))
+
 ## [4.25.0](https://github.com/capawesome-team/cli/compare/v4.24.0...v4.25.0) (2026-10-04)
 
 

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

@@ -1,16 +1,16 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 import appBuildSourcesService from '../../../services/app-build-sources.js';
 import appBuildsService from '../../../services/app-builds.js';
 import appCertificatesService from '../../../services/app-certificates.js';
 import appConfigurationsService from '../../../services/app-configurations.js';
 import appEnvironmentsService from '../../../services/app-environments.js';
 import appsService from '../../../services/apps.js';
+import configService from '../../../services/config.js';
 import { APP_BUILD_ARTIFACT_FORM_FACTORS, APP_BUILD_ARTIFACT_TYPES_BY_PLATFORM, handleAppBuildArtifactDownload, } from '../../../utils/app-build-artifacts.js';
 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()
@@ -423,7 +423,8 @@ export default defineCommand({
         });
         consola.info(`Build ID: ${response.id}`);
         consola.info(`Build Number: ${response.numberAsString}`);
-        consola.info(`Build URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/builds/${response.id}`);
+        const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+        consola.info(`Build URL: ${consoleBaseUrl}/apps/${appId}/builds/${response.id}`);
         consola.success('Build created successfully.');
         if (channels?.length) {
             consola.info(`The build will be deployed to the following ${channels.length === 1 ? 'channel' : 'channels'} once it succeeds: ${channels.join(', ')}.`);
@@ -446,7 +447,7 @@ export default defineCommand({
             });
             consola.info(`Build ID: ${response.id}`);
             consola.info(`Build Number: ${response.numberAsString}`);
-            consola.info(`Build URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/builds/${response.id}`);
+            consola.info(`Build URL: ${consoleBaseUrl}/apps/${appId}/builds/${response.id}`);
             consola.success('Build completed successfully.');
             console.log();
             // Download artifacts if flags are set
@@ -517,7 +518,7 @@ export default defineCommand({
             else {
                 consola.info(`Build ID: ${response.id}`);
                 consola.info(`Build Number: ${response.numberAsString}`);
-                consola.info(`Build URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/builds/${response.id}`);
+                consola.info(`Build URL: ${consoleBaseUrl}/apps/${appId}/builds/${response.id}`);
                 consola.success('Build started successfully.');
             }
         }

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/create.js

@@ -1,5 +1,5 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../config/consts.js';
 import appsService from '../../services/apps.js';
+import configService from '../../services/config.js';
 import { withAuth } from '../../utils/auth.js';
 import { isInteractive } from '../../utils/environment.js';
 import { prompt, promptOrganizationSelection } from '../../utils/prompt.js';
@@ -39,7 +39,8 @@ export default defineCommand({
         const response = await appsService.create({ name, organizationId, type });
         if (!json) {
             consola.info(`App ID: ${response.id}`);
-            consola.info(`App URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${response.id}`);
+            const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+            consola.info(`App URL: ${consoleBaseUrl}/apps/${response.id}`);
             consola.success('App created successfully.');
         }
         let shouldLink = options.link ?? false;

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

@@ -1,8 +1,9 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 import appBuildsService from '../../../services/app-builds.js';
 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()
@@ -171,7 +172,8 @@ export default defineCommand({
             releaseNotes,
         });
         consola.info(`Deployment ID: ${response.id}`);
-        consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.id}`);
+        const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+        consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${response.id}`);
         consola.success('Deployment created successfully.');
         // Wait for deployment job to complete by default, unless --detached flag is set
         const shouldWait = !options.detached && build.platform !== 'web';

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

@@ -1,5 +1,6 @@
 import { DEFAULT_API_BASE_URL } from '../../../config/consts.js';
 import authorizationService from '../../../services/authorization-service.js';
+import configService from '../../../services/config.js';
 import userConfig from '../../../utils/user-config.js';
 import consola from 'consola';
 import nock from 'nock';
@@ -62,6 +63,22 @@ describe('apps-deployments-create', () => {
         expect(deploymentScope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Deployment created successfully.');
     });
+    it('should print the deployment url using the configured console base url', async () => {
+        const consoleBaseUrl = 'https://console.example.com';
+        const getValueForKey = configService.getValueForKey.bind(configService);
+        vi.spyOn(configService, 'getValueForKey').mockImplementation((key) => key === 'CONSOLE_BASE_URL' ? Promise.resolve(consoleBaseUrl) : getValueForKey(key));
+        const options = { appId, buildId, destination: 'Google Play', detached: true };
+        nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}/builds/${buildId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: buildId, platform: 'android' });
+        nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/deployments`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: deploymentId, jobId: 'job-1' });
+        await createCommand.action(options, undefined);
+        expect(mockConsola.info).toHaveBeenCalledWith(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${deploymentId}`);
+    });
     it('should reject translated release notes without a default text', async () => {
         const options = { appId, buildId, destination: 'Google Play', releaseNotesLocale: ['de-DE=Fehlerbehebungen'] };
         await expect(createCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');

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';
@@ -74,10 +74,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).'),
+        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;

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/import.js

@@ -1,4 +1,3 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../config/consts.js';
 import appAutomationsService from '../../services/app-automations.js';
 import appCertificatesService from '../../services/app-certificates.js';
 import appChannelsService from '../../services/app-channels.js';
@@ -8,6 +7,7 @@ import appEnvironmentsService from '../../services/app-environments.js';
 import appGoogleServiceAccountKeysService from '../../services/app-google-service-account-keys.js';
 import appProvisioningProfilesService from '../../services/app-provisioning-profiles.js';
 import appsService from '../../services/apps.js';
+import configService from '../../services/config.js';
 import gitConnectionsService from '../../services/git-connections.js';
 import { generateUniqueName, isNameTaken } from '../../utils/app-import.js';
 import { parseAppflowExport } from '../../utils/appflow-export.js';
@@ -103,12 +103,13 @@ export default defineCommand({
             selectedSkippedApps.push(...unresolvedApps);
             await assignUniqueAppNames(resolvedApps, organizationId);
             const gitConnectionIds = await findGitConnectionIds(resolvedApps, organizationId);
+            const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
             for (const provider of getGitProviders(resolvedApps)) {
                 if (gitConnectionIds.has(provider)) {
                     continue;
                 }
                 const appCount = resolvedApps.filter((app) => app.repository?.provider === provider).length;
-                consola.warn(`The organization has no \`${provider}\` git connection, so the repositories of ${appCount} app(s) will not be linked. Connect the git provider at ${DEFAULT_CONSOLE_BASE_URL}/organizations/${organizationId}/git before running the import to link them automatically, or link the repositories manually in the Capawesome Cloud Console afterwards.`);
+                consola.warn(`The organization has no \`${provider}\` git connection, so the repositories of ${appCount} app(s) will not be linked. Connect the git provider at ${consoleBaseUrl}/organizations/${organizationId}/git before running the import to link them automatically, or link the repositories manually in the Capawesome Cloud Console afterwards.`);
             }
             const outcomes = [];
             for (const app of resolvedApps) {
@@ -132,10 +133,10 @@ export default defineCommand({
             }
             const errorCount = outcomes.reduce((count, outcome) => count + outcome.errors.length, 0);
             if (json) {
-                printJsonSummary(outcomes, selectedSkippedApps, warnings, dryRun === true);
+                printJsonSummary(outcomes, selectedSkippedApps, warnings, dryRun === true, consoleBaseUrl);
             }
             else {
-                printSummary(outcomes, selectedSkippedApps, dryRun === true, file);
+                printSummary(outcomes, selectedSkippedApps, dryRun === true, file, consoleBaseUrl);
             }
             if (errorCount > 0) {
                 process.exitCode = 1;
@@ -444,7 +445,7 @@ const importApp = async (organizationId, outcome, gitConnectionIds) => {
         }
     }
 };
-const printSummary = (outcomes, skippedApps, dryRun, file) => {
+const printSummary = (outcomes, skippedApps, dryRun, file, consoleBaseUrl) => {
     consola.log('');
     if (dryRun) {
         consola.info('Dry run. No resources were created.');
@@ -477,7 +478,7 @@ const printSummary = (outcomes, skippedApps, dryRun, file) => {
     }
     for (const outcome of outcomes) {
         if (outcome.id) {
-            consola.info(`App URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${outcome.id}`);
+            consola.info(`App URL: ${consoleBaseUrl}/apps/${outcome.id}`);
         }
     }
     const retryLaterApps = skippedApps.filter((app) => app.retryLater);
@@ -498,7 +499,7 @@ const printSummary = (outcomes, skippedApps, dryRun, file) => {
 const formatCount = (created, total, dryRun) => {
     return dryRun ? `${total}` : `${created}/${total}`;
 };
-const printJsonSummary = (outcomes, skippedApps, warnings, dryRun) => {
+const printJsonSummary = (outcomes, skippedApps, warnings, dryRun, consoleBaseUrl) => {
     console.log(JSON.stringify({
         dryRun,
         warnings,
@@ -507,7 +508,7 @@ const printJsonSummary = (outcomes, skippedApps, warnings, dryRun) => {
             name: outcome.app.name,
             sourceId: outcome.app.sourceId,
             sourceName: outcome.app.sourceName,
-            webUrl: outcome.id ? `${DEFAULT_CONSOLE_BASE_URL}/apps/${outcome.id}` : null,
+            webUrl: outcome.id ? `${consoleBaseUrl}/apps/${outcome.id}` : null,
             created: outcome.created,
             notes: outcome.app.notes,
             renames: outcome.app.renames,

package/dist/commands/apps/link.js

@@ -1,5 +1,5 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../config/consts.js';
 import appsService from '../../services/apps.js';
+import configService from '../../services/config.js';
 import gitConnectionsService from '../../services/git-connections.js';
 import { withAuth } from '../../utils/auth.js';
 import { isInteractive } from '../../utils/environment.js';
@@ -37,7 +37,8 @@ export default defineCommand({
                 limit: 1,
             });
             if (!gitConnection) {
-                consola.error(`No \`${gitRemoteInfo.provider}\` git connection found in the organization. Connect the git provider first at ${DEFAULT_CONSOLE_BASE_URL}/organizations/${app.organizationId}/git.`);
+                const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+                consola.error(`No \`${gitRemoteInfo.provider}\` git connection found in the organization. Connect the git provider first at ${consoleBaseUrl}/organizations/${app.organizationId}/git.`);
                 process.exit(1);
             }
             gitConnectionId = gitConnection.id;

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

@@ -1,11 +1,12 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 import appBuildSourcesService from '../../../services/app-build-sources.js';
 import appBuildsService from '../../../services/app-builds.js';
 import appCertificatesService from '../../../services/app-certificates.js';
 import appDeploymentsService from '../../../services/app-deployments.js';
 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.');
@@ -241,7 +243,8 @@ export default defineCommand({
         });
         consola.info(`Build ID: ${response.id}`);
         consola.info(`Build Number: ${response.numberAsString}`);
-        consola.info(`Build URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/builds/${response.id}`);
+        const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+        consola.info(`Build URL: ${consoleBaseUrl}/apps/${appId}/builds/${response.id}`);
         consola.success('Build created successfully.');
         // Wait for build to complete
         await waitForJobCompletion({ jobId: response.jobId });
@@ -284,7 +287,7 @@ export default defineCommand({
             });
             appDeploymentIds.push(deployment.id);
             consola.info(`Deployment ID: ${deployment.id}`);
-            consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${deployment.id}`);
+            consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${deployment.id}`);
             consola.success('Deployment created successfully.');
         }
         // Output JSON if json flag is set

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

@@ -1,7 +1,8 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 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()
@@ -56,6 +57,18 @@ export default defineCommand({
             .max(10)
             .optional()
             .describe('A custom property to assign to the bundle. Must be in the format `key=value`. Can be specified multiple times.'),
+        electronMax: z
+            .string()
+            .optional()
+            .describe('The maximum Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle supports. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
+        electronMin: z
+            .string()
+            .optional()
+            .describe('The minimum Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle supports. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
+        electronEq: z
+            .string()
+            .optional()
+            .describe('The exact Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle does not support. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
         expiresInDays: z.coerce
             .number({
             message: 'Expiration days must be an integer.',
@@ -104,7 +117,7 @@ export default defineCommand({
         yes: z.boolean().optional().describe('Skip confirmation prompts.'),
     }), { y: 'yes' }),
     action: withAuth(async (options, args) => {
-        let { androidEq, androidMax, androidMin, appId, channel, commitMessage, commitRef, commitSha, customProperty, expiresInDays, gitRef, iosEq, iosMax, iosMin, json, path, privateKey, rolloutPercentage, url, } = options;
+        let { androidEq, androidMax, androidMin, appId, channel, commitMessage, commitRef, commitSha, customProperty, electronEq, electronMax, electronMin, expiresInDays, gitRef, iosEq, iosMax, iosMin, json, path, privateKey, rolloutPercentage, url, } = options;
         if (expiresInDays) {
             consola.warn('The `--expires-in-days` option is deprecated and will be removed in a future version. Bundle expiration is now managed by the data retention policy of your organization billing plan.');
         }
@@ -225,6 +238,7 @@ export default defineCommand({
             channelName: channel,
             checksum,
             eqAndroidAppVersionCode: androidEq,
+            eqElectronAppVersionCode: electronEq,
             eqIosAppVersionCode: iosEq,
             gitCommitMessage: commitMessage,
             gitCommitRef: commitRef,
@@ -233,15 +247,18 @@ export default defineCommand({
             customProperties: parseCustomProperties(customProperty),
             url,
             maxAndroidAppVersionCode: androidMax,
+            maxElectronAppVersionCode: electronMax,
             maxIosAppVersionCode: iosMax,
             minAndroidAppVersionCode: androidMin,
+            minElectronAppVersionCode: electronMin,
             minIosAppVersionCode: iosMin,
             rolloutPercentage: (rolloutPercentage ?? 100) / 100,
             signature,
         });
         consola.info(`Bundle Artifact ID: ${response.id}`);
         if (response.appDeploymentId) {
-            consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.appDeploymentId}`);
+            const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+            consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${response.appDeploymentId}`);
         }
         consola.success('Live Update successfully registered.');
         if (json) {

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

@@ -134,6 +134,45 @@ describe('apps-liveupdates-register', () => {
         expect(mockConsola.info).toHaveBeenCalledWith(`Bundle Artifact ID: ${bundleId}`);
         expect(mockConsola.success).toHaveBeenCalledWith('Live Update successfully registered.');
     });
+    it('should pass Electron version constraints to API when provided', async () => {
+        const appId = 'app-123';
+        const bundleUrl = 'https://example.com/bundle.zip';
+        const bundleId = 'bundle-456';
+        const testToken = 'test-token';
+        const electronEq = '1.0.0';
+        const electronMin = '2.0.0';
+        const electronMax = '3.0.0';
+        const options = {
+            appId,
+            url: bundleUrl,
+            rolloutPercentage: 1,
+            electronEq,
+            electronMin,
+            electronMax,
+            yes: true,
+        };
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/bundles`, {
+            appId,
+            url: bundleUrl,
+            artifactType: 'zip',
+            eqElectronAppVersionCode: electronEq,
+            minElectronAppVersionCode: electronMin,
+            maxElectronAppVersionCode: electronMax,
+            rolloutPercentage: 0.01,
+        })
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: bundleId, appBuildId: 'build-789' });
+        await registerCommand.action(options, undefined);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
+        expect(mockConsola.info).toHaveBeenCalledWith(`Bundle Artifact ID: ${bundleId}`);
+        expect(mockConsola.success).toHaveBeenCalledWith('Live Update successfully registered.');
+    });
     it('should register bundle with checksum when path is provided', async () => {
         const appId = 'app-123';
         const bundleUrl = 'https://example.com/bundle.zip';

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

@@ -1,6 +1,6 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 import appChannelsService from '../../../services/app-channels.js';
 import appDeploymentsService from '../../../services/app-deployments.js';
+import configService from '../../../services/config.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
@@ -130,7 +130,8 @@ export default defineCommand({
             appChannelName: channel,
         });
         consola.info(`Deployment ID: ${response.id}`);
-        consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.id}`);
+        const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+        consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${response.id}`);
         consola.success(`Rolled back to Build #${selectedAppDeployment.appBuild?.numberAsString} (${selectedIndex} step${selectedIndex === 1 ? '' : 's'} back).`);
     }),
 });

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

@@ -1,6 +1,6 @@
-import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
 import appChannelsService from '../../../services/app-channels.js';
 import appDeploymentsService from '../../../services/app-deployments.js';
+import configService from '../../../services/config.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
@@ -106,7 +106,8 @@ export default defineCommand({
             rolloutPercentage: percentage / 100,
         });
         consola.info(`Deployment ID: ${response.id}`);
-        consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.id}`);
+        const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+        consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${response.id}`);
         consola.success(`Rolled out to ${percentage}%.`);
     }),
 });

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

@@ -1,8 +1,10 @@
-import { DEFAULT_CONSOLE_BASE_URL, MAX_CONCURRENT_FILE_UPLOADS } from '../../../config/index.js';
+import { MAX_CONCURRENT_FILE_UPLOADS } from '../../../config/index.js';
 import appBundleFilesService from '../../../services/app-bundle-files.js';
 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';
@@ -49,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()
@@ -67,6 +69,18 @@ export default defineCommand({
             .max(10)
             .optional()
             .describe('A custom property to assign to the bundle. Must be in the format `key=value`. Can be specified multiple times.'),
+        electronMax: z
+            .string()
+            .optional()
+            .describe('The maximum Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle supports. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
+        electronMin: z
+            .string()
+            .optional()
+            .describe('The minimum Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle supports. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
+        electronEq: z
+            .string()
+            .optional()
+            .describe('The exact Electron app version (`app.getVersion()`, from `electron/package.json`) that the bundle does not support. Must be in the format `major[.minor[.patch]]`. Prerelease suffixes are not supported.'),
         expiresInDays: z.coerce
             .number({
             message: 'Expiration days must be an integer.',
@@ -117,7 +131,7 @@ export default defineCommand({
         yes: z.boolean().optional().describe('Skip confirmation prompt.'),
     }), { y: 'yes' }),
     action: withAuth(async (options, args) => {
-        let { androidEq, androidMax, androidMin, appId, artifactType, channel, commitMessage, commitRef, commitSha, customProperty, expiresInDays, gitRef, iosEq, iosMax, iosMin, json, path, privateKey, rolloutPercentage, } = options;
+        let { androidEq, androidMax, androidMin, appId, artifactType, channel, commitMessage, commitRef, commitSha, customProperty, electronEq, electronMax, electronMin, expiresInDays, gitRef, iosEq, iosMax, iosMin, json, path, privateKey, rolloutPercentage, } = options;
         if (expiresInDays) {
             consola.warn('The `--expires-in-days` option is deprecated and will be removed in a future version. Bundle expiration is now managed by the data retention policy of your organization billing plan.');
         }
@@ -255,6 +269,7 @@ export default defineCommand({
             artifactType,
             channelName: channel,
             eqAndroidAppVersionCode: androidEq,
+            eqElectronAppVersionCode: electronEq,
             eqIosAppVersionCode: iosEq,
             gitCommitMessage: commitMessage,
             gitCommitRef: commitRef,
@@ -262,8 +277,10 @@ export default defineCommand({
             gitRef,
             customProperties: parseCustomProperties(customProperty),
             maxAndroidAppVersionCode: androidMax,
+            maxElectronAppVersionCode: electronMax,
             maxIosAppVersionCode: iosMax,
             minAndroidAppVersionCode: androidMin,
+            minElectronAppVersionCode: electronMin,
             minIosAppVersionCode: iosMin,
             // Convert percentage from 0-100 to 0-1 for API
             rolloutPercentage: (rolloutPercentage ?? 100) / 100,
@@ -287,7 +304,8 @@ export default defineCommand({
         });
         consola.info(`Build Artifact ID: ${createBundleResponse.id}`);
         if (updateBundleResponse.appDeploymentId) {
-            consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${updateBundleResponse.appDeploymentId}`);
+            const consoleBaseUrl = await configService.getValueForKey('CONSOLE_BASE_URL');
+            consola.info(`Deployment URL: ${consoleBaseUrl}/apps/${appId}/deployments/${updateBundleResponse.appDeploymentId}`);
         }
         consola.success('Live Update successfully uploaded.');
         if (json) {

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

@@ -211,6 +211,66 @@ describe('apps-liveupdates-upload', () => {
         expect(mockConsola.info).toHaveBeenCalledWith(`Build Artifact ID: ${bundleId}`);
         expect(mockConsola.success).toHaveBeenCalledWith('Live Update successfully uploaded.');
     });
+    it('should pass Electron version constraints to API when provided', async () => {
+        const appId = 'app-123';
+        const bundlePath = './dist';
+        const bundleId = 'bundle-456';
+        const testToken = 'test-token';
+        const testBuffer = Buffer.from('test');
+        const electronEq = '1.0.0';
+        const electronMin = '2.0.0';
+        const electronMax = '3.0.0';
+        const options = {
+            appId,
+            path: bundlePath,
+            artifactType: 'zip',
+            rollout: 1,
+            electronEq,
+            electronMin,
+            electronMax,
+        };
+        mockIsReadable.mockResolvedValue(true);
+        mockIsDirectory.mockResolvedValue(true);
+        mockGetFilesInDirectoryAndSubdirectories.mockResolvedValue([
+            { href: 'index.html', mimeType: 'text/html', name: 'index.html', path: 'index.html' },
+        ]);
+        // Mock utility functions
+        const mockZip = await import('../../../utils/zip.js');
+        const mockHash = await import('../../../utils/hash.js');
+        vi.mocked(mockZip.default.isZipped).mockReturnValue(false);
+        vi.mocked(mockZip.default.zipFolder).mockResolvedValue(testBuffer);
+        vi.mocked(mockHash.createHash).mockResolvedValue('test-hash');
+        const appScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: appId, name: 'Test App' });
+        const bundleScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/bundles`, {
+            appId,
+            artifactType: 'zip',
+            eqElectronAppVersionCode: electronEq,
+            minElectronAppVersionCode: electronMin,
+            maxElectronAppVersionCode: electronMax,
+            rolloutPercentage: 1,
+        })
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: bundleId, appBuildId: 'build-789' });
+        const uploadScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/bundles/${bundleId}/files`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: 'file-123' });
+        const updateScope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}/bundles/${bundleId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: bundleId });
+        await uploadCommand.action(options, undefined);
+        expect(appScope.isDone()).toBe(true);
+        expect(bundleScope.isDone()).toBe(true);
+        expect(uploadScope.isDone()).toBe(true);
+        expect(updateScope.isDone()).toBe(true);
+        expect(mockConsola.info).toHaveBeenCalledWith(`Build Artifact ID: ${bundleId}`);
+        expect(mockConsola.success).toHaveBeenCalledWith('Live Update successfully uploaded.');
+    });
     it('should output JSON when json flag is set', async () => {
         const appId = 'app-123';
         const bundlePath = './dist';

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.25.0",
+  "version": "4.26.1",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {