@sap-ux/generator-adp 0.3.46 → 0.3.47

package/generators/add-annotations-to-odata/index.d.ts

@@ -0,0 +1,28 @@
+import SubGeneratorWithAuthBase from '../base/sub-gen-auth-base';
+import type { GeneratorOpts } from '../utils/opts';
+/**
+ * Generator for adding annotations to OData services.
+ */
+declare class AddAnnotationsToDataGenerator extends SubGeneratorWithAuthBase {
+    /**
+     * The answers from the prompts.
+     */
+    private answers;
+    /**
+     * The data sources from the manifest.
+     */
+    private dataSources;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts);
+    initializing(): Promise<void>;
+    prompting(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+}
+export = AddAnnotationsToDataGenerator;
+//# sourceMappingURL=index.d.ts.map

package/generators/add-annotations-to-odata/index.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const yeoman_ui_types_1 = require("@sap-devx/yeoman-ui-types");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const odata_service_writer_1 = require("@sap-ux/odata-service-writer");
+const i18n_1 = require("../utils/i18n");
+const types_1 = require("../types");
+const sub_gen_auth_base_1 = __importDefault(require("../base/sub-gen-auth-base"));
+/**
+ * Generator for adding annotations to OData services.
+ */
+class AddAnnotationsToDataGenerator extends sub_gen_auth_base_1.default {
+    /**
+     * The answers from the prompts.
+     */
+    answers;
+    /**
+     * The data sources from the manifest.
+     */
+    dataSources;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args, opts) {
+        super(args, opts, types_1.GeneratorTypes.ADD_ANNOTATIONS_TO_DATA);
+    }
+    async initializing() {
+        await this.onInit();
+    }
+    async prompting() {
+        try {
+            const manifest = await this.getManifest();
+            this.dataSources = manifest?.['sap.app']?.dataSources ?? {};
+            this.answers = await this.prompt((0, adp_tooling_1.getPromptsForAddAnnotationsToOData)(this.projectPath, this.dataSources));
+            this.logger.log(`Current OData services\n${JSON.stringify(this.answers, null, 2)}`);
+        }
+        catch (e) {
+            await this.handleRuntimeCrash(e.message);
+        }
+    }
+    async writing() {
+        const changeData = {
+            variant: this.variant,
+            isCommand: true,
+            annotation: {
+                dataSource: this.answers.id,
+                filePath: this.answers.filePath,
+                serviceUrl: this.dataSources?.[this.answers.id]?.uri
+            }
+        };
+        if (!this.answers.filePath) {
+            const metadata = await this.manifestService.getDataSourceMetadata(this.answers.id);
+            changeData.annotation.namespaces = (0, odata_service_writer_1.getAnnotationNamespaces)({ metadata });
+        }
+        await (0, adp_tooling_1.generateChange)(this.projectPath, "appdescr_app_addAnnotationsToOData" /* ChangeType.ADD_ANNOTATIONS_TO_ODATA */, changeData, this.fs);
+        this.logger.log('Change written to changes folder');
+        if (this.answers.fileSelectOption === 2 /* AnnotationFileSelectType.NewEmptyFile */) {
+            this.appWizard.showInformation((0, i18n_1.t)('prompts.emptyAnnotationFile'), yeoman_ui_types_1.MessageType.notification);
+        }
+    }
+    end() {
+        this.logger.log('Successfully created annotation file!');
+    }
+}
+module.exports = AddAnnotationsToDataGenerator;
+//# sourceMappingURL=index.js.map

package/generators/add-component-usages/index.d.ts

@@ -0,0 +1,38 @@
+import type { GeneratorOpts } from '../utils/opts';
+import SubGeneratorBase from '../base/sub-gen-base';
+/**
+ * Generator for adding component usages to a project.
+ */
+declare class AddComponentUsagesGenerator extends SubGeneratorBase {
+    /**
+     * The answers from the prompts.
+     */
+    private answers;
+    /**
+     * The variant.
+     */
+    private variant;
+    /**
+     * The project path.
+     */
+    private readonly projectPath;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts);
+    initializing(): Promise<void>;
+    prompting(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+    /**
+     * Creates the component usage data.
+     *
+     * @returns {ComponentUsagesData} The component usage data.
+     */
+    private _createComponentUsageData;
+}
+export = AddComponentUsagesGenerator;
+//# sourceMappingURL=index.d.ts.map

