@learnpack/learnpack 2.1.56 → 4.0.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @learnpack/learnpack
 $ learnpack COMMAND
 running command...
 $ learnpack (-v|--version|version)
-@learnpack/learnpack/2.1.56 win32-x64 node-v20.10.0
+@learnpack/learnpack/4.0.0 win32-x64 node-v20.10.0
 $ learnpack --help [COMMAND]
 USAGE
   $ learnpack COMMAND
@@ -74,7 +74,7 @@ DESCRIPTION
        12. If there is a file within the exercises folder but not inside of any particular exercise's folder. (Warning)
 ```
 
-_See code: [src\commands\audit.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\audit.ts)_
+_See code: [src\commands\audit.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\audit.ts)_
 
 ## `learnpack clean`
 
@@ -89,7 +89,7 @@ DESCRIPTION
      Extra documentation goes here
 ```
 
-_See code: [src\commands\clean.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\clean.ts)_
+_See code: [src\commands\clean.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\clean.ts)_
 
 ## `learnpack download [PACKAGE]`
 
@@ -107,7 +107,7 @@ DESCRIPTION
   Extra documentation goes here
 ```
 
-_See code: [src\commands\download.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\download.ts)_
+_See code: [src\commands\download.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\download.ts)_
 
 ## `learnpack help [COMMAND]`
 
@@ -138,7 +138,7 @@ OPTIONS
   -h, --grading  show CLI help
 ```
 
-_See code: [src\commands\init.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\init.ts)_
+_See code: [src\commands\init.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\init.ts)_
 
 ## `learnpack login [PACKAGE]`
 
@@ -156,7 +156,7 @@ DESCRIPTION
      Extra documentation goes here
 ```
 
-_See code: [src\commands\login.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\login.ts)_
+_See code: [src\commands\login.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\login.ts)_
 
 ## `learnpack logout [PACKAGE]`
 
@@ -174,7 +174,7 @@ DESCRIPTION
      Extra documentation goes here
 ```
 
-_See code: [src\commands\logout.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\logout.ts)_
+_See code: [src\commands\logout.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\logout.ts)_
 
 ## `learnpack plugins`
 
@@ -309,7 +309,7 @@ DESCRIPTION
      Extra documentation goes here
 ```
 
-_See code: [src\commands\publish.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\publish.ts)_
+_See code: [src\commands\publish.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\publish.ts)_
 
 ## `learnpack start`
 
@@ -330,7 +330,7 @@ OPTIONS
   -w, --watch                         Watch for file changes
 ```
 
-_See code: [src\commands\start.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\start.ts)_
+_See code: [src\commands\start.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\start.ts)_
 
 ## `learnpack test [EXERCISESLUG]`
 
