@capawesome/cli 4.5.0 → 4.6.0-dev.0108a83.1774286472

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

@@ -1,4 +1,5 @@
 import { DEFAULT_CONSOLE_BASE_URL } from '../../../config/consts.js';
+import appBuildSourcesService from '../../../services/app-build-sources.js';
 import appBuildsService from '../../../services/app-builds.js';
 import appCertificatesService from '../../../services/app-certificates.js';
 import appEnvironmentsService from '../../../services/app-environments.js';
@@ -7,6 +8,7 @@ import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import { wait } from '../../../utils/wait.js';
+import zip from '../../../utils/zip.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
 import consola from 'consola';
 import fs from 'fs/promises';
@@ -45,6 +47,7 @@ export default defineCommand({
             .optional()
             .describe('Download the generated IPA file (iOS only). Optionally provide a file path.'),
         json: z.boolean().optional().describe('Output in JSON format.'),
+        path: z.string().optional().describe('Path to local source files to upload.'),
         platform: z
             .enum(['ios', 'android', 'web'], {
             message: 'Platform must be either `ios`, `android`, or `web`.',
@@ -68,7 +71,7 @@ export default defineCommand({
         yes: z.boolean().optional().describe('Skip confirmation prompts.'),
     }), { y: 'yes' }),
     action: withAuth(async (options) => {
-        let { appId, platform, type, gitRef, environment, certificate, json, stack } = options;
+        let { appId, platform, type, gitRef, environment, certificate, json, stack, path: sourcePath } = options;
         // Validate that detached flag cannot be used with artifact flags
         if (options.detached && (options.apk || options.aab || options.ipa || options.zip)) {
             consola.error('The --detached flag cannot be used with --apk, --aab, --ipa, or --zip flags.');
@@ -84,6 +87,26 @@ export default defineCommand({
             consola.error('The --channel and --destination flags cannot be used together.');
             process.exit(1);
         }
+        // Validate that path and gitRef cannot be used together
+        if (sourcePath && gitRef) {
+            consola.error('The --path and --git-ref flags cannot be used together.');
+            process.exit(1);
+        }
+        // Validate path if provided
+        if (sourcePath) {
+            const resolvedPath = path.resolve(sourcePath);
+            const stat = await fs.stat(resolvedPath).catch(() => null);
+            if (!stat || !stat.isDirectory()) {
+                consola.error('The --path must point to an existing directory.');
+                process.exit(1);
+            }
+            const packageJsonPath = path.join(resolvedPath, 'package.json');
+            const packageJsonStat = await fs.stat(packageJsonPath).catch(() => null);
+            if (!packageJsonStat || !packageJsonStat.isFile()) {
+                consola.error('The directory specified by --path must contain a package.json file.');
+                process.exit(1);
+            }
+        }
         // Prompt for app ID if not provided
         if (!appId) {
             if (!isInteractive()) {
@@ -113,10 +136,10 @@ export default defineCommand({
                 process.exit(1);
             }
         }
-        // Prompt for git ref if not provided
-        if (!gitRef) {
+        // Prompt for git ref if not provided and no path specified
+        if (!sourcePath && !gitRef) {
             if (!isInteractive()) {
-                consola.error('You must provide a git ref when running in non-interactive environment.');
+                consola.error('You must provide a git ref or path when running in non-interactive environment.');
                 process.exit(1);
             }
             gitRef = await prompt('Enter the Git reference (branch, tag, or commit SHA):', {
@@ -197,9 +220,28 @@ export default defineCommand({
                 }
             }
         }
+        // Upload source files if path is provided
+        let appBuildSourceId;
+        if (sourcePath) {
+            const resolvedPath = path.resolve(sourcePath);
+            consola.start('Zipping source files...');
+            const buffer = await zip.zipFolderWithGitignore(resolvedPath);
+            consola.start('Uploading source files...');
+            const appBuildSource = await appBuildSourcesService.create({
+                appId,
+                fileSizeInBytes: buffer.byteLength,
+                buffer,
+                name: 'source.zip',
+            }, (currentPart, totalParts) => {
+                consola.start(`Uploading source files (${currentPart}/${totalParts})...`);
+            });
+            appBuildSourceId = appBuildSource.id;
+            consola.success('Source files uploaded successfully.');
+        }
         // Create the app build
         consola.start('Creating build...');
         const response = await appBuildsService.create({
+            appBuildSourceId,
             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/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/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-build-sources.js

@@ -0,0 +1,112 @@
+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';
+class AppBuildSourcesServiceImpl {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    async create(dto, onProgress) {
+        const response = await this.httpClient.post(`/v1/apps/${dto.appId}/build-sources`, { fileSizeInBytes: dto.fileSizeInBytes }, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+        });
+        await this.upload({
+            appBuildSourceId: response.data.id,
+            appId: dto.appId,
+            buffer: dto.buffer,
+            name: dto.name,
+        }, onProgress);
+        return response.data;
+    }
+    async completeUpload(dto) {
+        return this.httpClient
+            .post(`/v1/apps/${dto.appId}/build-sources/${dto.appBuildSourceId}/upload?action=mpu-complete&uploadId=${dto.uploadId}`, {
+            parts: dto.parts,
+        }, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+        })
+            .then((response) => response.data);
+    }
+    async createUpload(dto) {
+        const response = await this.httpClient.post(`/v1/apps/${dto.appId}/build-sources/${dto.appBuildSourceId}/upload?action=mpu-create`, {}, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+            },
+        });
+        return response.data;
+    }
+    async createUploadPart(dto) {
+        const formData = new FormData();
+        formData.append('blob', dto.buffer, { filename: dto.name });
+        formData.append('partNumber', dto.partNumber.toString());
+        return this.httpClient
+            .put(`/v1/apps/${dto.appId}/build-sources/${dto.appBuildSourceId}/upload?action=mpu-uploadpart&uploadId=${dto.uploadId}`, formData, {
+            headers: {
+                Authorization: `Bearer ${authorizationService.getCurrentAuthorizationToken()}`,
+                ...formData.getHeaders(),
+            },
+        })
+            .then((response) => response.data);
+    }
+    async createUploadParts(dto, onProgress) {
+        const uploadedParts = [];
+        const partSize = 10 * 1024 * 1024; // 10 MB
+        const totalParts = Math.ceil(dto.buffer.byteLength / partSize);
+        let partNumber = 0;
+        const uploadNextPart = async () => {
+            if (partNumber >= totalParts) {
+                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);
+            const uploadedPart = await this.createUploadPart({
+                appBuildSourceId: dto.appBuildSourceId,
+                appId: dto.appId,
+                buffer: partBuffer,
+                name: dto.name,
+                partNumber,
+                uploadId: dto.uploadId,
+            });
+            uploadedParts.push(uploadedPart);
+            await uploadNextPart();
+        };
+        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.sort((a, b) => a.partNumber - b.partNumber);
+    }
+    async upload(dto, onProgress) {
+        // 1. Create a multipart upload
+        const { uploadId } = await this.createUpload({
+            appBuildSourceId: dto.appBuildSourceId,
+            appId: dto.appId,
+        });
+        // 2. Upload the file in parts
+        const parts = await this.createUploadParts({
+            appBuildSourceId: dto.appBuildSourceId,
+            appId: dto.appId,
+            buffer: dto.buffer,
+            name: dto.name,
+            uploadId,
+        }, onProgress);
+        // 3. Complete the upload
+        await this.completeUpload({
+            appBuildSourceId: dto.appBuildSourceId,
+            appId: dto.appId,
+            parts,
+            uploadId,
+        });
+    }
+}
+const appBuildSourcesService = new AppBuildSourcesServiceImpl(httpClient);
+export default appBuildSourcesService;

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: {

package/dist/types/app-build-source.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.js

@@ -1,4 +1,5 @@
 export * from './app-apple-api-key.js';
+export * from './app-build-source.js';
 export * from './app-bundle.js';
 export * from './app-certificate.js';
 export * from './app-channel.js';

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

@@ -1,12 +1,29 @@
 import AdmZip from 'adm-zip';
+import { globby } from 'globby';
+import path from 'path';
 class ZipImpl {
     async zipFolder(sourceFolder) {
         const zip = new AdmZip();
         zip.addLocalFolder(sourceFolder);
         return zip.toBuffer();
     }
-    isZipped(path) {
-        return path.endsWith('.zip');
+    async zipFolderWithGitignore(sourceFolder) {
+        const files = await globby(['**/*'], {
+            cwd: sourceFolder,
+            gitignore: true,
+            ignore: ['.git/**'],
+            dot: true,
+        });
+        const zip = new AdmZip();
+        for (const file of files) {
+            const filePath = path.join(sourceFolder, file);
+            const dirName = path.dirname(file);
+            zip.addLocalFile(filePath, dirName === '.' ? '' : dirName);
+        }
+        return zip.toBuffer();
+    }
+    isZipped(filePath) {
+        return filePath.endsWith('.zip');
     }
 }
 const zip = new ZipImpl();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/cli",
-  "version": "4.5.0",
+  "version": "4.6.0-dev.0108a83.1774286472",
   "description": "The Capawesome Cloud Command Line Interface (CLI) to manage Live Updates and more.",
   "type": "module",
   "scripts": {
@@ -61,6 +61,7 @@
     "c12": "3.3.3",
     "consola": "3.3.0",
     "form-data": "4.0.4",
+    "globby": "16.1.1",
     "http-proxy-agent": "7.0.2",
     "https-proxy-agent": "7.0.6",
     "mime": "4.0.7",