def-game 5.1.0-timeout.0 → 6.1.0

package/templates/worker/session.ts

@@ -1,100 +0,0 @@
-import { DurableObject } from "cloudflare:workers";
-import { gameAdapter, type State, type ServerMessage, type ProtocolError } from __ADAPTER_IMPORT__;
-import type { Env } from "./env.js";
-import { isRecord, parseCommandRequest } from "./runtime/parse.js";
-
-const STATE_KEY = "game-state";
-
-/** 生成対象の Session runtime。ゲーム固有の判断は gameAdapter だけを通して呼ぶ。 */
-export class SessionDurableObject extends DurableObject<Env> {
-  // State の独自キャッシュを持たない。再起動時にも Storage と attachment だけで復元する。
-  async fetch(request: Request): Promise<Response> {
-    return this.ctx.blockConcurrencyWhile(async () => {
-      const actorId = request.headers.get("x-actor-id");
-      const fail = (code: ProtocolError["code"], status: number) => Response.json({ ok: false, error: { code } }, { status });
-      if (!actorId) return fail("AuthenticationRequired", 401);
-      const path = new URL(request.url).pathname;
-      const stored = await this.ctx.storage.get<State>(STATE_KEY);
-      if (path === "/connect" && request.method === "GET") {
-        if (stored === undefined) return fail("SessionNotFound", 404);
-        if (!gameAdapter.canConnect(stored, actorId)) return fail("NotSessionMember", 403);
-        const viewState = gameAdapter.game.project(stored, actorId);
-        const pair = new WebSocketPair();
-        pair[1].serializeAttachment({ actorId });
-        this.ctx.acceptWebSocket(pair[1]);
-        this.send(pair[1], { type: "ViewStateEvent", viewState });
-        return new Response(null, { status: 101, webSocket: pair[0] });
-      }
-      if (request.method !== "POST" || (path !== "/create" && path !== "/join")) return fail("InvalidRequest", 400);
-      if (path === "/create" && stored !== undefined) return fail("InvalidRequest", 409);
-      if (path === "/join" && stored === undefined) return fail("SessionNotFound", 404);
-      let body: unknown;
-      try { body = await request.json(); } catch { return fail("InvalidRequest", 400); }
-      const command = path === "/create" ? gameAdapter.parseCreate(body) : gameAdapter.parseJoin(body);
-      if (command === null) return fail("InvalidRequest", 400);
-      const result = gameAdapter.game.handleCommand(stored === undefined ? gameAdapter.game.createInitialState() : stored, command, { origin: "actor", actorId });
-      if (!result.ok) return Response.json(result, { status: 409 });
-      // 作成と作成者の参加は、この1回の保存で確定する。
-      if (result.state !== stored) {
-        await this.ctx.storage.put(STATE_KEY, result.state);
-        this.broadcast(result.state);
-      }
-      return Response.json({ ok: true });
-    });
-  }
-
-  async webSocketMessage(socket: WebSocket, raw: string | ArrayBuffer): Promise<void> {
-    await this.ctx.blockConcurrencyWhile(async () => {
-      const parsed = parseCommandRequest(raw);
-      const command = parsed ? gameAdapter.parseCommand(parsed.command) : null;
-      if (!parsed || command === null) {
-        this.send(socket, { type: "ProtocolErrorEvent", error: { code: "InvalidRequest" } });
-        return;
-      }
-      try {
-        const attachment: unknown = socket.deserializeAttachment();
-        const state = await this.ctx.storage.get<State>(STATE_KEY);
-        if (state === undefined || !isRecord(attachment) || typeof attachment.actorId !== "string" || !gameAdapter.canConnect(state, attachment.actorId)) {
-          this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: { code: "NotSessionMember" } });
-          return;
-        }
-        const result = gameAdapter.game.handleCommand(state, command, { origin: "actor", actorId: attachment.actorId });
-        if (!result.ok) {
-          this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: result.error });
-          return;
-        }
-        await this.ctx.storage.put(STATE_KEY, result.state);
-        // Effect は現在 never。実装時もこの保存の後に実行し、配送失敗で rollback しない。
-        this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: true });
-        this.broadcast(result.state);
-      } catch {
-        console.error("Session command failed");
-        this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: { code: "InternalError" } });
-      }
-    });
-  }
-
-  private broadcast(state: State): void {
-    for (const socket of this.ctx.getWebSockets()) {
-      try {
-        const attachment: unknown = socket.deserializeAttachment();
-        if (!isRecord(attachment) || typeof attachment.actorId !== "string" || !gameAdapter.canConnect(state, attachment.actorId)) continue;
-        this.send(socket, { type: "ViewStateEvent", viewState: gameAdapter.game.project(state, attachment.actorId) });
-      } catch {
-        console.error("Session view delivery failed");
-        this.close(socket);
-      }
-    }
-  }
-
-  private send(socket: WebSocket, message: ServerMessage): void {
-    try { socket.send(JSON.stringify(message)); } catch { this.close(socket); }
-  }
-
-  private close(socket: WebSocket): void {
-    try { socket.close(1011, "Delivery failed"); } catch { /* 切断済み。確定済みの保存結果へ影響させない。 */ }
-  }
-
-  webSocketClose(socket: WebSocket, code: number, reason: string): void { socket.close(code, reason); }
-  webSocketError(socket: WebSocket): void { socket.close(1011, "Connection error"); }
-}

