@sap-ux/repo-app-import-sub-generator 0.0.0

package/generators/prompts/prompt-state.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptState = void 0;
+/**
+ * Much of the values returned by the app downloader prompting are derived from prompt answers and are not direct answer values.
+ * Since inquirer does not provide a way to return values that are not direct answers from prompts, this class will maintain the derived values
+ * across prompts statically for the lifespan of the prompting session.
+ *
+ */
+class PromptState {
+    static _systemSelection = {};
+    static _downloadedAppPackage;
+    /**
+     * Returns the current state of the service config.
+     *
+     * @returns {SystemSelectionAnswers} service config
+     */
+    static get systemSelection() {
+        return this._systemSelection;
+    }
+    /**
+     * Set the state of the system selection.
+     *
+     * @param {SystemSelectionAnswers} value - system selection value
+     */
+    static set systemSelection(value) {
+        this._systemSelection = value;
+    }
+    /**
+     * Set the downloaded app package.
+     */
+    static set downloadedAppPackage(archive) {
+        this._downloadedAppPackage = archive;
+    }
+    /**
+     * Returns the downloaded app package.
+     *
+     * @returns {Buffer} downloaded app package
+     */
+    static get downloadedAppPackage() {
+        return this._downloadedAppPackage ?? Buffer.alloc(0);
+    }
+    /**
+     * Get the baseURL from the connected system's service provider defaults.
+     *
+     * @returns {string | undefined} baseURL
+     */
+    static get baseURL() {
+        return this._systemSelection.connectedSystem?.serviceProvider?.defaults?.baseURL;
+    }
+    /**
+     * Get the sap-client parameter from the connected system's service provider defaults.
+     *
+     * @returns {string | undefined} sap-client
+     */
+    static get sapClient() {
+        return this._systemSelection.connectedSystem?.serviceProvider?.defaults?.params?.['sap-client'];
+    }
+    static reset() {
+        PromptState.systemSelection = {};
+        PromptState._downloadedAppPackage = undefined;
+    }
+}
+exports.PromptState = PromptState;
+//# sourceMappingURL=prompt-state.js.map

package/generators/prompts/prompts.d.ts

@@ -0,0 +1,10 @@
+import type { RepoAppDownloadQuestions, QuickDeployedAppConfig } from '../app/types';
+/**
+ * Retrieves prompts for selecting a system, app list, and target folder where the app will be generated.
+ *
+ * @param {string} [appRootPath] - The root path of the application.
+ * @param {QuickDeployedAppConfig} [quickDeployedAppConfig] - The quick deployed app configuration.
+ * @returns {Promise<RepoAppDownloadQuestions[]>} A list of prompts for user interaction.
+ */
+export declare function getPrompts(appRootPath?: string, quickDeployedAppConfig?: QuickDeployedAppConfig): Promise<RepoAppDownloadQuestions[]>;
+//# sourceMappingURL=prompts.d.ts.map