package/generators/add-component-usages/index.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const yeoman_ui_types_1 = require("@sap-devx/yeoman-ui-types");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const types_1 = require("../types");
+const i18n_1 = require("../utils/i18n");
+const sub_gen_base_1 = __importDefault(require("../base/sub-gen-base"));
+/**
+ * Generator for adding component usages to a project.
+ */
+class AddComponentUsagesGenerator extends sub_gen_base_1.default {
+    /**
+     * The answers from the prompts.
+     */
+    answers;
+    /**
+     * The variant.
+     */
+    variant;
+    /**
+     * The project path.
+     */
+    projectPath;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args, opts) {
+        super(args, opts, types_1.GeneratorTypes.ADD_COMPONENT_USAGES);
+        if (opts.data) {
+            this.projectPath = opts.data.path;
+        }
+    }
+    async initializing() {
+        await (0, i18n_1.initI18n)();
+        try {
+            this._registerPrompts(new yeoman_ui_types_1.Prompts([
+                {
+                    name: (0, i18n_1.t)('yuiNavSteps.addComponentUsagesName'),
+                    description: (0, i18n_1.t)('yuiNavSteps.addComponentUsagesDescr')
+                }
+            ]));
+            this.variant = await (0, adp_tooling_1.getVariant)(this.projectPath);
+        }
+        catch (e) {
+            this.appWizard.showError(e.message, yeoman_ui_types_1.MessageType.notification);
+            this.validationError = e;
+            this.logger.error(e);
+        }
+    }
+    async prompting() {
+        if (this.validationError) {
+            await this.handleRuntimeCrash(this.validationError.message);
+            return;
+        }
+        this.answers = await this.prompt((0, adp_tooling_1.getPromptsForAddComponentUsages)(this.projectPath, this.variant.layer));
+        this.logger.log(`Current answers\n${JSON.stringify(this.answers, null, 2)}`);
+    }
+    async writing() {
+        await (0, adp_tooling_1.generateChange)(this.projectPath, "appdescr_ui5_addComponentUsages" /* ChangeType.ADD_COMPONENT_USAGES */, this._createComponentUsageData(), this.fs);
+        this.logger.log(`Changes written to changes folder`);
+    }
+    end() {
+        this.logger.log('Successfully created change!');
+    }
+    /**
+     * Creates the component usage data.
+     *
+     * @returns {ComponentUsagesData} The component usage data.
+     */
+    _createComponentUsageData() {
+        const { usageId, data, settings, isLazy, name, shouldAddLibrary } = this.answers;
+        return {
+            variant: this.variant,
+            component: {
+                data,
+                usageId,
+                settings,
+                isLazy,
+                name
+            },
+            ...(shouldAddLibrary && {
+                library: {
+                    reference: this.answers.library,
+                    referenceIsLazy: this.answers.libraryIsLazy
+                }
+            })
+        };
+    }
+}
+module.exports = AddComponentUsagesGenerator;
+//# sourceMappingURL=index.js.map

package/generators/add-new-model/index.d.ts

@@ -0,0 +1,38 @@
+import type { GeneratorOpts } from '../utils/opts';
+import SubGeneratorBase from '../base/sub-gen-base';
+/**
+ * Generator for adding a new model to an OData service.
+ */
+declare class AddNewModelGenerator extends SubGeneratorBase {
+    /**
+     * The answers from the prompts.
+     */
+    private answers;
+    /**
+     * The variant.
+     */
+    private variant;
+    /**
+     * The project path.
+     */
+    private readonly projectPath;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts);
+    initializing(): Promise<void>;
+    prompting(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+    /**
+     * Creates the new model data.
+     *
+     * @returns {NewModelData} The new model data.
+     */
+    private _createNewModelData;
+}
+export = AddNewModelGenerator;
+//# sourceMappingURL=index.d.ts.map

package/generators/add-new-model/index.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const yeoman_ui_types_1 = require("@sap-devx/yeoman-ui-types");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const types_1 = require("../types");
+const i18n_1 = require("../utils/i18n");
+const sub_gen_base_1 = __importDefault(require("../base/sub-gen-base"));
+/**
+ * Generator for adding a new model to an OData service.
+ */
+class AddNewModelGenerator extends sub_gen_base_1.default {
+    /**
+     * The answers from the prompts.
+     */
+    answers;
+    /**
+     * The variant.
+     */
+    variant;
+    /**
+     * The project path.
+     */
+    projectPath;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args, opts) {
+        super(args, opts, types_1.GeneratorTypes.ADD_NEW_MODEL);
+        if (opts.data) {
+            this.projectPath = opts.data.path;
+        }
+    }
+    async initializing() {
+        await (0, i18n_1.initI18n)();
+        try {
+            this._registerPrompts(new yeoman_ui_types_1.Prompts([
+                { name: (0, i18n_1.t)('yuiNavSteps.addNewModelName'), description: (0, i18n_1.t)('yuiNavSteps.addNewModelDescr') }
+            ]));
+            this.variant = await (0, adp_tooling_1.getVariant)(this.projectPath);
+        }
+        catch (e) {
+            this.appWizard.showError(e.message, yeoman_ui_types_1.MessageType.notification);
+            this.validationError = e;
+            this.logger.error(e);
+        }
+    }
+    async prompting() {
+        if (this.validationError) {
+            await this.handleRuntimeCrash(this.validationError.message);
+            return;
+        }
+        this.answers = await this.prompt((0, adp_tooling_1.getPromptsForNewModel)(this.projectPath, this.variant.layer));
+        this.logger.log(`Current answers\n${JSON.stringify(this.answers, null, 2)}`);
+    }
+    async writing() {
+        await (0, adp_tooling_1.generateChange)(this.projectPath, "appdescr_ui5_addNewModel" /* ChangeType.ADD_NEW_MODEL */, this._createNewModelData(), this.fs);
+        this.logger.log('Change written to changes folder');
+    }
+    end() {
+        this.logger.log('Successfully created change!');
+    }
+    /**
+     * Creates the new model data.
+     *
+     * @returns {NewModelData} The new model data.
+     */
+    _createNewModelData() {
+        const { name, uri, modelName, version, modelSettings, addAnnotationMode } = this.answers;
+        return {
+            variant: this.variant,
+            service: {
+                name,
+                uri,
+                modelName,
+                version,
+                modelSettings
+            },
+            ...(addAnnotationMode && {
+                annotation: {
+                    dataSourceName: this.answers.dataSourceName,
+                    dataSourceURI: this.answers.dataSourceURI,
+                    settings: this.answers.annotationSettings
+                }
+            })
+        };
+    }
+}
+module.exports = AddNewModelGenerator;
+//# sourceMappingURL=index.js.map

package/generators/app/index.js

@@ -25,6 +25,7 @@ const appWizardCache_1 = require("../utils/appWizardCache");
 const default_values_1 = require("./questions/helper/default-values");
 const steps_1 = require("../utils/steps");
 const workspace_1 = require("../utils/workspace");
