@signageos/cli 2.7.1 → 2.9.0

package/README.md

@@ -45,12 +45,6 @@ sos autocomplete uninstall
 This will remove the completion script and the source line from your shell configuration file.
 
 
-## Test
-```bash
-cp .env.amy .env
-npm test
-```
-
 ## API reference
 ### General
 | Argument                   | Description                     | Default value                                     |
@@ -175,6 +169,18 @@ sos applet start
 | --detach *(optional)* | Run the applet HTTP server in the background (detached process) | false |
 | --forward-server-url *(optional)* | Custom forward server URL for `sos device connect` command. | https://forward.signageos.io |
 
+##### Local Configuration
+You can create a `sos.config.local.json` file in your applet directory to provide configuration values during local development. This file is automatically loaded when running `sos applet start` and passed to your applet as configuration.
+
+```json
+{
+  "myConfigKey": "myConfigValue",
+  "anotherSetting": true
+}
+```
+
+This is useful for testing your applet with different configuration values without having to deploy it to a device.
+
 #### Applet Tests Upload
 ```bash
 sos applet test upload

package/dist/Applet/Build/appletBuildCommand.js

@@ -21,6 +21,7 @@ const dist_1 = require("@signageos/sdk/dist");
 const appletFacade_1 = require("../appletFacade");
 const log_1 = require("@signageos/sdk/dist/Console/log");
 const debug_1 = __importDefault(require("debug"));
+const appletValidation_1 = require("../appletValidation");
 const Debug = (0, debug_1.default)('@signageos/cli:Applet:Build:appletBuildCommand');
 exports.OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organizationFacade_1.ORGANIZATION_UID_OPTION, appletFacade_1.APPLET_UID_OPTION];
 /**
@@ -56,6 +57,7 @@ exports.appletBuild = (0, commandDefinition_1.createCommandDefinition)({
     run(options) {
         return __awaiter(this, void 0, void 0, function* () {
             const currentDirectory = process.cwd();
+            yield (0, appletValidation_1.validateAppletDirectory)(currentDirectory);
             const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
             const organization = yield (0, organizationFacade_1.getOrganization)(organizationUid);
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);

package/dist/Applet/Generate/appletGenerateCommand.js

@@ -413,11 +413,15 @@ exports.appletGenerate = (0, commandDefinition_1.createCommandDefinition)({
                 path: path.join(appletRootDirectory, '.sosignore'),
                 content: 'node_modules/\n',
             });
+            generateFiles.push({
+                path: path.join(appletRootDirectory, 'sos.config.local.json'),
+                content: '{}\n',
+            });
             // Initialise git repository
             if (git === GitOptions.Yes && gitFound) {
                 generateFiles.push({
                     path: path.join(appletRootDirectory, '.gitignore'),
-                    content: 'node_modules/\n./dist',
+                    content: 'node_modules/\n/dist/\nsos.config.local.json',
                 });
                 yield (0, git_1.initGitRepository)(appletRootDirectory, true).catch((error) => {
                     console.error(`Git repository initialization failed: ${error}`);

package/dist/Applet/Start/appletStartCommand.js

@@ -24,6 +24,7 @@ const wait_1 = __importDefault(require("../../Timer/wait"));
 const appletServerHelper_1 = require("../appletServerHelper");
 const log_1 = require("@signageos/sdk/dist/Console/log");
 const parameters_1 = require("../../parameters");
+const appletValidation_1 = require("../appletValidation");
 const DEFAULT_PORT = 8090;
 const PORT_OPTION = {
     name: 'port',
@@ -96,8 +97,9 @@ exports.appletStart = (0, commandDefinition_1.createCommandDefinition)({
             var _a, _b;
             const currentDirectory = process.cwd();
             const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
-            const entryFileAbsolutePath = yield (0, appletUploadCommandHelper_1.getAppletEntryFileAbsolutePath)(currentDirectory, options);
             const appletPath = yield (0, appletUploadCommandHelper_1.getAppletDirectoryAbsolutePath)(currentDirectory, options);
+            yield (0, appletValidation_1.validateAppletDirectory)(appletPath);
+            const entryFileAbsolutePath = yield (0, appletUploadCommandHelper_1.getAppletEntryFileAbsolutePath)(currentDirectory, options);
             const entryFileRelativePath = (0, appletUploadCommandHelper_1.getAppletEntryFileRelativePath)(entryFileAbsolutePath, appletPath);
             const emulatorUid = yield (0, emulatorFacade_1.loadEmulatorOrCreateNewAndReturnUid)(organizationUid);
             const dev = (0, dist_1.createDevelopment)({

package/dist/Applet/Test/Upload/appletTestRunCommand.js

@@ -24,6 +24,7 @@ const appletTestRunFacade_1 = require("./appletTestRunFacade");
 const wait_1 = __importDefault(require("../../../Timer/wait"));
 const commandDefinition_1 = require("../../../Command/commandDefinition");
 const log_1 = require("@signageos/sdk/dist/Console/log");
+const appletValidation_1 = require("../../appletValidation");
 const OPTION_LIST = [
     organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION,
     deviceFacade_1.DEVICE_UID_OPTION,
@@ -75,7 +76,8 @@ exports.appletTestRun = (0, commandDefinition_1.createCommandDefinition)({
             const skipConfirmation = !!options.yes;
             let tests = options.test;
             const currentDirectory = process.cwd();
-            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
+            yield (0, appletValidation_1.validateAppletDirectory)(currentDirectory);
+            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options, skipConfirmation);
             const organization = yield (0, organizationFacade_1.getOrganization)(organizationUid);
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);
             const deviceUid = yield (0, deviceFacade_1.getDeviceUid)(restApi, options);
@@ -88,8 +90,10 @@ exports.appletTestRun = (0, commandDefinition_1.createCommandDefinition)({
             if (!tests || tests.length === 0) {
                 tests = testSuites.map((testSuite) => testSuite.identifier);
             }
-            (0, appletTestRunFacade_1.validateTestIdentifiers)(tests, testSuites);
-            printRunTests(tests);
+            // At this point tests should be defined, but TypeScript doesn't know that
+            const testsToRun = tests || [];
+            (0, appletTestRunFacade_1.validateTestIdentifiers)(testsToRun, testSuites);
+            printRunTests(testsToRun);
             if (!skipConfirmation) {
                 const response = yield (0, prompts_1.default)({
                     type: 'confirm',
@@ -104,10 +108,10 @@ exports.appletTestRun = (0, commandDefinition_1.createCommandDefinition)({
             const progressBar = (0, progressBarFactory_1.createProgressBar)();
             try {
                 progressBar.init({
-                    size: tests.length,
+                    size: testsToRun.length,
                     name: RUNNING_TEST_TITLE,
                 });
-                yield restApi.device.appletTest.run(device.uid, applet.uid, appletVersion.version, tests);
+                yield restApi.device.appletTest.run(device.uid, applet.uid, appletVersion.version, testsToRun);
                 let deviceAppletTest;
                 do {
                     yield (0, wait_1.default)(1e3);

package/dist/Applet/Test/Upload/appletTestUploadCommand.js

@@ -23,6 +23,7 @@ const progressBarFactory_1 = require("../../../CommandLine/progressBarFactory");
 const packageConfig_1 = require("@signageos/sdk/dist/FileSystem/packageConfig");
 const commandDefinition_1 = require("../../../Command/commandDefinition");
 const log_1 = require("@signageos/sdk/dist/Console/log");
+const appletValidation_1 = require("../../appletValidation");
 const OPTION_LIST = [
     organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION,
     organizationFacade_1.ORGANIZATION_UID_OPTION,
@@ -79,7 +80,8 @@ exports.appletTestUpload = (0, commandDefinition_1.createCommandDefinition)({
             const isVerbose = !!options.verbose;
             const skipConfirmation = !!options.yes;
             const currentDirectory = process.cwd();
-            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
+            yield (0, appletValidation_1.validateAppletDirectory)(currentDirectory);
+            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options, skipConfirmation);
             const organization = yield (0, organizationFacade_1.getOrganization)(organizationUid);
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);
             const version = yield (0, appletFacade_1.getAppletVersion)(currentDirectory);
@@ -151,8 +153,8 @@ exports.appletTestUpload = (0, commandDefinition_1.createCommandDefinition)({
     },
 });
 function displaySuccessMessage(appletName, appletVersion) {
-    (0, log_1.log)('info', `Applet ${chalk_1.default.green(appletName)} version ${chalk_1.default.green(appletVersion)} tests has been uploaded.`);
-    (0, log_1.log)('info', `To run the tests, use command ${chalk_1.default.blue(`sos applet test run`)}`);
+    (0, log_1.log)('info', `\nApplet ${chalk_1.default.green(appletName)} version ${chalk_1.default.green(appletVersion)} tests has been uploaded.`);
+    (0, log_1.log)('info', `To run the tests, use command ${chalk_1.default.green(`sos applet test run`)}`);
 }
 function printMatchedFiles(testFiles) {
     if (testFiles.length > 0) {

package/dist/Applet/Upload/appletUploadCommand.d.ts

@@ -56,14 +56,28 @@ export declare const OPTION_LIST: readonly [{
  * # Upload with organization override
  * sos applet upload --organization-uid abc123def456
  *
- * # Skip confirmation prompts
+ * # Skip confirmation prompts (auto-selects if only 1 org available)
  * sos applet upload --yes
  *
+ * # CI/CD: Non-interactive upload with specific organization
+ * sos applet upload --yes --organization-uid abc123def456
+ *
  * # Verbose output with detailed file information
  * sos applet upload --verbose
  *
  * # Update package.json with new applet UID
  * sos applet upload --update-package-config
+ *
+ * # Complete CI/CD example
+ * sos applet upload --yes --organization-uid abc123def456 --update-package-config
+ * ```
+ *
+ * **Note for CI/CD and --yes flag:**
+ * When using `--yes` with multiple organizations:
+ * - If you have only 1 organization: it will be auto-selected
+ * - If you have multiple organizations: you MUST specify `--organization-uid`
+ * - Alternative: Set a default organization with `sos organization set-default`
+ *
  * ```
  *
  * @throws {Error} When package.json is missing or invalid

package/dist/Applet/Upload/appletUploadCommand.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -15,8 +48,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.appletUpload = exports.OPTION_LIST = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
 const helper_1 = require("../../helper");
-const parameters_1 = require("../../parameters");
 const organizationFacade_1 = require("../../Organization/organizationFacade");
 const appletFacade_1 = require("../appletFacade");
 const appletUploadFacade_1 = require("./appletUploadFacade");
@@ -30,6 +64,7 @@ const log_1 = require("@signageos/sdk/dist/Console/log");
 const sdk_1 = require("@signageos/sdk");
 const GatewayError_1 = __importDefault(require("@signageos/sdk/dist/RestApi/Error/GatewayError"));
 const NotFoundError_1 = __importDefault(require("@signageos/sdk/dist/RestApi/Error/NotFoundError"));
+const appletValidation_1 = require("../appletValidation");
 exports.OPTION_LIST = [
     appletUploadCommandHelper_1.APPLET_PATH_OPTION,
     appletUploadCommandHelper_1.ENTRY_FILE_PATH_OPTION,
@@ -77,14 +112,28 @@ exports.OPTION_LIST = [
  * # Upload with organization override
  * sos applet upload --organization-uid abc123def456
  *
- * # Skip confirmation prompts
+ * # Skip confirmation prompts (auto-selects if only 1 org available)
  * sos applet upload --yes
  *
+ * # CI/CD: Non-interactive upload with specific organization
+ * sos applet upload --yes --organization-uid abc123def456
+ *
  * # Verbose output with detailed file information
  * sos applet upload --verbose
  *
  * # Update package.json with new applet UID
  * sos applet upload --update-package-config
+ *
+ * # Complete CI/CD example
+ * sos applet upload --yes --organization-uid abc123def456 --update-package-config
+ * ```
+ *
+ * **Note for CI/CD and --yes flag:**
+ * When using `--yes` with multiple organizations:
+ * - If you have only 1 organization: it will be auto-selected
+ * - If you have multiple organizations: you MUST specify `--organization-uid`
+ * - Alternative: Set a default organization with `sos organization set-default`
+ *
  * ```
  *
  * @throws {Error} When package.json is missing or invalid
@@ -103,25 +152,44 @@ exports.appletUpload = (0, commandDefinition_1.createCommandDefinition)({
     run(options) {
         return __awaiter(this, void 0, void 0, function* () {
             const currentDirectory = process.cwd();
-            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
+            const skipPrompts = options.yes;
+            const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options, skipPrompts);
             const organization = yield (0, organizationFacade_1.getOrganization)(organizationUid);
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);
-            const { name: appletName, version: appletVersion, frontAppletVersion } = yield (0, appletFacade_1.getApplet)(currentDirectory);
             const appletPathOption = options['applet-path'];
             const appletEntryOption = options['entry-file-path'];
             const updatePackageConfig = options['update-package-config'];
             let appletBinaryFilePath = undefined;
             let appletDirectoryPath = undefined;
             let appletEntryFilePath = undefined;
-            const isSingleFileApplet = !!(appletPathOption && !appletEntryOption);
+            // Determine if this is a single file applet by checking if applet-path points to a file
+            let isSingleFileApplet = false;
+            if (appletPathOption) {
+                const appletPath = path.isAbsolute(appletPathOption) ? appletPathOption : path.join(currentDirectory, appletPathOption);
+                if (yield fs.pathExists(appletPath)) {
+                    const stats = yield fs.stat(appletPath);
+                    isSingleFileApplet = stats.isFile();
+                }
+                else {
+                    // If path doesn't exist, fall back to the original logic
+                    isSingleFileApplet = !appletEntryOption;
+                }
+            }
             if (isSingleFileApplet) {
                 displaySingleFileAppletDeprecationNote();
                 appletBinaryFilePath = yield (0, appletUploadCommandHelper_1.getAppletBinaryFileAbsolutePath)(currentDirectory, options);
             }
             else {
                 appletDirectoryPath = yield (0, appletUploadCommandHelper_1.getAppletDirectoryAbsolutePath)(currentDirectory, options);
-                appletEntryFilePath = yield (0, appletUploadCommandHelper_1.getAppletEntryFileAbsolutePath)(currentDirectory, options);
+                // For multi-file applets, use the applet directory as the base for resolving the entry file
+                appletEntryFilePath = yield (0, appletUploadCommandHelper_1.getAppletEntryFileAbsolutePath)(appletDirectoryPath, options);
             }
+            // Validate that the applet directory contains a valid applet
+            // For multi-file applets, validate the resolved applet directory
+            // For single-file applets (deprecated), validate the current directory
+            const directoryToValidate = appletDirectoryPath !== null && appletDirectoryPath !== void 0 ? appletDirectoryPath : currentDirectory;
+            yield (0, appletValidation_1.validateAppletDirectory)(directoryToValidate);
+            const { name: appletName, version: appletVersion, frontAppletVersion } = yield (0, appletFacade_1.getApplet)(directoryToValidate);
             let overrideAppletVersionConfirmed = false;
             let createNewAppletVersionConfirmed = false;
             let appletUid;
@@ -138,7 +206,10 @@ exports.appletUpload = (0, commandDefinition_1.createCommandDefinition)({
             }
             finally {
                 if (updatePackageConfig) {
-                    yield (0, packageConfig_1.saveToPackage)(currentDirectory, { sos: { appletUid } });
+                    // For multi-file applets, save to the applet directory's package.json
+                    // For single-file applets, save to the current directory's package.json
+                    const packageConfigDirectory = isSingleFileApplet ? currentDirectory : appletDirectoryPath || currentDirectory;
+                    yield (0, packageConfig_1.saveToPackage)(packageConfigDirectory, { sos: { appletUid } });
                 }
             }
             const applet = yield restApi.applet.get(appletUid);
@@ -233,7 +304,7 @@ exports.appletUpload = (0, commandDefinition_1.createCommandDefinition)({
                             progressBar: progressBar,
                         });
                     }
-                    displaySuccessMessage(applet.uid, applet.name, appletVersion, parameters_1.parameters.boxHost);
+                    displaySuccessMessage(applet.uid, applet.name, appletVersion);
                 }
                 else if (createNewAppletVersionConfirmed) {
                     if (isSingleFileApplet) {
@@ -262,7 +333,7 @@ exports.appletUpload = (0, commandDefinition_1.createCommandDefinition)({
                             progressBar,
                         });
                     }
-                    displaySuccessMessage(applet.uid, applet.name, appletVersion, parameters_1.parameters.boxHost);
+                    displaySuccessMessage(applet.uid, applet.name, appletVersion);
                 }
             }
             catch (error) {
@@ -274,10 +345,8 @@ exports.appletUpload = (0, commandDefinition_1.createCommandDefinition)({
         });
     },
 });
-function displaySuccessMessage(appletUid, appletName, appletVersion, boxHost) {
-    (0, log_1.log)('info', `Applet ${chalk_1.default.green(appletName)} version ${chalk_1.default.green(appletVersion)} has been uploaded.`);
-    const appletBoxUri = `https://${boxHost}/applet/${appletUid}/${appletVersion}/build`;
-    (0, log_1.log)('info', `To build specific applications (Tizen, WebOS, SSSP, BrightSign, RPi, Android etc.) go to ${chalk_1.default.blue(appletBoxUri)}`);
+function displaySuccessMessage(appletUid, appletName, appletVersion) {
+    (0, log_1.log)('info', `\nApplet ${chalk_1.default.green(appletName)} version ${chalk_1.default.green(appletVersion)} (${chalk_1.default.blue(appletUid)}) uploaded successfully.`);
 }
 function displaySingleFileAppletDeprecationNote() {
     (0, log_1.log)('warning', `${chalk_1.default.red(`Applets with only applet-path file are ${chalk_1.default.bold(`deprecated`)}.`)} Please find more information at our website.`);

package/dist/Applet/Upload/appletUploadCommandHelper.js

@@ -82,7 +82,7 @@ function getAppletDirectoryAbsolutePath(currentDirectory, options) {
         if (appletDirectoryPath.length > 1 && (appletDirectoryPath.endsWith('/') || appletDirectoryPath.endsWith('\\'))) {
             appletDirectoryPath = appletDirectoryPath.slice(0, -1);
         }
-        (0, log_1.log)('info', `\nUse applet project directory path: ${appletDirectoryPath}`);
+        (0, log_1.log)('info', chalk_1.default.white(`Use applet project directory path: ${appletDirectoryPath}`) + '\n');
         const appletDirectoryPathExists = yield fs.pathExists(appletDirectoryPath);
         if (!appletDirectoryPathExists) {
             throw new Error(`Applet project directory not found: ${appletDirectoryPath}`);
@@ -105,7 +105,7 @@ function getAppletBinaryFileAbsolutePath(currentDirectory, options) {
         }
         // Normalize the path for cross-platform compatibility
         appletBinaryFilePath = path.normalize(appletBinaryFilePath);
-        (0, log_1.log)('info', `\nUse applet binary file: ${appletBinaryFilePath}`);
+        (0, log_1.log)('info', chalk_1.default.white(`Use applet binary file: ${appletBinaryFilePath}` + '\n'));
         const appletBinaryFilePathExists = yield fs.pathExists(appletBinaryFilePath);
         if (!appletBinaryFilePathExists) {
             throw new Error(`Applet binary file not found: ${appletBinaryFilePath}`);
@@ -132,7 +132,7 @@ function getAppletEntryFileAbsolutePath(currentDirectory, options) {
         }
         // Normalize the path for cross-platform compatibility
         appletEntryFilePath = path.normalize(appletEntryFilePath);
-        (0, log_1.log)('info', `\nUse applet entry file: ${appletEntryFilePath}`);
+        (0, log_1.log)('info', chalk_1.default.white(`Use applet entry file: ${appletEntryFilePath}`) + '\n');
         const appletEntryFilePathExists = yield fs.pathExists(appletEntryFilePath);
         if (!appletEntryFilePathExists) {
             throw new Error(`Applet entry file not found: ${appletEntryFilePath}\nDid you forget to build your applet by ${chalk_1.default.green('sos applet build')}?`);

package/dist/Applet/Upload/appletUploadFacade.js

@@ -60,9 +60,17 @@ function updateSingleFileApplet(parameters) {
     return __awaiter(this, void 0, void 0, function* () {
         const { restApi, applet } = parameters;
         const appletBinary = fs.createReadStream(applet.binaryFilePath, { encoding: 'utf8' });
-        yield restApi.applet.version.update(applet.uid, applet.version, {
+        yield restApi.applet.version
+            .update(applet.uid, applet.version, {
             binary: appletBinary,
             frontAppletVersion: applet.frontAppletVersion,
+        })
+            .catch((error) => {
+            if (error instanceof Error) {
+                throw new Error(`Failed to update applet version "${applet.version}" with binary file "${applet.binaryFilePath}": ${error.message}\n` +
+                    `Please check that the file exists, is readable, and that you have permissions to update the applet.`);
+            }
+            throw error;
         });
     });
 }
@@ -91,40 +99,44 @@ const updateMultiFileApplet = (parameters) => __awaiter(void 0, void 0, void 0,
         }
         else {
             changedFilesCounter++;
-            (0, log_1.log)('info', chalk_1.default.yellow(` Uploading ${fileAbsolutePath}`));
         }
         if (progressBar) {
-            progressBar.init({ size: fileSize, name: fileRelativePath });
+            progressBar.init({ size: fileSize, name: fileRelativePosixPath });
         }
         const fileStream = fs.createReadStream(fileAbsolutePath);
         fileStream.pause();
         fileStream.on('data', (chunk) => {
             if (progressBar) {
-                progressBar.update({ add: chunk.length });
+                progressBar.update({ add: chunk.length, name: fileRelativePosixPath });
             }
         });
-        try {
-            // update file is just alias to create file (both are idempotent)
-            yield restApi.applet.version.file.update(applet.uid, applet.version, fileRelativePosixPath, {
-                content: fileStream,
-                hash: fileHash,
-                size: fileSize,
-                type: fileType,
-            }, { build: false });
-        }
-        catch (error) {
+        // update file is just alias to create file (both are idempotent)
+        yield restApi.applet.version.file
+            .update(applet.uid, applet.version, fileRelativePosixPath, {
+            content: fileStream,
+            hash: fileHash,
+            size: fileSize,
+            type: fileType,
+        }, { build: false })
+            .catch((error) => {
             if (fileSize === 0) {
                 throw new Error(`Empty files are temporarily disallowed ${fileAbsolutePath}`);
             }
+            // Enhance error message with more context
+            if (error instanceof Error) {
+                const enhancedError = new Error(`Failed to upload file "${fileAbsolutePath}": ${error.message}\n` + `File details: Size=${fileSize} bytes, Type=${fileType}`);
+                // Preserve the original stack trace if available
+                if (error.stack) {
+                    enhancedError.stack = error.stack;
+                }
+                throw enhancedError;
+            }
             throw error;
-        }
+        });
     }
     for (const fileRelativePath in currentAppletFiles) {
         if (Object.prototype.hasOwnProperty.call(currentAppletFiles, fileRelativePath)) {
-            try {
-                yield restApi.applet.version.file.remove(applet.uid, applet.version, fileRelativePath, { build: false });
-            }
-            catch (error) {
+            yield restApi.applet.version.file.remove(applet.uid, applet.version, fileRelativePath, { build: false }).catch((error) => {
                 if (error instanceof NotFoundError_1.default) {
                     /*
                      * This means that the file we are trying to remove somehow already got removed.
@@ -134,9 +146,17 @@ const updateMultiFileApplet = (parameters) => __awaiter(void 0, void 0, void 0,
                     Debug(`remove old file ${fileRelativePath} failed`);
                 }
                 else {
+                    // Add more context to file removal errors
+                    if (error instanceof Error) {
+                        const enhancedError = new Error(`Failed to remove obsolete file "${fileRelativePath}": ${error.message}`);
+                        if (error.stack) {
+                            enhancedError.stack = error.stack;
+                        }
+                        throw enhancedError;
+                    }
                     throw error;
                 }
-            }
+            });
             changedFilesCounter++;
         }
     }
@@ -144,8 +164,16 @@ const updateMultiFileApplet = (parameters) => __awaiter(void 0, void 0, void 0,
     const appletEntryFilePosixPath = path.posix.normalize(applet.entryFilePath.replace(/\\/g, '/'));
     if (changedFilesCounter > 0 || appletVersion.entryFile !== appletEntryFilePosixPath) {
         // The update applet version has to be the last after upload all files to trigger applet version build
-        yield restApi.applet.version.update(applet.uid, applet.version, {
+        yield restApi.applet.version
+            .update(applet.uid, applet.version, {
             entryFile: appletEntryFilePosixPath,
+        })
+            .catch((error) => {
+            if (error instanceof Error) {
+                throw new Error(`Failed to update applet version with entry file "${appletEntryFilePosixPath}": ${error.message}\n` +
+                    `This usually happens when the entry file is missing, has errors, or the applet version cannot be built.`);
+            }
+            throw error;
         });
     }
     if (progressBar) {
@@ -159,10 +187,18 @@ exports.updateMultiFileApplet = updateMultiFileApplet;
 const createSingleFileApplet = (parameters) => __awaiter(void 0, void 0, void 0, function* () {
     const { restApi, applet } = parameters;
     const appletBinary = fs.createReadStream(applet.binaryFilePath, { encoding: 'utf8' });
-    yield restApi.applet.version.create(applet.uid, {
+    yield restApi.applet.version
+        .create(applet.uid, {
         binary: appletBinary,
         version: applet.version,
         frontAppletVersion: applet.frontAppletVersion,
+    })
+        .catch((error) => {
+        if (error instanceof Error) {
+            throw new Error(`Failed to create applet version "${applet.version}" with binary file "${applet.binaryFilePath}": ${error.message}\n` +
+                `Please check that the file exists, is readable, and that you have permissions to create applet versions.`);
+        }
+        throw error;
     });
 });
 exports.createSingleFileApplet = createSingleFileApplet;
@@ -170,39 +206,71 @@ const createMultiFileFileApplet = (parameters) => __awaiter(void 0, void 0, void
     const { restApi, applet, progressBar } = parameters;
     const appletEntryFilePosixPath = path.posix.normalize(applet.entryFilePath.replace(/\\/g, '/'));
     try {
-        yield restApi.applet.version.create(applet.uid, {
+        yield restApi.applet.version
+            .create(applet.uid, {
             version: applet.version,
             entryFile: appletEntryFilePosixPath,
-        });
-        yield Promise.all(applet.files.map((fileAbsolutePath) => __awaiter(void 0, void 0, void 0, function* () {
-            const fileRelativePath = (0, appletUploadFacadeHelper_1.getAppletFileRelativePath)(fileAbsolutePath, applet.directoryPath);
-            const fileHash = yield (0, fileSystem_1.getFileMD5Checksum)(fileAbsolutePath);
-            const fileType = yield (0, fileSystem_1.getFileType)(fileAbsolutePath);
-            const fileSize = (yield fs.stat(fileAbsolutePath)).size;
-            if (fileSize === 0) {
-                throw new Error(`Empty files are temporarily disallowed ${fileAbsolutePath}`);
-            }
-            if (progressBar) {
-                progressBar.init({ size: fileSize, name: fileRelativePath });
+        })
+            .catch((error) => {
+            if (error instanceof Error) {
+                throw new Error(`Failed to create applet version "${applet.version}": ${error.message}\n` +
+                    `Please check that you have permissions to create applet versions and that the version is valid.`);
             }
-            const fileStream = fs.createReadStream(fileAbsolutePath);
-            fileStream.pause();
-            fileStream.on('data', (chunk) => {
+            throw error;
+        });
+        // Process files sequentially to avoid concurrent progress bar issues
+        for (const fileAbsolutePath of applet.files) {
+            try {
+                const fileRelativePath = (0, appletUploadFacadeHelper_1.getAppletFileRelativePath)(fileAbsolutePath, applet.directoryPath);
+                const fileHash = yield (0, fileSystem_1.getFileMD5Checksum)(fileAbsolutePath);
+                const fileType = yield (0, fileSystem_1.getFileType)(fileAbsolutePath);
+                const fileSize = (yield fs.stat(fileAbsolutePath)).size;
+                if (fileSize === 0) {
+                    (0, log_1.log)('info', chalk_1.default.yellow(`Skipping empty file ${fileAbsolutePath}`));
+                    continue;
+                }
+                const filePosixPath = path.posix.normalize(fileRelativePath.replace(/\\/g, '/'));
                 if (progressBar) {
-                    progressBar.update({ add: chunk.length });
+                    progressBar.init({ size: fileSize, name: filePosixPath });
                 }
-            });
-            const filePosixPath = path.posix.normalize(fileRelativePath.replace(/\\/g, '/'));
-            (0, log_1.log)('info', chalk_1.default.yellow(` Uploading ${fileAbsolutePath}`));
-            return restApi.applet.version.file.create(applet.uid, applet.version, {
-                name: path.basename(filePosixPath),
-                path: filePosixPath,
-                type: fileType,
-                hash: fileHash,
-                content: fileStream,
-                size: fileSize,
-            }, { build: false });
-        })));
+                const fileStream = fs.createReadStream(fileAbsolutePath);
+                fileStream.pause();
+                fileStream.on('data', (chunk) => {
+                    if (progressBar) {
+                        progressBar.update({ add: chunk.length, name: filePosixPath });
+                    }
+                });
+                yield restApi.applet.version.file
+                    .create(applet.uid, applet.version, {
+                    name: path.basename(filePosixPath),
+                    path: filePosixPath,
+                    type: fileType,
+                    hash: fileHash,
+                    content: fileStream,
+                    size: fileSize,
+                }, { build: false })
+                    .catch((error) => {
+                    if (error instanceof Error) {
+                        throw new Error(`Failed to upload file "${fileAbsolutePath}": ${error.message}\n` +
+                            `File details: Size=${fileSize} bytes, Type=${fileType}`);
+                    }
+                    throw error;
+                });
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    if (fileAbsolutePath) {
+                        const enhancedError = new Error(`Failed to upload file "${fileAbsolutePath}": ${error.message}`);
+                        // Preserve the original stack trace if available
+                        if (error.stack) {
+                            enhancedError.stack = error.stack;
+                        }
+                        throw enhancedError;
+                    }
+                }
+                throw error;
+            }
+        }
     }
     finally {
         if (progressBar) {
@@ -210,8 +278,12 @@ const createMultiFileFileApplet = (parameters) => __awaiter(void 0, void 0, void
         }
     }
     // The extra update applet version which has to be after upload all files to trigger applet version build
-    yield restApi.applet.version.update(applet.uid, applet.version, {
-        entryFile: appletEntryFilePosixPath,
+    yield restApi.applet.version.update(applet.uid, applet.version, { entryFile: appletEntryFilePosixPath }).catch((error) => {
+        if (error instanceof Error) {
+            throw new Error(`Failed to finalize applet version with entry file "${appletEntryFilePosixPath}": ${error.message}\n` +
+                `This usually happens when there were issues with one or more uploaded files or when building the applet.`);
+        }
+        throw error;
     });
 });
 exports.createMultiFileFileApplet = createMultiFileFileApplet;