package/generators/prompts/prompts.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPrompts = void 0;
+const odata_service_inquirer_1 = require("@sap-ux/odata-service-inquirer");
+const types_1 = require("../app/types");
+const i18n_1 = require("../utils/i18n");
+const project_input_validator_1 = require("@sap-ux/project-input-validator");
+const prompt_state_1 = require("./prompt-state");
+const prompt_helpers_1 = require("./prompt-helpers");
+const download_utils_1 = require("../utils/download-utils");
+/**
+ * Gets the target folder selection prompt.
+ *
+ * @param {string} [appRootPath] - The application root path.
+ * @param {string} appId - The application ID.
+ * @returns {FileBrowserQuestion<RepoAppDownloadAnswers>} The target folder prompt configuration.
+ */
+const getTargetFolderPrompt = (appRootPath, appId) => {
+    return {
+        type: 'input',
+        name: types_1.PromptNames.targetFolder,
+        message: (0, i18n_1.t)('prompts.targetPath.message'),
+        guiType: 'folder-browser',
+        when: (answers) => {
+            // Display the prompt if appId is provided. This occurs when the generator is invoked
+            // as part of the quick deployment process from ADT.
+            if (appId) {
+                return true;
+            }
+            // If appId is not provided, check if the user has selected an app.
+            // If an app is selected, display the prompt accordingly.
+            return Boolean(answers?.selectedApp?.appId);
+        },
+        guiOptions: {
+            applyDefaultWhenDirty: true,
+            mandatory: true,
+            breadcrumb: (0, i18n_1.t)('prompts.targetPath.breadcrumb')
+        },
+        validate: async (target, answers) => {
+            const selectedAppId = answers.selectedApp?.appId ?? appId;
+            return await (0, project_input_validator_1.validateFioriAppTargetFolder)(target, selectedAppId, true);
+        },
+        default: () => appRootPath
+    };
+};
+/**
+ * Retrieves prompts for selecting a system, app list, and target folder where the app will be generated.
+ *
+ * @param {string} [appRootPath] - The root path of the application.
+ * @param {QuickDeployedAppConfig} [quickDeployedAppConfig] - The quick deployed app configuration.
+ * @returns {Promise<RepoAppDownloadQuestions[]>} A list of prompts for user interaction.
+ */
+async function getPrompts(appRootPath, quickDeployedAppConfig) {
+    try {
+        prompt_state_1.PromptState.reset();
+        const systemQuestions = await (0, odata_service_inquirer_1.getSystemSelectionQuestions)({
+            serviceSelection: { hide: true },
+            systemSelection: { defaultChoice: quickDeployedAppConfig?.serviceProviderInfo?.name }
+        }, false);
+        let appList = [];
+        const appSelectionPrompt = [
+            {
+                when: async (answers) => {
+                    if (answers[types_1.PromptNames.systemSelection]) {
+                        appList = await (0, prompt_helpers_1.fetchAppListForSelectedSystem)(systemQuestions.answers.connectedSystem?.serviceProvider, quickDeployedAppConfig?.appId);
+                    }
+                    return !!systemQuestions.answers.connectedSystem?.serviceProvider;
+                },
+                type: 'list',
+                name: types_1.PromptNames.selectedApp,
+                default: () => (quickDeployedAppConfig?.appId ? 0 : undefined),
+                guiOptions: {
+                    mandatory: !!appList.length,
+                    breadcrumb: (0, i18n_1.t)('prompts.appSelection.breadcrumb')
+                },
+                message: (0, i18n_1.t)('prompts.appSelection.message'),
+                choices: () => (appList.length ? (0, prompt_helpers_1.formatAppChoices)(appList) : []),
+                validate: async (answers) => {
+                    // Quick deploy config exists but no apps found
+                    if (quickDeployedAppConfig?.appId && appList.length === 0) {
+                        return (0, i18n_1.t)('error.quickDeployedAppDownloadErrors.noAppsFound', {
+                            appId: quickDeployedAppConfig.appId
+                        });
+                    }
+                    // No apps available at all
+                    if (appList.length === 0) {
+                        return (0, i18n_1.t)('prompts.appSelection.noAppsDeployed');
+                    }
+                    // Valid app selected, try to download
+                    if (answers?.appId) {
+                        try {
+                            await (0, download_utils_1.downloadApp)(answers.repoName);
+                            return true;
+                        }
+                        catch (error) {
+                            return (0, i18n_1.t)('error.appDownloadErrors.appDownloadFailure', { error: error.message });
+                        }
+                    }
+                    return false;
+                }
+            }
+        ];
+        const targetFolderPrompts = getTargetFolderPrompt(appRootPath, quickDeployedAppConfig?.appId);
+        return [...systemQuestions.prompts, ...appSelectionPrompt, targetFolderPrompts];
+    }
+    catch (error) {
+        throw new Error(`Failed to generate prompts: ${error.message}`);
+    }
+}
+exports.getPrompts = getPrompts;
+//# sourceMappingURL=prompts.js.map