+const generatorTitle = 'Adaptation Project';
 /**
  * Generator for creating an Adaptation Project.
  *
@@ -117,7 +118,7 @@ class default_1 extends yeoman_generator_1.default {
             this.env.lookup({
                 packagePatterns: ['@sap/generator-fiori', '@sap-ux/adp-flp-config-sub-generator']
             });
-            (0, opts_1.setHeaderTitle)(opts, this.logger);
+            (0, opts_1.setHeaderTitle)(opts, this.logger, generatorTitle);
             (0, appWizardCache_1.initCache)(this.logger, this.appWizard);
             this.prompts = new yeoman_ui_types_1.Prompts([]);
             this.setPromptsCallback = (fn) => {

package/generators/base/questions/credentials.d.ts

@@ -0,0 +1,13 @@
+import type { ToolsLogger } from '@sap-ux/logger';
+import type { AbapTarget } from '@sap-ux/system-access';
+import type { YUIQuestion } from '@sap-ux/inquirer-common';
+import type { Credentials } from '../../types';
+/**
+ * Returns the username prompt.
+ *
+ * @param {AbapTarget} abapTarget - The ABAP target.
+ * @param {ToolsLogger} logger - The logger.
+ * @returns {YUIQuestion<Credentials>[]} The username prompt.
+ */
+export declare function getCredentialsPrompts(abapTarget: AbapTarget, logger: ToolsLogger): YUIQuestion<Credentials>[];
+//# sourceMappingURL=credentials.d.ts.map

package/generators/base/questions/credentials.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCredentialsPrompts = getCredentialsPrompts;
+const btp_utils_1 = require("@sap-ux/btp-utils");
+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("../../app/types");
+/**
+ * Returns the username prompt.
+ *
+ * @param {AbapTarget} abapTarget - The ABAP target.
+ * @param {ToolsLogger} logger - The logger.
+ * @returns {YUIQuestion<Credentials>[]} The username prompt.
+ */
+function getCredentialsPrompts(abapTarget, logger) {
+    return [getUsernamePrompt(), getPasswordPrompt(abapTarget, logger)];
+}
+/**
+ * Returns the username prompt.
+ *
+ * @returns {InputQuestion<Credentials>} The username prompt.
+ */
+function getUsernamePrompt() {
+    return {
+        type: 'input',
+        name: types_1.configPromptNames.username,
+        message: (0, i18n_1.t)('prompts.usernameLabel'),
+        validate: project_input_validator_1.validateEmptyString,
+        guiOptions: {
+            mandatory: true
+        }
+    };
+}
+/**
+ * Returns the password prompt.
+ *
+ * @param {AbapTarget} abapTarget - The ABAP target.
+ * @param {ToolsLogger} logger - The logger.
+ * @returns {PasswordQuestion<Credentials>} The password prompt.
+ */
+function getPasswordPrompt(abapTarget, logger) {
+    const system = ((0, btp_utils_1.isAppStudio)() ? abapTarget.destination : abapTarget.url) ?? '';
+    return {
+        type: 'password',
+        name: types_1.configPromptNames.password,
+        message: (0, i18n_1.t)('prompts.passwordLabel'),
+        mask: '*',
+        guiOptions: {
+            mandatory: true,
+            type: 'login'
+        },
+        validate: async (value, answers) => {
+            const validationResult = (0, project_input_validator_1.validateEmptyString)(value);
+            if (typeof validationResult === 'string') {
+                return validationResult;
+            }
+            if (!answers.username) {
+                return (0, i18n_1.t)('error.pleaseProvideAllRequiredData');
+            }
+            try {
+                const options = {
+                    system,
+                    client: abapTarget.client ?? '',
+                    username: answers.username,
+                    password: value
+                };
+                const abapProvider = await (0, adp_tooling_1.getConfiguredProvider)(options, logger);
+                await (0, adp_tooling_1.getSystemUI5Version)(abapProvider);
+                return true;
+            }
+            catch (e) {
+                return e.response ? `Login failed: ${e.response.status} ${e.response.statusText}` : 'Login failed.';
+            }
+        }
+    };
+}
+//# sourceMappingURL=credentials.js.map

package/generators/base/sub-gen-auth-base.d.ts

@@ -0,0 +1,70 @@
+import type { Manifest } from '@sap-ux/project-access';
+import { type AbapTarget } from '@sap-ux/system-access';
+import type { DescriptorVariant } from '@sap-ux/adp-tooling';
+import { ManifestService, SystemLookup } from '@sap-ux/adp-tooling';
+import SubGeneratorBase from './sub-gen-base';
+import type { GeneratorOpts } from '../utils/opts';
+import type { GeneratorTypes } from '../types';
+/**
+ * Base class for *sub* generators that need authentication handling.
+ * Adds functionality on top of {@link SubGeneratorBase}.
+ */
+export default class SubGeneratorWithAuthBase extends SubGeneratorBase {
+    /**
+     * The ABAP target.
+     */
+    protected abapTarget: AbapTarget;
+    /**
+     * The project data.
+     */
+    protected system: string;
+    /**
+     * The project path.
+     */
+    protected readonly projectPath: string;
+    /**
+     * The type of generator.
+     */
+    protected readonly generatorType: GeneratorTypes;
+    /**
+     * The manifest service.
+     */
+    manifestService: ManifestService;
+    /**
+     * Whether the generator requires authentication.
+     */
+    protected requiresAuth: boolean;
+    /**
+     * The descriptor variant.
+     */
+    protected variant: DescriptorVariant;
+    /**
+     * The system lookup instance.
+     */
+    protected systemLookup: SystemLookup;
+    /**
+     * The VSCode instance.
+     */
+    private readonly vscode;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {Generator.GeneratorOptions} opts - The options for the generator.
+     * @param {GeneratorTypes} type - The type of generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts, type: GeneratorTypes);
+    /**
+     * Executes logic that should happen during Yeoman's `initializing` phase.
+     * Subclasses must call this to benefit from the built-in auth handling.
+     */
+    protected onInit(): Promise<void>;
+    /**
+     * Retrieves and parses the manifest (app descriptor) of the current project.
+     * Requests credentials when required by the destination system.
+     *
+     * @returns {Promise<Manifest>} The manifest.
+     */
+    protected getManifest(): Promise<Manifest>;
+}
+//# sourceMappingURL=sub-gen-auth-base.d.ts.map