@@ -344,7 +344,7 @@ ARGUMENTS
   EXERCISESLUG  The name of the exercise to test
 ```
 
-_See code: [src\commands\test.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.56/src\commands\test.ts)_
+_See code: [src\commands\test.ts](https://github.com/learnpack/learnpack-cli/blob/v4.0.0/src\commands\test.ts)_
 <!-- commandsstop -->
 
 > > > > > > > 0cb3e56d84c197f9d008836bb573eade212b7e57

package/lib/managers/config/defaults.d.ts

@@ -37,5 +37,6 @@ declare const _default: {
     exercises: never[];
     bugsLink: null;
     videoSolutions: boolean;
+    localhostOnly: boolean;
 };
 export default _default;

package/lib/managers/config/defaults.js

@@ -41,4 +41,5 @@ exports.default = {
     exercises: [],
     bugsLink: null,
     videoSolutions: false,
+    localhostOnly: false,
 };

package/lib/managers/config/index.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const path = require("path");
 const fs = require("fs");
 const shell = require("shelljs");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = util_1.promisify(child_process_1.exec);
 const console_1 = require("../../utils/console");
 const watcher_1 = require("../../utils/watcher");
 const errors_1 = require("../../utils/errors");
@@ -142,10 +145,47 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
         console_1.default.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.23";
+        configObj.config.editor.version = packageJSON.version || "4.0.0";
     }
     configObj.config.dirPath = "./" + confPath.base;
     configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./";
+    if (configObj.config.variables) {
+        const allowedCommands = new Set(["ls", "pwd", "echo", "node", "python"]);
+        const variableKeys = Object.keys(configObj.config.variables);
+        const promises = [];
+        for (const v of variableKeys) {
+            if (Object.prototype.hasOwnProperty.call(configObj.config.variables, v)) {
+                const variable = configObj.config.variables[v];
+                if (typeof variable === "string") {
+                    continue;
+                }
+                const type = variable.type;
+                if (type === "command") {
+                    const promise = (async () => {
+                        try {
+                            // Validate the command
+                            if (!allowedCommands.has(variable.source.split(" ")[0])) {
+                                throw new Error("Command not allowed");
+                            }
+                            // Execute the code and replace the value
+                            const { stdout } = await execAsync(variable.source);
+                            if (!configObj.config || !configObj.config.variables)
+                                return;
+                            configObj.config.variables[v] = stdout.trim();
+                        }
+                        catch (error) {
+                            console.error(`Error executing code: ${error}`);
+                        }
+                    })();
+                    promises.push(promise);
+                }
+                else if (type === "string") {
+                    configObj.config.variables[v] = variable.source;
+                }
+            }
+        }
+        await Promise.all(promises);
+    }
     return {
         validLanguages: {},
         get: () => configObj,

package/lib/managers/file.js

@@ -28,22 +28,32 @@ exports.decompress = (sourcePath, destinationPath) => new Promise((resolve, reje
     });
 });
 exports.downloadEditor = async (version, destination) => {
-    // https://raw.githubusercontent.com/learnpack/coding-ide/master/dist/app.tar.gz
-    // if(versions[version] === undefined) throw new Error(`Invalid editor version ${version}`)
     if (!version) {
         const res = await fetch("https://raw.githubusercontent.com/learnpack/ide/master/package.json");
         const json = await res.json();
-        version = json.version;
+        version = json.version || "4.0.0";
         if (!version)
             throw errors_1.InternalError(`Coding Editor version was not found on learnpack repository, check the config.editor.version property on learn.json`);
     }
-    const versionNumber = parseInt(version.split(".")[0]);
-    let url = `https://github.com/learnpack/coding-ide/blob/${version}/dist`;
+    const [major, minor] = version.split(".");
+    const versionPrefix = `${major}.${minor}`;
+    const tagsRes = await fetch("https://api.github.com/repos/learnpack/ide/contents/bin");
+    const tags = await tagsRes.json();
+    const matchingTags = tags
+        .filter((tag) => tag.name.includes(versionPrefix))
+        .sort((a, b) => b.name.localeCompare(a.name, undefined, { numeric: true }));
+    if (matchingTags.length === 0)
+        throw errors_1.InternalError(`No matching version found for prefix ${versionPrefix} in the learnpack repository`);
+    const latestVersion = matchingTags[0].name
+        .replace("learnpack-", "")
+        .replace(".tar.gz", "");
+    const versionNumber = parseInt(latestVersion.split(".")[0]);
+    let url = `https://github.com/learnpack/coding-ide/blob/${latestVersion}/dist`;
     if (versionNumber > 2)
-        url = `https://github.com/learnpack/ide/blob/master/bin/learnpack-${version}.tar.gz`;
+        url = `https://github.com/learnpack/ide/blob/master/bin/learnpack-${latestVersion}.tar.gz`;
     const resp2 = await fetch(url, { method: "HEAD" });
     if (!resp2.ok)
-        throw errors_1.InternalError(`Coding Editor ${version} was not found on learnpack repository, check the config.editor.version property on learn.json`);
+        throw errors_1.InternalError(`Coding Editor ${latestVersion} was not found on learnpack repository, check the config.editor.version property on learn.json`);
     console_1.default.info("Downloading the LearnPack coding UI, this may take a minute...");
     url += versionNumber > 2 ? `?raw=true` : `/app.tar.gz?raw=true`;
     return exports.download(url, destination);

package/lib/models/config.d.ts

@@ -55,9 +55,17 @@ export interface IConfig {
     videoSolutions?: boolean;
     skills: Array<string>;
     telemetry?: TTelemetryUrls;
+    variables?: TVariables;
     runHook: (...agrs: Array<any>) => void;
     testingFinishedCallback: (arg: any | undefined) => void;
 }
