@learnpack/learnpack 2.1.46 → 2.1.48

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @learnpack/learnpack
 $ learnpack COMMAND
 running command...
 $ learnpack (-v|--version|version)
-@learnpack/learnpack/2.1.46 win32-x64 node-v20.10.0
+@learnpack/learnpack/2.1.48 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.46/src\commands\audit.ts)_
+_See code: [src\commands\audit.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\clean.ts)_
+_See code: [src\commands\clean.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\download.ts)_
+_See code: [src\commands\download.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\init.ts)_
+_See code: [src\commands\init.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\login.ts)_
+_See code: [src\commands\login.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\logout.ts)_
+_See code: [src\commands\logout.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\publish.ts)_
+_See code: [src\commands\publish.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\start.ts)_
+_See code: [src\commands\start.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/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.46/src\commands\test.ts)_
+_See code: [src\commands\test.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.48/src\commands\test.ts)_
 <!-- commandsstop -->
 
 > > > > > > > 0cb3e56d84c197f9d008836bb573eade212b7e57

package/lib/commands/start.js

@@ -90,14 +90,20 @@ class StartCommand extends SessionCommand_1.default {
                 socket_1.default.on("open_window", (data) => {
                     console_1.default.debug("Opening window: ", data);
                     // cli.open(data.url); This uses XDG under the ground
-                    if (config.editor.agent === "os" &&
-                        ((config.os === "linux" && hasXDG) || config.os !== "linux")) {
+                    if (config.os !== "linux" || (config.os === "linux" && hasXDG)) {
                         osOperations_1.eventManager.enqueue(dispatcher.events.OPEN_WINDOW, data);
                     }
                     else {
                         dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data);
                     }
-                    socket_1.default.log("open_window", `URL ${data.url} opened in the browser`);
+                    socket_1.default.log("open_window", "", undefined, data.url);
+                });
+                socket_1.default.on("open_terminal", (exercise) => {
+                    console_1.default.debug("Opening terminal: ", exercise);
+                    // eventManager.enqueue(dispatcher.events.OPEN_TERMINAL, exercise);
+                    if (config.editor.agent === "vscode") {
+                        dispatcher.enqueue(dispatcher.events.OPEN_TERMINAL, exercise);
+                    }
                 });
                 socket_1.default.on("reset", (exercise) => {
                     var _a;

package/lib/utils/checkNotInstalled.js

@@ -18,23 +18,30 @@ exports.checkNotInstalledPlugins = async (exercises, installedPlugins, command)
     // See the extensions of the files that are not tests files
     for (const e of exercises) {
         const notReadmeFiles = e.files.filter(f => !f.name.toLowerCase().includes("readme"));
-        if (!someExerciseWithOnlyTestFile) {
-            someExerciseWithOnlyTestFile = notReadmeFiles.every(f => f.name.includes("test"));
+        if (!someExerciseWithOnlyTestFile && notReadmeFiles.length > 0) {
+            someExerciseWithOnlyTestFile = notReadmeFiles.every(f => {
+                return f.name.includes("test");
+            });
+            if (someExerciseWithOnlyTestFile) {
+                console_1.default.debug("Some exercises have only test files, I will install the @learnpack/node plugin to run the tests.");
+            }
         }
         for (const f of notReadmeFiles) {
-            // There are some courses with only test files in js  and grading: incremental
-            // TODO: We should know in the incremental exercises which compilers are needed
             const ext = f.name.split(".").pop();
+            if (!ext)
+                continue;
             if (f.name.includes("test")) {
-                testingExtensions.push(ext);
+                !testingExtensions.includes(ext) && testingExtensions.push(ext);
                 continue;
             }
-            if (ext && usefulExtensions.has(ext) && !foundExtensions.includes(ext)) {
+            if (usefulExtensions.has(ext) && !foundExtensions.includes(ext)) {
                 foundExtensions.push(ext);
             }
         }
     }
-    if (foundExtensions.length === 0)
+    console_1.default.debug("foundExtensions", foundExtensions);
+    console_1.default.debug("testingExtensions", testingExtensions);
+    if (foundExtensions.length === 0 && testingExtensions.length === 0)
         return {
             needed: [],
             notInstalled: [],

package/lib/utils/fileQueue.d.ts

@@ -8,6 +8,7 @@ declare const _default: {
         OPEN_FILES: string;
         OPEN_WINDOW: string;
         INSTRUCTIONS_CLOSED: string;
+        OPEN_TERMINAL: string;
     };
     dispatcher: (opts?: any) => {
         enqueue: (name: string, data?: any) => void;
@@ -20,6 +21,7 @@ declare const _default: {
             OPEN_FILES: string;
             OPEN_WINDOW: string;
             INSTRUCTIONS_CLOSED: string;
+            OPEN_TERMINAL: string;
         };
     };
     listener: (opts?: any) => {
@@ -34,6 +36,7 @@ declare const _default: {
             OPEN_FILES: string;
             OPEN_WINDOW: string;
             INSTRUCTIONS_CLOSED: string;
+            OPEN_TERMINAL: string;
         };
     };
 };

package/lib/utils/fileQueue.js

@@ -14,6 +14,7 @@ const events = {
     OPEN_FILES: "open_files",
     OPEN_WINDOW: "open_window",
     INSTRUCTIONS_CLOSED: "instructions_closed",
+    OPEN_TERMINAL: "open_terminal",
 };
 let options = {
     path: null,

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.1.46","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":"2.1.48","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.46",
+  "version": "2.1.48",
   "author": "Alejandro Sanchez @alesanchezr",
   "bin": {
     "learnpack": "bin/run"
@@ -100,7 +100,8 @@
     "plugins": [
       "@oclif/plugin-help",
       "@oclif/plugin-plugins",
-      "@oclif/plugin-warn-if-update-available"
+      "@oclif/plugin-warn-if-update-available",
+      "@learnpack/dom"
     ],
     "permanent_plugins": [
       "@oclif/plugin-help",

package/src/commands/start.ts

@@ -187,16 +187,21 @@ export default class StartCommand extends SessionCommand {
         socket.on("open_window", (data: TOpenWindowData) => {
           Console.debug("Opening window: ", data)
           // cli.open(data.url); This uses XDG under the ground
-          if (
-            config.editor.agent === "os" &&
-            ((config.os === "linux" && hasXDG) || config.os !== "linux")
-          ) {
+          if (config.os !== "linux" || (config.os === "linux" && hasXDG)) {
             eventManager.enqueue(dispatcher.events.OPEN_WINDOW, data)
           } else {
             dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data)
           }
 
-          socket.log("open_window", `URL ${data.url} opened in the browser`)
+          socket.log("open_window", "", undefined, data.url)
+        })
+
+        socket.on("open_terminal", (exercise: IExerciseData) => {
+          Console.debug("Opening terminal: ", exercise)
+          // eventManager.enqueue(dispatcher.events.OPEN_TERMINAL, exercise);
+          if (config.editor.agent === "vscode") {
+            dispatcher.enqueue(dispatcher.events.OPEN_TERMINAL, exercise)
+          }
         })
 
         socket.on("reset", (exercise: IExerciseData) => {

package/src/utils/checkNotInstalled.ts

@@ -21,7 +21,7 @@ export const checkNotInstalledPlugins = async (
   Console.info("Checking needed plugins...")
   const usefulExtensions = new Set(["py", "js", "jsx", "html"])
   const foundExtensions: string[] = []
-  const testingExtensions = []
+  const testingExtensions: string[] = []
   const neededPlugins: string[] = []
   let someExerciseWithOnlyTestFile = false // I will suppose that there are not exercises with only readme and test files
 
@@ -31,29 +31,38 @@ export const checkNotInstalledPlugins = async (
       f => !f.name.toLowerCase().includes("readme")
     )
 
-    if (!someExerciseWithOnlyTestFile) {
-      someExerciseWithOnlyTestFile = notReadmeFiles.every(f =>
-        f.name.includes("test")
-      )
+    if (!someExerciseWithOnlyTestFile && notReadmeFiles.length > 0) {
+      someExerciseWithOnlyTestFile = notReadmeFiles.every(f => {
+        return f.name.includes("test")
+      })
+
+      if (someExerciseWithOnlyTestFile) {
+        Console.debug(
+          "Some exercises have only test files, I will install the @learnpack/node plugin to run the tests."
+        )
+      }
     }
 
     for (const f of notReadmeFiles) {
-      // There are some courses with only test files in js  and grading: incremental
-      // TODO: We should know in the incremental exercises which compilers are needed
-
       const ext = f.name.split(".").pop()
+      if (!ext) 
+continue
+
       if (f.name.includes("test")) {
-        testingExtensions.push(ext)
+        !testingExtensions.includes(ext) && testingExtensions.push(ext)
         continue
       }
 
-      if (ext && usefulExtensions.has(ext) && !foundExtensions.includes(ext)) {
+      if (usefulExtensions.has(ext) && !foundExtensions.includes(ext)) {
         foundExtensions.push(ext)
       }
     }
   }
 
-  if (foundExtensions.length === 0)
+  Console.debug("foundExtensions", foundExtensions)
+  Console.debug("testingExtensions", testingExtensions)
+
+  if (foundExtensions.length === 0 && testingExtensions.length === 0)
     return {
       needed: [],
       notInstalled: [],

package/src/utils/fileQueue.ts

@@ -1,198 +1,199 @@
-import logger from "../utils/console"
-import * as fs from "fs"
-// import em from "events"
-import * as XXH from "xxhashjs"
-
-// possible events to dispatch
-const events = {
-  START_EXERCISE: "start_exercise",
-  INIT: "initializing",
-  RUNNING: "configuration_loaded",
-  END: "connection_ended",
-  RESET_EXERCISE: "reset_exercise",
-  OPEN_FILES: "open_files",
-  OPEN_WINDOW: "open_window",
-  INSTRUCTIONS_CLOSED: "instructions_closed",
-}
-
-let options = {
-  path: null,
-  create: false,
-}
-let lastHash: any = null
-let watcher: any = null // subscribe to file and listen to changes
-let actions: any = null // action queue
-
-const loadDispatcher = (opts: any) => {
-  actions = [{ name: "initializing", time: now() }]
-  logger.debug(`Loading from ${opts.path}`)
-
-  let exists = fs.existsSync(opts.path)
-  if (opts.create) {
-    if (exists) 
-actions.push({ name: "reset", time: now() })
-    fs.writeFileSync(opts.path, JSON.stringify(actions), { flag: "w" })
-    exists = true
-  }
-
-  if (!exists)
-    throw new Error(`Invalid queue path, missing file at: ${opts.path}`)
-
-  let incomingActions = []
-  try {
-    const content = fs.readFileSync(opts.path, "utf-8")
-    incomingActions = JSON.parse(content)
-    if (!Array.isArray(incomingActions)) 
-incomingActions = []
-  } catch {
-    incomingActions = []
-    logger.debug("Error loading VSCode Actions file")
-  }
-
-  logger.debug("Actions load ", incomingActions)
-  return incomingActions
-}
-
-// eslint-disable-next-line
-const enqueue = (name: string, data: any | undefined = undefined) => {
-  if (!Object.values(events).includes(name)) {
-    logger.debug(`Invalid event ${name}`)
-    throw new Error(`Invalid action ${name}`)
-  }
-
-  if (!actions) 
-actions = []
-
-  actions.push({ name, time: now(), data: data })
-  logger.debug(`EMIT -> ${name}:Exporting changes to ${options.path}`)
-
-  return fs.writeFileSync(options.path || "", JSON.stringify(actions))
-}
-
-const now = () => {
-  const hrTime = process.hrtime()
-  // eslint-disable-next-line
-  const htTime0 = hrTime[0] * 1000000;
-  return (htTime0 + hrTime[1]) / 1000
-}
-
-const loadFile = (filePath: string) => {
-  if (!fs.existsSync(filePath))
-    throw new Error(`No queue.json file to load on ${filePath}`)
-
-  const content = fs.readFileSync(filePath, "utf8")
-  const newHash = XXH.h32(content, 0xAB_CD).toString(16)
-  const isUpdated = lastHash !== newHash
-  lastHash = newHash
-  const incomingActions = JSON.parse(content)
-  return { isUpdated, incomingActions }
-}
-
-const dequeue = () => {
-  // first time dequeue loads
-  if (!actions) 
-actions = []
-
-  const { isUpdated, incomingActions } = loadFile(options.path || "")
-
-  if (!isUpdated) {
-    /**
-     * make sure no tasks are executed from the queue by matching both
-     * queues (the incoming with current one)
-     */
-    actions = incomingActions
-    logger.debug(
-      `No new actions to process: ${actions.length}/${incomingActions.length}`
-    )
-    return null
-  }
-
-  // do i need to reset actions to zero?
-  if (actions.length > 0 && actions[0].time !== incomingActions[0].time) {
-    actions = []
-  }
-
-  const action = incomingActions[incomingActions.length - 1]
-  logger.debug("Dequeing action ", action)
-  actions.push(action)
-  return action
-}
-
-const pull = (callback: (T: any) => any) => {
-  logger.debug("Pulling actions")
-  let incoming = dequeue()
-  while (incoming) {
-    callback(incoming)
-    incoming = dequeue()
-  }
-}
-
-const reset = (callback: (T?: any) => any) => {
-  logger.debug("Queue reseted")
-  actions = []
-  if (fs.existsSync(options.path || "")) {
-    fs.writeFileSync(options.path || "", "[]")
-    callback()
-  }
-}
-
-const onPull = (callback: (T?: any) => any) => {
-  // eslint-disable-next-line
-  const chokidar = require("chokidar");
-
-  logger.debug("Starting to listen...")
-  try {
-    loadFile(options.path || "")
-  } catch {
-    logger.debug("No previoues queue file, waiting for it to be created...")
-  }
-
-  if (!watcher) {
-    logger.debug(`Watching ${options.path}`)
-    watcher = chokidar.watch(`${options.path}`, {
-      persistent: true,
-    })
-  } else 
-logger.debug("Already watching queue path")
-
-  watcher.on("add", () => pull(callback)).on("change", () => pull(callback))
-
-  return true
-}
-
-const onReset = (callback: (T?: any) => any) => {
-  // eslint-disable-next-line
-  const chokidar = require("chokidar");
-
-  if (!watcher) {
-    logger.debug(`Watching ${options.path}`)
-    watcher = chokidar.watch(`${options.path}`, {
-      persistent: true,
-    })
-  }
-
-  watcher.on("unlink", () => reset(callback))
-
-  return true
-}
-
-export default {
-  events,
-  dispatcher: (opts: any = {}) => {
-    if (!actions) {
-      options = { ...options, ...opts }
-      logger.debug("Initializing queue dispatcher", options)
-      actions = loadDispatcher(options)
-    }
-
-    return { enqueue, events }
-  },
-  listener: (opts: any = {}) => {
-    if (!actions) {
-      options = { ...options, ...opts }
-      logger.debug("Initializing queue listener", options)
-    }
-
-    return { onPull, onReset, events }
-  },
-}
+import logger from "../utils/console"
+import * as fs from "fs"
+// import em from "events"
+import * as XXH from "xxhashjs"
+
+// possible events to dispatch
+const events = {
+  START_EXERCISE: "start_exercise",
+  INIT: "initializing",
+  RUNNING: "configuration_loaded",
+  END: "connection_ended",
+  RESET_EXERCISE: "reset_exercise",
+  OPEN_FILES: "open_files",
+  OPEN_WINDOW: "open_window",
+  INSTRUCTIONS_CLOSED: "instructions_closed",
+  OPEN_TERMINAL: "open_terminal",
+}
+
+let options = {
+  path: null,
+  create: false,
+}
+let lastHash: any = null
+let watcher: any = null // subscribe to file and listen to changes
+let actions: any = null // action queue
+
+const loadDispatcher = (opts: any) => {
+  actions = [{ name: "initializing", time: now() }]
+  logger.debug(`Loading from ${opts.path}`)
+
+  let exists = fs.existsSync(opts.path)
+  if (opts.create) {
+    if (exists) 
+actions.push({ name: "reset", time: now() })
+    fs.writeFileSync(opts.path, JSON.stringify(actions), { flag: "w" })
+    exists = true
+  }
+
+  if (!exists)
+    throw new Error(`Invalid queue path, missing file at: ${opts.path}`)
+
+  let incomingActions = []
+  try {
+    const content = fs.readFileSync(opts.path, "utf-8")
+    incomingActions = JSON.parse(content)
+    if (!Array.isArray(incomingActions)) 
+incomingActions = []
+  } catch {
+    incomingActions = []
+    logger.debug("Error loading VSCode Actions file")
+  }
+
+  logger.debug("Actions load ", incomingActions)
+  return incomingActions
+}
+
+// eslint-disable-next-line
+const enqueue = (name: string, data: any | undefined = undefined) => {
+  if (!Object.values(events).includes(name)) {
+    logger.debug(`Invalid event ${name}`)
+    throw new Error(`Invalid action ${name}`)
+  }
+
+  if (!actions) 
+actions = []
+
+  actions.push({ name, time: now(), data: data })
+  logger.debug(`EMIT -> ${name}:Exporting changes to ${options.path}`)
+
+  return fs.writeFileSync(options.path || "", JSON.stringify(actions))
+}
+
+const now = () => {
+  const hrTime = process.hrtime()
+  // eslint-disable-next-line
+  const htTime0 = hrTime[0] * 1000000;
+  return (htTime0 + hrTime[1]) / 1000
+}
+
+const loadFile = (filePath: string) => {
+  if (!fs.existsSync(filePath))
+    throw new Error(`No queue.json file to load on ${filePath}`)
+
+  const content = fs.readFileSync(filePath, "utf8")
+  const newHash = XXH.h32(content, 0xAB_CD).toString(16)
+  const isUpdated = lastHash !== newHash
+  lastHash = newHash
+  const incomingActions = JSON.parse(content)
+  return { isUpdated, incomingActions }
+}
+
+const dequeue = () => {
+  // first time dequeue loads
+  if (!actions) 
+actions = []
+
+  const { isUpdated, incomingActions } = loadFile(options.path || "")
+
+  if (!isUpdated) {
+    /**
+     * make sure no tasks are executed from the queue by matching both
+     * queues (the incoming with current one)
+     */
+    actions = incomingActions
+    logger.debug(
+      `No new actions to process: ${actions.length}/${incomingActions.length}`
+    )
+    return null
+  }
+
+  // do i need to reset actions to zero?
+  if (actions.length > 0 && actions[0].time !== incomingActions[0].time) {
+    actions = []
+  }
+
+  const action = incomingActions[incomingActions.length - 1]
+  logger.debug("Dequeing action ", action)
+  actions.push(action)
+  return action
+}
+
+const pull = (callback: (T: any) => any) => {
+  logger.debug("Pulling actions")
+  let incoming = dequeue()
+  while (incoming) {
+    callback(incoming)
+    incoming = dequeue()
+  }
+}
+
+const reset = (callback: (T?: any) => any) => {
+  logger.debug("Queue reseted")
+  actions = []
+  if (fs.existsSync(options.path || "")) {
+    fs.writeFileSync(options.path || "", "[]")
+    callback()
+  }
+}
+
+const onPull = (callback: (T?: any) => any) => {
+  // eslint-disable-next-line
+  const chokidar = require("chokidar");
+
+  logger.debug("Starting to listen...")
+  try {
+    loadFile(options.path || "")
+  } catch {
+    logger.debug("No previoues queue file, waiting for it to be created...")
+  }
+
+  if (!watcher) {
+    logger.debug(`Watching ${options.path}`)
+    watcher = chokidar.watch(`${options.path}`, {
+      persistent: true,
+    })
+  } else 
+logger.debug("Already watching queue path")
+
+  watcher.on("add", () => pull(callback)).on("change", () => pull(callback))
+
+  return true
+}
+
+const onReset = (callback: (T?: any) => any) => {
+  // eslint-disable-next-line
+  const chokidar = require("chokidar");
+
+  if (!watcher) {
+    logger.debug(`Watching ${options.path}`)
+    watcher = chokidar.watch(`${options.path}`, {
+      persistent: true,
+    })
+  }
+
+  watcher.on("unlink", () => reset(callback))
+
+  return true
+}
+
+export default {
+  events,
+  dispatcher: (opts: any = {}) => {
+    if (!actions) {
+      options = { ...options, ...opts }
+      logger.debug("Initializing queue dispatcher", options)
+      actions = loadDispatcher(options)
+    }
+
+    return { enqueue, events }
+  },
+  listener: (opts: any = {}) => {
+    if (!actions) {
+      options = { ...options, ...opts }
+      logger.debug("Initializing queue listener", options)
+    }
+
+    return { onPull, onReset, events }
+  },
+}