@uzuhq/code-sdk 0.8.3 → 0.8.5

package/README.md

@@ -25,24 +25,6 @@ SDK チャネルのメッセージは `playSound()`, `setMicEnabled()` などの
 
 ---
 
-## 3 つのパラダイム
-
-SDK は用途に応じて 3 つの API パターンを提供する。
-
-| パラダイム | API                   | state 管理                         | 向いているゲーム             |
-| ---------- | --------------------- | ---------------------------------- | ---------------------------- |
-| **Relay**  | `init()` + `onRoom()` | ゲーム側の責務                     | 独自プロトコルが必要なゲーム |
-| **sync()** | `sync()`              | SDK + サーバーが JSON Patch で同期 | ターン制・ボードゲーム       |
-| **run()**  | `run()`               | SDK + reducer がサーバーで逐次実行 | リアルタイム・アクション全般 |
-
-### 選択基準
-
-- 同時操作で同じリソースを奪い合う → **`run()`**（reducer が最新 state に対して逐次実行、条件保証あり）
-- 各プレイヤーが自分の領域だけ変更 → **`sync()`** で十分
-- 独自のメッセージプロトコルが必要 → **Relay**
-
----
-
 ## 初期化
 
 ### `init(): void`
@@ -54,132 +36,19 @@ import { init } from '@uzuhq/code-sdk';
 init();
 ```
 
-- `run()` / `sync()` を使う場合は内部で `init()` が呼ばれるため不要
-- Relay パターン (`onRoom()`) のみ、最初に呼び出す
-
----
-
-## パターン 1: Relay
-
-### `onRoom(callback: (room: RoomLike) => void): void`
-
-Room に接続されたときのコールバックを登録する。
-
-```ts
-import { init, onRoom } from '@uzuhq/code-sdk';
-
-init();
-
-onRoom((room) => {
-  console.log('My ID:', room.myId);
-
-  room.on('attack', (msg) => {
-    console.log(`${msg.__from} sent ${msg.lines} lines`);
-  });
-
-  room.broadcast({ type: 'attack', lines: 2 });
-  room.send(targetId, { type: 'whisper', text: 'hello' });
-});
-```
-
-### Room API
-
-| メソッド/プロパティ      | 型                                                     | 説明                                                     |
-| ------------------------ | ------------------------------------------------------ | -------------------------------------------------------- |
-| `room.myId`              | `string` (readonly)                                    | 自分の playerId                                          |
-| `room.broadcast(msg)`    | `(msg: Record<string, unknown>) => void`               | 自分以外の全員に送信                                     |
-| `room.send(id, msg)`     | `(id: string, msg: Record<string, unknown>) => void`   | 特定プレイヤーに送信                                     |
-| `room.on(type, handler)` | `(type: string, handler: (data: any) => void) => void` | メッセージハンドラ登録。受信データに `__from` が含まれる |
+- `run()` が内部で呼ぶので、通常は直接書かなくてよい
+- マルチプレイの state 同期を使わない 1 人用シナリオ (サウンド・ボイス・safe area だけ使う)
+  では、これだけを最初に呼ぶ
 
 ---
 
-## パターン 2: sync()
-
-### `sync<S>(config: SyncConfig<S>): void`
-
-JSON Patch ベースの状態同期を開始する。
-
-```ts
-import { sync, SERVER_TIME } from '@uzuhq/code-sdk';
-import type { Seat } from '@uzuhq/code-sdk';
-
-sync<GameState>({
-  playerCount: 2,
-
-  initialState(players: Seat[]) {
-    return { board: createBoard(8), currentPlayer: players[0].id };
-  },
-
-  onState(state, myPlayerId, serverTime) {
-    currentState = state;
-    render();
-  },
-
-  inputs(patch, set) {
-    canvas.addEventListener('click', (e) => {
-      const { row, col } = getCellFromClick(e);
-      // 複数操作をまとめて送信
-      patch([
-        { op: 'replace', path: `/board/${row}/${col}`, value: myPlayerId },
-        { op: 'replace', path: '/lastMoveAt', value: SERVER_TIME },
-      ]);
-      // 単一値のショートカット
-      set('/currentPlayer', getNextPlayer());
-    });
-  },
-
-  connection: {
-    onConnectionStateChange(state) {
-      console.log('Connection:', state);
-    },
-    onPatchFailed(error) {
-      console.error('Patch failed:', error);
-    },
-  },
-});
-```
-
-### SyncConfig
-
-| キー           | 型                                                           | 必須 | 説明                         |
-| -------------- | ------------------------------------------------------------ | ---- | ---------------------------- |
-| `playerCount`  | `number`                                                     | Yes  | プレイヤー数                 |
-| `initialState` | `(players: Seat[]) => S`                                     | Yes  | 初期 state を生成            |
-| `onState`      | `(state: S, myPlayerId: string, serverTime: number) => void` | Yes  | state 更新時のコールバック   |
-| `inputs`       | `(patch: PatchFn, set: SetFn) => void`                       | Yes  | 入力ハンドラ登録             |
-| `events`       | `Record<string, (data: Record<string, unknown>) => void>`    | No   | ゲームイベントハンドラ       |
-| `connection`   | `ConnectionCallbacks`                                        | No   | 接続状態・エラーコールバック |
-
-### PatchFn / SetFn
-
-```ts
-type PatchFn = (ops: Operation[]) => void; // 複数操作をまとめて送信
-type SetFn = (path: string, value: unknown) => void; // 単一パスの replace ショートカット
-```
-
-### Operation (JSON Patch)
-
-```ts
-interface Operation {
-  op: 'replace' | 'add' | 'remove';
-  path: string; // JSON Pointer パス (例: '/players/alice/score')
-  value?: unknown; // 値。SERVER_TIME sentinel 使用可
-}
-```
-
-### 楽観的更新
-
-`sync()` は送信した patch をローカルに即座に適用する。サーバーからの権威的な state を受信すると上書きする。
-
-**注意**: `sync()` は patch の条件を検証しない。同時に同じパスを変更すると後勝ちになる。条件付きの状態遷移が必要なら `run()` を使う。
-
----
-
-## パターン 3: run()
+## ゲームループ
 
 ### `run<S>(config: GameConfig<S>): void`
 
-Host-authoritative ゲームループを実行する。サーバー (GameRoom DO) が reducer を逐次実行するため、条件保証あり。
+ゲームループを開始する。state はサーバー (GameRoom DO) が持ち、送られた action を
+reducer で 1 件ずつ検証・実行して結果を全員へ配る。reducer は常にその時点の最新 state に
+対して走るので、同時操作で条件が壊れることがない。
 
 ```ts
 import { run } from '@uzuhq/code-sdk';