package/generators/telemetryEvents/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Event names for telemetry for the generator when downloading an app from repository
+ */
+export declare enum EventName {
+    GENERATION_SUCCESS = "GENERATION_SUCCESS"
+}
+//# sourceMappingURL=index.d.ts.map

package/generators/telemetryEvents/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventName = void 0;
+/**
+ * Event names for telemetry for the generator when downloading an app from repository
+ */
+var EventName;
+(function (EventName) {
+    EventName["GENERATION_SUCCESS"] = "GENERATION_SUCCESS";
+})(EventName || (exports.EventName = EventName = {}));
+//# sourceMappingURL=index.js.map

package/generators/translations/repo-app-import-sub-generator.i18n.json

@@ -0,0 +1,67 @@
+{
+    "error": {
+        "telemetry": "Failed to send telemetry data after downloading app from UI5 ABAP Repository. {{- error}}",
+        "qfaJsonNotFound": "{{- jsonFileName }} not found in the downloaded app",
+        "replaceWebappFilesError": "Error replacing files in the downloaded app: {{- error}}",
+        "requiredFieldsMissing": "Required fields are missing for app: {{- app }}. Check if the app is deployed correctly",
+        "applicationListFetchError": "Error fetching application list: {{- error}}",
+        "metadataFetchError": "Error fetching metadata: {{- error}}",
+        "appConfigGenError": "Error generating application configuration: {{- error}}",
+        "endPhase": "Error in end phase: {{- error}}",
+        "errorProcessingJsonFile": "Error processing JSON file: {{- error}}",
+        "validationErrors": {
+            "invalidMetadataPackage": "Invalid or missing package in metadata",
+            "invalidServiceName": "Invalid or missing serviceName in serviceBindingDetails",
+            "invalidServiceVersion": "Invalid or missing serviceVersion in serviceBindingDetails",
+            "invalidMainEntityName": "Invalid or missing mainEntityName in serviceBindingDetails",
+            "invalidModuleName": "Invalid or missing moduleName in serviceBindingDetails",
+            "invalidRepositoryName": "Invalid or missing repositoryName in serviceBindingDetails"
+        },
+        "installationErrors": {
+            "npmInstall": "Error in install phase: {{- error}}",
+            "skippedInstallation": "Option `--skipInstall` was specified. Installation of dependencies will be skipped."
+        },
+        "appDownloadErrors": {
+            "downloadedFileNotBufferError": "Error: The downloaded file is not a Buffer.",
+            "appDownloadFailure": "Error downloading app: {{- error}}",
+            "zipExtractionError": "Error extracting zip: {{- error}}"
+        },
+        "eventHookErrors": {
+            "vscodeInstanceMissing": "Error: Missing VSCode instance in event hook",
+            "postGenCommandMissing": "Error: Missing postGenCommand in event hook",
+            "commandExecutionFailed": "Error executing postGenCommand in event hook: {{- error}}"
+        },
+        "readManifestErrors": {
+            "manifestFileNotFound": "Error: Manifest file not found in the downloaded app",
+            "readManifestFailed": "Error: Failed to read manifest file",
+            "sapAppNotDefined": "Error: sap.app not defined in the manifest file",
+            "sourceTemplateNotSupported": "Error: Source template not supported",
+            "invalidManifestStructureError": "Invalid manifest structure: 'sap.ui5' or 'sap.app' are missing."
+        },
+        "quickDeployedAppDownloadErrors": {
+            "noAppsFound": "No application with id {{ appId }} found in the system. Please check if the application is deployed correctly or select another app"
+        }
+    },
+    "warn": {
+        "extractedFileNotFound": "Extracted file not found - {{- extractedFilePath}}"
+    },
+    "prompts": {
+        "appSelection": {
+            "message": "App",
+            "hint": "Select the app to download",
+            "breadcrumb": "App",
+            "noAppsDeployed": "No applications deployed to this system can be downloaded. {{- help}}"
+        },
+        "targetPath": {
+            "message": "Project folder path",
+            "breadcrumb": "Project Path"
+        }
+    },
+    "readMe": {
+        "appDescription": "This application was converted from a SAP Fiori app that was deployed from ADT using the ADT Quick Fiori Application generator",
+        "launchText": "In order to launch the generated app, simply run the following from the generated app root folder:\n\n```\n    npm start\n```"
+    },
+    "info": {
+        "repoAppDownloadCompleteMsg": "The selected application has been downloaded and updated to support SAP Fiori tools."
+    }
+}

