@uzuhq/code-cli 0.3.18 → 0.3.20

package/dist/dev-server/game-room.js

@@ -14,6 +14,16 @@
 import { randomUUID } from 'crypto';
 import { compare, applyJsonMergePatch, applyJsonPatch } from './json-patch.js';
 import { SeededRandomImpl } from './random.js';
+/**
+ * serverOnly() で wrap された handler かを判定する (SDK の isServerOnlyAction と同じ brand)。
+ * dev-server は SDK を import できないため実装を持つ。
+ */
+function isServerOnlyAction(handler) {
+    // handler は logic.actions[name] の結果なので undefined になりうる。型上は
+    // undefined を含まない (noUncheckedIndexedAccess 無効) ため tsc では気付けない。
+    // typeof ガードが無いと `'__serverOnly' in undefined` で TypeError になる。
+    return (typeof handler === 'function' && '__serverOnly' in handler && handler.__serverOnly === true);
+}
 export class GameRoom {
     logic;
     tickRate;
@@ -324,17 +334,45 @@ export class GameRoom {
         }
     }
     async dispatchAction(actionName, payload, senderId, ackSeq) {
-        const handler = this.logic.actions[actionName];
-        if (!handler) {
+        const plain = this.logic.actions[actionName];
+        // 移行期の互換: 旧 serverOnly() を actions に入れたままの logic も動かす。
+        const legacyServerOnly = isServerOnlyAction(plain) ? plain : null;
+        const serverHandler = this.logic.serverActions?.[actionName] ?? legacyServerOnly;
+        if (!plain && !serverHandler) {
             throw new Error(`Unknown action: ${actionName}`);
         }
         if (!this.gameState) {
             throw new Error('Game not started');
         }
+        // actions 由来は送信者側で先読み時に発火済みなので ack で skip されるが、
+        // serverActions 由来は先読みで走っていないため別枠で常に配信する。
         const events = [];
+        const serverEvents = [];
         const emit = (name, data) => events.push({ name, data: data ?? {} });
-        await handler(this.gameState, payload ?? {}, senderId, emit, { tick: this.tickCount });
-        this.broadcastStateDelta(events, { ack: ackSeq, from: senderId });
+        const serverEmit = (name, data) => serverEvents.push({ name, data: data ?? {} });
+        // action は「全部成功か全部失敗か」にする。plain が state を変更したあと
+        // serverActions が throw すると、caller の catch が __action_error を返して
+        // broadcast されないまま変更が gameState に残り、次の無関係な broadcast の diff に
+        // 紛れて漏れる。クライアントは __action_error で予測を rollback するので、
+        // 巻き戻さないとサーバー真実と表示が食い違ったままになる。
+        const snapshot = structuredClone(this.gameState);
+        try {
+            // 決定的な部分を先に走らせ、serverActions がその結果を見られるようにする。
+            if (plain && !legacyServerOnly) {
+                plain(this.gameState, payload ?? {}, senderId, emit, {});
+            }
+            if (serverHandler) {
+                await serverHandler(this.gameState, payload ?? {}, senderId, serverEmit, {
+                    tick: this.tickCount,
+                    random: this.random ?? new SeededRandomImpl(this.seed),
+                });
+            }
+        }
+        catch (err) {
+            this.gameState = snapshot;
+            throw err;
+        }
+        this.broadcastStateDelta(events, { ack: ackSeq, from: senderId, serverEvents });
     }
     handleClose(ws) {
         const attachment = this.attachments.get(ws);

package/dist/dev.js

@@ -107,7 +107,7 @@ export async function runDevCommand() {
         port: harnessPort,
         // 同一 LAN の実機 (スマホ等) から harness / 単一プレイヤー画面を開けるよう
         // 全 interface で listen する。 GameRoom は in-memory の dev 専用 state のみ。
-        host: '0.0.0.0',
+        host: HARNESS_HOST,
         logic: loaded?.logic ?? null,
         harness: { html: harnessHtml(), js: harnessJs },
         meta,
@@ -207,13 +207,16 @@ function watchForReady(child, pattern) {
 }
 const DEFAULT_HARNESS_PORT = 10001;
 const MAX_HARNESS_PORT_ATTEMPTS = 100;
+const HARNESS_HOST = '0.0.0.0';
 async function findFreePort() {
     const net = await import('net');
     const tryPort = (port) => new Promise((resolve) => {
         const server = net.createServer();
         server.unref();
         server.once('error', () => resolve(null));
-        server.listen(port, () => {
+        // host は実 listen (dev-server/server.ts) と揃える。省略すると IPv6 wildcard に
+        // bind してしまい、別プロセスが 0.0.0.0 で掴んでいるポートを空きと誤判定する。
+        server.listen(port, HARNESS_HOST, () => {
             // listen(0) は OS が空きポートを動的割当するため、引数ではなく実際に割り当てられた
             // 番号を読む必要がある。close 後は address() が null を返すので閉じる前に取る。
             const address = server.address();

package/dist/harness/mount.js

@@ -254,7 +254,16 @@ function createLifecycleStatusRow() {
         item.appendChild(text);
         row.appendChild(item);
     }
-    return { el: row, dots };
+    // native title の tooltip は的が小さく遅延も長いので、クリックで開くパネル (render 側で
+    // frameWrap に置く) を主にする。title は補助。
+    const predictionWarn = document.createElement('span');
+    predictionWarn.style.cssText = [
+        'display:none;align-items:center;gap:3px',
+        'color:#1a1a2e;background:#ffb86c;border-radius:6px',
+        'padding:0 5px;cursor:pointer;user-select:none;font-weight:bold',
+    ].join(';');
+    row.appendChild(predictionWarn);
+    return { el: row, dots, predictionWarn };
 }
 function seatAt(opts, index) {
     const seat = opts.seats[index];
@@ -505,6 +514,7 @@ export function mountIframeGrid(opts) {
     const cells = [];
     const iframeStatusDots = new Map();
     const iframeSplashes = new Map();
+    const iframePredictionWarns = new Map();
     // 擬似ノッチ (各 cell 共通トグル)。 iframe を再生成せず inset だけ切り替える。
     let notchSimOn = true;
     const notchAppliers = [];
@@ -552,6 +562,7 @@ export function mountIframeGrid(opts) {
         cells.length = 0;
         iframeStatusDots.clear();
         iframeSplashes.clear();
+        iframePredictionWarns.clear();
         for (let i = 0; i < opts.seats.length; i++) {
             const seat = seatAt(opts, i);
             const cell = document.createElement('div');
@@ -595,9 +606,25 @@ export function mountIframeGrid(opts) {
             if (seat.kind !== 'admin') {
                 screen.appendChild(createCellChrome(opts, i, false, toggleNotchSim));
             }
+            // 先読み警告の内訳パネル。 バッジクリックで開閉する。 画面の上に重ねるので
+            // ゲームの見た目は普段どおりのまま、 必要なときだけ前に出る。
+            const predictionPanel = document.createElement('div');
+            predictionPanel.style.cssText = [
+                'display:none;position:absolute;z-index:20;left:6px;right:6px;top:6px',
+                'background:#16213e;border:1px solid #ffb86c;border-radius:6px',
+                'padding:8px 10px;font-family:monospace;font-size:10px;line-height:1.6',
+                'color:#ffb86c;text-align:left;white-space:pre-wrap;cursor:pointer',
+            ].join(';');
+            predictionPanel.addEventListener('click', () => {
+                predictionPanel.style.display = 'none';
+            });
             const notchDecor = createNotchDecor();
             frameWrap.appendChild(screen);
             frameWrap.appendChild(notchDecor);
+            frameWrap.appendChild(predictionPanel);
+            statusRow.predictionWarn.addEventListener('click', () => {
+                predictionPanel.style.display = predictionPanel.style.display === 'none' ? 'block' : 'none';
+            });
             // 擬似ノッチ ON/OFF を screen の inset だけで切り替える (iframe は再生成しない)。
             const applyNotch = (on) => {
                 if (seat.kind === 'admin')
@@ -628,6 +655,11 @@ export function mountIframeGrid(opts) {
             if (iframe.contentWindow) {
                 iframeStatusDots.set(iframe.contentWindow, statusRow.dots);
                 iframeSplashes.set(iframe.contentWindow, splash);
+                iframePredictionWarns.set(iframe.contentWindow, {
+                    badge: statusRow.predictionWarn,
+                    panel: predictionPanel,
+                    entries: [],
+                });
             }
         }
         layout();
@@ -658,6 +690,32 @@ export function mountIframeGrid(opts) {
                 iframeSplashes.delete(event.source);
             }
         }
+        if (type === 'predictionWarning') {
+            const slot = iframePredictionWarns.get(event.source);
+            const payload = data.payload;
+            if (!slot || typeof payload !== 'object' || payload === null)
+                return;
+            if (!('action' in payload) || !('api' in payload))
+                return;
+            const { action, api } = payload;
+            if (typeof action !== 'string' || typeof api !== 'string')
+                return;
+            slot.entries.push(`${action} → ${api}`);
+            const body = [
+                '⚠ 先読み中に、サーバーと結果が一致しない API が呼ばれました',
+                '',
+                ...slot.entries.map((e) => `  ${e}`),
+                '',
+                'この action を serverOnly() で wrap するか、値を state に書かないでください。',
+                '直し方の詳細は console を参照。',
+                '',
+                '(クリックで閉じる)',
+            ].join('\n');
+            slot.badge.textContent = `⚠ ${slot.entries.length}`;
+            slot.badge.title = body;
+            slot.badge.style.display = 'inline-flex';
+            slot.panel.textContent = body;
+        }
     };
     window.addEventListener('message', onParentMessage);
     window.addEventListener('resize', layout);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-cli",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "UZU ゲーム開発 CLI - ビルド・パブリッシュ・プロジェクト作成ツール",
   "type": "module",
   "bin": {