castle-web-cli 0.4.171 → 0.4.173

package/kits/physics-3d/package-lock.json

@@ -34,7 +34,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.26",
+      "version": "0.4.28",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/kits/real-time/castle.json

@@ -15,5 +15,5 @@
   "autoUpdateWhenImported": true,
   "deckId": "xFVr-afOLuUQ",
   "cardId": "w6G45sy3_P_m",
-  "publishedVersion": "2026-09-10T20:10:30.302Z"
+  "publishedVersion": "2026-09-10T22:05:27.337Z"
 }

package/kits/real-time/code/client/connection.js

@@ -12,6 +12,7 @@ const SEND_MS = 1000 / Messages.MOVE_HZ;
 //   connection  the SDK connection
 //   inbox       arrived messages, each with `localMs` added
 //   roster      playerId -> username, as the platform last reported it
+//   userIds     playerId -> userId, from the same roster
 //   you         the SDK's entry for the local player, null until a roster has it
 //   sentAt      `performance.now()` of the last move, so sends stay at MOVE_HZ
 //   claims      ids asked for since the last send, held until it goes
@@ -21,6 +22,7 @@ function makeNet(connection) {
     connection,
     inbox: [],
     roster: new Map(),
+    userIds: new Map(),
     you: null,
     sentAt: 0,
     claims: new Set(),
@@ -48,6 +50,7 @@ export async function connectSession({ onLog = () => {} } = {}) {
 
     // Replace the map from the complete SDK roster so departures disappear.
     net.roster = new Map(players.map((player) => [player.playerId, player.username]));
+    net.userIds = new Map(players.map((player) => [player.playerId, player.userId]));
     net.you = you;
   });
 
