@capawesome/cli 4.5.0 → 4.6.0-dev.80c962a.1774597304

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.6.0](https://github.com/capawesome-team/cli/compare/v4.5.0...v4.6.0) (2026-03-18)
+
+
+### Features
+
+* add `apps:devices:probe` command ([#129](https://github.com/capawesome-team/cli/issues/129)) ([33607cd](https://github.com/capawesome-team/cli/commit/33607cdb2e65e26c48d114d694b876db3762b8ec))
+
 ## [4.5.0](https://github.com/capawesome-team/cli/compare/v4.4.0...v4.5.0) (2026-03-15)
 
 

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

@@ -3,6 +3,7 @@ import appBuildsService from '../../../services/app-builds.js';
 import appCertificatesService from '../../../services/app-certificates.js';
 import appEnvironmentsService from '../../../services/app-environments.js';
 import { unescapeAnsi } from '../../../utils/ansi.js';
+import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
@@ -61,6 +62,14 @@ export default defineCommand({
             .string()
             .optional()
             .describe('The type of build. For iOS, supported values are `simulator`, `development`, `ad-hoc`, `app-store`, and `enterprise`. For Android, supported values are `debug` and `release`. For Web, no type is required.'),
+        variable: z
+            .array(z.string())
+            .optional()
+            .describe('Ad hoc environment variable in key=value format. Can be specified multiple times.'),
+        variableFile: z
+            .string()
+            .optional()
+            .describe('Path to a file containing ad hoc environment variables in .env format.'),
         zip: z
             .union([z.boolean(), z.string()])
             .optional()
@@ -197,9 +206,22 @@ export default defineCommand({
                 }
             }
         }
+        // Parse ad hoc environment variables from inline and file
+        const variablesMap = new Map();
+        if (options.variableFile) {
+            const fileContent = await fs.readFile(options.variableFile, 'utf-8');
+            const fileVariables = parseKeyValuePairs(fileContent);
+            fileVariables.forEach((v) => variablesMap.set(v.key, v.value));
+        }
+        if (options.variable) {
+            const inlineVariables = parseKeyValuePairs(options.variable.join('\n'));
+            inlineVariables.forEach((v) => variablesMap.set(v.key, v.value));
+        }
+        const adHocEnvironmentVariables = variablesMap.size > 0 ? Object.fromEntries(variablesMap) : undefined;
         // Create the app build
         consola.start('Creating build...');
         const response = await appBuildsService.create({
+            adHocEnvironmentVariables,
             appCertificateName: certificate,
             appEnvironmentName: environment,
             appId,

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

@@ -74,24 +74,9 @@ export default defineCommand({
                 process.exit(1);
             }
         }
-        // 4. Select certificate type
-        if (!type) {
-            if (!isInteractive()) {
-                consola.error('You must provide the certificate type when running in non-interactive environment.');
-                process.exit(1);
-            }
-            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
-            type = await prompt('Select the certificate type:', {
-                type: 'select',
-                options: [
-                    { label: 'Development', value: 'development' },
-                    { label: 'Production', value: 'production' },
-                ],
-            });
-            if (!type) {
-                consola.error('You must select a certificate type.');
-                process.exit(1);
-            }
+        // 4. Warn if deprecated --type option is used
+        if (type) {
+            consola.warn('The --type option is deprecated and will be removed in a future version. The certificate type is now detected automatically.');
         }
         // 5. Enter certificate file path
         if (!file) {
@@ -167,7 +152,6 @@ export default defineCommand({
             fileName,
             name,
             platform: platform,
-            type: type,
             password,
             keyAlias,
             keyPassword,

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

@@ -36,11 +36,13 @@ export default defineCommand({
             }
             certificateId = await prompt('Enter the certificate ID:', { type: 'text' });
         }
+        if (type) {
+            consola.warn('The --type option is deprecated and will be removed in a future version. The certificate type is now detected automatically.');
+        }
         await appCertificatesService.update({
             appId,
             certificateId,
             name,
-            type,
             password,
             keyAlias,
             keyPassword,

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

@@ -10,11 +10,11 @@ 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.'),
+        deviceId: z.array(z.string()).optional().describe('ID of the device. Can be specified multiple times.'),
         channel: z.string().optional().describe('Name of the channel to force.'),
     })),
     action: withAuth(async (options, args) => {
-        let { appId, deviceId, channel } = options;
+        let { appId, deviceId: deviceIds, channel } = options;
         if (!appId) {
             if (!isInteractive()) {
                 consola.error('You must provide an app ID when running in non-interactive environment.');
@@ -23,14 +23,15 @@ export default defineCommand({
             const organizationId = await promptOrganizationSelection();
             appId = await promptAppSelection(organizationId);
         }
-        if (!deviceId) {
+        if (!deviceIds || deviceIds.length === 0) {
             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:', {
+            const deviceId = await prompt('Enter the device ID:', {
                 type: 'text',
             });
+            deviceIds = [deviceId];
         }
         if (!channel) {
             if (!isInteractive()) {
@@ -56,11 +57,12 @@ export default defineCommand({
             consola.error('Channel ID not found.');
             process.exit(1);
         }
-        await appDevicesService.update({
+        await appDevicesService.updateMany({
             appId,
-            deviceId,
+            deviceIds,
             forcedAppChannelId: channelId,
         });
-        consola.success('Device forced to channel successfully.');
+        const deviceCount = deviceIds.length;
+        consola.success(`${deviceCount === 1 ? 'Device' : `${deviceCount} devices`} forced to channel successfully.`);
     }),
 });

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

@@ -0,0 +1,70 @@
+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 { AxiosError } from 'axios';
+import consola from 'consola';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Check whether a device would receive a live update.',
+    options: defineOptions(z.object({
+        appId: z.string().optional().describe('ID of the app.'),
+        deviceId: z.string().optional().describe('ID of the device.'),
+        json: z.boolean().optional().describe('Output in JSON format.'),
+    })),
+    action: withAuth(async (options) => {
+        let { appId, deviceId, 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);
+        }
+        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',
+            });
+        }
+        const device = await appDevicesService.findOneById({ appId, deviceId });
+        try {
+            const result = await appDevicesService.probe({
+                appId,
+                appVersionCode: device.appVersionCode,
+                appVersionName: device.appVersionName,
+                channelName: device.appChannel?.name,
+                customId: device.customId ?? undefined,
+                deviceId: device.id,
+                osVersion: device.osVersion,
+                platform: device.platform,
+                pluginVersion: device.pluginVersion,
+            });
+            if (json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.table(result);
+                consola.success('Update available for this device.');
+            }
+        }
+        catch (error) {
+            if (error instanceof AxiosError && error.response?.status === 404) {
+                if (json) {
+                    console.log(JSON.stringify({ bundleId: null }, null, 2));
+                }
+                else {
+                    consola.info('No update available for this device.');
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }),
+});

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

@@ -9,10 +9,10 @@ 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.'),
+        deviceId: z.array(z.string()).optional().describe('ID of the device. Can be specified multiple times.'),
     })),
     action: withAuth(async (options, args) => {
-        let { appId, deviceId } = options;
+        let { appId, deviceId: deviceIds } = options;
         if (!appId) {
             if (!isInteractive()) {
                 consola.error('You must provide an app ID when running in non-interactive environment.');
@@ -21,20 +21,22 @@ export default defineCommand({
             const organizationId = await promptOrganizationSelection();
             appId = await promptAppSelection(organizationId);
         }
-        if (!deviceId) {
+        if (!deviceIds || deviceIds.length === 0) {
             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:', {
+            const deviceId = await prompt('Enter the device ID:', {
                 type: 'text',
             });
+            deviceIds = [deviceId];
         }
-        await appDevicesService.update({
+        await appDevicesService.updateMany({
             appId,
-            deviceId,
+            deviceIds,
             forcedAppChannelId: null,
         });
-        consola.success('Forced channel removed from device successfully.');
+        const deviceCount = deviceIds.length;
+        consola.success(`Forced channel removed from ${deviceCount === 1 ? 'device' : `${deviceCount} devices`} successfully.`);
     }),
 });

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

@@ -1,5 +1,5 @@
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath, isDirectory } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, fileExistsAtPath, isDirectory } from '../../../utils/file.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { prompt } from '../../../utils/prompt.js';
 import zip from '../../../utils/zip.js';
@@ -62,6 +62,11 @@ export default defineCommand({
             consola.error(`Directory must contain an index.html file: ${inputPath}`);
             process.exit(1);
         }
+        // Check for source maps
+        const containsSourceMaps = await directoryContainsSourceMaps(inputPath);
+        if (containsSourceMaps) {
+            consola.warn('Source map files were detected in the specified path. Source maps should not be distributed to end users as they expose your original source code and increase the download size. Consider excluding source map files from your build output.');
+        }
         // 2. Output path resolution
         if (!outputPath) {
             outputPath = './bundle.zip';

package/dist/commands/apps/liveupdates/generate-manifest.js

@@ -1,5 +1,5 @@
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, fileExistsAtPath } from '../../../utils/file.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { prompt } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
@@ -32,6 +32,11 @@ export default defineCommand({
             consola.error(`The path does not exist.`);
             process.exit(1);
         }
+        // Check for source maps
+        const containsSourceMaps = await directoryContainsSourceMaps(path);
+        if (containsSourceMaps) {
+            consola.warn('Source map files were detected in the specified path. Source maps should not be distributed to end users as they expose your original source code and increase the download size. Consider excluding source map files from your build output.');
+        }
         // Generate the manifest file
         await generateManifestJson(path);
         consola.success('Manifest file generated.');

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

@@ -5,7 +5,7 @@ import appsService from '../../../services/apps.js';
 import { withAuth } from '../../../utils/auth.js';
 import { createBufferFromPath, createBufferFromReadStream, createBufferFromString, isPrivateKeyContent, } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory, } from '../../../utils/file.js';
 import { createHash } from '../../../utils/hash.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { formatPrivateKey } from '../../../utils/private-key.js';
@@ -156,6 +156,13 @@ export default defineCommand({
             consola.error('The path must be either a folder or a zip file.');
             process.exit(1);
         }
+        // Check for source maps
+        if (pathIsDirectory) {
+            const containsSourceMaps = await directoryContainsSourceMaps(path);
+            if (containsSourceMaps) {
+                consola.warn('Source map files were detected in the specified path. Source maps should not be distributed to end users as they expose your original source code and increase the download size. Consider excluding source map files from your build output.');
+            }
+        }
         // Check that the path is a directory when creating a bundle with an artifact type of manifest
         if (artifactType === 'manifest') {
             const pathIsDirectory = await isDirectory(path);

package/dist/index.js

@@ -52,6 +52,7 @@ const config = defineConfig({
         'apps:destinations:update': await import('./commands/apps/destinations/update.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:probe': await import('./commands/apps/devices/probe.js').then((mod) => mod.default),
         'apps:devices:unforcechannel': await import('./commands/apps/devices/unforcechannel.js').then((mod) => mod.default),
         'apps:environments:create': await import('./commands/apps/environments/create.js').then((mod) => mod.default),
         'apps:environments:delete': await import('./commands/apps/environments/delete.js').then((mod) => mod.default),

package/dist/services/app-certificates.js

@@ -11,7 +11,6 @@ class AppCertificatesServiceImpl {
         formData.append('file', dto.buffer, { filename: dto.fileName });
         formData.append('name', dto.name);
         formData.append('platform', dto.platform);
-        formData.append('type', dto.type);
         if (dto.password) {
             formData.append('password', dto.password);
         }

package/dist/services/app-devices.js

@@ -12,6 +12,42 @@ class AppDevicesServiceImpl {
             },
         });
     }
+    async findOneById(data) {
+        const response = await this.httpClient.get(`/v1/apps/${data.appId}/devices/${data.deviceId}`, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+            params: {
+                relations: 'appChannel',
+            },
+        });
+        return response.data;
+    }
+    async probe(data) {
+        const params = {
+            appVersionCode: data.appVersionCode,
+            appVersionName: data.appVersionName,
+            osVersion: data.osVersion,
+            platform: data.platform.toString(),
+            pluginVersion: data.pluginVersion,
+        };
+        if (data.channelName) {
+            params.channelName = data.channelName;
+        }
+        if (data.customId) {
+            params.customId = data.customId;
+        }
+        if (data.deviceId) {
+            params.deviceId = data.deviceId;
+        }
+        const response = await this.httpClient.get(`/v1/apps/${data.appId}/bundles/latest`, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+            params,
+        });
+        return response.data;
+    }
     async update(data) {
         await this.httpClient.patch(`/v1/apps/${data.appId}/devices/${data.deviceId}`, { forcedAppChannelId: data.forcedAppChannelId }, {
             headers: {
@@ -19,6 +55,14 @@ class AppDevicesServiceImpl {
             },
         });
     }
+    async updateMany(data) {
+        const ids = data.deviceIds.join(',');
+        await this.httpClient.patch(`/v1/apps/${data.appId}/devices?ids=${ids}`, { forcedAppChannelId: data.forcedAppChannelId }, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+        });
+    }
 }
 const appDevicesService = new AppDevicesServiceImpl(httpClient);
 export default appDevicesService;

package/dist/utils/file.js

@@ -35,6 +35,10 @@ export const getFilesInDirectoryAndSubdirectories = async (path) => {
     await walk(path);
     return files;
 };
+export const directoryContainsSourceMaps = async (path) => {
+    const files = await getFilesInDirectoryAndSubdirectories(path);
+    return files.some((file) => file.name.endsWith('.js.map') || file.name.endsWith('.css.map'));
+};
 export const fileExistsAtPath = async (path) => {
     return new Promise((resolve) => {
         fs.access(path, fs.constants.F_OK, (err) => {

package/package.json

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