package/templates/worker/timeout/runtime/game-adapter.ts

@@ -1,18 +0,0 @@
-import type { GameDefinition } from "def-game";
-
-export type TimeoutEffect =
-  | { readonly type: "schedule"; readonly decisionId: string; readonly deadline: number }
-  | { readonly type: "cancel"; readonly decisionId: string };
-
-/** Runtime never interprets State. The adapter translates game effects and timeout commands. */
-export interface GameAdapter<State, Command, View, Error, Effect = never> {
-  readonly game: GameDefinition<State, Command, string, View, Effect, Error>;
-  readonly parseCreate: (input: unknown) => Command | null;
-  readonly parseJoin: (input: unknown) => Command | null;
-  readonly parseCommand: (input: unknown) => Command | null;
-  readonly canConnect: (state: State, actorId: string) => boolean;
-  readonly timeout?: {
-    readonly effect: (effect: Effect) => TimeoutEffect;
-    readonly command: (decisionId: string) => Command;
-  };
-}

package/templates/worker/timeout/session.ts

@@ -1,152 +0,0 @@
-import { DurableObject } from "cloudflare:workers";
-import { gameAdapter, type State, type ServerMessage, type ProtocolError } from __ADAPTER_IMPORT__;
-import type { Env } from "./env.js";
-import { isRecord, parseCommandRequest } from "./runtime/parse.js";
-
-const STATE_KEY = "game-state";
-const TIMEOUT_KEY = "decision-timeout";
-type Reservation = { decisionId: string; deadline: number };
-type Success = Extract<ReturnType<typeof gameAdapter.game.handleCommand>, { ok: true }>;
-
-/** 生成対象の Session runtime。ゲーム固有の判断は gameAdapter だけを通して呼ぶ。 */
-export class SessionDurableObject extends DurableObject<Env> {
-  // State の独自キャッシュを持たない。再起動時にも Storage と attachment だけで復元する。
-  async fetch(request: Request): Promise<Response> {
-    return this.ctx.blockConcurrencyWhile(async () => {
-      const actorId = request.headers.get("x-actor-id");
-      const fail = (code: ProtocolError["code"], status: number) => Response.json({ ok: false, error: { code } }, { status });
-      if (!actorId) return fail("AuthenticationRequired", 401);
-      const path = new URL(request.url).pathname;
-      const stored = await this.ctx.storage.get<State>(STATE_KEY);
-      if (path === "/connect" && request.method === "GET") {
-        if (stored === undefined) return fail("SessionNotFound", 404);
-        if (!gameAdapter.canConnect(stored, actorId)) return fail("NotSessionMember", 403);
-        const viewState = gameAdapter.game.project(stored, actorId);
-        const pair = new WebSocketPair();
-        pair[1].serializeAttachment({ actorId });
-        this.ctx.acceptWebSocket(pair[1]);
-        this.send(pair[1], { type: "ViewStateEvent", viewState });
-        return new Response(null, { status: 101, webSocket: pair[0] });
-      }
-      if (request.method !== "POST" || (path !== "/create" && path !== "/join")) return fail("InvalidRequest", 400);
-      if (path === "/create" && stored !== undefined) return fail("InvalidRequest", 409);
-      if (path === "/join" && stored === undefined) return fail("SessionNotFound", 404);
-      let body: unknown;
-      try { body = await request.json(); } catch { return fail("InvalidRequest", 400); }
-      const command = path === "/create" ? gameAdapter.parseCreate(body) : gameAdapter.parseJoin(body);
-      if (command === null) return fail("InvalidRequest", 400);
-      const result = gameAdapter.game.handleCommand(stored === undefined ? gameAdapter.game.createInitialState() : stored, command, { origin: "actor", actorId });
-      if (!result.ok) return Response.json(result, { status: 409 });
-      // 作成と作成者の参加は、この1回の保存で確定する。
-      if (result.state !== stored || result.effects.length > 0) {
-        try { await this.commit(result); } catch { return fail("InternalError", 500); }
-        this.broadcast(result.state);
-      }
-      return Response.json({ ok: true });
-    });
-  }
-
-  async webSocketMessage(socket: WebSocket, raw: string | ArrayBuffer): Promise<void> {
-    await this.ctx.blockConcurrencyWhile(async () => {
-      const parsed = parseCommandRequest(raw);
-      const command = parsed ? gameAdapter.parseCommand(parsed.command) : null;
-      if (!parsed || command === null) {
-        this.send(socket, { type: "ProtocolErrorEvent", error: { code: "InvalidRequest" } });
-        return;
-      }
-      try {
-        const attachment: unknown = socket.deserializeAttachment();
-        const state = await this.ctx.storage.get<State>(STATE_KEY);
-        if (state === undefined || !isRecord(attachment) || typeof attachment.actorId !== "string" || !gameAdapter.canConnect(state, attachment.actorId)) {
-          this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: { code: "NotSessionMember" } });
-          return;
-        }
-        const result = gameAdapter.game.handleCommand(state, command, { origin: "actor", actorId: attachment.actorId });
-        if (!result.ok) {
-          this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: result.error });
-          return;
-        }
-        await this.commit(result);
-        this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: true });
-        this.broadcast(result.state);
-      } catch {
-        console.error("Session command failed");
-        this.send(socket, { type: "GameCommandResponse", requestId: parsed.requestId, ok: false, error: { code: "InternalError" } });
-      }
-    });
-  }
-
-  /** Commit state, reservation and alarm together. No external effects inside the transaction. */
-  private async commit(result: Success, consumedDecisionId?: string): Promise<void> {
-    const effects = result.effects.map(effect => {
-      if (!gameAdapter.timeout) throw new Error("Timeout adapter required for effects");
-      return gameAdapter.timeout.effect(effect);
-    });
-    await this.ctx.storage.transaction(async txn => {
-      await txn.put(STATE_KEY, result.state);
-      if (consumedDecisionId !== undefined) {
-        const current = await txn.get<Reservation>(TIMEOUT_KEY);
-        if (current?.decisionId === consumedDecisionId) {
-          await txn.delete(TIMEOUT_KEY);
-          await txn.deleteAlarm();
-        }
-      }
-      for (const effect of effects) {
-        if (effect.type === "schedule") {
-          if (!effect.decisionId || !Number.isFinite(effect.deadline)) throw new Error("Invalid timeout reservation");
-          await txn.put(TIMEOUT_KEY, { decisionId: effect.decisionId, deadline: effect.deadline });
-          await txn.setAlarm(effect.deadline);
-        } else {
-          const current = await txn.get<Reservation>(TIMEOUT_KEY);
-          if (current?.decisionId === effect.decisionId) {
-            await txn.delete(TIMEOUT_KEY);
-            await txn.deleteAlarm();
-          }
-        }
-      }
-    });
-  }
-
-  async alarm(): Promise<void> {
-    await this.ctx.blockConcurrencyWhile(async () => {
-      const reservation = await this.ctx.storage.get<Reservation>(TIMEOUT_KEY);
-      if (!reservation) return;
-      // An old alarm can wake after a new reservation replaced it. Never expire that decision early.
-      if (Date.now() < reservation.deadline) {
-        await this.ctx.storage.setAlarm(reservation.deadline);
-        return;
-      }
-      const state = await this.ctx.storage.get<State>(STATE_KEY);
-      if (state === undefined || !gameAdapter.timeout) throw new Error("Missing timeout state or adapter");
-      const result = gameAdapter.game.handleCommand(state, gameAdapter.timeout.command(reservation.decisionId), { origin: "system" });
-      if (!result.ok) throw new Error("Timeout command rejected");
-      // Failed commits throw so Cloudflare can retry. Delivery failure never rolls back committed state.
-      await this.commit(result, reservation.decisionId);
-      this.broadcast(result.state);
-    });
-  }
-
-  private broadcast(state: State): void {
-    for (const socket of this.ctx.getWebSockets()) {
-      try {
-        const attachment: unknown = socket.deserializeAttachment();
-        if (!isRecord(attachment) || typeof attachment.actorId !== "string" || !gameAdapter.canConnect(state, attachment.actorId)) continue;
-        this.send(socket, { type: "ViewStateEvent", viewState: gameAdapter.game.project(state, attachment.actorId) });
-      } catch {
-        console.error("Session view delivery failed");
-        this.close(socket);
-      }
-    }
-  }
-
-  private send(socket: WebSocket, message: ServerMessage): void {
-    try { socket.send(JSON.stringify(message)); } catch { this.close(socket); }
-  }
-
-  private close(socket: WebSocket): void {
-    try { socket.close(1011, "Delivery failed"); } catch { /* 切断済み。確定済みの保存結果へ影響させない。 */ }
-  }
-
-  webSocketClose(socket: WebSocket, code: number, reason: string): void { socket.close(code === 1005 || code === 1006 || code === 1015 ? 1000 : code, reason); }
-  webSocketError(socket: WebSocket): void { socket.close(1011, "Connection error"); }
-}