@capawesome/cli 4.23.1 → 4.24.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.24.0](https://github.com/capawesome-team/cli/compare/v4.23.1...v4.24.0) (2026-10-01)
+
+
+### Features
+
+* **apps:** add the `apps:update` command ([#237](https://github.com/capawesome-team/cli/issues/237)) ([274cd09](https://github.com/capawesome-team/cli/commit/274cd09ce2898aa309d2a6613d059e8fa999e5d9))
+
 ## [4.23.1](https://github.com/capawesome-team/cli/compare/v4.23.0...v4.23.1) (2026-10-01)
 
 

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

@@ -45,11 +45,11 @@ export default defineCommand({
             .optional()
             .describe('The platform for the build. Supported values are `android`, `ios`, and `web`.'),
         stack: z
-            .enum(['macos-sequoia', 'macos-tahoe', 'macos-golden-gate'], {
+            .union([z.enum(['macos-sequoia', 'macos-tahoe', 'macos-golden-gate']), z.literal('')], {
             message: 'Build stack must be one of `macos-sequoia`, `macos-tahoe`, or `macos-golden-gate`.',
         })
             .optional()
-            .describe('The build stack to use for the build process.'),
+            .describe("The build stack to use for the build process. Pass an empty string to use the app's default build stack."),
         triggerPattern: z
             .array(z.string())
             .optional()
@@ -101,7 +101,7 @@ export default defineCommand({
             appEnvironmentName: clearableValue(options.environment),
             appId,
             automationId,
-            buildStack: options.stack,
+            buildStack: clearableValue(options.stack),
             buildType: options.type,
             commitMessagePattern: clearableValue(options.commitMessagePattern),
             name: options.name,

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

@@ -71,6 +71,18 @@ describe('apps-automations-update', () => {
         expect(scope.isDone()).toBe(true);
         expect(mockConsola.success).toHaveBeenCalledWith('Automation updated successfully.');
     });
+    it('should clear the build stack when an empty string is passed', async () => {
+        const appId = 'app-123';
+        const automationId = 'automation-456';
+        const options = { appId, automationId, stack: '' };
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}/automations/${automationId}`, { buildStack: 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 output JSON when json flag is set', async () => {
         const appId = 'app-123';
         const automationId = 'automation-456';

package/dist/commands/apps/update.js

@@ -0,0 +1,79 @@
+import appsService from '../../services/apps.js';
+import { withAuth } from '../../utils/auth.js';
+import { clearableValue } from '../../utils/cli-options.js';
+import { isInteractive } from '../../utils/environment.js';
+import { promptAppSelection, promptOrganizationSelection } from '../../utils/prompt.js';
+import consola from 'consola';
+import { z } from 'zod';
+import { defineCommand, defineOptions } from 'zodline';
+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.'),
+        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.'),
+        json: z.boolean().optional().describe('Output in JSON format.'),
+        name: z.string().optional().describe('Name of the app.'),
+        nextBuildNumber: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The next build number. Must be greater than the latest build number.'),
+        stack: z
+            .union([z.enum(['macos-sequoia', 'macos-tahoe', 'macos-golden-gate']), z.literal('')], {
+            message: 'Build stack must be one of `macos-sequoia`, `macos-tahoe`, or `macos-golden-gate`.',
+        })
+            .optional()
+            .describe('The default build stack for builds without an explicit build stack. Must be one of `macos-sequoia`, `macos-tahoe`, or `macos-golden-gate`. Pass an empty string to use the Capawesome Cloud default.'),
+        type: z
+            .enum(['android', 'capacitor', 'cordova', 'ios'], {
+            message: 'Type must be one of `android`, `capacitor`, `cordova`, or `ios`.',
+        })
+            .optional()
+            .describe('Type of the app. Supported values are `android`, `capacitor`, `cordova`, and `ios`.'),
+    })),
+    action: withAuth(async (options, args) => {
+        let { appId, json } = options;
+        if (!appId) {
+            if (!isInteractive()) {
+                consola.error('You must provide an app ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const organizationId = await promptOrganizationSelection();
+            appId = await promptAppSelection(organizationId);
+        }
+        const app = await appsService.update({
+            appChannelDiscoveryEnabled: options.channelDiscovery,
+            appChannelName: clearableValue(options.channel),
+            appConfigurationName: clearableValue(options.configuration),
+            appEnvironmentName: clearableValue(options.environment),
+            appId,
+            buildStack: clearableValue(options.stack),
+            name: options.name,
+            nextAppBuildNumber: options.nextBuildNumber,
+            type: options.type,
+        });
+        if (json) {
+            console.log(JSON.stringify(app, null, 2));
+        }
+        else {
+            consola.success('App updated successfully.');
+        }
+    }),
+});

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

@@ -0,0 +1,117 @@
+import { DEFAULT_API_BASE_URL } from '../../config/consts.js';
+import authorizationService from '../../services/authorization-service.js';
+import { promptAppSelection, promptOrganizationSelection } from '../../utils/prompt.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 updateAppCommand from './update.js';
+// Mock dependencies
+vi.mock('@/utils/user-config.js');
+vi.mock('@/utils/prompt.js');
+vi.mock('@/services/authorization-service.js');
+vi.mock('consola');
+vi.mock('@/utils/environment.js', () => ({
+    isInteractive: () => true,
+}));
+describe('apps-update', () => {
+    const mockUserConfig = vi.mocked(userConfig);
+    const mockPromptOrganizationSelection = vi.mocked(promptOrganizationSelection);
+    const mockPromptAppSelection = vi.mocked(promptAppSelection);
+    const mockConsola = vi.mocked(consola);
+    const mockAuthorizationService = vi.mocked(authorizationService);
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockUserConfig.read.mockReturnValue({ token: 'test-token' });
+        mockAuthorizationService.getCurrentAuthorizationToken.mockReturnValue('test-token');
+        mockAuthorizationService.hasAuthorizationToken.mockReturnValue(true);
+        vi.spyOn(process, 'exit').mockImplementation((code) => {
+            throw new Error(`Process exited with code ${code}`);
+        });
+    });
+    afterEach(() => {
+        nock.cleanAll();
+        vi.restoreAllMocks();
+    });
+    it('should update app with provided options', async () => {
+        const appId = 'app-123';
+        const options = updateAppCommand.options.schema.parse({
+            appId,
+            channelDiscovery: 'false',
+            configuration: 'Production',
+            name: 'renamed',
+            nextBuildNumber: '42',
+            stack: 'macos-tahoe',
+            type: 'ios',
+        });
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}`, {
+            appChannelDiscoveryEnabled: false,
+            appConfigurationName: 'Production',
+            buildStack: 'macos-tahoe',
+            name: 'renamed',
+            nextAppBuildNumber: 42,
+            type: 'ios',
+        })
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(200, { id: appId, name: 'renamed' });
+        await updateAppCommand.action(options, undefined);
+        expect(scope.isDone()).toBe(true);
+        expect(mockConsola.success).toHaveBeenCalledWith('App updated successfully.');
+    });
+    it('should clear defaults when an empty string is passed', async () => {
+        const appId = 'app-123';
+        const options = { appId, channel: '', environment: '', stack: '' };
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}`, {
+            appChannelName: null,
+            appEnvironmentName: null,
+            buildStack: null,
+        })
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(200, { id: appId });
+        await updateAppCommand.action(options, undefined);
+        expect(scope.isDone()).toBe(true);
+        expect(mockConsola.success).toHaveBeenCalledWith('App updated successfully.');
+    });
+    it('should output JSON when json flag is set', async () => {
+        const appId = 'app-123';
+        const app = { id: appId, name: 'renamed', organizationId: 'org-1', type: 'capacitor' };
+        const options = { appId, json: true, name: 'renamed' };
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}`, { name: 'renamed' })
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(200, app);
+        await updateAppCommand.action(options, undefined);
+        expect(scope.isDone()).toBe(true);
+        expect(logSpy).toHaveBeenCalledWith(JSON.stringify(app, null, 2));
+        expect(mockConsola.success).not.toHaveBeenCalled();
+    });
+    it('should prompt for app when not provided', async () => {
+        const orgId = 'org-1';
+        const appId = 'app-1';
+        const options = { name: 'renamed' };
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}`, { name: 'renamed' })
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(200, { id: appId, name: 'renamed' });
+        mockPromptOrganizationSelection.mockResolvedValueOnce(orgId);
+        mockPromptAppSelection.mockResolvedValueOnce(appId);
+        await updateAppCommand.action(options, undefined);
+        expect(scope.isDone()).toBe(true);
+        expect(mockPromptAppSelection).toHaveBeenCalledWith(orgId);
+        expect(mockConsola.success).toHaveBeenCalledWith('App updated successfully.');
+    });
+    it('should handle API error', async () => {
+        const appId = 'app-123';
+        const options = { appId, nextBuildNumber: 1 };
+        const scope = nock(DEFAULT_API_BASE_URL)
+            .patch(`/v1/apps/${appId}`)
+            .matchHeader('Authorization', 'Bearer test-token')
+            .reply(400, { message: 'The next build number must be greater than the latest build number.' });
+        await expect(updateAppCommand.action(options, undefined)).rejects.toThrow();
+        expect(scope.isDone()).toBe(true);
+        expect(mockConsola.success).not.toHaveBeenCalled();
+    });
+});

package/dist/index.js

@@ -32,6 +32,7 @@ const config = defineConfig({
         'apps:list': await import('./commands/apps/list.js').then((mod) => mod.default),
         'apps:transfer': await import('./commands/apps/transfer.js').then((mod) => mod.default),
         'apps:unlink': await import('./commands/apps/unlink.js').then((mod) => mod.default),
+        'apps:update': await import('./commands/apps/update.js').then((mod) => mod.default),
         'apps:automations:create': await import('./commands/apps/automations/create.js').then((mod) => mod.default),
         'apps:automations:delete': await import('./commands/apps/automations/delete.js').then((mod) => mod.default),
         'apps:automations:get': await import('./commands/apps/automations/get.js').then((mod) => mod.default),

package/dist/utils/cli-options.js

@@ -1,4 +1,4 @@
-export const clearableValue = (value) => (value === '' ? null : value);
+export const clearableValue = (value) => value === '' ? null : value;
 export const parseListOption = (values) => {
     return values
         ?.flatMap((value) => value.split(','))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "4.23.1",
+  "version": "4.24.0",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {
@@ -59,7 +59,7 @@
     "@napi-rs/keyring": "1.3.0",
     "@sentry/node": "10.58.0",
     "adm-zip": "0.6.1",
-    "axios": "1.18.1",
+    "axios": "1.20.0",
     "axios-retry": "4.5.0",
     "c12": "3.3.3",
     "consola": "3.3.0",
@@ -73,7 +73,7 @@
     "semver": "7.6.3",
     "systeminformation": "5.31.17",
     "zod": "4.0.17",
-    "zodline": "0.3.0"
+    "zodline": "0.3.2"
   },
   "devDependencies": {
     "@ionic/prettier-config": "4.0.0",