@capawesome/cli 4.9.2 → 4.9.3-dev.47af0d1.1779135155

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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.9.3](https://github.com/capawesome-team/cli/compare/v4.9.2...v4.9.3) (2026-05-14)
+
+
+### Bug Fixes
+
+* **apps:builds:create:** exclude native build artifact directories when zipping source ([#159](https://github.com/capawesome-team/cli/issues/159)) ([4c2a704](https://github.com/capawesome-team/cli/commit/4c2a7048d59d9e966f48d7c05af2e0f2d8d75379))
+* check file read access to surface permission errors ([#158](https://github.com/capawesome-team/cli/issues/158)) ([242189a](https://github.com/capawesome-team/cli/commit/242189a21f19ecbab72a34d8ce13f23824f1a4bf))
+
 ## [4.9.2](https://github.com/capawesome-team/cli/compare/v4.9.1...v4.9.2) (2026-05-13)
 
 ## [4.9.1](https://github.com/capawesome-team/cli/compare/v4.9.0...v4.9.1) (2026-05-07)

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

@@ -5,8 +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 } from '../../../utils/file.js';
+import { isDirectory, isReadable } from '../../../utils/file.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import zip from '../../../utils/zip.js';
@@ -48,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`.',
@@ -118,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 pathReadable = await isReadable(resolvedPath);
+            if (!pathReadable) {
+                consola.error(`The path does not exist or is not accessible: ${resolvedPath}`);
                 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 packageJsonReadable = await isReadable(packageJsonPath);
+                if (!packageJsonReadable) {
+                    consola.error(`The path must contain a package.json file: ${packageJsonPath}`);
+                    process.exit(1);
+                }
+            }
+            else if (!zip.isZipped(resolvedPath)) {
+                consola.error(`The path must be a folder or a zip file: ${resolvedPath}`);
                 process.exit(1);
             }
         }
@@ -246,9 +254,9 @@ export default defineCommand({
         // Parse ad hoc environment variables from inline and file
         const variablesMap = new Map();
         if (options.variableFile) {
-            const fileExists = await fileExistsAtPath(options.variableFile);
-            if (!fileExists) {
-                consola.error(`The variable file was not found or is not accessible: ${options.variableFile}`);
+            const variableFileReadable = await isReadable(options.variableFile);
+            if (!variableFileReadable) {
+                consola.error(`The variable file does not exist or is not accessible: ${options.variableFile}`);
                 process.exit(1);
             }
             const fileContent = await fs.readFile(options.variableFile, 'utf-8');
@@ -271,8 +279,15 @@ 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);
+            const sourcePathIsDirectory = await isDirectory(resolvedPath);
+            let buffer;
+            if (sourcePathIsDirectory) {
+                consola.start('Zipping source files...');
+                buffer = await zip.zipFolderWithGitignore(resolvedPath);
+            }
+            else {
+                buffer = await createBufferFromPath(resolvedPath);
+            }
             consola.start('Uploading source files...');
             const appBuildSource = await appBuildSourcesService.createFromFile({
                 appId,

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

@@ -2,7 +2,7 @@ import appCertificatesService from '../../../services/app-certificates.js';
 import appProvisioningProfilesService from '../../../services/app-provisioning-profiles.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
 import consola from 'consola';
@@ -131,9 +131,9 @@ export default defineCommand({
                 provisioningProfile = [profilePath];
             }
         }
-        const fileExists = await fileExistsAtPath(file);
-        if (!fileExists) {
-            consola.error(`The certificate file was not found or is not accessible: ${file}`);
+        const fileReadable = await isReadable(file);
+        if (!fileReadable) {
+            consola.error(`The certificate file does not exist or is not accessible: ${file}`);
             process.exit(1);
         }
         const buffer = fs.readFileSync(file);
@@ -142,9 +142,9 @@ export default defineCommand({
         const provisioningProfileIds = [];
         if (provisioningProfile && provisioningProfile.length > 0) {
             for (const profilePath of provisioningProfile) {
-                const profileExists = await fileExistsAtPath(profilePath);
-                if (!profileExists) {
-                    consola.error(`The provisioning profile file was not found or is not accessible: ${profilePath}`);
+                const profileReadable = await isReadable(profilePath);
+                if (!profileReadable) {
+                    consola.error(`The provisioning profile file does not exist or is not accessible: ${profilePath}`);
                     process.exit(1);
                 }
                 const profileBuffer = fs.readFileSync(profilePath);

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

@@ -3,7 +3,7 @@ import appDestinationsService from '../../../services/app-destinations.js';
 import appGoogleServiceAccountKeysService from '../../../services/app-google-service-account-keys.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
 import consola from 'consola';
@@ -154,9 +154,9 @@ export default defineCommand({
                 }
             }
             // Upload Google service account key file
-            const googleServiceAccountKeyFileExists = await fileExistsAtPath(googleServiceAccountKeyFile);
-            if (!googleServiceAccountKeyFileExists) {
-                consola.error(`The Google service account key file was not found or is not accessible: ${googleServiceAccountKeyFile}`);
+            const googleServiceAccountKeyFileReadable = await isReadable(googleServiceAccountKeyFile);
+            if (!googleServiceAccountKeyFileReadable) {
+                consola.error(`The Google service account key file does not exist or is not accessible: ${googleServiceAccountKeyFile}`);
                 process.exit(1);
             }
             const buffer = fs.readFileSync(googleServiceAccountKeyFile);
@@ -211,9 +211,9 @@ export default defineCommand({
                     }
                 }
                 // Upload Apple API key file
-                const appleApiKeyFileExists = await fileExistsAtPath(appleApiKeyFile);
-                if (!appleApiKeyFileExists) {
-                    consola.error(`The Apple API key file was not found or is not accessible: ${appleApiKeyFile}`);
+                const appleApiKeyFileReadable = await isReadable(appleApiKeyFile);
+                if (!appleApiKeyFileReadable) {
+                    consola.error(`The Apple API key file does not exist or is not accessible: ${appleApiKeyFile}`);
                     process.exit(1);
                 }
                 const buffer = fs.readFileSync(appleApiKeyFile);

package/dist/commands/apps/environments/set.js

@@ -2,7 +2,7 @@ import appEnvironmentsService from '../../../services/app-environments.js';
 import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
 import consola from 'consola';
@@ -53,9 +53,9 @@ export default defineCommand({
         // Parse variables from inline and file
         const variablesMap = new Map();
         if (variableFile) {
-            const fileExists = await fileExistsAtPath(variableFile);
-            if (!fileExists) {
-                consola.error(`The variable file was not found or is not accessible: ${variableFile}`);
+            const variableFileReadable = await isReadable(variableFile);
+            if (!variableFileReadable) {
+                consola.error(`The variable file does not exist or is not accessible: ${variableFile}`);
                 process.exit(1);
             }
             const fileContent = await fs.promises.readFile(variableFile, 'utf-8');
@@ -70,9 +70,9 @@ export default defineCommand({
         // Parse secrets from inline and file
         const secretsMap = new Map();
         if (secretFile) {
-            const fileExists = await fileExistsAtPath(secretFile);
-            if (!fileExists) {
-                consola.error(`The secret file was not found or is not accessible: ${secretFile}`);
+            const secretFileReadable = await isReadable(secretFile);
+            if (!secretFileReadable) {
+                consola.error(`The secret file does not exist or is not accessible: ${secretFile}`);
                 process.exit(1);
             }
             const fileContent = await fs.promises.readFile(secretFile, 'utf-8');

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

@@ -1,5 +1,5 @@
 import { isInteractive } from '../../../utils/environment.js';
-import { directoryContainsSourceMaps, directoryContainsSymlinks, fileExistsAtPath, isDirectory } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, directoryContainsSymlinks, isDirectory, isReadable, pathExists, } from '../../../utils/file.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { prompt } from '../../../utils/prompt.js';
 import zip from '../../../utils/zip.js';
@@ -44,9 +44,9 @@ export default defineCommand({
         // Convert to absolute path
         inputPath = pathModule.resolve(inputPath);
         // Validate input path exists
-        const inputExists = await fileExistsAtPath(inputPath);
-        if (!inputExists) {
-            consola.error(`Input path does not exist: ${inputPath}`);
+        const inputPathReadable = await isReadable(inputPath);
+        if (!inputPathReadable) {
+            consola.error(`The input path does not exist or is not accessible: ${inputPath}`);
             process.exit(1);
         }
         // Validate input is a directory
@@ -57,9 +57,9 @@ export default defineCommand({
         }
         // Validate directory contains index.html
         const indexHtmlPath = pathModule.join(inputPath, 'index.html');
-        const hasIndexHtml = await fileExistsAtPath(indexHtmlPath);
-        if (!hasIndexHtml) {
-            consola.error(`Directory must contain an index.html file: ${inputPath}`);
+        const indexHtmlReadable = await isReadable(indexHtmlPath);
+        if (!indexHtmlReadable) {
+            consola.error(`The index.html file does not exist or is not accessible: ${indexHtmlPath}`);
             process.exit(1);
         }
         // Check for symlinks
@@ -78,8 +78,8 @@ export default defineCommand({
         }
         outputPath = pathModule.resolve(outputPath);
         // 3. Check if output exists and handle overwrite
-        const outputExists = await fileExistsAtPath(outputPath);
-        if (outputExists) {
+        const outputPathExists = await pathExists(outputPath);
+        if (outputPathExists) {
             if (!overwrite) {
                 if (!isInteractive()) {
                     consola.error(`Output file already exists: ${outputPath}. Use --overwrite flag to skip confirmation or run in interactive mode.`);
@@ -97,9 +97,9 @@ export default defineCommand({
         }
         // Validate parent directory exists
         const outputDir = pathModule.dirname(outputPath);
-        const outputDirExists = await fileExistsAtPath(outputDir);
+        const outputDirExists = await pathExists(outputDir);
         if (!outputDirExists) {
-            consola.error(`Output directory does not exist: ${outputDir}`);
+            consola.error(`The output directory does not exist: ${outputDir}`);
             process.exit(1);
         }
         // 4. Generate bundle

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

@@ -8,7 +8,7 @@ import { parseKeyValuePairs } from '../../../utils/app-environments.js';
 import { withAuth } from '../../../utils/auth.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import { waitForJobCompletion } from '../../../utils/job.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
 import zip from '../../../utils/zip.js';
@@ -188,9 +188,9 @@ export default defineCommand({
         // Parse ad hoc environment variables from inline and file
         const variablesMap = new Map();
         if (options.variableFile) {
-            const fileExists = await fileExistsAtPath(options.variableFile);
-            if (!fileExists) {
-                consola.error(`The variable file was not found or is not accessible: ${options.variableFile}`);
+            const variableFileReadable = await isReadable(options.variableFile);
+            if (!variableFileReadable) {
+                consola.error(`The variable file does not exist or is not accessible: ${options.variableFile}`);
                 process.exit(1);
             }
             const fileContent = await fs.readFile(options.variableFile, 'utf-8');

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

@@ -1,5 +1,5 @@
 import { isInteractive } from '../../../utils/environment.js';
-import { directoryContainsSourceMaps, directoryContainsSymlinks, fileExistsAtPath, isDirectory } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, directoryContainsSymlinks, isReadable, isDirectory } from '../../../utils/file.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { prompt } from '../../../utils/prompt.js';
 import { defineCommand, defineOptions } from '@robingenz/zli';
@@ -27,9 +27,9 @@ export default defineCommand({
             }
         }
         // Check if the path exists
-        const pathExists = await fileExistsAtPath(path);
-        if (!pathExists) {
-            consola.error(`The path does not exist.`);
+        const pathReadable = await isReadable(path);
+        if (!pathReadable) {
+            consola.error(`The path does not exist or is not accessible: ${path}`);
             process.exit(1);
         }
         // Check if the path is a directory

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

@@ -1,4 +1,4 @@
-import { directoryContainsSymlinks, fileExistsAtPath, isDirectory } from '../../../utils/file.js';
+import { directoryContainsSymlinks, isReadable, isDirectory } from '../../../utils/file.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { prompt } from '../../../utils/prompt.js';
 import consola from 'consola';
@@ -13,7 +13,7 @@ vi.mock('@/utils/environment.js', () => ({
     isInteractive: () => true,
 }));
 describe('apps-liveupdates-generatemanifest', () => {
-    const mockFileExistsAtPath = vi.mocked(fileExistsAtPath);
+    const mockIsReadable = vi.mocked(isReadable);
     const mockIsDirectory = vi.mocked(isDirectory);
     const mockDirectoryContainsSymlinks = vi.mocked(directoryContainsSymlinks);
     const mockGenerateManifestJson = vi.mocked(generateManifestJson);
@@ -30,25 +30,25 @@ describe('apps-liveupdates-generatemanifest', () => {
     });
     it('should generate manifest with provided path', async () => {
         const options = { path: './dist' };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockGenerateManifestJson.mockResolvedValue(undefined);
         await generateManifestCommand.action(options, undefined);
-        expect(mockFileExistsAtPath).toHaveBeenCalledWith('./dist');
+        expect(mockIsReadable).toHaveBeenCalledWith('./dist');
         expect(mockGenerateManifestJson).toHaveBeenCalledWith('./dist');
         expect(mockConsola.success).toHaveBeenCalledWith('Manifest file generated.');
     });
     it('should prompt for path when not provided', async () => {
         const options = {};
         mockPrompt.mockResolvedValueOnce('./www');
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockGenerateManifestJson.mockResolvedValue(undefined);
         await generateManifestCommand.action(options, undefined);
         expect(mockPrompt).toHaveBeenCalledWith('Enter the path to the web assets folder (e.g., `dist` or `www`):', {
             type: 'text',
         });
-        expect(mockFileExistsAtPath).toHaveBeenCalledWith('./www');
+        expect(mockIsReadable).toHaveBeenCalledWith('./www');
         expect(mockGenerateManifestJson).toHaveBeenCalledWith('./www');
         expect(mockConsola.success).toHaveBeenCalledWith('Manifest file generated.');
     });
@@ -60,20 +60,20 @@ describe('apps-liveupdates-generatemanifest', () => {
     });
     it('should handle nonexistent path', async () => {
         const options = { path: './nonexistent' };
-        mockFileExistsAtPath.mockResolvedValue(false);
+        mockIsReadable.mockResolvedValue(false);
         await expect(generateManifestCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
-        expect(mockConsola.error).toHaveBeenCalledWith('The path does not exist.');
+        expect(mockConsola.error).toHaveBeenCalledWith('The path does not exist or is not accessible: ./nonexistent');
     });
     it('should handle non-directory path', async () => {
         const options = { path: './file.txt' };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(false);
         await expect(generateManifestCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
         expect(mockConsola.error).toHaveBeenCalledWith('The path is not a directory.');
     });
     it('should warn when symlinks are detected', async () => {
         const options = { path: './dist' };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockDirectoryContainsSymlinks.mockResolvedValue(true);
         mockGenerateManifestJson.mockResolvedValue(undefined);

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

@@ -5,7 +5,7 @@ import { withAuth } from '../../../utils/auth.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { createBufferFromPath, createBufferFromString, isPrivateKeyContent } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import { createHash } from '../../../utils/hash.js';
 import { formatPrivateKey } from '../../../utils/private-key.js';
 import { prompt, promptAppSelection, promptOrganizationSelection } from '../../../utils/prompt.js';
@@ -158,9 +158,9 @@ export default defineCommand({
                 process.exit(1);
             }
             // Check if the path exists
-            const pathExists = await fileExistsAtPath(path);
-            if (!pathExists) {
-                consola.error(`The path does not exist.`);
+            const pathReadable = await isReadable(path);
+            if (!pathReadable) {
+                consola.error(`The path does not exist or is not accessible: ${path}`);
                 process.exit(1);
             }
             // Create the file buffer
@@ -177,15 +177,15 @@ export default defineCommand({
                 }
                 else if (privateKey.endsWith('.pem')) {
                     // Handle file path
-                    const fileExists = await fileExistsAtPath(privateKey);
-                    if (fileExists) {
+                    const privateKeyReadable = await isReadable(privateKey);
+                    if (privateKeyReadable) {
                         const keyBuffer = await createBufferFromPath(privateKey);
                         const keyContent = keyBuffer.toString('utf8');
                         const formattedPrivateKey = formatPrivateKey(keyContent);
                         privateKeyBuffer = createBufferFromString(formattedPrivateKey);
                     }
                     else {
-                        consola.error('Private key file not found.');
+                        consola.error(`The private key file does not exist or is not accessible: ${privateKey}`);
                         process.exit(1);
                     }
                 }

package/dist/commands/apps/liveupdates/register.test.js

@@ -1,6 +1,6 @@
 import { DEFAULT_API_BASE_URL } from '../../../config/consts.js';
 import authorizationService from '../../../services/authorization-service.js';
-import { fileExistsAtPath } from '../../../utils/file.js';
+import { isReadable } from '../../../utils/file.js';
 import userConfig from '../../../utils/user-config.js';
 import consola from 'consola';
 import nock from 'nock';
@@ -20,7 +20,7 @@ vi.mock('consola');
 describe('apps-liveupdates-register', () => {
     const mockUserConfig = vi.mocked(userConfig);
     const mockAuthorizationService = vi.mocked(authorizationService);
-    const mockFileExistsAtPath = vi.mocked(fileExistsAtPath);
+    const mockIsReadable = vi.mocked(isReadable);
     const mockConsola = vi.mocked(consola);
     beforeEach(() => {
         vi.clearAllMocks();
@@ -121,7 +121,7 @@ describe('apps-liveupdates-register', () => {
             rolloutPercentage: 1,
             yes: true,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         // Mock utility functions
         const mockZip = await import('../../../utils/zip.js');
         const mockBuffer = await import('../../../utils/buffer.js');
@@ -167,7 +167,7 @@ describe('apps-liveupdates-register', () => {
             rolloutPercentage: 1,
             yes: true,
         };
-        mockFileExistsAtPath.mockImplementation((path) => {
+        mockIsReadable.mockImplementation((path) => {
             if (path === privateKeyPath)
                 return Promise.resolve(true);
             if (path === bundlePath)
@@ -226,7 +226,7 @@ describe('apps-liveupdates-register', () => {
             rolloutPercentage: 1,
             yes: true,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         // Mock utility functions
         const mockZip = await import('../../../utils/zip.js');
         const mockBuffer = await import('../../../utils/buffer.js');
@@ -273,7 +273,7 @@ describe('apps-liveupdates-register', () => {
             privateKey: privateKeyPath,
             rolloutPercentage: 1,
         };
-        mockFileExistsAtPath.mockImplementation((path) => {
+        mockIsReadable.mockImplementation((path) => {
             if (path === privateKeyPath)
                 return Promise.resolve(false);
             return Promise.resolve(true);
@@ -284,7 +284,7 @@ describe('apps-liveupdates-register', () => {
         vi.mocked(mockZip.default.isZipped).mockReturnValue(true);
         vi.mocked(mockBuffer.isPrivateKeyContent).mockReturnValue(false);
         await expect(registerCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
-        expect(mockConsola.error).toHaveBeenCalledWith('Private key file not found.');
+        expect(mockConsola.error).toHaveBeenCalledWith(`The private key file does not exist or is not accessible: ${privateKeyPath}`);
     });
     it('should validate path must be a zip file', async () => {
         const appId = 'app-123';
@@ -296,7 +296,7 @@ describe('apps-liveupdates-register', () => {
             path: bundlePath,
             rolloutPercentage: 1,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         // Mock zip utility to return false
         const mockZip = await import('../../../utils/zip.js');
         vi.mocked(mockZip.default.isZipped).mockReturnValue(false);

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

@@ -6,7 +6,7 @@ import { withAuth } from '../../../utils/auth.js';
 import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { createBufferFromPath, createBufferFromReadStream, createBufferFromString, isPrivateKeyContent, } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { directoryContainsSourceMaps, directoryContainsSymlinks, fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory, } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, directoryContainsSymlinks, isReadable, 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';
@@ -136,9 +136,9 @@ export default defineCommand({
             }
         }
         // Validate the provided path
-        const pathExists = await fileExistsAtPath(path);
-        if (!pathExists) {
-            consola.error(`The path does not exist.`);
+        const pathReadable = await isReadable(path);
+        if (!pathReadable) {
+            consola.error(`The path does not exist or is not accessible: ${path}`);
             process.exit(1);
         }
         // Check if the directory contains an index.html file
@@ -216,15 +216,15 @@ export default defineCommand({
             }
             else if (privateKey.endsWith('.pem')) {
                 // Handle file path
-                const fileExists = await fileExistsAtPath(privateKey);
-                if (fileExists) {
+                const privateKeyReadable = await isReadable(privateKey);
+                if (privateKeyReadable) {
                     const keyBuffer = await createBufferFromPath(privateKey);
                     const keyContent = keyBuffer.toString('utf8');
                     const formattedPrivateKey = formatPrivateKey(keyContent);
                     privateKeyBuffer = createBufferFromString(formattedPrivateKey);
                 }
                 else {
-                    consola.error('Private key file not found.');
+                    consola.error(`The private key file does not exist or is not accessible: ${privateKey}`);
                     process.exit(1);
                 }
             }

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

@@ -1,7 +1,7 @@
 import { DEFAULT_API_BASE_URL } from '../../../config/consts.js';
 import authorizationService from '../../../services/authorization-service.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { fileExistsAtPath, getFilesInDirectoryAndSubdirectories, isDirectory } from '../../../utils/file.js';
+import { isReadable, getFilesInDirectoryAndSubdirectories, isDirectory } from '../../../utils/file.js';
 import userConfig from '../../../utils/user-config.js';
 import consola from 'consola';
 import nock from 'nock';
@@ -23,7 +23,7 @@ vi.mock('consola');
 describe('apps-liveupdates-upload', () => {
     const mockUserConfig = vi.mocked(userConfig);
     const mockAuthorizationService = vi.mocked(authorizationService);
-    const mockFileExistsAtPath = vi.mocked(fileExistsAtPath);
+    const mockIsReadable = vi.mocked(isReadable);
     const mockGetFilesInDirectoryAndSubdirectories = vi.mocked(getFilesInDirectoryAndSubdirectories);
     const mockIsDirectory = vi.mocked(isDirectory);
     const mockIsInteractive = vi.mocked(isInteractive);
@@ -53,9 +53,9 @@ describe('apps-liveupdates-upload', () => {
         const appId = 'app-123';
         const nonexistentPath = './nonexistent';
         const options = { appId, path: nonexistentPath, artifactType: 'zip', rollout: 1 };
-        mockFileExistsAtPath.mockResolvedValue(false);
+        mockIsReadable.mockResolvedValue(false);
         await expect(uploadCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
-        expect(mockConsola.error).toHaveBeenCalledWith('The path does not exist.');
+        expect(mockConsola.error).toHaveBeenCalledWith(`The path does not exist or is not accessible: ${nonexistentPath}`);
     });
     it('should validate manifest artifact type requires directory', async () => {
         const appId = 'app-123';
@@ -66,7 +66,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'manifest',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(false);
         // Mock zip utility to return true so path validation passes
         const mockZip = await import('../../../utils/zip.js');
@@ -86,7 +86,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockGetFilesInDirectoryAndSubdirectories.mockResolvedValue([
             { href: 'index.html', mimeType: 'text/html', name: 'index.html', path: 'index.html' },
@@ -140,7 +140,7 @@ describe('apps-liveupdates-upload', () => {
             rollout: 1,
             gitRef,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockGetFilesInDirectoryAndSubdirectories.mockResolvedValue([
             { href: 'index.html', mimeType: 'text/html', name: 'index.html', path: 'index.html' },
@@ -196,7 +196,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockImplementation((path) => {
+        mockIsReadable.mockImplementation((path) => {
             if (path === privateKeyPath)
                 return Promise.resolve(true);
             if (path === bundlePath)
@@ -255,7 +255,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockImplementation((path) => {
+        mockIsReadable.mockImplementation((path) => {
             if (path === privateKeyPath)
                 return Promise.resolve(false);
             return Promise.resolve(true);
@@ -268,7 +268,7 @@ describe('apps-liveupdates-upload', () => {
         const mockBuffer = await import('../../../utils/buffer.js');
         vi.mocked(mockBuffer.isPrivateKeyContent).mockReturnValue(false);
         await expect(uploadCommand.action(options, undefined)).rejects.toThrow('Process exited with code 1');
-        expect(mockConsola.error).toHaveBeenCalledWith('Private key file not found.');
+        expect(mockConsola.error).toHaveBeenCalledWith(`The private key file does not exist or is not accessible: ${privateKeyPath}`);
     });
     it('should handle invalid private key format', async () => {
         const appId = 'app-123';
@@ -280,7 +280,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(false);
         // Mock zip utility to pass path validation
         const mockZip = await import('../../../utils/zip.js');
@@ -302,7 +302,7 @@ describe('apps-liveupdates-upload', () => {
             artifactType: 'zip',
             rollout: 1,
         };
-        mockFileExistsAtPath.mockResolvedValue(true);
+        mockIsReadable.mockResolvedValue(true);
         mockIsDirectory.mockResolvedValue(true);
         mockGetFilesInDirectoryAndSubdirectories.mockResolvedValue([
             { href: 'index.html', mimeType: 'text/html', name: 'index.html', path: 'index.html' },

package/dist/utils/file.js

@@ -46,7 +46,14 @@ 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) => {
+export const isReadable = async (path) => {
+    return new Promise((resolve) => {
+        fs.access(path, fs.constants.R_OK, (err) => {
+            resolve(!err);
+        });
+    });
+};
+export const pathExists = async (path) => {
     return new Promise((resolve) => {
         fs.access(path, fs.constants.F_OK, (err) => {
             resolve(!err);

package/dist/utils/zip.js

@@ -7,13 +7,36 @@ class ZipImpl {
     async zipFolder(sourceFolder) {
         const zip = new AdmZip();
         zip.addLocalFolder(sourceFolder);
+        // Strip external file attributes from every entry. `addLocalFolder` copies
+        // the source's Unix mode bits onto each entry, so a directory with e.g.
+        // `0500` on a CI checkout ends up in the bundle and makes `zip4j` on
+        // Android fail with "Could not create directory" when extracting children
+        // into that read-only parent. Clearing attrs lets the extractor fall back
+        // to its OS defaults. Mirrors the plugin-side workaround in live-update
+        // 8.2.1+ (`FileHeader.setExternalFileAttributes(null)`).
+        for (const entry of zip.getEntries()) {
+            entry.attr = 0;
+        }
         return zip.toBuffer();
     }
     async zipFolderWithGitignore(sourceFolder) {
+        // Do NOT apply the `entry.attr = 0` workaround from `zipFolder` here.
+        // This method zips full project sources for `apps:builds:create`, which
+        // include executables like `gradlew` whose `0755` mode must survive the
+        // round-trip so the server-side build can run them.
         const files = await globby(['**/*'], {
             cwd: sourceFolder,
             gitignore: true,
-            ignore: ['.git/**'],
+            ignore: [
+                '.git/**',
+                '**/node_modules/**',
+                '**/ios/DerivedData/**',
+                '**/ios/Pods/**',
+                '**/ios/build/**',
+                '**/android/build/**',
+                '**/android/.gradle/**',
+                '**/android/app/build/**',
+            ],
             dot: true,
         });
         if (files.length > MAX_ZIP_ENTRIES) {

package/package.json

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