Add utility prompts for WordPress configuration and dump options

Introducing new utility file prompts.js which contains two asynchronous functions; one that prompts the user for their new WordPress installation details for configuration initialization and another that checks if the user wants to dump installation. These prompts help to improve the user experience by allowing interactive customization for WordPress installations and dump handling, and serve to better structure the codebase.

lib/utils/prompts.js

@@ -0,0 +1,99 @@
+const inquirer = require("inquirer");
+const {DefaultWpInstallFolder, PkgFileName} = require("../constants");
+const path = require("path");
+const {initConfig} = require("./data");
+const {getWordPressPaths} = require("./wordpress");
+const Dump = require("../Dump");
+
+/**
+ * This function prompts the user for configuration details regarding a new WordPress installation.
+ * It first checks if the user wants to create a new installation. If so, it asks for the name,
+ * version, and language of the site. It then initializes the configuration based on the provided
+ * details. If the user does not want a new installation, it terminates the process with an error
+ * message asking for a template file.
+ *
+ * @return {Promise<import("../constants").WPMMconfig>} Returns a promise that resolves with the result of the initialization of the
+ * configuration or ends the process if the template file does not exist.
+ */
+async function askForConfiguration() {
+  return await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'newInstallation',
+      message: '❓ Do you want to create a new WordPress installation?',
+      default: true
+    },
+    {
+      type: 'input',
+      name: 'name',
+      message: 'Enter the name of your website:',
+      default: process.cwd().split("/").pop() || DefaultWpInstallFolder,
+      when: (answers) => answers.newInstallation // This question will be asked only if 'newInstallation' is true
+    },
+    {
+      type: 'input',
+      name: 'version',
+      message: 'Enter the WordPress version:',
+      default: 'Latest',
+      when: (answers) => answers.newInstallation
+    },
+    {
+      type: 'input',
+      name: 'language',
+      message: 'Enter the language for your WordPress site:',
+      default: 'English',
+      when: (answers) => answers.newInstallation
+    }
+  ])
+    .then((answers) => {
+      if (answers.newInstallation) {
+        const {name, version, language} = answers;
+
+        // If the template file does not exist, create it with the default config in the 'wordpress' folder
+        const baseFolder = path.join(process.cwd(), name ?? DefaultWpInstallFolder);
+        return initConfig(baseFolder, {version, language});
+      } else {
+        console.error(`⚠️ The template file ${PkgFileName} does not exist in the current folder. Please provide a template file using the --template option.`);
+        process.exit(1);
+      }
+    })
+    .then((result) => {
+      return result;
+    });
+}
+
+/**
+ * This async function asks the user if they want to dump the WordPress
+ * installation. If the user confirms, it gets the WordPress paths, creates
+ * a new Dump instance, and initiates it.
+ *
+ * It does not take any parameters.
+ *
+ * @return {Promise<import("../constants").WPMMconfig>} The result of the dump initiation, if it is initiated.
+ */
+async function askForDump() {
+  return await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'dump',
+      message: '❓ Do you want to Dump this WordPress installation?',
+      default: true
+    }
+  ]).then(answers => {
+    if (answers.dump) {
+      const baseFolder = process.cwd();
+      const paths = getWordPressPaths( path.dirname(baseFolder), baseFolder );
+      const dump = new Dump(paths);
+      return dump.init();
+    }
+  }).then( (/** @type {import("../constants").DefaultWpConfig|undefined} */ result) => {
+    if (result.wordpress.name) {
+      return result;
+    }
+  });
+}
+
+module.exports = {
+  askForConfiguration,
+  askForDump
+};