+declare type TVariable = {
+    type: "command" | "string";
+    source: string;
+};
+declare type TVariables = {
+    [key: string]: TVariable | string;
+};
 export interface IConfigObj {
     session?: number;
     currentExercise?: any;

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.1.56","commands":{"audit":{"id":"audit","description":"learnpack audit is the command in charge of creating an auditory of the repository\n...\nlearnpack audit checks for the following information in a repository:\n    1. The configuration object has slug, repository and description. (Error)\n    2. The command learnpack clean has been run. (Error)\n    3. If a markdown or test file doesn't have any content. (Error)\n    4. The links are accessing to valid servers. (Error)\n    5. The relative images are working (If they have the shortest path to the image or if the images exists in the assets). (Error)\n    6. The external images are working (If they are pointing to a valid server). (Error)\n    7. The exercises directory names are valid. (Error)\n    8. If an exercise doesn't have a README file. (Error)\n    9. The exercises array (Of the config file) has content. (Error)\n    10. The exercses have the same translations. (Warning)\n    11. The .gitignore file exists. (Warning)\n    12. If there is a file within the exercises folder but not inside of any particular exercise's folder. (Warning)\n","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[]},"clean":{"id":"clean","description":"Clean the configuration object\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[]},"download":{"id":"download","description":"Describe the command here\n...\nExtra documentation goes here\n","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"init":{"id":"init","description":"Create a new learning package: Book, Tutorial or Exercise","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"grading":{"name":"grading","type":"boolean","char":"h","description":"show CLI help","allowNo":false}},"args":[]},"login":{"id":"login","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"logout":{"id":"logout","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"publish":{"id":"publish","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"start":{"id":"start","description":"Runs a small server with all the exercise instructions","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"port":{"name":"port","type":"option","char":"p","description":"server port"},"host":{"name":"host","type":"option","char":"h","description":"server host"},"disableGrading":{"name":"disableGrading","type":"boolean","char":"D","description":"disble grading functionality","allowNo":false},"watch":{"name":"watch","type":"boolean","char":"w","description":"Watch for file changes","allowNo":false},"editor":{"name":"editor","type":"option","char":"e","description":"[preview, extension]","options":["extension","preview"]},"version":{"name":"version","type":"option","char":"v","description":"E.g: 1.0.1"},"grading":{"name":"grading","type":"option","char":"g","description":"[isolated, incremental]","options":["isolated","incremental"]},"debug":{"name":"debug","type":"boolean","char":"d","description":"debugger mode for more verbage","allowNo":false}},"args":[]},"test":{"id":"test","description":"Test exercises","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"exerciseSlug","description":"The name of the exercise to test","required":false,"hidden":false}]}}}
+{"version":"4.0.0","commands":{"audit":{"id":"audit","description":"learnpack audit is the command in charge of creating an auditory of the repository\n...\nlearnpack audit checks for the following information in a repository:\n    1. The configuration object has slug, repository and description. (Error)\n    2. The command learnpack clean has been run. (Error)\n    3. If a markdown or test file doesn't have any content. (Error)\n    4. The links are accessing to valid servers. (Error)\n    5. The relative images are working (If they have the shortest path to the image or if the images exists in the assets). (Error)\n    6. The external images are working (If they are pointing to a valid server). (Error)\n    7. The exercises directory names are valid. (Error)\n    8. If an exercise doesn't have a README file. (Error)\n    9. The exercises array (Of the config file) has content. (Error)\n    10. The exercses have the same translations. (Warning)\n    11. The .gitignore file exists. (Warning)\n    12. If there is a file within the exercises folder but not inside of any particular exercise's folder. (Warning)\n","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[]},"clean":{"id":"clean","description":"Clean the configuration object\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[]},"download":{"id":"download","description":"Describe the command here\n...\nExtra documentation goes here\n","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"init":{"id":"init","description":"Create a new learning package: Book, Tutorial or Exercise","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"grading":{"name":"grading","type":"boolean","char":"h","description":"show CLI help","allowNo":false}},"args":[]},"login":{"id":"login","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"logout":{"id":"logout","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"publish":{"id":"publish","description":"Describe the command here\n  ...\n  Extra documentation goes here\n  ","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"package","description":"The unique string that identifies this package on learnpack","required":false,"hidden":false}]},"start":{"id":"start","description":"Runs a small server with all the exercise instructions","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"port":{"name":"port","type":"option","char":"p","description":"server port"},"host":{"name":"host","type":"option","char":"h","description":"server host"},"disableGrading":{"name":"disableGrading","type":"boolean","char":"D","description":"disble grading functionality","allowNo":false},"watch":{"name":"watch","type":"boolean","char":"w","description":"Watch for file changes","allowNo":false},"editor":{"name":"editor","type":"option","char":"e","description":"[preview, extension]","options":["extension","preview"]},"version":{"name":"version","type":"option","char":"v","description":"E.g: 1.0.1"},"grading":{"name":"grading","type":"option","char":"g","description":"[isolated, incremental]","options":["isolated","incremental"]},"debug":{"name":"debug","type":"boolean","char":"d","description":"debugger mode for more verbage","allowNo":false}},"args":[]},"test":{"id":"test","description":"Test exercises","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"exerciseSlug","description":"The name of the exercise to test","required":false,"hidden":false}]}}}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@learnpack/learnpack",
   "description": "Create, sell or download and take learning amazing learning packages",
-  "version": "2.1.56",
+  "version": "4.0.0",
   "author": "Alejandro Sanchez @alesanchezr",
   "contributors": [
     {

package/src/managers/config/defaults.ts

@@ -39,4 +39,5 @@ export default {
   exercises: [],
   bugsLink: null,
   videoSolutions: false,
+  localhostOnly: false, // if true, the exercise should not run on gitpod or codespaces but show an error message encouraging the user to run locally
 }

package/src/managers/config/index.ts

@@ -1,6 +1,11 @@
 import * as path from "path"
 import * as fs from "fs"
 import * as shell from "shelljs"
+import { exec } from "child_process"
+import { promisify } from "util"
+
+const execAsync = promisify(exec)
+
 import Console from "../../utils/console"
 import watch from "../../utils/watcher"
 import {
@@ -23,9 +28,9 @@ import { IFile } from "../../models/file"
 /* exercise folder name standard */
 
 // eslint-disable-next-line
-const fetch = require("node-fetch");
+const fetch = require("node-fetch")
 // eslint-disable-next-line
-const chalk = require("chalk");
+const chalk = require("chalk")
 
 /* exercise folder name standard */
 
@@ -201,12 +206,56 @@ configObj.config.editor.version = version
       "https://raw.githubusercontent.com/learnpack/ide/master/package.json"
     )
     const packageJSON = await resp.json()
-    configObj.config.editor.version = packageJSON.version || "3.1.23"
+    configObj.config.editor.version = packageJSON.version || "4.0.0"
   }
 
   configObj.config.dirPath = "./" + confPath.base
   configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
 
+  if (configObj.config.variables) {
+    const allowedCommands = new Set(["ls", "pwd", "echo", "node", "python"])
+
+    const variableKeys = Object.keys(configObj.config.variables)
+    const promises = []
+
+    for (const v of variableKeys) {
+      if (Object.prototype.hasOwnProperty.call(configObj.config.variables, v)) {
+        const variable = configObj.config.variables[v]
+
+        if (typeof variable === "string") {
+          continue
+        }
+
+        const type = variable.type
+
+        if (type === "command") {
+          const promise = (async () => {
+            try {
+              // Validate the command
+              if (!allowedCommands.has(variable.source.split(" ")[0])) {
+                throw new Error("Command not allowed")
+              }
+
+              // Execute the code and replace the value
+              const { stdout } = await execAsync(variable.source)
+              if (!configObj.config || !configObj.config.variables) 
+return
+
+              configObj.config.variables[v] = stdout.trim()
+            } catch (error) {
+              console.error(`Error executing code: ${error}`)
+            }
+          })()
+          promises.push(promise)
+        } else if (type === "string") {
+          configObj.config.variables[v] = variable.source
+        }
+      }
+    }
+
+    await Promise.all(promises)
+  }
+
   return {
     validLanguages: {},
     get: () => configObj,
@@ -335,9 +384,7 @@ fs.unlinkSync(_path)
         ex => ex.slug === slug
       )
       if (!exercise)
-        throw ValidationError(
-          `Exercise ${slug} not found on the configuration`
-        )
+        throw ValidationError(`Exercise ${slug} not found on the configuration`)
 
       if (configObj.config) {
         for (const fileName of fs.readdirSync(

package/src/managers/file.ts

@@ -1,196 +1,212 @@
-import * as fs from "fs"
-import * as p from "path"
-import * as shell from "shelljs"
-import { cli } from "cli-ux"
-import * as targz from "targz"
-import Console from "../utils/console"
-import * as https from "https"
-import { InternalError } from "../utils/errors"
-
-// eslint-disable-next-line
-const fetch = require("node-fetch");
-
-export const decompress = (sourcePath: string, destinationPath: string) =>
-  new Promise((resolve, reject) => {
-    Console.debug("Decompressing " + sourcePath)
-    targz.decompress(
-      {
-        src: sourcePath,
-        dest: destinationPath,
-      },
-      function (err: string | Error | null) {
-        if (err) {
-          Console.error("Error when trying to decompress")
-          reject(err)
-        } else {
-          Console.info("Decompression finished successfully")
-          resolve(/* */ "")
-        }
-      }
-    )
-  })
-
-export const downloadEditor = async (
-  version: string | undefined,
-  destination: string
-) => {
-  // https://raw.githubusercontent.com/learnpack/coding-ide/master/dist/app.tar.gz
-  // if(versions[version] === undefined) throw new Error(`Invalid editor version ${version}`)
-
-  if (!version) {
-    const res = await fetch(
-      "https://raw.githubusercontent.com/learnpack/ide/master/package.json"
-    )
-    const json = await res.json()
-    version = json.version
-
-    if (!version)
-      throw InternalError(
-        `Coding Editor version was not found on learnpack repository, check the config.editor.version property on learn.json`
-      )
-  }
-
-  const versionNumber = parseInt(version.split(".")[0])
-
-  let url = `https://github.com/learnpack/coding-ide/blob/${version}/dist`
-
-  if (versionNumber > 2)
-    url = `https://github.com/learnpack/ide/blob/master/bin/learnpack-${version}.tar.gz`
-
-  const resp2 = await fetch(url, { method: "HEAD" })
-  if (!resp2.ok)
-    throw InternalError(
-      `Coding Editor ${version} was not found on learnpack repository, check the config.editor.version property on learn.json`
-    )
-
-  Console.info(
-    "Downloading the LearnPack coding UI, this may take a minute..."
-  )
-
-  url += versionNumber > 2 ? `?raw=true` : `/app.tar.gz?raw=true`
-
-  return download(url, destination)
-}
-
-export const download = (url: string, dest: string) => {
-  Console.debug("Downloading " + url)
-  return new Promise((resolve, reject) => {
-    const request = https.get(url, response => {
-      if (response.statusCode === 200) {
-        const file = fs.createWriteStream(dest, { flags: "wx" })
-        file.on("finish", () => {
-          resolve(true)
-        })
-        file.on("error", err => {
-          file.close()
-          if (err.code === "EEXIST") {
-            Console.debug("File already exists")
-            resolve("File already exists")
-          } else {
-            Console.debug("Error ", err.message)
-            fs.unlink(dest, () => reject(err.message)) // Delete temp file
-          }
-        })
-        response.pipe(file)
-      } else if (response.statusCode === 302 || response.statusCode === 301) {
-        // Console.debug("Servers redirected to "+response.headers.location)
-        // Recursively follow redirects, only a 200 will resolve.
-        if (response.headers.location) {
-          download(response.headers.location, dest)
-            .then(() => resolve(/* */ ""))
-            .catch(error => {
-              Console.error(error)
-              reject(error)
-            })
-        }
-      } else {
-        Console.debug(
-          `Server responded with ${response.statusCode}: ${response.statusMessage}`
-        )
-        reject(
-          `Server responded with ${response.statusCode}: ${response.statusMessage}`
-        )
-      }
-    })
-
-    request.on("error", err => {
-      reject(err.message)
-    })
-  })
-}
-
-export const clone = (repository = "", folder = "./") =>
-  new Promise((resolve, reject) => {
-    if (!repository) {
-      reject("Missing repository url for this package")
-      // return false
-    }
-
-    cli.action.start("Verifying GIT...")
-    if (!shell.which("git")) {
-      reject("Sorry, this script requires git")
-      // return false
-    }
-
-    cli.action.stop()
-
-    let fileName = p.basename(repository)
-    if (!fileName) {
-      reject("Invalid repository information on package: " + repository)
-      // return false
-    }
-
-    fileName = fileName.split(".")[0]
-    if (fs.existsSync("./" + fileName)) {
-      reject(
-        `Directory ${fileName} already exists; Did you download this package already?`
-      )
-      // return false
-    }
-
-    cli.action.start(`Cloning repository ${repository}...`)
-    if (shell.exec(`git clone ${repository}`).code !== 0) {
-      reject("Error: Installation failed")
-    }
-
-    cli.action.stop()
-
-    cli.action.start("Cleaning installation...")
-    if (shell.exec(`rm -R -f ${folder}${fileName}/.git`).code !== 0) {
-      reject("Error: removing .git directory")
-    }
-
-    cli.action.stop()
-
-    resolve("Done")
-  })
-
-export const rmSync = function (path: string) {
-  let files = []
-  if (fs.existsSync(path)) {
-    files = fs.readdirSync(path)
-    for (const [, file] of files.entries()) {
-      const curPath = path + "/" + file
-      if (fs.lstatSync(curPath).isDirectory()) {
-        // recurse
-        rmSync(curPath)
-      } else {
-        // delete file
-        fs.unlinkSync(curPath)
-      }
-    }
-
-    fs.rmdirSync(path)
-  }
-}
-
-export const checkIfDirectoryExists = (path: string) => {
-  const fs = require("fs")
-  if (fs.existsSync(path)) {
-    return true
-  }
-
-  return false
-}
-
-export default { download, decompress, downloadEditor, clone, rmSync }
+import * as fs from "fs"
+import * as p from "path"
+import * as shell from "shelljs"
+import { cli } from "cli-ux"
+import * as targz from "targz"
+import Console from "../utils/console"
+import * as https from "https"
+import { InternalError } from "../utils/errors"
+
+// eslint-disable-next-line
+const fetch = require("node-fetch")
+
+export const decompress = (sourcePath: string, destinationPath: string) =>
+  new Promise((resolve, reject) => {
+    Console.debug("Decompressing " + sourcePath)
+    targz.decompress(
+      {
+        src: sourcePath,
+        dest: destinationPath,
+      },
+      function (err: string | Error | null) {
+        if (err) {
+          Console.error("Error when trying to decompress")
+          reject(err)
+        } else {
+          Console.info("Decompression finished successfully")
+          resolve(/* */ "")
+        }
+      }
+    )
+  })
+
+export const downloadEditor = async (
+  version: string | undefined,
+  destination: string
+) => {
+  if (!version) {
+    const res = await fetch(
+      "https://raw.githubusercontent.com/learnpack/ide/master/package.json"
+    )
+    const json = await res.json()
+    version = json.version || "4.0.0"
+
+    if (!version)
+      throw InternalError(
+        `Coding Editor version was not found on learnpack repository, check the config.editor.version property on learn.json`
+      )
+  }
+
+  const [major, minor] = version.split(".")
+  const versionPrefix = `${major}.${minor}`
+
+  const tagsRes = await fetch(
+    "https://api.github.com/repos/learnpack/ide/contents/bin"
+  )
+  const tags = await tagsRes.json()
+  const matchingTags = tags
+    .filter((tag: any) => tag.name.includes(versionPrefix))
+    .sort((a: any, b: any) =>
+      b.name.localeCompare(a.name, undefined, { numeric: true })
+    )
+
+  if (matchingTags.length === 0)
+    throw InternalError(
+      `No matching version found for prefix ${versionPrefix} in the learnpack repository`
+    )
+
+  const latestVersion = matchingTags[0].name
+    .replace("learnpack-", "")
+    .replace(".tar.gz", "")
+  const versionNumber = parseInt(latestVersion.split(".")[0])
+
+  let url = `https://github.com/learnpack/coding-ide/blob/${latestVersion}/dist`
+
+  if (versionNumber > 2)
+    url = `https://github.com/learnpack/ide/blob/master/bin/learnpack-${latestVersion}.tar.gz`
+
+  const resp2 = await fetch(url, { method: "HEAD" })
+  if (!resp2.ok)
+    throw InternalError(
+      `Coding Editor ${latestVersion} was not found on learnpack repository, check the config.editor.version property on learn.json`
+    )
+
+  Console.info("Downloading the LearnPack coding UI, this may take a minute...")
+
+  url += versionNumber > 2 ? `?raw=true` : `/app.tar.gz?raw=true`
+
+  return download(url, destination)
+}
+
+export const download = (url: string, dest: string) => {
+  Console.debug("Downloading " + url)
+  return new Promise((resolve, reject) => {
+    const request = https.get(url, response => {
+      if (response.statusCode === 200) {
+        const file = fs.createWriteStream(dest, { flags: "wx" })
+        file.on("finish", () => {
+          resolve(true)
+        })
+        file.on("error", err => {
+          file.close()
+          if (err.code === "EEXIST") {
+            Console.debug("File already exists")
+            resolve("File already exists")
+          } else {
+            Console.debug("Error ", err.message)
+            fs.unlink(dest, () => reject(err.message)) // Delete temp file
+          }
+        })
+        response.pipe(file)
+      } else if (response.statusCode === 302 || response.statusCode === 301) {
+        // Console.debug("Servers redirected to "+response.headers.location)
+        // Recursively follow redirects, only a 200 will resolve.
+        if (response.headers.location) {
+          download(response.headers.location, dest)
+            .then(() => resolve(/* */ ""))
+            .catch(error => {
+              Console.error(error)
+              reject(error)
+            })
+        }
+      } else {
+        Console.debug(
+          `Server responded with ${response.statusCode}: ${response.statusMessage}`
+        )
+        reject(
+          `Server responded with ${response.statusCode}: ${response.statusMessage}`
+        )
+      }
+    })
+
+    request.on("error", err => {
+      reject(err.message)
+    })
+  })
+}
+
+export const clone = (repository = "", folder = "./") =>
+  new Promise((resolve, reject) => {
+    if (!repository) {
+      reject("Missing repository url for this package")
+      // return false
+    }
+
+    cli.action.start("Verifying GIT...")
+    if (!shell.which("git")) {
+      reject("Sorry, this script requires git")
+      // return false
+    }
+
+    cli.action.stop()
+
+    let fileName = p.basename(repository)
+    if (!fileName) {
+      reject("Invalid repository information on package: " + repository)
+      // return false
+    }
+
+    fileName = fileName.split(".")[0]
+    if (fs.existsSync("./" + fileName)) {
+      reject(
+        `Directory ${fileName} already exists; Did you download this package already?`
+      )
+      // return false
+    }
+
+    cli.action.start(`Cloning repository ${repository}...`)
+    if (shell.exec(`git clone ${repository}`).code !== 0) {
+      reject("Error: Installation failed")
+    }
+
+    cli.action.stop()
+
+    cli.action.start("Cleaning installation...")
+    if (shell.exec(`rm -R -f ${folder}${fileName}/.git`).code !== 0) {
+      reject("Error: removing .git directory")
+    }
+
+    cli.action.stop()
+
+    resolve("Done")
+  })
+
+export const rmSync = function (path: string) {
+  let files = []
+  if (fs.existsSync(path)) {
+    files = fs.readdirSync(path)
+    for (const [, file] of files.entries()) {
+      const curPath = path + "/" + file
+      if (fs.lstatSync(curPath).isDirectory()) {
+        // recurse
+        rmSync(curPath)
+      } else {
+        // delete file
+        fs.unlinkSync(curPath)
+      }
+    }
+
+    fs.rmdirSync(path)
+  }
+}
+
+export const checkIfDirectoryExists = (path: string) => {
+  const fs = require("fs")
+  if (fs.existsSync(path)) {
+    return true
+  }
+
+  return false
+}
+
+export default { download, decompress, downloadEditor, clone, rmSync }

package/src/models/config.ts

@@ -78,11 +78,20 @@ export interface IConfig {
   videoSolutions?: boolean;
   skills: Array<string>;
   telemetry?: TTelemetryUrls;
+  variables?: TVariables;
 
   runHook: (...agrs: Array<any>) => void;
   testingFinishedCallback: (arg: any | undefined) => void;
 }
 
+type TVariable = {
+  type: "command" | "string";
+  source: string;
+};
+type TVariables = {
+  [key: string]: TVariable | string;
+};
+
 export interface IConfigObj {
   session?: number;
   currentExercise?: any;