@sap-ux/generator-adp 0.7.44 → 0.8.0

package/generators/app/index.d.ts

@@ -112,6 +112,10 @@ export default class extends Generator {
      * Telemetry collector instance.
      */
     private telemetryCollector;
+    /**
+     * Key-user import prompter instance.
+     */
+    private keyUserPrompter?;
     /**
      * Creates an instance of the generator.
      *

package/generators/app/index.js

@@ -32,6 +32,7 @@ const default_values_1 = require("./questions/helper/default-values");
 const validators_1 = require("./questions/helper/validators");
 const types_1 = require("./types");
 const target_env_1 = require("./questions/target-env");
+const key_user_1 = require("./questions/key-user");
 const generatorTitle = 'Adaptation Project';
 /**
  * Generator for creating an Adaptation Project.
@@ -145,6 +146,10 @@ class default_1 extends yeoman_generator_1.default {
      * Telemetry collector instance.
      */
     telemetryCollector;
+    /**
+     * Key-user import prompter instance.
+     */
+    keyUserPrompter;
     /**
      * Creates an instance of the generator.
      *
@@ -243,12 +248,20 @@ class default_1 extends yeoman_generator_1.default {
                     hasBaseAppInbounds: !!this.prompter.baseAppInbounds,
                     hide: this.shouldCreateExtProject
                 },
-                addDeployConfig: { hide: this.shouldCreateExtProject || !this.isCustomerBase }
+                addDeployConfig: { hide: this.shouldCreateExtProject || !this.isCustomerBase },
+                importKeyUserChanges: { hide: this.shouldCreateExtProject }
             };
             const attributesQuestions = (0, attributes_1.getPrompts)(this.destinationPath(), promptConfig, options);
             this.attributeAnswers = await this.prompt(attributesQuestions);
             // Steps need to be updated here to be available after back navigation in Yeoman UI.
             this._updateWizardStepsAfterNavigation();
+            if (this.attributeAnswers.importKeyUserChanges) {
+                this.keyUserPrompter = new key_user_1.KeyUserImportPrompter(this.systemLookup, this.configAnswers.application.id, this.prompter.provider, this.configAnswers.system, this.logger);
+                const keyUserQuestions = this.keyUserPrompter.getPrompts({
+                    keyUserSystem: { default: this.configAnswers.system }
+                });
+                await this.prompt(keyUserQuestions);
+            }
             this.logger.info(`Project Attributes: ${JSON.stringify(this.attributeAnswers, null, 2)}`);
             if (this.attributeAnswers.addDeployConfig) {
                 const system = await this.systemLookup.getSystemByName(this.configAnswers.system);
@@ -303,7 +316,8 @@ class default_1 extends yeoman_generator_1.default {
                 layer: this.layer,
                 packageJson,
                 logger: this.toolsLogger,
-                toolsId: this.toolsId
+                toolsId: this.toolsId,
+                keyUserChanges: this.keyUserPrompter?.changes
             });
             if (config.options) {
                 config.options.templatePathOverwrite = (0, templates_1.getTemplatesOverwritePath)();
@@ -446,7 +460,8 @@ class default_1 extends yeoman_generator_1.default {
             ui5ValidationCli: { hide: true },
             enableTypeScript: { hide: true },
             addFlpConfig: { hide: true },
-            addDeployConfig: { hide: true }
+            addDeployConfig: { hide: true },
+            importKeyUserChanges: { hide: true }
         };
         const projectPath = this.destinationPath();
         const attributesQuestions = (0, attributes_1.getPrompts)(projectPath, {
@@ -590,6 +605,7 @@ class default_1 extends yeoman_generator_1.default {
         if (!deployPageExists) {
             (0, steps_1.updateWizardSteps)(this.prompts, (0, steps_1.getDeployPage)(), (0, i18n_1.t)('yuiNavSteps.projectAttributesName'), this.attributeAnswers.addDeployConfig);
         }
+        (0, steps_1.updateWizardSteps)(this.prompts, (0, steps_1.getKeyUserImportPage)(), (0, i18n_1.t)('yuiNavSteps.projectAttributesName'), !!this.attributeAnswers.importKeyUserChanges);
         if (!flpPagesExist) {
             (0, steps_1.updateFlpWizardSteps)(!!this.prompter.baseAppInbounds, this.prompts, this.attributeAnswers.projectName, !!this.attributeAnswers.addFlpConfig);
         }

package/generators/app/questions/attributes.js

@@ -31,7 +31,8 @@ function getPrompts(path, config, promptOptions) {
         [types_1.attributePromptNames.ui5ValidationCli]: getUi5VersionValidationPromptForCli(),
         [types_1.attributePromptNames.enableTypeScript]: getEnableTypeScriptPrompt(promptOptions?.[types_1.attributePromptNames.enableTypeScript]),
         [types_1.attributePromptNames.addDeployConfig]: getAddDeployConfigPrompt(prompts, promptOptions?.[types_1.attributePromptNames.addDeployConfig]),
-        [types_1.attributePromptNames.addFlpConfig]: getFlpConfigPrompt(prompts, isCloudProject, promptOptions?.[types_1.attributePromptNames.addFlpConfig])
+        [types_1.attributePromptNames.addFlpConfig]: getFlpConfigPrompt(prompts, isCloudProject, promptOptions?.[types_1.attributePromptNames.addFlpConfig]),
+        [types_1.attributePromptNames.importKeyUserChanges]: getImportKeyUserChangesPrompt(prompts, promptOptions?.[types_1.attributePromptNames.importKeyUserChanges])
     };
     const questions = Object.entries(keyedPrompts)
         .filter(([promptName]) => {
@@ -246,4 +247,26 @@ function getFlpConfigPrompt(prompts, isCloudProject, options) {
         }
     };
 }
+/**
+ * Creates the Import Key User Changes confirm prompt.
+ *
+ * @param {YeomanUiSteps} prompts - The Yeoman UI pages.
+ * @param {ImportKeyUserChangesPromptOptions} options - Optional prompt options.
+ * @returns {AttributesQuestion} The prompt configuration for copying key user changes.
+ */
+function getImportKeyUserChangesPrompt(prompts, options) {
+    return {
+        type: 'confirm',
+        name: types_1.attributePromptNames.importKeyUserChanges,
+        message: (0, i18n_1.t)('prompts.importKeyUserChangesLabel'),
+        default: options?.default ?? false,
+        guiOptions: {
+            breadcrumb: true
+        },
+        validate: (value) => {
+            (0, steps_1.updateWizardSteps)(prompts, (0, steps_1.getKeyUserImportPage)(), (0, i18n_1.t)('yuiNavSteps.projectAttributesName'), value);
+            return true;
+        }
+    };
+}
 //# sourceMappingURL=attributes.js.map

package/generators/app/questions/helper/choices.d.ts

@@ -1,5 +1,6 @@
 import { AppRouterType } from '@sap-ux/adp-tooling';
-import type { CFApp, SourceApplication } from '@sap-ux/adp-tooling';
+import type { CFApp, Endpoint, SourceApplication } from '@sap-ux/adp-tooling';
+import type { AdaptationDescriptor } from '@sap-ux/axios-extension';
 interface Choice {
     name: string;
     value: SourceApplication;
@@ -32,5 +33,26 @@ export declare const getAppRouterChoices: (isInternalUsage: boolean) => {
     name: AppRouterType;
     value: AppRouterType;
 }[];
+/**
+ * Returns the choices for the adaptation prompt.
+ *
+ * @param {AdaptationDescriptor[]} adaptations - The adaptations to get the choices for.
+ * @returns {Array<{ name: string; value: AdaptationDescriptor }>} The choices for the adaptation prompt.
+ */
+export declare const getAdaptationChoices: (adaptations: AdaptationDescriptor[]) => Array<{
+    name: string;
+    value: AdaptationDescriptor;
+}>;
+/**
+ * Returns the choices for the system prompt.
+ *
+ * @param {string[]} systems - The systems to get the choices for.
+ * @param {string} defaultSystem - The default system.
+ * @returns {Array<{ name: string; value: string }>} The choices for the system prompt.
+ */
+export declare const getKeyUserSystemChoices: (systems: Endpoint[], defaultSystem: string) => Array<{
+    name: string;
+    value: string;
+}>;
 export {};
 //# sourceMappingURL=choices.d.ts.map

package/generators/app/questions/helper/choices.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAppRouterChoices = exports.getCFAppChoices = exports.getApplicationChoices = void 0;
+exports.getKeyUserSystemChoices = exports.getAdaptationChoices = exports.getAppRouterChoices = exports.getCFAppChoices = exports.getApplicationChoices = void 0;
 const adp_tooling_1 = require("@sap-ux/adp-tooling");
 /**
  * Creates a list of choices from a list of applications, formatted for display or selection in a UI.
@@ -58,4 +58,34 @@ const getAppRouterChoices = (isInternalUsage) => {
     return options;
 };
 exports.getAppRouterChoices = getAppRouterChoices;
+/**
+ * Returns the choices for the adaptation prompt.
+ *
+ * @param {AdaptationDescriptor[]} adaptations - The adaptations to get the choices for.
+ * @returns {Array<{ name: string; value: AdaptationDescriptor }>} The choices for the adaptation prompt.
+ */
+const getAdaptationChoices = (adaptations) => {
+    return adaptations?.map((adaptation) => ({
+        name: adaptation.title ? `${adaptation.title} (${adaptation.id})` : adaptation.id,
+        value: adaptation
+    }));
+};
+exports.getAdaptationChoices = getAdaptationChoices;
+/**
+ * Returns the choices for the system prompt.
+ *
+ * @param {string[]} systems - The systems to get the choices for.
+ * @param {string} defaultSystem - The default system.
+ * @returns {Array<{ name: string; value: string }>} The choices for the system prompt.
+ */
+const getKeyUserSystemChoices = (systems, defaultSystem) => {
+    const endpointNames = (0, adp_tooling_1.getEndpointNames)(systems);
+    return endpointNames.map((name) => {
+        return {
+            name: name === defaultSystem ? `${name} (Source system)` : name,
+            value: name
+        };
+    });
+};
+exports.getKeyUserSystemChoices = getKeyUserSystemChoices;
 //# sourceMappingURL=choices.js.map

package/generators/app/questions/key-user.d.ts

@@ -0,0 +1,135 @@
+import type { AbapServiceProvider, FlexVersion, KeyUserChangeContent } from '@sap-ux/axios-extension';
+import type { ToolsLogger } from '@sap-ux/logger';
+import { type SystemLookup } from '@sap-ux/adp-tooling';
+import type { KeyUserImportPromptOptions, KeyUserImportQuestion } from '../types';
+export declare const DEFAULT_ADAPTATION_ID = "DEFAULT";
+/**
+ * Determines the flex version to be used. If the first version is the draft (versionId "0"), use the second version (active version).
+ *
+ * @param {FlexVersion[]} flexVersions - The list of flex versions.
+ * @returns {string} The flex version to be used.
+ */
+export declare function determineFlexVersion(flexVersions: FlexVersion[]): string;
+/**
+ * Prompter class that guides the user through importing key-user changes.
+ */
+export declare class KeyUserImportPrompter {
+    private readonly systemLookup;
+    private readonly componentId;
+    private readonly defaultProvider;
+    private readonly defaultSystem;
+    private readonly logger;
+    /**
+     * Instance of AbapServiceProvider.
+     */
+    private provider;
+    /**
+     * List of adaptations.
+     */
+    private adaptations;
+    /**
+     * List of key-user changes.
+     */
+    private keyUserChanges;
+    /**
+     * List of flex versions.
+     */
+    private flexVersions;
+    /**
+     * Indicates if authentication is required.
+     */
+    private isAuthRequired;
+    /**
+     * Constructs a new KeyUserImportPrompter.
+     *
+     * @param {SystemLookup} systemLookup - The system lookup.
+     * @param {string} componentId - The component ID.
+     * @param {AbapServiceProvider} defaultProvider - The default provider.
+     * @param {string} defaultSystem - The default system.
+     * @param {ToolsLogger} logger - The logger.
+     */
+    constructor(systemLookup: SystemLookup, componentId: string, defaultProvider: AbapServiceProvider, defaultSystem: string, logger: ToolsLogger);
+    /**
+     * Returns the key-user changes.
+     *
+     * @returns {KeyUserChangeContent[]} The key-user changes.
+     */
+    get changes(): KeyUserChangeContent[];
+    /**
+     * Builds the prompts for the key-user import page.
+     *
+     * @param {KeyUserImportPromptOptions} [promptOptions] - Per-prompt settings (hide/default).
+     * @returns {KeyUserImportQuestion[]} Questions for the key-user import page.
+     */
+    getPrompts(promptOptions?: KeyUserImportPromptOptions): KeyUserImportQuestion[];
+    /**
+     * Returns the system prompt.
+     *
+     * @param {KeyUserSystemPromptOptions} [options] - The options for the system prompt.
+     * @returns {KeyUserImportQuestion} The system prompt.
+     */
+    private getSystemPrompt;
+    /**
+     * Returns the username prompt.
+     *
+     * @param {KeyUserUsernamePromptOptions} [options] - The options for the username prompt.
+     * @returns {KeyUserImportQuestion} The username prompt.
+     */
+    private getUsernamePrompt;
+    /**
+     * Returns the password prompt.
+     *
+     * @param {KeyUserPasswordPromptOptions} [options] - The options for the password prompt.
+     * @returns {KeyUserImportQuestion} The password prompt.
+     */
+    private getPasswordPrompt;
+    /**
+     * Returns the adaptation prompt.
+     *
+     * @param {KeyUserAdaptationPromptOptions} [_] - The options for the adaptation prompt.
+     * @returns {KeyUserImportQuestion} The adaptation prompt.
+     */
+    private getAdaptationPrompt;
+    /**
+     * Loads adaptations for the current provider.
+     */
+    private loadAdaptations;
+    /**
+     * Loads flex versions for the current provider.
+     */
+    private loadFlexVersions;
+    /**
+     * Resets the state by clearing adaptations, flex versions, and key-user changes.
+     */
+    private resetState;
+    /**
+     * Loads flex versions and adaptations, then validates key-user changes if only DEFAULT adaptation exists.
+     *
+     * @returns The result of key-user validation if only DEFAULT exists, or true.
+     */
+    private loadDataAndValidateKeyUserChanges;
+    /**
+     * Validates the system selection by testing the connection.
+     *
+     * @param {string} system - The selected system.
+     * @param {KeyUserImportAnswers} answers - The configuration answers provided by the user.
+     * @returns An error message if validation fails, or true if the system selection is valid.
+     */
+    private validateSystem;
+    /**
+     * Validates the password by testing the connection.
+     *
+     * @param {string} password - The inputted password.
+     * @param {KeyUserImportAnswers} answers - The configuration answers provided by the user.
+     * @returns An error message if validation fails, or true if the password is valid.
+     */
+    private validatePassword;
+    /**
+     * Validates the key-user changes by testing the connection.
+     *
+     * @param {string} adaptationId - The selected adaptation.
+     * @returns An error message if validation fails, or true if the key-user changes are valid.
+     */
+    private validateKeyUserChanges;
+}
+//# sourceMappingURL=key-user.d.ts.map

package/generators/app/questions/key-user.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyUserImportPrompter = exports.DEFAULT_ADAPTATION_ID = void 0;
+exports.determineFlexVersion = determineFlexVersion;
+const axios_extension_1 = require("@sap-ux/axios-extension");
+const project_input_validator_1 = require("@sap-ux/project-input-validator");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const i18n_1 = require("../../utils/i18n");
+const types_1 = require("../types");
+const choices_1 = require("./helper/choices");
+exports.DEFAULT_ADAPTATION_ID = 'DEFAULT';
+/**
+ * Determines the flex version to be used. If the first version is the draft (versionId "0"), use the second version (active version).
+ *
+ * @param {FlexVersion[]} flexVersions - The list of flex versions.
+ * @returns {string} The flex version to be used.
+ */
+function determineFlexVersion(flexVersions) {
+    if (!flexVersions?.length) {
+        return '';
+    }
+    if (flexVersions[0]?.versionId === '0') {
+        return flexVersions[1]?.versionId ?? '';
+    }
+    return flexVersions[0]?.versionId ?? '';
+}
+/**
+ * Prompter class that guides the user through importing key-user changes.
+ */
+class KeyUserImportPrompter {
+    systemLookup;
+    componentId;
+    defaultProvider;
+    defaultSystem;
+    logger;
+    /**
+     * Instance of AbapServiceProvider.
+     */
+    provider;
+    /**
+     * List of adaptations.
+     */
+    adaptations = [];
+    /**
+     * List of key-user changes.
+     */
+    keyUserChanges = [];
+    /**
+     * List of flex versions.
+     */
+    flexVersions = [];
+    /**
+     * Indicates if authentication is required.
+     */
+    isAuthRequired = false;
+    /**
+     * Constructs a new KeyUserImportPrompter.
+     *
+     * @param {SystemLookup} systemLookup - The system lookup.
+     * @param {string} componentId - The component ID.
+     * @param {AbapServiceProvider} defaultProvider - The default provider.
+     * @param {string} defaultSystem - The default system.
+     * @param {ToolsLogger} logger - The logger.
+     */
+    constructor(systemLookup, componentId, defaultProvider, defaultSystem, logger) {
+        this.systemLookup = systemLookup;
+        this.componentId = componentId;
+        this.defaultProvider = defaultProvider;
+        this.defaultSystem = defaultSystem;
+        this.logger = logger;
+        this.provider = defaultProvider;
+    }
+    /**
+     * Returns the key-user changes.
+     *
+     * @returns {KeyUserChangeContent[]} The key-user changes.
+     */
+    get changes() {
+        return this.keyUserChanges;
+    }
+    /**
+     * Builds the prompts for the key-user import page.
+     *
+     * @param {KeyUserImportPromptOptions} [promptOptions] - Per-prompt settings (hide/default).
+     * @returns {KeyUserImportQuestion[]} Questions for the key-user import page.
+     */
+    getPrompts(promptOptions) {
+        const keyedPrompts = {
+            [types_1.keyUserPromptNames.keyUserSystem]: this.getSystemPrompt(promptOptions?.[types_1.keyUserPromptNames.keyUserSystem]),
+            [types_1.keyUserPromptNames.keyUserUsername]: this.getUsernamePrompt(promptOptions?.[types_1.keyUserPromptNames.keyUserUsername]),
+            [types_1.keyUserPromptNames.keyUserPassword]: this.getPasswordPrompt(promptOptions?.[types_1.keyUserPromptNames.keyUserPassword]),
+            [types_1.keyUserPromptNames.keyUserAdaptation]: this.getAdaptationPrompt(promptOptions?.[types_1.keyUserPromptNames.keyUserAdaptation])
+        };
+        const questions = Object.entries(keyedPrompts)
+            .filter(([promptName, _]) => {
+            const options = promptOptions?.[promptName];
+            return !(options && 'hide' in options && options.hide);
+        })
+            .map(([_, question]) => question);
+        return questions;
+    }
+    /**
+     * Returns the system prompt.
+     *
+     * @param {KeyUserSystemPromptOptions} [options] - The options for the system prompt.
+     * @returns {KeyUserImportQuestion} The system prompt.
+     */
+    getSystemPrompt(options) {
+        return {
+            type: 'list',
+            name: types_1.keyUserPromptNames.keyUserSystem,
+            message: (0, i18n_1.t)('prompts.systemLabel'),
+            choices: async () => {
+                const systems = await this.systemLookup.getSystems();
+                return (0, choices_1.getKeyUserSystemChoices)(systems, this.defaultSystem);
+            },
+            guiOptions: {
+                mandatory: true,
+                breadcrumb: true
+            },
+            default: options?.default ?? '',
+            validate: async (value, answers) => await this.validateSystem(value, answers)
+        };
+    }
+    /**
+     * Returns the username prompt.
+     *
+     * @param {KeyUserUsernamePromptOptions} [options] - The options for the username prompt.
+     * @returns {KeyUserImportQuestion} The username prompt.
+     */
+    getUsernamePrompt(options) {
+        return {
+            type: 'input',
+            name: types_1.keyUserPromptNames.keyUserUsername,
+            message: (0, i18n_1.t)('prompts.usernameLabel'),
+            default: options?.default ?? '',
+            filter: (val) => val.trim(),
+            guiOptions: {
+                mandatory: true
+            },
+            when: (answers) => !!answers.keyUserSystem && this.isAuthRequired,
+            validate: (value) => (0, project_input_validator_1.validateEmptyString)(value)
+        };
+    }
+    /**
+     * Returns the password prompt.
+     *
+     * @param {KeyUserPasswordPromptOptions} [options] - The options for the password prompt.
+     * @returns {KeyUserImportQuestion} The password prompt.
+     */
+    getPasswordPrompt(options) {
+        return {
+            type: 'password',
+            name: types_1.keyUserPromptNames.keyUserPassword,
+            message: (0, i18n_1.t)('prompts.passwordLabel'),
+            mask: '*',
+            default: options?.default ?? '',
+            guiOptions: {
+                mandatory: true,
+                type: 'login'
+            },
+            when: (answers) => !!answers.keyUserSystem && this.isAuthRequired,
+            validate: async (value, answers) => await this.validatePassword(value, answers)
+        };
+    }
+    /**
+     * Returns the adaptation prompt.
+     *
+     * @param {KeyUserAdaptationPromptOptions} [_] - The options for the adaptation prompt.
+     * @returns {KeyUserImportQuestion} The adaptation prompt.
+     */
+    getAdaptationPrompt(_) {
+        return {
+            type: 'list',
+            name: types_1.keyUserPromptNames.keyUserAdaptation,
+            message: (0, i18n_1.t)('prompts.keyUserAdaptationLabel'),
+            guiOptions: {
+                mandatory: true,
+                breadcrumb: (0, i18n_1.t)('prompts.keyUserAdaptationBreadcrumb')
+            },
+            choices: () => (0, choices_1.getAdaptationChoices)(this.adaptations),
+            default: () => (0, choices_1.getAdaptationChoices)(this.adaptations)[0]?.name,
+            validate: async (adaptation) => await this.validateKeyUserChanges(adaptation?.id),
+            when: () => this.adaptations.length > 1
+        };
+    }
+    /**
+     * Loads adaptations for the current provider.
+     */
+    async loadAdaptations() {
+        const version = determineFlexVersion(this.flexVersions);
+        const lrep = this.provider?.getLayeredRepository();
+        const response = await lrep?.listAdaptations(this.componentId, version);
+        this.adaptations = response?.adaptations ?? [];
+        this.logger.log(`Loaded adaptations: ${JSON.stringify(this.adaptations, null, 2)}`);
+        if (!this.adaptations.length) {
+            throw new Error((0, i18n_1.t)('error.keyUserNoAdaptations'));
+        }
+    }
+    /**
+     * Loads flex versions for the current provider.
+     */
+    async loadFlexVersions() {
+        const lrep = this.provider?.getLayeredRepository();
+        const response = await lrep?.getFlexVersions(this.componentId);
+        this.flexVersions = response?.versions ?? [];
+        this.logger.log(`Loaded flex versions: ${JSON.stringify(this.flexVersions, null, 2)}`);
+    }
+    /**
+     * Resets the state by clearing adaptations, flex versions, and key-user changes.
+     */
+    resetState() {
+        this.flexVersions = [];
+        this.adaptations = [];
+        this.keyUserChanges = [];
+    }
+    /**
+     * Loads flex versions and adaptations, then validates key-user changes if only DEFAULT adaptation exists.
+     *
+     * @returns The result of key-user validation if only DEFAULT exists, or true.
+     */
+    async loadDataAndValidateKeyUserChanges() {
+        /**
+         * Ensure provider is authenticated for CloudReady systems before making API calls
+         */
+        await this.provider.isAbapCloud();
+        await this.loadFlexVersions();
+        await this.loadAdaptations();
+        if (this.adaptations.length === 1 && this.adaptations[0]?.id === exports.DEFAULT_ADAPTATION_ID) {
+            return await this.validateKeyUserChanges(exports.DEFAULT_ADAPTATION_ID);
+        }
+        return true;
+    }
+    /**
+     * Validates the system selection by testing the connection.
+     *
+     * @param {string} system - The selected system.
+     * @param {KeyUserImportAnswers} answers - The configuration answers provided by the user.
+     * @returns An error message if validation fails, or true if the system selection is valid.
+     */
+    async validateSystem(system, answers) {
+        const validationResult = (0, project_input_validator_1.validateEmptyString)(system);
+        if (typeof validationResult === 'string') {
+            return validationResult;
+        }
+        try {
+            this.resetState();
+            if (system === this.defaultSystem && this.defaultProvider) {
+                this.provider = this.defaultProvider;
+                this.isAuthRequired = false;
+                return await this.loadDataAndValidateKeyUserChanges();
+            }
+            this.isAuthRequired = await this.systemLookup.getSystemRequiresAuth(system);
+            if (!this.isAuthRequired) {
+                const options = {
+                    system,
+                    client: undefined,
+                    username: answers.keyUserUsername,
+                    password: answers.keyUserPassword
+                };
+                this.provider = await (0, adp_tooling_1.getConfiguredProvider)(options, this.logger);
+                return await this.loadDataAndValidateKeyUserChanges();
+            }
+        }
+        catch (e) {
+            return e.message;
+        }
+        return true;
+    }
+    /**
+     * Validates the password by testing the connection.
+     *
+     * @param {string} password - The inputted password.
+     * @param {KeyUserImportAnswers} answers - The configuration answers provided by the user.
+     * @returns An error message if validation fails, or true if the password is valid.
+     */
+    async validatePassword(password, answers) {
+        const validationResult = (0, project_input_validator_1.validateEmptyString)(password);
+        if (typeof validationResult === 'string') {
+            return validationResult;
+        }
+        try {
+            this.resetState();
+            const options = {
+                system: answers.keyUserSystem,
+                client: undefined,
+                username: answers.keyUserUsername,
+                password
+            };
+            this.provider = await (0, adp_tooling_1.getConfiguredProvider)(options, this.logger);
+            return await this.loadDataAndValidateKeyUserChanges();
+        }
+        catch (e) {
+            return e.message;
+        }
+    }
+    /**
+     * Validates the key-user changes by testing the connection.
+     *
+     * @param {string} adaptationId - The selected adaptation.
+     * @returns An error message if validation fails, or true if the key-user changes are valid.
+     */
+    async validateKeyUserChanges(adaptationId) {
+        try {
+            if (!this.provider || !adaptationId) {
+                return false;
+            }
+            const lrep = this.provider?.getLayeredRepository();
+            const data = await lrep?.getKeyUserData(this.componentId, adaptationId);
+            this.keyUserChanges = data?.contents ?? [];
+            this.logger.debug(`Retrieved ${this.keyUserChanges.length} key-user change(s) for adaptation ${adaptationId}`);
+            if (!this.keyUserChanges.length) {
+                if (adaptationId === exports.DEFAULT_ADAPTATION_ID && this.adaptations.length === 1) {
+                    return (0, i18n_1.t)('error.keyUserNoChangesDefault');
+                }
+                this.logger.warn(`No key-user changes found for adaptation: ${adaptationId}`);
+                return (0, i18n_1.t)('error.keyUserNoChangesAdaptation', { adaptationId });
+            }
+            return true;
+        }
+        catch (e) {
+            this.logger.error(`Error validating key-user changes for adaptation ${adaptationId}: ${e.message}`);
+            this.logger.debug(e);
+            if ((0, axios_extension_1.isAxiosError)(e) && (e.response?.status === 405 || e.response?.status === 404)) {
+                return (0, i18n_1.t)('error.keyUserNotSupported');
+            }
+            return e.message;
+        }
+    }
+}
+exports.KeyUserImportPrompter = KeyUserImportPrompter;
+//# sourceMappingURL=key-user.js.map

package/generators/app/types.d.ts

@@ -2,6 +2,7 @@ import type Generator from 'yeoman-generator';
 import type { AppWizard } from '@sap-devx/yeoman-ui-types';
 import type { YUIQuestion } from '@sap-ux/inquirer-common';
 import type { TelemetryData } from '@sap-ux/fiori-generator-shared';
+import type { AdaptationDescriptor } from '@sap-ux/axios-extension';
 import type { AttributesAnswers, ConfigAnswers } from '@sap-ux/adp-tooling';
 export interface AdpGeneratorOptions extends Generator.GeneratorOptions {
     /**
@@ -96,7 +97,8 @@ export declare enum attributePromptNames {
     ui5ValidationCli = "ui5ValidationCli",
     enableTypeScript = "enableTypeScript",
     addDeployConfig = "addDeployConfig",
-    addFlpConfig = "addFlpConfig"
+    addFlpConfig = "addFlpConfig",
+    importKeyUserChanges = "importKeyUserChanges"
 }
 export type AttributesQuestion = YUIQuestion<AttributesAnswers>;
 export interface ProjectNamePromptOptions {
@@ -128,6 +130,10 @@ export interface AddFlpConfigPromptOptions {
     hide?: boolean;
     hasBaseAppInbounds?: boolean;
 }
+export interface ImportKeyUserChangesPromptOptions {
+    hide?: boolean;
+    default?: boolean;
+}
 export type AttributePromptOptions = Partial<{
     [attributePromptNames.projectName]: ProjectNamePromptOptions;
     [attributePromptNames.title]: ApplicationTitlePromptOptions;
@@ -138,7 +144,49 @@ export type AttributePromptOptions = Partial<{
     [attributePromptNames.enableTypeScript]: EnableTypeScriptPromptOptions;
     [attributePromptNames.addDeployConfig]: AddDeployConfigPromptOptions;
     [attributePromptNames.addFlpConfig]: AddFlpConfigPromptOptions;
+    [attributePromptNames.importKeyUserChanges]: ImportKeyUserChangesPromptOptions;
 }>;
+export type KeyUserImportQuestion = YUIQuestion<KeyUserImportAnswers>;
+/**
+ * Enumeration of prompt names used in the key-user import.
+ */
+export declare enum keyUserPromptNames {
+    keyUserSystem = "keyUserSystem",
+    keyUserUsername = "keyUserUsername",
+    keyUserPassword = "keyUserPassword",
+    keyUserAdaptation = "keyUserAdaptation"
+}
+export interface KeyUserSystemPromptOptions {
+    default?: string;
+    hide?: boolean;
+}
+export interface KeyUserUsernamePromptOptions {
+    default?: string;
+    hide?: boolean;
+}
+export interface KeyUserPasswordPromptOptions {
+    default?: string;
+    hide?: boolean;
+}
+export interface KeyUserAdaptationPromptOptions {
+    default?: string;
+    hide?: boolean;
+}
+/**
+ * Options for the key-user import inquirer & the prompts.
+ */
+export type KeyUserImportPromptOptions = Partial<{
+    [keyUserPromptNames.keyUserSystem]: KeyUserSystemPromptOptions;
+    [keyUserPromptNames.keyUserUsername]: KeyUserUsernamePromptOptions;
+    [keyUserPromptNames.keyUserPassword]: KeyUserPasswordPromptOptions;
+    [keyUserPromptNames.keyUserAdaptation]: KeyUserAdaptationPromptOptions;
+}>;
+export interface KeyUserImportAnswers {
+    keyUserSystem: string;
+    keyUserUsername?: string;
+    keyUserPassword?: string;
+    keyUserAdaptation: AdaptationDescriptor;
+}
 export declare enum targetEnvPromptNames {
     targetEnv = "targetEnv"
 }

package/generators/app/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cfLoginPromptNames = exports.TargetEnv = exports.targetEnvPromptNames = exports.attributePromptNames = exports.configPromptNames = void 0;
+exports.cfLoginPromptNames = exports.TargetEnv = exports.targetEnvPromptNames = exports.keyUserPromptNames = exports.attributePromptNames = exports.configPromptNames = void 0;
 /**
  * Enumeration of prompt names used in the configuration.
  */
@@ -27,7 +27,18 @@ var attributePromptNames;
     attributePromptNames["enableTypeScript"] = "enableTypeScript";
     attributePromptNames["addDeployConfig"] = "addDeployConfig";
     attributePromptNames["addFlpConfig"] = "addFlpConfig";
+    attributePromptNames["importKeyUserChanges"] = "importKeyUserChanges";
 })(attributePromptNames || (exports.attributePromptNames = attributePromptNames = {}));
+/**
+ * Enumeration of prompt names used in the key-user import.
+ */
+var keyUserPromptNames;
+(function (keyUserPromptNames) {
+    keyUserPromptNames["keyUserSystem"] = "keyUserSystem";
+    keyUserPromptNames["keyUserUsername"] = "keyUserUsername";
+    keyUserPromptNames["keyUserPassword"] = "keyUserPassword";
+    keyUserPromptNames["keyUserAdaptation"] = "keyUserAdaptation";
+})(keyUserPromptNames || (exports.keyUserPromptNames = keyUserPromptNames = {}));
 var targetEnvPromptNames;
 (function (targetEnvPromptNames) {
     targetEnvPromptNames["targetEnv"] = "targetEnv";

package/generators/translations/generator-adp.i18n.json

@@ -4,6 +4,8 @@
         "configurationDescr": "Configure the system and select an application.",
         "projectAttributesName": "Project Attributes",
         "projectAttributesDescr": "Configure the main project attributes.",
+        "keyUserImportName": "Import Key User Changes",
+        "keyUserImportDescr": "You can either continue with the pre-selected source system or choose a system from which the key-user changes are taken over.",
         "flpConfigName": "SAP Fiori Launchpad Configuration: Tile Settings",
         "tileSettingsName": "SAP Fiori Launchpad Configuration: Tile Handling",
         "tileSettingsDescr": "Add a new tile or replace existing tiles of the base application.\nProject: {{projectName}}",
@@ -48,6 +50,9 @@
         "ui5VersionTooltip": "Select the SAPUI5 version you want to use to preview your app variant.",
         "addDeployConfig": "Add Deployment Configuration",
         "addFlpConfig": "Add SAP Fiori Launchpad Configuration",
+        "importKeyUserChangesLabel": "Import Key User Changes",
+        "keyUserAdaptationLabel": "Context-Based Adaptation",
+        "keyUserAdaptationBreadcrumb": "Adaptation",
         "targetEnvLabel": "Environment",
         "targetEnvTooltip": "Select the target environment for your Adaptation Project.",
         "targetEnvBreadcrumb": "Target Environment",
@@ -104,7 +109,11 @@
         "projectDoesNotExist": "The project does not exist. Please select an MTA project.",
         "projectDoesNotExistMta": "Provide the path to the MTA project where you want to have your Adaptation Project created.",
         "noAdaptableBusinessServiceFoundInMta": "No adaptable business service found in the MTA.",
-        "fetchBaseInboundsFailed": "Fetching base application inbounds failed: {{error}}."
+        "fetchBaseInboundsFailed": "Fetching base application inbounds failed: {{error}}.",
+        "keyUserNoChangesDefault": "Only a single adaptation ('DEFAULT') was found and no key-user changes were found for it. Please select a different system to continue, or navigate back to the 'Project Attributes' page and choose not to import key-user changes.",
+        "keyUserNoChangesAdaptation": "No key-user changes have been found for the '{{adaptationId}}' adaptation. Please select a different adaptation.",
+        "keyUserNoAdaptations": "No context-based adaptations have been found for the selected application. Please refer to the documentation.",
+        "keyUserNotSupported": "The selected system does not allow or support the import of key-user changes. Please refer to the documentation."
     },
     "validators": {
         "ui5VersionNotDetectedError": "The SAPUI5 version of the selected system cannot be determined. You are able to create and edit adaptation projects that use the latest SAPUI5 version, but they are not usable on this system until the system's SAPUI5 version is upgraded to version 1.71 or higher."

package/generators/utils/steps.d.ts

@@ -37,6 +37,12 @@ export declare function updateFlpWizardSteps(hasBaseAppInbound: boolean, prompts
  * @returns {IPrompt} The deployment configuration wizard page.
  */
 export declare function getDeployPage(): IPrompt;
+/**
+ * Returns the key user import page step.
+ *
+ * @returns {IPrompt} The key user import wizard page.
+ */
+export declare function getKeyUserImportPage(): IPrompt;
 /**
  * Dynamically adds or removes a step in the Yeoman UI wizard.
  *

package/generators/utils/steps.js

@@ -5,6 +5,7 @@ exports.updateCfWizardSteps = updateCfWizardSteps;
 exports.getFlpPages = getFlpPages;
 exports.updateFlpWizardSteps = updateFlpWizardSteps;
 exports.getDeployPage = getDeployPage;
+exports.getKeyUserImportPage = getKeyUserImportPage;
 exports.updateWizardSteps = updateWizardSteps;
 exports.getSubGenErrorPage = getSubGenErrorPage;
 exports.getSubGenAuthPages = getSubGenAuthPages;
@@ -94,6 +95,14 @@ function updateFlpWizardSteps(hasBaseAppInbound, prompts, projectName, shouldAdd
 function getDeployPage() {
     return { name: (0, i18n_1.t)('yuiNavSteps.deployConfigName'), description: (0, i18n_1.t)('yuiNavSteps.deployConfigDescr') };
 }
+/**
+ * Returns the key user import page step.
+ *
+ * @returns {IPrompt} The key user import wizard page.
+ */
+function getKeyUserImportPage() {
+    return { name: (0, i18n_1.t)('yuiNavSteps.keyUserImportName'), description: (0, i18n_1.t)('yuiNavSteps.keyUserImportDescr') };
+}
 /**
  * Dynamically adds or removes a step in the Yeoman UI wizard.
  *

package/package.json

@@ -3,7 +3,7 @@
   "displayName": "SAPUI5 Adaptation Project",
   "homepage": "https://help.sap.com/viewer/584e0bcbfd4a4aff91c815cefa0bce2d/Cloud/en-US/ada9567b767941aba8d49fdb4fdedea7.html",
   "description": "Adaptation project allows you to create an app variant for an existing SAP Fiori elements-based or SAPUI5 freestyle application, without changing the original application.",
-  "version": "0.7.44",
+  "version": "0.8.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/SAP/open-ux-tools.git",
@@ -30,15 +30,15 @@
     "i18next": "25.8.0",
     "yeoman-generator": "5.10.0",
     "uuid": "10.0.0",
-    "@sap-ux/adp-tooling": "0.18.44",
-    "@sap-ux/axios-extension": "1.25.6",
+    "@sap-ux/adp-tooling": "0.18.45",
+    "@sap-ux/axios-extension": "1.25.7",
     "@sap-ux/btp-utils": "1.1.6",
     "@sap-ux/feature-toggle": "0.3.5",
     "@sap-ux/inquirer-common": "0.10.17",
     "@sap-ux/logger": "0.8.0",
     "@sap-ux/project-access": "1.34.2",
     "@sap-ux/store": "1.5.1",
-    "@sap-ux/system-access": "0.6.42",
+    "@sap-ux/system-access": "0.6.43",
     "@sap-ux/project-input-validator": "0.6.46",
     "@sap-ux/fiori-generator-shared": "0.13.57",
     "@sap-ux/odata-service-writer": "0.29.9",
@@ -57,7 +57,7 @@
     "fs-extra": "10.0.0",
     "rimraf": "6.0.1",
     "yeoman-test": "6.3.0",
-    "@sap-ux/deploy-config-sub-generator": "0.5.53"
+    "@sap-ux/deploy-config-sub-generator": "0.5.54"
   },
   "engines": {
     "node": ">=20.x"