Things and støff

server/scenes/scene.js

@@ -1,11 +1,16 @@
 import { Session } from "../models/session.js";
 import { Prompt } from "./prompt.js";
-const MsgContext.ERROR_INSANE_PASSWORD = "Invalid password.";
-const MsgContext.ERROR_INCORRECT_PASSWOD = "Incorrect password.";
 
 /**
+ * Scene - a class for showing one or more prompts in a row.
+ *
+ * Scenes are mostly there to keep track of which prompt to show,
+ * and to store data for subsequent prompts to access.
+ *
+ * The prompts themselves are responsible for data validation and
+ * interpretation.
+ *
  * @abstract
- * @method onReady
  */
 export class Scene {
     /**
@@ -31,8 +36,7 @@ export class Scene {
         return this._prompt;
     }
 
-    constructor() {
-    }
+    constructor() {}
 
     /** @param {Session} session */
     execute(session) {
@@ -51,8 +55,73 @@ export class Scene {
     /**
      * @param {Prompt} prompt
      */
-    doPrompt(prompt) {
+    showPrompt(prompt) {
         this._prompt = prompt;
         prompt.execute();
     }
+
+    /** @param {new (scene: Scene) => Prompt} promptClassReference */
+    show(promptClassReference) {
+        this.showPrompt(new promptClassReference(this));
+    }
+
+    /**
+     * Triggered when a user types a :command that begins with a colon
+     * and the current Prompt cannot handle that command.
+     *
+     * @param {string} command
+     * @param {any[]} args
+     */
+    onColon(command, args) {
+        const propertyName = "onColon__" + command;
+        const property = this[propertyName];
+
+        //
+        // Default: we have no handler for the Foo command
+        if (property === undefined) {
+            this.session.sendError(`You cannot ${command.toUpperCase()} right now`, { verbatim: true }); // :foo ==> you cannot FOO right now
+            return;
+        }
+
+        //
+        // If the prompt has a method called onColon_foo() =>
+        if (typeof property === "function") {
+            property.call(this, args);
+            return;
+        }
+
+        //
+        // If the prompt has a _string_ called onColon_foo =>
+        if (typeof property === "string") {
+            this.session.sendText(property);
+            return;
+        }
+
+        //
+        // We found a property that has the right name but the wrong type.
+        throw new Error(
+            [
+                `Logic error. Scene has a handler for a command called ${command}`,
+                `but it is neither a function or a string, but a ${typeof property}`,
+            ].join(" "),
+        );
+    }
+
+    //
+    // Easter ægg
+    // Example dynamic colon handler
+    /** @param {any[]} args */
+    onColon__imperial(args) {
+        if (args.length === 0) {
+            this.session.sendText("The imperial system is the freeest system ever. Also the least good");
+        }
+
+        const n = Number(args[0]);
+
+        this.session.sendText(
+            sprintf("%.2f centimeters is only %.2f inches. This is american wands are so short!", n, n / 2.54),
+        );
+    }
+
+    onColon__hi = "Hoe";
 }