package/generators/base/sub-gen-auth-base.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const yeoman_ui_types_1 = require("@sap-devx/yeoman-ui-types");
+const btp_utils_1 = require("@sap-ux/btp-utils");
+const system_access_1 = require("@sap-ux/system-access");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const i18n_1 = require("../utils/i18n");
+const sub_gen_base_1 = __importDefault(require("./sub-gen-base"));
+const credentials_1 = require("./questions/credentials");
+const steps_1 = require("../utils/steps");
+/**
+ * Base class for *sub* generators that need authentication handling.
+ * Adds functionality on top of {@link SubGeneratorBase}.
+ */
+class SubGeneratorWithAuthBase extends sub_gen_base_1.default {
+    /**
+     * The ABAP target.
+     */
+    abapTarget;
+    /**
+     * The project data.
+     */
+    system;
+    /**
+     * The project path.
+     */
+    projectPath;
+    /**
+     * The type of generator.
+     */
+    generatorType;
+    /**
+     * The manifest service.
+     */
+    manifestService;
+    /**
+     * Whether the generator requires authentication.
+     */
+    requiresAuth = false;
+    /**
+     * The descriptor variant.
+     */
+    variant;
+    /**
+     * The system lookup instance.
+     */
+    systemLookup;
+    /**
+     * The VSCode instance.
+     */
+    vscode;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {Generator.GeneratorOptions} opts - The options for the generator.
+     * @param {GeneratorTypes} type - The type of generator.
+     */
+    constructor(args, opts, type) {
+        super(args, opts, type);
+        this.generatorType = type;
+        try {
+            if (opts.data) {
+                this.projectPath = opts.data.path;
+            }
+            this.vscode = opts.vscode;
+        }
+        catch (e) {
+            this.validationError = e;
+        }
+    }
+    /**
+     * Executes logic that should happen during Yeoman's `initializing` phase.
+     * Subclasses must call this to benefit from the built-in auth handling.
+     */
+    async onInit() {
+        await (0, i18n_1.initI18n)();
+        if (this.validationError) {
+            this._registerPrompts(new yeoman_ui_types_1.Prompts((0, steps_1.getSubGenErrorPage)(this.generatorType)));
+        }
+        else {
+            this._registerPrompts(new yeoman_ui_types_1.Prompts((0, steps_1.getSubGenAuthPages)(this.generatorType, this.system)));
+        }
+        this.systemLookup = new adp_tooling_1.SystemLookup(this.logger);
+        const adpConfig = await (0, adp_tooling_1.getAdpConfig)(this.projectPath, path_1.default.join(this.projectPath, 'ui5.yaml'));
+        this.abapTarget = adpConfig.target;
+        this.system = ((0, btp_utils_1.isAppStudio)() ? this.abapTarget.destination : this.abapTarget.url) ?? '';
+        this.logger.log(`Successfully retrieved abap target\n${JSON.stringify(this.abapTarget, null, 2)}`);
+        if (this.validationError) {
+            this.appWizard.showError(this.validationError.message, yeoman_ui_types_1.MessageType.notification);
+            await this.handleRuntimeCrash(this.validationError.message);
+            return;
+        }
+        try {
+            this.requiresAuth = await this.systemLookup.getSystemRequiresAuth(this.system);
+            this.logger.log(`System ${this.system} requires authentication: ${this.requiresAuth}`);
+            if (!this.requiresAuth) {
+                // Remove the credential page when authentication is not required
+                this.prompts.splice(0, 1, []);
+            }
+        }
+        catch (error) {
+            await this.handleRuntimeCrash(error.message);
+        }
+    }
+    /**
+     * Retrieves and parses the manifest (app descriptor) of the current project.
+     * Requests credentials when required by the destination system.
+     *
+     * @returns {Promise<Manifest>} The manifest.
+     */
+    async getManifest() {
+        let requestOptions;
+        if (this.requiresAuth) {
+            const credentials = (await this.prompt((0, credentials_1.getCredentialsPrompts)(this.abapTarget, this.logger)));
+            requestOptions = { auth: { username: credentials.username, password: credentials.password } };
+        }
+        this.variant = await (0, adp_tooling_1.getVariant)(this.projectPath);
+        const yamlPath = path_1.default.join(this.projectPath, 'ui5.yaml');
+        const { target, ignoreCertErrors = false } = await (0, adp_tooling_1.getAdpConfig)(this.projectPath, yamlPath);
+        const provider = await (0, system_access_1.createAbapServiceProvider)(target, { ...requestOptions, ignoreCertErrors }, true, this.logger);
+        this.manifestService = await adp_tooling_1.ManifestService.initMergedManifest(provider, this.projectPath, this.variant, this.logger);
+        const manifest = this.manifestService.getManifest();
+        const oDataSources = this.manifestService.getManifestDataSources();
+        this.logger.log(`OData sources from manifest\n${JSON.stringify(oDataSources, null, 2)}`);
+        const oDataTargetSources = Object.entries(oDataSources ?? {})
+            .filter((source) => source[1]?.type === 'OData')
+            .map((source) => {
+            return {
+                dataSourceName: source[0],
+                uri: source[1]?.uri,
+                annotations: source[1]?.settings?.annotations ?? []
+            };
+        });
+        this.logger.log(`OData target sources\n${JSON.stringify(oDataTargetSources, null, 2)}`);
+        return manifest;
+    }
+}
+exports.default = SubGeneratorWithAuthBase;
+//# sourceMappingURL=sub-gen-auth-base.js.map

