create-eigen-game 0.14.3 → 0.15.0

package/templates/app-overlay/web/eigen_offline_sw.js

@@ -0,0 +1,82 @@
+// The app shell's cache, so a game can be opened with no network.
+//
+// Flutter stopped generating a service worker in 2025, and the browser cache it
+// left behind is not a promise: it is evicted on its own terms and never
+// answers a cold start offline. Offline play needs the opposite guarantee, so
+// this worker is the app's own, small and readable rather than generated.
+//
+// Runtime caching, not a precache manifest. Flutter's build emits hashed file
+// names that a checked-in manifest would have to track release by release; what
+// this does instead is remember what the app actually asked for, which after one
+// online visit is exactly the shell.
+
+const CACHE = "eigen-shell-v1";
+
+// Never cached: the engine's own API and socket. They are the live truth, and a
+// stale answer from here would be worse than an honest failure the app already
+// knows how to render.
+const isApi = (url) => url.pathname.startsWith("/api/");
+
+self.addEventListener("install", (event) => {
+  // Take over as soon as this version is ready; there is no migration to stage.
+  event.waitUntil(self.skipWaiting());
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    (async () => {
+      const names = await caches.keys();
+      await Promise.all(names.filter((name) => name !== CACHE).map((name) => caches.delete(name)));
+      await self.clients.claim();
+    })(),
+  );
+});
+
+self.addEventListener("fetch", (event) => {
+  const request = event.request;
+  if (request.method !== "GET") return;
+  const url = new URL(request.url);
+  if (url.origin !== self.location.origin || isApi(url)) return;
+
+  // A navigation is the app opening. Prefer the network so a deploy is picked
+  // up, and fall back to whatever shell was cached, which is what makes a cold
+  // start offline work at all.
+  if (request.mode === "navigate") {
+    event.respondWith(
+      (async () => {
+        try {
+          const response = await fetch(request);
+          const cache = await caches.open(CACHE);
+          cache.put(request, response.clone());
+          return response;
+        } catch (error) {
+          const cached = (await caches.match(request)) || (await caches.match("/"));
+          if (cached) return cached;
+          throw error;
+        }
+      })(),
+    );
+    return;
+  }
+
+  // Everything else the shell is built from: answer from the cache instantly and
+  // refresh it in the background, so a release lands on the next load.
+  event.respondWith(
+    (async () => {
+      const cached = await caches.match(request);
+      const network = fetch(request)
+        .then(async (response) => {
+          if (response.ok) {
+            const cache = await caches.open(CACHE);
+            cache.put(request, response.clone());
+          }
+          return response;
+        })
+        .catch((error) => {
+          if (cached) return cached;
+          throw error;
+        });
+      return cached || network;
+    })(),
+  );
+});

package/templates/app-overlay/web/flutter_bootstrap.js.template

@@ -15,5 +15,16 @@
       });
   }
 
+  if ("serviceWorker" in navigator) {
+    // The app shell's own cache, registered at the root scope so it can answer
+    // a cold start with no network. Separate from the messaging worker above,
+    // which owns only its push scope.
+    await navigator.serviceWorker
+      .register("eigen_offline_sw.js", { scope: "/" })
+      .catch((error) => {
+        console.warn("Offline shell service worker registration failed", error);
+      });
+  }
+
   _flutter.loader.load();
 })();

package/templates/worker/game-contract.json

@@ -112,6 +112,248 @@
             },
             "kind": "playerLimits",
             "name": "two seats, because applyAction passes the turn with 1 - playerIndex"
