@celonis/content-cli 1.12.0 → 1.14.0

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

@@ -0,0 +1,139 @@
+export declare enum MergeResolution {
+    CUSTOM = "CUSTOM",
+    ACCEPT_SOURCE = "ACCEPT_SOURCE",
+    ACCEPT_TARGET = "ACCEPT_TARGET"
+}
+export declare enum MergeStatus {
+    UNKNOWN = "UNKNOWN",
+    UNCHANGED = "UNCHANGED",
+    SOURCE_ONLY = "SOURCE_ONLY",
+    TARGET_ONLY = "TARGET_ONLY",
+    AUTO_MERGE = "AUTO_MERGE",
+    CONFLICT = "CONFLICT"
+}
+export declare enum ChangeType {
+    UNKNOWN = "UNKNOWN",
+    ADDED = "ADDED",
+    DELETED = "DELETED",
+    CHANGED = "CHANGED",
+    UNCHANGED = "UNCHANGED"
+}
+export declare enum VersionBumpOption {
+    NONE = "NONE",
+    PATCH = "PATCH"
+}
+export interface BranchingSettingsTransport {
+    branchingEnabled: boolean;
+}
+export interface CreateBranchTransport {
+    branchKey: string;
+    version: string;
+}
+export interface BranchTransport {
+    projectKey: string;
+    branchKey: string;
+    sourcePackageKey: string;
+    sourceVersion: string;
+    packageKey: string;
+    packageId?: string;
+}
+export interface ConfigurationChangeTransport {
+    op: string;
+    path: string;
+    from?: string;
+    value?: unknown;
+    fromValue?: unknown;
+}
+export interface MergePackageResolutionTransport {
+    resolution: MergeResolution;
+    customConfigurationChanges?: ConfigurationChangeTransport[];
+    customMetadataChanges?: ConfigurationChangeTransport[];
+}
+export interface MergeNodeResolutionTransport {
+    nodeKey: string;
+    resolution: MergeResolution;
+    customConfigurationChanges?: ConfigurationChangeTransport[];
+    customMetadataChanges?: ConfigurationChangeTransport[];
+}
+export interface NodeFilterTransport {
+    nodeKeys?: string[];
+}
+export interface SavePackageVersionTransport {
+    version?: string | null;
+    versionBumpOption?: VersionBumpOption;
+    summaryOfChanges?: string;
+    nodeFilter?: NodeFilterTransport | null;
+}
+export interface MergePreviewRequestTransport {
+    sourceKey: string;
+    sourceVersion: string;
+}
+export interface MergeBranchTransport {
+    sourceKey: string;
+    sourceVersion: string;
+    resolvedPackageConflict?: MergePackageResolutionTransport | null;
+    resolvedNodeConflicts?: MergeNodeResolutionTransport[];
+    versionCreate: SavePackageVersionTransport;
+}
+export interface MergePathConflictTransport {
+    path: string;
+    sourceChange: ConfigurationChangeTransport;
+    targetChange: ConfigurationChangeTransport;
+}
+export interface MergeDiffDetailTransport {
+    status: MergeStatus;
+    sourceChanges: ConfigurationChangeTransport[];
+    targetChanges: ConfigurationChangeTransport[];
+    conflicts: MergePathConflictTransport[];
+    autoMergedChanges: ConfigurationChangeTransport[];
+}
+export interface MergeDiffTransport {
+    configuration: MergeDiffDetailTransport;
+    metadata: MergeDiffDetailTransport;
+}
+export interface MergePreviewPackageTransport {
+    sourceChange: ChangeType;
+    targetChange: ChangeType;
+    changeDate: string;
+    updatedBy: string;
+    changes: MergeDiffTransport;
+}
+export interface MergePreviewNodeTransport {
+    nodeKey: string;
+    name: string;
+    type: string;
+    parentNodeKey?: string;
+    invalidContent: boolean;
+    sourceChange: ChangeType;
+    targetChange: ChangeType;
+    changeDate: string;
+    updatedBy: string;
+    changes: MergeDiffTransport;
+}
+export interface MergePreviewTransport {
+    commonPackageKey: string;
+    commonVersion: string;
+    packageChanges: MergePreviewPackageTransport;
+    nodeChanges: MergePreviewNodeTransport[];
+}
+export interface PackageVersionCreatedTransport {
+    packageKey: string;
+    version: string;
+    summaryOfChanges?: string;
+    creationDate: string;
+    createdBy: string;
+}
+export interface MergeApplyOptions {
+    sourceKey?: string;
+    sourceVersion?: string;
+    file?: string;
+    bump?: string;
+    version?: string;
+    summary?: string;
+    jsonResponse?: boolean;
+}
+export interface BranchSyncSummary {
+    packageKey: string;
+    branchName: string;
+    synced?: string[];
+}

package/lib/commands/configuration-management/module.d.ts

@@ -5,6 +5,14 @@ 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 setBranchSettings;
+    private createBranch;
+    private listBranches;
+    private deleteBranch;
+    private previewBranchMerge;
+    private applyBranchMerge;
+    private exportBranch;
+    private importBranch;
     private listPackages;
     private listStagingPackages;
     private batchExportPackages;
