create-gametau 0.3.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gametau",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Scaffold a Tauri game that deploys to web + desktop",
   "license": "Apache-2.0",
   "repository": {

package/templates/base/package.json

@@ -11,12 +11,12 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "webtau": "^0.3.0"
+    "webtau": "^0.3.1"
   },
   "devDependencies": {
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.3.0",
+    "webtau-vite": "^0.3.1",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }

package/templates/base/src/game/snapshot-queue.ts

@@ -0,0 +1,62 @@
+export interface SnapshotQueueOptions {
+  maxRetries?: number;
+  backoffMs?: number;
+  onError?: (error: unknown, retriesLeft: number) => void;
+}
+
+export function createSnapshotQueue<T>(
+  save: (snapshot: T) => Promise<void>,
+  options?: SnapshotQueueOptions,
+): { enqueue(snapshot: T): void } {
+  const maxRetries = options?.maxRetries ?? 3;
+  const baseBackoffMs = options?.backoffMs ?? 500;
+  const onError = options?.onError;
+
+  let snapshotInFlight = false;
+  let pendingSnapshot: T | null = null;
+
+  async function flush(): Promise<void> {
+    if (snapshotInFlight) return;
+    snapshotInFlight = true;
+    try {
+      while (pendingSnapshot !== null) {
+        const snapshot = pendingSnapshot;
+        pendingSnapshot = null;
+
+        let lastError: unknown;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+          try {
+            await save(snapshot);
+            lastError = null;
+            break;
+          } catch (error) {
+            lastError = error;
+            const retriesLeft = maxRetries - attempt;
+            onError?.(error, retriesLeft);
+            if (retriesLeft > 0) {
+              const delayMs = baseBackoffMs * 2 ** attempt;
+              await new Promise((r) => setTimeout(r, delayMs));
+            }
+          }
+        }
+
+        if (lastError !== null && lastError !== undefined) {
+          // All retries exhausted for this snapshot; continue draining
+          // pending queue so newer snapshots are not blocked.
+        }
+      }
+    } finally {
+      snapshotInFlight = false;
+      if (pendingSnapshot !== null) {
+        void flush();
+      }
+    }
+  }
+
+  return {
+    enqueue(snapshot: T): void {
+      pendingSnapshot = snapshot;
+      void flush();
+    },
+  };
+}

package/templates/base/src/index.ts

@@ -1,5 +1,6 @@
 import { configure, isTauri } from "webtau";
 import { startGameLoop } from "./game/loop";
+import { createSnapshotQueue } from "./game/snapshot-queue";
 import { initScene, updateScene } from "./game/scene";
 import {
   createServiceLayer,
@@ -69,6 +70,13 @@ async function main() {
   let tickInFlight = false;
   const tickRate = 1 / settings.tickRateHz;
 
+  const snapshotQueue = createSnapshotQueue<WorldView>(
+    async (snapshot) => {
+      await services.session.saveSnapshot(snapshot);
+      document.getElementById("session")!.textContent = `saved at tick ${snapshot.tick_count}`;
+    },
+  );
+
   startGameLoop(
     (dt) => {
       tickAccumulator += dt;
@@ -81,15 +89,16 @@ async function main() {
             updateHud(nextView, settings);
 
             if (nextView.tick_count % settings.autoSaveEveryTicks === 0) {
-              await services.session.saveSnapshot(nextView);
-              document.getElementById("session")!.textContent = `saved at tick ${nextView.tick_count}`;
+              snapshotQueue.enqueue(nextView);
             }
 
-            await services.comms.publish({
+            // Intentional fire-and-forget: comms events are non-critical side effects
+            // and must not block the tick cadence. void suppresses the floating-promise lint.
+            void services.comms.publish({
               level: resolveAlertLevel(tickResult.score_delta),
               source: "engine",
               message: `score delta ${tickResult.score_delta}`,
-            });
+            }).catch(console.error);
           })
           .catch(console.error)
           .finally(() => { tickInFlight = false; });

package/templates/base/src-tauri/commands/Cargo.toml

@@ -5,7 +5,7 @@ edition.workspace = true
 
 [dependencies]
 {{PROJECT_NAME}}-core = { path = "../core" }
-webtau = "0.3.0"
+webtau = "0.3.1"
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 tauri = { version = "2", features = [] }

package/templates/base/src-tauri/wasm/Cargo.toml

@@ -11,7 +11,7 @@ wasm-bindgen = "0.2"
 serde = { version = "1", features = ["derive"] }
 serde-wasm-bindgen = "0.6"
 getrandom = { version = "0.2", features = ["js"] }
-webtau = "0.3.0"
+webtau = "0.3.1"
 {{PROJECT_NAME}}-core = { path = "../core" }
 {{PROJECT_NAME}}-commands = { path = "../commands" }
 

package/templates/pixi/package.json

@@ -12,12 +12,12 @@
   },
   "dependencies": {
     "pixi.js": "^8.0.0",
-    "webtau": "^0.3.0"
+    "webtau": "^0.3.1"
   },
   "devDependencies": {
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.3.0",
+    "webtau-vite": "^0.3.1",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }

package/templates/three/package.json

@@ -12,13 +12,13 @@
   },
   "dependencies": {
     "three": "^0.172.0",
-    "webtau": "^0.3.0"
+    "webtau": "^0.3.1"
   },
   "devDependencies": {
     "@types/three": "^0.172.0",
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.3.0",
+    "webtau-vite": "^0.3.1",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }