@magnolia/cli-jumpstart-plugin 1.0.0-preview.3 → 1.0.0-preview.4

package/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright (c) 2024 Magnolia International Ltd.
+(http://www.magnolia-cms.com). All rights reserved.
+
+
+The software is dual-licensed under both the Magnolia
+Network Agreement and the GNU General Public License.
+You may elect to use one or the other of these licenses.
+
+The software is distributed in the hope that it will be
+useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
+implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
+Redistribution, except as permitted by whichever of the GPL
+or MNA you select, is prohibited.
+
+1. For the GPL license (GPL), you can redistribute and/or
+modify this file under the terms of the GNU General
+Public License, Version 3, as published by the Free Software
+Foundation.  You should have received a copy of the GNU
+General Public License, Version 3 along with this program;
+if not, write to the Free Software Foundation, Inc., 51
+Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+
+2. For the Magnolia Network Agreement (MNA), this file
+and the accompanying materials are made available under the
+terms of the MNA which accompanies this distribution, and
+is available at http://www.magnolia-cms.com/mna.html

package/README.md

@@ -31,6 +31,7 @@ You can customize the **jumpstart** plugin's actions using these command-line op
 - `-p, --projectTemplatesPath <path>`: Specify from where the projectTemplates should be loaded.
 
 **Template option:**
+
 With this option, you can specify which template to use:
 
 ```bash
@@ -47,7 +48,94 @@ You can specify your own project templates list with the *--project-templates-pa
 magnolia-cli jumpstart -p "<project-templates-path>"
 ```
 
-**Light-modules folder:**
+
+## Extensions
+
+The extensions functionality allows for greater flexibility and customizability during the setup process of a new Magnolia project.
+
+### Extension YAML Configuration
+
+The plugin searches for extension YAML files in the following path within your project directory:
+`<rootdir>/extensions/extension.yaml`
+
+This YAML file defines additional prompts and post-command functions, which can be helpful for tailoring the plugin's functionality to specific project requirements.
+
+### Structure of the YAML File
+
+An extension YAML file typically contains the following key sections:
+
+- `extend`: Specifies a JavaScript file that the extension will tie into for additional logic or configuration.
+- `prompts`: A series of input prompts to gather necessary information from the user. Each prompt can specify:
+    - `type`: The type of prompt, such as `input` for user text input.
+    - `name`: The internal name used to reference the collected data.
+    - `message`: The message displayed to the user during the prompt.
+    - `default`: The default value for the prompt, used if the user provides no input.
+- `commands`: Defines actions to be taken after the prompts have been completed, such as:
+    - `post`: Commands to be executed after the setup process. This could involve downloading dependencies, setting up environment variables, etc.
+
+### Example
+
+```yaml
+extend: ./example.js
+prompts:
+  - type: input
+    name: clientId
+    message: Client ID
+    default: clientId_001
+
+  - type: input
+    name: organizationId
+    message: Organization Id
+    default: organizationId_001
+
+  - type: input
+    name: siteId
+    message: Site Id
+    default: siteId_001
+
+commands:
+  post:
+    - function: example
+      retry: 3
+      delay: 1000
+```
+
+### Execution Flow
+
+Upon project initialization, if an extension file is detected, the **Jumpstart** Plugin performs the following steps:
+
+1. **Input Gathering**: It prompts the user for input based on the `prompts` defined within the extension's YAML file.
+
+2. **Configuration Integration**: The plugin retrieves the main **package.json** file. The responses gathered from the prompts are then added to this configuration object under an `answers` property. This augmented **package.json** object is subsequently used to automatically populate the corresponding placeholders within your project files.
+
+3. **Post-Command Execution**: Each `post-command` function specified in the YAML file is executed. These functions have access to the `prompts` object, which contains the user's responses, allowing the functions to perform tasks that are tailored to the user's input.
+
+### Customization Example
+
+After gathering inputs, a file containing placeholders like below:
+```js
+// config.js
+
+export default {
+  clientId: <%=answers.siteId%>,
+  organizationId: <%=answers.organizationId%>,
+  siteId: <%=answers.siteId%>
+};
+```
+will be transformed into:
+```js
+// config.js
+
+export default {
+  clientId: clientId_001,
+  organizationId: organizationId_001,
+  siteId: siteId_001
+};
+```
+
+By using the **Jumpstart** Plugin's extensions functionality, developers can create a more interactive and automated project setup process, making it easier to get started with a new Magnolia project.
+
+## Light-modules folder:
 
 The Jumpstart Plugin initiates a recursive search throughout the project's directory structure for an existing `light-modules` directory. Upon detection, the plugin avoids creating a new one, instead utilizing the existing directory to maintain the pre-configured modules. On the other hand, if a `light-modules` directory is not found, the system will generate one.
 

package/dist/jumpstart-plugin.d.ts

@@ -1,23 +1,26 @@
 import { PluginTemplate } from '@magnolia/cli-plugin-template';
 import { Option } from 'commander';
-import { PluginOptions, Template, Bundle, TemplateWithoutChildren } from "./types/types.js";
+import { PluginOptions, Template, Bundle, TemplateWithoutChildren, Credentials } from "./types/types.js";
 import { Logger } from "winston";
 export declare let logger: Logger;
+export declare let i18nInstance: {
+    t(key: string, options?: any): string;
+};
 export default class JumpstartPlugin extends PluginTemplate {
     name: string;
     version: any;
     description: any;
     projectTemplates?: Array<Template>;
     options: Option[];
+    credentials?: Credentials;
     constructor();
     executePostCommands(bundle: Bundle, file: string): Promise<void>;
-    handleTemplate(template: TemplateWithoutChildren): Promise<void>;
+    handleTemplate(template: TemplateWithoutChildren, options: PluginOptions): Promise<void>;
     setProjectTemplates(options: PluginOptions): Promise<void>;
-    promptTemplateSelection(templates: Array<Template>): Promise<TemplateWithoutChildren | undefined>;
+    promptTemplateSelection(templates: Array<Template>, names?: string[]): Promise<TemplateWithoutChildren | undefined>;
     findTemplateByIdentifier(identifier: string): TemplateWithoutChildren | undefined;
     chooseTemplate(options: PluginOptions): Promise<void>;
     init(winstonLogger: Logger): Promise<void>;
     start(options: PluginOptions): Promise<void>;
     stop(): Promise<void>;
-    help(): Promise<void>;
 }

package/dist/jumpstart-plugin.js

@@ -19,17 +19,23 @@ import { downloadBundle } from "./lib/download.js";
 import { PostCommands } from "./types/types.js";
 import { installDependencies } from "./lib/install.js";
 import path from "path";
-import { handleLightModulesFolder, initializeNodeProject, installAdditionalPlugins } from "./lib/helper.js";
+import { askForCredentials, handleLightModulesFolder, initI18n, initializeNodeProject, installAdditionalPlugins } from "./lib/helper.js";
+import { compileCustomPrompts, evaluateCustomPrompts } from "./lib/extensions.js";
+const extensionsPath = path.resolve("./extensions/extension.yaml");
 export let logger;
+export let i18nInstance = {
+    t(key, options) { return key; }
+};
 export default class JumpstartPlugin extends PluginTemplate {
     constructor() {
         super();
         this.name = "jumpstart";
         this.version = pkg.version;
         this.description = pkg.description;
+        i18nInstance = initI18n(this.name);
         this.options = [
-            new Option('-t, --template <name>', 'Choose template'),
-            new Option('-p, --project-templates-path <path>', 'Specify from where the projectTemplates should be loaded')
+            new Option('-t, --template <name>', i18nInstance.t("cmd-option-template")),
+            new Option('-p, --project-templates-path <path>', i18nInstance.t("cmd-option-project-templates-path"))
         ];
     }
     executePostCommands(bundle, file) {
@@ -50,51 +56,26 @@ export default class JumpstartPlugin extends PluginTemplate {
             }
         });
     }
