@celonis/content-cli 1.12.0 → 1.14.0

package/commands/t2tc/t2tc-package.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", "stream", "adm-zip", "./batch-export-import.constants", "../../core/utils/file-service", "../../core/utils/logger", "../../core/utils/json", "../studio/api/package-api", "./api/t2tc-package-api", "../configuration-management/api/variable-api", "../configuration-management/connection-variable.helper", "./studio.service", "../../core/git-profile/git/git.service", "fs", "../../core/utils/file.constants"], factory);
+        define(["require", "exports", "uuid", "form-data", "stream", "adm-zip", "./batch-export-import.constants", "../../core/utils/file-service", "../../core/utils/logger", "../../core/utils/json", "../studio/api/package-api", "./api/t2tc-package-api", "../configuration-management/api/variable-api", "../configuration-management/connection-variable.helper", "./studio.service", "../../core/git-profile/git/git.service", "fs", "../../core/utils/file.constants", "node:path"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -35,6 +35,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const git_service_1 = require("../../core/git-profile/git/git.service");
     const fs = require("fs");
     const file_constants_1 = require("../../core/utils/file.constants");
+    const node_path_1 = require("node:path");
     class T2tcPackageService {
         constructor(context) {
             this.t2tcPackageApi = new t2tc_package_api_1.T2tcPackageApi(context);
@@ -138,7 +139,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 const postPackageImportData = yield this.t2tcPackageApi.importPackages(formData, overwrite, performValidation);
                 yield this.studioService.processImportedPackages(configs, existingStudioPackages, studioManifests);
                 if (gitBranch) {
-                    fs.rmSync(temporaryGitFolder, { recursive: true });
+                    fs.rmSync(temporaryGitFolder, { recursive: true, force: true });
                 }
                 fs.rmSync(sourceToBeImported);
                 const reportFileName = "config_import_report_" + (0, uuid_1.v4)() + ".json";
@@ -229,7 +230,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             else {
                 const fileDownloadedMessage = "File downloaded successfully. New filename: ";
                 const filename = `export_${(0, uuid_1.v4)()}.zip`;
-                exportedZip.writeZip(filename, () => fs.chmodSync(filename, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
+                const fullFilePath = (0, node_path_1.resolve)(process.cwd(), filename);
+                exportedZip.writeZip(fullFilePath, () => fs.chmodSync(fullFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
                 logger_1.logger.info(fileDownloadedMessage + filename);
             }
         }

package/content-cli.js

@@ -19,6 +19,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.createProgram = void 0;
     const semverSatisfies = require("semver/functions/satisfies");
     const commander_1 = require("commander");
     const module_handler_1 = require("./core/command/module-handler");
@@ -31,61 +32,90 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
      *
      * This is the main entry point for the CLI.
      */
-    // Check if the Node.js version satisfies the minimum requirements
     const requiredVersion = ">=10.10.0";
-    if (!semverSatisfies(process.version, requiredVersion)) {
-        logger_1.logger.error(`Node version ${process.version} not supported. Please upgrade your node version to ${requiredVersion}`);
-        process.exit(1);
-    }
-    // Global configuration options
-    const program = new commander_1.Command();
-    program.configureHelp({
-        formatHelp: (cmd, helper) => new CustomHelp_1.ContentCLIHelp().formatHelp(cmd, helper),
-        subcommandTerm: cmd => new CustomHelp_1.ContentCLIHelp().subcommandTerm(cmd),
-        optionTerm: opt => new CustomHelp_1.ContentCLIHelp().optionTerm(opt),
-    });
-    program.version(version_1.VersionUtils.getCurrentCliVersion());
-    program.option("-q, --quietmode", "Reduce output to a minimum", false);
-    program.option("-p, --profile [profile]");
-    program.option("--gitProfile [gitProfile]", "Git profile to use");
-    program.option("--debug", "Print debug messages", false);
-    program.option("--dev", "Development Mode", false);
-    program.parseOptions(process.argv);
-    if (!program.opts().quietmode) {
-        console.log(`Content CLI - (C) Copyright 2025 - Celonis SE - Version ${version_1.VersionUtils.getCurrentCliVersion()}`);
-        console.log();
+    function addDefaultOptions(program) {
+        program.option("-q, --quietmode", "Reduce output to a minimum", false);
+        program.option("-p, --profile [profile]");
+        program.option("--gitProfile [gitProfile]", "Git profile to use");
+        program.option("--debug", "Print debug messages", false);
+        program.option("--dev", "Development Mode", false);
     }
-    if (program.opts().debug) {
-        logger_1.logger.transports.forEach(t => {
-            t.level = "debug";
+    /**
+     * Build a fully-configured Commander program without parsing argv
+     */
+    function createProgram(context, opts = {}) {
+        var _a;
+        const program = new commander_1.Command();
+        program.configureHelp({
+            formatHelp: (cmd, helper) => new CustomHelp_1.ContentCLIHelp().formatHelp(cmd, helper),
+            subcommandTerm: cmd => new CustomHelp_1.ContentCLIHelp().subcommandTerm(cmd),
+            optionTerm: opt => new CustomHelp_1.ContentCLIHelp().optionTerm(opt),
         });
+        program.version(version_1.VersionUtils.getCurrentCliVersion());
+        addDefaultOptions(program);
+        const moduleHandler = new module_handler_1.ModuleHandler(program, context);
+        configureRootCommands(moduleHandler.configurator);
+        if (opts.modules) {
+            for (const moduleClass of opts.modules) {
+                const moduleInstance = new moduleClass();
+                moduleInstance.register(context, moduleHandler.configurator);
+            }
+        }
+        else {
+            const rootPath = __dirname;
+            const devMode = (_a = opts.devMode) !== null && _a !== void 0 ? _a : !!program.opts().dev;
+            moduleHandler.discoverAndRegisterModules(rootPath, devMode);
+        }
+        return program;
     }
+    exports.createProgram = createProgram;
     /**
      * To support the legacy command structure, we have to configure some root commands
      * that the individual modules will extend.
      */
     function configureRootCommands(configurator) {
-        configurator.command("list")
-            .description("Commands to list content.")
-            .alias("ls");
+        configurator.command("list").description("Commands to list content.").alias("ls");
+        configurator.command("export").description("Export resource: action flow or data pool");
+        configurator.command("import").description("Import resource: action flow or data pool");
+        configurator.command("pull").description("Pull resource: skill, bookmark, view bookmark, data pool or asset");
+        configurator.command("push").description("Push resource: asset, skill, bookmark, view bookmark, CTP or data pool");
     }
     function run() {
         return __awaiter(this, void 0, void 0, function* () {
-            const context = new cli_context_1.Context(program.opts());
+            if (!semverSatisfies(process.version, requiredVersion)) {
+                logger_1.logger.error(`Node version ${process.version} not supported. Please upgrade your node version to ${requiredVersion}`);
+                process.exit(1);
+            }
+            // Parse global options up-front so banner/debug-level decisions can use
+            // them before module discovery runs.
+            const bootstrapProgram = new commander_1.Command();
+            addDefaultOptions(bootstrapProgram);
+            bootstrapProgram.allowUnknownOption(true);
+            bootstrapProgram.parseOptions(process.argv);
+            const globalOpts = bootstrapProgram.opts();
+            if (!globalOpts.quietmode) {
+                console.log(`Content CLI - (C) Copyright 2025 - Celonis SE - Version ${version_1.VersionUtils.getCurrentCliVersion()}`);
+                console.log();
+            }
+            if (globalOpts.debug) {
+                logger_1.logger.transports.forEach(t => {
+                    t.level = "debug";
+                });
+            }
+            const context = new cli_context_1.Context(globalOpts);
             yield context.init();
-            const moduleHandler = new module_handler_1.ModuleHandler(program, context);
-            configureRootCommands(moduleHandler.configurator);
-            moduleHandler.discoverAndRegisterModules(__dirname, program.opts().dev);
+            const program = createProgram(context, { devMode: !!globalOpts.dev });
             try {
-                program.parse(process.argv);
+                yield program.parseAsync(process.argv);
             }
             catch (error) {
                 logger_1.logger.error(`An unexpected error occurred: ${error}`);
             }
         });
     }
-    run();
-    // catch uncaught exceptions
+    if (require.main === module) {
+        run();
+    }
     process.on("uncaughtException", (error, origin) => {
         console.error("\n💥 UNCAUGHT EXCEPTION!\n");
         console.error("Error:", error);

package/core/command/module-handler.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", "path", "fs", "commander", "../utils/logger", "chalk"], factory);
+        define(["require", "exports", "path", "fs", "commander", "../utils/logger", "../feature-flag/feature-disabled-error", "chalk"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -23,6 +23,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const fs = require("fs");
     const commander_1 = require("commander");
     const logger_1 = require("../utils/logger");
+    const feature_disabled_error_1 = require("../feature-flag/feature-disabled-error");
     const chalk = require("chalk");
     class IModule {
     }
@@ -200,7 +201,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     yield handler(this.ctx, this.cmd, this.cmd.optsWithGlobals());
                 }
                 catch (error) {
+                    if (error instanceof logger_1.GracefulError) {
+                        logger_1.logger.error(error.message);
+                        return;
+                    }
+                    // Backend gates early-access features; translate its "feature disabled"
+                    // rejection into a clear message instead of a raw error.
+                    if ((0, feature_disabled_error_1.isFeatureDisabledError)(error)) {
+                        logger_1.logger.error(`'${this.cmd.name()}' is not enabled for your team. Contact support to request access.`);
+                        return;
+                    }
                     logger_1.logger.error(`An unexpected error occured executing a command: ${error}`);
+                    process.exitCode = 1;
                 }
             }));
         }

package/core/feature-flag/feature-disabled-error.js

@@ -0,0 +1,52 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.isFeatureDisabledError = exports.FEATURE_DISABLED_CODE = void 0;
+    /**
+     * Recognizes the backend's "feature not enabled" response so the CLI can surface a
+     * clear message instead of a raw error. Enforcement stays entirely in the backend
+     * (pacman); the CLI only translates the response — it never decides entitlement.
+     *
+     * The backend rejects a flag-gated request with 403 and a machine-readable body:
+     * {"errorCode":"feature-disabled", ...} (pacman's standard ErrorTransport). Keying
+     * off the stable code (rather than a free-text message) keeps this robust.
+     */
+    exports.FEATURE_DISABLED_CODE = "feature-disabled";
+    /**
+     * True when the given error represents a backend "feature disabled" rejection.
+     * HttpClient rejects with the stringified response body (often wrapped as
+     * "FatalError: {json}"), so we extract and parse the embedded JSON payload.
+     */
+    function isFeatureDisabledError(error) {
+        return extractErrorCode(error) === exports.FEATURE_DISABLED_CODE;
+    }
+    exports.isFeatureDisabledError = isFeatureDisabledError;
+    function extractErrorCode(error) {
+        let text = "";
+        if (error instanceof Error) {
+            text = error.message;
+        }
+        else if (typeof error === "string") {
+            text = error;
+        }
+        const jsonStart = text.indexOf("{");
+        if (jsonStart === -1) {
+            return undefined;
+        }
+        try {
+            const payload = JSON.parse(text.slice(jsonStart));
+            return typeof payload.errorCode === "string" ? payload.errorCode : undefined;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+});

package/core/utils/branches.js

@@ -17,7 +17,17 @@
             }
             return packageKey.includes(BranchUtils.BRANCH_SEPARATOR);
         }
+        static constructBranchKey(projectKey, branchKey) {
+            return `${projectKey}${BranchUtils.BRANCH_SEPARATOR}${branchKey}`;
+        }
+        static extractProjectKey(packageKey) {
+            if (!BranchUtils.isBranchPackageKey(packageKey)) {
+                return packageKey;
+            }
+            return packageKey.substring(0, packageKey.indexOf(BranchUtils.BRANCH_SEPARATOR));
+        }
     }
     exports.BranchUtils = BranchUtils;
+    BranchUtils.MAIN_BRANCH_KEY = "main";
     BranchUtils.BRANCH_SEPARATOR = "@";
 });

package/core/utils/file-service.js

@@ -1,12 +1,3 @@
-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);
@@ -33,12 +24,28 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 mode: file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS,
             });
         }
-        readFileToJson(fileName) {
-            return __awaiter(this, void 0, void 0, function* () {
-                const fileContent = this.readFile(fileName);
-                return JSON.parse(fileContent);
+        writeBufferToFileWithGivenName(data, filename) {
+            fs.writeFileSync(path.resolve(process.cwd(), filename), data, {
+                mode: file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS,
             });
         }
+        extractZipBufferToDirectory(data, targetDir) {
+            const targetPath = path.resolve(process.cwd(), targetDir);
+            this.mkdirRecursive(targetPath);
+            new AdmZip(data).extractAllTo(targetPath, true, true);
+            this.restrictFilePermissions(targetPath);
+        }
+        extractZipBufferToTempDirectory(data) {
+            const tempDir = path.join(os.tmpdir(), `content-cli-${(0, uuid_1.v4)()}`);
+            this.mkdirRecursive(tempDir);
+            new AdmZip(data).extractAllTo(tempDir, true, true);
+            this.restrictFilePermissions(tempDir);
+            return tempDir;
+        }
+        readFileToJson(fileName) {
+            const fileContent = this.readFile(fileName);
+            return JSON.parse(fileContent);
+        }
         readFile(filename) {
             if (!fs.existsSync(path.resolve(process.cwd(), filename))) {
                 logger_1.logger.error(new logger_1.FatalError(`The provided file '${filename}' does not exit`));
@@ -50,7 +57,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             return this.extractExportedZipWithNestedZipsToDir(zipFile, tempDir);
         }
         extractExportedZipWithNestedZipsToDir(zipFile, targetDir) {
-            fs.mkdirSync(targetDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(targetDir);
             zipFile.extractAllTo(targetDir, true, true);
             const files = fs.readdirSync(targetDir);
             for (const file of files) {
@@ -58,7 +65,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 if (file.endsWith(".zip")) {
                     const nestedZip = new AdmZip(innerZipPath);
                     const nestedDir = innerZipPath.replace(/\.zip$/, "");
-                    fs.mkdirSync(nestedDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+                    this.mkdirRecursive(nestedDir);
                     nestedZip.extractAllTo(nestedDir, true, true);
                     fs.rmSync(innerZipPath); // Optionally remove the inner zip
                 }
@@ -90,7 +97,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
             });
             const tempDir = path.join(os.tmpdir(), "content-cli-exports");
-            fs.mkdirSync(tempDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(tempDir);
             const zipFilePath = path.join(tempDir, `export_${(0, uuid_1.v4)()}.zip`);
             finalZip.writeZip(zipFilePath, () => fs.chmodSync(zipFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
             return zipFilePath;
@@ -102,7 +109,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             const zip = new AdmZip();
             zip.addLocalFolder(sourceDir);
             const tempDir = path.join(os.tmpdir(), "content-cli-imports");
-            fs.mkdirSync(tempDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(tempDir);
             const zipFilePath = path.join(tempDir, `single_package_${(0, uuid_1.v4)()}.zip`);
             zip.writeZip(zipFilePath, () => fs.chmodSync(zipFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
             return zipFilePath;
@@ -110,6 +117,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         getSerializedFileContent(data) {
             return data;
         }
+        mkdirRecursive(dir) {
+            fs.mkdirSync(dir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+        }
         restrictFilePermissions(targetDir) {
             var _a;
             const files = fs.readdirSync(targetDir);

package/lib/commands/asset-registry/asset-registry-api.d.ts

@@ -1,12 +1,13 @@
 import { Context } from "../../core/command/cli-context";
-import { AgentSkillsResponse, AssetRegistryDescriptor, AssetRegistryMetadata } from "./asset-registry.interfaces";
+import { AssetRegistryDescriptor, AssetRegistryMetadata } from "./asset-registry.interfaces";
 export declare class AssetRegistryApi {
-    private httpClient;
+    private static readonly BASE_URL;
+    private readonly httpClient;
     constructor(context: Context);
     listTypes(): Promise<AssetRegistryMetadata>;
-    listSkills(): Promise<AgentSkillsResponse>;
     getType(assetType: string): Promise<AssetRegistryDescriptor>;
     getSchema(assetType: string): Promise<any>;
     getExamples(assetType: string): Promise<any>;
     validate(assetType: string, body: any): Promise<any>;
+    private static endpointUrl;
 }

package/lib/commands/asset-registry/asset-registry.interfaces.d.ts

@@ -36,15 +36,3 @@ export interface ValidateOptions {
     file?: string;
     json: boolean;
 }
-export interface AgentSkillMetadata {
-    version: string;
-}
-export interface AgentSkill {
-    name: string;
-    description: string;
-    path: string;
-    metadata: AgentSkillMetadata;
-}
-export interface AgentSkillsResponse {
-    skills: AgentSkill[];
-}

package/lib/commands/asset-registry/asset-registry.service.d.ts

@@ -1,10 +1,9 @@
 import { ValidateOptions } from "./asset-registry.interfaces";
 import { Context } from "../../core/command/cli-context";
 export declare class AssetRegistryService {
-    private api;
+    private readonly api;
     constructor(context: Context);
     listTypes(jsonResponse: boolean): Promise<void>;
-    listSkills(jsonResponse: boolean): Promise<void>;
     getType(assetType: string, jsonResponse: boolean): Promise<void>;
     getSchema(assetType: string, jsonResponse: boolean): Promise<void>;
     getExamples(assetType: string, jsonResponse: boolean): Promise<void>;
@@ -14,6 +13,5 @@ export declare class AssetRegistryService {
     private parseJson;
     private outputResponse;
     private logDescriptorSummary;
-    private logSkillSummary;
     private logDescriptorDetail;
 }

package/lib/commands/asset-registry/module.d.ts

@@ -7,6 +7,5 @@ declare class Module extends IModule {
     private getSchema;
     private validate;
     private getExamples;
-    private listSkills;
 }
 export = Module;

package/lib/commands/bookmarks/bookmarks-api.d.ts

@@ -0,0 +1,8 @@
+import { Context } from "../../core/command/cli-context";
+import { BookmarksExport, BookmarksImportRequest, BookmarksImportResult } from "./bookmarks.interfaces";
+export declare class BookmarksApi {
+    private readonly httpClient;
+    constructor(context: Context);
+    exportBookmarks(packageKey: string): Promise<BookmarksExport>;
+    importBookmarks(packageKey: string, payload: BookmarksImportRequest): Promise<BookmarksImportResult>;
+}

package/lib/commands/bookmarks/bookmarks-command.service.d.ts

@@ -0,0 +1,7 @@
+import { Context } from "../../core/command/cli-context";
+export declare class BookmarksCommandService {
+    private readonly bookmarksApi;
+    constructor(context: Context);
+    exportBookmarks(packageKey: string, file?: string): Promise<void>;
+    importBookmarks(packageKey: string, file: string): Promise<void>;
+}

package/lib/commands/bookmarks/bookmarks.interfaces.d.ts

@@ -0,0 +1,34 @@
+export interface BookmarkEntry {
+    assetKey: string;
+    assetType: string;
+    bookmark: BookmarkDetails;
+    preference: BookmarkPreference;
+}
+export interface BookmarkDetails {
+    name: string;
+    ownerId: string;
+    sharedByLink: boolean;
+    published: boolean;
+}
+export interface BookmarkPreference {
+    configuration: string;
+    shareable: boolean;
+    mode: string;
+    userId: string;
+}
+export interface BookmarksExport {
+    packageKey: string;
+    entries: BookmarkEntry[];
+}
+export interface BookmarksImportRequest {
+    entries: BookmarkEntry[];
+}
+export interface BookmarksImportResultEntry {
+    assetKey: string;
+    status: string;
+    reason: string | null;
+}
+export interface BookmarksImportResult {
+    packageKey: string;
+    entries: BookmarksImportResultEntry[];
+}

package/lib/commands/bookmarks/module.d.ts

@@ -0,0 +1,8 @@
+import { Configurator, IModule } from "../../core/command/module-handler";
+import { Context } from "../../core/command/cli-context";
+declare class Module extends IModule {
+    register(context: Context, configurator: Configurator): void;
+    private exportBookmarks;
+    private importBookmarks;
+}
+export = Module;

package/lib/commands/configuration-management/api/single-package-export-api.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+import { Context } from "../../../core/command/cli-context";
+export declare class SinglePackageExportApi {
+    private readonly httpClient;
+    constructor(context: Context);
+    exportPackage(packageKey: string): Promise<Buffer>;
+}

package/lib/commands/configuration-management/branch/api/branch.api.d.ts

@@ -0,0 +1,12 @@
+import { Context } from "../../../../core/command/cli-context";
+import { BranchingSettingsTransport, BranchTransport, CreateBranchTransport, MergeBranchTransport, MergePreviewRequestTransport, MergePreviewTransport, PackageVersionCreatedTransport } from "../interfaces/branch.interfaces";
+export declare class BranchApi {
+    private readonly httpClient;
+    constructor(context: Context);
+    configureBranchingSettings(packageKey: string, transport: BranchingSettingsTransport): Promise<BranchingSettingsTransport>;
+    createBranch(packageKey: string, transport: CreateBranchTransport, validate?: boolean): Promise<BranchTransport | void>;
+    listBranches(packageKey: string): Promise<BranchTransport[]>;
+    mergePreview(packageKey: string, transport: MergePreviewRequestTransport): Promise<MergePreviewTransport>;
+    merge(packageKey: string, transport: MergeBranchTransport): Promise<PackageVersionCreatedTransport>;
+    deleteBranch(branchPackageKey: string): Promise<void>;
+}

package/lib/commands/configuration-management/branch/branch-export-import.command.service.d.ts

@@ -0,0 +1,36 @@
+import { Context } from "../../../core/command/cli-context";
+export interface BranchExportOptions {
+    zip?: boolean;
+    gitEnabled?: boolean;
+    jsonResponse?: boolean;
+}
+export interface BranchImportOptions {
+    file?: string;
+    directory?: string;
+    overwrite?: boolean;
+    gitEnabled?: boolean;
+    jsonResponse?: boolean;
+}
+export declare class BranchExportImportCommandService {
+    private readonly singlePackageExportApi;
+    private readonly singlePackageImportApi;
+    private readonly branchApi;
+    private readonly gitService;
+    constructor(context: Context);
+    exportBranch(packageKey: string, branchKey: string, options?: BranchExportOptions): Promise<void>;
+    exportAll(packageKey: string, jsonResponse?: boolean): Promise<void>;
+    importBranch(packageKey: string, branchKey: string, options?: BranchImportOptions): Promise<void>;
+    private pushBranchToGit;
+    private pushMainPackage;
+    private exportRewrittenPackageDir;
+    private writeLocalArtifact;
+    private prepareLocalWorkingDir;
+    private importPackageSourceDir;
+    private normalizeToProjectKey;
+    private restoreBranchKey;
+    private replaceFieldValue;
+    private escapeRegExp;
+    private removeDir;
+    private static isExportableBranch;
+    private static writeJson;
+}

package/lib/commands/configuration-management/branch/branch.command.service.d.ts

@@ -0,0 +1,18 @@
+import { Context } from "../../../core/command/cli-context";
+import { BranchTransport, BranchingSettingsTransport, MergeApplyOptions, MergePreviewTransport, PackageVersionCreatedTransport } from "./interfaces/branch.interfaces";
+export declare class BranchCommandService {
+    private readonly branchApi;
+    constructor(context: Context);
+    setBranchingEnabled(packageKey: string, enabled: boolean, jsonResponse: boolean): Promise<BranchingSettingsTransport>;
+    createBranch(packageKey: string, branchKey: string, sourceVersion: string, validate: boolean, jsonResponse: boolean): Promise<BranchTransport | void>;
+    listBranches(packageKey: string, jsonResponse: boolean): Promise<BranchTransport[]>;
+    deleteBranch(packageKey: string, branchKey: string): Promise<void>;
+    mergePreview(targetPackageKey: string, sourceKey: string, sourceVersion: string, jsonResponse: boolean): Promise<MergePreviewTransport>;
+    mergeApply(targetPackageKey: string, options: MergeApplyOptions): Promise<PackageVersionCreatedTransport>;
+    private static buildVersionCreate;
+    private static writeJson;
+    private static printBranch;
+    private static printPreviewSummary;
+    private static countConflictPaths;
+    private static isInConflict;
+}