@learnpack/learnpack 2.1.38 → 2.1.40

package/src/managers/config/index.ts

@@ -1,455 +1,455 @@
-import * as path from "path"
-import * as fs from "fs"
-import * as shell from "shelljs"
-import Console from "../../utils/console"
-import watch from "../../utils/watcher"
-import {
-  ValidationError,
-  NotFoundError,
-  InternalError,
-} from "../../utils/errors"
-
-import defaults from "./defaults"
-import { exercise } from "./exercise"
-
-import { rmSync } from "../file"
-import { IConfigObj, TConfigObjAttributes, TMode } from "../../models/config"
-import {
-  IConfigManagerAttributes,
-  IConfigManager,
-} from "../../models/config-manager"
-import { IFile } from "../../models/file"
-
-/* exercise folder name standard */
-
-// eslint-disable-next-line
-const fetch = require("node-fetch");
-// eslint-disable-next-line
-const chalk = require("chalk");
-
-/* exercise folder name standard */
-
-/**
- * Retrieves the configuration path for the learnpack package.
- *
- * @returns An object containing the configuration file path and the base directory.
- * @throws NotFoundError if the learn.json file is not found in the current folder.
- */
-const getConfigPath = () => {
-  const possibleFileNames = ["learn.json", ".learn/learn.json"]
-  const config = possibleFileNames.find(file => fs.existsSync(file)) || null
-  if (config && fs.existsSync(".breathecode"))
-    return { config, base: ".breathecode" }
-  if (config === null)
-    throw NotFoundError(
-      "learn.json file not found on current folder, is this a learnpack package?"
-    )
-  return { config, base: ".learn" }
-}
-
-const getExercisesPath = (base: string) => {
-  const possibleFileNames = ["./exercises", base + "/exercises", "./"]
-  return possibleFileNames.find(file => fs.existsSync(file)) || null
-}
-
-const getGitpodAddress = () => {
-  if (shell.exec("gp -h", { silent: true }).code === 0) {
-    return shell
-      .exec("gp url", { silent: true })
-      .stdout.replace(/(\r\n|\n|\r)/gm, "")
-  }
-
-  Console.debug("Gitpod command line tool not found")
-  return "http://localhost"
-}
-
-const getCodespacesNamespace = () => {
-  // Example: https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
-
-  const codespace_name = shell
-    .exec("echo $CODESPACE_NAME", { silent: true })
-    .stdout.replace(/(\r\n|\n|\r)/gm, "")
-
-  if (
-    !codespace_name ||
-    codespace_name === "" ||
-    codespace_name === undefined ||
-    // ! I added this line
-    codespace_name === "$CODESPACE_NAME"
-  ) {
-    return null
-  }
-
-  return codespace_name
-}
-
-export default async ({
-  grading,
-  mode,
-  disableGrading,
-  version,
-}: IConfigManagerAttributes): Promise<IConfigManager> => {
-  const confPath = getConfigPath()
-  Console.debug("This is the config path: ", confPath)
-
-  let configObj: IConfigObj = {}
-
-  if (confPath) {
-    const learnJsonContent = fs.readFileSync(confPath.config)
-    let hiddenBcContent = {}
-    if (fs.existsSync(confPath.base + "/config.json")) {
-      hiddenBcContent = fs.readFileSync(confPath.base + "/config.json")
-      hiddenBcContent = JSON.parse(hiddenBcContent as string)
-      if (!hiddenBcContent)
-        throw new Error(
-          `Invalid ${confPath.base}/config.json syntax: Unable to parse.`
-        )
-    }
-
-    const jsonConfig = JSON.parse(`${learnJsonContent}`)
-
-    if (!jsonConfig)
-      throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`)
-
-    let session: number
-
-    // add using id to the installation
-    if (!jsonConfig.session) {
-      session = Math.floor(Math.random() * 10_000_000_000_000_000_000)
-    } else {
-      session = jsonConfig.session
-      delete jsonConfig.session
-    }
-
-    configObj = deepMerge(hiddenBcContent, {
-      config: jsonConfig,
-      session: session,
-    })
-  } else {
-    throw ValidationError(
-      "No learn.json file has been found, make sure you are in the correct directory. To start a new LearnPack package run: $ learnpack init my-course-name"
-    )
-  }
-
-  configObj = deepMerge(defaults || {}, configObj, {
-    config: {
-      grading: grading || configObj.config?.grading,
-      configPath: confPath.config,
-    },
-  })
-  if (!configObj.config) 
-throw InternalError("Config object not found")
-
-  configObj.config.outputPath = confPath.base + "/dist"
-
-  Console.debug("This is your configuration object: ", {
-    ...configObj,
-    exercises: configObj.exercises ?
-      configObj.exercises.map(e => e.slug) :
-      [],
-  })
-
-  // auto detect agent (if possible)
-  const codespaces_workspace = getCodespacesNamespace()
-  Console.debug("This is the codespace namespace: ", codespaces_workspace)
-
-  Console.debug(
-    "This is the agent, and this should be null an the beginning: ",
-    configObj.config?.editor?.agent
-  )
-
-  if (shell.which("gp") && configObj && configObj.config) {
-    Console.debug("Gitpod detected")
-    configObj.address = getGitpodAddress()
-    configObj.config.publicUrl = `https://${
-      configObj.config.port
-    }-${configObj.address?.slice(8)}`
-  } else if (configObj.config && Boolean(codespaces_workspace)) {
-    Console.debug("Codespaces detected: ", codespaces_workspace)
-    configObj.address = `https://${codespaces_workspace}.github.dev`
-    configObj.config.publicUrl = `https://${codespaces_workspace}-${configObj.config.port}.app.github.dev`
-    // TODO: Why is needed to have an agent?
-  } else {
-    Console.debug("Neither Gitpod nor Codespaces detected, using localhost.")
-    configObj.address = `http://localhost:${configObj.config.port}`
-    configObj.config.publicUrl = `http://localhost:${configObj.config.port}`
-  }
-
-  if (!configObj.config.editor.agent) {
-    configObj.config.editor.agent = shell.which("code") ? "vscode" : "os"
-  }
-
-  // TODO: We need to set the correct EventListener if the agent is not vscode
-
-  if (configObj.config && !configObj.config.publicUrl)
-    configObj.config.publicUrl = `${configObj.address}:${configObj.config.port}`
-
-  if (configObj.config && !configObj.config.editor.mode && mode) {
-    configObj.config.editor.mode = mode as TMode
-  }
-
-  if (!configObj.config.editor.mode) {
-    configObj.config.editor.mode =
-      configObj.config.editor.agent === "vscode" ? "extension" : "preview"
-  }
-
-  if (version) 
-configObj.config.editor.version = version
-  else if (configObj.config.editor.version === null) {
-    Console.debug("Config version not found, downloading default.")
-    const resp = await fetch(
-      "https://raw.githubusercontent.com/learnpack/ide/master/package.json"
-    )
-    const packageJSON = await resp.json()
-    configObj.config.editor.version = packageJSON.version || "3.1.22"
-  }
-
-  configObj.config.dirPath = "./" + confPath.base
-  configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
-
-  return {
-    validLanguages: {},
-    get: () => configObj,
-    validateEngine: function (language: string, server: any, socket: any) {
-      // eslint-disable-next-line
-      const alias = (_l: string) => {
-        const map: any = {
-          python3: "python",
-        }
-        if (map[_l]) 
-return map[_l]
-        return _l
-      }
-
-      // decode aliases
-      language = alias(language)
-
-      if (this.validLanguages[language]) 
-return true
-
-      Console.debug(`Validating engine for ${language} compilation`)
-      let result = shell.exec("learnpack plugins", { silent: true })
-
-      if (
-        result.code === 0 &&
-        result.stdout.includes(`learnpack-${language}`)
-      ) {
-        this.validLanguages[language] = true
-        return true
-      }
-
-      Console.info(`Language engine for ${language} not found, installing...`)
-      // Install the compiler in their new versions
-      result = shell.exec(`learnpack plugins:install learnpack-${language}`, {
-        silent: true,
-      })
-      if (result.code === 0) {
-        socket.log(
-          "compiling",
-          "Installing the python compiler, you will have to reset the exercises after installation by writing on your terminal: $ learnpack run"
-        )
-        Console.info(
-          `Successfully installed the ${language} exercise engine, \n please start learnpack again by running the following command: \n ${chalk.white(
-            "$ learnpack start"
-          )}\n\n `
-        )
-        server.terminate()
-        return false
-      }
-
-      this.validLanguages[language] = false
-      socket.error(`Error installing ${language} exercise engine`)
-      Console.error(`Error installing ${language} exercise engine`)
-      Console.log(result.stdout)
-      throw InternalError(`Error installing ${language} exercise engine`)
-    },
-    clean: () => {
-      if (configObj.config) {
-        if (configObj.config.outputPath) {
-          rmSync(configObj.config.outputPath)
-        }
-
-        rmSync(configObj.config.dirPath + "/_app")
-        rmSync(configObj.config.dirPath + "/reports")
-        rmSync(configObj.config.dirPath + "/.session")
-        rmSync(configObj.config.dirPath + "/resets")
-
-        // clean tag gz
-        if (fs.existsSync(configObj.config.dirPath + "/app.tar.gz"))
-          fs.unlinkSync(configObj.config.dirPath + "/app.tar.gz")
-
-        if (fs.existsSync(configObj.config.dirPath + "/config.json"))
-          fs.unlinkSync(configObj.config.dirPath + "/config.json")
-
-        if (fs.existsSync(configObj.config.dirPath + "/telemetry.json"))
-          fs.unlinkSync(configObj.config.dirPath + "/telemetry.json")
-
-        if (fs.existsSync(configObj.config.dirPath + "/vscode_queue.json"))
-          fs.unlinkSync(configObj.config.dirPath + "/vscode_queue.json")
-      }
-    },
-    getExercise: slug => {
-      Console.debug("ExercisePath Slug", slug)
-      const exercise = (configObj.exercises || []).find(
-        ex => ex.slug === slug
-      )
-      if (!exercise) 
-throw ValidationError(`Exercise ${slug} not found`)
-
-      return exercise
-    },
-    getAllExercises: () => {
-      return configObj.exercises
-    },
-    startExercise: function (slug: string) {
-      const exercise = this.getExercise(slug)
-
-      // set config.json with current exercise
-      configObj.currentExercise = exercise.slug
-
-      this.save()
-
-      // eslint-disable-next-line
-      exercise.files.forEach((f: IFile) => {
-        if (configObj.config) {
-          const _path = configObj.config.outputPath + "/" + f.name
-          if (f.hidden === false && fs.existsSync(_path)) 
-fs.unlinkSync(_path)
-        }
-      })
-
-      return exercise
-    },
-    noCurrentExercise: function () {
-      configObj.currentExercise = null
-      this.save()
-    },
-    reset: slug => {
-      if (
-        configObj.config &&
-        !fs.existsSync(`${configObj.config.dirPath}/resets/` + slug)
-      )
-        throw ValidationError("Could not find the original files for " + slug)
-
-      const exercise = (configObj.exercises || []).find(
-        ex => ex.slug === slug
-      )
-      if (!exercise)
-        throw ValidationError(
-          `Exercise ${slug} not found on the configuration`
-        )
-
-      if (configObj.config) {
-        for (const fileName of fs.readdirSync(
-          `${configObj.config.dirPath}/resets/${slug}/`
-        )) {
-          const content = fs.readFileSync(
-            `${configObj.config?.dirPath}/resets/${slug}/${fileName}`
-          )
-          fs.writeFileSync(`${exercise.path}/${fileName}`, content)
-        }
-      }
-    },
-    buildIndex: function () {
-      Console.info("Building the exercise index...")
-
-      const isDirectory = (source: string) => {
-        const name = path.basename(source)
-        if (name === path.basename(configObj?.config?.dirPath || ""))
-          return false
-        // ignore folders that start with a dot
-        if (name.charAt(0) === "." || name.charAt(0) === "_") 
-return false
-
-        return fs.lstatSync(source).isDirectory()
-      }
-
-      const getDirectories = (source: string) =>
-        fs
-          .readdirSync(source)
-          .map(name => path.join(source, name))
-          .filter(isDirectory)
-      // add the .learn folder
-      if (!fs.existsSync(confPath.base)) 
-fs.mkdirSync(confPath.base)
-      // add the outout folder where webpack will publish the the html/css/js files
-      if (
-        configObj.config &&
-        configObj.config.outputPath &&
-        !fs.existsSync(configObj.config.outputPath)
-      )
-        fs.mkdirSync(configObj.config.outputPath)
-
-      // TODO: we could use npm library front-mater to read the title of the exercises from the README.md
-      const grupedByDirectory = getDirectories(
-        configObj?.config?.exercisesPath || ""
-      )
-      configObj.exercises =
-        grupedByDirectory.length > 0 ?
-          grupedByDirectory.map((path, position) =>
-              exercise(path, position, configObj)
-            ) :
-          [exercise(configObj?.config?.exercisesPath || "", 0, configObj)]
-      this.save()
-    },
-    watchIndex: function (onChange: (filename: string) => void) {
-      if (configObj.config && !configObj.config.exercisesPath)
-        throw ValidationError(
-          "No exercises directory to watch: " + configObj.config.exercisesPath
-        )
-
-      this.buildIndex()
-
-      watch(configObj?.config?.exercisesPath || "", onChange)
-        .then(() => {
-          Console.debug("Changes detected on your exercises")
-          this.buildIndex()
-          // if (onChange) onChange(filename);
-        })
-        .catch(error => {
-          throw error
-        })
-    },
-
-    save: () => {
-      // Console.debug("Saving configuration with: ", configObj)
-
-      // remove the duplicates form the actions array
-      // configObj.config.actions = [...new Set(configObj.config.actions)];
-      if (configObj.config) {
-        configObj.config.translations = [
-          ...new Set(configObj.config.translations),
-        ]
-        fs.writeFileSync(
-          configObj.config.dirPath + "/config.json",
-          JSON.stringify(configObj, null, 4)
-        )
-      }
-    },
-  } as IConfigManager
-}
-
-function deepMerge(...sources: any): any {
-  let acc: any = {}
-  for (const source of sources) {
-    if (Array.isArray(source)) {
-      if (!Array.isArray(acc)) {
-        acc = []
-      }
-
-      acc = [...source]
-    } else if (source instanceof Object) {
-      // eslint-disable-next-line
-      for (let [key, value] of Object.entries(source)) {
-        if (value instanceof Object && key in acc) {
-          value = deepMerge(acc[key], value)
-        }
-
-        if (value !== undefined) 
-acc = { ...acc, [key]: value }
-      }
-    }
-  }
-
-  return acc
-}
+import * as path from "path"
+import * as fs from "fs"
+import * as shell from "shelljs"
+import Console from "../../utils/console"
+import watch from "../../utils/watcher"
+import {
+  ValidationError,
+  NotFoundError,
+  InternalError,
+} from "../../utils/errors"
+
+import defaults from "./defaults"
+import { exercise } from "./exercise"
+
+import { rmSync } from "../file"
+import { IConfigObj, TConfigObjAttributes, TMode } from "../../models/config"
+import {
+  IConfigManagerAttributes,
+  IConfigManager,
+} from "../../models/config-manager"
+import { IFile } from "../../models/file"
+
+/* exercise folder name standard */
+
+// eslint-disable-next-line
+const fetch = require("node-fetch");
+// eslint-disable-next-line
+const chalk = require("chalk");
+
+/* exercise folder name standard */
+
+/**
+ * Retrieves the configuration path for the learnpack package.
+ *
+ * @returns An object containing the configuration file path and the base directory.
+ * @throws NotFoundError if the learn.json file is not found in the current folder.
+ */
+const getConfigPath = () => {
+  const possibleFileNames = ["learn.json", ".learn/learn.json"]
+  const config = possibleFileNames.find(file => fs.existsSync(file)) || null
+  if (config && fs.existsSync(".breathecode"))
+    return { config, base: ".breathecode" }
+  if (config === null)
+    throw NotFoundError(
+      "learn.json file not found on current folder, is this a learnpack package?"
+    )
+  return { config, base: ".learn" }
+}
+
+const getExercisesPath = (base: string) => {
+  const possibleFileNames = ["./exercises", base + "/exercises", "./"]
+  return possibleFileNames.find(file => fs.existsSync(file)) || null
+}
+
+const getGitpodAddress = () => {
+  if (shell.exec("gp -h", { silent: true }).code === 0) {
+    return shell
+      .exec("gp url", { silent: true })
+      .stdout.replace(/(\r\n|\n|\r)/gm, "")
+  }
+
+  Console.debug("Gitpod command line tool not found")
+  return "http://localhost"
+}
+
+const getCodespacesNamespace = () => {
+  // Example: https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
+
+  const codespace_name = shell
+    .exec("echo $CODESPACE_NAME", { silent: true })
+    .stdout.replace(/(\r\n|\n|\r)/gm, "")
+
+  if (
+    !codespace_name ||
+    codespace_name === "" ||
+    codespace_name === undefined ||
+    // ! I added this line
+    codespace_name === "$CODESPACE_NAME"
+  ) {
+    return null
+  }
+
+  return codespace_name
+}
+
+export default async ({
+  grading,
+  mode,
+  disableGrading,
+  version,
+}: IConfigManagerAttributes): Promise<IConfigManager> => {
+  const confPath = getConfigPath()
+  Console.debug("This is the config path: ", confPath)
+
+  let configObj: IConfigObj = {}
+
+  if (confPath) {
+    const learnJsonContent = fs.readFileSync(confPath.config)
+    let hiddenBcContent = {}
+    if (fs.existsSync(confPath.base + "/config.json")) {
+      hiddenBcContent = fs.readFileSync(confPath.base + "/config.json")
+      hiddenBcContent = JSON.parse(hiddenBcContent as string)
+      if (!hiddenBcContent)
+        throw new Error(
+          `Invalid ${confPath.base}/config.json syntax: Unable to parse.`
+        )
+    }
+
+    const jsonConfig = JSON.parse(`${learnJsonContent}`)
+
+    if (!jsonConfig)
+      throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`)
+
+    let session: number
+
+    // add using id to the installation
+    if (!jsonConfig.session) {
+      session = Math.floor(Math.random() * 10_000_000_000_000_000_000)
+    } else {
+      session = jsonConfig.session
+      delete jsonConfig.session
+    }
+
+    configObj = deepMerge(hiddenBcContent, {
+      config: jsonConfig,
+      session: session,
+    })
+  } else {
+    throw ValidationError(
+      "No learn.json file has been found, make sure you are in the correct directory. To start a new LearnPack package run: $ learnpack init my-course-name"
+    )
+  }
+
+  configObj = deepMerge(defaults || {}, configObj, {
+    config: {
+      grading: grading || configObj.config?.grading,
+      configPath: confPath.config,
+    },
+  })
+  if (!configObj.config) 
+throw InternalError("Config object not found")
+
+  configObj.config.outputPath = confPath.base + "/dist"
+
+  Console.debug("This is your configuration object: ", {
+    ...configObj,
+    exercises: configObj.exercises ?
+      configObj.exercises.map(e => e.slug) :
+      [],
+  })
+
+  // auto detect agent (if possible)
+  const codespaces_workspace = getCodespacesNamespace()
+  Console.debug("This is the codespace namespace: ", codespaces_workspace)
+
+  Console.debug(
+    "This is the agent, and this should be null an the beginning: ",
+    configObj.config?.editor?.agent
+  )
+
+  if (shell.which("gp") && configObj && configObj.config) {
+    Console.debug("Gitpod detected")
+    configObj.address = getGitpodAddress()
+    configObj.config.publicUrl = `https://${
+      configObj.config.port
+    }-${configObj.address?.slice(8)}`
+    configObj.config.editor.agent = "vscode"
+  } else if (configObj.config && Boolean(codespaces_workspace)) {
+    Console.debug("Codespaces detected: ", codespaces_workspace)
+    configObj.address = `https://${codespaces_workspace}.github.dev`
+    configObj.config.publicUrl = `https://${codespaces_workspace}-${configObj.config.port}.app.github.dev`
+    configObj.config.editor.agent = "vscode"
+  } else {
+    Console.debug("Neither Gitpod nor Codespaces detected, using localhost.")
+    configObj.address = `http://localhost:${configObj.config.port}`
+    configObj.config.publicUrl = `http://localhost:${configObj.config.port}`
+  }
+
+  if (!configObj.config.editor.agent) {
+    configObj.config.editor.agent =
+      process.env.TERM_PROGRAM === "vscode" ? "vscode" : "os"
+  }
+
+  if (configObj.config && !configObj.config.publicUrl)
+    configObj.config.publicUrl = `${configObj.address}:${configObj.config.port}`
+
+  if (configObj.config && !configObj.config.editor.mode && mode) {
+    configObj.config.editor.mode = mode as TMode
+  }
+
+  if (!configObj.config.editor.mode) {
+    configObj.config.editor.mode =
+      configObj.config.editor.agent === "vscode" ? "extension" : "preview"
+  }
+
+  if (version) 
+configObj.config.editor.version = version
+  else if (configObj.config.editor.version === null) {
+    Console.debug("Config version not found, downloading default.")
+    const resp = await fetch(
+      "https://raw.githubusercontent.com/learnpack/ide/master/package.json"
+    )
+    const packageJSON = await resp.json()
+    configObj.config.editor.version = packageJSON.version || "3.1.22"
+  }
+
+  configObj.config.dirPath = "./" + confPath.base
+  configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
+
+  return {
+    validLanguages: {},
+    get: () => configObj,
+    validateEngine: function (language: string, server: any, socket: any) {
+      // eslint-disable-next-line
+      const alias = (_l: string) => {
+        const map: any = {
+          python3: "python",
+        }
+        if (map[_l]) 
+return map[_l]
+        return _l
+      }
+
+      // decode aliases
+      language = alias(language)
+
+      if (this.validLanguages[language]) 
+return true
+
+      Console.debug(`Validating engine for ${language} compilation`)
+      let result = shell.exec("learnpack plugins", { silent: true })
+
+      if (
+        result.code === 0 &&
+        result.stdout.includes(`learnpack-${language}`)
+      ) {
+        this.validLanguages[language] = true
+        return true
+      }
+
+      Console.info(`Language engine for ${language} not found, installing...`)
+      // Install the compiler in their new versions
+      result = shell.exec(`learnpack plugins:install learnpack-${language}`, {
+        silent: true,
+      })
+      if (result.code === 0) {
+        socket.log(
+          "compiling",
+          "Installing the python compiler, you will have to reset the exercises after installation by writing on your terminal: $ learnpack run"
+        )
+        Console.info(
+          `Successfully installed the ${language} exercise engine, \n please start learnpack again by running the following command: \n ${chalk.white(
+            "$ learnpack start"
+          )}\n\n `
+        )
+        server.terminate()
+        return false
+      }
+
+      this.validLanguages[language] = false
+      socket.error(`Error installing ${language} exercise engine`)
+      Console.error(`Error installing ${language} exercise engine`)
+      Console.log(result.stdout)
+      throw InternalError(`Error installing ${language} exercise engine`)
+    },
+    clean: () => {
+      if (configObj.config) {
+        if (configObj.config.outputPath) {
+          rmSync(configObj.config.outputPath)
+        }
+
+        rmSync(configObj.config.dirPath + "/_app")
+        rmSync(configObj.config.dirPath + "/reports")
+        rmSync(configObj.config.dirPath + "/.session")
+        rmSync(configObj.config.dirPath + "/resets")
+
+        // clean tag gz
+        if (fs.existsSync(configObj.config.dirPath + "/app.tar.gz"))
+          fs.unlinkSync(configObj.config.dirPath + "/app.tar.gz")
+
+        if (fs.existsSync(configObj.config.dirPath + "/config.json"))
+          fs.unlinkSync(configObj.config.dirPath + "/config.json")
+
+        if (fs.existsSync(configObj.config.dirPath + "/telemetry.json"))
+          fs.unlinkSync(configObj.config.dirPath + "/telemetry.json")
+
+        if (fs.existsSync(configObj.config.dirPath + "/vscode_queue.json"))
+          fs.unlinkSync(configObj.config.dirPath + "/vscode_queue.json")
+      }
+    },
+    getExercise: slug => {
+      Console.debug("ExercisePath Slug", slug)
+      const exercise = (configObj.exercises || []).find(
+        ex => ex.slug === slug
+      )
+      if (!exercise) 
+throw ValidationError(`Exercise ${slug} not found`)
+
+      return exercise
+    },
+    getAllExercises: () => {
+      return configObj.exercises
+    },
+    startExercise: function (slug: string) {
+      const exercise = this.getExercise(slug)
+
+      // set config.json with current exercise
+      configObj.currentExercise = exercise.slug
+
+      this.save()
+
+      // eslint-disable-next-line
+      exercise.files.forEach((f: IFile) => {
+        if (configObj.config) {
+          const _path = configObj.config.outputPath + "/" + f.name
+          if (f.hidden === false && fs.existsSync(_path)) 
+fs.unlinkSync(_path)
+        }
+      })
+
+      return exercise
+    },
+    noCurrentExercise: function () {
+      configObj.currentExercise = null
+      this.save()
+    },
+    reset: slug => {
+      if (
+        configObj.config &&
+        !fs.existsSync(`${configObj.config.dirPath}/resets/` + slug)
+      )
+        throw ValidationError("Could not find the original files for " + slug)
+
+      const exercise = (configObj.exercises || []).find(
+        ex => ex.slug === slug
+      )
+      if (!exercise)
+        throw ValidationError(
+          `Exercise ${slug} not found on the configuration`
+        )
+
+      if (configObj.config) {
+        for (const fileName of fs.readdirSync(
+          `${configObj.config.dirPath}/resets/${slug}/`
+        )) {
+          const content = fs.readFileSync(
+            `${configObj.config?.dirPath}/resets/${slug}/${fileName}`
+          )
+          fs.writeFileSync(`${exercise.path}/${fileName}`, content)
+        }
+      }
+    },
+    buildIndex: function () {
+      Console.info("Building the exercise index...")
+
+      const isDirectory = (source: string) => {
+        const name = path.basename(source)
+        if (name === path.basename(configObj?.config?.dirPath || ""))
+          return false
+        // ignore folders that start with a dot
+        if (name.charAt(0) === "." || name.charAt(0) === "_") 
+return false
+
+        return fs.lstatSync(source).isDirectory()
+      }
+
+      const getDirectories = (source: string) =>
+        fs
+          .readdirSync(source)
+          .map(name => path.join(source, name))
+          .filter(isDirectory)
+      // add the .learn folder
+      if (!fs.existsSync(confPath.base)) 
+fs.mkdirSync(confPath.base)
+      // add the outout folder where webpack will publish the the html/css/js files
+      if (
+        configObj.config &&
+        configObj.config.outputPath &&
+        !fs.existsSync(configObj.config.outputPath)
+      )
+        fs.mkdirSync(configObj.config.outputPath)
+
+      // TODO: we could use npm library front-mater to read the title of the exercises from the README.md
+      const grupedByDirectory = getDirectories(
+        configObj?.config?.exercisesPath || ""
+      )
+      configObj.exercises =
+        grupedByDirectory.length > 0 ?
+          grupedByDirectory.map((path, position) =>
+              exercise(path, position, configObj)
+            ) :
+          [exercise(configObj?.config?.exercisesPath || "", 0, configObj)]
+      this.save()
+    },
+    watchIndex: function (onChange: (filename: string) => void) {
+      if (configObj.config && !configObj.config.exercisesPath)
+        throw ValidationError(
+          "No exercises directory to watch: " + configObj.config.exercisesPath
+        )
+
+      this.buildIndex()
+
+      watch(configObj?.config?.exercisesPath || "", onChange)
+        .then(() => {
+          Console.debug("Changes detected on your exercises")
+          this.buildIndex()
+          // if (onChange) onChange(filename);
+        })
+        .catch(error => {
+          throw error
+        })
+    },
+
+    save: () => {
+      // Console.debug("Saving configuration with: ", configObj)
+
+      // remove the duplicates form the actions array
+      // configObj.config.actions = [...new Set(configObj.config.actions)];
+      if (configObj.config) {
+        configObj.config.translations = [
+          ...new Set(configObj.config.translations),
+        ]
+        fs.writeFileSync(
+          configObj.config.dirPath + "/config.json",
+          JSON.stringify(configObj, null, 4)
+        )
+      }
+    },
+  } as IConfigManager
+}
+
+function deepMerge(...sources: any): any {
+  let acc: any = {}
+  for (const source of sources) {
+    if (Array.isArray(source)) {
+      if (!Array.isArray(acc)) {
+        acc = []
+      }
+
+      acc = [...source]
+    } else if (source instanceof Object) {
+      // eslint-disable-next-line
+      for (let [key, value] of Object.entries(source)) {
+        if (value instanceof Object && key in acc) {
+          value = deepMerge(acc[key], value)
+        }
+
+        if (value !== undefined) 
+acc = { ...acc, [key]: value }
+      }
+    }
+  }
+
+  return acc
+}