@microtronics/studio-cli 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -1,11 +1,25 @@
 
 
-## 0.28.0 (2025-03-27)
+## 0.29.0 (2025-04-03)
 
 
 ### Features
 
-* **studio-cli:** run precompiler on the fly during dlo compile time ([354ebcf](https://bitbucket.org/microtronics-core/vscode-studio/commits/354ebcf72400b6f1956c85cae9bc7587a1680a16))
+* **studio-cli:** add functionality to fetch previous DDE history JSON ([ae4a22b](https://bitbucket.org/microtronics-core/vscode-studio/commits/ae4a22b704d207e52d16d524b0b11043db175484))
+* **studio-cli:** add the versions history.json to the apm tag ([1c3e35e](https://bitbucket.org/microtronics-core/vscode-studio/commits/1c3e35ef53d508987485103b0220a0eb84f4414c))
+* **studio-cli:** write the actual history.json to the dist/dde directory ([1fc5b32](https://bitbucket.org/microtronics-core/vscode-studio/commits/1fc5b3232f3d86f40bd7dfdeb9c6ef7a6d3c5491))
+
+
+### Bug Fixes
+
+* **studio-cli:** requesting the previous container by name was not correctly implemented ([78076a9](https://bitbucket.org/microtronics-core/vscode-studio/commits/78076a9b0fc6647e33f5ddfc0554d651fe7bc30e))
+
+## 0.28.0 (2025-03-27)
+
+
+### Features
+
+* **studio-cli:** run precompiler on the fly during dlo compile time ([354ebcf](https://bitbucket.org/microtronics-core/vscode-studio/commits/354ebcf72400b6f1956c85cae9bc7587a1680a16))
 * **studio-cli:** updated dlo compiler to suport dlo.cfg instead of pawn.cfg files ([9c56440](https://bitbucket.org/microtronics-core/vscode-studio/commits/9c564407a8d4118b7bb04cd6ffdaeb93ebed8290))
 
 ## 0.27.3 (2025-03-26)

package/dist/studio-cli.d.ts

@@ -121,11 +121,13 @@ declare interface BaseTagHeader {
  * @param {URI} cwd - The current working directory where the build process will be executed.
  * @param {LocalFS} fs - The local file system instance used for file operations during the build.
  * @param {Logger} logger - Logger instance for logging details during the build process.
+ * @param {Globals.ENV} env - The global environment configuration used during the installation.
+ * @param {string|null} apiToken - The API token for authentication, if required, or null if not applicable.
  * @param {APM.Part} selectedParts - The project parts to be built.
  * @param {boolean} [errorWithDiagnostics] - If true, includes diagnostic details in case of an error.
  * @return {Promise<Object>} A promise resolved with an object containing diagnostics information for the specified project parts: `dde`, `dlo`, and `dfiles`.
  */
-export declare function build(cwd: URI, fs: LocalFS, logger: Log.Logger, selectedParts?: APM.Part[] | boolean, errorWithDiagnostics?: boolean): Promise<{
+export declare function build(cwd: URI, fs: LocalFS, logger: Log.Logger, env: Globals.ENV, apiToken?: string | null, selectedParts?: APM.Part[] | boolean, errorWithDiagnostics?: boolean): Promise<{
     [APM.Part.dde]: Diagnostics.File[];
     [APM.Part.dlo]: Diagnostics.File[];
     [APM.Part.dfiles]: Diagnostics.File[];
@@ -373,7 +375,7 @@ declare interface components {
         ApplicationVersion: string | number;
         ApplicationVersionInSemver: boolean;
         /** @description File that can be downloaded */
-        ApplicationFileName: "release-notes.md" | "app.tar.gz" | "studio.json";
+        ApplicationFileName: "release-notes.md" | "app.tar.gz" | "studio.json" | "dde.json";
         /** @description User Id */
         MemberId: string;
         /** @description User Id */
@@ -1164,7 +1166,7 @@ export declare namespace DDE {
      * @param ddeHistory
      * @constructor
      */
-    const PreCompiler: (manifest: Manifest.Manifest, libraries: DDE_Core.LibraryFile[], ddeHistory: any) => YamlPreCompiler.PreCompiler;
+    const PreCompiler: (libraries: DDE_Core.LibraryFile[], ddeHistory: HistoryJson | null) => YamlPreCompiler.PreCompiler;
     /**
      * File Generators
      */
@@ -1180,23 +1182,46 @@ export declare namespace DDE {
      * @param ddeJSON
      */
     export function exportMyDatanetXML(cwd: URI, fs: LocalFS, logger: Log.Logger, ddeJSON: DDEJson): Promise<void>;
+    export interface HistoryJson {
+        version: string;
+        containers: {
+            [p: string]: DDE_Core.DDEJsonContainer;
+        };
+        setPointList: DDE_Core.DDESetpointList;
+    }
+    /**
+     * Fetches the DDE history JSON of a previous version of an app and saves it to a designated file path.
+     *
+     * The method removes any previously fetched version of the DDE JSON file and fetches the configuration
+     * of the previous stable version of the app from a remote registry. If a valid DDE file exists for the previous version, it is downloaded
+     * and stored at the specified location.
+     *
+     * @param {URI} cwd - The current working directory of the project.
+     * @param {LocalFS} fs - The local filesystem utility for performing file operations.
+     * @param {Log.Logger} logger - Logger instance for logging informational, warning, and error messages.
+     * @param {Globals.ENV} env - The environment configuration parameters.
+     * @param {string|null} apiToken - The API authentication token for accessing the registry. A null value will prevent fetching the DDE JSON file.
+     * @return {Promise<void>} Resolves with no value if the process completes successfully or returns early for validation or fetch failures.
+     */
+    export function fetchPreviousHistoryJson(cwd: URI, fs: LocalFS, logger: Log.Logger, env: Globals.ENV, apiToken: string | null): Promise<void>;
     /**
      * Read the correct history.json file from the project
      * @param cwd
      * @param fs
+     * @param logger
      */
-    export function getHistoryJson(cwd: URI, fs: LocalFS, logger: Log.Logger): Promise<any>;
+    export function getHistoryJson(cwd: URI, fs: LocalFS, logger: Log.Logger): Promise<HistoryJson | null>;
     /**
      * Generate the object for the history.json
      * @param ddeJson
-     * @param currentHistory
      * @param manifest
      */
-    export function buildHistoryJson(ddeJson: DDEJson, currentHistory: any, manifest: Manifest.Manifest): {};
+    export function buildHistoryJson(ddeJson: DDEJson, manifest: Manifest.Manifest): HistoryJson;
     /**
      * Generate the history.json file for the current version
      * @param cwd
      * @param fs
+     * @param logger
      * @param ddeJSON
      */
     export function exportHistoryJson(cwd: URI, fs: LocalFS, logger: Log.Logger, ddeJSON: DDEJson): Promise<void>;
@@ -1227,7 +1252,7 @@ export declare namespace DDE {
      * @param fs
      * @internal
      */
-    export function exportDefaultInc(cwd: URI, fs: LocalFS): Promise<void>;
+    export function exportDefaultInc(cwd: URI, fs: LocalFS, logger: Log.Logger): Promise<void>;
 }
 
 export declare namespace DDE_Core {
@@ -1526,6 +1551,10 @@ export declare namespace DefaultFiles {
                     legacyAutoUplinkInc: string;
                     cfg: string;
                 };
+                dde: {
+                    path: string;
+                    historyJson: string;
+                };
             };
             libdeps: string;
         };
@@ -2309,7 +2338,7 @@ export declare namespace Package {
      * @param selectedParts - choose a specific part that should be build or if true all parts are build
      * @param errorWithDiagnostics
      */
-    export function buildAll(cwd: URI, fs: LocalFS, logger: Log.Logger, selectedParts?: APM.Part[] | boolean, errorWithDiagnostics?: boolean): Promise<MergedDiagnostics>;
+    export function buildAll(cwd: URI, fs: LocalFS, logger: Log.Logger, env: Globals.ENV, apiToken: string | null, selectedParts?: APM.Part[] | boolean, errorWithDiagnostics?: boolean): Promise<MergedDiagnostics>;
     /**
      * Trigger the release based on the manifest settings
      * @param cwd
@@ -4674,14 +4703,13 @@ declare interface XMLField {
 
 declare namespace YamlPreCompiler {
     class PreCompiler {
-        private manifest;
         private libraryFiles;
         private ddeHistory;
         private readonly fieldNamesPerContainer;
         private readonly usedContainerNames;
         private fileDiagnostics;
         private readonly libraryDDE;
-        constructor(manifest: Manifest.Manifest, libraryFiles: DDE_Core.LibraryFile[], ddeHistory: any);
+        constructor(libraryFiles: DDE_Core.LibraryFile[], ddeHistory: DDE.HistoryJson | null);
         /**
          * Parse the given library files and return the diagnostics
          */

package/out/api.js

@@ -70,12 +70,14 @@ async function install(cwd, fs, env, apiToken, dependencies) {
  * @param {URI} cwd - The current working directory where the build process will be executed.
  * @param {LocalFS} fs - The local file system instance used for file operations during the build.
  * @param {Logger} logger - Logger instance for logging details during the build process.
+ * @param {Globals.ENV} env - The global environment configuration used during the installation.
+ * @param {string|null} apiToken - The API token for authentication, if required, or null if not applicable.
  * @param {APM.Part} selectedParts - The project parts to be built.
  * @param {boolean} [errorWithDiagnostics] - If true, includes diagnostic details in case of an error.
  * @return {Promise<Object>} A promise resolved with an object containing diagnostics information for the specified project parts: `dde`, `dlo`, and `dfiles`.
  */
-async function build(cwd, fs, logger, selectedParts = true, errorWithDiagnostics) {
-    return package_1.Package.buildAll(cwd, fs, logger, selectedParts, errorWithDiagnostics);
+async function build(cwd, fs, logger, env, apiToken = null, selectedParts = true, errorWithDiagnostics) {
+    return package_1.Package.buildAll(cwd, fs, logger, env, apiToken, selectedParts, errorWithDiagnostics);
 }
 /**
  * Publishes a package to the registry with the specified settings and configurations.

package/out/dde/dde.js

@@ -42,6 +42,7 @@ const dlo_1 = require("./fileGenerators/dlo");
 const globals_1 = require("../globals");
 const api_1 = require("./fileGenerators/api");
 const helper_1 = require("../helper");
+const registryAPI_1 = require("../registryAPI");
 exports.DDE_PATH = defaultFiles_1.DefaultFiles.filePaths.dde.path;
 // create file cache.
 // yaml & json
@@ -94,7 +95,7 @@ var DDE;
     async function compileDDE(cwd, fs, logger, fileName = defaultFiles_1.DefaultFiles.fileNames.mainDDE) {
         const validated = await validate(cwd, fs, logger, fileName);
         const historyJson = await getHistoryJson(cwd, fs, logger);
-        const preCompiler = new yamlDdePreCompiler_1.YamlPreCompiler.PreCompiler(validated.manifest, validated.libraryFiles, historyJson);
+        const preCompiler = new yamlDdePreCompiler_1.YamlPreCompiler.PreCompiler(validated.libraryFiles, historyJson);
         const libraryDiagnostics = preCompiler.parseLibraries();
         const librariesHaveError = libraryDiagnostics.find(diagnostics => diagnostics.level === 'error');
         if (librariesHaveError) {
@@ -136,8 +137,8 @@ var DDE;
      * @param ddeHistory
      * @constructor
      */
-    DDE.PreCompiler = (manifest, libraries, ddeHistory) => {
-        return new yamlDdePreCompiler_1.YamlPreCompiler.PreCompiler(manifest, libraries, ddeHistory);
+    DDE.PreCompiler = (libraries, ddeHistory) => {
+        return new yamlDdePreCompiler_1.YamlPreCompiler.PreCompiler(libraries, ddeHistory);
     };
     /**
      * File Generators
@@ -163,54 +164,130 @@ var DDE;
         logger.log('Generated', defaultFiles_1.DefaultFiles.filePaths.dist.ddeXmlPath);
     }
     DDE.exportMyDatanetXML = exportMyDatanetXML;
+    /**
+     * Fetches the DDE history JSON of a previous version of an app and saves it to a designated file path.
+     *
+     * The method removes any previously fetched version of the DDE JSON file and fetches the configuration
+     * of the previous stable version of the app from a remote registry. If a valid DDE file exists for the previous version, it is downloaded
+     * and stored at the specified location.
+     *
+     * @param {URI} cwd - The current working directory of the project.
+     * @param {LocalFS} fs - The local filesystem utility for performing file operations.
+     * @param {Log.Logger} logger - Logger instance for logging informational, warning, and error messages.
+     * @param {Globals.ENV} env - The environment configuration parameters.
+     * @param {string|null} apiToken - The API authentication token for accessing the registry. A null value will prevent fetching the DDE JSON file.
+     * @return {Promise<void>} Resolves with no value if the process completes successfully or returns early for validation or fetch failures.
+     */
+    async function fetchPreviousHistoryJson(cwd, fs, logger, env, apiToken) {
+        // remove the previous fetched version beforehand.
+        const previousDDEPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.studio.auto.dde.historyJson);
+        await fs.rm(previousDDEPath).catch(console.error);
+        const manifest = await manifest_1.Manifest.read(cwd, fs);
+        // only validate if the project is an app and has a registry id
+        if (!manifest_1.Manifest.isApp(manifest) || !manifest.registry?.id) {
+            return;
+        }
+        if (!apiToken) {
+            logger.warn('Could not fetch dde of previous version: No API token provided.');
+            return;
+        }
+        const currentVersion = semver.valid(manifest.version) ? manifest.version : semver.coerce(manifest.version);
+        try {
+            const appProfile = await registryAPI_1.Registry.getExistingApplication(apiToken, manifest.publisher, manifest.registry.id, env);
+            const appVersions = appProfile.versions;
+            // find the previous version
+            const previousVersion = appVersions.find(version => {
+                // the appProfile is fetched with semver header true, therefore is the version.version a valid semver string.
+                return !semver.prerelease(version.version) && semver.lt(version.version, currentVersion);
+            });
+            const versionFile = previousVersion?.files.find(file => file.name === 'dde.json');
+            if (!versionFile) {
+                // the version does not have a dde.json file
+                logger.warn('Could not find a valid previous released app version to fetch the previous dde from.');
+                return;
+            }
+            const request = await fetch(versionFile.downloadUrl, {
+                headers: {
+                    ...(0, registryAPI_1.buildAuthHeader)(apiToken),
+                    ...registryAPI_1.Registry.injectSemverHeader(true)
+                }
+            });
+            if (request.status !== 200) {
+                // the version does not have a dde.json file
+                logger.warn(`Could not fetch the dde.json of version "${previousVersion?.version}"`);
+                return;
+            }
+            const historyJson = await request.text();
+            await fs.writeFile(previousDDEPath, historyJson);
+            logger.log(`Saved history.json of previous app version ${previousVersion.version}`);
+        }
+        catch (e) {
+            logger.error('Failed to fetch the dde of previous version', e);
+        }
+    }
+    DDE.fetchPreviousHistoryJson = fetchPreviousHistoryJson;
     /**
      * Read the correct history.json file from the project
      * @param cwd
      * @param fs
+     * @param logger
      */
     async function getHistoryJson(cwd, fs, logger) {
-        const historyPath = vscode_uri_1.Utils.joinPath(cwd, exports.DDE_PATH, 'history.json');
         try {
-            const binary = await fs.readFile(historyPath);
-            const historyString = convertBlobToString(binary);
-            return JSON.parse(historyString);
+            const prevHistoryPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.studio.auto.dde.historyJson);
+            if (await fs.stat(prevHistoryPath)) {
+                const binary = await fs.readFile(prevHistoryPath);
+                return JSON.parse(convertBlobToString(binary));
+            }
+            // fallback to previous history.json located within the projects dde directory
+            const historyPath = vscode_uri_1.Utils.joinPath(cwd, exports.DDE_PATH, 'history.json');
+            if (await fs.stat(historyPath)) {
+                logger.warn(`"${defaultFiles_1.DefaultFiles.filePaths.studio.auto.dde.historyJson}" does not exist - fallback to "${exports.DDE_PATH}history.json"`);
+                const binary = await fs.readFile(historyPath);
+                const historyJson = JSON.parse(convertBlobToString(binary));
+                const manifest = await manifest_1.Manifest.read(cwd, fs);
+                const currentSemver = semver.coerce(manifest.version)?.version;
+                // get previous dde version
+                const prev = Object.keys(historyJson || {})
+                    .sort(semver.rcompare)
+                    .find(version => version !== currentSemver);
+                if (!prev) {
+                    return null;
+                }
+                const newHistoryFormat = historyJson[prev];
+                return { version: prev, ...newHistoryFormat };
+            }
         }
         catch (e) {
-            logger.warn('history.json does not exist');
-            return {};
+            logger.error('Failed to read history.json', e);
         }
+        logger.warn('history.json does not exist');
+        return null;
     }
     DDE.getHistoryJson = getHistoryJson;
     /**
      * Generate the object for the history.json
      * @param ddeJson
-     * @param currentHistory
      * @param manifest
      */
-    function buildHistoryJson(ddeJson, currentHistory, manifest) {
+    function buildHistoryJson(ddeJson, manifest) {
         const currentVersion = semver.coerce(manifest.version)?.version || '1.0.0';
-        const fullMap = { ...currentHistory };
-        fullMap[currentVersion] = { ...ddeJson };
-        delete fullMap[currentVersion]['defines'];
-        return Object.keys(fullMap)
-            .sort(semver.rcompare)
-            .reduce((obj, key) => {
-            //@ts-ignore
-            obj[key] = fullMap[key];
-            return obj;
-        }, {});
+        return {
+            version: currentVersion,
+            ...structuredClone(ddeJson)
+        };
     }
     DDE.buildHistoryJson = buildHistoryJson;
     /**
      * Generate the history.json file for the current version
      * @param cwd
      * @param fs
+     * @param logger
      * @param ddeJSON
      */
     async function exportHistoryJson(cwd, fs, logger, ddeJSON) {
-        const currentHistory = await getHistoryJson(cwd, fs, logger);
         const manifest = await manifest_1.Manifest.read(cwd, fs);
-        const newHistory = buildHistoryJson(ddeJSON, currentHistory, manifest);
+        const newHistory = buildHistoryJson(ddeJSON, manifest);
         const historyPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.dist.historyJson);
         await fs.writeFile(historyPath, JSON.stringify(newHistory, null, '\t'));
         logger.log('Generated', defaultFiles_1.DefaultFiles.filePaths.dist.historyJson);
@@ -266,7 +343,7 @@ var DDE;
         const autoDdeMainPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.studio.auto.dlo.autoDdeInc.replace('X', 'main'));
         await fs.writeFile(autoDdeMainPath, mainDDEInc);
         logger.log('Generated', defaultFiles_1.DefaultFiles.filePaths.studio.auto.dlo.autoDdeInc.replace('X', 'main'));
-        await exportDefaultInc(cwd, fs);
+        await exportDefaultInc(cwd, fs, logger);
     }
     DDE.exportAutoDloFiles = exportAutoDloFiles;
     /**
@@ -301,11 +378,11 @@ var DDE;
      * @param fs
      * @internal
      */
-    async function exportDefaultInc(cwd, fs) {
+    async function exportDefaultInc(cwd, fs, logger) {
         const defaultIncPaht = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.studio.auto.dlo.defaultInc);
         const content = await (0, dlo_1.buildDefaultInc)(cwd, fs);
         await fs.writeFile(defaultIncPaht, content);
-        console.log('Generated', defaultFiles_1.DefaultFiles.filePaths.studio.auto.dlo.defaultInc);
+        logger.log('Generated', defaultFiles_1.DefaultFiles.filePaths.studio.auto.dlo.defaultInc);
     }
     DDE.exportDefaultInc = exportDefaultInc;
 })(DDE || (exports.DDE = DDE = {}));

package/out/dde/yamlDdePreCompiler.js

@@ -1,32 +1,8 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.YamlPreCompiler = void 0;
 const yaml_1 = require("yaml");
 const diagnostics_1 = require("../diagnostics");
-const semver = __importStar(require("semver"));
 const coreDefinitions_1 = require("./coreDefinitions");
 const helper_1 = require("../helper");
 var DDEContainerName = coreDefinitions_1.DDE_Core.DDEContainerName;
@@ -45,15 +21,13 @@ var yamlRangeToLineInformation = helper_1.Helper.yamlRangeToLineInformation;
 var YamlPreCompiler;
 (function (YamlPreCompiler) {
     class PreCompiler {
-        manifest;
         libraryFiles;
         ddeHistory;
         fieldNamesPerContainer = {};
         usedContainerNames = {};
         fileDiagnostics = [];
         libraryDDE = [];
-        constructor(manifest, libraryFiles, ddeHistory) {
-            this.manifest = manifest;
+        constructor(libraryFiles, ddeHistory) {
             this.libraryFiles = libraryFiles;
             this.ddeHistory = ddeHistory;
         }
@@ -71,33 +45,11 @@ var YamlPreCompiler;
             return libDiagnostics;
         }
         get previousVersion() {
-            const currentSemver = semver.coerce(this.manifest.version)?.version;
-            // get previous dde version
-            const prev = Object.keys(this.ddeHistory || {})
-                .sort(semver.rcompare)
-                .find(version => version !== currentSemver);
-            const previousDDE = prev ? this.ddeHistory[prev] : { setPointList: {}, containers: {} };
-            // 04.04.2024 handle old DDEJson description:
-            if (!Object.hasOwn(previousDDE, 'containers')) {
-                previousDDE.containers = {};
-                for (const [container, containerDefinition] of Object.entries(previousDDE)) {
-                    if (['setPointList', 'containers'].includes(container)) {
-                        continue;
-                    }
-                    previousDDE.containers[container] = containerDefinition;
-                    delete previousDDE[container];
-                }
-            }
-            return previousDDE;
+            return { setPointList: { ...this.ddeHistory?.setPointList }, containers: { ...this.ddeHistory?.containers } };
         }
         getContainerOfPreviousVersion(containerName) {
             const previousDDE = this.previousVersion;
-            if (Object.hasOwn(previousDDE.containers, containerName)) {
-                return previousDDE.containers[containerName];
-            }
-            else {
-                return null;
-            }
+            return (Object.values(previousDDE.containers).find(containerDefinition => containerDefinition.title === containerName) || null);
         }
         parseMainDDE(filePath, yaml) {
             const { parsedDDE, diagnostics } = this.parseYamlFile(filePath, yaml);

package/out/defaultFiles.js

@@ -30,6 +30,7 @@ var DefaultFiles;
     };
     const studioAutoPath = `${studioDirectoryName}auto/`;
     const studioAutoDloPath = `${studioAutoPath}dlo/`;
+    const studioAutoDdePath = `${studioAutoPath}dde/`;
     DefaultFiles.filePaths = {
         studio: {
             // init file to test if we can write to the workspace
@@ -48,6 +49,10 @@ var DefaultFiles;
                     legacyAutoDdeInc: `${studioAutoDloPath}${DefaultFiles.fileNames.legacyAutoDdeInc}`,
                     legacyAutoUplinkInc: `${studioAutoDloPath}${DefaultFiles.fileNames.legacyAutoUplinkInc}`,
                     cfg: `${studioAutoDloPath}${DefaultFiles.fileNames.dloCfg}`
+                },
+                dde: {
+                    path: studioAutoDdePath,
+                    historyJson: `${studioAutoDdePath}${DefaultFiles.fileNames.historyJson}`
                 }
             },
             libdeps: `${studioDirectoryName}libdeps/`
@@ -61,7 +66,7 @@ var DefaultFiles;
             ddeApiPath: `${deployDirectoryName}api/`,
             ddeApi: `${deployDirectoryName}api/${DefaultFiles.fileNames.ddeOpenApi}`,
             // ddeJson has changed to history.json and is now in dde/ dir
-            historyJson: `${ddeDirectoryName}${DefaultFiles.fileNames.historyJson}`,
+            historyJson: `${deployDirectoryName}dde/${DefaultFiles.fileNames.historyJson}`,
             povPath: `${deployDirectoryName}pov`,
             povDetailsPath: `${deployDirectoryName}pov/details`,
             dfilesPath: `${deployDirectoryName}dfiles`,

package/out/main.js

@@ -84,8 +84,12 @@ program
 program
     .command('build')
     .addOption(new commander_1.Option('-p --part <APM part>', 'APM part that should be build').choices(Object.values(apm_1.APM.Part)))
+    .allowExcessArguments(true)
+    .addOption(optionStudioEnv)
+    .addOption(optionStudioToken)
     .action(opts => {
-    main((0, api_1.build)(cwd, cliFS_1.cliFS, logger, opts.part));
+    const { env, token } = getDefaultOptions(opts);
+    main((0, api_1.build)(cwd, cliFS_1.cliFS, logger, env, token, opts.part));
 });
 const releasePhaseArguments = Object.values(apm_1.APM.TagPhase);
 program

package/out/package/apm.js

@@ -285,7 +285,10 @@ async function addAdditionalFiles(cwd, fs, apmBuffer) {
         const reportTemplateBlob = new Blob([await fs.readFile(reportTemplate)]);
         apmBuffer.append(`bin/pov/mdn_report_template.json`, reportTemplateBlob);
     }
+    // pass the current versions history json to the apm tag
     const historyPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.dist.historyJson);
-    apmBuffer.append(`src/dde/${manifest_1.Manifest.fileName}`, new Blob([await fs.readFile(historyPath)]));
+    if (await fs.stat(historyPath)) {
+        apmBuffer.append(`src/dde/history.json`, new Blob([await fs.readFile(historyPath)]));
+    }
 }
 //# sourceMappingURL=apm.js.map

package/out/package/package.js

@@ -36,8 +36,9 @@ var Package;
      * @param selectedParts - choose a specific part that should be build or if true all parts are build
      * @param errorWithDiagnostics
      */
-    async function buildAll(cwd, fs, logger, selectedParts = true, errorWithDiagnostics) {
+    async function buildAll(cwd, fs, logger, env, apiToken, selectedParts = true, errorWithDiagnostics) {
         selectedParts = normalizeSelectedParts(logger, selectedParts);
+        await preBuild(cwd, fs, logger, env, apiToken, selectedParts);
         const mergedDiagnostics = {
             [apm_1.APM.Part.dde]: [],
             [apm_1.APM.Part.dlo]: [],
@@ -133,7 +134,7 @@ var Package;
             return;
         }
         // build the complete project
-        await buildAll(cwd, fs, logger);
+        await buildAll(cwd, fs, logger, env, token);
         // update the store apm with the actual name/description/...
         await apm_1.APM.updateProfile(cwd, fs, token, env);
         const tagContent = await apm_1.APM.createTag(cwd, fs, releasePhase);
@@ -162,7 +163,7 @@ var Package;
         await manifest_1.Manifest.validateBasicManifest(cwd, fs, manifest);
         await validatePublishSettings(cwd, fs, token, env);
         // build the complete project
-        await buildAll(cwd, fs, logger);
+        await buildAll(cwd, fs, logger, env, token);
         const archive = await library_1.Library.createArchive(cwd, fs);
         await library_1.Library.publishPackage(cwd, fs, token, archive, env);
         logger.done(`Library "${manifest.publisher}/${manifest.name}" with version "${manifest.version}" published!`);
@@ -264,6 +265,22 @@ function normalizeSelectedParts(logger, selectedParts) {
     }
     return selectedParts;
 }
+/**
+ * Prepares the build process by performing pre-build operations based on the selected parts.
+ *
+ * @param {URI} cwd - The current working directory for the build process.
+ * @param {LocalFS} fs - The file system abstraction used for file operations.
+ * @param {Log.Logger} logger - The logger instance for logging messages during the process.
+ * @param {Globals.ENV} env - The environment variables and configuration for the process.
+ * @param {string|null} apiToken - The API token used for authentication, or null if not required.
+ * @param {APM.Part[]} selectedParts - An array of selected parts indicating specific build steps to execute.
+ * @return {Promise<void>} A promise that resolves when the pre-build process completes.
+ */
+async function preBuild(cwd, fs, logger, env, apiToken, selectedParts) {
+    if (selectedParts.includes(apm_1.APM.Part.dde)) {
+        await dde_1.DDE.fetchPreviousHistoryJson(cwd, fs, logger, env, apiToken);
+    }
+}
 /**
  * Generates all needed files out of the dde declaration
  * @param cwd

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@microtronics/studio-cli",
-	"version": "0.28.0",
+	"version": "0.29.0",
 	"description": "Microtronics Studio CLI Tool",
 	"main": "./out/api.js",
 	"typings": "./dist/studio-cli.d.ts",