+          },
+          {
+            "config": {
+              "target": 10
+            },
+            "expected": {
+              "outcome": null,
+              "pending": [
+                0
+              ],
+              "state": {
+                "count": 0
+              }
+            },
+            "kind": "initialState",
+            "name": "opens at zero with seat 0 to move",
+            "playerCount": 2
+          },
+          {
+            "config": {
+              "target": 10
+            },
+            "expected": {
+              "outcome": [
+                {
+                  "placement": 1,
+                  "playerIndex": 0,
+                  "result": "win",
+                  "teamIndex": 0
+                },
+                {
+                  "placement": 2,
+                  "playerIndex": 1,
+                  "result": "loss",
+                  "teamIndex": 1
+                }
+              ],
+              "pending": [],
+              "state": {
+                "count": 4
+              }
+            },
+            "kind": "lifecycle",
+            "name": "the seat that ran out of time loses",
+            "pending": [
+              1
+            ],
+            "state": {
+              "count": 4
+            },
+            "type": "timeout"
+          },
+          {
+            "config": {
+              "target": 10
+            },
+            "expected": {
+              "outcome": [
+                {
+                  "placement": 1,
+                  "playerIndex": 1,
+                  "result": "win",
+                  "teamIndex": 1
+                },
+                {
+                  "placement": 2,
+                  "playerIndex": 0,
+                  "result": "loss",
+                  "teamIndex": 0
+                }
+              ],
+              "pending": [],
+              "state": {
+                "count": 4
+              }
+            },
+            "kind": "lifecycle",
+            "name": "a resign hands the game to the other seat",
+            "pending": [
+              0
+            ],
+            "playerIndex": 0,
+            "state": {
+              "count": 4
+            },
+            "type": "forfeit"
+          },
+          {
+            "config": {
+              "target": 3
+            },
+            "expected": {
+              "outcome": [
+                {
+                  "placement": 1,
+                  "playerIndex": 0,
+                  "result": "win",
+                  "teamIndex": 0
+                },
+                {
+                  "placement": 2,
+                  "playerIndex": 1,
+                  "result": "loss",
+                  "teamIndex": 1
+                }
+              ],
+              "pending": [],
+              "state": {
+                "count": 3
+              },
+              "status": "finished",
+              "version": 3
+            },
+            "kind": "transcript",
+            "name": "three turns reach the target and end the game",
+            "playerCount": 2,
+            "seed": "counter-twin-transcript",
+            "transitions": [
+              {
+                "data": {
+                  "amount": 1
+                },
+                "kind": "game",
+                "playerIndex": 0
+              },
+              {
+                "data": {
+                  "amount": 1
+                },
+                "kind": "game",
+                "playerIndex": 1
+              },
+              {
+                "data": {
+                  "amount": 1
+                },
+                "kind": "game",
+                "playerIndex": 0
+              }
+            ]
+          },
+          {
+            "config": {
+              "target": 10
+            },
+            "expected": {
+              "outcome": [
+                {
+                  "placement": 1,
+                  "playerIndex": 0,
+                  "result": "win",
+                  "teamIndex": 0
+                },
+                {
+                  "placement": 2,
+                  "playerIndex": 1,
+                  "result": "loss",
+                  "teamIndex": 1
+                }
+              ],
+              "pending": [],
+              "state": {
+                "count": 2
+              },
+              "status": "finished",
+              "version": 2
+            },
+            "kind": "transcript",
+            "name": "a resign ends the game before the target",
+            "playerCount": 2,
+            "seed": "counter-twin-transcript",
+            "transitions": [
+              {
+                "data": {
+                  "amount": 2
+                },
+                "kind": "game",
+                "playerIndex": 0
+              },
+              {
+                "kind": "lifecycle",
+                "playerIndex": 1,
+                "type": "forfeit"
+              }
+            ]
+          }
+        ],
+        "schemaVersion": 1
+      }
+    },
+    {
+      "path": "v1/rng.json",
+      "document": {
+        "cases": [
+          {
+            "draws": [
+              0.918312304187566,
+              0.4001447563059628,
+              0.7442655747290701,
+              0.2554785134270787,
+              0.5585219208151102,
+              0.07595188519917428,
+              0.24315627454780042,
+              0.9577318748924881,
+              0.9142457258421928,
+              0.6567775409203023,
+              0.6638973171357065,
+              0.18344326340593398,
+              0.20923550752922893,
+              0.3633683763910085,
+              0.48092103423550725,
+              0.5577720713336021
+            ],
+            "kind": "rng",
+            "name": "version 0: the stream initialState draws from",
+            "seed": "twin-fixtures",
+            "version": 0
+          },
+          {
+            "draws": [
+              0.9881007166113704,
+              0.19638481689617038,
+              0.36466718139126897,
+              0.012999370228499174,
+              0.07939737639389932,
+              0.6601194732356817,
+              0.4466901211999357,
+              0.44865574641153216,
+              0.9610719594638795,
+              0.2350573013536632,
+              0.1399781135842204,
+              0.2336114849895239,
+              0.8675420160870999,
+              0.8760754023678601,
+              0.3999718655832112,
+              0.5116847101598978
+            ],
+            "kind": "rng",
+            "name": "seat 1's bot stream at version 1",
+            "seat": 1,
+            "seed": "counter-twin-transcript",
+            "version": 1
           }
         ],
         "schemaVersion": 1

package/templates/worker/src/module/fixtures/v1/counter.json

@@ -37,6 +37,185 @@
         "minPlayers": 2,
         "maxPlayers": 2
       }
+    },
+    {
+      "kind": "initialState",
+      "name": "opens at zero with seat 0 to move",
+      "config": {
+        "target": 10
+      },
+      "playerCount": 2,
+      "expected": {
+        "state": {
+          "count": 0
+        },
+        "pending": [0],
+        "outcome": null
+      }
+    },
+    {
+      "kind": "lifecycle",
+      "name": "the seat that ran out of time loses",
+      "config": {
+        "target": 10
+      },
+      "state": {
+        "count": 4
+      },
+      "pending": [1],
+      "type": "timeout",
+      "expected": {
+        "state": {
+          "count": 4
+        },
+        "pending": [],
+        "outcome": [
+          {
+            "playerIndex": 0,
+            "result": "win",
+            "placement": 1,
+            "teamIndex": 0
+          },
+          {
+            "playerIndex": 1,
+            "result": "loss",
+            "placement": 2,
+            "teamIndex": 1
+          }
+        ]
+      }
+    },
+    {
+      "kind": "lifecycle",
+      "name": "a resign hands the game to the other seat",
+      "config": {
+        "target": 10
+      },
+      "state": {
+        "count": 4
+      },
+      "pending": [0],
+      "type": "forfeit",
+      "playerIndex": 0,
+      "expected": {
+        "state": {
+          "count": 4
+        },
+        "pending": [],
+        "outcome": [
+          {
+            "playerIndex": 1,
+            "result": "win",
+            "placement": 1,
+            "teamIndex": 1
+          },
+          {
+            "playerIndex": 0,
+            "result": "loss",
+            "placement": 2,
+            "teamIndex": 0
+          }
+        ]
+      }
+    },
+    {
+      "kind": "transcript",
+      "name": "three turns reach the target and end the game",
+      "config": {
+        "target": 3
+      },
+      "playerCount": 2,
+      "seed": "counter-twin-transcript",
+      "transitions": [
+        {
+          "kind": "game",
+          "playerIndex": 0,
+          "data": {
+            "amount": 1
+          }
+        },
+        {
+          "kind": "game",
+          "playerIndex": 1,
+          "data": {
+            "amount": 1
+          }
+        },
+        {
+          "kind": "game",
+          "playerIndex": 0,
+          "data": {
+            "amount": 1
+          }
+        }
+      ],
+      "expected": {
+        "version": 3,
+        "status": "finished",
+        "state": {
+          "count": 3
+        },
+        "pending": [],
+        "outcome": [
+          {
+            "playerIndex": 0,
+            "result": "win",
+            "placement": 1,
+            "teamIndex": 0
+          },
+          {
+            "playerIndex": 1,
+            "result": "loss",
+            "placement": 2,
+            "teamIndex": 1
+          }
+        ]
+      }
+    },
+    {
+      "kind": "transcript",
+      "name": "a resign ends the game before the target",
+      "config": {
+        "target": 10
+      },
+      "playerCount": 2,
+      "seed": "counter-twin-transcript",
+      "transitions": [
+        {
+          "kind": "game",
+          "playerIndex": 0,
+          "data": {
+            "amount": 2
+          }
+        },
+        {
+          "kind": "lifecycle",
+          "type": "forfeit",
+          "playerIndex": 1
+        }
+      ],
+      "expected": {
+        "version": 2,
+        "status": "finished",
+        "state": {
+          "count": 2
+        },
+        "pending": [],
+        "outcome": [
+          {
+            "playerIndex": 0,
+            "result": "win",
+            "placement": 1,
+            "teamIndex": 0
+          },
+          {
+            "playerIndex": 1,
+            "result": "loss",
+            "placement": 2,
+            "teamIndex": 1
+          }
+        ]
+      }
     }
   ]
 }