@@ -206,15 +75,14 @@ run({
 
 ### GameConfig
 
-| キー                      | 型                                                             | 必須 | 説明                                |
-| ------------------------- | -------------------------------------------------------------- | ---- | ----------------------------------- |
-| `logic`                   | `GameLogic<S>`                                                 | Yes  | ゲームロジック定義                  |
-| `onState`                 | `(state: S, myPlayerId: string) => void`                       | Yes  | state 更新時のコールバック          |
-| `inputs`                  | `(sendAction: (action: string, payload: any) => void) => void` | Yes  | 入力ハンドラ登録                    |
-| `events`                  | `Record<string, (data: any) => void>`                          | No   | ゲームイベントハンドラ              |
-| `playerCount`             | `number`                                                       | Yes  | プレイヤー数                        |
-| `onConnectionStateChange` | `(state: ConnectionState) => void`                             | No   | 接続状態変化コールバック            |
-| `onPatchFailed`           | `(reason: string) => void`                                     | No   | サーバー patch 適用失敗コールバック |
+| キー                      | 型                                                             | 必須 | 説明                       |
+| ------------------------- | -------------------------------------------------------------- | ---- | -------------------------- |
+| `logic`                   | `GameLogic<S>`                                                 | Yes  | ゲームロジック定義         |
+| `onState`                 | `(state: S, myPlayerId: string) => void`                       | Yes  | state 更新時のコールバック |
+| `inputs`                  | `(sendAction: (action: string, payload: any) => void) => void` | Yes  | 入力ハンドラ登録           |
+| `events`                  | `Record<string, (data: any) => void>`                          | No   | ゲームイベントハンドラ     |
+| `playerCount`             | `number`                                                       | Yes  | プレイヤー数               |
+| `onConnectionStateChange` | `(state: ConnectionState) => void`                             | No   | 接続状態変化コールバック   |
 
 ### GameLogic
 
@@ -479,17 +347,6 @@ on('attack', (payload) => {
 
 ---
 
-## SERVER_TIME
-
-サーバー時刻 sentinel 定数。Patch の `value` に指定すると、サーバー側で `Date.now()` に自動置換される。
-
-```ts
-import { SERVER_TIME } from '@uzuhq/code-sdk';
-set('/meta/phaseStartedAt', SERVER_TIME);
-```
-
----
-
 ## 型定義
 
 ### BridgeMessage
@@ -554,7 +411,6 @@ type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnect
 ```ts
 interface ConnectionCallbacks {
   onConnectionStateChange?: (state: ConnectionState) => void;
-  onPatchFailed?: (error: string) => void;
 }
 ```
 
@@ -578,7 +434,7 @@ interface PlayerVoiceState {
 
 ## URL パラメータ
 
-`init()` / `run()` / `sync()` は以下の URL パラメータを読み取る。
+`init()` / `run()` は以下の URL パラメータを読み取る。
 
 | パラメータ  | 説明                                          |
 | ----------- | --------------------------------------------- |
@@ -604,7 +460,6 @@ interface PlayerVoiceState {
 
 - `run()` の devHarness → **親 frame だけ** (`page.mainFrame()`)
 - `runLocalServerAction` (ソロモード) 単独 frame → その frame
-- sync 系単独 frame → その frame
 - devHarness の **子 iframe には attach しない**
 
 ```ts
@@ -653,7 +508,7 @@ await window.__uzu_dev.waitForSnapshot((s) => s.self.isReady === true);
   - 部分更新は `mergeRawState`、array 要素単体の書換は `patchRawState` を使う
   - `mergeRawState` で array field に non-array object patch を当てると **throw** する (array が pure object に化けるのを構造的に防止)
 - online ServerAction では 3 API すべて `undefined`
-- `send` は run devHarness 親 frame のみ。非 parent モード (runLocal / emulator / sync) では scenario 側の `window.__uzu.sendAction` を使う
+- `send` は run devHarness 親 frame のみ。非 parent モード (runLocal / emulator) では scenario 側の `window.__uzu.sendAction` を使う
 - `await d.send(...)` / `await d.*RawState(...)` は **(a) handler 完了 (b) parent state broadcast 投函** までを待つ。**子 iframe canvas の paint 完了は含まない** ので、screenshot / visual e2e test では `await new Promise(r => requestAnimationFrame(r))` を別途挟むこと
 - phase 遷移時の field reset や `markReady` 等の **state shape を仮定する helper は SDK には含めない**。scenario 側で `window.__<scene>_dev` を生やして上記 primitive を組み合わせる
 

package/dist/dev-globals.d.ts

@@ -1,4 +1,4 @@
-import { i as UzuDevHooks } from "./dev-hooks-DOtJHP55.js";
+import { r as UzuDevHooks } from "./dev-hooks-DmOV2p0j.js";
 //#region src/dev-globals.d.ts
 declare global {
   interface Window {
@@ -6,7 +6,7 @@ declare global {
      * dev harness / Playwright / 単独 page で attach される dev hooks。
      * 本番 (Flutter native ホスト) では undefined。
      * - run() devHarness: 親 frame に attach (authoritative state)
-     * - sync() / online: 子 frame で undefined
+     * - online: 子 frame で undefined
      */
     __uzu_dev?: UzuDevHooks<unknown>;
   }

package/dist/{dev-hooks-DOtJHP55.d.ts → dev-hooks-DmOV2p0j.d.ts}

@@ -352,25 +352,9 @@ interface GameLogic<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerA
   deadlines?: Record<string, Deadline<S>>;
   tickRate?: number;
 }
-/** Sentinel value — patch の value にセットすると、サーバーが Date.now() に置換する */
-declare const SERVER_TIME: "__SERVER_TIME__";
 /** デフォルトのプレイヤーアイコン URL 一覧（dev / local モード用） */
 declare const DEFAULT_ICON_URLS: readonly ["https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/4d0da24d-bcf2-4f7b-d1a0-f1bb8c747300/original", "https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/8c75fccb-41d6-429d-e943-06c728a72a00/original", "https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/43f45d11-da38-4d6e-637d-3df78e583500/original"];
 //#endregion
-//#region ../engine-core/src/json-patch.d.ts
-/**
- * @docs
- * - SyncRoom仕様: docs/docs/uzu_code/sync-room.md
- *
- * state 差分同期用の JSON Patch。RFC 6902 の全 op は実装せず、
- * `compare` が生成する replace / add / remove だけを扱う。
- */
-interface Operation {
-  op: 'replace' | 'add' | 'remove';
-  path: string;
-  value?: unknown;
-}
-//#endregion
 //#region src/types.d.ts
 /** @deprecated 旧フラット形式。新コードでは BridgeMessage を使用 */
 type PlayScreenMessage = {
@@ -474,29 +458,10 @@ interface GameConfig<S, A extends ActionMap<S> = ActionMap<S>, SA extends Server
    */
   devMinIframeShortEdge?: number;
 }
-type PatchFn = (ops: Operation[]) => void;
-type SetFn = (path: string, value: unknown) => void;
-interface SyncConfig<S = any> extends ConnectionCallbacks {
-  initialState: (players: Seat[]) => S;
-  onState: (state: S, myPlayerId: string, serverTime: number) => void;
-  inputs: (patch: PatchFn, set: SetFn) => void;
-  events?: Record<string, (data: Record<string, unknown>) => void>;
-  playerCount: number;
-  /** Dev harness のデフォルト向き。manifest.json の `orientation` を渡す。 */
-  orientation?: 'portrait' | 'landscape';
-  /**
-   * Dev harness で各 iframe inner viewport 短辺の下限 (CSS px)。
-   * default 360。狭い viewport では親 frame に `body { zoom: N }` を当てて
-   * iframe 内部の `window.innerWidth/Height` を保証する。
-   */
-  devMinIframeShortEdge?: number;
-}
 type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
 interface ConnectionCallbacks {
   /** WebSocket 接続状態が変化した時に呼ばれる */
   onConnectionStateChange?: (state: ConnectionState) => void;
-  /** サーバーで patch 適用が失敗した時に呼ばれる (sync モード専用) */
-  onPatchFailed?: (reason: string) => void;
 }
 //#endregion
 //#region src/host-globals.d.ts
@@ -671,23 +636,9 @@ interface RunHandle<S = unknown> {
   /** 既存 inputs と同等の action 送信 (dev hooks 用) */
   sendAction(type: string, payload?: Record<string, unknown>): void;
 }
-/**
- * sync/* モジュール (sync/dev / sync/local) が dev hooks に state を expose
- * するための handle。online sync では handle 自体を返さない。
- */
-interface SyncHandle<S = unknown> {
-  /** 内部 state の getter (dev hooks 用) */
-  getRawState?(): S | null;
-  /** 生 state 全置換 */
-  setRawState?(state: S): Promise<void>;
-  /** RFC 7396 風 Merge Patch */
-  mergeRawState?(patch: JsonMergePatch<S>): Promise<void>;
-  /** RFC 6902 JSON Patch */
-  patchRawState?(ops: JsonPatchOp[]): Promise<void>;
-}
 /**
  * dev-hooks.ts から見た「SDK 内部のコンテキスト」。
- * 各 run/* / sync/* モジュールがこの形の handle を組み立てて attachDevHooks に渡す。
+ * 各 run/* モジュールがこの形の handle を組み立てて attachDevHooks に渡す。
  */
 interface DevHooksCtx<S = unknown> {
   /** 最新 snapshot (per-player view)。未初期化なら null。 */
@@ -738,4 +689,4 @@ interface DevHooksCtx<S = unknown> {
 declare function createDevHooks<S>(ctx: DevHooksCtx<S>): UzuDevHooks<S>;
 declare function attachDevHooks<S>(ctx: DevHooksCtx<S>): void;
 //#endregion
-export { GameTime as $, DEFAULT_ICON_URLS as A, ServerActionContext as B, SetFn as C, ActionContext as D, ActionArgs as E, GameLogic as F, ServerOnlyActionContext as G, ServerActionMap as H, SERVER_TIME as I, SetupContext as J, ServerOnlyActionHandlerFn as K, Seat as L, DeadlineArgs as M, DeadlineContext as N, ActionHandler as O, Emit as P, GAME_START as Q, SeededRandom as R, SendAction as S, Operation as T, ServerEvent as U, ServerActionHandler as V, ServerOnlyAction as W, UpdateContext as X, UpdateArgs as Y, Duration as Z, PayloadMap as _, attachDevHooks as a, applyJsonMergePatch as at, PlayersChangedMessage as b, getPredictionWarnings as c, ConnectionCallbacks as d, minus as et, ConnectionState as f, PatchFn as g, GameConfig as h, UzuDevHooks as i, JsonPatchOp as it, Deadline as j, ActionMap as k, BridgeChannel as l, EventSubscription as m, RunHandle as n, sub as nt, createDevHooks as o, applyJsonPatch as ot, EventHandler as p, SetupArgs as q, SyncHandle as r, JsonMergePatch as rt, PredictionWarning as s, DevHooksCtx as t, plus as tt, BridgeMessage as u, PlayScreenMessage as v, SyncConfig as w, SeatKind as x, PlayerVoiceState as y, ServerActionArgs as z };
+export { applyJsonMergePatch as $, GameLogic as A, ServerOnlyActionHandlerFn as B, ActionHandler as C, DeadlineArgs as D, Deadline as E, ServerActionHandler as F, Duration as G, SetupContext as H, ServerActionMap as I, minus as J, GAME_START as K, ServerEvent as L, SeededRandom as M, ServerActionArgs as N, DeadlineContext as O, ServerActionContext as P, JsonPatchOp as Q, ServerOnlyAction as R, ActionContext as S, DEFAULT_ICON_URLS as T, UpdateArgs as U, SetupArgs as V, UpdateContext as W, sub as X, plus as Y, JsonMergePatch as Z, PlayerVoiceState as _, createDevHooks as a, SendAction as b, BridgeChannel as c, ConnectionState as d, applyJsonPatch as et, EventHandler as f, PlayScreenMessage as g, PayloadMap as h, attachDevHooks as i, Seat as j, Emit as k, BridgeMessage as l, GameConfig as m, RunHandle as n, PredictionWarning as o, EventSubscription as p, GameTime as q, UzuDevHooks as r, getPredictionWarnings as s, DevHooksCtx as t, ConnectionCallbacks as u, PlayersChangedMessage as v, ActionMap as w, ActionArgs as x, SeatKind as y, ServerOnlyActionContext as z };

package/dist/index.d.ts

@@ -1,4 +1,18 @@
-import { $ as GameTime, A as DEFAULT_ICON_URLS, B as ServerActionContext, C as SetFn, D as ActionContext, E as ActionArgs, F as GameLogic, G as ServerOnlyActionContext, H as ServerActionMap, I as SERVER_TIME, J as SetupContext, K as ServerOnlyActionHandlerFn, L as Seat, M as DeadlineArgs, N as DeadlineContext, O as ActionHandler, P as Emit, Q as GAME_START, R as SeededRandom, S as SendAction, T as Operation, U as ServerEvent, V as ServerActionHandler, W as ServerOnlyAction, X as UpdateContext, Y as UpdateArgs, Z as Duration, _ as PayloadMap, a as attachDevHooks, at as applyJsonMergePatch, b as PlayersChangedMessage, c as getPredictionWarnings, d as ConnectionCallbacks, et as minus, f as ConnectionState, g as PatchFn, h as GameConfig, i as UzuDevHooks, it as JsonPatchOp, j as Deadline, k as ActionMap, l as BridgeChannel, m as EventSubscription, n as RunHandle, nt as sub, o as createDevHooks, ot as applyJsonPatch, p as EventHandler, q as SetupArgs, r as SyncHandle, rt as JsonMergePatch, s as PredictionWarning, t as DevHooksCtx, tt as plus, u as BridgeMessage, v as PlayScreenMessage, w as SyncConfig, x as SeatKind, y as PlayerVoiceState, z as ServerActionArgs } from "./dev-hooks-DOtJHP55.js";
+import { $ as applyJsonMergePatch, A as GameLogic, B as ServerOnlyActionHandlerFn, C as ActionHandler, D as DeadlineArgs, E as Deadline, F as ServerActionHandler, G as Duration, H as SetupContext, I as ServerActionMap, J as minus, K as GAME_START, L as ServerEvent, M as SeededRandom, N as ServerActionArgs, O as DeadlineContext, P as ServerActionContext, Q as JsonPatchOp, R as ServerOnlyAction, S as ActionContext, T as DEFAULT_ICON_URLS, U as UpdateArgs, V as SetupArgs, W as UpdateContext, X as sub, Y as plus, Z as JsonMergePatch, _ as PlayerVoiceState, a as createDevHooks, b as SendAction, c as BridgeChannel, d as ConnectionState, et as applyJsonPatch, f as EventHandler, g as PlayScreenMessage, h as PayloadMap, i as attachDevHooks, j as Seat, k as Emit, l as BridgeMessage, m as GameConfig, n as RunHandle, o as PredictionWarning, p as EventSubscription, q as GameTime, r as UzuDevHooks, s as getPredictionWarnings, t as DevHooksCtx, u as ConnectionCallbacks, v as PlayersChangedMessage, w as ActionMap, x as ActionArgs, y as SeatKind, z as ServerOnlyActionContext } from "./dev-hooks-DmOV2p0j.js";
+//#region ../engine-core/src/json-patch.d.ts
+/**
+ * @docs
+ * - play-server 仕様: docs/docs/uzu_code/play-server.md
+ *
+ * state 差分同期用の JSON Patch。RFC 6902 の全 op は実装せず、
+ * `compare` が生成する replace / add / remove だけを扱う。
+ */
+interface Operation {
+  op: 'replace' | 'add' | 'remove';
+  path: string;
+  value?: unknown;
+}
+//#endregion
 //#region ../engine-core/src/random.d.ts
 declare class SeededRandomImpl implements SeededRandom {
   private _state;
@@ -45,30 +59,6 @@ declare function isPaused(): boolean;
 /** 停止状態の変化を購読する。 */
 declare function onPauseChange(cb: (paused: boolean) => void): void;
 //#endregion
-//#region src/room.d.ts
-type RoomMessageHandler = (data: Record<string, unknown>) => void;
-/** WebSocket 互換の send/addEventListener インターフェース */
-interface WebSocketLike {
-  send(data: string): void;
-  addEventListener(type: 'message', handler: (ev: MessageEvent) => void): void;
-}
-/** Room の公開インターフェース。WebSocket / BroadcastChannel どちらでも実装可能。 */
-interface RoomLike {
-  readonly myId: string;
-  broadcast(msg: Record<string, unknown>): void;
-  send(id: string, msg: Record<string, unknown>): void;
-  on(type: string, handler: RoomMessageHandler): void;
-}
-declare class Room implements RoomLike {
-  readonly myId: string;
-  private ws;
-  private handlers;
-  constructor(ws: WebSocketLike, myId: string);
-  broadcast(msg: Record<string, unknown>): void;
-  send(id: string, msg: Record<string, unknown>): void;
-  on(type: string, handler: RoomMessageHandler): void;
-}
-//#endregion
 //#region src/reconnectable-ws.d.ts
 /**
  * 自動再接続 WebSocket ラッパー
@@ -135,11 +125,7 @@ declare class ReconnectableWebSocket {
 type GameMessageHandler = (payload: Record<string, unknown>) => void;
 type PlayersChangedHandler = (players: Record<string, PlayerVoiceState>) => void;
 declare const isHosted: boolean;
-declare function getRoom(): RoomLike | null;
-declare function onRoom(callback: (room: RoomLike) => void): void;
 declare function init(opts?: {
-  wsEndpoint?: string;
-  syncEndpoint?: string;
   playerCount?: number;
   orientation?: 'portrait' | 'landscape';
   /**
@@ -203,6 +189,5 @@ declare function onPlayersChanged(handler: PlayersChangedHandler): void;
  * `serverActions` を持たない logic でもキーが残るよう空 map を既定にする。
  */
 declare function run<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = Record<never, never>>(config: GameConfig<S, A, SA>): void;
-declare function sync<S>(config: SyncConfig<S>): void;
 //#endregion
-export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, type JsonMergePatch, type JsonPatchOp, type Operation, type PatchFn, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, Room, type RoomLike, type RunHandle, SERVER_TIME, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetFn, type SetupArgs, type SetupContext, type SyncConfig, type SyncHandle, type UpdateArgs, type UpdateContext, type UzuDevHooks, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, getRoom, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, onRoom, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub, sync };
+export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, type JsonMergePatch, type JsonPatchOp, type Operation, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, type RunHandle, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetupArgs, type SetupContext, type UpdateArgs, type UpdateContext, type UzuDevHooks, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };

package/dist/index.js

@@ -1,6 +1,4 @@
 //#region ../engine-core/src/types.ts
-/** Sentinel value — patch の value にセットすると、サーバーが Date.now() に置換する */
-const SERVER_TIME = "__SERVER_TIME__";
 /** デフォルトのプレイヤーアイコン URL 一覧（dev / local モード用） */
 const DEFAULT_ICON_URLS = [
 	"https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/4d0da24d-bcf2-4f7b-d1a0-f1bb8c747300/original",
@@ -284,7 +282,7 @@ function isServerOnlyAction(handler) {
 //#region src/server-clock.ts
 /**
 * @docs
-* - ServerAction仕様: docs/docs/uzu_code/connection-method/arch3-authority.md
+* - play-server 仕様: docs/docs/uzu_code/play-server.md
 * - 緊急停止とゲーム内時計: docs/docs/uzu_code/emergency-stop.md
 *
 * サーバーのゲーム内時計の推定値をクライアント全体へ配る。
@@ -400,46 +398,6 @@ function requestResume() {
 	requester(false);
 }
 //#endregion
-//#region src/room.ts
-var Room = class {
-	constructor(ws, myId) {
-		this.handlers = /* @__PURE__ */ new Map();
-		this.ws = ws;
-		this.myId = myId;
-		this.ws.addEventListener("message", (ev) => {
-			let parsed;
-			try {
-				parsed = JSON.parse(ev.data);
-			} catch {
-				return;
-			}
-			const type = parsed.type;
-			if (!type) return;
-			const from = parsed.__from;
-			console.log(`[SDK Room] ⬅ recv type=${type} from=${from}`, JSON.stringify(parsed));
-			(this.handlers.get(type) || []).forEach((h) => h({
-				...parsed,
-				__from: from
-			}));
-		});
-	}
-	broadcast(msg) {
-		console.log(`[SDK Room] ➡ broadcast type=${msg.type}`, JSON.stringify(msg));
-		this.ws.send(JSON.stringify(msg));
-	}
-	send(id, msg) {
-		console.log(`[SDK Room] ➡ send to=${id} type=${msg.type}`, JSON.stringify(msg));
-		this.ws.send(JSON.stringify({
-			...msg,
-			__to: id
-		}));
-	}
-	on(type, handler) {
-		if (!this.handlers.has(type)) this.handlers.set(type, []);
-		this.handlers.get(type).push(handler);
-	}
-};
-//#endregion
 //#region src/reconnectable-ws.ts
 const DEFAULTS = {
 	maxReconnectAttempts: 15,
@@ -1310,15 +1268,12 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 		id: p.id,
 		name: p.nickname,
 		iconUrl: p.iconUrl,
-		characterId: p.characterId,
-		kind: "player"
+		characterId: p.characterId
 	});
-	const roster = JSON.stringify(players.map(toWire));
 	const wsUrl = `${gameEndpoint}/${roomId}?${new URLSearchParams({
 		seatId,
 		nickname: "Player",
-		players: roster,
-		seats: roster
+		players: JSON.stringify(players.map(toWire))
 	})}`;
 	console.log(`[SDK ServerAction] 🔗 Connecting wsUrl=${wsUrl}`);
 	const ws = new ReconnectableWebSocket(wsUrl, {
@@ -1567,7 +1522,6 @@ function runLocalServerAction(config) {
 	const setupTime = gameTime();
 	const setupArgs = {
 		players,
-		seats: players,
 		ctx: {
 			random,
 			...timeCtx(setupTime)
@@ -1703,217 +1657,15 @@ function runLocalServerAction(config) {
 	};
 }
 //#endregion
-//#region src/sync/local.ts
-function resolveLocalTime(ops) {
-	const now = Date.now();
-	return ops.map((op) => op.value === "__SERVER_TIME__" ? {
-		...op,
-		value: now
-	} : op);
-}
-function syncLocal(config) {
-	const { initialState, onState, inputs, events: _events } = config;
-	const localCount = config.playerCount;
-	const players = [];
-	for (let i = 0; i < localCount; i++) players.push({
-		id: `local_${i}`,
-		nickname: `Player ${i + 1}`,
-		iconUrl: DEFAULT_ICON_URLS[i % DEFAULT_ICON_URLS.length]
-	});
-	let state = initialState(players);
-	const myId = players[0].id;
-	const patchFn = (ops) => {
-		applyPatch(state, resolveLocalTime(ops));
-		onState(state, myId, Date.now());
-	};
-	const setFn = (path, value) => {
-		patchFn([{
-			op: "replace",
-			path,
-			value
-		}]);
-	};
-	inputs(patchFn, setFn);
-	onState(state, myId, Date.now());
-	setInterval(() => {
-		onState(state, myId, Date.now());
-	}, 100);
-	return {
-		getRawState: () => state,
-		setRawState: async (next) => {
-			state = next;
-			onState(state, myId, Date.now());
-		},
-		mergeRawState: async (patch) => {
-			applyJsonMergePatch(state, patch);
-			onState(state, myId, Date.now());
-		},
-		patchRawState: async (ops) => {
-			applyJsonPatch(state, ops);
-			onState(state, myId, Date.now());
-		}
-	};
-}
-//#endregion
-//#region src/sync/online.ts
-function syncOnline(config, syncEndpoint, roomId, playerId, hostPlayers) {
-	const { initialState, onState, inputs, events: _events } = config;
-	const wsUrl = `${syncEndpoint}/${roomId}?playerId=${encodeURIComponent(playerId)}`;
-	console.log(`[SDK Sync] 🔗 Connecting wsUrl=${wsUrl}`);
-	const ws = new ReconnectableWebSocket(wsUrl, {
-		onConnectionStateChange: (state) => {
-			console.log(`[SDK Sync] 📡 Connection state: ${state}`);
-			config.onConnectionStateChange?.(state);
-		},
-		shouldBuffer: (data) => {
-			try {
-				const parsed = JSON.parse(data);
-				return parsed.type !== "__patch" && parsed.type !== "__patch_ack";
-			} catch {
-				return true;
-			}
-		}
-	});
-	const myId = playerId;
-	const players = hostPlayers;
-	let state = null;
-	let gameInitSent = false;
-	let serverTimeOffset = 0;
-	let localSeq = 0;
-	let requestStatePending = false;
-	const estimateServerTime = () => Date.now() + serverTimeOffset;
-	const resolveToServerTime = (ops) => {
-		const now = estimateServerTime();
-		return ops.map((op) => op.value === "__SERVER_TIME__" ? {
-			...op,
-			value: now
-		} : op);
-	};
-	const sendPatch = (ops) => {
-		if (!ops || ops.length === 0) return;
-		if (state) {
-			applyPatch(state, resolveToServerTime(ops));
-			onState(state, myId, estimateServerTime());
-		}
-		console.log(`[SDK Sync] ➡ send __patch ops=${ops.length}`, JSON.stringify(ops));
-		ws.send(JSON.stringify({
-			type: "__patch",
-			ops
-		}));
-	};
-	const sendSet = (path, value) => {
-		sendPatch([{
-			op: "replace",
-			path,
-			value
-		}]);
-	};
-	inputs(sendPatch, sendSet);
-	setInterval(() => {
-		if (state) onState(state, myId, estimateServerTime());
-	}, 100);
-	const tryInitState = () => {
-		if (gameInitSent) return;
-		gameInitSent = true;
-		const initState = initialState(players);
-		console.log(`[SDK Sync] ➡ send __init_state players=${players.length}`);
-		ws.send(JSON.stringify({
-			type: "__init_state",
-			state: initState
-		}));
-	};
-	ws.addEventListener("message", (ev) => {
-		let parsed;
-		try {
-			parsed = JSON.parse(ev.data);
-		} catch {
-			return;
-		}
-		const msgType = parsed.type;
-		console.log(`[SDK Sync] ⬅ recv type=${msgType}`, JSON.stringify(parsed));
-		if (msgType === "__room_init") {
-			console.log(`[SDK Sync] ✅ Room init myId=${myId} players=${players.length}`);
-			tryInitState();
-			return;
-		}
-		if (msgType === "__reconnected") {
-			console.log(`[SDK Sync] 🔄 Reconnected myId=${myId}`);
-			if (!gameInitSent) tryInitState();
-			return;
-		}
-		if (msgType === "__state_cleared") {
-			console.log(`[SDK Sync] 🗑 State cleared, reinitializing`);
-			state = null;
-			localSeq = 0;
-			requestStatePending = false;
-			gameInitSent = false;
-			tryInitState();
-			return;
-		}
-		if (msgType === "__patch_failed") {
-			console.log(`[SDK Sync] ⚠️ Patch failed: ${parsed.reason}`);
-			config.onPatchFailed?.(parsed.reason);
-			return;
-		}
-		if (msgType === "__patch_ack") {
-			if (!state) return;
-			const ackSeq = parsed.seq ?? 0;
-			const ackSenderId = parsed.senderId;
-			const ackOps = parsed.ops;
-			const serverTime = parsed.serverTime;
-			if (ackSenderId === myId) {
-				localSeq = ackSeq;
-				serverTimeOffset = serverTime - Date.now();
-				return;
-			}
-			if (requestStatePending) return;
-			if (ackSeq === localSeq + 1) {
-				if (!applyPatch(state, ackOps)) {
-					console.log(`[SDK Sync] ⚠️ Local applyPatch failed, requesting full state`);
-					requestStatePending = true;
-					ws.send(JSON.stringify({ type: "__request_state" }));
-					return;
-				}
-				localSeq = ackSeq;
-				serverTimeOffset = serverTime - Date.now();
-				onState(state, myId, serverTime);
-			} else if (ackSeq > localSeq + 1) {
-				console.log(`[SDK Sync] ⚠️ Seq gap detected: expected=${localSeq + 1} received=${ackSeq}, requesting full state`);
-				requestStatePending = true;
-				ws.send(JSON.stringify({ type: "__request_state" }));
-			}
-			return;
-		}
-		if (msgType === "__state") {
-			state = parsed.state;
-			const serverTime = parsed.serverTime;
-			localSeq = parsed.seq ?? 0;
-			requestStatePending = false;
-			serverTimeOffset = serverTime - Date.now();
-			console.log(`[SDK Sync] ✅ State received serverTime=${serverTime} offset=${serverTimeOffset} seq=${localSeq}`);
-			ws.clearBuffer();
-			onState(state, myId, serverTime);
-			return;
-		}
-	});
-	return { ws };
-}
-//#endregion
 //#region src/index.ts
 const gameHandlers = /* @__PURE__ */ new Map();
 const _playersChangedHandlers = [];
-let _room = null;
 let _lastStateSnap = null;
-let _onRoomCallbacks = [];
-let _wsEndpoint = null;
-let _syncEndpoint = null;
 let _gameEndpoint = null;
-let _syncWs = null;
 let _initialized = false;
 let _usesRun = false;
 let _playerId = null;
 let _runHandle = null;
-let _syncHandle = null;
 const _snapshotListeners = /* @__PURE__ */ new Set();
 function notifyDevSnapshot(snap) {
 	_snapshotListeners.forEach((cb) => {
@@ -1928,10 +1680,10 @@ function attachDevHooksIfNotHosted() {
 	if (window.FlutterHost) return;
 	attachDevHooks({
 		getSnapshot: () => _lastStateSnap?.state ?? null,
-		getRawState: _runHandle?.getRawState ?? _syncHandle?.getRawState,
-		setRawState: _runHandle?.setRawState ?? _syncHandle?.setRawState,
-		mergeRawState: _runHandle?.mergeRawState ?? _syncHandle?.mergeRawState,
-		patchRawState: _runHandle?.patchRawState ?? _syncHandle?.patchRawState,
+		getRawState: _runHandle?.getRawState,
+		setRawState: _runHandle?.setRawState,
+		mergeRawState: _runHandle?.mergeRawState,
+		patchRawState: _runHandle?.patchRawState,
 		playerId: () => _lastStateSnap?.myId ?? _playerId,
 		subscribeSnapshot: (cb) => {
 			_snapshotListeners.add(cb);
@@ -1942,13 +1694,6 @@ function attachDevHooksIfNotHosted() {
 	});
 }
 const isHosted = typeof window !== "undefined" && (!!window.FlutterHost || window.parent !== window);
-function getRoom() {
-	return _room;
-}
-function onRoom(callback) {
-	if (_room) callback(_room);
-	else _onRoomCallbacks.push(callback);
-}
 function init(opts) {
 	const params = new URLSearchParams(window.location.search);
 	_playerId = params.get("seatId");
@@ -1956,14 +1701,10 @@ function init(opts) {
 	const serverParam = params.get("server");
 	if (serverParam && serverParam.length > 0) {
 		const base = serverParam.replace(/\/$/, "");
-		_wsEndpoint = `${base}/ws/rooms`;
-		_syncEndpoint = `${base}/ws/sync`;
 		const revisionId = params.get("revisionId");
 		if (!revisionId) throw new Error("[UZU SDK] revisionId is required when server is specified. Pass ?revisionId=xxx in the URL.");
 		_gameEndpoint = `${base}/ws/games/${revisionId}`;
 	}
-	if (opts?.wsEndpoint) _wsEndpoint = opts.wsEndpoint;
-	if (opts?.syncEndpoint) _syncEndpoint = opts.syncEndpoint;
 	if (!isHosted) return;
 	if (!_initialized) {
 		window.__ps = { onMessage: (msg) => {
@@ -1993,13 +1734,6 @@ function init(opts) {
 		sendRaw("sdk", "ready", {});
 		_initialized = true;
 	}
-	if (!_usesRun) {
-		const roomIdParam = params.get("roomId");
-		if (roomIdParam) {
-			if (_wsEndpoint) connectRoom(roomIdParam);
-			else console.warn("[SDK] roomId is present but server is not configured — skipping Relay connection");
-		}
-	}
 	if (!_usesRun) attachDevHooksIfNotHosted();
 }
 /** game channel でカスタムメッセージを送信する。 native コマンドには使用不可。 */
@@ -2104,33 +1838,6 @@ function run(config) {
 	} else throw new Error("[UZU SDK] roomId is set but ?server= is missing. Multiplayer requires a WebSocket server URL — pass ?server=ws://host:port in the URL.");
 	attachDevHooksIfNotHosted();
 }
-function sync(config) {
-	_usesRun = true;
-	const params = new URLSearchParams(window.location.search);
-	if (!isHosted) return;
-	init();
-	const origOnState = config.onState;
-	const wrappedConfig = {
-		...config,
-		onState(state, myPlayerId, serverTime) {
-			_lastStateSnap = {
-				state,
-				serverTime,
-				myId: myPlayerId
-			};
-			origOnState(state, myPlayerId, serverTime);
-			notifyDevSnapshot(state);
-		}
-	};
-	const roomId = params.get("roomId");
-	if (!roomId) _syncHandle = syncLocal(wrappedConfig);
-	else if (_syncEndpoint) {
-		const { seatId, players } = resolveSeatParams(params);
-		const { ws } = syncOnline(wrappedConfig, _syncEndpoint, roomId, seatId, players);
-		_syncWs = ws;
-	} else throw new Error("[UZU SDK] roomId is set but ?server= is missing. Multiplayer sync requires a WebSocket server URL — pass ?server=ws://host:port in the URL.");
-	attachDevHooksIfNotHosted();
-}
 /**
 * 自分の席種別を URL から取り出す。
 *
@@ -2149,13 +1856,11 @@ function resolveSeatKind(params) {
 *
 * 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("players") ?? params.get("seats");
+	const json = params.get("players");
 	if (!json) throw new Error("[UZU SDK] players is required. Pass ?players=[...] in the URL.");
 	return {
 		seatId,
@@ -2167,33 +1872,6 @@ function resolveSeatParams(params) {
 		}))
 	};
 }
-function requireEndpoint(endpoint, name) {
-	if (!endpoint) throw new Error(`[UZU SDK] ${name} is not configured. Pass ?server=ws://host:port or call init({ wsEndpoint, syncEndpoint }).`);
-	return endpoint;
-}
-function connectRoom(roomId) {
-	const { seatId } = resolveSeatParams(new URLSearchParams(window.location.search));
-	const wsParams = new URLSearchParams({ playerId: seatId });
-	const wsUrl = `${requireEndpoint(_wsEndpoint, "wsEndpoint")}/${roomId}?${wsParams}`;
-	console.log(`[SDK] 🔗 connectRoom wsUrl=${wsUrl}`);
-	const ws = new ReconnectableWebSocket(wsUrl);
-	ws.addEventListener("message", (ev) => {
-		let parsed;
-		try {
-			parsed = JSON.parse(ev.data);
-		} catch {
-			return;
-		}
-		console.log(`[SDK] ⬅ recv ws type=${parsed.type}`, JSON.stringify(parsed));
-		if (parsed.type === "__room_init") {
-			const myId = parsed.myId;
-			console.log(`[SDK] ✅ Room initialized myId=${myId}`);
-			_room = new Room(ws, myId);
-			_onRoomCallbacks.forEach((cb) => cb(_room));
-			_onRoomCallbacks = [];
-		} else if (parsed.type === "__reconnected") console.log(`[SDK] 🔄 Room reconnected`);
-	});
-}
 /** 内部送信関数。 channel + type + payload のエンベロープで送信する。 */
 function sendRaw(channel, type, payload) {
 	const msg = {
@@ -2214,10 +1892,6 @@ function handleMessage(msg) {
 				console.log(`[SDK] 🔧 handleMessage sdk/getState → responding`);
 				sendRaw("sdk", "stateResponse", { state: _lastStateSnap });
 				return;
-			case "clearState":
-				console.log(`[SDK] 🗑 handleMessage sdk/clearState → forwarding to server`);
-				if (_syncWs && _syncWs.connectionState === "connected") _syncWs.send(JSON.stringify({ type: "__clear_state" }));
-				return;
 			case "playersChanged": {
 				const players = payload?.players ?? {};
 				_playersChangedHandlers.forEach((fn) => fn(players));
@@ -2257,7 +1931,7 @@ const ACTION_ITEM_WIDTH = 38;
 function calcHudInsets(params) {
 	const y = 52;
 	let actionCount = 2;
-	const json = params.get("players") ?? params.get("seats");
+	const json = params.get("players");
 	if (json) try {
 		actionCount = JSON.parse(json).length >= 2 ? 2 : 0;
 	} catch {}
@@ -2269,4 +1943,4 @@ function calcHudInsets(params) {
 	};
 }
 //#endregion
-export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, Room, SERVER_TIME, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, getRoom, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, onRoom, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub, sync };
+export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };

package/package.json

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