X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=lmno.js;h=5d4ca3e7b554025a2b367cf8aca6dae71945ec1b;hb=16564f558ee42c3fbc0ca5ee56c91407253747b5;hp=5d7d5687522a214c7c8a82633d74c8930eee45b2;hpb=eff8b40b8ee5bccc0990a49791365abb3b64b8b1;p=empires-server

diff --git a/lmno.js b/lmno.js
index 5d7d568..5d4ca3e 100644
--- a/lmno.js
+++ b/lmno.js
@@ -46,10 +46,42 @@ nunjucks.configure("templates", {
   express: app
 });
 
-/* Load each of our game mini-apps. */
+/* Load each of our game mini-apps.
+ *
+ * Each "engine" we load here must have a property .Game on the
+ * exports object that should be a class that extends the common base
+ * class Game.
+ *
+ * In turn, each engine's Game must have the following properties:
+ *
+ *     .meta:   An object with .name and .identifier properties.
+ *
+ *              Here, .name is a string giving a human-readable name
+ *              for the game, such as "Tic Tac Toe" while .identifier
+ *              is the short, single-word, all-lowercase identifier
+ *              that is used in the path of the URL, such as
+ *              "tictactoe".
+ *
+ *     .router: An express Router object
+ *
+ *              Any game-specific routes should already be on the
+ *              router. Then, LMNO will add common routes including:
+ *
+ *                 /        Serves <identifier>-game.html template
+ *
+ *                 /player  Allows client to set name or team
+ *
+ *                 /events  Serves a stream of events. Game can override
+ *                          the handle_events method, call super() first,
+ *                          and then have code to add custom events.
+ *
+ *                 /moves   Receives move data from clients. This route
+ *                          is only added if the Game class has an
+ *                          add_move method.
+ */
 const engines = {
-  empires: require("./empires"),
-  tictactoe: require("./tictactoe")
+  empires: require("./empires").Game,
+  tictactoe: require("./tictactoe").Game
 };
 
 class LMNO {
@@ -68,11 +100,11 @@ class LMNO {
 
     const engine = engines[engine_name];
 
-    const game = new engine.Game(id);
+    const game = new engine(id);
 
     this.games[id] = game;
 
-    return id;
+    return game;
   }
 }
 
@@ -108,8 +140,8 @@ function lmno_canonize(id) {
 
 app.post('/new/:game_engine', (request, response) =>  {
   const game_engine = request.params.game_engine;
-  const game_id = lmno.create_game(game_engine);
-  response.send(JSON.stringify(game_id));
+  const game = lmno.create_game(game_engine);
+  response.send(JSON.stringify(game.id));
 });
 
 /* Redirect any requests to a game ID at the top-level.
@@ -247,9 +279,10 @@ app.get('/admin/', auth_admin, (request, response) => {
 /* Mount sub apps. only _after_ we have done all the middleware we need. */
 for (let key in engines) {
   const engine = engines[key];
+  const router = engine.router;
 
   /* Add routes that are common to all games. */
-  engine.router.get('/', (request, response) => {
+  router.get('/', (request, response) => {
     const game = request.game;
 
     if (! request.session.nickname)
@@ -258,8 +291,40 @@ for (let key in engines) {
       response.render(`${game.meta.identifier}-game.html`);
   });
 
+  router.put('/player', (request, response) => {
+    const game = request.game;
+
+    game.handle_player(request, response);
+  });
+
+  router.get('/events', (request, response) => {
+    const game = request.game;
+
+    game.handle_events(request, response);
+  });
+
+  /* Further, add some routes conditionally depending on whether the
+   * engine provides specific, necessary methods for the routes. */
+  if (engine.prototype.add_move) {
+    router.post('/move', (request, response) => {
+      const game = request.game;
+      const move = request.body.move;
+
+      const result = game.add_move(move);
+
+      /* Feed move response back to the client. */
+      response.json(result);
+
+      /* And only if legal, inform all clients. */
+      if (! result.legal)
+        return;
+
+      game.broadcast_move(move);
+    });
+  }
+
   /* And mount the whole router at the path for the game. */
-  app.use(`/${engine.Game.meta.identifier}/[a-zA-Z0-9]{4}/`, engine.router);
+  app.use(`/${engine.meta.identifier}/[a-zA-Z0-9]{4}/`, router);
 }
 
 app.listen(4000, function () {