@uzuhq/code-sdk 0.7.5 → 0.7.6

package/dist/index.js

@@ -323,17 +323,19 @@ function resolveSeatKind(params) {
 /**
  * 自席の ID と roster を URL から取り出す。
  *
- * roster (`?seats=`) に自席が居ないことは異常ではない。観測者はそもそも roster に
+ * roster (`?players=`) に自席が居ないことは異常ではない。観測者はそもそも roster に
  * 載らないまま接続してくる。
+ *
+ * 移行期: 旧ホスト (デプロイ前の mobile / uzutokyo / emulator) は `?seats=` で送ってくる。
  */
 function resolveSeatParams(params) {
     const seatId = params.get('seatId');
     if (!seatId) {
         throw new Error('[UZU SDK] seatId is required. Pass ?seatId=xxx in the URL.');
     }
-    const json = params.get('seats');
+    const json = params.get('players') ?? params.get('seats');
     if (!json) {
-        throw new Error('[UZU SDK] seats is required. Pass ?seats=[...] in the URL.');
+        throw new Error('[UZU SDK] players is required. Pass ?players=[...] in the URL.');
     }
     const raw = JSON.parse(json);
     const players = raw.map((p) => ({
@@ -448,7 +450,7 @@ const ACTION_ITEM_WIDTH = 38;
 function calcHudInsets(params) {
     const y = HUD_TOP + UZU_BUTTON_SIZE;
     let actionCount = 2; // デフォルト: 安全側 (マイク + チャット想定)
-    const json = params.get('seats');
+    const json = params.get('players') ?? params.get('seats');
     if (json) {
         try {
             const raw = JSON.parse(json);

package/dist/roster-params.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/roster-params.test.js

@@ -0,0 +1,86 @@
+/**
+ * URL の roster パラメータ (`?players=` / 旧名 `?seats=`) の解決を固定する unit test。
+ *
+ * ホスト (mobile / uzutokyo / emulator / dev harness) と SDK の間はデプロイが揃わない。
+ * 新旧どちらの名前で渡されても run() が起動し、GameRoom へは新名で送り直すところまでを
+ * 1 本で見る。旧名しか読めない SDK / 旧名しか送らないホストが同時に居るのが移行期の前提。
+ */
+import { afterEach, describe, expect, it, vi } from 'vitest';
+const logic = {
+    setup: () => ({ moves: 0 }),
+    actions: {},
+    update: () => { },
+};
+const roster = [
+    { id: 'p1', nickname: 'P1', iconUrl: '' },
+    { id: 'p2', nickname: 'P2', iconUrl: '' },
+];
+const wire = (seats) => JSON.stringify(seats.map((s) => ({ id: s.id, name: s.nickname, iconUrl: s.iconUrl })));
+/** `new WebSocket(url)` を捕まえるスタブ。接続先 URL だけ見る。 */
+const stubWebSocket = () => {
+    const urls = [];
+    class FakeWebSocket {
+        constructor(url) {
+            this.url = url;
+            this.onopen = null;
+            this.onclose = null;
+            this.onerror = null;
+            this.onmessage = null;
+            this.readyState = FakeWebSocket.OPEN;
+            urls.push(url);
+        }
+        send() { }
+        close() { }
+    }
+    FakeWebSocket.OPEN = 1;
+    vi.stubGlobal('WebSocket', FakeWebSocket);
+    return urls;
+};
+/**
+ * 指定のクエリで SDK を読み込み直して `run()` まで通す。
+ *
+ * `isHosted` は module 評価時に一度だけ決まるので、`FlutterHost` を先に生やしてから
+ * import しないと run() が即 return して何も起きない。
+ */
+const runWithQuery = async (query) => {
+    vi.resetModules();
+    vi.stubGlobal('FlutterHost', { postMessage: () => { } });
+    const urls = stubWebSocket();
+    window.history.replaceState({}, '', `/?${query}`);
+    const sdk = await import('./index.js');
+    sdk.run({ logic, playerCount: 2, onState: () => { }, inputs: () => { } });
+    return urls;
+};
+const baseQuery = 'roomId=room1&server=ws://localhost:1234&revisionId=rev1&seatId=p1';
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+describe('roster パラメータの解決', () => {
+    /** 新ホストは `players=` で送る。 */
+    it('players から roster を読む', async () => {
+        const urls = await runWithQuery(`${baseQuery}&players=${encodeURIComponent(wire(roster))}`);
+        const sent = new URL(urls[0]).searchParams.get('players');
+        expect(JSON.parse(sent ?? '[]').map((s) => s.id)).toEqual(['p1', 'p2']);
+    });
+    /**
+     * 移行期の互換措置。デプロイ前のホストは旧名でしか送ってこない。読めないと run() の
+     * 入口で throw してシナリオが起動しない。
+     */
+    it('players が無ければ旧名 seats に落ちる', async () => {
+        const urls = await runWithQuery(`${baseQuery}&seats=${encodeURIComponent(wire(roster))}`);
+        const sent = new URL(urls[0]).searchParams.get('players');
+        expect(JSON.parse(sent ?? '[]').map((s) => s.id)).toEqual(['p1', 'p2']);
+    });
+    /** 移行期は両方載せたホストが居る。新名を優先し、旧名は fallback にしか使わない。 */
+    it('両方あれば players を採る', async () => {
+        const old = [{ id: 'old1', nickname: 'Old1', iconUrl: '' }];
+        const urls = await runWithQuery(`${baseQuery}&players=${encodeURIComponent(wire(roster))}` +
+            `&seats=${encodeURIComponent(wire(old))}`);
+        const sent = new URL(urls[0]).searchParams.get('players');
+        expect(JSON.parse(sent ?? '[]').map((s) => s.id)).toEqual(['p1', 'p2']);
+    });
+    /** roster がどちらの名前でも無ければ、黙って空 roster で始めず入口で落とす。 */
+    it('どちらも無ければ throw する', async () => {
+        await expect(runWithQuery(baseQuery)).rejects.toThrow(/players is required/);
+    });
+});

package/dist/run/server-action.js

@@ -10,10 +10,14 @@ export function runOnlineServerAction(config, gameEndpoint, roomId, seatId, play
         characterId: p.characterId,
         kind: 'player',
     });
+    const roster = JSON.stringify(players.map(toWire));
     const query = new URLSearchParams({
         seatId,
         nickname: 'Player',
-        seats: JSON.stringify(players.map(toWire)),
+        players: roster,
+        // 移行期: play-server / dev-server が `players=` を読めるようになる前の revision へ
+        // 繋ぐ経路が残る (JIT 再デプロイ前の焼き込み済みテンプレなど)。旧名も併せて送る。
+        seats: roster,
     });
     const wsUrl = `${gameEndpoint}/${roomId}?${query}`;
     console.log(`[SDK ServerAction] 🔗 Connecting wsUrl=${wsUrl}`);

package/dist/run/server-action.test.js

@@ -74,13 +74,22 @@ describe('runOnlineServerAction の seatKind', () => {
         expect(url.searchParams.get('seatId')).toBe('admin_0');
     });
     /**
-     * roster (`?seats=`) は player 席だけ。観測者は自分が載っていない roster を送る。
+     * roster (`?players=`) は player 席だけ。観測者は自分が載っていない roster を送る。
      */
     it('roster には自分が居なくてよい', () => {
         const { sockets } = connect('admin', 'admin_0');
-        const raw = JSON.parse(new URL(sockets[0].url).searchParams.get('seats') ?? '[]');
+        const raw = JSON.parse(new URL(sockets[0].url).searchParams.get('players') ?? '[]');
         expect(raw.map((s) => s.id)).toEqual(['p1', 'p2']);
     });
+    /**
+     * 移行期の互換措置。`players=` しか送らないと、JIT 再デプロイ前の焼き込み済み
+     * テンプレを持つ部屋が roster を pin できず起動しない。旧名にも同じ JSON を載せる。
+     */
+    it('旧名 seats にも同じ roster を載せる', () => {
+        const { sockets } = connect('player');
+        const params = new URL(sockets[0].url).searchParams;
+        expect(params.get('seats')).toBe(params.get('players'));
+    });
     /** シナリオが GM ビューと観戦ビューを分けられるよう、自分の席種別だけを渡す。 */
     it('onState の第 3 引数に自分の seatKind を渡す', () => {
         const { sockets, onState } = connect('admin', 'admin_0');

package/package.json

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