package/generators/utils/constants.d.ts

@@ -0,0 +1,14 @@
+import { type RepoAppDownloadAnswers } from '../app/types';
+export declare const generatorTitle = "Download ADT deployed app from UI5 ABAP repository";
+export declare const generatorDescription = "Download an application that was generated with the ADT Quick Fiori Application generator";
+export declare const generatorName = "@sap-ux/repo-app-import-sub-generator";
+export declare const adtSourceTemplateId = "@sap.adt.sevicebinding.deploy:lrop";
+export declare const fioriAppSourcetemplateId = "@sap/generator-fiori:lrop";
+export declare const qfaJsonFileName = "qfa.json";
+export declare const defaultAnswers: RepoAppDownloadAnswers;
+export declare const extractedFilePath = "extractedFiles";
+export declare const appListSearchParams: {
+    'sap.app/sourceTemplate/id': string;
+};
+export declare const appListResultFields: string[];
+//# sourceMappingURL=constants.d.ts.map

package/generators/utils/constants.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appListResultFields = exports.appListSearchParams = exports.extractedFilePath = exports.defaultAnswers = exports.qfaJsonFileName = exports.fioriAppSourcetemplateId = exports.adtSourceTemplateId = exports.generatorName = exports.generatorDescription = exports.generatorTitle = void 0;
+const types_1 = require("../app/types");
+// Title and description for the generator
+exports.generatorTitle = 'Download ADT deployed app from UI5 ABAP repository';
+exports.generatorDescription = 'Download an application that was generated with the ADT Quick Fiori Application generator';
+// Name of the generator used for Fiori app download
+exports.generatorName = '@sap-ux/repo-app-import-sub-generator';
+// The source template ID used for filtering the apps in the repository
+exports.adtSourceTemplateId = '@sap.adt.sevicebinding.deploy:lrop';
+// The source template ID used for Fiori app generation
+exports.fioriAppSourcetemplateId = '@sap/generator-fiori:lrop';
+// The name of the QFA JSON file provided with the downloaded app, containing all user inputs.
+exports.qfaJsonFileName = 'qfa.json';
+// Default initial answers to use as a fallback.
+exports.defaultAnswers = {
+    [types_1.PromptNames.systemSelection]: {},
+    [types_1.PromptNames.selectedApp]: {
+        appId: '',
+        title: '',
+        description: '',
+        repoName: '',
+        url: ''
+    },
+    [types_1.PromptNames.targetFolder]: ''
+};
+// Path for storing the extracted files from repository
+exports.extractedFilePath = 'extractedFiles';
+// Search parameters to filter applications by the source template ID
+exports.appListSearchParams = {
+    'sap.app/sourceTemplate/id': exports.adtSourceTemplateId
+};
+// Fields to retrieve from the app list, useful for displaying app metadata
+exports.appListResultFields = [
+    'sap.app/id', // ID of the application
+    'sap.app/title', // Title of the application
+    'sap.app/description', // Description of the application
+    'sap.app/sourceTemplate/id', // ID of the source template
+    'repoName', // Repository name where the app is located
+    'fileType', // Type of file (.zip etc)
+    'url' // URL for accessing the app
+];
+//# sourceMappingURL=constants.js.map