package/templates/worker/src/module/fixtures/v1/rng.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "kind": "rng",
+      "name": "version 0: the stream initialState draws from",
+      "seed": "twin-fixtures",
+      "version": 0,
+      "draws": [
+        0.918312304187566, 0.4001447563059628, 0.7442655747290701, 0.2554785134270787, 0.5585219208151102, 0.07595188519917428, 0.24315627454780042, 0.9577318748924881, 0.9142457258421928, 0.6567775409203023, 0.6638973171357065, 0.18344326340593398, 0.20923550752922893, 0.3633683763910085, 0.48092103423550725,
+        0.5577720713336021
+      ]
+    },
+    {
+      "kind": "rng",
+      "name": "seat 1's bot stream at version 1",
+      "seed": "counter-twin-transcript",
+      "version": 1,
+      "seat": 1,
+      "draws": [
+        0.9881007166113704, 0.19638481689617038, 0.36466718139126897, 0.012999370228499174, 0.07939737639389932, 0.6601194732356817, 0.4466901211999357, 0.44865574641153216, 0.9610719594638795, 0.2350573013536632, 0.1399781135842204, 0.2336114849895239, 0.8675420160870999, 0.8760754023678601, 0.3999718655832112,
+        0.5116847101598978
+      ]
+    }
+  ]
+}