-    handleTemplate(template) {
+    handleTemplate(template, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            let templateCredentials;
             if (template.auth) {
-                console.log("Please enter credentials for ", template.name);
-                templateCredentials = yield inquirer
-                    .prompt([
-                    {
-                        type: 'input',
-                        name: 'username',
-                        message: 'Username'
-                    },
-                    {
-                        type: 'password',
-                        name: 'password',
-                        message: 'Password'
-                    }
-                ]);
+                logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("prompt-enter-credentials", {
+                    bundle: template.name
+                }));
+                this.credentials = yield askForCredentials();
             }
             for (const bundle of template.bundles || []) {
-                let credentials = null;
                 let file;
                 try {
-                    if (bundle.auth === "inherit") {
-                        file = yield downloadBundle(bundle, templateCredentials, undefined);
-                    }
-                    else if (bundle.auth) {
-                        console.log("Please enter credentials for ", bundle.name ? bundle.name : bundle.url);
-                        credentials = yield inquirer
-                            .prompt([
-                            {
-                                type: 'input',
-                                name: 'username',
-                                message: 'Username'
-                            },
-                            {
-                                type: 'password',
-                                name: 'password',
-                                message: 'Password'
-                            }
-                        ]);
-                        file = yield downloadBundle(bundle, credentials, undefined);
+                    if (bundle.auth === true) {
+                        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t('prompt-enter-credentials', {
+                            bundle: bundle.name ? bundle.name : bundle.url
+                        }));
+                        const bundleCredentials = yield askForCredentials();
+                        file = yield downloadBundle(bundle, bundleCredentials, undefined);
                     }
                     else {
-                        file = yield downloadBundle(bundle, null, undefined);
+                        file = yield downloadBundle(bundle, this.credentials, undefined);
                     }
                     if (file) {
                         yield this.executePostCommands(bundle, file);
@@ -107,23 +88,38 @@ export default class JumpstartPlugin extends PluginTemplate {
             yield handleLightModulesFolder();
             yield initializeNodeProject();
             if (template.plugins) {
-                yield installAdditionalPlugins(template.plugins);
+                yield installAdditionalPlugins(template.plugins, this.credentials);
+            }
+            const extensions = yield evaluateCustomPrompts(extensionsPath);
+            if (extensions === null || extensions === void 0 ? void 0 : extensions.answers) {
+                yield compileCustomPrompts(extensions === null || extensions === void 0 ? void 0 : extensions.answers);
+            }
+            if (extensions === null || extensions === void 0 ? void 0 : extensions.executePostCommands) {
+                yield extensions.executePostCommands(extensions === null || extensions === void 0 ? void 0 : extensions.answers);
             }
         });
     }
     setProjectTemplates(options) {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             try {
                 if ((_a = options.projectTemplatesPath) === null || _a === void 0 ? void 0 : _a.startsWith("http", 0)) {
-                    const res = yield axios.get(options.projectTemplatesPath);
+                    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t('prompt-project-templates-credentials'));
+                    this.credentials = yield askForCredentials();
+                    const res = yield axios.get(options.projectTemplatesPath, {
+                        auth: this.credentials
+                    });
                     this.projectTemplates = res.data.projectTemplates;
                 }
                 else if (options.projectTemplatesPath) {
-                    this.projectTemplates = requireFn(path.join(process.cwd(), options.projectTemplatesPath)).projectTemplates;
+                    this.projectTemplates = requireFn(path.resolve(options.projectTemplatesPath)).projectTemplates;
                 }
                 else {
-                    const res = yield axios.get("https://git.magnolia-cms.com/rest/api/latest/projects/SERVICES/repos/cli-project-templates/raw/projectTemplates.json");
+                    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t('prompt-project-templates-credentials'));
+                    this.credentials = yield askForCredentials();
+                    const res = yield axios.get("https://git.magnolia-cms.com/rest/api/latest/projects/SERVICES/repos/cli-project-templates/raw/projectTemplates.json", {
+                        auth: this.credentials
+                    });
                     this.projectTemplates = res.data.projectTemplates;
                 }
             }
@@ -132,8 +128,8 @@ export default class JumpstartPlugin extends PluginTemplate {
             }
         });
     }
-    promptTemplateSelection(templates) {
-        return __awaiter(this, void 0, void 0, function* () {
+    promptTemplateSelection(templates_1) {
+        return __awaiter(this, arguments, void 0, function* (templates, names = []) {
             if (!templates || !templates.length) {
                 return;
             }
@@ -151,11 +147,14 @@ export default class JumpstartPlugin extends PluginTemplate {
                     choices: choices
                 }
             ]);
+            if (template.name) {
+                names.push(template.name);
+            }
             if (template.children && template.children.length) {
-                return this.promptTemplateSelection(template.children);
+                return this.promptTemplateSelection(template.children, names);
             }
             if (template.bundles || template.plugins) {
-                return template;
+                return Object.assign(Object.assign({}, template), { name: names.join("/") });
             }
         });
     }
@@ -179,16 +178,18 @@ export default class JumpstartPlugin extends PluginTemplate {
             if (typeof options.template === 'string') {
                 const template = this.findTemplateByIdentifier(options.template);
                 if (template) {
-                    yield this.handleTemplate(template);
+                    yield this.handleTemplate(template, options);
                     return;
                 }
                 else {
-                    logger.info(`The '${options.template}' template was not found.`);
+                    logger.info(i18nInstance.t("info-template_not_found", {
+                        template: options.template
+                    }));
                 }
             }
             const template = yield this.promptTemplateSelection(this.projectTemplates);
             if (template) {
-                yield this.handleTemplate(template);
+                yield this.handleTemplate(template, options);
             }
         });
     }
@@ -199,19 +200,14 @@ export default class JumpstartPlugin extends PluginTemplate {
     }
     start(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            logger === null || logger === void 0 ? void 0 : logger.info(`'JumpstartPlugin' plugin started succesfully.`);
+            logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-jumpstart_started"));
             yield this.setProjectTemplates(options);
             yield this.chooseTemplate(options);
         });
     }
     stop() {
         return __awaiter(this, void 0, void 0, function* () {
-            console.log("Plugin stopped");
-        });
-    }
-    help() {
-        return __awaiter(this, void 0, void 0, function* () {
-            console.log("Plugin help");
+            logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-jumpstart_stopped"));
         });
     }
 }

package/dist/lib/config-helper.d.ts

@@ -1,3 +1,3 @@
-import { PluginRequirement } from "../types/types.js";
+import { Credentials, PluginRequirement } from "../types/types.js";
 export declare const handleMGNLConfigFile: () => Promise<void>;
-export declare const installAndConfigPlugins: (plugins: Array<PluginRequirement>) => Promise<void>;
+export declare const installAndConfigPlugins: (plugins: Array<PluginRequirement>, credentials?: Credentials) => Promise<void>;

package/dist/lib/config-helper.js

@@ -14,7 +14,7 @@ import beautifyModule from "js-beautify";
 import path from "path";
 import { determinePackageManager, extractRepoName, installPackage, isValidURL } from "./helper.js";
 import ora from "ora";
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
 const { js_beautify } = beautifyModule;
 const BEAUTIFY_OPTIONS = {
     indent_size: 2,
@@ -29,7 +29,7 @@ export const handleMGNLConfigFile = () => __awaiter(void 0, void 0, void 0, func
     let isMgnlCliInstalled = true;
     if (!fs.existsSync(getPackageConfigPath())) {
         isMgnlCliInstalled = yield installPackage(determinePackageManager(), "@magnolia/cli@preview");
-        logger === null || logger === void 0 ? void 0 : logger.warn("Couldn't install @magnolia/cli");
+        logger === null || logger === void 0 ? void 0 : logger.warn(i18nInstance.t('warn-config-h-could-not-install-cli'));
     }
     if (isMgnlCliInstalled && fs.existsSync(getLocalConfigPath())) {
         handleExistingConfigFile();
@@ -44,15 +44,15 @@ export const handleMGNLConfigFile = () => __awaiter(void 0, void 0, void 0, func
         // the mgnl.config.js exist, do not do anything
     }
 });
-export const installAndConfigPlugins = (plugins) => __awaiter(void 0, void 0, void 0, function* () {
+export const installAndConfigPlugins = (plugins, credentials) => __awaiter(void 0, void 0, void 0, function* () {
     const localConfig = parseConfigFile(getLocalConfigPath());
     if (!localConfig)
         return;
     const missingPlugins = findMissingPlugins(plugins, localConfig);
     if (missingPlugins.length === 0)
         return;
-    logger === null || logger === void 0 ? void 0 : logger.info(`Will attempt to install missing plugins`);
-    const installedPlugins = yield installPlugins(missingPlugins);
+    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-config-h-will-install-missing-plugins"));
+    const installedPlugins = yield installPlugins(missingPlugins, credentials);
     const pluginsConfig = createCustomConfigForPlugins(installedPlugins);
     updateLocalConfig(pluginsConfig, localConfig);
 });
@@ -106,16 +106,25 @@ const findMissingPlugins = (plugins, config) => {
         return !config.imports.some(customImport => customImport.importedNames === packageName);
     });
 };
-const installPlugins = (plugins) => __awaiter(void 0, void 0, void 0, function* () {
+const installPlugins = (plugins, credentials) => __awaiter(void 0, void 0, void 0, function* () {
     const packageManager = determinePackageManager();
     let installedPlugins = [];
     for (const plugin of plugins) {
-        const installed = yield installPackage(packageManager, plugin.installReference, plugin.name);
+        const installed = yield installPackage(packageManager, plugin.installReference, plugin.name, credentials);
         if (installed)
             installedPlugins.push(plugin);
     }
     return installedPlugins;
 });
+const extractPackageName = (installReference) => {
+    // Use a regular expression to match the package name.
+    const regex = /^(?:@([^/]+)\/)?([^@]+)/;
+    const match = installReference.match(regex);
+    if (!match)
+        return null;
+    // Construct package name. If it's a scoped package, prepend the scope.
+    return match[1] ? `@${match[1]}/${match[2]}` : match[2];
+};
 const createCustomConfigForPlugins = (plugins) => {
     const defaultConfig = { configContent: "", imports: [], commands: [] };
     plugins.forEach(plugin => {
@@ -126,8 +135,8 @@ const createCustomConfigForPlugins = (plugins) => {
         if (!importSource) {
             importSource = plugin.installReference;
         }
-        defaultConfig.imports.push({ importedNames: plugin.name, importSource: importSource });
-        defaultConfig.commands.push({ commandName: plugin.name });
+        defaultConfig.imports.push({ importedNames: plugin.name, importSource: extractPackageName(importSource) || importSource });
+        defaultConfig.commands.push({ commandName: plugin.name, options: plugin.options });
     });
     return defaultConfig;
 };
@@ -137,7 +146,9 @@ const parseConfigFile = (configPath) => {
         configContent = fs.readFileSync(configPath, 'utf-8');
     }
     catch (e) {
-        logger === null || logger === void 0 ? void 0 : logger.error(`Couldn't read ${configPath}`);
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-config-h-could-not-read-mgnl-config", {
+            configPath: configPath
+        }));
         console.error(e);
         return null;
     }
@@ -146,7 +157,9 @@ const parseConfigFile = (configPath) => {
         parsedConfig = parser.parse(configContent, { sourceType: 'module' });
     }
     catch (e) {
-        logger === null || logger === void 0 ? void 0 : logger.error(`Couldn't parse ${configPath}, please check the file for issues`);
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-config-h-could-not-parse-mgnl-config", {
+            configPath: configPath
+        }));
         console.error(e);
         return null;
     }
@@ -193,8 +206,14 @@ const updateLocalConfig = (defaultConfig, localConfig) => {
     const updatedConfigContent = mergeCommandsWithConfigContent(localConfig.configContent, missingCommands);
     writeToLocalConfigFile(mergedImports, updatedConfigContent);
 };