@@ -61,6 +64,9 @@ export async function connectSession({ onLog = () => {} } = {}) {
     // A stable fallback until the SDK roster includes this player.
     username: (playerId) => net.roster.get(playerId) ?? 'player',
 
+    // The account behind a player, for `User.get`; null until the roster has it.
+    userId: (playerId) => net.userIds.get(playerId) ?? null,
+
     // Every other player's roster entry. The local player is simulated by this client,
     // so the deck draws only these from network samples.
     others: () => new Map([...net.roster].filter(([id]) => id !== connection.playerId)),
@@ -85,7 +91,16 @@ export async function connectSession({ onLog = () => {} } = {}) {
       sendMove(net, pose, owned, claims, releases, state),
 
     // Send deck-specific data. The server routes these to `code/server/game.js`.
-    send: (data) => net.connection.send(data),
+    send: (data) => {
+      if (connection.state !== 'closed') {
+        net.connection.send(data);
+      }
+    },
+
+    // Whether the session has ended under this connection: the server was
+    // replaced, the platform closed it, or `close` was called. Nothing is sent
+    // on it again; the client system joins afresh.
+    closed: () => connection.state === 'closed',
 
     // Connection and presence data for a deck status line.
     status: () => ({
@@ -121,7 +136,7 @@ function sendMove(net, pose, owned, claims, releases, state) {
     net.releases.add(id);
   }
   const now = performance.now();
-  if (now - net.sentAt < SEND_MS) {
+  if (now - net.sentAt < SEND_MS || net.connection.state === 'closed') {
     return false;
   }
   net.sentAt = now;

package/kits/real-time/code/server/session.js

@@ -80,12 +80,18 @@ function newServer(parts) {
 export function makeSession(parts) {
   const server = newServer(parts);
 
-  // Castle's handlers remain available while `createSimulation` is pending.
+  // Castle's handlers remain available while `createSimulation` is pending. A
+  // build that fails is logged here; `buildWorld` sees the same rejection when
+  // the first tick awaits it.
   server.building = server.world.createSimulation();
+  server.building.catch((err) => {
+    console.error(`[${server.label}] simulation failed to build: ${err?.stack ?? err}`);
+  });
   return {
-    onStart(session) {
-      attach(server, session);
-    },
+    // The world is built from the first tick or join, not here: `onStart` runs
+    // while the process is still booting, and a storage read made then can go
+    // unanswered.
+    onStart() {},
 
     // Joins are logged here; the simulation's players are reconciled from the
     // full session roster on the next tick.
@@ -124,8 +130,8 @@ export function makeSession(parts) {
   };
 }
 
-// Keep the first session a callback carries and build the world with it. The
-// room the session persists under is not known before this.
+// Keep the first session a tick or join carries and build the world with it.
+// The room the session persists under is not known before this.
 function attach(server, session) {
   if (server.session) {
     return;

package/kits/real-time/package-lock.json

@@ -16,7 +16,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.27",
+      "version": "0.4.28",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/kits/turn-based/CLAUDE.md

@@ -41,6 +41,10 @@ This kit adds no engine and no editors. What it holds:
   `{ table }`. One table per `session.sessionId`, made on demand. `joinAsync` is
   the join to use: it reads the saved table first, which the synchronous
   `room.join` cannot.
+- **A claimed square shows its holder's avatar.** The state carries `users`,
+  seat -> userId, and `Board.jsx` swaps the square's `Sprite.file` for the
+  avatar from `castle.physics-2d`'s `engine/avatarArt.js`; a holder with no
+  photo keeps the seat tint.
 - **A room comes back.** `table.game`, the seat each account held, and the time
   of the last accepted move are saved to deck storage on every accepted move, on
   every leave, and from `room.save(session)` in `onShutdown`. Storage belongs to

package/kits/turn-based/castle.json

@@ -17,7 +17,7 @@
   "imports": {
     "castle.physics-2d": {
       "deckId": "ckRZGFW4iPrx",
-      "version": "2026-09-10T00:57:31.408Z"
+      "version": "2026-09-10T20:21:12.665Z"
     },
     "castle.base": {
       "deckId": "yRcmH4_aYllE",
@@ -28,7 +28,7 @@
   "autoUpdateWhenImported": true,
   "deckId": "K6-Xs7dCoMVi",
   "cardId": "Kh_08IYATpC3",
-  "publishedVersion": "2026-09-10T20:10:44.202Z",
+  "publishedVersion": "2026-09-10T22:05:30.856Z",
   "server": {
     "main": "code/server/index.js",
     "maxPlayers": 8,

package/kits/turn-based/code/behaviors/Board.jsx

@@ -3,8 +3,10 @@
 // multiplayer session, send square claims, tint actors and format status text.
 
 import { Multiplayer } from 'castle-web-sdk';
+import { avatarSpritePath } from '@imports/castle.physics-2d/engine/avatarArt';
 
-// Sprite tint multiplies these seat colors over each square's own artwork.
+// A claimed square shows its holder's avatar. Until that has loaded, or when the
+// holder has none, the seat's tint multiplies the square's own artwork instead.
 const SEAT_TINT = { A: '#ea323cff', B: '#0cf1ffff' };
 const UNCLAIMED_TINT = '#ffffffff';
 
@@ -130,10 +132,18 @@ function paintSquares(scene, state) {
   for (const squareActor of scene.actorsWith('Square')) {
     // Square.index selects the same slot in the server's sixteen-element array.
     const seat = state.squares[squareActor.components.Square.index];
-    // Sprite tint multiplies the editable `drawings/square.sprite` pixels.
-    // White preserves their colors; a seat tint displays the square's owner.
-    // A game with separate pieces can spawn piece actors over these square actors.
-    squareActor.components.Sprite.tint = seat ? SEAT_TINT[seat] : UNCLAIMED_TINT;
+    const sprite = squareActor.components.Sprite;
+
+    // The square's own art is remembered the first time, since `file` is
+    // swapped for an avatar below and back again when the square is cleared.
+    squareActor.runtime.squareFile ??= sprite.file;
+    const avatar = seat ? avatarSpritePath(scene, state.users?.[seat]) : null;
+    sprite.file = avatar ?? squareActor.runtime.squareFile;
+
+    // Sprite tint multiplies the pixels. White preserves their colors; a seat
+    // tint displays the owner of a square without an avatar. A game with
+    // separate pieces can spawn piece actors over these square actors.
+    sprite.tint = seat && !avatar ? SEAT_TINT[seat] : UNCLAIMED_TINT;
   }
 }
 

package/kits/turn-based/code/server/index.js

@@ -91,6 +91,7 @@ function stateFor(session, table, playerId) {
     turn: table.game.turn,
     winner: table.game.winner,
     names: table.seatNames(),
+    users: table.seatUsers(),
     watching: table.spectatorCount(session),
     you: table.seatOf(playerId),
   };

package/kits/turn-based/fonts.generated.js

@@ -1,4 +1,4 @@
-// Generated by the Style editor. Do not edit -- picking a font rewrites it.
+// Generated by the Theme editor. Do not edit -- picking a font rewrites it.
 //
 // `theme.style` records that this deck's font is DMSans; this module is what
 // puts DMSans's bytes in the published bundle. It has to name the face in a

package/kits/turn-based/package-lock.json

@@ -28,7 +28,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.26",
+      "version": "0.4.28",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/kits/turn-based/room.js

@@ -178,6 +178,8 @@ function createTable(settings, session) {
     playerAt: (seat) => table.seats[seat] ?? null,
     seatNames: () =>
       Object.fromEntries(settings.seats.map((seat) => [seat, table.seats[seat]?.name ?? null])),
+    seatUsers: () =>
+      Object.fromEntries(settings.seats.map((seat) => [seat, table.seats[seat]?.userId ?? null])),
     spectatorCount: (session) => spectatorCount(table, session),
 
     // Call this past every rejection, never before one. A refused message is not

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.171",
+  "version": "0.4.173",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"
@@ -41,6 +41,7 @@
     "@xterm/headless": "^6.0.0",
     "@xterm/xterm": "^6.0.0",
     "codemirror": "^6.0.2",
+    "compression": "^1.8.1",
     "html2canvas": "^1.4.1",
     "marked": "^18.0.5",
     "nanoid": "^5.1.7",
@@ -54,6 +55,7 @@
     "ws": "^8.20.0"
   },
   "devDependencies": {
+    "@types/compression": "^1.8.1",
     "@types/node": "^20.0.0",
     "@types/picomatch": "^4.0.2",
     "@types/react": "^18.3.31",