package/generators/base/sub-gen-base.d.ts

@@ -0,0 +1,67 @@
+import Generator = require('yeoman-generator');
+import type { Prompts } from '@sap-devx/yeoman-ui-types';
+import { AppWizard } from '@sap-devx/yeoman-ui-types';
+import type { ToolsLogger } from '@sap-ux/logger';
+import type { GeneratorTypes } from '../types';
+import type { GeneratorOpts } from '../utils/opts';
+/**
+ * Shared base class for all ADP generators.
+ */
+export default class SubGeneratorBase extends Generator {
+    setPromptsCallback: (fn: any) => void;
+    prompts: Prompts;
+    /**
+     * Instance of the logger.
+     */
+    logger: ToolsLogger;
+    /**
+     * Instance of the app wizard.
+     */
+    protected readonly appWizard: AppWizard;
+    /**
+     * The type of generator.
+     */
+    protected readonly type: GeneratorTypes;
+    /**
+     * Captures validation errors occurring during construction so they can be surfaced later.
+     */
+    protected validationError: Error | undefined;
+    /**
+     * Stores a callback provided by Yeoman-UI when the <Prompts> instance is not
+     * yet created. This ensures the callback is attached once the prompts are
+     * available (e.g. after async i18n or system look-ups).
+     */
+    private pendingPromptsCallback?;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {Generator.GeneratorOptions} opts - The options for the generator.
+     * @param {GeneratorTypes} type - The type of generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts, type: GeneratorTypes);
+    /**
+     * Helper to create/update the prompts instance. Any pending Yeoman-UI
+     * callback that arrived before prompts existed will automatically be
+     * attached.
+     *
+     * @param {Prompts} prompts The newly created Prompts instance.
+     */
+    protected _registerPrompts(prompts: Prompts): void;
+    /**
+     * Centralized error handler that ensures resources are cleaned up and a helpful
+     * error prompt is shown to the user.
+     *
+     * @param {string} errorMessage - Human-readable error message.
+     * @returns {Promise<void>} A promise that resolves when the error is handled.
+     */
+    protected handleRuntimeCrash(errorMessage: string): Promise<void>;
+    /**
+     * Builds a Yeoman question that simply displays the error message and blocks the wizard.
+     *
+     * @param {string} errorMessage - Human-readable error message.
+     * @returns {YUIQuestion<InputQuestion>} The Yeoman question that displays the error message.
+     */
+    private _getErrorMessagePrompt;
+}
+//# sourceMappingURL=sub-gen-base.d.ts.map

package/generators/base/sub-gen-base.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Generator = require("yeoman-generator");
+const yeoman_ui_types_1 = require("@sap-devx/yeoman-ui-types");
+const i18n_1 = require("../utils/i18n");
+const opts_1 = require("../utils/opts");
+const logger_1 = __importDefault(require("../utils/logger"));
+/**
+ * Shared base class for all ADP generators.
+ */
+class SubGeneratorBase extends Generator {
+    setPromptsCallback;
+    prompts;
+    /**
+     * Instance of the logger.
+     */
+    logger;
+    /**
+     * Instance of the app wizard.
+     */
+    appWizard;
+    /**
+     * The type of generator.
+     */
+    type;
+    /**
+     * Captures validation errors occurring during construction so they can be surfaced later.
+     */
+    validationError;
+    /**
+     * Stores a callback provided by Yeoman-UI when the <Prompts> instance is not
+     * yet created. This ensures the callback is attached once the prompts are
+     * available (e.g. after async i18n or system look-ups).
+     */
+    pendingPromptsCallback;
+    /**
+     * Creates an instance of the generator.
+     *
+     * @param {string | string[]} args - The arguments passed to the generator.
+     * @param {Generator.GeneratorOptions} opts - The options for the generator.
+     * @param {GeneratorTypes} type - The type of generator.
+     */
+    constructor(args, opts, type) {
+        super(args, opts);
+        this.type = type;
+        this.appWizard = opts.appWizard ?? yeoman_ui_types_1.AppWizard.create(opts);
+        logger_1.default.configureLogging(this.options.logger, this.rootGeneratorName(), this.log, this.options.vscode, this.options.logLevel, this.options.logWrapper);
+        this.logger = logger_1.default.logger;
+        (0, opts_1.setHeaderTitle)(opts, this.logger, this.type);
+        this.setPromptsCallback = (fn) => {
+            // Persist callback so we can attach it once prompts are created
+            this.pendingPromptsCallback = fn;
+            if (this.prompts) {
+                this.prompts.setCallback(fn);
+            }
+        };
+    }
+    /**
+     * Helper to create/update the prompts instance. Any pending Yeoman-UI
+     * callback that arrived before prompts existed will automatically be
+     * attached.
+     *
+     * @param {Prompts} prompts The newly created Prompts instance.
+     */
+    _registerPrompts(prompts) {
+        this.prompts = prompts;
+        if (this.pendingPromptsCallback) {
+            this.prompts.setCallback(this.pendingPromptsCallback);
+        }
+    }
+    /**
+     * Centralized error handler that ensures resources are cleaned up and a helpful
+     * error prompt is shown to the user.
+     *
+     * @param {string} errorMessage - Human-readable error message.
+     * @returns {Promise<void>} A promise that resolves when the error is handled.
+     */
+    async handleRuntimeCrash(errorMessage) {
+        await this.prompt([this._getErrorMessagePrompt(errorMessage)]);
+    }
+    /**
+     * Builds a Yeoman question that simply displays the error message and blocks the wizard.
+     *
+     * @param {string} errorMessage - Human-readable error message.
+     * @returns {YUIQuestion<InputQuestion>} The Yeoman question that displays the error message.
+     */
+    _getErrorMessagePrompt(errorMessage) {
+        return {
+            type: 'input',
+            name: 'errorMessagePrompt',
+            message: (0, i18n_1.t)('error.backendCommunicationError'),
+            guiOptions: {
+                type: 'label',
+                hint: errorMessage
+            },
+            validate: () => false // Always keep the wizard on this page
+        };
+    }
+}
+exports.default = SubGeneratorBase;
+//# sourceMappingURL=sub-gen-base.js.map