+const formatOptions = (options) => {
+    if (!options)
+        return '()';
+    const formattedOptions = JSON.stringify(options, null);
+    return `(${formattedOptions})`;
+};
 const mergeCommandsWithConfigContent = (configContent, missingCommands) => {
-    const missingCommandsStr = missingCommands.map(c => `new ${c.commandName}()`).join(',\n');
+    const missingCommandsStr = missingCommands.map(c => `new ${c.commandName}${formatOptions(c.options)}`).join(',\n');
     const commandsPattern = /(commands\s*:\s*\[)([^\]]*?)(,\s*)?(\])/;
     return configContent.replace(commandsPattern, (match, p1, p2, p3, p4) => {
         const separator = (p2.trim() !== "" && missingCommandsStr.trim() !== "") ? "," : "";
@@ -207,15 +226,15 @@ const writeToLocalConfigFile = (mergedImports, updatedConfigContent) => {
     writeConfigContent(configContentWithImports);
 };
 const writeConfigContent = (content) => {
-    const spinner = ora().start(`Updating mgnl.config.js`);
+    const spinner = ora().start(i18nInstance.t("ora-updating-mgnl-config"));
     try {
         fs.writeFileSync(getLocalConfigPath(), js_beautify(content.trim(), BEAUTIFY_OPTIONS), 'utf-8');
     }
     catch (e) {
         spinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.error('Error occured while updating mgnl.config.js');
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-config-h-while-updating-mgnl-config"));
         console.error(e);
     }
     spinner.stop();
-    logger === null || logger === void 0 ? void 0 : logger.info('mgnl.config.js updated');
+    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-config-h-mgnl-config-updated"));
 };

package/dist/lib/download.js

@@ -12,12 +12,15 @@ import fs from "fs-extra";
 import axios from "axios";
 import ProgressBar from "progress";
 import inquirer from "inquirer";
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
 export const downloadBundle = (bundle, credentials, dest) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         let url = bundle.url;
         const downloadDest = dest ? dest : "./download-" + new Date().getTime();
         let downloadUrl;
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-download-preparing", {
+            url
+        }));
         if (path.parse(url).name === "tags") {
             downloadUrl = yield selectTag(url, credentials);
         }
@@ -31,7 +34,7 @@ export const downloadBundle = (bundle, credentials, dest) => __awaiter(void 0, v
             method: 'get',
             responseType: 'stream',
         };
-        if (credentials) {
+        if (credentials && credentials.username && credentials.password) {
             opts.auth = credentials;
         }
         if (downloadDest) {
@@ -39,8 +42,16 @@ export const downloadBundle = (bundle, credentials, dest) => __awaiter(void 0, v
         }
         const tempDownload = path.join(downloadDest, bundle.name ? bundle.name : 'temp-' + new Date().getTime());
         const target = fs.createWriteStream(tempDownload);
-        logger === null || logger === void 0 ? void 0 : logger.info("Starting download from: " + downloadUrl);
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-download-starting", {
+            downloadUrl: downloadUrl
+        }));
         const res = yield axios.get(downloadUrl, opts);
+        if (res.status !== 200) {
+            throw new Error(i18nInstance.t("info-download-status-error", {
+                downloadUrl: downloadUrl,
+                status: res.status
+            }));
+        }
         if (res.headers['content-length']) {
             const len = parseInt(res.headers['content-length'], 10);
             const bar = new ProgressBar('Downloading [:bar] :percent :etas', {
@@ -54,14 +65,19 @@ export const downloadBundle = (bundle, credentials, dest) => __awaiter(void 0, v
             });
         }
         res.data.pipe(target);
-        res.data.on('error', (error) => {
-            throw new Error(error);
-        });
         return new Promise((resolve) => {
-            res.data.on('end', () => {
-                logger === null || logger === void 0 ? void 0 : logger.info("Download finished");
+            target.on('finish', () => {
+                logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-download-finished"));
                 resolve(path.join('.', tempDownload));
             });
+            target.on('error', (error) => {
+                target.close();
+                throw new Error(error);
+            });
+            res.data.on('error', (error) => {
+                target.close();
+                throw new Error(error);
+            });
         });
     }
     catch (error) {
@@ -88,6 +104,12 @@ export const getDownloadUrl = (bundle, credentials) => __awaiter(void 0, void 0,
         return downloadUrl;
     }
     catch (error) {
+        if (error.code === 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY') {
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-download-problem-accessing-url", {
+                url: bundle.url
+            }));
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-download-unable-to-get-local-issuer-certificate"));
+        }
         throw new Error(error);
     }
 });