package/templates/worker/src/module/v1.ts

@@ -1,10 +1,10 @@
 import type { GameRules } from "@eigeninteractive/rules";
 import { z } from "zod";
 
-const stateSchema = z.object({ count: z.int().min(0) }).meta({ id: "ExampleGameV1State" });
-const observationSchema = z.object({ count: z.int().min(0) }).meta({ id: "ExampleGameV1Observation" });
-const actionSchema = z.object({ amount: z.int().min(1) }).meta({ id: "ExampleGameV1Action" });
-const configSchema = z.object({ target: z.int().min(1) }).meta({ id: "ExampleGameV1Config" });
+const stateSchema = z.object({ count: z.int().min(0) });
+const observationSchema = z.object({ count: z.int().min(0) });
+const actionSchema = z.object({ amount: z.int().min(1) });
+const configSchema = z.object({ target: z.int().min(1) });
 
 type State = z.infer<typeof stateSchema>;
 type Observation = z.infer<typeof observationSchema>;
@@ -61,4 +61,11 @@ export const rulesV1: GameRules<State, Observation, Action, Config> = {
 
   ratingPool: () => null,
   botSeatable: () => true,
+
+  // The in-engine bot brain, keyed by the bot registry's `username`. The Dart
+  // twin in `app/lib/game/v1/local_rules.dart` ships a brain under the same
+  // name, so one registered bot is playable on the server and on the device.
+  botActions: {
+    "example-bot": () => ({ amount: 1 }),
+  },
 };