package/generators/change-data-source/index.d.ts

@@ -0,0 +1,28 @@
+import type { GeneratorOpts } from '../utils/opts';
+import SubGeneratorWithAuthBase from '../base/sub-gen-auth-base';
+/**
+ * Generator for changing the data source of an OData service.
+ */
+declare class OdataServiceGenerator extends SubGeneratorWithAuthBase {
+    /**
+     * The answers for the generator.
+     */
+    private answers;
+    /**
+     * The data sources from the manifest.
+     */
+    private dataSources;
+    /**
+     * Constructor for the OdataServiceGenerator.
+     *
+     * @param {string | string[]} args - The arguments for the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args: string | string[], opts: GeneratorOpts);
+    initializing(): Promise<void>;
+    prompting(): Promise<void>;
+    writing(): Promise<void>;
+    end(): void;
+}
+export = OdataServiceGenerator;
+//# sourceMappingURL=index.d.ts.map

package/generators/change-data-source/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const types_1 = require("../types");
+const sub_gen_auth_base_1 = __importDefault(require("../base/sub-gen-auth-base"));
+/**
+ * Generator for changing the data source of an OData service.
+ */
+class OdataServiceGenerator extends sub_gen_auth_base_1.default {
+    /**
+     * The answers for the generator.
+     */
+    answers;
+    /**
+     * The data sources from the manifest.
+     */
+    dataSources;
+    /**
+     * Constructor for the OdataServiceGenerator.
+     *
+     * @param {string | string[]} args - The arguments for the generator.
+     * @param {GeneratorOpts} opts - The options for the generator.
+     */
+    constructor(args, opts) {
+        super(args, opts, types_1.GeneratorTypes.CHANGE_DATA_SOURCE);
+    }
+    async initializing() {
+        await this.onInit();
+    }
+    async prompting() {
+        try {
+            const manifest = await this.getManifest();
+            this.dataSources = manifest?.['sap.app']?.dataSources ?? {};
+            this.answers = await this.prompt((0, adp_tooling_1.getPromptsForChangeDataSource)(this.dataSources));
+            this.logger.log(`Current OData services\n${JSON.stringify(this.answers, null, 2)}`);
+        }
+        catch (error) {
+            await this.handleRuntimeCrash(error.message);
+        }
+    }
+    async writing() {
+        await (0, adp_tooling_1.generateChange)(this.projectPath, "appdescr_app_changeDataSource" /* ChangeType.CHANGE_DATA_SOURCE */, {
+            variant: this.variant,
+            dataSources: this.dataSources,
+            service: this.answers
+        }, this.fs);
+        this.logger.log('Change written to changes folder');
+    }
+    end() {
+        this.logger.log('Successfully created OData Change!');
+    }
+}
+module.exports = OdataServiceGenerator;
+//# sourceMappingURL=index.js.map

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

@@ -7,7 +7,15 @@
         "flpConfigName": "SAP Fiori Launchpad Configuration",
         "tileSettingsName": "SAP Fiori Launchpad Configuration - Tile Settings for {{- projectName}}",
         "deployConfigName": "Deployment Configuration",
-        "deployConfigDescr": "Configure deployment settings."
+        "deployConfigDescr": "Configure deployment settings.",
+        "addComponentUsagesName": "Add SAPUI5 Component Usages",
+        "addComponentUsagesDescr": "Select SAPUI5 component usages.",
+        "addNewModelName": "Add OData Service and SAPUI5 Model",
+        "addNewModelDescr": "Select an OData service and SAPUI5 model.",
+        "addLocalAnnotationFileName": "Add Local Annotation File",
+        "addLocalAnnotationFileDescr": "Select an OData service and annotation XML file.",
+        "replaceODataServiceName": "Replace OData Service",
+        "replaceODataServiceDescr": "Select an OData service and new OData URI."
     },
     "prompts": {
         "systemLabel": "System",
@@ -47,7 +55,8 @@
         "projectNameValidationErrorExt": "The name must only contain Latin alphanumeric characters. Every part must start with a letter and different parts can be separated by a period.",
         "projectNameLengthErrorInt": "The name cannot start with the word 'customer', contain more than 61 characters, or end with the word 'component'.",
         "projectNameValidationErrorInt": "The name must only contain Latin alphanumeric characters and it must have at least two parts. Every part must start with a letter and the different parts must be separated by a period.",
-        "projectNotInWorkspace": "The project: '{{- path}}' is not in the workspace. Some adaptation project tools may not work. What do you want to do?"
+        "projectNotInWorkspace": "The project: '{{- path}}' is not in the workspace. Some adaptation project tools may not work. What do you want to do?",
+        "emptyAnnotationFile": "An empty annotation file will be created in the webapp/changes/annotations folder of your project."
     },
     "error": {
         "selectCannotBeEmptyError": "The {{value}} has to be selected.",
@@ -65,7 +74,9 @@
         "creatingExtensionProjectError": "Creating the extension project failed. To see the error, view the logs.",
         "appParameterMissing": "Could not create an extension project because the application parameters are missing. Please select a different application.",
         "destinationInfoMissing": "Could not create an extension project because the destination info is missing. Please select a different system.",
-        "systemNotFound": "System not found or not supported: {{system}}. Please check the system exists.",
-        "applicationNotFound": "Application not found or not supported: {{appName}}. Please check the application exists."
+        "systemNotFound": "System could not be found or is not supported: {{system}}. Please check the system exists.",
+        "applicationNotFound": "The application could not be found or is not supported: {{appName}}. Please check the application exists.",
+        "backendCommunicationError": "An error occurred when communicating with the back end. Please try again later.",
+        "pleaseProvideAllRequiredData": "Please provide the required data and try again."
     }
 }

