@learnpack/learnpack 5.0.3 → 5.0.5

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @learnpack/learnpack
 $ learnpack COMMAND
 running command...
 $ learnpack (-v|--version|version)
-@learnpack/learnpack/5.0.3 win32-x64 node-v20.16.0
+@learnpack/learnpack/5.0.5 win32-x64 node-v20.16.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/v5.0.3/src\commands\audit.ts)_
+_See code: [src\commands\audit.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/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/v5.0.3/src\commands\clean.ts)_
+_See code: [src\commands\clean.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/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/v5.0.3/src\commands\download.ts)_
+_See code: [src\commands\download.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/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/v5.0.3/src\commands\init.ts)_
+_See code: [src\commands\init.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/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/v5.0.3/src\commands\login.ts)_
+_See code: [src\commands\login.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/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/v5.0.3/src\commands\logout.ts)_
+_See code: [src\commands\logout.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/src\commands\logout.ts)_
 
 ## `learnpack plugins`
 
@@ -305,7 +305,7 @@ OPTIONS
   -h, --help  show CLI help
 ```
 
-_See code: [src\commands\publish.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.3/src\commands\publish.ts)_
+_See code: [src\commands\publish.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/src\commands\publish.ts)_
 
 ## `learnpack start`
 
@@ -326,7 +326,7 @@ OPTIONS
   -w, --watch                         Watch for file changes
 ```
 
-_See code: [src\commands\start.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.3/src\commands\start.ts)_
+_See code: [src\commands\start.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/src\commands\start.ts)_
 
 ## `learnpack test [EXERCISESLUG]`
 
