@capawesome/cli 4.18.2 → 4.18.4

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.18.4](https://github.com/capawesome-team/cli/compare/v4.18.3...v4.18.4) (2026-08-20)
+
+
+### Bug Fixes
+
+* report unreadable files with an actionable error message ([#208](https://github.com/capawesome-team/cli/issues/208)) ([cc18dee](https://github.com/capawesome-team/cli/commit/cc18dee898658c99affd660c99e64ef8e45cdf9a))
+
+## [4.18.3](https://github.com/capawesome-team/cli/compare/v4.18.2...v4.18.3) (2026-08-18)
+
+
+### Bug Fixes
+
+* write the manifest file before uploading a bundle ([#206](https://github.com/capawesome-team/cli/issues/206)) ([631e99b](https://github.com/capawesome-team/cli/commit/631e99bff0b9426260e1f997d00c3fd36e840e78))
+
 ## [4.18.2](https://github.com/capawesome-team/cli/compare/v4.18.1...v4.18.2) (2026-08-10)
 
 

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

@@ -7,7 +7,7 @@ import { parseCustomProperties } from '../../../utils/custom-properties.js';
 import { defineCommand, defineOptions } from 'zodline';
 import { createBufferFromPath, createBufferFromReadStream, createBufferFromString, isPrivateKeyContent, } from '../../../utils/buffer.js';
 import { isInteractive } from '../../../utils/environment.js';
-import { directoryContainsSourceMaps, directoryContainsSymlinks, isReadable, getFilesInDirectoryAndSubdirectories, isDirectory, } from '../../../utils/file.js';
+import { directoryContainsSourceMaps, directoryContainsSymlinks, isReadable, getFilesInDirectoryAndSubdirectories, isDirectory, readFileFromDirectory, } from '../../../utils/file.js';
 import { createHash } from '../../../utils/hash.js';
 import { generateManifestJson } from '../../../utils/manifest.js';
 import { formatPrivateKey } from '../../../utils/private-key.js';
@@ -351,7 +351,7 @@ const uploadFiles = async (options) => {
         const file = files[fileIndex];
         fileIndex++;
         consola.start(`Uploading file (${fileIndex}/${files.length})...`);
-        const buffer = await createBufferFromPath(file.path);
+        const buffer = await readFileFromDirectory(file.path);
         await uploadFile({
             appId,
             appBundleId: appBundleId,

package/dist/utils/file.js

@@ -1,6 +1,16 @@
 import fs from 'fs';
 import mime from 'mime';
 import pathModule from 'path';
+import { createBufferFromPath } from './buffer.js';
+import { getCodeFromUnknownError, UserError } from './error.js';
+const concurrentModificationHint = 'Make sure that no other process (e.g. a build or file sync client) modifies the folder while the command is running.';
+const permissionHint = 'Make sure that you have permission to read the file.';
+const unreadableFileErrorHints = {
+    EACCES: permissionHint,
+    EBUSY: concurrentModificationHint,
+    ENOENT: concurrentModificationHint,
+    EPERM: permissionHint,
+};
 export const getFilesInDirectoryAndSubdirectories = async (path) => {
     const files = [];
     const walk = async (directory) => {
@@ -38,6 +48,23 @@ export const getFilesInDirectoryAndSubdirectories = async (path) => {
     await walk(path);
     return files;
 };
+/**
+ * Reads a file that was found by `getFilesInDirectoryAndSubdirectories`.
+ * Such files can vanish, get locked or become inaccessible in the meantime (e.g. by a running build or a file sync client).
+ */
+export const readFileFromDirectory = async (path) => {
+    try {
+        return await createBufferFromPath(path);
+    }
+    catch (error) {
+        const code = getCodeFromUnknownError(error);
+        const hint = code ? unreadableFileErrorHints[code] : undefined;
+        if (hint) {
+            throw new UserError(`The file could not be read: ${path}. ${hint}`);
+        }
+        throw error;
+    }
+};
 export const directoryContainsSymlinks = async (path) => {
     const dirEntries = await fs.promises.readdir(path, { withFileTypes: true, recursive: true }).catch(() => []);
     return dirEntries.some((dirEntry) => dirEntry.isSymbolicLink());

package/dist/utils/file.test.js

@@ -0,0 +1,46 @@
+import fs from 'fs';
+import os from 'os';
+import pathModule from 'path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { UserError } from './error.js';
+import { readFileFromDirectory } from './file.js';
+const { mockCreateBufferFromPath } = vi.hoisted(() => ({ mockCreateBufferFromPath: vi.fn() }));
+vi.mock('./buffer.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    mockCreateBufferFromPath.mockImplementation(actual.createBufferFromPath);
+    return { ...actual, createBufferFromPath: mockCreateBufferFromPath };
+});
+const createErrorWithCode = (code) => Object.assign(new Error(code), { code });
+describe('readFileFromDirectory', () => {
+    let directory;
+    beforeEach(() => {
+        directory = fs.mkdtempSync(pathModule.join(os.tmpdir(), 'file-'));
+    });
+    afterEach(() => {
+        fs.rmSync(directory, { force: true, recursive: true });
+    });
+    it('should read the file', async () => {
+        const path = pathModule.join(directory, 'index.html');
+        fs.writeFileSync(path, '<html></html>');
+        const buffer = await readFileFromDirectory(path);
+        expect(buffer.toString()).toBe('<html></html>');
+    });
+    it('should throw a user error if the file no longer exists', async () => {
+        const path = pathModule.join(directory, 'missing.png');
+        const promise = readFileFromDirectory(path);
+        await expect(promise).rejects.toThrow(UserError);
+        await expect(promise).rejects.toThrow(`The file could not be read: ${path}. Make sure that no other process`);
+    });
+    it('should throw a user error if the file is not readable', async () => {
+        const path = pathModule.join(directory, 'index.html');
+        mockCreateBufferFromPath.mockRejectedValueOnce(createErrorWithCode('EACCES'));
+        const promise = readFileFromDirectory(path);
+        await expect(promise).rejects.toThrow(UserError);
+        await expect(promise).rejects.toThrow(`The file could not be read: ${path}. Make sure that you have permission to read the file.`);
+    });
+    it('should rethrow errors that are not related to reading the file', async () => {
+        const error = createErrorWithCode('EISDIR');
+        mockCreateBufferFromPath.mockRejectedValueOnce(error);
+        await expect(readFileFromDirectory(pathModule.join(directory, 'assets'))).rejects.toBe(error);
+    });
+});

package/dist/utils/manifest.js

@@ -1,6 +1,5 @@
 import { MANIFEST_JSON_FILE_NAME } from '../config/index.js';
-import { createBufferFromPath } from './buffer.js';
-import { getFilesInDirectoryAndSubdirectories, writeFile } from './file.js';
+import { getFilesInDirectoryAndSubdirectories, readFileFromDirectory, writeFile } from './file.js';
 import { createHash } from './hash.js';
 const ignoreFiles = ['.DS_Store', MANIFEST_JSON_FILE_NAME];
 export const generateManifestJson = async (path) => {
@@ -9,7 +8,7 @@ export const generateManifestJson = async (path) => {
     const files = await getFilesInDirectoryAndSubdirectories(path);
     // Iterate over each file
     for (const [index, file] of files.entries()) {
-        const fileBuffer = await createBufferFromPath(file.path);
+        const fileBuffer = await readFileFromDirectory(file.path);
         const checksum = await createHash(fileBuffer);
         const sizeInBytes = fileBuffer.byteLength;
         // Skip ignored files
@@ -23,5 +22,5 @@ export const generateManifestJson = async (path) => {
         });
     }
     // Write the manifest file
-    writeFile(`${path}/${MANIFEST_JSON_FILE_NAME}`, JSON.stringify(manifestItems, null, 2));
+    await writeFile(`${path}/${MANIFEST_JSON_FILE_NAME}`, JSON.stringify(manifestItems, null, 2));
 };

package/dist/utils/manifest.test.js

@@ -0,0 +1,27 @@
+import fs from 'fs';
+import os from 'os';
+import pathModule from 'path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { MANIFEST_JSON_FILE_NAME } from '../config/index.js';
+import { generateManifestJson } from './manifest.js';
+describe('generateManifestJson', () => {
+    let directory;
+    beforeEach(() => {
+        directory = fs.mkdtempSync(pathModule.join(os.tmpdir(), 'manifest-'));
+        fs.mkdirSync(pathModule.join(directory, 'assets'));
+        fs.writeFileSync(pathModule.join(directory, 'index.html'), '<html></html>');
+        fs.writeFileSync(pathModule.join(directory, 'assets', 'main.js'), 'console.log(1);');
+    });
+    afterEach(() => {
+        fs.rmSync(directory, { force: true, recursive: true });
+    });
+    it('should write the manifest file before resolving', async () => {
+        await generateManifestJson(directory);
+        expect(fs.existsSync(pathModule.join(directory, MANIFEST_JSON_FILE_NAME))).toBe(true);
+    });
+    it('should list all files except the manifest file itself', async () => {
+        await generateManifestJson(directory);
+        const manifestItems = JSON.parse(fs.readFileSync(pathModule.join(directory, MANIFEST_JSON_FILE_NAME), 'utf8'));
+        expect(manifestItems.map((item) => item.href).sort()).toEqual(['assets/main.js', 'index.html']);
+    });
+});

package/package.json

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