bdy 1.16.28-stage → 1.16.30-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.16.28-stage",
+  "version": "1.16.30-dev",
   "type": "commonjs",
   "license": "MIT",
   "scripts": {

package/distTs/src/api/client.js

@@ -58,7 +58,7 @@ class ApiClient {
         }
         return false;
     }
-    async request({ method = 'GET', path, query, body = null, headers = {}, parseResponseBody = false, rawResponseBody = false, httpUrlEncoded = false, tryRefreshingToken = true, }) {
+    async request({ method = 'GET', path, query, body = null, headers = {}, parseResponseBody = false, rawResponseBody = false, rawResponse = false, httpUrlEncoded = false, tryRefreshingToken = true, }) {
         if (!headers)
             headers = {};
         if (this.token && !headers.authorization) {
@@ -94,6 +94,8 @@ class ApiClient {
         };
         let status;
         let responseBody;
+        let response;
+        let rateLimitReset;
         logger_1.default.debug(`API CLIENT: ${method} ${this.baseUrl.protocol}//${this.baseUrl.host}${path}`);
         logger_1.default.debug('QUERY');
         logger_1.default.debug(query);
@@ -102,9 +104,10 @@ class ApiClient {
         logger_1.default.debug('BODY');
         logger_1.default.debug(bodyParsed);
         try {
-            const r = await this.client.request(opts);
-            status = r.statusCode;
-            responseBody = r.body;
+            response = await this.client.request(opts);
+            rateLimitReset = response.headers['x-rate-limit-reset'];
+            status = response.statusCode;
+            responseBody = response.body;
             logger_1.default.debug(`API CLIENT RESPONSE STATUS: ${status}`);
         }
         catch (err) {
@@ -131,6 +134,7 @@ class ApiClient {
                         headers,
                         parseResponseBody,
                         rawResponseBody,
+                        rawResponse,
                         httpUrlEncoded,
                         tryRefreshingToken: false,
                     });
@@ -147,12 +151,12 @@ class ApiClient {
             }
             catch {
                 await responseBody.dump();
-                throw new Error(texts_1.ERR_REST_API_RATE_LIMIT);
+                throw new Error((0, texts_1.ERR_REST_API_RATE_LIMIT)(rateLimitReset));
             }
             if (json.errors && json.errors[0] && json.errors[0].message) {
-                throw new Error((0, texts_1.ERR_API_MESSAGE_REPLACER)(json.errors[0].message, path, this.baseUrl));
+                throw new Error((0, texts_1.ERR_API_MESSAGE_REPLACER)(json.errors[0].message, path, this.baseUrl, rateLimitReset));
             }
-            throw new Error(texts_1.ERR_REST_API_RATE_LIMIT);
+            throw new Error((0, texts_1.ERR_REST_API_RATE_LIMIT)(rateLimitReset));
         }
         if ([400, 404].includes(status)) {
             let json;
@@ -168,7 +172,7 @@ class ApiClient {
             logger_1.default.debug('API CLIENT PARSED RESPONSE:');
             logger_1.default.debug(json);
             if (json.errors && json.errors[0] && json.errors[0].message) {
-                throw new Error((0, texts_1.ERR_API_MESSAGE_REPLACER)(json.errors[0].message, path, this.baseUrl));
+                throw new Error((0, texts_1.ERR_API_MESSAGE_REPLACER)(json.errors[0].message, path, this.baseUrl, rateLimitReset));
             }
             if (status === 404)
                 throw new Error(texts_1.ERR_REST_API_RESOURCE_NOT_FOUND);
@@ -189,6 +193,9 @@ class ApiClient {
                     throw new Error(texts_1.ERR_REST_API_GENERAL_ERROR);
                 }
             }
+            else if (rawResponse) {
+                return response;
+            }
             else if (rawResponseBody) {
                 return responseBody;
             }
@@ -258,6 +265,13 @@ class ApiClient {
             parseResponseBody: true,
         });
     }
+    async sandboxDownloadFile(workspace, sandboxId, remotePath) {
+        return await this.request({
+            method: 'GET',
+            path: `/workspaces/${encodeURIComponent(workspace)}/sandboxes/${encodeURIComponent(sandboxId)}/download${remotePath}`,
+            rawResponse: true,
+        });
+    }
     async sandboxUploadFile(workspace, sandboxId, remotePath, localPath) {
         const formData = new undici_1.FormData();
         const file = await node_fs_1.default.openAsBlob(localPath);
@@ -503,23 +517,6 @@ class ApiClient {
             await this.waitSleep();
         }
     }
-    async sandboxWaitForApp(workspace, sandboxId, timeout = 300) {
-        const end = Date.now() + timeout * 1000;
-        for (;;) {
-            const sb = await this.getSandbox(workspace, sandboxId);
-            if ([
-                utils_1.SANDBOX_APP_STATUS.RUNNING,
-                utils_1.SANDBOX_APP_STATUS.FAILED,
-                utils_1.SANDBOX_APP_STATUS.ENDED,
-            ].includes(sb.app_status)) {
-                return sb.app_status;
-            }
-            if (Date.now() > end) {
-                throw new Error('timeout');
-            }
-            await this.waitSleep();
-        }
-    }
     async getWorkspaces() {
         return await this.request({
             method: 'GET',
@@ -537,10 +534,15 @@ class ApiClient {
             parseResponseBody: true,
         });
     }
-    async getProjects(workspace) {
+    async getProjects(workspace, page = 1, perPage = 100) {
+        const query = {
+            page: page.toString(),
+            per_page: perPage.toString(),
+        };
         return await this.request({
             method: 'GET',
             path: `/workspaces/${encodeURIComponent(workspace)}/projects`,
+            query,
             parseResponseBody: true,
         });
     }
@@ -570,7 +572,7 @@ class ApiClient {
     async deletePackageVersion(workspace, packageId, versionId) {
         return await this.request({
             method: 'DELETE',
-            path: `/workspaces/${encodeURIComponent(workspace)}/packages/${encodeURIComponent(packageId)}/versions/${encodeURIComponent(versionId)}`
+            path: `/workspaces/${encodeURIComponent(workspace)}/packages/${encodeURIComponent(packageId)}/versions/${encodeURIComponent(versionId)}`,
         });
     }
     async getPackageVersionByIdentifier(workspace, project, pkg, version) {
@@ -589,9 +591,9 @@ class ApiClient {
             path: `/workspaces/${encodeURIComponent(workspace)}/packages/${pkgId}/versions`,
             query: {
                 page: page.toString(),
-                per_page: perPage.toString()
+                per_page: perPage.toString(),
             },
-            parseResponseBody: true
+            parseResponseBody: true,
         });
     }
     async getPackageVersion(workspace, pkgId, versionId) {
@@ -654,11 +656,10 @@ class ApiClient {
             parseResponseBody: true,
         });
     }
-    ;
     async deletePackage(workspace, packageId) {
         return await this.request({
             method: 'DELETE',
-            path: `/workspaces/${encodeURIComponent(workspace)}/packages/${encodeURIComponent(packageId)}`
+            path: `/workspaces/${encodeURIComponent(workspace)}/packages/${encodeURIComponent(packageId)}`,
         });
     }
 }

package/distTs/src/command/package/create.js

@@ -7,6 +7,7 @@ const utils_1 = require("../../utils");
 const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
+const human_id_1 = __importDefault(require("human-id"));
 const commandPackageCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_PACKAGE_CREATE);
 commandPackageCreate.alias('add');
 commandPackageCreate.option('--token <token>', texts_1.OPTION_REST_API_TOKEN);
@@ -18,13 +19,20 @@ commandPackageCreate.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJ
 commandPackageCreate.option('-t, --type <type>', texts_1.OPT_COMMAND_PACKAGE_TYPE, utils_1.PACKAGE_TYPE.FILE);
 commandPackageCreate.option('-b, --buddy', texts_1.OPTION_HTTP_AUTH_BUDDY);
 commandPackageCreate.option('-a, --auth <user:pass>', texts_1.OPTION_HTTP_AUTH);
-commandPackageCreate.argument('<name>', texts_1.OPT_COMMAND_PACKAGE_NAME);
+commandPackageCreate.argument('[name]', texts_1.OPT_COMMAND_PACKAGE_NAME);
+commandPackageCreate.addHelpText('after', texts_1.EXAMPLE_PACKAGE_CREATE);
 commandPackageCreate.action(async (name, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);
     const client = input_1.default.restApiTokenClient(options.api, options.region, options.token);
     const type = input_1.default.packageType(options.type);
     const scope = input_1.default.packageScope(project);
+    if (!name) {
+        if (options.identifier)
+            name = options.identifier;
+        else
+            name = (0, human_id_1.default)({ separator: '-', capitalize: false });
+    }
     const data = {
         name,
         type,
@@ -54,6 +62,6 @@ commandPackageCreate.action(async (name, options) => {
         };
     }
     const result = await client.postPackage(workspace, data);
-    output_1.default.exitSuccess((0, texts_1.TXT_PACKAGE_CREATED)(workspace, result));
+    output_1.default.exitSuccess((0, texts_1.TXT_PACKAGE_CREATED)(client.baseUrl, workspace, result));
 });
 exports.default = commandPackageCreate;

package/distTs/src/command/package/delete.js

@@ -15,6 +15,7 @@ commandPackageDelete.option('--region <region>', texts_1.OPTION_REST_API_REGION)
 commandPackageDelete.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPackageDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandPackageDelete.argument('<identifier>', texts_1.OPT_COMMAND_PACKAGE_IDENTIFIER);
+commandPackageDelete.addHelpText('after', texts_1.EXAMPLE_PACKAGE_DELETE);
 commandPackageDelete.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const client = input_1.default.restApiTokenClient(options.api, options.region, options.token);
@@ -25,7 +26,8 @@ commandPackageDelete.action(async (identifier, options) => {
     if (!data.pkg_id) {
         output_1.default.exitError(texts_1.ERR_PACKAGE_NOT_FOUND);
     }
-    const confirmed = options.force || await output_1.default.confirm((0, texts_1.TXT_PACKAGE_DELETE_CONFIRM)(identifier));
+    const confirmed = options.force ||
+        (await output_1.default.confirm((0, texts_1.TXT_PACKAGE_DELETE_CONFIRM)(identifier)));
     if (confirmed) {
         await client.deletePackage(workspace, data.pkg_id);
         output_1.default.exitSuccess(texts_1.TXT_PACKAGE_DELETED);

package/distTs/src/command/package/download.js

@@ -11,8 +11,7 @@ const logger_1 = __importDefault(require("../../logger"));
 const path_1 = require("path");
 const uuid_1 = require("uuid");
 const fs_1 = __importDefault(require("fs"));
-const promises_1 = __importDefault(require("stream/promises"));
-const fflate_1 = require("fflate");
+const promises_1 = __importDefault(require("node:stream/promises"));
 const commandPackageDownload = (0, utils_1.newCommand)('download', texts_1.DESC_COMMAND_PACKAGE_DOWNLOAD);
 commandPackageDownload.alias('dd');
 commandPackageDownload.option('-t, --token <token>', texts_1.OPTION_REST_API_TOKEN);
@@ -24,6 +23,7 @@ commandPackageDownload.option('-m, --merge', texts_1.OPTION_PACKAGE_DOWNLOAD_MER
 commandPackageDownload.option('-r, --replace', texts_1.OPTION_PACKAGE_DOWNLOAD_REPLACE);
 commandPackageDownload.argument('<identifier>', texts_1.OPTION_PACKAGE_ID);
 commandPackageDownload.argument('<directory>', texts_1.OPTION_PACKAGE_DOWNLOAD_PATH);
+commandPackageDownload.addHelpText('after', texts_1.EXAMPLE_PACKAGE_DOWNLOAD);
 commandPackageDownload.action(async (id, path, options) => {
     const client = input_1.default.restApiTokenClient(options.api, options.region, options.token);
     const workspace = input_1.default.restApiWorkspace(options.workspace);
@@ -120,7 +120,7 @@ commandPackageDownload.action(async (id, path, options) => {
         output_1.default.normal(texts_1.TXT_PACKAGE_DOWNLOADED_ZIP);
         output_1.default.normal(texts_1.TXT_PACKAGE_UNZIPPING);
         let count = 0;
-        await unzip(dirPath, zipPath, () => {
+        await (0, utils_1.unzipFile)(dirPath, zipPath, () => {
             count += 1;
             output_1.default.clearPreviousLine();
             output_1.default.normal((0, texts_1.TXT_PACKAGE_UNZIPPING_COUNT)(count));
@@ -136,121 +136,4 @@ commandPackageDownload.action(async (id, path, options) => {
     }
     output_1.default.exitSuccess((0, texts_1.TXT_PACKAGE_DOWNLOADED)(version, dirPath));
 });
-const unzip = (dirPath, zipPath, onFile) => {
-    return new Promise((resolve, reject) => {
-        let _startedFiles = 0;
-        let _finishedFiles = 0;
-        let _finishedStream = false;
-        let _finishedError = null;
-        let _calledResolve = false;
-        const rs = fs_1.default.createReadStream(zipPath);
-        const _finish = () => {
-            if (_finishedError || _finishedStream) {
-                try {
-                    rs.removeAllListeners();
-                    rs.close();
-                }
-                catch {
-                    // do nothing
-                }
-            }
-            if (_calledResolve)
-                return;
-            if (_finishedError) {
-                _calledResolve = true;
-                reject(_finishedError);
-                return;
-            }
-            if (_finishedStream && _startedFiles === _finishedFiles) {
-                _calledResolve = true;
-                resolve();
-            }
-        };
-        const finishFile = (err, fws) => {
-            if (!_finishedError && err)
-                _finishedError = err;
-            _finishedFiles += 1;
-            if (fws) {
-                try {
-                    fws.removeAllListeners();
-                    fws.close();
-                }
-                catch {
-                    // do nothing
-                }
-            }
-            onFile();
-            _finish();
-        };
-        const finishStream = (err) => {
-            if (!_finishedError && err)
-                _finishedError = err;
-            _finishedStream = true;
-            _finish();
-        };
-        const unzip = new fflate_1.Unzip(async (file) => {
-            if (_finishedError)
-                return;
-            _startedFiles += 1;
-            const fullPath = (0, path_1.join)(dirPath, file.name);
-            const parentPath = (0, path_1.dirname)(fullPath);
-            let fws;
-            try {
-                await fs_1.default.promises.rm(fullPath, {
-                    recursive: true,
-                    force: true,
-                });
-            }
-            catch {
-                // do nothing
-            }
-            try {
-                if (fullPath.endsWith('/')) {
-                    await fs_1.default.promises.mkdir(fullPath, {
-                        recursive: true,
-                    });
-                    finishFile();
-                    return;
-                }
-                await fs_1.default.promises.mkdir(parentPath, {
-                    recursive: true,
-                });
-                fws = fs_1.default.createWriteStream(fullPath, {
-                    flags: 'w',
-                });
-                fws.on('error', (err) => {
-                    finishFile(err, fws);
-                });
-            }
-            catch (err) {
-                finishFile(err, fws);
-                return;
-            }
-            file.ondata = (err, data, final) => {
-                if (_finishedError)
-                    return;
-                if (err)
-                    finishFile(err, fws);
-                else {
-                    if (fws)
-                        fws.write(data);
-                    if (final)
-                        finishFile(null, fws);
-                }
-            };
-            file.start();
-        });
-        unzip.register(fflate_1.AsyncUnzipInflate);
-        rs.on('data', (chunk) => {
-            unzip.push(chunk, false);
-        });
-        rs.on('error', (err) => {
-            finishStream(err);
-        });
-        rs.on('end', () => {
-            unzip.push(new Uint8Array(0), true);
-            finishStream();
-        });
-    });
-};
 exports.default = commandPackageDownload;

package/distTs/src/command/package/get.js

@@ -34,6 +34,6 @@ commandSandboxGet.action(async (identifier, options) => {
         'Size': (0, utils_1.formatBytes)(pkg.size || 0),
         'Created': pkg.created_date,
     });
-    output_1.default.exitNormal();
+    output_1.default.exitNormal(`\n${(0, texts_1.TXT_PACKAGE_PUBLISH)(client.baseUrl, workspace, pkg)}`);
 });
 exports.default = commandSandboxGet;

package/distTs/src/command/package/list.js

@@ -22,7 +22,7 @@ commandPackageList.action(async (options) => {
     if (!response.packages || response.packages.length === 0) {
         output_1.default.exitError(texts_1.ERR_COMMAND_PACKAGE_NO_PROJECTS);
     }
-    const data = [['NAME', 'IDENTIFIER', 'TYPE', 'SCOPE', 'URL']];
+    const data = [['NAME', 'IDENTIFIER', 'TYPE', 'URL']];
     for (const pkg of response.packages) {
         if (project && pkg.scope === utils_1.PACKAGE_SCOPE.WORKSPACE)
             continue;

package/distTs/src/command/package/publish.js

@@ -23,6 +23,7 @@ commandPackagePublish.option('-c, --create', texts_1.OPTION_PACKAGE_PUBLISH_CREA
 commandPackagePublish.option('-f, --force', texts_1.OPTION_PACKAGE_PUBLISH_OVERWRITE_VERSION);
 commandPackagePublish.argument('<identifier>', texts_1.OPTION_PACKAGE_ID);
 commandPackagePublish.argument('<directory>', texts_1.OPTION_PACKAGE_PUBLISH_PATH);
+commandPackagePublish.addHelpText('after', texts_1.EXAMPLE_PACKAGE_PUBLISH);
 commandPackagePublish.action(async (id, path, options) => {
     let dirPath = input_1.default.resolvePath(path);
     const workspace = input_1.default.restApiWorkspace(options.workspace);
@@ -48,13 +49,13 @@ commandPackagePublish.action(async (id, path, options) => {
                 type: utils_1.PACKAGE_TYPE.FILE,
                 scope: utils_1.PACKAGE_SCOPE.WORKSPACE,
                 authorization: {
-                    type: utils_1.PACKAGE_AUTH_TYPE.BUDDY
-                }
+                    type: utils_1.PACKAGE_AUTH_TYPE.BUDDY,
+                },
             };
             if (project) {
                 data.scope = utils_1.PACKAGE_SCOPE.PROJECT;
                 data.project = {
-                    name: project
+                    name: project,
                 };
             }
             const d = await client.postPackage(workspace, data);

package/distTs/src/command/package/version/delete.js

@@ -17,6 +17,7 @@ commandPackageVersionDelete.option('-p, --project <name>', texts_1.OPTION_REST_A
 commandPackageVersionDelete.argument('<identifier>', texts_1.OPT_COMMAND_PACKAGE_IDENTIFIER);
 commandPackageVersionDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandPackageVersionDelete.argument('<version>', texts_1.OPT_COMMAND_PACKAGE_VERSION);
+commandPackageVersionDelete.addHelpText('after', texts_1.EXAMPLE_PACKAGE_VERSION_DELETE);
 commandPackageVersionDelete.action(async (identifier, version, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

package/distTs/src/command/package/version/get.js

@@ -15,6 +15,7 @@ commandPackageVersionGet.option('-w, --workspace <domain>', texts_1.OPTION_REST_
 commandPackageVersionGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPackageVersionGet.argument('<identifier>', texts_1.OPT_COMMAND_PACKAGE_IDENTIFIER);
 commandPackageVersionGet.argument('<version>', texts_1.OPT_COMMAND_PACKAGE_VERSION);
+commandPackageVersionGet.addHelpText('after', texts_1.EXAMPLE_PACKAGE_VERSION_GET);
 commandPackageVersionGet.action(async (identifier, version, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

package/distTs/src/command/package/version/list.js

@@ -17,6 +17,7 @@ commandPackageVersionList.option('--page <number>', texts_1.OPTION_REST_API_PAGE
 commandPackageVersionList.option('--per-page <number>', texts_1.OPTION_REST_API_PER_PAGE, '10');
 commandPackageVersionList.alias('ls');
 commandPackageVersionList.argument('<identifier>', texts_1.OPT_COMMAND_PACKAGE_IDENTIFIER);
+commandPackageVersionList.addHelpText('after', texts_1.EXAMPLE_PACKAGE_VERSION_LIST);
 commandPackageVersionList.action(async (identifier, options) => {
     const page = input_1.default.restApiPage(options.page);
     const perPage = input_1.default.restApiPerPage(options.perPage);

package/distTs/src/command/pipeline/run.js

@@ -29,6 +29,7 @@ commandPipelineRun.option('--action <actions...>', texts_1.OPTION_PIPELINE_RUN_A
 commandPipelineRun.option('--wait [minutes]', texts_1.OPTION_PIPELINE_RUN_WAIT);
 commandPipelineRun.argument('<identifier>', texts_1.OPTION_PIPELINE_RUN_ARGUMENT);
 commandPipelineRun.usage('<identifier> [options]');
+commandPipelineRun.addHelpText('after', texts_1.EXAMPLE_PIPELINE_RUN);
 commandPipelineRun.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);

package/distTs/src/command/sandbox/cp.js

@@ -9,34 +9,35 @@ const output_1 = __importDefault(require("../../output"));
 const input_1 = __importDefault(require("../../input"));
 const fdir_1 = require("fdir");
 const path_1 = require("path");
+const node_fs_1 = __importDefault(require("node:fs"));
+const uuid_1 = require("uuid");
+const promises_1 = __importDefault(require("node:stream/promises"));
 const commandSandboxCp = (0, utils_1.newCommand)('cp', texts_1.DESC_COMMAND_SANDBOX_CP);
 commandSandboxCp.option('--token <token>', texts_1.OPTION_REST_API_TOKEN);
 commandSandboxCp.option('--api <url>', texts_1.OPTION_REST_API_ENDPOINT);
 commandSandboxCp.option('--region <region>', texts_1.OPTION_REST_API_REGION);
 commandSandboxCp.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandSandboxCp.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
-commandSandboxCp.option('-s, --silent', texts_1.OPTION_SANDBOX_CP_SILENT);
+commandSandboxCp.option('-m, --merge', texts_1.OPTION_SANDBOX_CP_DOWNLOAD_MERGE);
+commandSandboxCp.option('-r, --replace', texts_1.OPTION_SANDBOX_CP_DOWNLOAD_REPLACE);
 commandSandboxCp.argument('<source>', texts_1.OPTION_SANDBOX_CP_SOURCE);
 commandSandboxCp.argument('<destination>', texts_1.OPTION_SANDBOX_CP_DEST);
-commandSandboxCp.action(async (source, destination, options) => {
-    const workspace = input_1.default.restApiWorkspace(options.workspace);
-    const project = input_1.default.restApiProject(options.project);
-    const client = input_1.default.restApiTokenClient(options.api, options.region, options.token);
+commandSandboxCp.addHelpText('after', texts_1.EXAMPLE_SANDBOX_CP);
+const upload = async (client, workspace, project, source, destination) => {
+    const { sourcePath, sourceStats } = input_1.default.restApiSandboxUploadSourcePath(source);
+    const { identifier, remotePath } = input_1.default.restApiSandboxUploadDestinationPath(destination);
     const result = await client.listSandboxes(workspace, project);
     const sandboxes = result.sandboxes || [];
-    const { identifier, remotePath } = input_1.default.restApiSandboxDestinationPath(destination);
-    const { sourcePath, sourceStats } = input_1.default.restApiSandboxSourcePath(source);
-    const silent = options.silent;
     const found = sandboxes.find((s) => s.identifier === identifier);
     if (!found) {
         output_1.default.exitError(texts_1.ERR_SANDBOX_NOT_FOUND);
     }
     if (sourceStats.isFile()) {
         // Single file copy
-        if (!silent) {
-            output_1.default.gray((0, texts_1.TXT_SANDBOX_CP_PROGRESS)(1, 1, (0, path_1.basename)(sourcePath)));
-        }
-        await client.sandboxUploadFile(workspace, found.id, remotePath, sourcePath);
+        const name = (0, path_1.basename)(sourcePath);
+        output_1.default.normal((0, texts_1.TXT_SANDBOX_CP_PROGRESS)(1, 1, name));
+        const remoteFile = (0, path_1.join)(remotePath, name);
+        await client.sandboxUploadFile(workspace, found.id, remoteFile, sourcePath);
         output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CP_DONE)(1));
     }
     else if (sourceStats.isDirectory()) {
@@ -48,15 +49,13 @@ commandSandboxCp.action(async (source, destination, options) => {
         if (files.length === 0) {
             output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CP_DONE)(0));
         }
-        if (!silent)
-            output_1.default.normal(`Copying ${files.length} file(s)...`);
+        output_1.default.normal('\n', false);
         for (let i = 0; i < files.length; i++) {
             const localFile = files[i];
             const relativePath = (0, path_1.relative)(sourcePath, localFile);
             const remoteFile = (0, path_1.join)(remotePath, relativePath).replace(/\\/g, '/');
-            if (!silent) {
-                output_1.default.gray((0, texts_1.TXT_SANDBOX_CP_PROGRESS)(i + 1, files.length, relativePath));
-            }
+            output_1.default.clearPreviousLine();
+            output_1.default.normal((0, texts_1.TXT_SANDBOX_CP_PROGRESS)(i + 1, files.length, relativePath));
             await client.sandboxUploadFile(workspace, found.id, remoteFile, localFile);
         }
         output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CP_DONE)(files.length));
@@ -64,5 +63,68 @@ commandSandboxCp.action(async (source, destination, options) => {
     else {
         output_1.default.exitError((0, texts_1.ERR_SANDBOX_CP_SOURCE_NOT_FOUND)(source));
     }
+};
+const download = async (client, workspace, project, source, destination, merge, replace) => {
+    const destPath = input_1.default.restApiSandboxDownloadDestinationPath(destination, merge, replace);
+    const { sourcePath, identifier } = input_1.default.restApiSandboxDownloadSourcePath(source);
+    const result = await client.listSandboxes(workspace, project);
+    const sandboxes = result.sandboxes || [];
+    const found = sandboxes.find((s) => s.identifier === identifier);
+    if (!found) {
+        output_1.default.exitError(texts_1.ERR_SANDBOX_NOT_FOUND);
+    }
+    output_1.default.normal(texts_1.TXT_SANDBOX_CP_DOWNLOAD, false);
+    const { body, headers } = await client.sandboxDownloadFile(workspace, found.id, sourcePath);
+    const isFile = headers['content-type'] === 'application/octet-stream';
+    if (isFile) {
+        const name = (0, path_1.basename)(sourcePath);
+        await node_fs_1.default.promises.writeFile((0, path_1.join)(destPath, name), body);
+        output_1.default.clearPreviousLine();
+        output_1.default.normal(texts_1.TXT_SANDBOX_CP_DOWNLOAD_DONE);
+        output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CP_DONE)(1));
+    }
+    else {
+        const zipPath = (0, path_1.join)((0, utils_1.getHomeDirectory)(), `${(0, uuid_1.v4)()}.tar.gz`);
+        const clearZip = () => {
+            try {
+                node_fs_1.default.rmSync(zipPath);
+            }
+            catch {
+                // do nothing
+            }
+        };
+        try {
+            await promises_1.default.pipeline(body, node_fs_1.default.createWriteStream(zipPath));
+            output_1.default.clearPreviousLine();
+            output_1.default.normal(texts_1.TXT_SANDBOX_CP_DOWNLOAD_DONE);
+            output_1.default.normal(texts_1.TXT_SANDBOX_UNZIP);
+            let count = 0;
+            await (0, utils_1.untarGz)(destPath, zipPath, () => {
+                count += 1;
+                output_1.default.clearPreviousLine();
+                output_1.default.normal((0, texts_1.TXT_SANDBOX_UNZIPPING_COUNT)(count));
+            });
+            clearZip();
+            output_1.default.clearPreviousLine();
+            output_1.default.normal(texts_1.TXT_SANDBOX_UNZIP_DONE);
+            output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CP_DONE)(count));
+        }
+        catch {
+            clearZip();
+            output_1.default.exitError(texts_1.ERR_SWW);
+        }
+    }
+};
+commandSandboxCp.action(async (source, destination, options) => {
+    const workspace = input_1.default.restApiWorkspace(options.workspace);
+    const project = input_1.default.restApiProject(options.project);
+    const client = input_1.default.restApiTokenClient(options.api, options.region, options.token);
+    const isUpload = input_1.default.restApiSandboxIsUpload(destination);
+    if (isUpload) {
+        await upload(client, workspace, project, source, destination);
+    }
+    else {
+        await download(client, workspace, project, source, destination, !!options.merge, !!options.replace);
+    }
 });
 exports.default = commandSandboxCp;

package/distTs/src/command/sandbox/create.js

@@ -41,7 +41,7 @@ commandSandboxCreate.option('--app-type <type>', texts_1.OPTION_SANDBOX_APP_TYPE
 commandSandboxCreate.option('--tag <tags...>', texts_1.OPTION_SANDBOX_TAGS);
 commandSandboxCreate.option('--wait-for-running [seconds]', texts_1.OPTION_SANDBOX_WAIT_RUNNING);
 commandSandboxCreate.option('--wait-for-configured [seconds]', texts_1.OPTION_SANDBOX_WAIT_CONFIGURED);
-commandSandboxCreate.option('--wait-for-app [seconds]', texts_1.OPTION_SANDBOX_WAIT_APP);
+commandSandboxCreate.addHelpText('after', texts_1.EXAMPLE_SANDBOX_CREATE);
 commandSandboxCreate.action(async (options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);
@@ -53,7 +53,7 @@ commandSandboxCreate.action(async (options) => {
     const baseName = (0, human_id_1.default)({ separator: '-', capitalize: false });
     const defaultIdentifier = `${baseName}-${timestamp}`;
     const body = {
-        name: options.name || baseName,
+        name: options.name || options.identifier || baseName,
         identifier: options.identifier || defaultIdentifier,
     };
     if (options.snapshot) {
@@ -124,19 +124,6 @@ commandSandboxCreate.action(async (options) => {
             output_1.default.exitError(texts_1.ERR_SANDBOX_SETUP_TIMEOUT);
         }
     }
-    if (options.waitForApp) {
-        output_1.default.normal(texts_1.TXT_SANDBOX_WAITING_APP);
-        const timeout = parseInt(options.waitForApp, 10) || 300;
-        try {
-            const status = await client.sandboxWaitForApp(workspace, sandboxId, timeout);
-            if (status !== utils_1.SANDBOX_APP_STATUS.RUNNING) {
-                output_1.default.exitError(texts_1.ERR_SANDBOX_APP_FAILED);
-            }
-        }
-        catch {
-            output_1.default.exitError(texts_1.ERR_SANDBOX_APP_TIMEOUT);
-        }
-    }
     output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_CREATED)(result.identifier, result.html_url));
 });
 exports.default = commandSandboxCreate;

package/distTs/src/command/sandbox/endpoint/add.js

@@ -10,6 +10,7 @@ const input_1 = __importDefault(require("../../../input"));
 const logger_1 = __importDefault(require("../../../logger"));
 const commandSandboxEndpointAdd = (0, utils_1.getBasicCommandSandboxEndpoint)('add', texts_1.DESC_COMMAND_SANDBOX_ENDPOINT_ADD);
 commandSandboxEndpointAdd.alias('create');
+commandSandboxEndpointAdd.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_SANDBOX_ENDPOINT_CREATE}`);
 commandSandboxEndpointAdd.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);

package/distTs/src/command/sandbox/endpoint/delete.js

@@ -17,6 +17,7 @@ commandSandboxEndpointDelete.option('-p, --project <name>', texts_1.OPTION_REST_
 commandSandboxEndpointDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandSandboxEndpointDelete.argument('<identifier>', texts_1.OPTION_SANDBOX_IDENTIFIER);
 commandSandboxEndpointDelete.argument('<endpoint-name>', texts_1.OPTION_SANDBOX_ENDPOINT_NAME_ARG);
+commandSandboxEndpointDelete.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_SANDBOX_ENDPOINT_DELETE}`);
 commandSandboxEndpointDelete.action(async (identifier, endpointName, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);

package/distTs/src/command/sandbox/endpoint/get.js

@@ -15,6 +15,7 @@ commandSandboxEndpointGet.option('-w, --workspace <domain>', texts_1.OPTION_REST
 commandSandboxEndpointGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandSandboxEndpointGet.argument('<identifier>', texts_1.OPTION_SANDBOX_IDENTIFIER);
 commandSandboxEndpointGet.argument('<endpoint-name>', texts_1.OPTION_SANDBOX_ENDPOINT_NAME_ARG);
+commandSandboxEndpointGet.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_SANDBOX_ENDPOINT_GET}`);
 commandSandboxEndpointGet.action(async (identifier, endpointName, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);