@capawesome/cli 4.3.0 → 4.4.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 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.4.0](https://github.com/capawesome-team/cli/compare/v4.3.0...v4.4.0) (2026-03-13)
+
+
+### Features
+
+* add `apps:devices:forcechannel` and `apps:devices:unforcechannel` commands ([#124](https://github.com/capawesome-team/cli/issues/124)) ([c47c15f](https://github.com/capawesome-team/cli/commit/c47c15fc8328824973dd9062bfac2bca2e847752))
+* add deprecation warning for `--expires-in-days` option ([#123](https://github.com/capawesome-team/cli/issues/123)) ([db628a2](https://github.com/capawesome-team/cli/commit/db628a21b50b826d59a1b29eb3913c1f6ce225bf))
+* add warning when using manifest artifact type ([42a6b2b](https://github.com/capawesome-team/cli/commit/42a6b2bfae0cc958127d4ff60562000eb9713943))
+
 ## [4.3.0](https://github.com/capawesome-team/cli/compare/v4.2.1...v4.3.0) (2026-03-07)
 
 

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

@@ -25,12 +25,8 @@ export default defineCommand({
     })),
     action: withAuth(async (options, args) => {
         let { appId, expiresInDays, ignoreErrors, name, protected: _protected } = options;
-        // Calculate the expiration date
-        let expiresAt;
         if (expiresInDays) {
-            const expiresAtDate = new Date();
-            expiresAtDate.setDate(expiresAtDate.getDate() + expiresInDays);
-            expiresAt = expiresAtDate.toISOString();
+            consola.warn('The `--expires-in-days` option is deprecated and will be removed in a future version. Channel expiration is now managed by the data retention policy of your organization billing plan.');
         }
         // Validate the app ID
         if (!appId) {
@@ -54,7 +50,6 @@ export default defineCommand({
                 appId,
                 protected: _protected,
                 name,
-                expiresAt,
             });
             consola.info(`Channel ID: ${response.id}`);
             consola.success('Channel created successfully.');

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

@@ -109,29 +109,24 @@ describe('apps-channels-create', () => {
         await expect(createChannelCommand.action(options, undefined)).rejects.toThrow();
         expect(scope.isDone()).toBe(true);
     });
-    it('should create channel with expiresInDays option', async () => {
+    it('should show warning when expiresInDays option is used', async () => {
         const appId = 'app-123';
         const channelName = 'production';
         const expiresInDays = 30;
         const channelId = 'channel-456';
         const testToken = 'test-token';
         const options = { appId, name: channelName, expiresInDays };
-        // Calculate expected expiration date
-        const expectedExpiresAt = new Date();
-        expectedExpiresAt.setDate(expectedExpiresAt.getDate() + expiresInDays);
         const scope = nock(DEFAULT_API_BASE_URL)
-            .post(`/v1/apps/${appId}/channels`, (body) => {
-            // Verify the request includes expiresAt and it's approximately correct (within 1 minute)
-            const actualExpiresAt = new Date(body.expiresAt);
-            const timeDiff = Math.abs(actualExpiresAt.getTime() - expectedExpiresAt.getTime());
-            const oneMinute = 60 * 1000;
-            return (body.appId === appId && body.name === channelName && body.protected === undefined && timeDiff < oneMinute);
+            .post(`/v1/apps/${appId}/channels`, {
+            appId,
+            name: channelName,
+            protected: undefined,
         })
             .matchHeader('Authorization', `Bearer ${testToken}`)
             .reply(201, { id: channelId, name: channelName });
         await createChannelCommand.action(options, undefined);
         expect(scope.isDone()).toBe(true);
+        expect(mockConsola.warn).toHaveBeenCalledWith('The `--expires-in-days` option is deprecated and will be removed in a future version. Channel expiration is now managed by the data retention policy of your organization billing plan.');
         expect(mockConsola.success).toHaveBeenCalledWith('Channel created successfully.');
-        expect(mockConsola.info).toHaveBeenCalledWith(`Channel ID: ${channelId}`);
     });
 });

package/dist/commands/apps/devices/forcechannel.js

@@ -0,0 +1,66 @@
+import appChannelsService from '../../../services/app-channels.js';
+import appDevicesService from '../../../services/app-devices.js';
+import { withAuth } from '../../../utils/auth.js';
+import { isInteractive } from '../../../utils/environment.js';
+import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Force a device to use a specific channel.',
+    options: defineOptions(z.object({
+        appId: z.string().uuid({ message: 'App ID must be a UUID.' }).optional().describe('ID of the app.'),
+        deviceId: z.string().optional().describe('ID of the device.'),
+        channel: z.string().optional().describe('Name of the channel to force.'),
+    })),
+    action: withAuth(async (options, args) => {
+        let { appId, deviceId, channel } = 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);
+        }
+        if (!deviceId) {
+            if (!isInteractive()) {
+                consola.error('You must provide the device ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            deviceId = await prompt('Enter the device ID:', {
+                type: 'text',
+            });
+        }
+        if (!channel) {
+            if (!isInteractive()) {
+                consola.error('You must provide a channel when running in non-interactive environment.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            channel = await prompt('Enter the name of the channel to force:', {
+                type: 'text',
+            });
+            if (!channel) {
+                consola.error('You must provide a channel name.');
+                process.exit(1);
+            }
+        }
+        const channels = await appChannelsService.findAll({ appId, name: channel });
+        if (channels.length === 0) {
+            consola.error('Channel not found.');
+            process.exit(1);
+        }
+        const channelId = channels[0]?.id;
+        if (!channelId) {
+            consola.error('Channel ID not found.');
+            process.exit(1);
+        }
+        await appDevicesService.update({
+            appId,
+            deviceId,
+            forcedAppChannelId: channelId,
+        });
+        consola.success('Device forced to channel successfully.');
+    }),
+});

package/dist/commands/apps/devices/unforcechannel.js

@@ -0,0 +1,40 @@
+import appDevicesService from '../../../services/app-devices.js';
+import { withAuth } from '../../../utils/auth.js';
+import { isInteractive } from '../../../utils/environment.js';
+import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Remove the forced channel from a device.',
+    options: defineOptions(z.object({
+        appId: z.string().uuid({ message: 'App ID must be a UUID.' }).optional().describe('ID of the app.'),
+        deviceId: z.string().optional().describe('ID of the device.'),
+    })),
+    action: withAuth(async (options, args) => {
+        let { appId, deviceId } = 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);
+        }
+        if (!deviceId) {
+            if (!isInteractive()) {
+                consola.error('You must provide the device ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            deviceId = await prompt('Enter the device ID:', {
+                type: 'text',
+            });
+        }
+        await appDevicesService.update({
+            appId,
+            deviceId,
+            forcedAppChannelId: null,
+        });
+        consola.success('Forced channel removed from device successfully.');
+    }),
+});

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

@@ -102,12 +102,8 @@ export default defineCommand({
     }), { y: 'yes' }),
     action: withAuth(async (options, args) => {
         let { androidEq, androidMax, androidMin, appId, channel, commitMessage, commitRef, commitSha, customProperty, expiresInDays, gitRef, iosEq, iosMax, iosMin, path, privateKey, rolloutPercentage, url, } = options;
-        // Calculate the expiration date
-        let expiresAt;
         if (expiresInDays) {
-            const expiresAtDate = new Date();
-            expiresAtDate.setDate(expiresAtDate.getDate() + expiresInDays);
-            expiresAt = expiresAtDate.toISOString();
+            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.');
         }
         // Prompt for url if not provided
         if (!url) {
@@ -226,7 +222,6 @@ export default defineCommand({
             gitCommitSha: commitSha,
             gitRef,
             customProperties: parseCustomProperties(customProperty),
-            expiresAt,
             url,
             maxAndroidAppVersionCode: androidMax,
             maxIosAppVersionCode: iosMax,

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

@@ -115,12 +115,8 @@ export default defineCommand({
     }), { y: 'yes' }),
     action: withAuth(async (options, args) => {
         let { androidEq, androidMax, androidMin, appId, artifactType, channel, commitMessage, commitRef, commitSha, customProperty, expiresInDays, gitRef, iosEq, iosMax, iosMin, path, privateKey, rolloutPercentage, } = options;
-        // Calculate the expiration date
-        let expiresAt;
         if (expiresInDays) {
-            const expiresAtDate = new Date();
-            expiresAtDate.setDate(expiresAtDate.getDate() + expiresInDays);
-            expiresAt = expiresAtDate.toISOString();
+            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.');
         }
         // Prompt for path if not provided
         if (!path) {
@@ -167,6 +163,7 @@ export default defineCommand({
                 consola.error('The path must be a folder when creating a bundle with an artifact type of `manifest`.');
                 process.exit(1);
             }
+            consola.warn('The `zip` artifact type is faster and more efficient for most apps. The `manifest` type can result in longer downloads and more network requests if your files change frequently between builds. Learn more: https://capawesome.io/cloud/live-updates/advanced/delta-updates/');
         }
         // Prompt for appId if not provided
         if (!appId) {
@@ -247,7 +244,6 @@ export default defineCommand({
             gitCommitSha: commitSha,
             gitRef,
             customProperties: parseCustomProperties(customProperty),
-            expiresAt,
             maxAndroidAppVersionCode: androidMax,
             maxIosAppVersionCode: iosMax,
             minAndroidAppVersionCode: androidMin,

package/dist/index.js

@@ -46,6 +46,8 @@ const config = defineConfig({
         'apps:deployments:cancel': await import('./commands/apps/deployments/cancel.js').then((mod) => mod.default),
         'apps:deployments:logs': await import('./commands/apps/deployments/logs.js').then((mod) => mod.default),
         'apps:devices:delete': await import('./commands/apps/devices/delete.js').then((mod) => mod.default),
+        'apps:devices:forcechannel': await import('./commands/apps/devices/forcechannel.js').then((mod) => mod.default),
+        'apps:devices:unforcechannel': await import('./commands/apps/devices/unforcechannel.js').then((mod) => mod.default),
         'apps:liveupdates:bundle': await import('./commands/apps/liveupdates/bundle.js').then((mod) => mod.default),
         'apps:liveupdates:generatesigningkey': await import('./commands/apps/liveupdates/generate-signing-key.js').then((mod) => mod.default),
         'apps:liveupdates:rollback': await import('./commands/apps/liveupdates/rollback.js').then((mod) => mod.default),

package/dist/services/app-devices.js

@@ -12,6 +12,13 @@ class AppDevicesServiceImpl {
             },
         });
     }
+    async update(data) {
+        await this.httpClient.patch(`/v1/apps/${data.appId}/devices/${data.deviceId}`, { forcedAppChannelId: data.forcedAppChannelId }, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+        });
+    }
 }
 const appDevicesService = new AppDevicesServiceImpl(httpClient);
 export default appDevicesService;

package/package.json

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