@celonis/content-cli 1.12.0 → 1.14.0

package/commands/configuration-management/module.js

@@ -16,7 +16,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../core/command/module-handler", "./config-command.service", "./staging-package.service", "./metadata.service", "../t2tc/t2tc-command.service", "./variable-command.service", "./node.service", "./node-diff.service", "./node-dependency.service", "./package-version-command.service", "./package-validation.service", "./single-package-import.service"], factory);
+        define(["require", "exports", "../../core/command/module-handler", "./config-command.service", "./staging-package.service", "./metadata.service", "../t2tc/t2tc-command.service", "./variable-command.service", "./node.service", "./node-diff.service", "./node-dependency.service", "./package-version-command.service", "./package-validation.service", "./single-package-import.service", "./single-package-export.service", "./branch/branch.command.service", "./branch/branch-export-import.command.service", "../../core/utils/branches"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -32,10 +32,81 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const package_version_command_service_1 = require("./package-version-command.service");
     const package_validation_service_1 = require("./package-validation.service");
     const single_package_import_service_1 = require("./single-package-import.service");
+    const single_package_export_service_1 = require("./single-package-export.service");
+    const branch_command_service_1 = require("./branch/branch.command.service");
+    const branch_export_import_command_service_1 = require("./branch/branch-export-import.command.service");
+    const branches_1 = require("../../core/utils/branches");
     class Module extends module_handler_1.IModule {
         register(context, configurator) {
             const configCommand = configurator.command("config")
                 .description("Manage package configurations and their resources (package, nodes, versions, variables, metadata). Note: 'config list/export/import/diff' are deprecated — bulk Team-to-Team Copy operations have moved to the 't2tc package' group, and single-package operations live under 'config package'.");
+            const branchCommand = configCommand.command("branch").beta()
+                .description("Author, merge, and mirror package branches");
+            const branchSettingsCommand = branchCommand.command("settings").beta()
+                .description("Commands to manage branch settings on a package");
+            branchSettingsCommand.command("set").beta()
+                .description("Configure branch settings on a main package")
+                .requiredOption("--packageKey <packageKey>", "Main package key")
+                .requiredOption("--enabled <enabled>", "true|false")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.setBranchSettings);
+            branchCommand.command("create").beta()
+                .description("Create a new branch from a source version")
+                .requiredOption("--packageKey <packageKey>", "Main package key to branch from")
+                .requiredOption("--branchKey <branchKey>", "New branch key")
+                .requiredOption("--sourceVersion <sourceVersion>", "Source version to branch from. Must be an existing version; 'LATEST' is not supported here")
+                .option("--validate", "Only validate the request without creating the branch", false)
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.createBranch);
+            branchCommand.command("list").beta()
+                .description("List branches of a main package")
+                .requiredOption("--packageKey <packageKey>", "Main package key")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.listBranches);
+            branchCommand.command("delete").beta()
+                .description("Delete a branch")
+                .requiredOption("--packageKey <packageKey>", "Main package key (no '@')")
+                .requiredOption("--branchKey <branchKey>", "Branch key to delete")
+                .action(this.deleteBranch);
+            const branchMergeCommand = branchCommand.command("merge").beta()
+                .description("Commands to preview and apply branch merges");
+            branchMergeCommand.command("preview").beta()
+                .description("Preview the changes a merge would apply to a target branch")
+                .requiredOption("--packageKey <packageKey>", "Target package key (main package key or '<mainPackageKey>@<branchKey>')")
+                .requiredOption("--sourceKey <sourceKey>", "Source package key (main package key or '<mainPackageKey>@<branchKey>')")
+                .requiredOption("--sourceVersion <sourceVersion>", "Source version (or 'LATEST')")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.previewBranchMerge);
+            branchMergeCommand.command("apply").beta()
+                .description("Merge changes from a source into a target branch")
+                .requiredOption("--packageKey <packageKey>", "Target package key (main package key or '<mainPackageKey>@<branchKey>')")
+                .option("-f, --file <file>", "Path to a JSON file containing the MergeBranchTransport payload")
+                .option("--sourceKey <sourceKey>", "Source package key, main package key or '<mainPackageKey>@<branchKey>' (overrides the file's 'sourceKey')")
+                .option("--sourceVersion <sourceVersion>", "Source version (overrides the file's 'sourceVersion'; or 'LATEST')")
+                .option("--bump <bump>", "Version bump for the new published version: PATCH (the default when neither --bump nor --newVersion is given)")
+                .option("--newVersion <newVersion>", "Pin the new published version to an explicit semver")
+                .option("--summary <summary>", "Summary of changes for the new published version")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.applyBranchMerge);
+            branchCommand.command("export").beta()
+                .description("Export a branch's package, rewriting the package.json key to the main package key. Writes an unzipped '<packageKey>' directory by default (or a '<packageKey>.zip' with --zip), or pushes to the Git branch named after --branchKey when --gitProfile is set.")
+                .requiredOption("--packageKey <packageKey>", "Main package key (no '@')")
+                .option("--branchKey <branchKey>", "Branch key to export. The Git branch, when pushing, is named after this value. Mutually exclusive with --all")
+                .option("--all", "Push the main package and every one of its branches to Git. Requires --gitProfile and is mutually exclusive with --branchKey", false)
+                .option("--zip", "Export the branch as a single '<packageKey>.zip' file instead of an unzipped directory (local export only)", false)
+                .option("--gitProfile <gitProfile>", "Git profile to use. When set, the export is pushed to Git instead of written locally")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.exportBranch);
+            branchCommand.command("import").beta()
+                .description("Import a branch's package from a zip file, directory, or Git branch, restoring the package.json key to '<packageKey>@<branchKey>'. Pulls the Git branch named after --branchKey when --gitProfile is set; otherwise reads --file or --directory.")
+                .requiredOption("--packageKey <packageKey>", "Main package key (no '@')")
+                .requiredOption("--branchKey <branchKey>", "Branch key to import into. The Git branch, when pulling, is named after this value")
+                .option("-f, --file <file>", "Package zip file (relative path). Mutually exclusive with --directory and --gitProfile")
+                .option("-d, --directory <directory>", "Package directory (relative path). Mutually exclusive with --file and --gitProfile")
+                .option("--overwrite", "Flag to allow overwriting an existing package with the same key", false)
+                .option("--gitProfile <gitProfile>", "Git profile to use. When set, the package is pulled from Git instead of read locally")
+                .option("--json", "Write response to a JSON file", false)
+                .action(this.importBranch);
             configCommand.command("list")
                 .description("[Deprecated] Use 't2tc package list' instead. List packages in the target team.")
                 .deprecationNotice("'config list' is deprecated and will be removed in a future release. Use 't2tc package list' instead.")
