@capawesome/cli 4.5.0 → 4.6.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.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/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/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-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: {

package/package.json

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