@capawesome/cli 4.22.0 → 4.23.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.23.0](https://github.com/capawesome-team/cli/compare/v4.22.0...v4.23.0) (2026-09-30)
+
+
+### Features
+
+* **apps:** add release notes and App Store submission flags ([#232](https://github.com/capawesome-team/cli/issues/232)) ([e32b057](https://github.com/capawesome-team/cli/commit/e32b057e0b06cd4e78c1d6c0dba25bceb2323e7e))
+* **apps:** support Huawei AppGallery and Firebase App Distribution destinations ([#229](https://github.com/capawesome-team/cli/issues/229)) ([78d3859](https://github.com/capawesome-team/cli/commit/78d38595feebfc5d1f81ca411ec6fe1aa5f7943f))
+* deploy builds to channels server-side and support multiple channels ([#210](https://github.com/capawesome-team/cli/issues/210)) ([c1722b9](https://github.com/capawesome-team/cli/commit/c1722b9d40b3d491228cedae95ee8e7a172d2cd9))
+
+
+### Bug Fixes
+
+* **apps:** rename Appflow tool version variables on import ([#230](https://github.com/capawesome-team/cli/issues/230)) ([b155a3a](https://github.com/capawesome-team/cli/commit/b155a3aa0eb62a67f922bb9783bf0740f345ffe0))
+
 ## [4.22.0](https://github.com/capawesome-team/cli/compare/v4.21.0...v4.22.0) (2026-09-24)
 
 

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

@@ -1,11 +1,11 @@
 import appAutomationsService from '../../../services/app-automations.js';
 import { withAuth } from '../../../utils/auth.js';
+import { clearableValue } from '../../../utils/cli-options.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import consola from 'consola';
 import { z } from 'zod';
 import { defineCommand, defineOptions } from 'zodline';
-const clearableValue = (value) => (value === '' ? null : value);
 const clearableValues = (values) => values?.filter((value) => value !== '');
 export default defineCommand({
     description: 'Update an existing app automation.',

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

@@ -10,11 +10,13 @@ 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 { isInteractive } from '../../../utils/environment.js';
 import { offerJobFailureSummary } from '../../../utils/job-failure-summary.js';
 import { isDirectory, isReadable } from '../../../utils/file.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
+import { parseReleaseNotes } from '../../../utils/release-notes.js';
 import zip from '../../../utils/zip.js';
 import consola from 'consola';
 import fs from 'fs/promises';
@@ -45,7 +47,10 @@ 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.'),
-        channel: z.string().optional().describe('The name of the channel to deploy to (Web only).'),
+        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).'),
         detached: z
@@ -76,6 +81,18 @@ export default defineCommand({
         })
             .optional()
             .describe('The platform for the build. Supported values are `ios`, `android`, and `web`.'),
+        releaseNotes: z
+            .string()
+            .optional()
+            .describe('Release notes for the deployment (default text). Requires --destination.'),
+        releaseNotesFile: z
+            .string()
+            .optional()
+            .describe('Path to a JSON file with release notes by locale, e.g. `{"default": "…", "de-DE": "…"}`. Requires --destination.'),
+        releaseNotesLocale: z
+            .array(z.string())
+            .optional()
+            .describe('Translated release notes as `<locale>=<text>`, e.g. `de-DE=Fehlerbehebungen`. Can be specified multiple times. Requires --destination.'),
         share: z.boolean().optional().describe('Create a public share link for the build after it succeeds.'),
         shareDescription: z
             .string()
@@ -116,14 +133,15 @@ export default defineCommand({
     }), { y: 'yes' }),
     action: withAuth(async (options) => {
         let { appId, platform, type, gitRef, environment, certificate, configuration, json, stack, path: sourcePath, url, } = options;
+        const channels = parseListOption(options.channel);
         // Validate that detached flag cannot be used with artifact flags
         if (options.detached && (options.apk || options.aab || options.ipa || options.app || options.zip)) {
             consola.error('The --detached flag cannot be used with --apk, --aab, --ipa, --app, or --zip flags.');
             process.exit(1);
         }
-        // Validate that detached flag cannot be used with channel or destination
-        if (options.detached && (options.channel || options.destination)) {
-            consola.error('The --detached flag cannot be used with --channel or --destination flags.');
+        // Validate that detached flag cannot be used with destination
+        if (options.detached && options.destination) {
+            consola.error('The --detached flag cannot be used with the --destination flag.');
             process.exit(1);
         }
         // Validate that detached flag cannot be used with failure summary
@@ -142,10 +160,16 @@ export default defineCommand({
             process.exit(1);
         }
         // Validate that channel and destination cannot be used together
-        if (options.channel && options.destination) {
+        if (channels?.length && options.destination) {
             consola.error('The --channel and --destination flags cannot be used together.');
             process.exit(1);
         }
+        // Validate the release notes before the build starts since they are only used for the deployment afterwards
+        const releaseNotes = await parseReleaseNotes(options);
+        if (releaseNotes && !options.destination) {
+            consola.error('The --release-notes, --release-notes-file, and --release-notes-locale flags require --destination.');
+            process.exit(1);
+        }
         // 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.');
@@ -255,7 +279,7 @@ export default defineCommand({
             process.exit(1);
         }
         // Validate that channel is only used with web platform
-        if (options.channel && platform !== 'web') {
+        if (channels?.length && platform !== 'web') {
             consola.error('The --channel flag can only be used with the web platform.');
             process.exit(1);
         }
@@ -388,6 +412,7 @@ export default defineCommand({
             adHocEnvironmentVariables,
             appBuildSourceId,
             appCertificateName: certificate,
+            appChannelNames: channels,
             appConfigurationName: configuration,
             appEnvironmentName: environment,
             appId,
@@ -400,6 +425,9 @@ export default defineCommand({
         consola.info(`Build Number: ${response.numberAsString}`);
         consola.info(`Build URL: ${DEFAULT_CONSOLE_BASE_URL}/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(', ')}.`);
+        }
         // Wait for build job to complete by default, unless --detached flag is set
         const shouldWait = !options.detached;
         if (shouldWait) {
@@ -459,9 +487,16 @@ export default defineCommand({
                     consola.info(`Share URL: ${shareUrls.webUrl}`);
                 }
             }
-            // Create deployment if channel or destination is set
-            if (options.channel || options.destination) {
-                await (await import('../../../commands/apps/deployments/create.js').then((mod) => mod.default)).action({ appId, buildId: response.id, channel: options.channel, destination: options.destination }, undefined);
+            // Create deployment if destination is set
+            if (options.destination) {
+                await (await import('../../../commands/apps/deployments/create.js').then((mod) => mod.default)).action({
+                    appId,
+                    buildId: response.id,
+                    destination: options.destination,
+                    releaseNotes: options.releaseNotes,
+                    releaseNotesFile: options.releaseNotesFile,
+                    releaseNotesLocale: options.releaseNotesLocale,
+                }, undefined);
             }
             // Output JSON if json flag is set
             if (json) {

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

@@ -144,6 +144,91 @@ describe('apps-builds-create', () => {
         expect(buildScope.isDone()).toBe(true);
         expect(mockConsola.error).not.toHaveBeenCalled();
     });
+    it('should send the channels as appChannelNames', async () => {
+        const options = { appId, platform: 'web', gitRef: 'main', channel: ['beta', 'alpha'], detached: true };
+        const buildScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/builds`, (body) => JSON.stringify(body.appChannelNames) === JSON.stringify(['beta', 'alpha']))
+            .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 split comma-separated channels into separate appChannelNames', async () => {
+        const options = { appId, platform: 'web', gitRef: 'main', channel: ['beta, alpha'], detached: true };
+        const buildScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/builds`, (body) => JSON.stringify(body.appChannelNames) === JSON.stringify(['beta', 'alpha']))
+            .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)
+            .post(`/v1/apps/${appId}/builds`)
+            .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 reject --detached combined with --destination', async () => {
+        const options = { appId, platform: 'ios', gitRef: 'main', destination: 'testflight', detached: true };
+        await expect(createCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
+        expect(mockConsola.error).toHaveBeenCalledWith('The --detached flag cannot be used with the --destination flag.');
+    });
+    it('should reject release notes without --destination', async () => {
+        const options = { appId, platform: 'android', gitRef: 'main', releaseNotes: 'Bug fixes' };
+        await expect(createCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
+        expect(mockConsola.error).toHaveBeenCalledWith('The --release-notes, --release-notes-file, and --release-notes-locale flags require --destination.');
+    });
+    it('should send the release notes with the deployment to the destination', async () => {
+        const options = {
+            appId,
+            platform: 'android',
+            gitRef: 'main',
+            destination: 'Google Play',
+            releaseNotes: 'Bug fixes',
+            releaseNotesLocale: ['de-DE=Fehlerbehebungen'],
+        };
+        const buildScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/builds`)
+            .reply(201, { id: buildId, jobId: 'job-1', numberAsString: '42' });
+        const findScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}/builds/${buildId}`)
+            .query({ relations: 'appBuildArtifacts' })
+            .reply(200, { id: buildId, appBuildArtifacts: [] });
+        const deploymentBuildScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}/builds/${buildId}`)
+            .reply(200, { id: buildId, platform: 'android' });
+        const deploymentScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/deployments`, {
+            appId,
+            appBuildId: buildId,
+            appDestinationName: 'Google Play',
+            releaseNotes: { default: 'Bug fixes', 'de-DE': 'Fehlerbehebungen' },
+        })
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: 'deployment-1', jobId: 'job-2' });
+        await createCommand.action(options, undefined);
+        expect(buildScope.isDone()).toBe(true);
+        expect(findScope.isDone()).toBe(true);
+        expect(deploymentBuildScope.isDone()).toBe(true);
+        expect(deploymentScope.isDone()).toBe(true);
+    });
+    it('should parse a single channel into an array', () => {
+        const schema = createCommand.options?.schema;
+        const result = schema?.safeParse({
+            appId: validAppId,
+            platform: 'web',
+            gitRef: 'main',
+            channel: ['beta'],
+        });
+        expect(result?.success).toBe(true);
+        expect(result?.data?.channel).toEqual(['beta']);
+    });
     it('should reject a non-positive shareExpiresInDays value', () => {
         const schema = createCommand.options?.schema;
         for (const shareExpiresInDays of [0, -1]) {

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

@@ -7,6 +7,7 @@ import { isInteractive } from '../../../utils/environment.js';
 import { offerJobFailureSummary } from '../../../utils/job-failure-summary.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
+import { parseReleaseNotes } from '../../../utils/release-notes.js';
 import consola from 'consola';
 import { z } from 'zod';
 import { defineCommand, defineOptions } from 'zodline';
@@ -37,9 +38,19 @@ export default defineCommand({
             .optional()
             .describe('Request an AI-powered failure summary (Capawesome Cloud Assist) if the deployment fails.'),
         json: z.boolean().optional().describe('Output in JSON format.'),
+        releaseNotes: z.string().optional().describe('Release notes for the deployment (default text).'),
+        releaseNotesFile: z
+            .string()
+            .optional()
+            .describe('Path to a JSON file with release notes by locale, e.g. `{"default": "…", "de-DE": "…"}`.'),
+        releaseNotesLocale: z
+            .array(z.string())
+            .optional()
+            .describe('Translated release notes as `<locale>=<text>`, e.g. `de-DE=Fehlerbehebungen`. Can be specified multiple times.'),
     })),
     action: withAuth(async (options) => {
         let { appId, buildId, buildNumber, channel, destination, json } = options;
+        const releaseNotes = await parseReleaseNotes(options);
         // Prompt for app ID if not provided
         if (!appId) {
             if (!isInteractive()) {
@@ -157,6 +168,7 @@ export default defineCommand({
             appBuildId: buildId,
             appDestinationName: build.platform === 'web' ? undefined : destination,
             appChannelName: build.platform === 'web' ? channel : undefined,
+            releaseNotes,
         });
         consola.info(`Deployment ID: ${response.id}`);
         consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.id}`);

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

@@ -0,0 +1,70 @@
+import { DEFAULT_API_BASE_URL } from '../../../config/consts.js';
+import authorizationService from '../../../services/authorization-service.js';
+import userConfig from '../../../utils/user-config.js';
+import consola from 'consola';
+import nock from 'nock';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import createCommand from './create.js';
+// Mock dependencies
+vi.mock('@/utils/user-config.js');
+vi.mock('@/utils/prompt.js');
+vi.mock('@/services/authorization-service.js');
+vi.mock('@/utils/job.js');
+vi.mock('consola');
+vi.mock('@/utils/environment.js', () => ({
+    isInteractive: () => false,
+}));
+describe('apps-deployments-create', () => {
+    const mockUserConfig = vi.mocked(userConfig);
+    const mockAuthorizationService = vi.mocked(authorizationService);
+    const mockConsola = vi.mocked(consola);
+    const testToken = 'test-token';
+    const appId = '00000000-0000-0000-0000-000000000001';
+    const buildId = '00000000-0000-0000-0000-000000000002';
+    const deploymentId = 'deployment-1';
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockUserConfig.read.mockReturnValue({ token: testToken });
+        mockAuthorizationService.hasAuthorizationToken.mockReturnValue(true);
+        mockAuthorizationService.getCurrentAuthorizationToken.mockReturnValue(testToken);
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`Process exited with code ${code}`);
+        });
+    });
+    afterEach(() => {
+        nock.cleanAll();
+        vi.restoreAllMocks();
+    });
+    it('should send the release notes with the deployment', async () => {
+        const options = {
+            appId,
+            buildId,
+            destination: 'Google Play',
+            detached: true,
+            releaseNotes: 'Bug fixes',
+            releaseNotesLocale: ['de-DE=Fehlerbehebungen'],
+        };
+        const buildScope = nock(DEFAULT_API_BASE_URL)
+            .get(`/v1/apps/${appId}/builds/${buildId}`)
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(200, { id: buildId, platform: 'android' });
+        const deploymentScope = nock(DEFAULT_API_BASE_URL)
+            .post(`/v1/apps/${appId}/deployments`, {
+            appId,
+            appBuildId: buildId,
+            appDestinationName: 'Google Play',
+            releaseNotes: { default: 'Bug fixes', 'de-DE': 'Fehlerbehebungen' },
+        })
+            .matchHeader('Authorization', `Bearer ${testToken}`)
+            .reply(201, { id: deploymentId, jobId: 'job-1' });
+        await createCommand.action(options, undefined);
+        expect(buildScope.isDone()).toBe(true);
+        expect(deploymentScope.isDone()).toBe(true);
+        expect(mockConsola.success).toHaveBeenCalledWith('Deployment created successfully.');
+    });
+    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');
+        expect(mockConsola.error).toHaveBeenCalledWith('Release notes require a default text (--release-notes).');
+    });
+});