@capawesome/cli 4.7.0 → 4.8.0-dev.efa0850.1775645973

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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.8.0](https://github.com/capawesome-team/cli/compare/v4.7.0...v4.8.0) (2026-04-08)
+
+
+### Features
+
+* **apps:** add `--json` option to `apps:create` ([#147](https://github.com/capawesome-team/cli/issues/147)) ([3573d60](https://github.com/capawesome-team/cli/commit/3573d6021574111e12a6758d212b41002a357ae8))
+* **apps:** add `--link` option to `apps:create` ([#145](https://github.com/capawesome-team/cli/issues/145)) ([c9e38b8](https://github.com/capawesome-team/cli/commit/c9e38b8e3e360bc856cbff4bf66b68fadedd3b04))
+* **apps:** add prompt to connect git repository after app creation ([#143](https://github.com/capawesome-team/cli/issues/143)) ([3427e6d](https://github.com/capawesome-team/cli/commit/3427e6da277fa61902dac5b9045c433535188142))
+* **apps:** print app URL after `apps:create` ([#146](https://github.com/capawesome-team/cli/issues/146)) ([ed7e04a](https://github.com/capawesome-team/cli/commit/ed7e04a5b379187d8c69856d180256f246931571))
+* **error:** add `UserError` class to skip user errors in Sentry ([#144](https://github.com/capawesome-team/cli/issues/144)) ([f7728d0](https://github.com/capawesome-team/cli/commit/f7728d0849cf4883c761de5bfd673eb5c3c37409))
+
 ## [4.7.0](https://github.com/capawesome-team/cli/compare/v4.6.0...v4.7.0) (2026-04-04)
 
 

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

@@ -5,7 +5,9 @@ import appCertificatesService from '../../../services/app-certificates.js';
 import appEnvironmentsService from '../../../services/app-environments.js';
 import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
+import { createBufferFromPath } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
+import { fileExistsAtPath, isDirectory } from '../../../utils/file.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import zip from '../../../utils/zip.js';
@@ -47,7 +49,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.'),
+        path: z.string().optional().describe('Path to local source files to upload. Must be a folder or a zip file.'),
         platform: z
             .enum(['ios', 'android', 'web'], {
             message: 'Platform must be either `ios`, `android`, or `web`.',
@@ -117,15 +119,22 @@ export default defineCommand({
         if (sourcePath) {
             consola.warn('The --path option is experimental and may change in the future.');
             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.');
+            const exists = await fileExistsAtPath(resolvedPath);
+            if (!exists) {
+                consola.error('The --path does not exist.');
                 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.');
+            const pathIsDirectory = await isDirectory(resolvedPath);
+            if (pathIsDirectory) {
+                const packageJsonPath = path.join(resolvedPath, 'package.json');
+                const packageJsonExists = await fileExistsAtPath(packageJsonPath);
+                if (!packageJsonExists) {
+                    consola.error('The directory specified by --path must contain a package.json file.');
+                    process.exit(1);
+                }
+            }
+            else if (!zip.isZipped(resolvedPath)) {
+                consola.error('The --path must be a folder or a zip file.');
                 process.exit(1);
             }
         }
@@ -265,8 +274,14 @@ export default defineCommand({
         // Upload source files if path is provided
         if (sourcePath) {
             const resolvedPath = path.resolve(sourcePath);
-            consola.start('Zipping source files...');
-            const buffer = await zip.zipFolderWithGitignore(resolvedPath);
+            let buffer;
+            if (zip.isZipped(resolvedPath)) {
+                buffer = await createBufferFromPath(resolvedPath);
+            }
+            else {
+                consola.start('Zipping source files...');
+                buffer = await zip.zipFolderWithGitignore(resolvedPath);
+            }
             consola.start('Uploading source files...');
             const appBuildSource = await appBuildSourcesService.createFromFile({
                 appId,

package/dist/commands/apps/create.js

@@ -1,3 +1,4 @@
+import { DEFAULT_CONSOLE_BASE_URL } from '../../config/consts.js';
 import appsService from '../../services/apps.js';
 import { withAuth } from '../../utils/auth.js';
 import { isInteractive } from '../../utils/environment.js';
@@ -8,11 +9,14 @@ import { z } from 'zod';
 export default defineCommand({
     description: 'Create a new app.',
     options: defineOptions(z.object({
+        json: z.boolean().optional().describe('Output in JSON format.'),
+        link: z.boolean().optional().describe('Connect the created app to the local git repository.'),
         name: z.string().optional().describe('Name of the app.'),
         organizationId: z.string().optional().describe('ID of the organization to create the app in.'),
-    })),
+        yes: z.boolean().optional().describe('Skip all confirmation prompts.'),
+    }), { y: 'yes' }),
     action: withAuth(async (options, args) => {
-        let { name, organizationId } = options;
+        let { json, name, organizationId } = options;
         if (!organizationId) {
             if (!isInteractive()) {
                 consola.error('You must provide the organization ID when running in non-interactive environment.');
@@ -28,7 +32,22 @@ export default defineCommand({
             name = await prompt('Enter the name of the app:', { type: 'text' });
         }
         const response = await appsService.create({ name, organizationId });
-        consola.info(`App ID: ${response.id}`);
-        consola.success('App created successfully.');
+        if (!json) {
+            consola.info(`App ID: ${response.id}`);
+            consola.info(`App URL: ${DEFAULT_CONSOLE_BASE_URL}/apps/${response.id}`);
+            consola.success('App created successfully.');
+        }
+        let shouldLink = options.link ?? false;
+        if (!shouldLink && !options.yes && !json && isInteractive()) {
+            shouldLink = await prompt('Do you want to connect a git repository?', {
+                type: 'confirm',
+            });
+        }
+        if (shouldLink) {
+            await (await import('../../commands/apps/link.js').then((mod) => mod.default)).action({ appId: response.id }, undefined);
+        }
+        if (json) {
+            console.log(JSON.stringify({ id: response.id }, null, 2));
+        }
     }),
 });

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import configService from './services/config.js';
 import updateService from './services/update.js';
-import { getMessageFromUnknownError } from './utils/error.js';
+import { getMessageFromUnknownError, UserError } from './utils/error.js';
 import { defineConfig, processConfig, ZliError } from '@robingenz/zli';
 import * as Sentry from '@sentry/node';
 import { AxiosError } from 'axios';
@@ -76,6 +76,14 @@ const config = defineConfig({
     },
 });
 const captureException = async (error) => {
+    // Ignore failed HTTP requests
+    if (error instanceof AxiosError) {
+        return;
+    }
+    // Ignore expected user errors
+    if (error instanceof UserError) {
+        return;
+    }
     // Ignore errors from the CLI itself (e.g. "No command found.")
     if (error instanceof ZliError) {
         return;
@@ -84,10 +92,6 @@ const captureException = async (error) => {
     if (error instanceof ZodError) {
         return;
     }
-    // Ignore failed HTTP requests
-    if (error instanceof AxiosError) {
-        return;
-    }
     const environment = await configService.getValueForKey('ENVIRONMENT');
     if (environment !== 'production') {
         return;

package/dist/utils/error.js

@@ -1,5 +1,11 @@
 import { AxiosError } from 'axios';
 import { ZodError } from 'zod';
+export class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UserError';
+    }
+}
 export const getMessageFromUnknownError = (error) => {
     let message = 'An unknown error has occurred.';
     if (error instanceof AxiosError) {

package/dist/utils/git.js

@@ -1,4 +1,5 @@
 import { execSync } from 'child_process';
+import { UserError } from '../utils/error.js';
 const HOSTNAME_TO_PROVIDER = {
     'github.com': 'github',
     'gitlab.com': 'gitlab',
@@ -15,7 +16,7 @@ const getGitRemoteUrl = () => {
         return execSync('git remote get-url origin', { encoding: 'utf-8' }).trim();
     }
     catch {
-        throw new Error('Could not read the git remote URL. Make sure you are inside a git repository with an origin remote.');
+        throw new UserError('Could not read the git remote URL. Make sure you are inside a git repository with an origin remote.');
     }
 };
 export const parseGitRemoteUrl = (remoteUrl) => {
@@ -55,7 +56,7 @@ export const parseGitRemoteUrl = (remoteUrl) => {
         const hostname = sshMatch[1];
         const provider = HOSTNAME_TO_PROVIDER[hostname];
         if (!provider) {
-            throw new Error(`Unsupported git provider for hostname "${hostname}".`);
+            throw new UserError(`Unsupported git provider for hostname "${hostname}".`);
         }
         return {
             ownerSlug: sshMatch[2],
@@ -71,7 +72,7 @@ export const parseGitRemoteUrl = (remoteUrl) => {
             const hostname = url.hostname;
             const provider = HOSTNAME_TO_PROVIDER[hostname];
             if (!provider) {
-                throw new Error(`Unsupported git provider for hostname "${hostname}".`);
+                throw new UserError(`Unsupported git provider for hostname "${hostname}".`);
             }
             const pathSegments = url.pathname.split('/').filter(Boolean);
             const repositorySlug = pathSegments.pop()?.replace(/\.git$/, '');
@@ -83,9 +84,9 @@ export const parseGitRemoteUrl = (remoteUrl) => {
         }
     }
     catch (error) {
-        if (error instanceof Error && error.message.startsWith('Unsupported git provider')) {
+        if (error instanceof UserError) {
             throw error;
         }
     }
-    throw new Error('Could not parse git remote URL.');
+    throw new UserError('Could not parse git remote URL.');
 };

package/package.json

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