@@ -80,16 +151,25 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             const packageCommand = configCommand.command("package")
                 .description("Commands for working with a single package.");
             packageCommand.command("import")
-                .description("Import a package from a zip file or directory. Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
+                .description("Import a package from a zip file, directory, or Git branch. Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
                 .option("-f, --file <file>", "Package zip file (relative path)")
                 .option("-d, --directory <directory>", "Package directory (relative path)")
                 .option("--overwrite", "Flag to allow overwriting an existing package with the same key")
                 .option("--json", "Return the response as a JSON file")
+                .option("--gitProfile <gitProfile>", "Git profile which you want to use for the Git operations")
+                .option("--gitBranch <gitBranch>", "Git branch from which you want to pull the package and import")
                 .action(this.importSinglePackage);
+            packageCommand.command("export")
+                .description("Export a single package's staging (draft) version to an unzipped directory (or a single zip with --zip, or to a Git branch with --gitBranch). Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
+                .requiredOption("--packageKey <packageKey>", "Key of the package to export")
+                .option("--zip", "Export the package as a single <packageKey>.zip file instead of an unzipped <packageKey> directory", false)
+                .option("--gitProfile <gitProfile>", "Git profile which you want to use for the Git operations")
+                .option("--gitBranch <gitBranch>", "Git branch in which you want to push the exported package")
+                .action(this.exportSinglePackage);
             packageCommand.command("validate")
                 .description("Validate package node configurations")
                 .requiredOption("--packageKey <packageKey>", "Key of the package to validate")
-                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS). Defaults to SCHEMA.", ["SCHEMA"])
+                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). Defaults to SCHEMA.", ["SCHEMA"])
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -102,7 +182,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .description("[Deprecated] Use 'config package validate' instead. Validate package node configurations.")
                 .deprecationNotice("'config validate' is deprecated and will be removed in a future release. Use 'config package validate' instead.")
                 .requiredOption("--packageKey <packageKey>", "Key of the package to validate")
-                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS). Defaults to SCHEMA.", ["SCHEMA"])
+                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). Defaults to SCHEMA.", ["SCHEMA"])
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -208,6 +288,99 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--params <params>", "Variable query params")
                 .action(this.listAssignments);
         }