@@ -104,7 +126,7 @@ export const selectTag = (url, credentials) => __awaiter(void 0, void 0, void 0,
     }
     const res = yield axios.get(url, opts);
     if (!((_a = res.data) === null || _a === void 0 ? void 0 : _a.values) || res.data.values.length <= 0) {
-        throw new Error("There are no available tags");
+        throw new Error(i18nInstance.t("error-download-no-tags"));
     }
     const { tag } = yield inquirer
         .prompt([

package/dist/lib/extensions.d.ts

@@ -0,0 +1,5 @@
+export declare const evaluateCustomPrompts: (extensionsPath: string) => Promise<{
+    answers: import("inquirer").Answers;
+    executePostCommands: (context: any) => Promise<void>;
+} | undefined>;
+export declare const compileCustomPrompts: (answers: any, pattern?: string) => Promise<void>;

package/dist/lib/extensions.js

@@ -0,0 +1,125 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import fs from "fs-extra";
+import path from "path";
+import inquirer from "inquirer";
+import { execa } from "execa";
+import { parse } from 'yaml';
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
+import ora from "ora";
+import { determinePackageManager } from "./helper.js";
+import { pathToFileURL } from "url";
+import { globSync } from "glob";
+import _ from "underscore";
+function pause(milliSeconds) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve();
+            }, milliSeconds);
+        });
+    });
+}
+function callExtensionFunction(func_1, context_1, name_1) {
+    return __awaiter(this, arguments, void 0, function* (func, context, name, delay = 200, retry = 0, maxRetry = 0) {
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-extensions-calling-fn", {
+            name: name
+        }));
+        try {
+            yield func(context);
+        }
+        catch (error) {
+            if (retry === maxRetry) {
+                throw error;
+            }
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-extensions-calling-fn-retry", {
+                name: name,
+                retry: retry,
+                maxRetry: maxRetry,
+                delay: delay
+            }));
+            yield pause(delay);
+            yield callExtensionFunction(func, context, name, delay, retry + 1, maxRetry);
+        }
+    });
+}
+function executePostCommands() {
+    return __awaiter(this, arguments, void 0, function* (cmds = [], extensions, context) {
+        for (let cmd of cmds) {
+            const func = extensions[cmd.function];
+            if (func) {
+                try {
+                    yield callExtensionFunction(func, context, cmd.function, cmd.delay, 0, cmd.retry);
+                }
+                catch (e) {
+                    throw e;
+                }
+            }
+            else {
+                logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-extensions-fn-not-found", {
+                    function: cmd.function
+                }));
+            }
+        }
+    });
+}
+// evaluate the given yaml file and create cli prompts out of it, return the answers
+export const evaluateCustomPrompts = (extensionsPath) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!fs.existsSync(extensionsPath)) {
+        return;
+    }
+    const doc = parse(fs.readFileSync(extensionsPath, 'utf8'));
+    const baseDir = path.parse(extensionsPath).dir;
+    const packageJson = path.join(baseDir, 'package.json');
+    if (fs.existsSync(packageJson)) {
+        const npmISpinner = ora().start(i18nInstance.t("ora-installing-ext-dep"));
+        const packageManager = determinePackageManager(baseDir);
+        try {
+            yield execa(packageManager, ["install"], {
+                buffer: true,
+                cwd: baseDir
+            });
+        }
+        catch (e) {
+            npmISpinner.stop();
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-extensions-install-fail", {
+                packageManager: packageManager
+            }));
+            return;
+        }
+        npmISpinner.stop();
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-extensions-install-done"));
+    }
+    try {
+        const extensions = doc.extend ? yield import(pathToFileURL(path.join(baseDir, doc.extend)).href) : null;
+        return {
+            answers: doc.prompts ? yield inquirer.prompt(doc.prompts) : {},
+            executePostCommands: (context) => __awaiter(void 0, void 0, void 0, function* () { var _a; return yield executePostCommands((_a = doc === null || doc === void 0 ? void 0 : doc.commands) === null || _a === void 0 ? void 0 : _a.post, extensions, context); })
+        };
+    }
+    catch (error) {
+        throw error;
+    }
+});
+export const compileCustomPrompts = (answers_1, ...args_1) => __awaiter(void 0, [answers_1, ...args_1], void 0, function* (answers, pattern = '**/**/**/*.{yaml,tsx,ts,js,jsx,vue,md,json}') {
+    const init = globSync(pattern, { ignore: 'node_modules/**' }).map(itm => path.join(process.cwd(), itm));
+    const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), './package.json'), 'utf8'));
+    pkg.answers = answers;
+    for (const item of init) {
+        try {
+            const file = fs.readFileSync(item, 'utf8');
+            const doc = _.template(file)(pkg);
+            fs.outputFileSync(item, doc, 'utf8');
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+});

package/dist/lib/extract.js

@@ -13,10 +13,10 @@ import walk from "walk";
 import fs from "fs-extra";
 import { PostCommands } from "../types/types.js";
 import url from "url";
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
 export const extract = (bundle, file, command) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
-    logger === null || logger === void 0 ? void 0 : logger.info('Extracting...');
+    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-extract-extracting"));
     const { dest = "./", type } = bundle;
     const unzipFolder = "temp-" + new Date().getTime();
     yield decompress(file, unzipFolder);
@@ -48,7 +48,7 @@ export const findExtractedApacheTomcatDir = (p) => {
             next();
         });
         walker.on('end', function () {
-            return reject(new Error("apache-tomcat was not found."));
+            return reject(new Error(i18nInstance.t("error-extract-apache-tomcat-not-found")));
         });
     });
 };

package/dist/lib/helper.d.ts

@@ -1,10 +1,13 @@
-import { PluginRequirement } from "../types/types.js";
+import { Credentials, PluginRequirement } from "../types/types.js";
+import { i18n } from "i18next";
+export declare function initI18n(pluginName: string, namespace?: string): i18n;
 export declare const handleLightModulesFolder: () => Promise<void>;
 export declare const findLightModulesFolder: (p: string) => Promise<unknown>;
 export declare const findWebAppsList: (apacheTomcatPath: string) => string[];
-export declare const installAdditionalPlugins: (plugins: Array<PluginRequirement>) => Promise<void>;
+export declare const installAdditionalPlugins: (plugins: Array<PluginRequirement>, credentials?: Credentials) => Promise<void>;
 export declare const initializeNodeProject: () => Promise<void>;
-export declare const installPackage: (packageManager: string, packageReference: string, packageName?: string) => Promise<boolean>;
+export declare const installPackage: (packageManager: string, packageReference: string, packageName?: string, credentials?: Credentials) => Promise<boolean>;
 export declare const isValidURL: (str: string) => boolean;
 export declare const extractRepoName: (gitUrl: string) => string | null;
 export declare const determinePackageManager: (baseDirectory?: string) => "yarn" | "npm";
+export declare const askForCredentials: () => Promise<Credentials>;

package/dist/lib/helper.js

@@ -9,32 +9,84 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { handleMGNLConfigFile, installAndConfigPlugins } from "./config-helper.js";
 import { handlePackageJSON } from "./pj-helper.js";
+import i18next from "i18next";
+import Backend from 'i18next-fs-backend';
 import ora from "ora";
 import { execa } from "execa";
 import path from "path";
 import fs from "fs-extra";
 import { findExtractedApacheTomcatDir } from "./extract.js";
 import walk from "walk";
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
+import { fileURLToPath } from "url";
+import inquirer from "inquirer";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function initI18n(pluginName, namespace = "translation") {
+    const lng = 'en';
+    const localesPath = path.join(__dirname, `locales/${lng}`);
+    const namespaces = fs.readdirSync(localesPath)
+        .filter(file => file.endsWith('.json'))
+        .map(file => file.replace('.json', ''));
+    if (!namespaces.includes(namespace)) {
+        console.warn(`${pluginName}: Requested translation file "${namespace}" not found at "${localesPath}".\n`);
+        if (namespaces.length > 0) {
+            console.warn(`Using "${namespaces[0]}" instead.\n`);
+        }
+        namespace = namespaces[0];
+    }
+    const newI18nInstance = i18next.createInstance();
+    newI18nInstance
+        .use(Backend)
+        .init({
+        joinArrays: '\n',
+        lng: lng,
+        fallbackLng: 'en',
+        ns: namespaces,
+        defaultNS: namespace,
+        initImmediate: false,
+        interpolation: {
+            escapeValue: false,
+        },
+        backend: {
+            loadPath: path.join(__dirname, 'locales/{{lng}}/{{ns}}.json')
+        }
+    });
+    return newI18nInstance;
+}
 export const handleLightModulesFolder = () => __awaiter(void 0, void 0, void 0, function* () {
     let lightModulesPath;
     try {
         lightModulesPath = (yield findLightModulesFolder(process.cwd()));
-        logger === null || logger === void 0 ? void 0 : logger.info(`Found existing light-modules path at '${lightModulesPath}'`);
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-helper-found-lm", {
+            lightModulesPath: lightModulesPath
+        }));
     }
     catch (e) {
-        logger === null || logger === void 0 ? void 0 : logger.info(`No light-modules folder found. Attempting to create one.`);
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-helper-no-lm-found"));
         lightModulesPath = path.join(process.cwd(), 'light-modules');
         try {
             fs.mkdirSync(lightModulesPath, { recursive: true });
-            logger === null || logger === void 0 ? void 0 : logger.info(`'light-modules' folder created at '${lightModulesPath}'.`);
+            logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-helper-lm-created", {
+                lightModulesPath: lightModulesPath
+            }));
         }
         catch (error) {
-            logger === null || logger === void 0 ? void 0 : logger.error(`Failed to create 'light-modules' folder: ${error instanceof Error ? error.message : ""}`);
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-helper-lm-create-fail", {
+                errorMsg: error instanceof Error ? error.message : ""
+            }));
             return;
         }
     }