package/generators/utils/download-utils.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+import type { Editor } from 'mem-fs-editor';
+/**
+ * Extracts a ZIP archive to a temporary directory.
+ *
+ * @param {string} extractedProjectPath - The path where the archive should be extracted.
+ * @param {Buffer} archive - The ZIP archive buffer.
+ * @param {Editor} fs - The file system editor.
+ */
+export declare function extractZip(extractedProjectPath: string, archive: Buffer, fs: Editor): Promise<void>;
+/**
+ * Downloads application files from the ABAP repository.
+ *
+ * @param {string} repoName - The repository name of the application.
+ */
+export declare function downloadApp(repoName: string): Promise<void>;
+//# sourceMappingURL=download-utils.d.ts.map

package/generators/utils/download-utils.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadApp = exports.extractZip = void 0;
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const path_1 = require("path");
+const prompt_state_1 = require("../prompts/prompt-state");
+const i18n_1 = require("./i18n");
+const logger_1 = __importDefault(require("../utils/logger"));
+/**
+ * Extracts a ZIP archive to a temporary directory.
+ *
+ * @param {string} extractedProjectPath - The path where the archive should be extracted.
+ * @param {Buffer} archive - The ZIP archive buffer.
+ * @param {Editor} fs - The file system editor.
+ */
+async function extractZip(extractedProjectPath, archive, fs) {
+    try {
+        const zip = new adm_zip_1.default(archive);
+        zip.getEntries().forEach(function (zipEntry) {
+            if (!zipEntry.isDirectory) {
+                // Extract the file content
+                const fileContent = zipEntry.getData().toString('utf8');
+                // Load the file content into mem-fs for use in the temporary extracted project directory
+                fs.write((0, path_1.join)(extractedProjectPath, zipEntry.entryName), fileContent);
+            }
+        });
+    }
+    catch (error) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.appDownloadErrors.zipExtractionError', { error: error.message }));
+    }
+}
+exports.extractZip = extractZip;
+/**
+ * Downloads application files from the ABAP repository.
+ *
+ * @param {string} repoName - The repository name of the application.
+ */
+async function downloadApp(repoName) {
+    const serviceProvider = prompt_state_1.PromptState.systemSelection?.connectedSystem?.serviceProvider;
+    const downloadedAppPackage = await serviceProvider.getUi5AbapRepository().downloadFiles(repoName);
+    // store downloaded package in prompt state
+    prompt_state_1.PromptState.downloadedAppPackage = downloadedAppPackage;
+}
+exports.downloadApp = downloadApp;
+//# sourceMappingURL=download-utils.js.map

package/generators/utils/event-hook.d.ts

@@ -0,0 +1,18 @@
+import type { VSCodeInstance } from '@sap-ux/fiori-generator-shared';
+/**
+ * Context object for the App generation process.
+ * Contains the path of the project and the post-generation command.
+ */
+export interface RepoAppGenContext {
+    path: string;
+    postGenCommand: string;
+    vscodeInstance?: VSCodeInstance;
+}
+/**
+ * Executes the post-generation command for the app.
+ * Runs the specified command in the context of the generated project, typically for tasks like refreshing or reloading the project in the editor.
+ *
+ * @param {RepoAppGenContext} context - The context containing the project path, post-generation command, and optional VSCode instance.
+ */
+export declare function runPostAppGenHook(context: RepoAppGenContext): Promise<void>;
+//# sourceMappingURL=event-hook.d.ts.map

package/generators/utils/event-hook.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPostAppGenHook = void 0;
+const logger_1 = __importDefault(require("./logger"));
+const i18n_1 = require("./i18n");
+/**
+ * Executes the post-generation command for the app.
+ * Runs the specified command in the context of the generated project, typically for tasks like refreshing or reloading the project in the editor.
+ *
+ * @param {RepoAppGenContext} context - The context containing the project path, post-generation command, and optional VSCode instance.
+ */
+async function runPostAppGenHook(context) {
+    try {
+        // Ensure that context has necessary values before proceeding
+        if (!context.vscodeInstance) {
+            logger_1.default.logger?.error((0, i18n_1.t)('error.eventHookErrors.vscodeInstanceMissing'));
+        }
+        if (!context.postGenCommand || context.postGenCommand.trim() === '') {
+            logger_1.default.logger?.error((0, i18n_1.t)('error.eventHookErrors.postGenCommandMissing'));
+        }
+        // Execute the post-generation command
+        await context.vscodeInstance?.commands?.executeCommand?.(context.postGenCommand, {
+            fsPath: context.path
+        });
+    }
+    catch (e) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.eventHookErrors.commandExecutionFailed', e.message));
+    }
+}
+exports.runPostAppGenHook = runPostAppGenHook;
+//# sourceMappingURL=event-hook.js.map

