@celonis/content-cli 1.13.1 → 1.14.1

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", "./single-package-export.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";
@@ -33,10 +33,80 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     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.")
@@ -99,7 +169,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             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, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). 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). Omit to run every layer available for the team.")
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -112,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, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). 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). Omit to run every layer available for the team.")
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -184,9 +254,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--force", "Force archive even if the node has dependants", false)
                 .action(this.archiveNode);
             nodesCommand.command("list")
-                .description("List nodes in a specific package version")
+                .description("List nodes in a package. Lists staging nodes by default.")
                 .requiredOption("--packageKey <packageKey>", "Identifier of the package")
-                .requiredOption("--packageVersion <packageVersion>", "Version of the package")
+                .option("--packageVersion <packageVersion>", "Version of the package. If not sent, the staging state of the package will be used.")
                 .option("--limit <limit>", "Limit the number of results returned")
                 .option("--offset <offset>", "Offset for pagination")
                 .option("--withConfiguration", "Include node configuration in the response", false)
@@ -218,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)) {
@@ -345,8 +508,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             });
         }
         listNodes(context, command, options) {
+            var _a;
             return __awaiter(this, void 0, void 0, function* () {
-                yield new node_service_1.NodeService(context).listNodes(options.packageKey, options.packageVersion, options.limit, options.offset, options.withConfiguration, options.json);
+                yield new node_service_1.NodeService(context).listNodes(options.packageKey, (_a = options.packageVersion) !== null && _a !== void 0 ? _a : null, options.limit, options.offset, options.withConfiguration, options.json);
             });
         }
         diffNode(context, command, options) {

package/commands/configuration-management/node-dependency.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", "./api/node-dependency-api", "../../core/utils/file-service", "../../core/utils/logger", "uuid"], factory);
+        define(["require", "exports", "./api/node-dependency-api", "../../core/utils/file-service", "../../core/utils/cui-file-service", "../../core/utils/logger", "uuid"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -21,11 +21,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     exports.NodeDependencyService = void 0;
     const node_dependency_api_1 = require("./api/node-dependency-api");
     const file_service_1 = require("../../core/utils/file-service");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     const logger_1 = require("../../core/utils/logger");
     const uuid_1 = require("uuid");
     class NodeDependencyService {
         constructor(context) {
             this.nodeDependencyApi = new node_dependency_api_1.NodeDependencyApi(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         listNodeDependencies(packageKey, nodeKey, version, jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
@@ -38,8 +40,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(dependencies, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(dependencies, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     if (dependencies.length === 0) {

package/commands/configuration-management/node-diff.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", "node:fs", "uuid", "../../core/utils/logger", "../../core/utils/file-service", "./api/node-diff-api"], factory);
+        define(["require", "exports", "node:fs", "uuid", "../../core/utils/logger", "../../core/utils/file-service", "../../core/utils/cui-file-service", "./api/node-diff-api"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -23,10 +23,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const uuid_1 = require("uuid");
     const logger_1 = require("../../core/utils/logger");
     const file_service_1 = require("../../core/utils/file-service");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     const node_diff_api_1 = require("./api/node-diff-api");
     class NodeDiffService {
         constructor(context) {
             this.nodeDiffApi = new node_diff_api_1.NodeDiffApi(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         diff(packageKey, nodeKey, baseVersion, compareVersion, jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
@@ -37,7 +39,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     compareVersion,
                 });
                 if (jsonResponse) {
-                    this.exportDiffAsJson(nodeDiff);
+                    yield this.exportDiffAsJson(nodeDiff);
                 }
                 else {
                     this.logDiff(nodeDiff);
@@ -53,7 +55,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     file: fs.createReadStream(file),
                 });
                 if (jsonResponse) {
-                    this.exportDiffAsJson(nodeDiff);
+                    yield this.exportDiffAsJson(nodeDiff);
                 }
                 else {
                     this.logDiff(nodeDiff);
@@ -61,9 +63,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             });
         }
         exportDiffAsJson(nodeDiff) {
-            const filename = (0, uuid_1.v4)() + ".json";
-            file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(nodeDiff, null, 2), filename);
-            logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+            return __awaiter(this, void 0, void 0, function* () {
+                const filename = (0, uuid_1.v4)() + ".json";
+                const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(nodeDiff, null, 2), filename);
+                logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
+            });
         }
         logDiff(nodeDiff) {
             logger_1.logger.info(`Package Key: ${nodeDiff.packageKey}`);

package/commands/configuration-management/node.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", "./api/node-api", "../../core/utils/file-service", "../../core/utils/logger", "uuid"], factory);
+        define(["require", "exports", "./api/node-api", "../../core/utils/file-service", "../../core/utils/cui-file-service", "../../core/utils/logger", "uuid"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -21,11 +21,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     exports.NodeService = void 0;
     const node_api_1 = require("./api/node-api");
     const file_service_1 = require("../../core/utils/file-service");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     const logger_1 = require("../../core/utils/logger");
     const uuid_1 = require("uuid");
     class NodeService {
         constructor(context) {
             this.nodeApi = new node_api_1.NodeApi(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         findNode(packageKey, nodeKey, withConfiguration, packageVersion, jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
@@ -34,8 +36,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     : yield this.nodeApi.findStagingNodeByKey(packageKey, nodeKey, withConfiguration);
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     this.printNode(node);
@@ -44,11 +46,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         }
         listNodes(packageKey, packageVersion, limit, offset, withConfiguration, jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
-                const nodes = yield this.nodeApi.findVersionedNodesByPackage(packageKey, packageVersion, withConfiguration, limit, offset);
+                const nodes = packageVersion
+                    ? yield this.nodeApi.findVersionedNodesByPackage(packageKey, packageVersion, withConfiguration, limit, offset)
+                    : yield this.nodeApi.findStagingNodesByPackage(packageKey, withConfiguration, limit, offset);
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(nodes, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(nodes, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     nodes.forEach(node => {
@@ -67,8 +71,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     this.printNode(node);
@@ -85,8 +89,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(node, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     this.printNode(node);

package/commands/configuration-management/package-validation.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", "./api/package-validation-api", "../../core/utils/logger", "../../core/utils/file-service"], factory);
+        define(["require", "exports", "uuid", "./api/package-validation-api", "../../core/utils/logger", "../../core/utils/cui-file-service"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -22,22 +22,28 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const uuid_1 = require("uuid");
     const package_validation_api_1 = require("./api/package-validation-api");
     const logger_1 = require("../../core/utils/logger");
-    const file_service_1 = require("../../core/utils/file-service");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     class PackageValidationService {
         constructor(context) {
             this.packageValidationApi = new package_validation_api_1.PackageValidationApi(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         validatePackage(packageKey, layers, nodeKeys, jsonOutput) {
             return __awaiter(this, void 0, void 0, function* () {
-                const request = { layers };
+                const request = {};
+                // Omitted rather than defaulted here: the API reads an absent "layers" as every layer available for
+                // the team, and rejects an empty list.
+                if (layers && layers.length > 0) {
+                    request.layers = layers;
+                }
                 if (nodeKeys && nodeKeys.length > 0) {
                     request.nodeKeys = nodeKeys;
                 }
                 const response = yield this.packageValidationApi.validatePackage(packageKey, request);
                 if (jsonOutput) {
                     const reportFileName = "config_validate_report_" + (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(response), reportFileName);
-                    logger_1.logger.info("Validation report file: " + reportFileName);
+                    const writtenFileName = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(response), reportFileName);
+                    logger_1.logger.info("Validation report file: " + writtenFileName);
                 }
                 else {
                     this.printValidationResult(response);

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

@@ -13,27 +13,29 @@ 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/utils/file-service", "../../core/utils/logger", "uuid", "./api/package-version-api"], factory);
+        define(["require", "exports", "../../core/utils/file-service", "../../core/utils/cui-file-service", "../../core/utils/logger", "uuid", "./api/package-version-api"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.PackageVersionService = void 0;
     const file_service_1 = require("../../core/utils/file-service");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     const logger_1 = require("../../core/utils/logger");
     const uuid_1 = require("uuid");
     const package_version_api_1 = require("./api/package-version-api");
     class PackageVersionService {
         constructor(context) {
             this.packageVersionApi = new package_version_api_1.PackageVersionApi(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         findPackageVersion(packageKey, version, jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
                 const packageVersionTransport = yield this.packageVersionApi.findOne(packageKey, version);
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(packageVersionTransport, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(packageVersionTransport, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     this.printPackageVersionTransport(packageVersionTransport);
@@ -56,8 +58,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 const created = yield this.packageVersionApi.createVersion(packageKey, request);
                 if (jsonResponse) {
                     const filename = (0, uuid_1.v4)() + ".json";
-                    file_service_1.fileService.writeToFileWithGivenName(JSON.stringify(created, null, 2), filename);
-                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + filename);
+                    const writtenFilename = yield this.cuiFileService.writeToFileWithGivenName(JSON.stringify(created, null, 2), filename);
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + writtenFilename);
                 }
                 else {
                     this.printPackageVersionCreatedTransport(created);

package/commands/configuration-management/single-package-export.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", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-export-api", "node:path"], factory);
+        define(["require", "exports", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-export-api", "../../core/utils/cui-file-service"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -24,11 +24,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     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");
+    const cui_file_service_1 = require("../../core/utils/cui-file-service");
     class SinglePackageExportService {
         constructor(context) {
             this.singlePackageExportApi = new single_package_export_api_1.SinglePackageExportApi(context);
             this.gitService = new git_service_1.GitService(context);
+            this.cuiFileService = new cui_file_service_1.CuiFileService(context);
         }
         exportPackage(packageKey, zip, gitBranch) {
             return __awaiter(this, void 0, void 0, function* () {
@@ -38,13 +39,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     return;
                 }
                 if (zip) {
-                    const fileName = `${packageKey}.zip`;
-                    file_service_1.fileService.writeBufferToFileWithGivenName(packageData, (0, node_path_1.resolve)(process.cwd(), fileName));
+                    const fileName = yield this.cuiFileService.writeZipToFileWithGivenName(packageData, `${packageKey}.zip`);
                     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}`);
+                const directoryName = yield this.cuiFileService.writeDirectoryWithGivenName(targetDir => file_service_1.fileService.extractZipBufferToDirectory(packageData, targetDir), packageKey);
+                logger_1.logger.info(`Successful export. Exported directory: ${directoryName}`);
             });
         }
         exportToGitBranch(packageData, gitBranch) {