-    const apacheTomcatPath = yield findExtractedApacheTomcatDir(process.cwd());
+    let apacheTomcatPath;
+    try {
+        apacheTomcatPath = yield findExtractedApacheTomcatDir(process.cwd());
+    }
+    catch (error) {
+        logger === null || logger === void 0 ? void 0 : logger.warn(i18nInstance.t("warn-helper-cannot-modify-webapp", {
+            errorMsg: error instanceof Error ? error.message : ""
+        }));
+        return;
+    }
     const webApps = findWebAppsList(apacheTomcatPath);
     for (const webApp of webApps) {
         const lightModulesPathToMagnoliaHomeRelPath = process.platform === 'win32' ? path.relative(webApp, lightModulesPath).replace(/\\/g, '/') : path.relative(webApp, lightModulesPath);
@@ -51,7 +103,9 @@ export const handleLightModulesFolder = () => __awaiter(void 0, void 0, void 0,
 });
 const editProperties = (filePath, props) => {
     if (!fs.existsSync(filePath)) {
-        logger === null || logger === void 0 ? void 0 : logger.warn(`File ${filePath} doesn't exists, skipping configuration.`);
+        logger === null || logger === void 0 ? void 0 : logger.warn(i18nInstance.t("warn-helper-webapp-props-not-exist", {
+            filePath: filePath
+        }));
         return;
     }
     const propertiesFileContent = fs.readFileSync(filePath, 'utf-8');
@@ -59,11 +113,17 @@ const editProperties = (filePath, props) => {
     try {
         fs.writeFileSync(filePath, replacedContent);
         Object.keys(props).forEach((key) => {
-            logger === null || logger === void 0 ? void 0 : logger.info(`Setting ${key} to: ${props[key]} in ${filePath}`);
+            logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-helper-webapp-prop-setting", {
+                key: key,
+                propsKey: props[key],
+                filePath: filePath
+            }));
         });
     }
     catch (error) {
-        logger === null || logger === void 0 ? void 0 : logger.error(`An error occurred while updating 'magnolia.properties': ${error instanceof Error ? error.message : ""}`);
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-helper-webapp-props-update-error", {
+            errorMsg: error instanceof Error ? error.message : ""
+        }));
     }
 };
 const replaceInConfig = (config, props) => {
@@ -84,7 +144,7 @@ export const findLightModulesFolder = (p) => {
             next();
         });
         walker.on('end', function () {
-            return reject(new Error("light-modules was not found."));
+            return reject(new Error(i18nInstance.t("error-helper-lm-not-found")));
         });
     });
 };
@@ -100,30 +160,42 @@ export const findWebAppsList = (apacheTomcatPath) => {
     }
     return webApps;
 };
-export const installAdditionalPlugins = (plugins) => __awaiter(void 0, void 0, void 0, function* () {
-    yield installAndConfigPlugins(plugins);
+export const installAdditionalPlugins = (plugins, credentials) => __awaiter(void 0, void 0, void 0, function* () {
+    yield installAndConfigPlugins(plugins, credentials);
 });
 export const initializeNodeProject = () => __awaiter(void 0, void 0, void 0, function* () {
     yield handlePackageJSON();
     yield handleMGNLConfigFile();
 });
-export const installPackage = (packageManager, packageReference, packageName) => __awaiter(void 0, void 0, void 0, function* () {
+export const installPackage = (packageManager, packageReference, packageName, credentials) => __awaiter(void 0, void 0, void 0, function* () {
     if (!packageName) {
         packageName = packageReference;
     }
-    const spinner = ora().start(`Installing ${packageName}`);
+    if (packageReference.startsWith("git+https://git.magnolia-cms.com")) {
+        if (credentials === undefined) {
+            credentials = yield askForCredentials();
+        }
+        packageReference = packageReference.replace("git+https://git.magnolia-cms.com", `git+https://${credentials.username}:${credentials.password}@git.magnolia-cms.com`);
+    }
+    const spinner = ora().start(i18nInstance.t("ora-installing-package", {
+        packageName: packageName
+    }));
     try {
         yield execa(packageManager, [packageManager === 'npm' ? 'install' : 'add', packageReference], {
             buffer: true,
             cwd: process.cwd()
         });
         spinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.info(`${packageName} installed`);
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-helper-package-installed", {
+            packageName: packageName
+        }));
         return true;
     }
     catch (error) {
         spinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.error(`Failed to install ${packageName}`);
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-helper-fail-to-install-package", {
+            packageName: packageName
+        }));
         return false;
     }
 });
@@ -152,3 +224,17 @@ export const determinePackageManager = (baseDirectory = process.cwd()) => {
     // Default to npm
     return 'npm';
 };
+export const askForCredentials = () => __awaiter(void 0, void 0, void 0, function* () {
+    return inquirer.prompt([
+        {
+            type: 'input',
+            name: 'username',
+            message: 'Username'
+        },
+        {
+            type: 'password',
+            name: 'password',
+            message: 'Password'
+        }
+    ]);
+});

package/dist/lib/install.js

@@ -11,19 +11,19 @@ import { PostCommands } from "../types/types.js";
 import path from "path";
 import { execa } from "execa";
 import ora from 'ora';
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
 export const installDependencies = (bundle, command) => __awaiter(void 0, void 0, void 0, function* () {
-    const spinner = ora('Installing dependencies').start();
+    const spinner = ora(i18nInstance.t("ora-installing-dep")).start();
     try {
         yield execa(command === PostCommands.YarnInstall ? 'yarn' : 'npm', ['install'], {
             buffer: true,
             cwd: path.join(process.cwd(), bundle.dest ? bundle.dest : "./")
         });
         spinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.info('Dependencies installed');
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-install-dep"));
     }
     catch (e) {
         spinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.error('Failed to install dependencies');
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-install-dep-fail"));
     }
 });