+        setBranchSettings(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const enabled = String(options.enabled).toLowerCase();
+                if (enabled !== "true" && enabled !== "false") {
+                    throw new Error("Please provide either 'true' or 'false' for --enabled.");
+                }
+                yield new branch_command_service_1.BranchCommandService(context).setBranchingEnabled(options.packageKey, enabled === "true", !!options.json);
+            });
+        }
+        createBranch(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new branch_command_service_1.BranchCommandService(context).createBranch(options.packageKey, options.branchKey, options.sourceVersion, !!options.validate, !!options.json);
+            });
+        }
+        listBranches(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new branch_command_service_1.BranchCommandService(context).listBranches(options.packageKey, !!options.json);
+            });
+        }
+        deleteBranch(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new branch_command_service_1.BranchCommandService(context).deleteBranch(options.packageKey, options.branchKey);
+            });
+        }
+        previewBranchMerge(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new branch_command_service_1.BranchCommandService(context).mergePreview(options.packageKey, options.sourceKey, options.sourceVersion, !!options.json);
+            });
+        }
+        applyBranchMerge(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new branch_command_service_1.BranchCommandService(context).mergeApply(options.packageKey, {
+                    sourceKey: options.sourceKey,
+                    sourceVersion: options.sourceVersion,
+                    file: options.file,
+                    bump: options.bump,
+                    version: options.newVersion,
+                    summary: options.summary,
+                    jsonResponse: !!options.json,
+                });
+            });
+        }
+        exportBranch(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const gitEnabled = !!options.gitProfile;
+                const service = new branch_export_import_command_service_1.BranchExportImportCommandService(context);
+                if (options.all) {
+                    if (options.branchKey) {
+                        throw new Error("Please provide either --branchKey or --all, but not both.");
+                    }
+                    if (!gitEnabled) {
+                        throw new Error("--all pushes to Git and requires a Git profile. Please provide --gitProfile.");
+                    }
+                    yield service.exportAll(options.packageKey, !!options.json);
+                    return;
+                }
+                if (!options.branchKey) {
+                    throw new Error("Please provide --branchKey, or use --all to export every branch.");
+                }
+                if (options.branchKey.toLowerCase() === branches_1.BranchUtils.MAIN_BRANCH_KEY) {
+                    throw new Error(`'${branches_1.BranchUtils.MAIN_BRANCH_KEY}' is a reserved branch key. The main package is exported only with --all.`);
+                }
+                yield service.exportBranch(options.packageKey, options.branchKey, {
+                    zip: !!options.zip,
+                    gitEnabled,
+                    jsonResponse: !!options.json,
+                });
+            });
+        }
+        importBranch(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const gitEnabled = !!options.gitProfile;
+                if (options.branchKey.toLowerCase() === branches_1.BranchUtils.MAIN_BRANCH_KEY) {
+                    throw new Error(`'${branches_1.BranchUtils.MAIN_BRANCH_KEY}' is a reserved branch key. Use 'config package import' to import into the main package.`);
+                }
+                if (gitEnabled && (options.file || options.directory)) {
+                    throw new Error("You cannot use --file or --directory together with --gitProfile. Only one import source can be defined.");
+                }
+                if (!gitEnabled && !options.file && !options.directory) {
+                    throw new Error("You must provide a --file, a --directory, or a --gitProfile option to import a branch.");
+                }
+                if (options.file && options.directory) {
+                    throw new Error("You cannot use both --file and --directory options at the same time. Only one import source can be defined.");
+                }
+                yield new branch_export_import_command_service_1.BranchExportImportCommandService(context).importBranch(options.packageKey, options.branchKey, {
+                    file: options.file,
+                    directory: options.directory,
+                    overwrite: !!options.overwrite,
+                    gitEnabled,
+                    jsonResponse: !!options.json,
+                });
+            });
+        }
         listPackages(context, command, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (options.staging && (options.withDependencies || options.packageKeys || options.keysByVersion || options.variableValue || options.variableType)) {
@@ -271,7 +444,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         }
         importSinglePackage(context, command, options) {
             return __awaiter(this, void 0, void 0, function* () {
-                yield new single_package_import_service_1.SinglePackageImportService(context).importPackage(options.file, options.directory, options.overwrite, options.json);
+                if (options.gitProfile && !options.gitBranch) {
+                    throw new Error("Please specify a branch using --gitBranch when using a Git profile.");
+                }
+                yield new single_package_import_service_1.SinglePackageImportService(context).importPackage(options.file, options.directory, options.overwrite, options.json, options.gitBranch);
+            });
+        }
+        exportSinglePackage(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (options.gitProfile && !options.gitBranch) {
+                    throw new Error("Please specify a branch using --gitBranch when using a Git profile.");
+                }
+                yield new single_package_export_service_1.SinglePackageExportService(context).exportPackage(options.packageKey, options.zip, options.gitBranch);
             });
         }
         diffPackages(context, command, options) {

package/commands/configuration-management/single-package-export.service.js

@@ -0,0 +1,64 @@
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-export-api", "node:path"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SinglePackageExportService = void 0;
+    const fs = require("node:fs");
+    const file_service_1 = require("../../core/utils/file-service");
+    const logger_1 = require("../../core/utils/logger");
+    const git_service_1 = require("../../core/git-profile/git/git.service");
+    const single_package_export_api_1 = require("./api/single-package-export-api");
+    const node_path_1 = require("node:path");
+    class SinglePackageExportService {
+        constructor(context) {
+            this.singlePackageExportApi = new single_package_export_api_1.SinglePackageExportApi(context);
+            this.gitService = new git_service_1.GitService(context);
+        }
+        exportPackage(packageKey, zip, gitBranch) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const packageData = yield this.singlePackageExportApi.exportPackage(packageKey);
+                if (gitBranch) {
+                    yield this.exportToGitBranch(packageData, gitBranch);
+                    return;
+                }
+                if (zip) {
+                    const fileName = `${packageKey}.zip`;
+                    file_service_1.fileService.writeBufferToFileWithGivenName(packageData, (0, node_path_1.resolve)(process.cwd(), fileName));
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + fileName);
+                    return;
+                }
+                file_service_1.fileService.extractZipBufferToDirectory(packageData, packageKey);
+                logger_1.logger.info(`Successful export. Exported directory: ${packageKey}`);
+            });
+        }
+        exportToGitBranch(packageData, gitBranch) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const extractedDirectory = file_service_1.fileService.extractZipBufferToTempDirectory(packageData);
+                try {
+                    yield this.gitService.pushToBranch(extractedDirectory, gitBranch);
+                    logger_1.logger.info("Successfully exported package to branch: " + gitBranch);
+                }
+                finally {
+                    fs.rmSync(extractedDirectory, { recursive: true, force: true });
+                }
+            });
+        }
+    }
+    exports.SinglePackageExportService = SinglePackageExportService;
+});