@@ -13,6 +21,7 @@ declare class Module extends IModule {
     private createPackageVersion;
     private batchImportPackages;
     private importSinglePackage;
+    private exportSinglePackage;
     private diffPackages;
     private validatePackage;
     private listVariables;

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

@@ -0,0 +1,8 @@
+import { Context } from "../../core/command/cli-context";
+export declare class SinglePackageExportService {
+    private readonly singlePackageExportApi;
+    private readonly gitService;
+    constructor(context: Context);
+    exportPackage(packageKey: string, zip: boolean, gitBranch: string): Promise<void>;
+    private exportToGitBranch;
+}

package/lib/commands/configuration-management/single-package-import.service.d.ts

@@ -1,12 +1,15 @@
+import * as FormData from "form-data";
+import * as AdmZip from "adm-zip";
 import { Context } from "../../core/command/cli-context";
 export declare class SinglePackageImportService {
     private static readonly MAX_UNCOMPRESSED_ZIP_SIZE;
     private readonly singlePackageImportApi;
+    private readonly gitService;
     constructor(context: Context);
-    importPackage(file: string, directory: string, overwrite: boolean, jsonResponse: boolean): Promise<void>;
+    importPackage(file: string, directory: string, overwrite: boolean, jsonResponse: boolean, gitBranch: string): Promise<void>;
     private resolveSource;
-    private buildBodyForImport;
-    private assertUncompressedSizeWithinLimit;
-    private getReadableStream;
+    static buildBodyForImport(packageZip: AdmZip, sourcePath: string): FormData;
+    static assertUncompressedSizeWithinLimit(packageZip: AdmZip, sourcePath: string): void;
+    private static getReadableStream;
     private outputResult;
 }

package/lib/content-cli.d.ts

@@ -1,2 +1,16 @@
 #!/usr/bin/env node
-export {};
+import { Command } from "commander";
+import { IModuleConstructor } from "./core/command/module-handler";
+import { Context } from "./core/command/cli-context";
+export interface CreateProgramOptions {
+    /**
+     * Explicit list of module classes to register. When provided, the factory
+     * skips automatic, filesystem-based module discovery.
+     */
+    modules?: IModuleConstructor[];
+    devMode?: boolean;
+}
+/**
+ * Build a fully-configured Commander program without parsing argv
+ */
+export declare function createProgram(context: Context, opts?: CreateProgramOptions): Command;

package/lib/core/command/module-handler.d.ts

@@ -24,8 +24,8 @@ type CommandHandler = (context: Context, command: Command, options: OptionValues
  * Allows the creation of root level commands.
  */
 export declare class Configurator {
-    private program;
-    private ctx;
+    private readonly program;
+    private readonly ctx;
     rootCommandMap: Map<string, CommandConfig>;
     constructor(program: Command, ctx: Context);
     /**
@@ -40,8 +40,8 @@ export declare class Configurator {
  * executed.
  */
 export declare class CommandConfig {
-    private cmd;
-    private ctx;
+    private readonly cmd;
+    private readonly ctx;
     private deprecationMessage;
     constructor(cmd: Command, ctx: Context);
     command(nameAndArgs: string, opts?: CommandOptions): CommandConfig;

package/lib/core/feature-flag/feature-disabled-error.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ */
+export declare const 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.
+ */
+export declare function isFeatureDisabledError(error: unknown): boolean;

package/lib/core/utils/branches.d.ts

@@ -1,4 +1,7 @@
 export declare class BranchUtils {
+    static readonly MAIN_BRANCH_KEY = "main";
     private static readonly BRANCH_SEPARATOR;
     static isBranchPackageKey(packageKey: string): boolean;
+    static constructBranchKey(projectKey: string, branchKey: string): string;
+    static extractProjectKey(packageKey: string): string;
 }

package/lib/core/utils/file-service.d.ts

@@ -1,8 +1,12 @@
+/// <reference types="node" />
 import AdmZip = require("adm-zip");
 export declare class FileService {
     static readonly fileDownloadedMessage = "File downloaded successfully. New filename: ";
     writeToFileWithGivenName(data: any, filename: string): void;
-    readFileToJson<T>(fileName: string): Promise<T>;
+    writeBufferToFileWithGivenName(data: Buffer, filename: string): void;
+    extractZipBufferToDirectory(data: Buffer, targetDir: string): void;
+    extractZipBufferToTempDirectory(data: Buffer): string;
+    readFileToJson(fileName: string): any;
     readFile(filename: string): string;
     extractExportedZipWithNestedZips(zipFile: AdmZip): string;
     extractExportedZipWithNestedZipsToDir(zipFile: AdmZip, targetDir: string): string;
@@ -10,6 +14,7 @@ export declare class FileService {
     zipDirectoryInBatchExportFormat(sourceDir: string): string;
     zipDirectoryAsSinglePackage(sourceDir: string): string;
     private getSerializedFileContent;
+    private mkdirRecursive;
     private restrictFilePermissions;
 }
 export declare const fileService: FileService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celonis/content-cli",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "CLI Tool to help manage content in Celonis Platform",
   "main": "content-cli.js",
   "bin": {
@@ -18,17 +18,17 @@
     "node": ">=18.20.5"
   },
   "dependencies": {
-    "adm-zip": "0.5.14",
+    "adm-zip": "0.6.0",
     "chalk": "4.1.2",
     "uuid": "9.0.1",
-    "axios": "1.13.5",
+    "axios": "1.18.0",
     "commander": "13.1.0",
-    "form-data": "4.0.4",
+    "form-data": "4.0.6",
     "openid-client": "5.6.1",
     "hpagent": "1.2.0",
     "@github/keytar": "7.10.6",
     "semver": "7.6.3",
-    "simple-git": "3.32.3",
+    "simple-git": "3.36.0",
     "valid-url": "1.0.9",
     "winston": "3.17.0",
     "yaml": "2.8.3"