@learnpack/learnpack 2.1.37 → 2.1.39

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @learnpack/learnpack
 $ learnpack COMMAND
 running command...
 $ learnpack (-v|--version|version)
-@learnpack/learnpack/2.1.37 darwin-arm64 node-v16.20.1
+@learnpack/learnpack/2.1.39 linux-x64 node-v20.11.1
 $ 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.37/src/commands/audit.ts)_
+_See code: [src/commands/audit.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/clean.ts)_
+_See code: [src/commands/clean.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/download.ts)_
+_See code: [src/commands/download.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/publish.ts)_
+_See code: [src/commands/publish.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/src/commands/publish.ts)_
 
 ## `learnpack start`
 
@@ -322,7 +322,7 @@ USAGE
 OPTIONS
   -D, --disableGrading                disble grading functionality
   -d, --debug                         debugger mode for more verbage
-  -e, --editor=standalone|gitpod      [standalone, gitpod]
+  -e, --editor=extension|preview      [preview, extension]
   -g, --grading=isolated|incremental  [isolated, incremental]
   -h, --host=host                     server host
   -p, --port=port                     server port
@@ -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.37/src/commands/start.ts)_
+_See code: [src/commands/start.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/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.37/src/commands/test.ts)_
+_See code: [src/commands/test.ts](https://github.com/learnpack/learnpack-cli/blob/v2.1.39/src/commands/test.ts)_
 <!-- commandsstop -->
 
 > > > > > > > 0cb3e56d84c197f9d008836bb573eade212b7e57

package/lib/commands/start.js

@@ -10,6 +10,7 @@ const server_1 = require("../managers/server");
 const fileQueue_1 = require("../utils/fileQueue");
 const file_1 = require("../managers/file");
 const misc_1 = require("../utils/misc");
+const osOperations_1 = require("../utils/osOperations");
 class StartCommand extends SessionCommand_1.default {
     // 🛑 IMPORTANT
     // Every command that will use the configManager needs this init method
@@ -22,6 +23,7 @@ class StartCommand extends SessionCommand_1.default {
         // get configuration object
         const configObject = (_a = this.configManager) === null || _a === void 0 ? void 0 : _a.get();
         const config = configObject === null || configObject === void 0 ? void 0 : configObject.config;
+        const hasXDG = await osOperations_1.eventManager.checkXDGInstalled();
         if (configObject) {
             const { config } = configObject;
             // build exerises
@@ -38,6 +40,9 @@ class StartCommand extends SessionCommand_1.default {
             // listen to socket commands
             if (config && this.configManager) {
                 const server = await server_1.default(configObject, this.configManager, process.env.NODE_ENV === "test");
+                server.setMaxListeners(20);
+                // console.log(config, "this is the f*!shell.which("code")!shell.which("code")cking config");
+                // I should call a method to get the EventListener
                 const dispatcher = fileQueue_1.default.dispatcher({
                     create: true,
                     path: `${config.dirPath}/vscode_queue.json`,
@@ -66,12 +71,23 @@ class StartCommand extends SessionCommand_1.default {
                 socket_1.default.on("open", (data) => {
                     console_1.default.debug("Opening these files: ", data);
                     const files = misc_1.prioritizeHTMLFile(data.files);
-                    dispatcher.enqueue(dispatcher.events.OPEN_FILES, files);
+                    if (config.editor.agent === "os") {
+                        osOperations_1.eventManager.enqueue(dispatcher.events.OPEN_FILES, files);
+                    }
+                    else {
+                        dispatcher.enqueue(dispatcher.events.OPEN_FILES, files);
+                    }
                     socket_1.default.ready("Ready to compile...");
                 });
                 socket_1.default.on("open_window", (data) => {
                     console_1.default.debug("Opening window: ", data);
-                    dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data);
+                    if (config.editor.agent === "os" &&
+                        ((config.os === "linux" && hasXDG) || config.os !== "linux")) {
+                        osOperations_1.eventManager.enqueue(dispatcher.events.OPEN_WINDOW, data);
+                    }
+                    else {
+                        dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data);
+                    }
                     socket_1.default.ready("Ready to compile...");
                 });
                 socket_1.default.on("reset", (exercise) => {
@@ -87,11 +103,6 @@ class StartCommand extends SessionCommand_1.default {
                         setTimeout(() => socket_1.default.ready("Ready to compile..."), 2000);
                     }
                 });
-                // socket.on("preview", (data) => {
-                //   Console.debug("Preview triggered, removing the 'preview' action ")
-                //   socket.removeAllowed("preview")
-                //   socket.log('ready',['Ready to compile...'])
-                // })
                 socket_1.default.on("build", async (data) => {
                     var _a;
                     const exercise = (_a = this.configManager) === null || _a === void 0 ? void 0 : _a.getExercise(data.exerciseSlug);
@@ -143,14 +154,12 @@ class StartCommand extends SessionCommand_1.default {
                     return true;
                 });
                 const terminate = () => {
-                    console_1.default.debug("Terminating Learnpack...");
+                    var _a;
+                    console_1.default.error("Terminating Learnpack...");
                     telemetry_1.default.submit();
-                    server.terminate(() => {
-                        var _a;
-                        (_a = this.configManager) === null || _a === void 0 ? void 0 : _a.noCurrentExercise();
-                        dispatcher.enqueue(dispatcher.events.END);
-                        process.exit();
-                    });
+                    (_a = this.configManager) === null || _a === void 0 ? void 0 : _a.noCurrentExercise();
+                    dispatcher.enqueue(dispatcher.events.END);
+                    process.exit();
                 };
                 server.on("close", terminate);
                 process.on("SIGINT", terminate);
@@ -182,8 +191,8 @@ StartCommand.flags = Object.assign(Object.assign({}, SessionCommand_1.default.fl
         default: false,
     }), editor: command_1.flags.string({
         char: "e",
-        description: "[standalone, gitpod]",
-        options: ["standalone", "gitpod"],
+        description: "[preview, extension]",
+        options: ["extension", "preview"],
     }), version: command_1.flags.string({
         char: "v",
         description: "E.g: 1.0.1",

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

@@ -1,6 +1,8 @@
+/// <reference types="node" />
 declare const _default: {
     config: {
         port: number;
+        os: NodeJS.Platform;
         editor: {
             mode: null;
             agent: null;

package/lib/managers/config/defaults.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const os = require("os");
 exports.default = {
     config: {
         port: 3000,
+        os: (function () {
+            return os.platform();
+        })(),
         editor: {
             mode: null,
             agent: null,

package/lib/managers/config/index.js

@@ -15,6 +15,12 @@ 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;
@@ -38,7 +44,7 @@ const getGitpodAddress = () => {
     return "http://localhost";
 };
 const getCodespacesNamespace = () => {
-    // https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
+    // 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, "");
@@ -52,12 +58,12 @@ const getCodespacesNamespace = () => {
     return codespace_name;
 };
 exports.default = async ({ grading, mode, disableGrading, version, }) => {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d;
     const confPath = getConfigPath();
     console_1.default.debug("This is the config path: ", confPath);
     let configObj = {};
     if (confPath) {
-        const bcContent = fs.readFileSync(confPath.config);
+        const learnJsonContent = fs.readFileSync(confPath.config);
         let hiddenBcContent = {};
         if (fs.existsSync(confPath.base + "/config.json")) {
             hiddenBcContent = fs.readFileSync(confPath.base + "/config.json");
@@ -65,7 +71,7 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
             if (!hiddenBcContent)
                 throw new Error(`Invalid ${confPath.base}/config.json syntax: Unable to parse.`);
         }
-        const jsonConfig = JSON.parse(`${bcContent}`);
+        const jsonConfig = JSON.parse(`${learnJsonContent}`);
         if (!jsonConfig)
             throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`);
         let session;
@@ -83,7 +89,7 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
         });
     }
     else {
-        throw errors_1.ValidationError("No learn.json file has been found, make sure you are in the folder");
+        throw errors_1.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_1.default || {}, configObj, {
         config: {
@@ -91,9 +97,9 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
             configPath: confPath.config,
         },
     });
-    if (configObj.config) {
-        configObj.config.outputPath = confPath.base + "/dist";
-    }
+    if (!configObj.config)
+        throw errors_1.InternalError("Config object not found");
+    configObj.config.outputPath = confPath.base + "/dist";
     console_1.default.debug("This is your configuration object: ", Object.assign(Object.assign({}, configObj), { exercises: configObj.exercises ?
             configObj.exercises.map(e => e.slug) :
             [] }));
@@ -103,46 +109,44 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
     console_1.default.debug("This is the agent, and this should be null an the beginning: ", (_c = (_b = configObj.config) === null || _b === void 0 ? void 0 : _b.editor) === null || _c === void 0 ? void 0 : _c.agent);
     if (shell.which("gp") && configObj && configObj.config) {
         console_1.default.debug("Gitpod detected");
-        configObj.config.editor.agent = "vscode";
         configObj.address = getGitpodAddress();
         configObj.config.publicUrl = `https://${configObj.config.port}-${(_d = configObj.address) === null || _d === void 0 ? void 0 : _d.slice(8)}`;
+        configObj.config.editor.agent = "vscode";
     }
     else if (configObj.config && Boolean(codespaces_workspace)) {
         console_1.default.debug("Codespaces detected: ", codespaces_workspace);
-        configObj.config.editor.agent = "vscode";
         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 if (configObj.config && !configObj.config.editor.agent) {
+        configObj.config.editor.agent = "vscode";
     }
-    else if (configObj.config) {
-        console_1.default.debug("Localhost detected");
-        configObj.config.editor.agent = "localhost";
+    else {
+        console_1.default.debug("Neither Gitpod nor Codespaces detected, using localhost.");
         configObj.address = `http://localhost:${configObj.config.port}`;
         configObj.config.publicUrl = `http://localhost:${configObj.config.port}`;
     }
-    console_1.default.debug("This is the agent later", (_e = configObj === null || configObj === void 0 ? void 0 : configObj.config) === null || _e === void 0 ? void 0 : _e.editor.agent);
+    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}`;
-    // Assign default editor mode if not set already
-    if (configObj.config && !mode) {
+    if (configObj.config && !configObj.config.editor.mode && mode) {
         configObj.config.editor.mode = mode;
     }
-    if (configObj.config && !configObj.config.editor.mode)
+    if (!configObj.config.editor.mode) {
         configObj.config.editor.mode =
-            configObj.config.editor.agent === "localhost" ? "standalone" : "preview";
-    if (version && configObj.config)
+            configObj.config.editor.agent === "vscode" ? "extension" : "preview";
+    }
+    if (version)
         configObj.config.editor.version = version;
-    else if (configObj.config && configObj.config.editor.version === null) {
+    else if (configObj.config.editor.version === null) {
         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.0.20";
-    }
-    if (configObj.config) {
-        configObj.config.dirPath = "./" + confPath.base;
-        configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./";
+        configObj.config.editor.version = packageJSON.version || "3.1.22";
     }
+    configObj.config.dirPath = "./" + confPath.base;
+    configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./";
     return {
         validLanguages: {},
         get: () => configObj,
@@ -168,6 +172,7 @@ exports.default = async ({ grading, mode, disableGrading, version, }) => {
                 return true;
             }
             console_1.default.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,
             });

package/lib/managers/server/index.js

@@ -32,7 +32,7 @@ async function default_1(configObj, configManager, isTestingEnvironment = false)
             console_1.default.success(`Exercises are running 😃 Open your browser to start practicing!`);
             console_1.default.success(`\n            Open the exercise on this link:`);
             console_1.default.log(`            ${config === null || config === void 0 ? void 0 : config.publicUrl}`);
-            if ((config === null || config === void 0 ? void 0 : config.editor.mode) === "standalone")
+            if ((config === null || config === void 0 ? void 0 : config.editor.mode) === "preview")
                 cli_ux_1.default.open(`${config.publicUrl}`);
         }
     });

package/lib/managers/server/routes.js

@@ -10,6 +10,7 @@ const fileQueue_1 = require("../../utils/fileQueue");
 const exercise_1 = require("../config/exercise");
 const session_1 = require("../../managers/session");
 const telemetry_1 = require("../telemetry");
+const osOperations_1 = require("../../utils/osOperations");
 const withHandler = (func) => (req, res) => {
     try {
         func(req, res);
@@ -112,7 +113,7 @@ async function default_1(app, configObject, configManager) {
         }
     }));
     app.get("/exercise/:slug", withHandler((req, res) => {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         // no need to re-start exercise if it's already started
         if (configObject.currentExercise &&
             req.params.slug === configObject.currentExercise) {
@@ -127,7 +128,12 @@ async function default_1(app, configObject, configManager) {
         if (exercise.position) {
             telemetry_1.default.registerStepEvent(exercise.position, "open_step", {});
         }
-        dispatcher.enqueue(dispatcher.events.START_EXERCISE, req.params.slug);
+        if (((_a = configObject.config) === null || _a === void 0 ? void 0 : _a.editor.agent) === "os") {
+            osOperations_1.eventManager.enqueue(dispatcher.events.START_EXERCISE, exercise);
+        }
+        else {
+            dispatcher.enqueue(dispatcher.events.START_EXERCISE, req.params.slug);
+        }
         const entries = new Set(Object.keys(config === null || config === void 0 ? void 0 : config.entries).map(lang => config === null || config === void 0 ? void 0 : config.entries[lang]));
         // if we are in incremental grading, the entry file can by dinamically detected
         // based on the changes the student is making during the exercise
@@ -159,23 +165,23 @@ async function default_1(app, configObject, configManager) {
         exercise.entry = detected === null || detected === void 0 ? void 0 : detected.entry;
         console_1.default.debug(`Exercise detected entry: ${detected === null || detected === void 0 ? void 0 : detected.entry} and language ${exercise.language}`);
         // exercises.graded and exercises.disableGrading deprecated.
-        if (!exercise.graded || (config === null || config === void 0 ? void 0 : config.disableGrading) || ((_a = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _a === void 0 ? void 0 : _a.includes("test"))) {
+        if (!exercise.graded || (config === null || config === void 0 ? void 0 : config.disableGrading) || ((_b = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _b === void 0 ? void 0 : _b.includes("test"))) {
             socket_1.default.removeAllowed("test");
         }
         else {
             socket_1.default.addAllowed("test");
         }
-        if (!exercise.entry || ((_b = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _b === void 0 ? void 0 : _b.includes("build"))) {
+        if (!exercise.entry || ((_c = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _c === void 0 ? void 0 : _c.includes("build"))) {
             socket_1.default.removeAllowed("build");
         }
         else {
             socket_1.default.addAllowed("build");
         }
         if (exercise.files.filter((f) => !f.name.toLowerCase().includes("readme.") &&
-            !f.name.toLowerCase().includes("test.")).length === 0 || ((_c = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _c === void 0 ? void 0 : _c.includes("reset"))) {
+            !f.name.toLowerCase().includes("test.")).length === 0 || ((_d = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _d === void 0 ? void 0 : _d.includes("reset"))) {
             socket_1.default.removeAllowed("reset");
         }
-        else if (!((_d = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _d === void 0 ? void 0 : _d.includes("reset"))) {
+        else if (!((_e = config === null || config === void 0 ? void 0 : config.disabledActions) === null || _e === void 0 ? void 0 : _e.includes("reset"))) {
             socket_1.default.addAllowed("reset");
         }
         socket_1.default.log("ready");

package/lib/managers/telemetry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const api_1 = require("../utils/api");
+const console_1 = require("../utils/console");
 const fs = require("fs");
 function createUUID() {
     return (Math.random().toString(36).slice(2, 10) +
@@ -14,7 +15,7 @@ const TelemetryManager = {
     urls: {},
     configPath: "",
     salute: message => {
-        console.log(message);
+        console_1.default.info(message);
     },
     start: function (agent, steps, path, tutorialSlug) {
         this.configPath = path;
@@ -44,7 +45,7 @@ const TelemetryManager = {
                 this.submit();
             })
                 .catch(error => {
-                console.error(error);
+                console_1.default.debug(error);
             });
         }
     },
@@ -167,6 +168,7 @@ const TelemetryManager = {
         });
     },
     submit: async function () {
+        console_1.default.debug("Submitting telemetry...");
         if (!this.current)
             return Promise.resolve();
         const url = this.urls.batch;

package/lib/models/config.d.ts

@@ -1,17 +1,18 @@
 import { IExercise } from "./exercise-obj";
 import { TTelemetryUrls } from "../managers/telemetry";
 export declare type TGrading = "isolated" | "incremental" | "no-grading";
-export declare type TMode = "preview" | "standalone";
+export declare type TMode = "preview" | "extension";
 export declare type TConfigAction = "test" | "build" | "tutorial" | "reset" | "generate";
 export declare type TConfigObjAttributes = "config" | "exercises" | "grading";
 export declare type TCompiler = "webpack" | "vanillajs" | "vue" | "react" | "css" | "html";
 export interface IConfigPath {
     base: string;
 }
+declare type TAgent = "vscode" | "os";
 export interface IEditor {
     mode?: TMode;
     version: string;
-    agent?: string;
+    agent?: TAgent;
 }
 export interface TEntries {
     python3?: string;
@@ -21,6 +22,7 @@ export interface TEntries {
     java?: string;
 }
 export interface IConfig {
+    os: string;
     port?: string;
     repository?: string;
     description?: string;
@@ -62,3 +64,4 @@ export interface IConfigObj {
     confPath?: IConfigPath;
     address?: string;
 }
+export {};

package/lib/utils/SessionCommand.d.ts

@@ -1,5 +1,5 @@
-import BaseCommand from './BaseCommand';
-import { IConfigManager } from '../models/config-manager';
+import BaseCommand from "./BaseCommand";
+import { IConfigManager } from "../models/config-manager";
 export default class SessionCommand extends BaseCommand {
     session: any;
     configManager: IConfigManager | null;

package/lib/utils/SessionCommand.js

@@ -24,8 +24,8 @@ class SessionCommand extends BaseCommand_1.default {
             }
             else {
                 if (_private)
-                    throw errors_1.AuthError('You need to log in, run the following command to continue: $ learnpack login');
-                console_1.default.debug('No active session available', _private);
+                    throw errors_1.AuthError("You need to log in, run the following command to continue: $ learnpack login");
+                console_1.default.debug("No active session available", _private);
             }
         }
         catch (error) {
@@ -36,12 +36,8 @@ class SessionCommand extends BaseCommand_1.default {
         this.configManager = await index_1.default(flags);
     }
     async catch(err) {
-        console_1.default.debug('COMMAND CATCH', err);
+        console_1.default.debug("COMMAND CATCH", err);
         throw err;
     }
 }
 exports.default = SessionCommand;
-// SessionCommand.description = `Describe the command here
-// ...
-// Extra documentation goes here
-// `

package/lib/utils/api.js

@@ -214,6 +214,7 @@ const sendBatchTelemetry = async function (url, body) {
         body: JSON.stringify(body),
     }, false)
         .then(response => {
+        console_1.default.debug("Telemetry sent successfully");
         return response.text();
     })
         .catch(error => {

package/lib/utils/osOperations.d.ts

@@ -0,0 +1,5 @@
+declare const eventManager: {
+    enqueue: (event: string, data: any) => void;
+    checkXDGInstalled: () => Promise<boolean>;
+};
+export { eventManager };

package/lib/utils/osOperations.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventManager = void 0;
+const child_process_1 = require("child_process");
+const os = require("os");
+const path = require("path");
+const cli_ux_1 = require("cli-ux");
+const checkXDGInstalled = () => {
+    return new Promise((resolve, reject) => {
+        child_process_1.exec("which xdg-open", (error, stdout, stderr) => {
+            if (error) {
+                resolve(false);
+            }
+            if (stdout) {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+    });
+};
+const openFile = (filePath) => {
+    const fullPath = path.join(process.cwd(), filePath);
+    let command;
+    switch (os.platform()) {
+        case "darwin": // macOS
+            command = `open ${fullPath}`;
+            break;
+        case "win32": // Windows
+            command = `start ${fullPath}`;
+            break;
+        case "linux": // Linux
+            command = `xdg-open ${fullPath}`;
+            break;
+        default:
+            throw new Error("Unsupported OS");
+    }
+    child_process_1.exec(command, (error, stdout, stderr) => {
+        if (error) {
+            console.error(`exec error: ${error}`);
+        }
+    });
+};
+const eventManager = {
+    enqueue: (event, data) => {
+        if (event === "start_exercise") {
+            const exercise = data;
+            const filesToOpen = exercise.files
+                .filter((file) => !file.hidden)
+                .map((file) => {
+                return file.path.replace("\\", "/");
+            });
+            for (const file of filesToOpen) {
+                openFile(file);
+            }
+        }
+        if (event === "open_files") {
+            const files = data;
+            for (const file of files) {
+                const correctedPath = file.replace("\\", "/");
+                openFile(correctedPath);
+            }
+        }
+        if (event === "open_window") {
+            const url = data.url;
+            cli_ux_1.default.open(url);
+        }
+    },
+    checkXDGInstalled,
+};
+exports.eventManager = eventManager;

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"2.1.37","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":"[standalone, gitpod]","options":["standalone","gitpod"]},"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.39","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.37",
+  "version": "2.1.39",
   "author": "Alejandro Sanchez @alesanchezr",
   "bin": {
     "learnpack": "bin/run"
@@ -67,7 +67,6 @@
     "fs-extra": "^10.0.1",
     "globby": "^10.0.2",
     "husky": ">=6",
-    "learnpack-node": "^0.0.21",
     "lint-staged": ">=10",
     "mocha": "^5.2.0",
     "mock-fs": "^5.1.2",

package/src/commands/start.ts

@@ -16,6 +16,7 @@ import { prioritizeHTMLFile } from "../utils/misc"
 
 import { IGitpodData } from "../models/gitpod-data"
 import { IExercise, IExerciseData } from "../models/exercise-obj"
+import { eventManager } from "../utils/osOperations"
 
 export default class StartCommand extends SessionCommand {
   static description = "Runs a small server with all the exercise instructions"
@@ -37,8 +38,8 @@ export default class StartCommand extends SessionCommand {
     }),
     editor: flags.string({
       char: "e",
-      description: "[standalone, gitpod]",
-      options: ["standalone", "gitpod"],
+      description: "[preview, extension]",
+      options: ["extension", "preview"],
     }),
     version: flags.string({
       char: "v",
@@ -69,6 +70,8 @@ export default class StartCommand extends SessionCommand {
     const configObject = this.configManager?.get()
     const config = configObject?.config
 
+    const hasXDG = await eventManager.checkXDGInstalled()
+
     if (configObject) {
       const { config } = configObject
 
@@ -110,7 +113,11 @@ export default class StartCommand extends SessionCommand {
           this.configManager,
           process.env.NODE_ENV === "test"
         )
+        server.setMaxListeners(20)
+
+        // console.log(config, "this is the f*!shell.which("code")!shell.which("code")cking config");
 
+        // I should call a method to get the EventListener
         const dispatcher = queue.dispatcher({
           create: true,
           path: `${config.dirPath}/vscode_queue.json`,
@@ -148,13 +155,27 @@ export default class StartCommand extends SessionCommand {
 
           const files = prioritizeHTMLFile(data.files)
 
-          dispatcher.enqueue(dispatcher.events.OPEN_FILES, files)
+          if (config.editor.agent === "os") {
+            eventManager.enqueue(dispatcher.events.OPEN_FILES, files)
+          } else {
+            dispatcher.enqueue(dispatcher.events.OPEN_FILES, files)
+          }
+
           socket.ready("Ready to compile...")
         })
 
         socket.on("open_window", (data: IGitpodData) => {
           Console.debug("Opening window: ", data)
-          dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data)
+
+          if (
+            config.editor.agent === "os" &&
+            ((config.os === "linux" && hasXDG) || config.os !== "linux")
+          ) {
+            eventManager.enqueue(dispatcher.events.OPEN_WINDOW, data)
+          } else {
+            dispatcher.enqueue(dispatcher.events.OPEN_WINDOW, data)
+          }
+
           socket.ready("Ready to compile...")
         })
 
@@ -175,11 +196,6 @@ export default class StartCommand extends SessionCommand {
             setTimeout(() => socket.ready("Ready to compile..."), 2000)
           }
         })
-        // socket.on("preview", (data) => {
-        //   Console.debug("Preview triggered, removing the 'preview' action ")
-        //   socket.removeAllowed("preview")
-        //   socket.log('ready',['Ready to compile...'])
-        // })
 
         socket.on("build", async (data: IExerciseData) => {
           const exercise = this.configManager?.getExercise(data.exerciseSlug)
@@ -256,15 +272,11 @@ export default class StartCommand extends SessionCommand {
         })
 
         const terminate = () => {
-          Console.debug("Terminating Learnpack...")
-
+          Console.error("Terminating Learnpack...")
           TelemetryManager.submit()
-
-          server.terminate(() => {
-            this.configManager?.noCurrentExercise()
-            dispatcher.enqueue(dispatcher.events.END)
-            process.exit()
-          })
+          this.configManager?.noCurrentExercise()
+          dispatcher.enqueue(dispatcher.events.END)
+          process.exit()
         }
 
         server.on("close", terminate)

package/src/managers/config/defaults.ts

@@ -1,10 +1,14 @@
+import * as os from "os"
 export default {
   config: {
     port: 3000,
+    os: (function () {
+      return os.platform()
+    })(),
     editor: {
-      mode: null, // [standalone, preview]
-      agent: null, // [vscode, gitpod, localhost, codespaces] TODO: We need to check if we are in codespaces
-      version: null,
+      mode: null, // [extension, preview]
+      agent: null, // ["vscode", "os"] ("os" is the agent when running outside a coding editor
+      version: null, // By default downloads the latest version
     },
     dirPath: "./.learn",
     configPath: "./learn.json",

package/src/managers/config/index.ts

@@ -29,6 +29,12 @@ 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
@@ -58,7 +64,7 @@ const getGitpodAddress = () => {
 }
 
 const getCodespacesNamespace = () => {
-  // https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
+  // Example: https://orange-rotary-phone-wxpg49q5gcg4rp-3000.app.github.dev
 
   const codespace_name = shell
     .exec("echo $CODESPACE_NAME", { silent: true })
@@ -84,13 +90,12 @@ export default async ({
   version,
 }: IConfigManagerAttributes): Promise<IConfigManager> => {
   const confPath = getConfigPath()
-
   Console.debug("This is the config path: ", confPath)
 
   let configObj: IConfigObj = {}
 
   if (confPath) {
-    const bcContent = fs.readFileSync(confPath.config)
+    const learnJsonContent = fs.readFileSync(confPath.config)
     let hiddenBcContent = {}
     if (fs.existsSync(confPath.base + "/config.json")) {
       hiddenBcContent = fs.readFileSync(confPath.base + "/config.json")
@@ -101,7 +106,8 @@ export default async ({
         )
     }
 
-    const jsonConfig = JSON.parse(`${bcContent}`)
+    const jsonConfig = JSON.parse(`${learnJsonContent}`)
+
     if (!jsonConfig)
       throw new Error(`Invalid ${confPath.config} syntax: Unable to parse.`)
 
@@ -121,7 +127,7 @@ export default async ({
     })
   } else {
     throw ValidationError(
-      "No learn.json file has been found, make sure you are in the folder"
+      "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"
     )
   }
 
@@ -131,10 +137,10 @@ export default async ({
       configPath: confPath.config,
     },
   })
+  if (!configObj.config) 
+throw InternalError("Config object not found")
 
-  if (configObj.config) {
-    configObj.config.outputPath = confPath.base + "/dist"
-  }
+  configObj.config.outputPath = confPath.base + "/dist"
 
   Console.debug("This is your configuration object: ", {
     ...configObj,
@@ -145,7 +151,6 @@ export default async ({
 
   // auto detect agent (if possible)
   const codespaces_workspace = getCodespacesNamespace()
-
   Console.debug("This is the codespace namespace: ", codespaces_workspace)
 
   Console.debug(
@@ -155,55 +160,52 @@ export default async ({
 
   if (shell.which("gp") && configObj && configObj.config) {
     Console.debug("Gitpod detected")
-    configObj.config.editor.agent = "vscode"
     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.config.editor.agent = "vscode"
-
     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 if (configObj.config && !configObj.config.editor.agent) {
-  } else if (configObj.config) {
-    Console.debug("Localhost detected")
-    configObj.config.editor.agent = "localhost"
+    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}`
   }
 
-  Console.debug("This is the agent later", configObj?.config?.editor.agent)
+  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}`
 
-  // Assign default editor mode if not set already
-  if (configObj.config && !mode) {
+  if (configObj.config && !configObj.config.editor.mode && mode) {
     configObj.config.editor.mode = mode as TMode
   }
 
-  if (configObj.config && !configObj.config.editor.mode)
+  if (!configObj.config.editor.mode) {
     configObj.config.editor.mode =
-      configObj.config.editor.agent === "localhost" ? "standalone" : "preview"
+      configObj.config.editor.agent === "vscode" ? "extension" : "preview"
+  }
 
-  if (version && configObj.config) 
+  if (version) 
 configObj.config.editor.version = version
-  else if (configObj.config && configObj.config.editor.version === null) {
+  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.0.20"
+    configObj.config.editor.version = packageJSON.version || "3.1.22"
   }
 
-  if (configObj.config) {
-    configObj.config.dirPath = "./" + confPath.base
-    configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
-  }
+  configObj.config.dirPath = "./" + confPath.base
+  configObj.config.exercisesPath = getExercisesPath(confPath.base) || "./"
 
   return {
     validLanguages: {},
@@ -237,6 +239,7 @@ 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,
       })

package/src/managers/server/index.ts

@@ -46,7 +46,8 @@ server = require("http").Server(app)
       )
       Console.success(`\n            Open the exercise on this link:`)
       Console.log(`            ${config?.publicUrl}`)
-      if (config?.editor.mode === "standalone") 
+
+      if (config?.editor.mode === "preview") 
 cli.open(`${config.publicUrl}`)
     }
   })
@@ -67,7 +68,6 @@ cli.open(`${config.publicUrl}`)
   server.terminate = (callback: void) => {
     for (const socket of sockets) {
       socket.destroy()
-
       sockets.delete(socket)
     }
 

package/src/managers/server/routes.ts

@@ -12,6 +12,7 @@ import { IConfigManager } from "../../models/config-manager"
 import { IExercise } from "../../models/exercise-obj"
 import SessionManager from "../../managers/session"
 import TelemetryManager from "../telemetry"
+import { eventManager } from "../../utils/osOperations"
 
 const withHandler =
   (func: (req: express.Request, res: express.Response) => void) =>
@@ -194,7 +195,11 @@ export default async function (
         TelemetryManager.registerStepEvent(exercise.position, "open_step", {})
       }
 
-      dispatcher.enqueue(dispatcher.events.START_EXERCISE, req.params.slug)
+      if (configObject.config?.editor.agent === "os") {
+        eventManager.enqueue(dispatcher.events.START_EXERCISE, exercise)
+      } else {
+        dispatcher.enqueue(dispatcher.events.START_EXERCISE, req.params.slug)
+      }
 
       type TEntry = "python3" | "html" | "node" | "react" | "java";
 
@@ -279,7 +284,6 @@ export default async function (
       }
 
       socket.log("ready")
-
       res.json(exercise)
     })
   )

package/src/managers/telemetry.ts

@@ -1,5 +1,7 @@
 import { IFile } from "../models/file"
 import API from "../utils/api"
+import Console from "../utils/console"
+
 const fs = require("fs")
 
 function createUUID(): string {
@@ -112,7 +114,7 @@ const TelemetryManager: ITelemetryManager = {
   urls: {},
   configPath: "",
   salute: message => {
-    console.log(message)
+    Console.info(message)
   },
 
   start: function (agent, steps, path, tutorialSlug) {
@@ -143,7 +145,7 @@ const TelemetryManager: ITelemetryManager = {
           this.submit()
         })
         .catch(error => {
-          console.error(error)
+          Console.debug(error)
         })
     }
   },
@@ -293,6 +295,8 @@ const TelemetryManager: ITelemetryManager = {
     })
   },
   submit: async function () {
+    Console.debug("Submitting telemetry...")
+
     if (!this.current) 
 return Promise.resolve()
     const url = this.urls.batch

package/src/models/config.ts

@@ -3,7 +3,7 @@ import { TTelemetryUrls } from "../managers/telemetry"
 
 export type TGrading = "isolated" | "incremental" | "no-grading";
 
-export type TMode = "preview" | "standalone";
+export type TMode = "preview" | "extension";
 
 export type TConfigAction =
   | "test"
@@ -26,10 +26,12 @@ export interface IConfigPath {
   base: string;
 }
 
+type TAgent = "vscode" | "os";
+
 export interface IEditor {
   mode?: TMode;
   version: string;
-  agent?: string;
+  agent?: TAgent;
 }
 
 export interface TEntries {
@@ -41,6 +43,7 @@ export interface TEntries {
 }
 
 export interface IConfig {
+  os: string;
   port?: string;
   repository?: string;
   description?: string;

package/src/utils/SessionCommand.ts

@@ -1,10 +1,10 @@
 // import { flags } from "@oclif/command";
-import BaseCommand from './BaseCommand'
-import Console from './console'
-import SessionManager from '../managers/session'
-import configManager from '../managers/config/index'
-import {AuthError} from './errors'
-import {IConfigManager} from '../models/config-manager'
+import BaseCommand from "./BaseCommand"
+import Console from "./console"
+import SessionManager from "../managers/session"
+import configManager from "../managers/config/index"
+import { AuthError } from "./errors"
+import { IConfigManager } from "../models/config-manager"
 
 export default class SessionCommand extends BaseCommand {
   session: any = null
@@ -23,9 +23,9 @@ export default class SessionCommand extends BaseCommand {
       } else {
         if (_private)
           throw AuthError(
-            'You need to log in, run the following command to continue: $ learnpack login',
+            "You need to log in, run the following command to continue: $ learnpack login"
           )
-        Console.debug('No active session available', _private)
+        Console.debug("No active session available", _private)
       }
     } catch (error) {
       Console.error((error as TypeError).message)
@@ -37,12 +37,7 @@ export default class SessionCommand extends BaseCommand {
   }
 
   async catch(err: any) {
-    Console.debug('COMMAND CATCH', err)
+    Console.debug("COMMAND CATCH", err)
     throw err
   }
 }
-
-// SessionCommand.description = `Describe the command here
-// ...
-// Extra documentation goes here
-// `

package/src/utils/api.ts

@@ -252,6 +252,7 @@ const sendBatchTelemetry = async function (url: string, body: object) {
     false
   )
     .then(response => {
+      Console.debug("Telemetry sent successfully")
       return response.text()
     })
     .catch(error => {

package/src/utils/osOperations.ts

@@ -0,0 +1,79 @@
+import { exec } from "child_process"
+import * as os from "os"
+import * as path from "path"
+import cli from "cli-ux"
+
+const checkXDGInstalled = (): Promise<boolean> => {
+  return new Promise((resolve, reject) => {
+    exec("which xdg-open", (error, stdout, stderr) => {
+      if (error) {
+        resolve(false)
+      }
+
+      if (stdout) {
+        resolve(true)
+      } else {
+        resolve(false)
+      }
+    })
+  })
+}
+
+const openFile = (filePath: string): void => {
+  const fullPath = path.join(process.cwd(), filePath)
+  let command: string
+
+  switch (os.platform()) {
+    case "darwin": // macOS
+      command = `open ${fullPath}`
+      break
+    case "win32": // Windows
+      command = `start ${fullPath}`
+      break
+    case "linux": // Linux
+      command = `xdg-open ${fullPath}`
+      break
+    default:
+      throw new Error("Unsupported OS")
+  }
+
+  exec(command, (error, stdout, stderr) => {
+    if (error) {
+      console.error(`exec error: ${error}`)
+    }
+  })
+}
+
+const eventManager = {
+  enqueue: (event: string, data: any) => {
+    if (event === "start_exercise") {
+      const exercise = data
+      const filesToOpen = exercise.files
+        .filter((file: any) => !file.hidden)
+        .map((file: any) => {
+          return file.path.replace("\\", "/")
+        })
+
+      for (const file of filesToOpen) {
+        openFile(file)
+      }
+    }
+
+    if (event === "open_files") {
+      const files = data
+
+      for (const file of files) {
+        const correctedPath = file.replace("\\", "/")
+        openFile(correctedPath)
+      }
+    }
+
+    if (event === "open_window") {
+      const url = data.url
+      cli.open(url)
+    }
+  },
+  checkXDGInstalled,
+}
+
+export { eventManager }