package/generators/types.d.ts

@@ -0,0 +1,11 @@
+export declare enum GeneratorTypes {
+    ADD_ANNOTATIONS_TO_DATA = "Add Local Annotation File",
+    ADD_COMPONENT_USAGES = "Add SAPUI5 Component Usages",
+    ADD_NEW_MODEL = "Add OData Service And SAPUI5 Model",
+    CHANGE_DATA_SOURCE = "Replace OData Service"
+}
+export interface Credentials {
+    username: string;
+    password: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/generators/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratorTypes = void 0;
+var GeneratorTypes;
+(function (GeneratorTypes) {
+    GeneratorTypes["ADD_ANNOTATIONS_TO_DATA"] = "Add Local Annotation File";
+    GeneratorTypes["ADD_COMPONENT_USAGES"] = "Add SAPUI5 Component Usages";
+    GeneratorTypes["ADD_NEW_MODEL"] = "Add OData Service And SAPUI5 Model";
+    GeneratorTypes["CHANGE_DATA_SOURCE"] = "Replace OData Service";
+})(GeneratorTypes || (exports.GeneratorTypes = GeneratorTypes = {}));
+//# sourceMappingURL=types.js.map

package/generators/utils/opts.d.ts

@@ -1,11 +1,19 @@
+import type { AppWizard } from '@sap-devx/yeoman-ui-types';
 import type { ToolsLogger } from '@sap-ux/logger';
-import type { AdpGeneratorOptions } from '../app/types';
+export interface GeneratorOpts {
+    appWizard?: AppWizard;
+    vscode?: any;
+    data?: {
+        path: string;
+    };
+}
 /**
- * Sets the header title in the AppWizard UI, if the `setHeaderTitle` method is available.
- * This helps users identify the generator and its version in the Yeoman UI interface.
+ * Sets a custom header title in the AppWizard UI, if the `setHeaderTitle` method is available.
+ * This allows generators to specify their own display name while keeping the version information.
  *
- * @param {AdpGeneratorOptions} opts - The generator options, potentially including the AppWizard instance.
- * @param {IChildLogger} logger - Logger instance used for logging any errors that occur during execution.
+ * @param {GeneratorOpts} opts - The generator options, potentially including the AppWizard instance.
+ * @param {ToolsLogger} logger - Logger instance used for logging any errors that occur during execution.
+ * @param {string} customTitle - Optional custom title to display instead of the package name.
  */
-export declare function setHeaderTitle(opts: AdpGeneratorOptions, logger: ToolsLogger): void;
+export declare function setHeaderTitle(opts: GeneratorOpts, logger: ToolsLogger, customTitle?: string): void;
 //# sourceMappingURL=opts.d.ts.map

package/generators/utils/opts.js

@@ -3,18 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setHeaderTitle = setHeaderTitle;
 const deps_1 = require("./deps");
 /**
- * Sets the header title in the AppWizard UI, if the `setHeaderTitle` method is available.
- * This helps users identify the generator and its version in the Yeoman UI interface.
+ * Sets a custom header title in the AppWizard UI, if the `setHeaderTitle` method is available.
+ * This allows generators to specify their own display name while keeping the version information.
  *
- * @param {AdpGeneratorOptions} opts - The generator options, potentially including the AppWizard instance.
- * @param {IChildLogger} logger - Logger instance used for logging any errors that occur during execution.
+ * @param {GeneratorOpts} opts - The generator options, potentially including the AppWizard instance.
+ * @param {ToolsLogger} logger - Logger instance used for logging any errors that occur during execution.
+ * @param {string} customTitle - Optional custom title to display instead of the package name.
  */
-function setHeaderTitle(opts, logger) {
+function setHeaderTitle(opts, logger, customTitle) {
     try {
         if (typeof opts?.appWizard?.setHeaderTitle === 'function') {
             const { name = '', version = '', displayName = '' } = (0, deps_1.getPackageInfo)();
             if (name && version) {
-                opts.appWizard.setHeaderTitle(displayName || name, `${name}@${version}`);
+                const headerTitle = customTitle ?? (displayName || name);
+                opts.appWizard.setHeaderTitle(headerTitle, `${name}@${version}`);
             }
         }
     }

package/generators/utils/steps.d.ts

@@ -1,4 +1,5 @@
 import type { Prompts as YeomanUiSteps, IPrompt } from '@sap-devx/yeoman-ui-types';
+import { GeneratorTypes } from '../types';
 /**
  * Returns the list of base wizard pages used in the Adaptation Project.
  *
@@ -44,4 +45,22 @@ export declare function getDeployPage(): IPrompt;
  * @param {boolean} [shouldAdd] - Whether to add (`true`) or remove (`false`) the step.
  */
 export declare function updateWizardSteps(prompts: YeomanUiSteps, step: IPrompt, insertAfter?: string, shouldAdd?: boolean): void;
+/**
+ * Returns the error page for the given sub generator type.
+ *
+ * @param {GeneratorTypes} subGenType - The type of sub generator.
+ * @returns {IPrompt[]} The error page for the given sub generator type.
+ */
+export declare function getSubGenErrorPage(subGenType: GeneratorTypes): IPrompt[];
+/**
+ * Returns the wizard pages for sub-generators that may trigger an ABAP login step.
+ *
+ * Depending on the destination system's authentication requirements, a
+ * credentials page can be shown before the business-specific page.
+ *
+ * @param {GeneratorTypes} type - The sub-generator type requesting pages.
+ * @param {string} destination - ID of the destination system (used only for UI text).
+ * @returns {IPrompt[]} The page definitions consumed by Yeoman-UI <Prompts>.
+ */
+export declare function getSubGenAuthPages(type: GeneratorTypes, destination: string): IPrompt[];
 //# sourceMappingURL=steps.d.ts.map

package/generators/utils/steps.js

@@ -5,7 +5,10 @@ exports.getFlpPages = getFlpPages;
 exports.updateFlpWizardSteps = updateFlpWizardSteps;
 exports.getDeployPage = getDeployPage;
 exports.updateWizardSteps = updateWizardSteps;
+exports.getSubGenErrorPage = getSubGenErrorPage;
+exports.getSubGenAuthPages = getSubGenAuthPages;
 const i18n_1 = require("./i18n");
+const types_1 = require("../types");
 /**
  * Returns the list of base wizard pages used in the Adaptation Project.
  *
@@ -108,4 +111,56 @@ function updateWizardSteps(prompts, step, insertAfter = '', shouldAdd = true) {
         prompts.splice(existingIdx, 1, []);
     }
 }
+/**
+ * Returns the error page for the given sub generator type.
+ *
+ * @param {GeneratorTypes} subGenType - The type of sub generator.
+ * @returns {IPrompt[]} The error page for the given sub generator type.
+ */
+function getSubGenErrorPage(subGenType) {
+    switch (subGenType) {
+        case types_1.GeneratorTypes.ADD_ANNOTATIONS_TO_DATA:
+            return [{ name: (0, i18n_1.t)('yuiNavSteps.addLocalAnnotationFileName'), description: '' }];
+        case types_1.GeneratorTypes.CHANGE_DATA_SOURCE:
+            return [{ name: (0, i18n_1.t)('yuiNavSteps.replaceODataServiceName'), description: '' }];
+        default:
+            return [];
+    }
+}
+/**
+ * Returns the wizard pages for sub-generators that may trigger an ABAP login step.
+ *
+ * Depending on the destination system's authentication requirements, a
+ * credentials page can be shown before the business-specific page.
+ *
+ * @param {GeneratorTypes} type - The sub-generator type requesting pages.
+ * @param {string} destination - ID of the destination system (used only for UI text).
+ * @returns {IPrompt[]} The page definitions consumed by Yeoman-UI <Prompts>.
+ */
+function getSubGenAuthPages(type, destination) {
+    const getCredentialsPageProps = (nameBase) => ({
+        name: `${nameBase} - Credentials`,
+        description: `Enter credentials for your adaptation project's system (${destination})`
+    });
+    switch (type) {
+        case types_1.GeneratorTypes.ADD_ANNOTATIONS_TO_DATA:
+            return [
+                getCredentialsPageProps((0, i18n_1.t)('yuiNavSteps.addLocalAnnotationFileName')),
+                {
+                    name: (0, i18n_1.t)('yuiNavSteps.addLocalAnnotationFileName'),
+                    description: (0, i18n_1.t)('yuiNavSteps.addLocalAnnotationFileDescr')
+                }
+            ];
+        case types_1.GeneratorTypes.CHANGE_DATA_SOURCE:
+            return [
+                getCredentialsPageProps((0, i18n_1.t)('yuiNavSteps.replaceODataServiceName')),
+                {
+                    name: (0, i18n_1.t)('yuiNavSteps.replaceODataServiceName'),
+                    description: (0, i18n_1.t)('yuiNavSteps.replaceODataServiceDescr')
+                }
+            ];
+        default:
+            return [];
+    }
+}
 //# sourceMappingURL=steps.js.map

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.3.46",
+  "version": "0.3.47",
   "repository": {
     "type": "git",
     "url": "https://github.com/SAP/open-ux-tools.git",
@@ -30,7 +30,7 @@
     "i18next": "25.3.0",
     "yeoman-generator": "5.10.0",
     "uuid": "10.0.0",
-    "@sap-ux/adp-tooling": "0.15.0",
+    "@sap-ux/adp-tooling": "0.15.1",
     "@sap-ux/axios-extension": "1.22.3",
     "@sap-ux/btp-utils": "1.1.0",
     "@sap-ux/feature-toggle": "0.3.0",
@@ -41,7 +41,8 @@
     "@sap-ux/system-access": "0.6.10",
     "@sap-ux/project-input-validator": "0.6.12",
     "@sap-ux/fiori-generator-shared": "0.13.2",
-    "@sap-ux/adp-flp-config-sub-generator": "0.1.45"
+    "@sap-ux/adp-flp-config-sub-generator": "0.1.46",
+    "@sap-ux/odata-service-writer": "0.27.12"
   },
   "devDependencies": {
     "@jest/types": "29.6.3",