package/generators/utils/file-helpers.d.ts

@@ -0,0 +1,19 @@
+import type { Editor } from 'mem-fs-editor';
+import { type Manifest } from '@sap-ux/project-access';
+import type { QfaJsonConfig } from '../app/types';
+/**
+ *
+ * @param filePath - Path to the JSON file
+ * @param fs - File system editor instance
+ * @returns - Parsed JSON object
+ */
+export declare function makeValidJson(filePath: string, fs: Editor): QfaJsonConfig;
+/**
+ * Reads and validates the `manifest.json` file.
+ *
+ * @param {string} manifesFilePath - Manifest file path.
+ * @param {Editor} fs - The file system editor.
+ * @returns {Manifest} The validated manifest object.
+ */
+export declare function readManifest(manifesFilePath: string, fs: Editor): Manifest;
+//# sourceMappingURL=file-helpers.d.ts.map

package/generators/utils/file-helpers.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readManifest = exports.makeValidJson = void 0;
+const constants_1 = require("./constants");
+const i18n_1 = require("./i18n");
+const logger_1 = __importDefault(require("./logger"));
+/**
+ *
+ * @param filePath - Path to the JSON file
+ * @param fs - File system editor instance
+ * @returns - Parsed JSON object
+ */
+function makeValidJson(filePath, fs) {
+    try {
+        // Read the file contents
+        const fileContents = fs.read(filePath);
+        const validJson = JSON.parse(fileContents);
+        return validJson;
+    }
+    catch (error) {
+        throw new Error((0, i18n_1.t)('error.errorProcessingJsonFile', { error }));
+    }
+}
+exports.makeValidJson = makeValidJson;
+/**
+ * Reads and validates the `manifest.json` file.
+ *
+ * @param {string} manifesFilePath - Manifest file path.
+ * @param {Editor} fs - The file system editor.
+ * @returns {Manifest} The validated manifest object.
+ */
+function readManifest(manifesFilePath, fs) {
+    if (!fs.exists(manifesFilePath)) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.readManifestErrors.manifestFileNotFound'));
+    }
+    const manifest = fs.readJSON(manifesFilePath);
+    if (!manifest) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.readManifestErrors.readManifestFailed'));
+    }
+    if (!manifest?.['sap.app']) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.readManifestErrors.sapAppNotDefined'));
+    }
+    if (manifest?.['sap.app']?.sourceTemplate?.id !== constants_1.adtSourceTemplateId) {
+        logger_1.default.logger?.error((0, i18n_1.t)('error.readManifestErrors.sourceTemplateNotSupported'));
+    }
+    return manifest;
+}
+exports.readManifest = readManifest;
+//# sourceMappingURL=file-helpers.js.map

package/generators/utils/i18n.d.ts

@@ -0,0 +1,14 @@
+import type { TOptions } from 'i18next';
+/**
+ * Initialize i18next with the translations for this module.
+ */
+export declare function initI18n(): Promise<void>;
+/**
+ * Helper function facading the call to i18next. Unless a namespace option is provided the local namespace will be used.
+ *
+ * @param key i18n key
+ * @param options additional options
+ * @returns {string} localized string stored for the given key
+ */
+export declare function t(key: string, options?: TOptions): string;
+//# sourceMappingURL=i18n.d.ts.map