package/dist/lib/locales/en/translation.json

@@ -0,0 +1,61 @@
+{
+  "cmd-option-template": "Choose template",
+  "cmd-option-project-templates-path": "Specify from where the projectTemplates should be loaded",
+
+  "prompt-enter-credentials": "Please enter credentials for {{bundle}}",
+  "prompt-project-templates-credentials": "Please enter credentials",
+
+  "info-template_not_found": "The '{{template}}' template was not found.",
+  "info-jumpstart_started": "'JumpstartPlugin' plugin started successfully.",
+  "info-jumpstart_stopped": "'JumpstartPlugin' stopped",
+  "info-config-h-will-install-missing-plugins": "Will attempt to install missing plugins",
+  "info-config-h-mgnl-config-updated": "mgnl.config.js updated",
+  "info-download-preparing": "Preparing to download {{url}}",
+  "info-download-starting": "Starting download from: {{downloadUrl}}",
+  "info-download-finished": "Download finished",
+  "info-download-status-error": "Failed to download from: {{downloadUrl}}. Expected 200, but received: {{status}}.",
+  "info-extensions-calling-fn": "Calling Function {{name}}.",
+  "info-extensions-install-done": "Installing Extension Dependencies. Done.",
+  "info-extract-extracting": "Extracting...",
+  "info-install-dep": "Dependencies installed",
+  "info-pj-helper-npm-done": "Running 'npm install' done",
+  "info-pj-helper-pj-created": "package.json created",
+  "info-pj-helper-add-mgnl-to-pj": "Adding \"mgnl\" script to package.json",
+  "info-helper-found-lm": "Found existing light-modules path at '{{lightModulesPath}}'",
+  "info-helper-no-lm-found": "No light-modules folder found. Attempting to create one.",
+  "info-helper-lm-created": "light-modules folder created at '{{lightModulesPath}}'.",
+  "info-helper-webapp-prop-setting": "Setting {{key}} to: {{propsKey}} in {{filePath}}",
+  "info-helper-package-installed": "{{packageName}} installed",
+
+  "warn-config-h-could-not-install-cli": "Couldn't install @magnolia/cli",
+  "warn-pj-helper-changing-type": "Changing 'type' to \"module\"",
+  "warn-helper-webapp-props-not-exist": "File {{filePath}} doesn't exists, skipping configuration.",
+  "warn-helper-cannot-modify-webapp": "Cannot modify webapps: {{errorMsg}}",
+
+  "error-config-h-could-not-read-mgnl-config": "Couldn't read {{configPath}}",
+  "error-config-h-could-not-parse-mgnl-config": "Couldn't parse {{configPath}}, please check the file for issues",
+  "error-config-h-while-updating-mgnl-config": "Error occurred while updating mgnl.config.js",
+  "error-download-no-tags": "There are no available tags",
+  "error-download-problem-accessing-url": "A problem was detected while accessing: {{url}}.",
+  "error-download-unable-to-get-local-issuer-certificate": "The \"unable to get local issuer certificate\" error indicates that something in your infrastructure is preventing the CLI from downloading the Magnolia artifacts. This is not a bug in the CLI. For example, you may be behind a proxy that requires certain certificates. You might be able to ask your infrastructure team to allow requests to the Magnolia artifact repository: https://nexus.magnolia-cms.com/ Please search the web on \"unable to get local issuer certificate\" for more information.",
+  "error-extensions-calling-fn-retry": "Error Calling Function {{name}}. {{retry}}/{{maxRetry}}. Waiting {{delay}}ms before retry.",
+  "error-extensions-fn-not-found": "{{function}} Function not found",
+  "error-extensions-path-not-found": "{{extensionsPath}} not found. Could not evaluate custom prompts.",
+  "error-extensions-install-fail": "'{{packageManager}} install' has failed",
+  "error-extract-apache-tomcat-not-found": "apache-tomcat was not found.",
+  "error-install-dep-fail": "Failed to install dependencies",
+  "error-pj-helper-npm-fail": "'npm install' has failed",
+  "error-pj-helper-pj-mod-fail": "Failed to modify package.json",
+  "error-pj-helper-pj-create-fail": "Failed to create package.json",
+  "error-helper-lm-create-fail": "Failed to create 'light-modules' folder: {{errorMsg}}",
+  "error-helper-webapp-props-update-error": "An error occurred while updating 'magnolia.properties': {{errorMsg}}",
+  "error-helper-lm-not-found": "light-modules was not found",
+  "error-helper-fail-to-install-package": "Failed to install {{packageName}}",
+
+  "ora-updating-mgnl-config": "Updating mgnl.config.js",
+  "ora-installing-ext-dep": "Installing Extension Dependencies",
+  "ora-installing-dep": "Installing dependencies",
+  "ora-running-npm-install": "Didn't find 'node_modules' folder. Running 'npm install'",
+  "ora-creating-pj": "Creating package.json",
+  "ora-installing-package": "Installing {{packageName}}"
+}

package/dist/lib/pj-helper.js

@@ -12,7 +12,7 @@ import ora from "ora";
 import fs from "fs-extra";
 import { execa } from "execa";
 import { determinePackageManager, installPackage } from "./helper.js";