@@ -340,7 +340,7 @@ ARGUMENTS
   EXERCISESLUG  The name of the exercise to test
 ```
 
-_See code: [src\commands\test.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.3/src\commands\test.ts)_
+_See code: [src\commands\test.ts](https://github.com/learnpack/learnpack-cli/blob/v5.0.5/src\commands\test.ts)_
 <!-- commandsstop -->
 
 > > > > > > > 0cb3e56d84c197f9d008836bb573eade212b7e57

package/lib/commands/publish.js

@@ -13,6 +13,8 @@ const FormData = require("form-data");
 const console_1 = require("../utils/console");
 const file_1 = require("../managers/file");
 const RIGOBOT_HOST = "https://rigobot.herokuapp.com";
+// const RIGOBOT_HOST =
+//   "https://8000-charlytoc-rigobot-bmwdeam7cev.ws-us116.gitpod.io"
 const uploadZipEndpont = RIGOBOT_HOST + "/v1/learnpack/upload";
 class BuildCommand extends SessionCommand_1.default {
     async init() {
@@ -72,13 +74,13 @@ class BuildCommand extends SessionCommand_1.default {
         else {
             this.error("config.json not found");
         }
-        // Copy .learn/assets directory
+        // Copy .learn/assets directory, if it exists else create it
         const assetsDir = path.join(process.cwd(), ".learn", "assets");
         if (fs.existsSync(assetsDir)) {
             this.copyDirectory(assetsDir, path.join(buildDir, ".learn", "assets"));
         }
         else {
-            this.error(".learn/assets directory not found");
+            fs.mkdirSync(path.join(buildDir, ".learn", "assets"), { recursive: true });
         }
         // Copy .learn/_app directory files to the same level as config.json
         const appDir = path.join(process.cwd(), ".learn", "_app");
@@ -88,6 +90,27 @@ class BuildCommand extends SessionCommand_1.default {
         else {
             this.error(".learn/_app directory not found");
         }
+        // After copying the _app directory
+        const indexHtmlPath = path.join(appDir, "index.html");
+        const buildIndexHtmlPath = path.join(buildDir, "index.html");
+        if (fs.existsSync(indexHtmlPath)) {
+            let indexHtmlContent = fs.readFileSync(indexHtmlPath, "utf-8");
+            const description = learnJson.description.us || "LearnPack is awesome!";
+            const title = learnJson.title.us || "LearnPack: Interactive Learning as a Service";
+            const previewUrl = learnJson.preview ||
+                "https://raw.githubusercontent.com/learnpack/ide/refs/heads/master/public/learnpack.svg";
+            // Replace placeholders and the <title>Old title </title> tag for a new tag with the title
+            indexHtmlContent = indexHtmlContent
+                .replace(/{{description}}/g, description)
+                .replace(/<title>.*<\/title>/, `<title>${title}</title>`)
+                .replace(/{{title}}/g, title)
+                .replace(/{{preview}}/g, previewUrl);
+            // Write the modified content to the build directory
+            fs.writeFileSync(buildIndexHtmlPath, indexHtmlContent);
+        }
+        else {
+            this.error("index.html not found in _app directory");
+        }
         // Copy exercises directory
         const exercisesDir = path.join(process.cwd(), "exercises");
         const learnExercisesDir = path.join(process.cwd(), ".learn", "exercises");
@@ -110,8 +133,8 @@ class BuildCommand extends SessionCommand_1.default {
         output.on("close", async () => {
             this.log(`Build completed: ${zipFilePath} (${archive.pointer()} total bytes)`);
             // Remove build directory after zip is created
-            this.removeDirectory(buildDir);
-            console.log("Zip file saved in project root");
+            // this.removeDirectory(buildDir)
+            console_1.default.debug("Zip file saved in project root");
             const formData = new FormData();
             formData.append("file", fs.createReadStream(zipFilePath));
             formData.append("config", JSON.stringify(learnJson));
@@ -120,6 +143,8 @@ class BuildCommand extends SessionCommand_1.default {
                     headers: Object.assign(Object.assign({}, formData.getHeaders()), { Authorization: `Token ${rigoToken}` }),
                 });
                 console.log(res.data);
+                // Remove the zip file after uploading
+                fs.unlinkSync(zipFilePath);
             }
             catch (error) {
                 if (axios_1.default.isAxiosError(error)) {
@@ -130,12 +155,13 @@ class BuildCommand extends SessionCommand_1.default {
                         console.error(error.response.data.error);
                     }
                     else {
-                        console.error("Error uploading file:", error.message);
+                        console.error("Error uploading file:", error);
                     }
                 }
                 else {
                     console.error("Error uploading file:", error);
                 }
+                fs.unlinkSync(zipFilePath);
             }
         });
         archive.on("error", (err) => {

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"5.0.3","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":"Builds the project by copying necessary files and directories into a zip file","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"help":{"name":"help","type":"boolean","char":"h","description":"show CLI help","allowNo":false}},"args":[]},"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":"5.0.5","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":"Builds the project by copying necessary files and directories into a zip file","pluginName":"@learnpack/learnpack","pluginType":"core","aliases":[],"flags":{"help":{"name":"help","type":"boolean","char":"h","description":"show CLI help","allowNo":false}},"args":[]},"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": "Seamlessly build, sell and/or take interactive & auto-graded tutorials, start learning now or build a new tutorial to your audience.",
-  "version": "5.0.3",
+  "version": "5.0.5",
   "author": "Alejandro Sanchez @alesanchezr",
   "contributors": [
     {

package/src/commands/publish.ts

@@ -16,6 +16,8 @@ import {
 } from "../managers/file"
 
 const RIGOBOT_HOST = "https://rigobot.herokuapp.com"
+// const RIGOBOT_HOST =
+//   "https://8000-charlytoc-rigobot-bmwdeam7cev.ws-us116.gitpod.io"
 const uploadZipEndpont = RIGOBOT_HOST + "/v1/learnpack/upload"
 
 export default class BuildCommand extends SessionCommand {
@@ -100,12 +102,12 @@ export default class BuildCommand extends SessionCommand {
       this.error("config.json not found")
     }
 
-    // Copy .learn/assets directory
+    // Copy .learn/assets directory, if it exists else create it
     const assetsDir = path.join(process.cwd(), ".learn", "assets")
     if (fs.existsSync(assetsDir)) {
       this.copyDirectory(assetsDir, path.join(buildDir, ".learn", "assets"))
     } else {
-      this.error(".learn/assets directory not found")
+      fs.mkdirSync(path.join(buildDir, ".learn", "assets"), { recursive: true })
     }
 
     // Copy .learn/_app directory files to the same level as config.json
@@ -116,6 +118,33 @@ export default class BuildCommand extends SessionCommand {
       this.error(".learn/_app directory not found")
     }
 
+    // After copying the _app directory
+    const indexHtmlPath = path.join(appDir, "index.html")
+    const buildIndexHtmlPath = path.join(buildDir, "index.html")
+
+    if (fs.existsSync(indexHtmlPath)) {
+      let indexHtmlContent = fs.readFileSync(indexHtmlPath, "utf-8")
+
+      const description = learnJson.description.us || "LearnPack is awesome!"
+      const title =
+        learnJson.title.us || "LearnPack: Interactive Learning as a Service"
+
+      const previewUrl =
+        learnJson.preview ||
+        "https://raw.githubusercontent.com/learnpack/ide/refs/heads/master/public/learnpack.svg"
+      // Replace placeholders and the <title>Old title </title> tag for a new tag with the title
+      indexHtmlContent = indexHtmlContent
+        .replace(/{{description}}/g, description)
+        .replace(/<title>.*<\/title>/, `<title>${title}</title>`)
+        .replace(/{{title}}/g, title)
+        .replace(/{{preview}}/g, previewUrl)
+
+      // Write the modified content to the build directory
+      fs.writeFileSync(buildIndexHtmlPath, indexHtmlContent)
+    } else {
+      this.error("index.html not found in _app directory")
+    }
+
     // Copy exercises directory
     const exercisesDir = path.join(process.cwd(), "exercises")
     const learnExercisesDir = path.join(process.cwd(), ".learn", "exercises")
@@ -142,8 +171,8 @@ export default class BuildCommand extends SessionCommand {
         `Build completed: ${zipFilePath} (${archive.pointer()} total bytes)`
       )
       // Remove build directory after zip is created
-      this.removeDirectory(buildDir)
-      console.log("Zip file saved in project root")
+      // this.removeDirectory(buildDir)
+      Console.debug("Zip file saved in project root")
 
       const formData = new FormData()
       formData.append("file", fs.createReadStream(zipFilePath))
@@ -157,6 +186,8 @@ export default class BuildCommand extends SessionCommand {
           },
         })
         console.log(res.data)
+        // Remove the zip file after uploading
+        fs.unlinkSync(zipFilePath)
       } catch (error) {
         if (axios.isAxiosError(error)) {
           if (error.response && error.response.status === 403) {
@@ -164,11 +195,13 @@ export default class BuildCommand extends SessionCommand {
           } else if (error.response && error.response.status === 400) {
             console.error(error.response.data.error)
           } else {
-            console.error("Error uploading file:", error.message)
+            console.error("Error uploading file:", error)
           }
         } else {
           console.error("Error uploading file:", error)
         }
+
+        fs.unlinkSync(zipFilePath)
       }
     })
 

package/src/managers/telemetry.ts

@@ -1,353 +1,353 @@
-import { IFile } from "../models/file"
-import API from "../utils/api"
-import Console from "../utils/console"
-
-const fs = require("fs")
-
-function createUUID(): string {
-  return (
-    Math.random().toString(36).slice(2, 10) +
-    Math.random().toString(36).slice(2, 10)
-  )
-}
-
-function stringToBase64(input: string): string {
-  return Buffer.from(input).toString("base64")
-}
-
-type TCompilationAttempt = {
-  source_code: string;
-  stdout: string;
-  exit_code: number;
-  starting_at: number;
-  ending_at: number;
-};
-
-type TTestAttempt = {
-  source_code: string;
-  stdout: string;
-  exit_code: number;
-  starting_at: number;
-  ending_at: number;
-};
-
-type TAIInteraction = {
-  student_message: string;
-  source_code: string;
-  ai_response: string;
-  starting_at: number;
-  ending_at: number;
-};
-
-export type TStep = {
-  slug: string;
-  position: number;
-  files: IFile[];
-  is_testeable: boolean;
-  opened_at?: number; // The time when the step was opened
-  completed_at?: number; // If the step has tests, the time when all the tests passed, else, the time when the user opens the next step
-  compilations: TCompilationAttempt[]; // Everytime the user tries to compile the code
-  tests: TTestAttempt[]; // Everytime the user tries to run the tests
-  ai_interactions: TAIInteraction[]; // Everytime the user interacts with the AI
-};
-
-type TWorkoutSession = {
-  started_at: number;
-  ended_at?: number;
-};
-
-type TStudent = {
-  token: string;
-  user_id: string;
-  email: string;
-};
-
-export interface ITelemetryJSONSchema {
-  telemetry_id?: string;
-  user_id?: number | string;
-  slug: string;
-  agent?: string;
-  tutorial_started_at?: number;
-  last_interaction_at?: number;
-  steps: Array<TStep>; // The steps should be the same as the exercise
-  workout_session: TWorkoutSession[]; // It start when the user starts Learnpack, if the last_interaction_at is available, it automatically fills with that
-  // number and start another session
-}
-
-type TStepEvent = "compile" | "test" | "ai_interaction" | "open_step";
-
-export type TTelemetryUrls = {
-  streaming?: string;
-  batch?: string;
-};
-
-interface ITelemetryManager {
-  current: ITelemetryJSONSchema | null;
-  configPath: string | null;
-  urls: TTelemetryUrls;
-  salute: (message: string) => void;
-  start: (
-    agent: string,
-    steps: TStep[],
-    path: string,
-    tutorialSlug: string
-  ) => void;
-  prevStep?: number;
-  registerStepEvent: (
-    stepPosition: number,
-    event: TStepEvent,
-    data: any
-  ) => void;
-  streamEvent: (stepPosition: number, event: string, data: any) => void;
-  submit: () => Promise<void>;
-  finishWorkoutSession: () => void;
-  setStudent: (student: TStudent) => void;
-  save: () => void;
-  retrieve: () => Promise<ITelemetryJSONSchema | null>;
-}
-
-const TelemetryManager: ITelemetryManager = {
-  current: null,
-  urls: {},
-  configPath: "",
-  salute: message => {
-    Console.info(message)
-  },
-
-  start: function (agent, steps, path, tutorialSlug) {
-    this.configPath = path
-    if (!this.current) {
-      this.retrieve()
-        .then(data => {
-          const prevTelemetry = data
-          if (prevTelemetry) {
-            this.current = prevTelemetry
-            this.finishWorkoutSession()
-          } else {
-            this.current = {
-              telemetry_id: createUUID(),
-              slug: tutorialSlug,
-              agent,
-              tutorial_started_at: Date.now(),
-              steps,
-              workout_session: [
-                {
-                  started_at: Date.now(),
-                },
-              ],
-            }
-          }
-
-          this.save()
-          this.submit()
-        })
-        .catch(error => {
-          Console.debug(error)
-          // Delete the telemetry.json if it exists
-          fs.unlinkSync(`${this.configPath}/telemetry.json`)
-          throw new Error(
-            "There was a problem starting, reload LearnPack\nRun\n$ learnpack start"
-          )
-        })
-    }
-  },
-  // verifyStudent: function () {
-  //   if (!this.current) {
-  //     return;
-  //   }
-
-  //   if (!this.current.user_id) {
-
-  //   }
-  // },
-
-  setStudent: function (student) {
-    if (!this.current) {
-      return
-    }
-
-    this.current.user_id = student.user_id
-    this.save()
-    this.submit()
-  },
-  finishWorkoutSession: function () {
-    if (!this.current) {
-      return
-    }
-
-    const lastSession =
-      this.current?.workout_session[this.current.workout_session.length - 1]
-    if (
-      lastSession &&
-      !lastSession.ended_at &&
-      this.current?.last_interaction_at
-    ) {
-      lastSession.ended_at = this.current.last_interaction_at
-      this.current.workout_session.push({
-        started_at: Date.now(),
-      })
-    }
-  },
-
-  registerStepEvent: function (stepPosition, event, data) {
-    if (!this.current) {
-      // throw new Error("Telemetry has not been started");
-      return
-    }
-
-    const step = this.current.steps[stepPosition]
-    if (!step) {
-      return
-    }
-
-    if (data.source_code) {
-      data.source_code = stringToBase64(data.source_code)
-    }
-
-    if (data.stdout) {
-      data.stdout = stringToBase64(data.stdout)
-    }
-
-    if (data.stderr) {
-      data.stderr = stringToBase64(data.stderr)
-    }
-
-    if (Object.prototype.hasOwnProperty.call(data, "exitCode")) {
-      data.exit_code = data.exitCode
-      data.exitCode = undefined
-    }
-
-    switch (event) {
-      case "compile":
-        if (!step.compilations) {
-          step.compilations = []
-        }
-
-        step.compilations.push(data)
-        this.current.steps[stepPosition] = step
-        break
-      case "test":
-        if (!step.tests) {
-          step.tests = []
-        }
-
-        // data.stdout =
-        step.tests.push(data)
-        if (data.exit_code === 0) {
-          step.completed_at = Date.now()
-        }
-
-        this.current.steps[stepPosition] = step
-        break
-      case "ai_interaction":
-        if (!step.ai_interactions) {
-          step.ai_interactions = []
-        }
-
-        step.ai_interactions.push(data)
-        break
-      case "open_step": {
-        const now = Date.now()
-
-        if (!step.opened_at) {
-          step.opened_at = now
-          this.current.steps[stepPosition] = step
-        }
-
-        if (this.prevStep || this.prevStep === 0) {
-          const prevStep = this.current.steps[this.prevStep]
-          if (!prevStep.is_testeable && !prevStep.completed_at) {
-            prevStep.completed_at = now
-            this.current.steps[this.prevStep] = prevStep
-          }
-        }
-
-        this.prevStep = stepPosition
-
-        this.submit()
-        break
-      }
-
-      default:
-        throw new Error(`Event type ${event} is not supported`)
-    }
-
-    this.current.last_interaction_at = Date.now()
-    this.streamEvent(stepPosition, event, data)
-    this.save()
-  },
-  retrieve: function () {
-    return new Promise((resolve, reject) => {
-      fs.readFile(
-        `${this.configPath}/telemetry.json`,
-        "utf8",
-        (err: any, data: any) => {
-          if (err) {
-            if (err.code === "ENOENT") {
-              // File does not exist, resolve with undefined
-              resolve(null)
-            } else {
-              reject(err)
-            }
-          } else {
-            try {
-              resolve(JSON.parse(data))
-            } catch (error) {
-              reject(error)
-            }
-          }
-        }
-      )
-    })
-  },
-
-  submit: async function () {
-    Console.debug("Submitting telemetry...")
-
-    if (!this.current) 
-return Promise.resolve()
-    const url = this.urls.batch
-    if (!url) {
-      return
-    }
-
-    const body = this.current
-
-    API.sendBatchTelemetry(url, body)
-  },
-  save: function () {
-    fs.writeFile(
-      `${this.configPath}/telemetry.json`,
-      JSON.stringify(this.current),
-      (err: any) => {
-        if (err) 
-throw err
-      }
-    )
-  },
-
-  streamEvent: async function (stepPosition, event, data) {
-    if (!this.current) 
-return
-
-    const url = this.urls.streaming
-    if (!url) {
-      return
-    }
-
-    const stepSlug = this.current.steps[stepPosition].slug
-
-    const body = {
-      slug: stepSlug,
-      telemetry_id: this.current.telemetry_id,
-      user_id: this.current.user_id,
-      step_position: stepPosition,
-      event,
-      data,
-    }
-
-    API.sendStreamTelemetry(url, body)
-  },
-}
-
-export default TelemetryManager
+import { IFile } from "../models/file"
+import API from "../utils/api"
+import Console from "../utils/console"
+
+const fs = require("fs")
+
+function createUUID(): string {
+  return (
+    Math.random().toString(36).slice(2, 10) +
+    Math.random().toString(36).slice(2, 10)
+  )
+}
+
+function stringToBase64(input: string): string {
+  return Buffer.from(input).toString("base64")
+}
+
+type TCompilationAttempt = {
+  source_code: string;
+  stdout: string;
+  exit_code: number;
+  starting_at: number;
+  ending_at: number;
+};
+
+type TTestAttempt = {
+  source_code: string;
+  stdout: string;
+  exit_code: number;
+  starting_at: number;
+  ending_at: number;
+};
+
+type TAIInteraction = {
+  student_message: string;
+  source_code: string;
+  ai_response: string;
+  starting_at: number;
+  ending_at: number;
+};
+
+export type TStep = {
+  slug: string;
+  position: number;
+  files: IFile[];
+  is_testeable: boolean;
+  opened_at?: number; // The time when the step was opened
+  completed_at?: number; // If the step has tests, the time when all the tests passed, else, the time when the user opens the next step
+  compilations: TCompilationAttempt[]; // Everytime the user tries to compile the code
+  tests: TTestAttempt[]; // Everytime the user tries to run the tests
+  ai_interactions: TAIInteraction[]; // Everytime the user interacts with the AI
+};
+
+type TWorkoutSession = {
+  started_at: number;
+  ended_at?: number;
+};
+
+type TStudent = {
+  token: string;
+  user_id: string;
+  email: string;
+};
+
+export interface ITelemetryJSONSchema {
+  telemetry_id?: string;
+  user_id?: number | string;
+  slug: string;
+  agent?: string;
+  tutorial_started_at?: number;
+  last_interaction_at?: number;
+  steps: Array<TStep>; // The steps should be the same as the exercise
+  workout_session: TWorkoutSession[]; // It start when the user starts Learnpack, if the last_interaction_at is available, it automatically fills with that
+  // number and start another session
+}
+
+type TStepEvent = "compile" | "test" | "ai_interaction" | "open_step";
+
+export type TTelemetryUrls = {
+  streaming?: string;
+  batch?: string;
+};
+
+interface ITelemetryManager {
+  current: ITelemetryJSONSchema | null;
+  configPath: string | null;
+  urls: TTelemetryUrls;
+  salute: (message: string) => void;
+  start: (
+    agent: string,
+    steps: TStep[],
+    path: string,
+    tutorialSlug: string
+  ) => void;
+  prevStep?: number;
+  registerStepEvent: (
+    stepPosition: number,
+    event: TStepEvent,
+    data: any
+  ) => void;
+  streamEvent: (stepPosition: number, event: string, data: any) => void;
+  submit: () => Promise<void>;
+  finishWorkoutSession: () => void;
+  setStudent: (student: TStudent) => void;
+  save: () => void;
+  retrieve: () => Promise<ITelemetryJSONSchema | null>;
+}
+
+const TelemetryManager: ITelemetryManager = {
+  current: null,
+  urls: {},
+  configPath: "",
+  salute: message => {
+    Console.info(message)
+  },
+
+  start: function (agent, steps, path, tutorialSlug) {
+    this.configPath = path
+    if (!this.current) {
+      this.retrieve()
+        .then(data => {
+          const prevTelemetry = data
+          if (prevTelemetry) {
+            this.current = prevTelemetry
+            this.finishWorkoutSession()
+          } else {
+            this.current = {
+              telemetry_id: createUUID(),
+              slug: tutorialSlug,
+              agent,
+              tutorial_started_at: Date.now(),
+              steps,
+              workout_session: [
+                {
+                  started_at: Date.now(),
+                },
+              ],
+            }
+          }
+
+          this.save()
+          this.submit()
+        })
+        .catch(error => {
+          Console.debug(error)
+          // Delete the telemetry.json if it exists
+          fs.unlinkSync(`${this.configPath}/telemetry.json`)
+          throw new Error(
+            "There was a problem starting, reload LearnPack\nRun\n$ learnpack start"
+          )
+        })
+    }
+  },
+  // verifyStudent: function () {
+  //   if (!this.current) {
+  //     return;
+  //   }
+
+  //   if (!this.current.user_id) {
+
+  //   }
+  // },
+
+  setStudent: function (student) {
+    if (!this.current) {
+      return
+    }
+
+    this.current.user_id = student.user_id
+    this.save()
+    this.submit()
+  },
+  finishWorkoutSession: function () {
+    if (!this.current) {
+      return
+    }
+
+    const lastSession =
+      this.current?.workout_session[this.current.workout_session.length - 1]
+    if (
+      lastSession &&
+      !lastSession.ended_at &&
+      this.current?.last_interaction_at
+    ) {
+      lastSession.ended_at = this.current.last_interaction_at
+      this.current.workout_session.push({
+        started_at: Date.now(),
+      })
+    }
+  },
+
+  registerStepEvent: function (stepPosition, event, data) {
+    if (!this.current) {
+      // throw new Error("Telemetry has not been started");
+      return
+    }
+
+    const step = this.current.steps[stepPosition]
+    if (!step) {
+      return
+    }
+
+    if (data.source_code) {
+      data.source_code = stringToBase64(data.source_code)
+    }
+
+    if (data.stdout) {
+      data.stdout = stringToBase64(data.stdout)
+    }
+
+    if (data.stderr) {
+      data.stderr = stringToBase64(data.stderr)
+    }
+
+    if (Object.prototype.hasOwnProperty.call(data, "exitCode")) {
+      data.exit_code = data.exitCode
+      data.exitCode = undefined
+    }
+
+    switch (event) {
+      case "compile":
+        if (!step.compilations) {
+          step.compilations = []
+        }
+
+        step.compilations.push(data)
+        this.current.steps[stepPosition] = step
+        break
+      case "test":
+        if (!step.tests) {
+          step.tests = []
+        }
+
+        // data.stdout =
+        step.tests.push(data)
+        if (data.exit_code === 0) {
+          step.completed_at = Date.now()
+        }
+
+        this.current.steps[stepPosition] = step
+        break
+      case "ai_interaction":
+        if (!step.ai_interactions) {
+          step.ai_interactions = []
+        }
+
+        step.ai_interactions.push(data)
+        break
+      case "open_step": {
+        const now = Date.now()
+
+        if (!step.opened_at) {
+          step.opened_at = now
+          this.current.steps[stepPosition] = step
+        }
+
+        if (this.prevStep || this.prevStep === 0) {
+          const prevStep = this.current.steps[this.prevStep]
+          if (!prevStep.is_testeable && !prevStep.completed_at) {
+            prevStep.completed_at = now
+            this.current.steps[this.prevStep] = prevStep
+          }
+        }
+
+        this.prevStep = stepPosition
+
+        this.submit()
+        break
+      }
+
+      default:
+        throw new Error(`Event type ${event} is not supported`)
+    }
+
+    this.current.last_interaction_at = Date.now()
+    this.streamEvent(stepPosition, event, data)
+    this.save()
+  },
+  retrieve: function () {
+    return new Promise((resolve, reject) => {
+      fs.readFile(
+        `${this.configPath}/telemetry.json`,
+        "utf8",
+        (err: any, data: any) => {
+          if (err) {
+            if (err.code === "ENOENT") {
+              // File does not exist, resolve with undefined
+              resolve(null)
+            } else {
+              reject(err)
+            }
+          } else {
+            try {
+              resolve(JSON.parse(data))
+            } catch (error) {
+              reject(error)
+            }
+          }
+        }
+      )
+    })
+  },
+
+  submit: async function () {
+    Console.debug("Submitting telemetry...")
+
+    if (!this.current) 
+return Promise.resolve()
+    const url = this.urls.batch
+    if (!url) {
+      return
+    }
+
+    const body = this.current
+
+    API.sendBatchTelemetry(url, body)
+  },
+  save: function () {
+    fs.writeFile(
+      `${this.configPath}/telemetry.json`,
+      JSON.stringify(this.current),
+      (err: any) => {
+        if (err) 
+throw err
+      }
+    )
+  },
+
+  streamEvent: async function (stepPosition, event, data) {
+    if (!this.current) 
+return
+
+    const url = this.urls.streaming
+    if (!url) {
+      return
+    }
+
+    const stepSlug = this.current.steps[stepPosition].slug
+
+    const body = {
+      slug: stepSlug,
+      telemetry_id: this.current.telemetry_id,
+      user_id: this.current.user_id,
+      step_position: stepPosition,
+      event,
+      data,
+    }
+
+    API.sendStreamTelemetry(url, body)
+  },
+}
+
+export default TelemetryManager