@capawesome/cli 3.4.2 → 3.5.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.
 
+## [3.5.0](https://github.com/capawesome-team/cli/compare/v3.4.2...v3.5.0) (2025-11-24)
+
+
+### Features
+
+* add `apps:builds:download` command ([#98](https://github.com/capawesome-team/cli/issues/98)) ([5f9ba10](https://github.com/capawesome-team/cli/commit/5f9ba1068afc835aacb2e6a356abbc90d7ebd70c))
+* add `apps:builds:logs` command ([#96](https://github.com/capawesome-team/cli/issues/96)) ([30ebd7e](https://github.com/capawesome-team/cli/commit/30ebd7e0159c53772f8ab80a9757e8ed957036ba))
+* add `apps:deployments:logs` command ([#97](https://github.com/capawesome-team/cli/issues/97)) ([9c91fd1](https://github.com/capawesome-team/cli/commit/9c91fd1ca6d3e6a31465e0671ced534f1f5fa138))
+
 ## [3.4.2](https://github.com/capawesome-team/cli/compare/v3.4.1...v3.4.2) (2025-11-22)
 
 ## [3.4.1](https://github.com/capawesome-team/cli/compare/v3.4.0...v3.4.1) (2025-11-20)

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

@@ -0,0 +1,240 @@
+import appBuildsService from '../../../services/app-builds.js';
+import appsService from '../../../services/apps.js';
+import authorizationService from '../../../services/authorization-service.js';
+import organizationsService from '../../../services/organizations.js';
+import { prompt } from '../../../utils/prompt.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import fs from 'fs/promises';
+import path from 'path';
+import { hasTTY } from 'std-env';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Download an app build.',
+    options: defineOptions(z.object({
+        appId: z
+            .uuid({
+            message: 'App ID must be a UUID.',
+        })
+            .optional()
+            .describe('App ID the build belongs to.'),
+        buildId: z
+            .uuid({
+            message: 'Build ID must be a UUID.',
+        })
+            .optional()
+            .describe('Build ID to download.'),
+        apk: z
+            .union([z.boolean(), z.string()])
+            .optional()
+            .describe('Download the APK artifact. Optionally provide a file path.'),
+        aab: z
+            .union([z.boolean(), z.string()])
+            .optional()
+            .describe('Download the AAB artifact. Optionally provide a file path.'),
+        ipa: z
+            .union([z.boolean(), z.string()])
+            .optional()
+            .describe('Download the IPA artifact. Optionally provide a file path.'),
+    })),
+    action: async (options) => {
+        let { appId, buildId } = options;
+        // Check if the user is logged in
+        if (!authorizationService.hasAuthorizationToken()) {
+            consola.error('You must be logged in to run this command.');
+            process.exit(1);
+        }
+        // Prompt for app ID if not provided
+        if (!appId) {
+            if (!hasTTY) {
+                consola.error('You must provide an app ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const organizations = await organizationsService.findAll();
+            if (organizations.length === 0) {
+                consola.error('You must create an organization before downloading a build.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const organizationId = await prompt('Select the organization of the app for which you want to download a build:', {
+                type: 'select',
+                options: organizations.map((organization) => ({ label: organization.name, value: organization.id })),
+            });
+            if (!organizationId) {
+                consola.error('You must select the organization of an app for which you want to download a build.');
+                process.exit(1);
+            }
+            const apps = await appsService.findAll({
+                organizationId,
+            });
+            if (apps.length === 0) {
+                consola.error('You must create an app before downloading a build.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            appId = await prompt('Select the app for which you want to download a build:', {
+                type: 'select',
+                options: apps.map((app) => ({ label: app.name, value: app.id })),
+            });
+            if (!appId) {
+                consola.error('You must select an app to download a build for.');
+                process.exit(1);
+            }
+        }
+        // Prompt for build ID if not provided
+        if (!buildId) {
+            if (!hasTTY) {
+                consola.error('You must provide a build ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const builds = await appBuildsService.findAll({ appId });
+            if (builds.length === 0) {
+                consola.error('No builds found for this app.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            buildId = await prompt('Select the build you want to download:', {
+                type: 'select',
+                options: builds.map((build) => ({
+                    label: `Build #${build.numberAsString || build.id} (${build.platform} - ${build.type})`,
+                    value: build.id,
+                })),
+            });
+            if (!buildId) {
+                consola.error('You must select a build to download.');
+                process.exit(1);
+            }
+        }
+        // Fetch the build details to get the job ID
+        const build = await appBuildsService.findOne({ appId, appBuildId: buildId, relations: 'appBuildArtifacts,job' });
+        if (build.job?.status !== 'succeeded') {
+            consola.error('The build has not succeeded yet. Cannot download artifacts for incomplete builds.');
+            process.exit(1);
+        }
+        // Validate platform-specific artifact flags
+        if (build.platform === 'android' && options.ipa) {
+            consola.error('Cannot download IPA artifact for an Android build.');
+            process.exit(1);
+        }
+        if (build.platform === 'ios' && (options.apk || options.aab)) {
+            consola.error('Cannot download APK or AAB artifacts for an iOS build.');
+            process.exit(1);
+        }
+        // Determine which artifacts to download
+        let downloadApk = options.apk;
+        let downloadAab = options.aab;
+        let downloadIpa = options.ipa;
+        // Prompt for artifact types if none were provided
+        if (!downloadApk && !downloadAab && !downloadIpa) {
+            if (!hasTTY) {
+                consola.error('You must specify at least one artifact type (--apk, --aab, or --ipa) when running in non-interactive environment.');
+                process.exit(1);
+            }
+            // Get available artifact types from the build
+            const availableArtifacts = build.appBuildArtifacts?.filter((artifact) => artifact.status === 'ready').map((artifact) => artifact.type) ||
+                [];
+            if (availableArtifacts.length === 0) {
+                consola.error('No artifacts available for download.');
+                process.exit(1);
+            }
+            // Create options based on available artifacts and platform
+            const artifactOptions = [];
+            if (build.platform === 'android') {
+                if (availableArtifacts.includes('apk')) {
+                    artifactOptions.push({ label: 'APK', value: 'apk' });
+                }
+                if (availableArtifacts.includes('aab')) {
+                    artifactOptions.push({ label: 'AAB', value: 'aab' });
+                }
+            }
+            else if (build.platform === 'ios') {
+                if (availableArtifacts.includes('ipa')) {
+                    artifactOptions.push({ label: 'IPA', value: 'ipa' });
+                }
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const selectedArtifacts = await prompt('Which artifact type(s) do you want to download:', {
+                type: 'multiselect',
+                options: artifactOptions,
+            });
+            if (!selectedArtifacts || selectedArtifacts.length === 0) {
+                consola.error('You must select at least one artifact type to download.');
+                process.exit(1);
+            }
+            // Set flags based on selection
+            downloadApk = selectedArtifacts.includes('apk');
+            downloadAab = selectedArtifacts.includes('aab');
+            downloadIpa = selectedArtifacts.includes('ipa');
+        }
+        // Download artifacts if flags are set
+        if (downloadApk) {
+            await handleArtifactDownload({
+                appId,
+                buildId: buildId,
+                buildArtifacts: build.appBuildArtifacts,
+                artifactType: 'apk',
+                filePath: typeof options.apk === 'string' ? options.apk : undefined,
+            });
+        }
+        if (downloadAab) {
+            await handleArtifactDownload({
+                appId,
+                buildId: buildId,
+                buildArtifacts: build.appBuildArtifacts,
+                artifactType: 'aab',
+                filePath: typeof options.aab === 'string' ? options.aab : undefined,
+            });
+        }
+        if (downloadIpa) {
+            await handleArtifactDownload({
+                appId,
+                buildId: buildId,
+                buildArtifacts: build.appBuildArtifacts,
+                artifactType: 'ipa',
+                filePath: typeof options.ipa === 'string' ? options.ipa : undefined,
+            });
+        }
+    },
+});
+/**
+ * Download a build artifact (APK, AAB, or IPA).
+ */
+const handleArtifactDownload = async (options) => {
+    const { appId, buildId, buildArtifacts, artifactType, filePath } = options;
+    try {
+        const artifactTypeUpper = artifactType.toUpperCase();
+        consola.start(`Downloading ${artifactTypeUpper}...`);
+        // Find the artifact
+        const artifact = buildArtifacts?.find((artifact) => artifact.type === artifactType);
+        if (!artifact) {
+            consola.warn(`No ${artifactTypeUpper} artifact found for this build.`);
+            return;
+        }
+        if (artifact.status !== 'ready') {
+            consola.warn(`${artifactTypeUpper} artifact is not ready (status: ${artifact.status}).`);
+            return;
+        }
+        // Download the artifact
+        const artifactData = await appBuildsService.downloadArtifact({
+            appId,
+            appBuildId: buildId,
+            artifactId: artifact.id,
+        });
+        // Determine the file path
+        let outputPath;
+        if (filePath) {
+            // Use provided path (can be relative or absolute)
+            outputPath = path.resolve(filePath);
+        }
+        else {
+            // Default to current working directory with build ID as filename
+            outputPath = path.resolve(`${buildId}.${artifactType}`);
+        }
+        // Save the file
+        await fs.writeFile(outputPath, Buffer.from(artifactData));
+        consola.success(`${artifactTypeUpper} downloaded successfully: ${outputPath}`);
+    }
+    catch (error) {
+        consola.error(`Failed to download ${artifactType.toUpperCase()}:`, error);
+    }
+};

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

@@ -0,0 +1,120 @@
+import appBuildsService from '../../../services/app-builds.js';
+import appsService from '../../../services/apps.js';
+import authorizationService from '../../../services/authorization-service.js';
+import organizationsService from '../../../services/organizations.js';
+import { unescapeAnsi } from '../../../utils/ansi.js';
+import { prompt } from '../../../utils/prompt.js';
+import { wait } from '../../../utils/wait.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import { hasTTY } from 'std-env';
+import { z } from 'zod';
+export default defineCommand({
+    description: 'Show logs of an app build.',
+    options: defineOptions(z.object({
+        appId: z
+            .uuid({
+            message: 'App ID must be a UUID.',
+        })
+            .optional()
+            .describe('App ID to display the build logs for.'),
+        buildId: z
+            .uuid({
+            message: 'Build ID must be a UUID.',
+        })
+            .optional()
+            .describe('Build ID to display the build logs for.'),
+    })),
+    action: async (options) => {
+        let { appId, buildId } = options;
+        // Check if the user is logged in
+        if (!authorizationService.hasAuthorizationToken()) {
+            consola.error('You must be logged in to run this command.');
+            process.exit(1);
+        }
+        // Prompt for app ID if not provided
+        if (!appId) {
+            if (!hasTTY) {
+                consola.error('You must provide an app ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const organizations = await organizationsService.findAll();
+            if (organizations.length === 0) {
+                consola.error('You must create an organization before viewing build logs.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const organizationId = await prompt('Select the organization of the app for which you want to view the build logs.', {
+                type: 'select',
+                options: organizations.map((organization) => ({ label: organization.name, value: organization.id })),
+            });
+            if (!organizationId) {
+                consola.error('You must select the organization of an app for which you want to view the build logs.');
+                process.exit(1);
+            }
+            const apps = await appsService.findAll({
+                organizationId,
+            });
+            if (apps.length === 0) {
+                consola.error('You must create an app before viewing build logs.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            appId = await prompt('Which app do you want to view the build logs for:', {
+                type: 'select',
+                options: apps.map((app) => ({ label: app.name, value: app.id })),
+            });
+            if (!appId) {
+                consola.error('You must select an app to view the build logs.');
+                process.exit(1);
+            }
+        }
+        // Prompt for platform if not provided
+        if (!buildId) {
+            if (!hasTTY) {
+                consola.error('You must provide a platform when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const appBuilds = await appBuildsService.findAll({ appId });
+            if (appBuilds.length === 0) {
+                consola.error('You must create a build before viewing the logs.');
+                process.exit(1);
+            }
+            buildId = await prompt('Select the build of the app for which you want to view the logs.', {
+                type: 'select',
+                options: appBuilds.map((build) => ({
+                    label: `Build #${build.numberAsString} (${build.platform} - ${build.type})`,
+                    value: build.id,
+                })),
+            });
+            if (!buildId) {
+                consola.error('You must select the build of an app for which you want to view the logs.');
+                process.exit(1);
+            }
+        }
+        let appBuildDto = await appBuildsService.findOne({ appId, appBuildId: buildId, relations: 'job,job.jobLogs' });
+        let isFinished = !!appBuildDto.job?.finishedAt;
+        let lastLogNumber = 0;
+        if (isFinished) {
+            const logs = appBuildDto.job?.jobLogs || [];
+            for (const logEntry of logs) {
+                console.log(unescapeAnsi(logEntry.payload));
+            }
+        }
+        else {
+            while (!isFinished) {
+                appBuildDto = await appBuildsService.findOne({ appId, appBuildId: buildId, relations: 'job,job.jobLogs' });
+                isFinished = !!appBuildDto.job?.finishedAt;
+                const logs = appBuildDto.job?.jobLogs || [];
+                const newLogs = logs.filter((log) => log.number > lastLogNumber);
+                for (const logEntry of newLogs) {
+                    console.log(unescapeAnsi(logEntry.payload));
+                    lastLogNumber = logEntry.number;
+                }
+                if (!isFinished) {
+                    await wait(3000);
+                }
+            }
+        }
+    },
+});

package/dist/commands/apps/deployments/logs.js

@@ -0,0 +1,129 @@
+import appsService from '../../../services/apps.js';
+import authorizationService from '../../../services/authorization-service.js';
+import organizationsService from '../../../services/organizations.js';
+import { unescapeAnsi } from '../../../utils/ansi.js';
+import { prompt } from '../../../utils/prompt.js';
+import { wait } from '../../../utils/wait.js';
+import { defineCommand, defineOptions } from '@robingenz/zli';
+import consola from 'consola';
+import { hasTTY } from 'std-env';
+import { z } from 'zod';
+import appDeploymentsService from '../../../services/app-deployments.js';
+export default defineCommand({
+    description: 'View the deployment logs of an app.',
+    options: defineOptions(z.object({
+        appId: z
+            .uuid({
+            message: 'App ID must be a UUID.',
+        })
+            .optional()
+            .describe('App ID to view the deployment logs for.'),
+        deploymentId: z
+            .uuid({
+            message: 'Deployment ID must be a UUID.',
+        })
+            .optional()
+            .describe('Deployment ID to view logs.'),
+    })),
+    action: async (options) => {
+        let { appId, deploymentId } = options;
+        // Check if the user is logged in
+        if (!authorizationService.hasAuthorizationToken()) {
+            consola.error('You must be logged in to run this command.');
+            process.exit(1);
+        }
+        // Prompt for app ID if not provided
+        if (!appId) {
+            if (!hasTTY) {
+                consola.error('You must provide an app ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const organizations = await organizationsService.findAll();
+            if (organizations.length === 0) {
+                consola.error('You must create an organization before viewing deployment logs.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            const organizationId = await prompt('Select the organization that contains the app whose deployment logs you want to view?', {
+                type: 'select',
+                options: organizations.map((organization) => ({ label: organization.name, value: organization.id })),
+            });
+            if (!organizationId) {
+                consola.error('You must select the organization containing the app whose deployment logs you want to view.');
+                process.exit(1);
+            }
+            const apps = await appsService.findAll({
+                organizationId,
+            });
+            if (apps.length === 0) {
+                consola.error('You must create an app before viewing deployment logs.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            appId = await prompt('Which app do you want to view deployment logs for?', {
+                type: 'select',
+                options: apps.map((app) => ({ label: app.name, value: app.id })),
+            });
+            if (!appId) {
+                consola.error('You must select an app to view its deployment logs.');
+                process.exit(1);
+            }
+        }
+        // Prompt for deployment ID if not provided
+        if (!deploymentId) {
+            if (!hasTTY) {
+                consola.error('You must provide a deployment ID when running in non-interactive environment.');
+                process.exit(1);
+            }
+            const appDeployments = await appDeploymentsService.findAll({ appId });
+            if (appDeployments.length === 0) {
+                consola.error('There are no deployments for this app.');
+                process.exit(1);
+            }
+            // @ts-ignore wait till https://github.com/unjs/consola/pull/280 is merged
+            deploymentId = await prompt('Which deployment do you want to view the logs for?', {
+                type: 'select',
+                options: appDeployments.map((deployment) => ({
+                    label: `Deployment ${deployment.id}`,
+                    value: deployment.id,
+                })),
+            });
+            if (!deploymentId) {
+                consola.error('You must select a deployment to view the logs.');
+                process.exit(1);
+            }
+        }
+        let appDeploymentDto = await appDeploymentsService.findOne({
+            appId,
+            appDeploymentId: deploymentId,
+            relations: 'job,job.jobLogs',
+        });
+        let isFinished = !!appDeploymentDto.job?.finishedAt;
+        let lastLogNumber = 0;
+        if (isFinished) {
+            const logs = appDeploymentDto.job?.jobLogs || [];
+            for (const logEntry of logs) {
+                console.log(unescapeAnsi(logEntry.payload));
+            }
+        }
+        else {
+            while (!isFinished) {
+                appDeploymentDto = await appDeploymentsService.findOne({
+                    appId,
+                    appDeploymentId: deploymentId,
+                    relations: 'job,job.jobLogs',
+                });
+                isFinished = !!appDeploymentDto.job?.finishedAt;
+                const logs = appDeploymentDto.job?.jobLogs || [];
+                const newLogs = logs.filter((log) => log.number > lastLogNumber);
+                for (const logEntry of newLogs) {
+                    console.log(unescapeAnsi(logEntry.payload));
+                    lastLogNumber = logEntry.number;
+                }
+                if (!isFinished) {
+                    await wait(3000);
+                }
+            }
+        }
+    },
+});

package/dist/index.js

@@ -25,6 +25,8 @@ const config = defineConfig({
         'apps:delete': await import('./commands/apps/delete.js').then((mod) => mod.default),
         'apps:builds:cancel': await import('./commands/apps/builds/cancel.js').then((mod) => mod.default),
         'apps:builds:create': await import('./commands/apps/builds/create.js').then((mod) => mod.default),
+        'apps:builds:logs': await import('./commands/apps/builds/logs.js').then((mod) => mod.default),
+        'apps:builds:download': await import('./commands/apps/builds/download.js').then((mod) => mod.default),
         'apps:bundles:create': await import('./commands/apps/bundles/create.js').then((mod) => mod.default),
         'apps:bundles:delete': await import('./commands/apps/bundles/delete.js').then((mod) => mod.default),
         'apps:bundles:update': await import('./commands/apps/bundles/update.js').then((mod) => mod.default),
@@ -35,6 +37,7 @@ const config = defineConfig({
         'apps:channels:update': await import('./commands/apps/channels/update.js').then((mod) => mod.default),
         'apps:deployments:create': await import('./commands/apps/deployments/create.js').then((mod) => mod.default),
         '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),
         'manifests:generate': await import('./commands/manifests/generate.js').then((mod) => mod.default),
         'organizations:create': await import('./commands/organizations/create.js').then((mod) => mod.default),

package/package.json

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