@uzuhq/code-sdk 0.8.7 → 0.8.8

package/dist/index.js

@@ -1301,9 +1301,43 @@ function onInsetsChange(cb) {
 	};
 }
 //#endregion
+//#region src/scenario-callback.ts
+/**
+* @docs
+* - SDK仕様: docs/docs/uzu_code/play-screen-sdk.md
+*
+* SDK からシナリオのコード (描画 / イベント購読 / bridge の購読) を呼ぶときの例外境界。
+* シナリオのコールバックを呼ぶ箇所は、すべてここを通す。
+*
+* これらは state 配信やメッセージ受信のたびに同じ経路を通る。例外をそのまま上へ通すと
+* 呼び出し元の state 適用 (confirmedState 更新 / ack 処理 / seq 前進) が途中で止まり、
+* 以降の配信でも同じ経路で投げ続ける。WebSocket もホストアプリも生きたまま画面だけが
+* 永久に更新されなくなる — 2026-09-09 の UZU TOKYO 公演で実際に起きた壊れ方がこれ。
+*
+* ここで断ち切れば state 適用は最後まで走り、次の配信で描画がやり直される
+* (onState は毎回フル state から再実行されるので冪等)。同じ理由で、購読が複数ある
+* ところでは 1 件の失敗を他の購読へ波及させない。
+*/
+/**
+* シナリオ側のコールバックを実行し、例外を境界で止める。
+*
+* 例外は握り潰さず `console.error` に出す。ホスト側のログ収集がこれを拾う。
+*/
+const callScenario = (label, fn) => {
+	try {
+		fn();
+	} catch (err) {
+		console.error(`[uzu] シナリオの ${label} で例外が発生しました (処理は継続します)`, err);
+	}
+};
+//#endregion
 //#region src/run/optimistic-action-client.ts
 function createOptimisticActionClient(config) {
-	const { logic, playerId, onState, events, sendAction } = config;
+	const { logic, playerId, events, sendAction } = config;
+	/** 呼び出し箇所ごとに守らず、シナリオの描画へ出る唯一の口をここで塞ぐ。 */
+	const onState = (state, id) => {
+		callScenario("描画 (onState)", () => config.onState(state, id));
+	};
 	/** サーバー確定 state (楽観的更新のベース) */
 	let confirmedState = null;
 	/** 表示用 state (pending actions 適用済み) */
@@ -1336,7 +1370,11 @@ function createOptimisticActionClient(config) {
 	/** 再適用時はイベントを発火しない (送信時に既に発火済み) */
 	const noopEmit = () => {};
 	const dispatchEvents = (evts) => {
-		for (const e of evts) events?.[e.name]?.handler(e.data);
+		for (const e of evts) {
+			const handler = events?.[e.name]?.handler;
+			if (!handler) continue;
+			callScenario(`event ハンドラ "${e.name}"`, () => handler(e.data));
+		}
 	};
 	/** events の同一性キー。name と data が一致すれば「同じ出来事」とみなす。 */
 	const eventKey = (e) => `${e.name}\u0000${JSON.stringify(e.data ?? {})}`;
@@ -1423,7 +1461,7 @@ function createOptimisticActionClient(config) {
 				const subscription = events?.[eventName];
 				if (!subscription?.predict) return;
 				const payloadData = data ?? {};
-				subscription.handler(payloadData);
+				callScenario(`event ハンドラ "${eventName}"`, () => subscription.handler(payloadData));
 				firedPredictions.push({
 					seq,
 					name: eventName,
@@ -1448,7 +1486,9 @@ function createOptimisticActionClient(config) {
 					time
 				});
 				onState(target, playerId);
-			} catch {}
+			} catch (err) {
+				console.warn(`[uzu] action "${type}" の先読み実行で例外`, err);
+			}
 			sendAction({
 				action: type,
 				payload: payload ?? {},
@@ -1552,13 +1592,7 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 	config.inputs((type, payload) => {
 		client.send(type, payload);
 	});
-	ws.addEventListener("message", (ev) => {
-		let parsed;
-		try {
-			parsed = JSON.parse(ev.data);
-		} catch {
-			return;
-		}
+	const handleMessage = (parsed) => {
 		const msgType = parsed.type;
 		console.log(`[SDK ServerAction] ⬅ recv type=${msgType}`);
 		client.observeGameTime(parsed.gameTime);
@@ -1649,6 +1683,21 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 			client.reset(parsed.state);
 			return;
 		}
+	};
+	ws.addEventListener("message", (ev) => {
+		let parsed;
+		try {
+			parsed = JSON.parse(ev.data);
+		} catch {
+			return;
+		}
+		if (parsed === null || typeof parsed !== "object") return;
+		const msg = parsed;
+		try {
+			handleMessage(msg);
+		} catch (err) {
+			console.error(`[SDK ServerAction] ❌ message 処理で例外 type=${String(msg.type)}`, err);
+		}
 	});
 }
 //#endregion
@@ -1657,7 +1706,7 @@ function runLocalServerAction(config) {
 	const { logic, inputs, events } = config;
 	const onState = (next, id) => {
 		observeGameTime(gameTime());
-		config.onState(next, id, "player");
+		callScenario("描画 (onState)", () => config.onState(next, id, "player"));
 	};
 	const tickRate = logic.tickRate ?? 0;
 	const clock = new GameClock();
@@ -1744,7 +1793,11 @@ function runLocalServerAction(config) {
 		wakeupTimer = setTimeout(fireDue, Math.max(0, clock.toWall(next) - Date.now()));
 	};
 	const dispatchEvents = (evts) => {
-		for (const e of evts) events?.[e.name]?.handler(e.data);
+		for (const e of evts) {
+			const handler = events?.[e.name]?.handler;
+			if (!handler) continue;
+			callScenario(`event ハンドラ "${e.name}"`, () => handler(e.data));
+		}
 	};
 	clock.restart();
 	const setupTime = gameTime();
@@ -2118,7 +2171,7 @@ function handleMessage(msg) {
 				return;
 			case "playersChanged": {
 				const players = payload?.players ?? {};
-				_playersChangedHandlers.forEach((fn) => fn(players));
+				for (const fn of _playersChangedHandlers) callScenario("playersChanged ハンドラ", () => fn(players));
 				return;
 			}
 			case "requestPause":
@@ -2138,7 +2191,7 @@ function handleMessage(msg) {
 	if (channel === "game") {
 		const h = gameHandlers.get(type) || [];
 		console.log(`[SDK] 🔧 handleMessage game/${type} handlers=${h.length}`);
-		h.forEach((fn) => fn(payload ?? {}));
+		for (const fn of h) callScenario(`game/${type} ハンドラ`, () => fn(payload ?? {}));
 		return;
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-sdk",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "UZU PlayScreen SDK - Flutter ↔ JS ゲーム通信ライブラリ",
   "type": "module",
   "exports": {