package/generators/utils/i18n.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.t = exports.initI18n = void 0;
+const i18next_1 = __importDefault(require("i18next"));
+const repo_app_import_sub_generator_i18n_json_1 = __importDefault(require("../translations/repo-app-import-sub-generator.i18n.json"));
+const repoAppDownloadGeneratorNs = 'repo-app-import-sub-generator';
+/**
+ * Initialize i18next with the translations for this module.
+ */
+async function initI18n() {
+    await i18next_1.default.init({ lng: 'en', fallbackLng: 'en' }, () => i18next_1.default.addResourceBundle('en', repoAppDownloadGeneratorNs, repo_app_import_sub_generator_i18n_json_1.default));
+}
+exports.initI18n = initI18n;
+/**
+ * Helper function facading the call to i18next. Unless a namespace option is provided the local namespace will be used.
+ *
+ * @param key i18n key
+ * @param options additional options
+ * @returns {string} localized string stored for the given key
+ */
+function t(key, options) {
+    if (!options?.ns) {
+        options = Object.assign(options ?? {}, { ns: repoAppDownloadGeneratorNs });
+    }
+    return i18next_1.default.t(key, options);
+}
+exports.t = t;
+initI18n().catch(() => {
+    // Needed for lint
+});
+//# sourceMappingURL=i18n.js.map

package/generators/utils/logger.d.ts

@@ -0,0 +1,33 @@
+import { LogWrapper, type ILogWrapper } from '@sap-ux/fiori-generator-shared';
+import type { Logger } from 'yeoman-environment';
+import type { IVSCodeExtLogger, LogLevel } from '@vscode-logging/logger';
+/**
+ * Static logger prevents passing of logger references through all functions, as this is a cross-cutting concern.
+ */
+export default class RepoAppDownloadLogger {
+    private static _logger;
+    /**
+     * Get the logger.
+     *
+     * @returns the logger
+     */
+    static get logger(): ILogWrapper;
+    /**
+     * Set the logger.
+     *
+     * @param value the logger to set
+     */
+    static set logger(value: ILogWrapper);
+    /**
+     * Configures the logger.
+     *
+     * @param loggerName - the logger name
+     * @param yoLogger - the yeoman logger
+     * @param logWrapper - log wrapper instance
+     * @param logLevel - the log level
+     * @param vscLogger - the vscode logger
+     * @param vscode - the vscode instance
+     */
+    static configureLogging(loggerName: string, yoLogger: Logger, logWrapper?: LogWrapper, logLevel?: LogLevel, vscLogger?: IVSCodeExtLogger, vscode?: unknown): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/generators/utils/logger.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fiori_generator_shared_1 = require("@sap-ux/fiori-generator-shared");
+/**
+ * Static logger prevents passing of logger references through all functions, as this is a cross-cutting concern.
+ */
+class RepoAppDownloadLogger {
+    static _logger = fiori_generator_shared_1.DefaultLogger;
+    /**
+     * Get the logger.
+     *
+     * @returns the logger
+     */
+    static get logger() {
+        return RepoAppDownloadLogger._logger;
+    }
+    /**
+     * Set the logger.
+     *
+     * @param value the logger to set
+     */
+    static set logger(value) {
+        RepoAppDownloadLogger._logger = value;
+    }
+    /**
+     * Configures the logger.
+     *
+     * @param loggerName - the logger name
+     * @param yoLogger - the yeoman logger
+     * @param logWrapper - log wrapper instance
+     * @param logLevel - the log level
+     * @param vscLogger - the vscode logger
+     * @param vscode - the vscode instance
+     */
+    static configureLogging(loggerName, yoLogger, logWrapper, logLevel, vscLogger, vscode) {
+        const logger = logWrapper ?? new fiori_generator_shared_1.LogWrapper(loggerName, yoLogger, logLevel, vscLogger, vscode);
+        RepoAppDownloadLogger.logger = logger;
+    }
+}
+exports.default = RepoAppDownloadLogger;
+//# sourceMappingURL=logger.js.map