-import { logger } from "../jumpstart-plugin.js";
+import { i18nInstance, logger } from "../jumpstart-plugin.js";
 export const handlePackageJSON = () => __awaiter(void 0, void 0, void 0, function* () {
     const pjPath = path.join(process.cwd(), 'package.json');
     if (!fs.existsSync(pjPath)) {
@@ -31,7 +31,7 @@ export const modifyPackageJSON = (pjPath) => __awaiter(void 0, void 0, void 0, f
     }
     const nodeModulesPath = path.join(process.cwd(), "node_modules");
     if (!fs.existsSync(nodeModulesPath)) {
-        const npmISpinner = ora().start("Didn't find 'node_modules' folder. Running 'npm install'");
+        const npmISpinner = ora().start(i18nInstance.t("ora-running-npm-install"));
         try {
             yield execa(determinePackageManager(), ["install"], {
                 buffer: true,
@@ -40,11 +40,11 @@ export const modifyPackageJSON = (pjPath) => __awaiter(void 0, void 0, void 0, f
         }
         catch (e) {
             npmISpinner.stop();
-            logger === null || logger === void 0 ? void 0 : logger.error("'npm install' has failed");
+            logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-pj-helper-npm-fail"));
             return;
         }
         npmISpinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.info("Running 'npm install' done");
+        logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-pj-helper-npm-done"));
     }
     if (isMgnlCliInstalled) {
         const mgnlScript = { "mgnl": "node node_modules/@magnolia/cli" };
@@ -53,7 +53,7 @@ export const modifyPackageJSON = (pjPath) => __awaiter(void 0, void 0, void 0, f
             pj.scripts = {};
         }
         if (!pj.scripts[scriptKey] || pj.scripts[scriptKey] !== mgnlScript[scriptKey]) {
-            logger === null || logger === void 0 ? void 0 : logger.info('Add "mgnl" script to package.json');
+            logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-pj-helper-add-mgnl-to-pj"));
             pj.scripts[scriptKey] = mgnlScript[scriptKey];
         }
     }
@@ -61,19 +61,19 @@ export const modifyPackageJSON = (pjPath) => __awaiter(void 0, void 0, void 0, f
         pj.type = "module";
     }
     else if (pj.type !== "module") {
-        logger === null || logger === void 0 ? void 0 : logger.warn(`Changing 'type' to "module"`);
+        logger === null || logger === void 0 ? void 0 : logger.warn(i18nInstance.t("warn-pj-helper-changing-type"));
         pj.type = "module";
     }
     try {
         fs.writeFileSync(pjPath, JSON.stringify(pj, null, '\t'), 'utf8');
     }
     catch (e) {
-        logger === null || logger === void 0 ? void 0 : logger.error('Failed to modify package.json');
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-pj-helper-pj-mod-fail"));
         return;
     }
 });
 export const initPackageJSON = () => __awaiter(void 0, void 0, void 0, function* () {
-    const pjSpinner = ora().start('Creating package.json');
+    const pjSpinner = ora().start(i18nInstance.t("ora-creating-pj"));
     try {
         yield execa(determinePackageManager(), ['init', '-y'], {
             buffer: true,
@@ -82,10 +82,10 @@ export const initPackageJSON = () => __awaiter(void 0, void 0, void 0, function*
     }
     catch (e) {
         pjSpinner.stop();
-        logger === null || logger === void 0 ? void 0 : logger.info('Failed to create package.json');
+        logger === null || logger === void 0 ? void 0 : logger.error(i18nInstance.t("error-pj-helper-pj-create-fail"));
         console.error(e);
         return;
     }
     pjSpinner.stop();
-    logger === null || logger === void 0 ? void 0 : logger.info('package.json created');
+    logger === null || logger === void 0 ? void 0 : logger.info(i18nInstance.t("info-pj-helper-pj-created"));
 });

package/dist/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@magnolia/cli-jumpstart-plugin",
-  "version": "1.0.0-preview.3",
+  "version": "1.0.0-preview.4",
   "description": "Plugin to set up new projects using predefined templates and bundles. Easily select and configure project templates, and let the plugin handle bundle downloads, extraction, and post-command execution.",
   "main": "dist/index.js",
   "scripts": {
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "build": "standard && tsc && cpy package.json dist",
+    "test": "npm run build && node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "build": "standard --fix && tsc && cpy package.json dist && cpy lib/locales dist",
     "standard": "npx standard"
   },
   "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "author": "Magnolia International Ltd.",
+  "license": "SEE LICENSE IN LICENSE.txt",
   "devDependencies": {
     "@jest/globals": "^29.6.3",
     "@types/decompress": "^4.2.4",
@@ -19,6 +19,7 @@
     "@types/js-beautify": "^1.14.0",
     "@types/node": "^20.3.3",
     "@types/progress": "^2.0.5",
+    "@types/underscore": "^1.11.14",
     "@types/walk": "^2.3.1",
     "@types/yauzl": "^2.10.1",
     "cpy-cli": "^5.0.0",
@@ -37,12 +38,17 @@
     "dotenv": "^16.3.1",
     "execa": "^7.2.0",
     "fs-extra": "^11.1.1",
+    "glob": "^10.3.10",
+    "i18next": "^23.8.2",
+    "i18next-fs-backend": "^2.3.1",
     "inquirer": "^9.2.8",
     "js-beautify": "^1.14.9",
     "ora": "^7.0.1",
     "progress": "^2.0.3",
+    "underscore": "^1.13.6",
     "walk": "^2.3.15",
-    "winston": "^3.10.0"
+    "winston": "^3.10.0",
+    "yaml": "^2.3.4"
   },
   "type": "module",
   "standard": {

package/dist/types/types.d.ts

@@ -40,11 +40,12 @@ export type Template = TemplateWithChildren | TemplateWithoutChildren;
 export interface PluginRequirement {
     name: string;
     installReference: string;
+    options?: any;
 }
 export type Credentials = {
     username: string;
     password: string;
-} | null;
+} | undefined;
 export declare enum PostCommands {
     Extract = "extract",
     ExtractAndOverride = "extract and override",
@@ -61,9 +62,15 @@ export type ImportItem = {
 };
 export interface CommandItem {
     commandName: string;
+    options?: any;
 }
 export type ParsedConfigData = {
     configContent: string;
     imports: ImportItem[];
     commands: CommandItem[];
 };
+export interface PostCommandFunction {
+    function: string;
+    delay: number;
+    retry: number;
+}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@magnolia/cli-jumpstart-plugin",
-  "version": "1.0.0-preview.3",
+  "version": "1.0.0-preview.4",
   "description": "Plugin to set up new projects using predefined templates and bundles. Easily select and configure project templates, and let the plugin handle bundle downloads, extraction, and post-command execution.",
   "main": "dist/index.js",
   "scripts": {
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "build": "standard && tsc && cpy package.json dist",
+    "test": "npm run build && node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "build": "standard --fix && tsc && cpy package.json dist && cpy lib/locales dist",
     "standard": "npx standard"
   },
   "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "author": "Magnolia International Ltd.",
+  "license": "SEE LICENSE IN LICENSE.txt",
   "devDependencies": {
     "@jest/globals": "^29.6.3",
     "@types/decompress": "^4.2.4",
@@ -19,6 +19,7 @@
     "@types/js-beautify": "^1.14.0",
     "@types/node": "^20.3.3",
     "@types/progress": "^2.0.5",
+    "@types/underscore": "^1.11.14",
     "@types/walk": "^2.3.1",
     "@types/yauzl": "^2.10.1",
     "cpy-cli": "^5.0.0",
@@ -37,12 +38,17 @@
     "dotenv": "^16.3.1",
     "execa": "^7.2.0",
     "fs-extra": "^11.1.1",
+    "glob": "^10.3.10",
+    "i18next": "^23.8.2",
+    "i18next-fs-backend": "^2.3.1",
     "inquirer": "^9.2.8",
     "js-beautify": "^1.14.9",
     "ora": "^7.0.1",
     "progress": "^2.0.3",
+    "underscore": "^1.13.6",
     "walk": "^2.3.15",
-    "winston": "^3.10.0"
+    "winston": "^3.10.0",
+    "yaml": "^2.3.4"
   },
   "type": "module",
   "standard": {