@capawesome/cli 4.2.1 → 4.4.0

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 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)
+
+
+### Features
+
+* add part-level progress for multipart zip uploads ([#122](https://github.com/capawesome-team/cli/issues/122)) ([f74cda4](https://github.com/capawesome-team/cli/commit/f74cda48f454dfbc786052498ebecccef98e6fc5))
+
+
+### Bug Fixes
+
+* **deps:** remove `glob` dependency ([#120](https://github.com/capawesome-team/cli/issues/120)) ([80709de](https://github.com/capawesome-team/cli/commit/80709deac3292b976f3633f3335004d2cb80fc22))
+* read deployment ID from update response ([#121](https://github.com/capawesome-team/cli/issues/121)) ([9ef9979](https://github.com/capawesome-team/cli/commit/9ef99794a5bb14631fcecf41c1a9885931627dfd))
+* use ISO string timestamps ([#119](https://github.com/capawesome-team/cli/issues/119)) ([7fe8263](https://github.com/capawesome-team/cli/commit/7fe8263956fc83ca7a93d803e6867133fea8c879))
+* validate prompt response in bundle command ([#118](https://github.com/capawesome-team/cli/issues/118)) ([a1541a0](https://github.com/capawesome-team/cli/commit/a1541a074f614b42bf69f2c6a186eeef5d95200b))
+
 ## [4.2.1](https://github.com/capawesome-team/cli/compare/v4.2.0...v4.2.1) (2026-03-01)
 
 ## [4.2.0](https://github.com/capawesome-team/cli/compare/v4.1.0...v4.2.0) (2026-02-20)

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

@@ -33,10 +33,13 @@ export default defineCommand({
                 process.exit(1);
             }
             consola.warn('Make sure you have built your web assets before creating a bundle (e.g., `npm run build`).');
-            const response = await prompt('Enter the path to the web assets directory (e.g., `dist` or `www`):', {
+            inputPath = await prompt('Enter the path to the web assets directory (e.g., `dist` or `www`):', {
                 type: 'text',
             });
-            inputPath = response;
+            if (!inputPath) {
+                consola.error('You must provide an input path.');
+                process.exit(1);
+            }
         }
         // Convert to absolute path
         inputPath = pathModule.resolve(inputPath);

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

@@ -1,4 +1,4 @@
-import { DEFAULT_CONSOLE_BASE_URL, MAX_CONCURRENT_UPLOADS } from '../../../config/index.js';
+import { DEFAULT_CONSOLE_BASE_URL, 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';
@@ -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) {
@@ -236,7 +233,7 @@ export default defineCommand({
         }
         // Create the app bundle
         consola.start('Creating bundle...');
-        const response = await appBundlesService.create({
+        const createBundleResponse = await appBundlesService.create({
             appId,
             artifactType,
             channelName: channel,
@@ -247,7 +244,6 @@ export default defineCommand({
             gitCommitSha: commitSha,
             gitRef,
             customProperties: parseCustomProperties(customProperty),
-            expiresAt,
             maxAndroidAppVersionCode: androidMax,
             maxIosAppVersionCode: iosMax,
             minAndroidAppVersionCode: androidMin,
@@ -258,29 +254,29 @@ export default defineCommand({
         let appBundleFileId;
         // Upload the app bundle files
         if (artifactType === 'manifest') {
-            await uploadFiles({ appId, appBundleId: response.id, path, privateKeyBuffer });
+            await uploadFiles({ appId, appBundleId: createBundleResponse.id, path, privateKeyBuffer });
         }
         else {
-            const result = await uploadZip({ appId, appBundleId: response.id, path, privateKeyBuffer });
+            const result = await uploadZip({ appId, appBundleId: createBundleResponse.id, path, privateKeyBuffer });
             appBundleFileId = result.appBundleFileId;
         }
         // Update the app bundle
         consola.start('Updating bundle...');
-        await appBundlesService.update({
+        const updateBundleResponse = await appBundlesService.update({
             appBundleFileId,
             appId,
             artifactStatus: 'ready',
-            appBundleId: response.id,
+            appBundleId: createBundleResponse.id,
         });
-        consola.info(`Build Artifact ID: ${response.id}`);
-        if (response.appDeploymentId) {
-            consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${response.appDeploymentId}`);
+        consola.info(`Build Artifact ID: ${createBundleResponse.id}`);
+        if (updateBundleResponse.appDeploymentId) {
+            consola.info(`Deployment URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${appId}/deployments/${updateBundleResponse.appDeploymentId}`);
         }
         consola.success('Live Update successfully uploaded.');
     }),
 });
 const uploadFile = async (options) => {
-    let { appId, appBundleId, buffer, href, mimeType, name, privateKeyBuffer, retryOnFailure } = options;
+    let { appId, appBundleId, buffer, href, mimeType, name, onProgress, privateKeyBuffer, retryOnFailure } = options;
     try {
         // Generate checksum
         const hash = await createHash(buffer);
@@ -299,7 +295,7 @@ const uploadFile = async (options) => {
             mimeType,
             name,
             signature,
-        });
+        }, onProgress);
     }
     catch (error) {
         if (retryOnFailure) {
@@ -339,8 +335,8 @@ const uploadFiles = async (options) => {
         });
         await uploadNextFile();
     };
-    const uploadPromises = Array.from({ length: MAX_CONCURRENT_UPLOADS });
-    for (let i = 0; i < MAX_CONCURRENT_UPLOADS; i++) {
+    const uploadPromises = Array.from({ length: MAX_CONCURRENT_FILE_UPLOADS });
+    for (let i = 0; i < MAX_CONCURRENT_FILE_UPLOADS; i++) {
         uploadPromises[i] = uploadNextFile();
     }
     await Promise.all(uploadPromises);
@@ -365,6 +361,9 @@ const uploadZip = async (options) => {
         buffer: fileBuffer,
         mimeType: 'application/zip',
         name: 'bundle.zip',
+        onProgress: (completed, total) => {
+            consola.start(`Uploading file (part ${completed}/${total})...`);
+        },
         privateKeyBuffer: privateKeyBuffer,
     });
     return {

package/dist/config/consts.js

@@ -1,4 +1,5 @@
 export const DEFAULT_API_BASE_URL = 'https://api.cloud.capawesome.io';
 export const DEFAULT_CONSOLE_BASE_URL = 'https://console.cloud.capawesome.io';
 export const MANIFEST_JSON_FILE_NAME = 'capawesome-live-update-manifest.json'; // Do NOT change this!
-export const MAX_CONCURRENT_UPLOADS = 20;
+export const MAX_CONCURRENT_FILE_UPLOADS = 20;
+export const MAX_CONCURRENT_PART_UPLOADS = 4;

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-bundle-files.js

@@ -1,4 +1,4 @@
-import { MAX_CONCURRENT_UPLOADS } from '../config/index.js';
+import { MAX_CONCURRENT_PART_UPLOADS } from '../config/index.js';
 import authorizationService from '../services/authorization-service.js';
 import httpClient from '../utils/http-client.js';
 import FormData from 'form-data';
@@ -7,7 +7,7 @@ class AppBundleFilesServiceImpl {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
-    async create(dto) {
+    async create(dto, onProgress) {
         const sizeInBytes = dto.buffer.byteLength;
         const useMultipartUpload = sizeInBytes >= 50 * 1024 * 1024; // 50 MB
         const formData = new FormData();
@@ -38,7 +38,7 @@ class AppBundleFilesServiceImpl {
                 buffer: dto.buffer,
                 name: dto.name,
                 checksum: dto.checksum,
-            });
+            }, onProgress);
         }
         return response.data;
     }
@@ -74,7 +74,7 @@ class AppBundleFilesServiceImpl {
         })
             .then((response) => response.data);
     }
-    async createUploadParts(dto) {
+    async createUploadParts(dto, onProgress) {
         const uploadedParts = [];
         const partSize = 10 * 1024 * 1024; // 10 MB. 5 MB is the minimum part size except for the last part.
         const totalParts = Math.ceil(dto.buffer.byteLength / partSize);
@@ -84,6 +84,7 @@ class AppBundleFilesServiceImpl {
                 return;
             }
             partNumber++;
+            onProgress?.(partNumber, totalParts);
             const start = (partNumber - 1) * partSize;
             const end = Math.min(start + partSize, dto.buffer.byteLength);
             const partBuffer = dto.buffer.subarray(start, end);
@@ -99,14 +100,14 @@ class AppBundleFilesServiceImpl {
             uploadedParts.push(uploadedPart);
             await uploadNextPart();
         };
-        const uploadPartPromises = Array.from({ length: MAX_CONCURRENT_UPLOADS });
-        for (let i = 0; i < MAX_CONCURRENT_UPLOADS; i++) {
+        const uploadPartPromises = Array.from({ length: MAX_CONCURRENT_PART_UPLOADS });
+        for (let i = 0; i < MAX_CONCURRENT_PART_UPLOADS; i++) {
             uploadPartPromises[i] = uploadNextPart();
         }
         await Promise.all(uploadPartPromises);
-        return uploadedParts;
+        return uploadedParts.sort((a, b) => a.partNumber - b.partNumber);
     }
-    async upload(dto) {
+    async upload(dto, onProgress) {
         // 1. Create a multipart upload
         const { uploadId } = await this.createUpload({
             appBundleFileId: dto.appBundleFileId,
@@ -121,7 +122,7 @@ class AppBundleFilesServiceImpl {
             buffer: dto.buffer,
             name: dto.name,
             uploadId,
-        });
+        }, onProgress);
         // 3. Complete the upload
         await this.completeUpload({
             appBundleFileId: dto.appBundleFileId,

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/dist/utils/time-format.js

@@ -1,6 +1,6 @@
 export function formatTimeAgo(timestamp) {
     const now = Date.now();
-    const diffInMs = now - timestamp;
+    const diffInMs = now - new Date(timestamp).getTime();
     const diffInSeconds = Math.floor(diffInMs / 1000);
     if (diffInSeconds < 60) {
         return 'just now';

package/dist/utils/zip.js

@@ -1,15 +1,9 @@
-import archiver from 'archiver';
+import AdmZip from 'adm-zip';
 class ZipImpl {
     async zipFolder(sourceFolder) {
-        return new Promise((resolve, reject) => {
-            const archive = archiver('zip', { zlib: { level: 9 } });
-            const buffers = [];
-            archive.on('data', (data) => buffers.push(data));
-            archive.on('error', (err) => reject(err));
-            archive.on('end', () => resolve(Buffer.concat(buffers)));
-            archive.directory(sourceFolder, false);
-            archive.finalize();
-        });
+        const zip = new AdmZip();
+        zip.addLocalFolder(sourceFolder);
+        return zip.toBuffer();
     }
     isZipped(path) {
         return path.endsWith('.zip');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "4.2.1",
+  "version": "4.4.0",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {
@@ -51,15 +51,11 @@
       "url": "https://opencollective.com/capawesome"
     }
   ],
-  "overrides": {
-    "glob": "13.0.6",
-    "minimatch": "10.2.4"
-  },
   "dependencies": {
     "@clack/prompts": "0.7.0",
     "@robingenz/zli": "0.2.0",
     "@sentry/node": "8.55.0",
-    "archiver": "7.0.1",
+    "adm-zip": "0.5.16",
     "axios": "1.13.5",
     "axios-retry": "4.5.0",
     "c12": "3.3.3",
@@ -77,7 +73,7 @@
   "devDependencies": {
     "@ionic/prettier-config": "4.0.0",
     "@sentry/cli": "2.52.0",
-    "@types/archiver": "6.0.3",
+    "@types/adm-zip": "0.5.7",
     "@types/mime": "3.0.4",
     "@types/node": "24.2.1",
     "@types/semver": "7.5.8",