package/commands/configuration-management/single-package-import.service.js

@@ -13,7 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "uuid", "form-data", "node:stream", "adm-zip", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "./api/single-package-import-api"], factory);
+        define(["require", "exports", "uuid", "form-data", "node:stream", "adm-zip", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-import-api"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -26,23 +26,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const fs = require("node:fs");
     const file_service_1 = require("../../core/utils/file-service");
     const logger_1 = require("../../core/utils/logger");
+    const git_service_1 = require("../../core/git-profile/git/git.service");
     const single_package_import_api_1 = require("./api/single-package-import-api");
     class SinglePackageImportService {
         constructor(context) {
             this.singlePackageImportApi = new single_package_import_api_1.SinglePackageImportApi(context);
+            this.gitService = new git_service_1.GitService(context);
         }
-        importPackage(file, directory, overwrite, jsonResponse) {
+        importPackage(file, directory, overwrite, jsonResponse, gitBranch) {
             return __awaiter(this, void 0, void 0, function* () {
-                const resolvedSource = this.resolveSource(file, directory);
+                if ((file || directory) && gitBranch) {
+                    throw new Error("You cannot use --file or --directory together with --gitBranch. Only one import source can be defined.");
+                }
+                if (!file && !directory && !gitBranch) {
+                    throw new Error("You must provide a --file, a --directory, or a --gitBranch option to import a package.");
+                }
+                let gitTempDir;
                 try {
-                    const packageZip = new AdmZip(resolvedSource.zipPath);
-                    const formData = this.buildBodyForImport(packageZip, resolvedSource.zipPath);
-                    const result = yield this.singlePackageImportApi.importPackage(formData, overwrite);
-                    this.outputResult(result, jsonResponse);
+                    let resolvedSource;
+                    if (gitBranch) {
+                        gitTempDir = yield this.gitService.pullFromBranch(gitBranch);
+                        resolvedSource = { zipPath: file_service_1.fileService.zipDirectoryAsSinglePackage(gitTempDir), isTemporary: true };
+                    }
+                    else {
+                        resolvedSource = this.resolveSource(file, directory);
+                    }
+                    try {
+                        const packageZip = new AdmZip(resolvedSource.zipPath);
+                        const formData = SinglePackageImportService.buildBodyForImport(packageZip, resolvedSource.zipPath);
+                        const result = yield this.singlePackageImportApi.importPackage(formData, overwrite);
+                        this.outputResult(result, jsonResponse);
+                    }
+                    finally {
+                        if (resolvedSource.isTemporary) {
+                            fs.rmSync(resolvedSource.zipPath);
+                        }
+                    }
                 }
                 finally {
-                    if (resolvedSource.isTemporary) {
-                        fs.rmSync(resolvedSource.zipPath);
+                    if (gitTempDir) {
+                        fs.rmSync(gitTempDir, { recursive: true, force: true });
                     }
                 }
             });
@@ -51,9 +74,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             if (file && directory) {
                 throw new Error("You cannot use both --file and --directory options at the same time. Only one import source can be defined.");
             }
-            if (!file && !directory) {
-                throw new Error("You must provide either a --file or a --directory option to import a package.");
-            }
             if (file) {
                 if (file_service_1.fileService.isDirectory(file)) {
                     throw new Error("The --file option accepts only zip files.");
@@ -65,19 +85,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             }
             return { zipPath: file_service_1.fileService.zipDirectoryAsSinglePackage(directory), isTemporary: true };
         }
-        buildBodyForImport(packageZip, sourcePath) {
-            this.assertUncompressedSizeWithinLimit(packageZip, sourcePath);
+        static buildBodyForImport(packageZip, sourcePath) {
+            SinglePackageImportService.assertUncompressedSizeWithinLimit(packageZip, sourcePath);
             const formData = new FormData();
-            formData.append("packageFile", this.getReadableStream(packageZip), { filename: "package.zip" });
+            formData.append("packageFile", SinglePackageImportService.getReadableStream(packageZip), { filename: "package.zip" });
             return formData;
         }
-        assertUncompressedSizeWithinLimit(packageZip, sourcePath) {
+        static assertUncompressedSizeWithinLimit(packageZip, sourcePath) {
             const totalUncompressedBytes = packageZip.getEntries().reduce((sum, entry) => sum + entry.header.size, 0);
             if (totalUncompressedBytes > SinglePackageImportService.MAX_UNCOMPRESSED_ZIP_SIZE) {
                 throw new Error(`Failed to handle zip file "${sourcePath}": uncompressed size ${(totalUncompressedBytes / (Math.pow(1024, 3))).toFixed(2)} GB exceeds the 4 GB limit.`);
             }
         }
-        getReadableStream(packageZip) {
+        static getReadableStream(packageZip) {
             return new node_stream_1.Readable({
                 read() {
                     this.push(packageZip.toBuffer());

package/commands/configuration-management/variable.service.js

@@ -84,25 +84,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         }
         getVersionedVariablesByKeyVersionPairs(keysByVersion, keysByVersionFile) {
             return __awaiter(this, void 0, void 0, function* () {
-                const variablesExportRequest = yield this.buildKeyVersionPairs(keysByVersion, keysByVersionFile);
+                const variablesExportRequest = this.buildKeyVersionPairs(keysByVersion, keysByVersionFile);
                 const variableManifests = yield this.variableApi.findVariablesWithValuesByPackageKeysAndVersion(variablesExportRequest);
                 return (0, connection_variable_helper_1.fixConnectionVariables)(variableManifests);
             });
         }
         buildKeyVersionPairs(keysByVersion, keysByVersionFile) {
-            return __awaiter(this, void 0, void 0, function* () {
-                let variablesExportRequest = [];
-                if (keysByVersion.length !== 0) {
-                    variablesExportRequest = this.buildKeyAndVersionPairsFromArrayInput(keysByVersion);
-                }
-                else if (keysByVersion.length === 0 && keysByVersionFile !== "") {
-                    variablesExportRequest = yield file_service_1.fileService.readFileToJson(keysByVersionFile);
-                }
-                else {
-                    throw new logger_1.FatalError("Please provide keysByVersion mappings or file path!");
-                }
-                return variablesExportRequest;
-            });
+            let variablesExportRequest = [];
+            if (keysByVersion.length !== 0) {
+                variablesExportRequest = this.buildKeyAndVersionPairsFromArrayInput(keysByVersion);
+            }
+            else if (keysByVersion.length === 0 && keysByVersionFile !== "") {
+                variablesExportRequest = file_service_1.fileService.readFileToJson(keysByVersionFile);
+            }
+            else {
+                throw new logger_1.FatalError("Please provide keysByVersion mappings or file path!");
+            }
+            return variablesExportRequest;
         }
         buildKeyAndVersionPairsFromArrayInput(keysByVersion) {
             return keysByVersion.map(keyAndVersion => {

package/commands/data-pipeline/connection/connection.commands.js

@@ -30,13 +30,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .description("Command to list all connections in a Data Pool")
                 .requiredOption("--dataPoolId <dataPoolId>", "ID of the data pool")
                 .action(this.listConnections);
-            const getCommand = configurator.command("get");
+            const getCommand = configurator.command("get")
+                .description("get data pool connection");
             getCommand.command("connection")
                 .description("Programmatically read properties of your connections")
                 .requiredOption("--dataPoolId <dataPoolId>", "Id of the data pool you want to update")
                 .requiredOption("--connectionId <connectionId>", "Id of the connection you want to update")
                 .action(this.getCommandProperties);
-            const setCommand = configurator.command("set");
+            const setCommand = configurator.command("set")
+                .description("set data pool connection");
             setCommand.command("connection")
                 .description("Programmatically update properties of your connections")
                 .requiredOption("--dataPoolId <dataPoolId>", "Id of the data pool you want to update")

package/commands/data-pipeline/data-pool/data-pool.commands.js

@@ -52,7 +52,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             pushCommand.command("data-pools")
                 .description("Command to push data pools")
                 .action(this.pushDataPools);
-            const updateCommand = configurator.command("update");
+            const updateCommand = configurator.command("update")
+                .description("Update data pool");
             updateCommand.command("data-pool")
                 .description("Command to update a data pool using a data pool configuration file")
                 .requiredOption("--id <id>", "Id of the data pool you want to update")

package/commands/deployment/module.js

@@ -21,9 +21,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const deployment_service_1 = require("./deployment.service");
     class Module extends module_handler_1.IModule {
         register(context, configurator) {
-            const deploymentCommand = configurator.command("deployment").beta();
+            const deploymentCommand = configurator.command("deployment")
+                .description("Create deployments, list their history, check active deployments, and retrieve deployables and targets");
             deploymentCommand.command("create")
-                .beta()
                 .description("Create a new deployment")
                 .requiredOption("--packageKey <packageKey>", "Identifier of the package to deploy")
                 .requiredOption("--packageVersion <packageVersion>", "Version of the package to deploy")
@@ -31,9 +31,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .requiredOption("--targetId <targetId>", "Identifier of the target to deploy to")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.createDeployment);
-            const listCommand = deploymentCommand.command("list").beta();
+            const listCommand = deploymentCommand.command("list")
+                .description("List deployment history, active deployments, deployables or targets");
             listCommand.command("history")
-                .beta()
                 .description("List deployment history")
                 .option("--packageKey <packageKey>", "Filter deployment history by package key")
                 .option("--targetId <targetId>", "Filter deployment history by target ID")
@@ -45,7 +45,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--json", "Return the response as a JSON file")
                 .action(this.listDeploymentHistory);
             listCommand.command("active")
-                .beta()
                 .description("Get the active deployment(s) for a given target or package.\n" +
                 "You can use the command to list the active deployment(s) for a specific target or for a specific package.\n" +
                 "The targetIds filter is available only for getting the active deployments for a given package. \n" +
@@ -58,13 +57,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--json", "Return the response as a JSON file")
                 .action(this.listActiveDeployments);
             listCommand.command("deployables")
-                .beta()
                 .description("List all deployables")
                 .option("--flavor <flavor>", "Filter deployables by flavor")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.listDeployables);
             listCommand.command("targets")
-                .beta()
                 .description("List all targets for a given deployable type and package key")
                 .requiredOption("--deployableType <deployableType>", "The type of the deployable")
                 .requiredOption("--packageKey <packageKey>", "Identifier of the package to list targets for")

package/commands/studio/manager/package.manager.js

@@ -93,7 +93,7 @@
         validateOptions() {
             if (this.newKey && this.overwrite) {
                 logger_1.logger.error("You cannot overwrite a package and set a new key at the same time. Please use only one of the options.");
-                process.exit();
+                process.exit(1);
             }
         }
         getPushUrlWithParams(pushUrl) {

package/commands/studio/module.js

@@ -29,7 +29,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         register(context, configurator) {
             const listCommand = configurator.command("list");
             listCommand.command("packages")
-                .description("Command to list all packages")
+                .description("[Deprecated] Use 'config package list' instead. Command to list all packages")
+                .deprecationNotice("'list packages' is deprecated and will be removed in a future release. Use 'config package list' instead.")
                 .option("--json", "Return response as json type", "")
                 .option("--includeDependencies", "Include variables and dependencies", "")
                 .option("--packageKeys <packageKeys...>", "Lists only given package keys")
@@ -49,7 +50,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .requiredOption("--key <key>", "Key of asset you want to pull")
                 .action(this.pullAsset);
             pullCommand.command("package")
-                .description("Command to pull a package")
+                .description("[Deprecated] Use 'config package export' instead. Command to pull a package")
+                .deprecationNotice("'pull package' is deprecated and will be removed in a future release. Use 'config package export' instead.")
                 .requiredOption("--key <key>", "Key of the package you want to pull")
                 .option("--store", "Pull package with store deployment metadata")
                 .option("--newKey <newKey>", "Define a new key for your package")
@@ -66,14 +68,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .requiredOption("--package <packageKey>", "Key of the package you want to push assets to")
                 .action(this.pushAssets);
             pushCommand.command("package")
-                .description("Command to push a package to Studio")
+                .description("[Deprecated] Use 'config package import' instead. Command to push a package to Studio")
+                .deprecationNotice("'push package' is deprecated and will be removed in a future release. Use 'config package import' instead.")
                 .option("--newKey <newKey>", "Define a new key for your package")
                 .option("--overwrite", "Overwrite package and its assets")
                 .requiredOption("-f, --file <file>", "The file you want to push")
                 .requiredOption("--spaceKey <spaceKey>", "The key of the destination space")
                 .action(this.pushPackage);
             pushCommand.command("packages")
-                .description("Command to push packages to Studio")
+                .description("[Deprecated] Use 'config package import' (single package) instead. Command to push packages to Studio")
+                .deprecationNotice("'push packages' is deprecated and will be removed in a future release. Use 'config package import' (single package) instead.")
                 .requiredOption("--spaceKey <spaceKey>", "The key of the destination space")
                 .action(this.pushPackages);
             pushCommand.command("widget")

package/commands/t2tc/module.js

@@ -38,7 +38,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--staging", "List staging packages instead", false)
                 .action(this.listPackages);
             t2tcPackageCommand.command("export")
-                .description("Export one or more packages into a Team-to-Team Copy archive. The archive is consumed by 't2tc package import' / 't2tc package diff'.")
+                .description("Export one or more packages into a Team-to-Team Copy archive. The archive is consumed by 't2tc package import' / 't2tc package diff'. To export a single standalone package, use 'config package export'.")
                 .option("--packageKeys <packageKeys...>", "Keys of packages to export. Exports the latest deployed version only")
                 .option("--keysByVersion <keysByVersion...>", "Keys of packages to export by version")
                 .option("--withDependencies", "Include variables and dependencies", "")