def-game 5.1.0-timeout.0 → 6.1.0

package/dist/worker/cloudflare/session-runtime.js

@@ -0,0 +1,279 @@
+import { DurableObject } from "cloudflare:workers";
+import { failure, isRecord, parseCommandRequest } from "./protocol.js";
+const STATE_KEY = "game-state";
+const TIMEOUT_KEY = "decision-timeout";
+/**
+ * 1ルームを動かすCloudflare専用runtime。アプリはadapterだけを接続した派生クラスをexportする。
+ * RPCとfetchは信頼されたWorker専用。認証・外部リクエスト保護はWorker入口が担当する。
+ */
+export class SessionRuntime extends DurableObject {
+    /** 所有者や参加者を要求せず、ゲームの初期状態だけを保存する。 */
+    async create() {
+        return this.ctx.blockConcurrencyWhile(async () => {
+            try {
+                const exists = await this.ctx.storage.get(STATE_KEY);
+                if (exists !== undefined)
+                    return failure("RoomAlreadyExists");
+                const state = this.adapter.game.createInitialState();
+                if (state === undefined)
+                    throw new Error("Initial state must be persistable");
+                await this.ctx.storage.transaction(async (txn) => { await txn.put(STATE_KEY, state); });
+                return { ok: true, roomId: this.ctx.id.toString() };
+            }
+            catch {
+                this.#report("create");
+                return failure("InternalError");
+            }
+        });
+    }
+    /** HTTP等からの読み取り。公開内容はprojectが決め、WS接続資格は要求しない。 */
+    async getView(actor) {
+        if (!actor || typeof actor.actorId !== "string" || actor.actorId.length === 0)
+            return failure("InvalidRequest");
+        return this.ctx.blockConcurrencyWhile(async () => {
+            try {
+                const state = await this.ctx.storage.get(STATE_KEY);
+                if (state === undefined)
+                    return failure("RoomNotFound");
+                return { ok: true, view: this.adapter.game.project(state, actor.actorId) };
+            }
+            catch {
+                this.#report("view");
+                return failure("InternalError");
+            }
+        });
+    }
+    /** アプリが認証済みActorと、必要なら外部取得済み情報を渡す入口。 */
+    async dispatchActor(actor, command) {
+        if (!actor || typeof actor.actorId !== "string" || actor.actorId.length === 0)
+            return failure("InvalidRequest");
+        return this.#dispatchCommand(command, { origin: "actor", actorId: actor.actorId });
+    }
+    /** webhook等の認証を済ませたサーバー専用入口。外部本文からoriginをコピーしない。 */
+    async dispatchSystem(command) {
+        return this.#dispatchCommand(command, { origin: "system" });
+    }
+    /** 全Commandが通る唯一の経路。Alarmの予約確認も同じ直列化区間で行う。 */
+    async #dispatchCommand(command, context, options = {}) {
+        let effects = [];
+        const outcome = await this.ctx.blockConcurrencyWhile(async () => {
+            try {
+                let consumed;
+                if (options.alarm) {
+                    const reservation = await this.ctx.storage.get(TIMEOUT_KEY);
+                    if (!reservation)
+                        return { ok: true };
+                    if (Date.now() < reservation.deadline) {
+                        await this.ctx.storage.setAlarm(reservation.deadline);
+                        return { ok: true };
+                    }
+                    if (!this.adapter.timeout)
+                        throw new Error("Timeout adapter missing");
+                    command = this.adapter.timeout.command(reservation.decisionId);
+                    consumed = reservation.decisionId;
+                }
+                const state = await this.ctx.storage.get(STATE_KEY);
+                if (state === undefined)
+                    return failure("RoomNotFound");
+                if (options.fromSocket && (context.origin !== "actor" || !this.adapter.canConnect(state, context.actorId))) {
+                    return failure("NotRoomMember");
+                }
+                const result = this.adapter.game.handleCommand(state, command, context);
+                if (!result.ok)
+                    return { ok: false, error: { kind: "game", detail: result.error } };
+                if (result.state === undefined)
+                    throw new Error("State must be persistable");
+                const external = [];
+                const alarms = [];
+                for (const effect of result.effects) {
+                    const alarm = this.adapter.timeout?.effect(effect) ?? null;
+                    if (alarm === null)
+                        external.push(effect);
+                    else {
+                        if (!alarm.decisionId || (alarm.type !== "schedule" && alarm.type !== "cancel")
+                            || (alarm.type === "schedule" && !Number.isFinite(alarm.deadline)))
+                            throw new Error("Invalid alarm effect");
+                        alarms.push(alarm);
+                    }
+                }
+                await this.ctx.storage.transaction(async (txn) => {
+                    await txn.put(STATE_KEY, result.state);
+                    if (consumed !== undefined) {
+                        const current = await txn.get(TIMEOUT_KEY);
+                        if (current?.decisionId === consumed) {
+                            await txn.delete(TIMEOUT_KEY);
+                            await txn.deleteAlarm();
+                        }
+                    }
+                    for (const alarm of alarms) {
+                        if (alarm.type === "schedule") {
+                            await txn.put(TIMEOUT_KEY, { decisionId: alarm.decisionId, deadline: alarm.deadline });
+                            await txn.setAlarm(alarm.deadline);
+                        }
+                        else {
+                            const current = await txn.get(TIMEOUT_KEY);
+                            if (current?.decisionId === alarm.decisionId) {
+                                await txn.delete(TIMEOUT_KEY);
+                                await txn.deleteAlarm();
+                            }
+                        }
+                    }
+                });
+                // 保存後の配信失敗で、確定したCommandを失敗に戻さない。
+                effects = external;
+                this.#broadcast(result.state);
+                return { ok: true };
+            }
+            catch {
+                this.#report("command");
+                return failure("InternalError");
+            }
+        });
+        // 排他区間を出てから呼ぶ。外部取得中も次のCommandを受け付ける。
+        if (effects.length)
+            this.#deliver(effects);
+        return outcome;
+    }
+    /** Alarm失敗は例外としてCloudflareの有限回リトライへ返す。 */
+    async alarm() {
+        const result = await this.#dispatchCommand(undefined, { origin: "system" }, { alarm: true });
+        if (!result.ok)
+            throw new Error("Timeout command failed");
+    }
+    /** 認証済みWorkerからだけ呼ぶ内部WS入口。一般HTTP Commandの転送は受け付けない。 */
+    async fetch(request) {
+        if (request.method !== "GET" || new URL(request.url).pathname !== "/connect"
+            || request.headers.get("upgrade")?.toLowerCase() !== "websocket") {
+            return Response.json(failure("InvalidRequest"), { status: 400 });
+        }
+        const actorId = request.headers.get("x-def-game-actor-id");
+        if (!actorId)
+            return Response.json(failure("InvalidRequest"), { status: 400 });
+        return this.ctx.blockConcurrencyWhile(async () => {
+            try {
+                const state = await this.ctx.storage.get(STATE_KEY);
+                if (state === undefined)
+                    return Response.json(failure("RoomNotFound"), { status: 404 });
+                if (!this.adapter.canConnect(state, actorId))
+                    return Response.json(failure("NotRoomMember"), { status: 403 });
+                const viewState = this.adapter.game.project(state, 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] });
+            }
+            catch {
+                this.#report("connection");
+                return Response.json(failure("InternalError"), { status: 500 });
+            }
+        });
+    }
+    /** WSの自己申告を実行元にせず、接続に保存したActorでdispatchする。 */
+    async webSocketMessage(socket, raw) {
+        const request = parseCommandRequest(raw);
+        let command = null;
+        try {
+            if (request)
+                command = this.adapter.webSocket.parseCommand(request.command);
+        }
+        catch { /* 入力を拒否 */ }
+        if (!request || command === null || command === undefined) {
+            this.#send(socket, { type: "ProtocolErrorEvent", error: failure("InvalidRequest").error });
+            return;
+        }
+        const actorId = this.#actor(socket);
+        const result = actorId === null ? failure("NotRoomMember")
+            : await this.#dispatchCommand(command, { origin: "actor", actorId }, { fromSocket: true });
+        this.#send(socket, { type: "GameCommandResponse", requestId: request.requestId, ...result });
+    }
+    /** 保存済みの状態は変更せず、接続ごとに公開可能なViewだけ配る。 */
+    #broadcast(state) {
+        try {
+            for (const socket of this.ctx.getWebSockets()) {
+                try {
+                    const actorId = this.#actor(socket);
+                    if (actorId === null || !this.adapter.canConnect(state, actorId)) {
+                        this.#close(socket, 1008);
+                        continue;
+                    }
+                    this.#send(socket, { type: "ViewStateEvent", viewState: this.adapter.game.project(state, actorId) });
+                }
+                catch {
+                    this.#report("view");
+                    this.#close(socket);
+                }
+            }
+        }
+        catch {
+            this.#report("view");
+        }
+    }
+    /** handlerの結果を新しいSystem Commandとして返す。永続配送・自動再試行はしない。 */
+    #deliver(effects) {
+        this.ctx.waitUntil((async () => {
+            for (const effect of effects) {
+                let feedback;
+                try {
+                    if (!this.adapter.executeEffect)
+                        throw new Error("Effect handler missing");
+                    feedback = await this.adapter.executeEffect(effect, { env: this.env, roomId: this.ctx.id.toString() });
+                }
+                catch {
+                    this.#report("effect");
+                    continue;
+                }
+                if (feedback !== undefined) {
+                    try {
+                        const result = await this.dispatchSystem(feedback.command);
+                        if (!result.ok)
+                            this.#report("effect-feedback");
+                    }
+                    catch {
+                        this.#report("effect-feedback");
+                    }
+                }
+            }
+        })());
+    }
+    #actor(socket) {
+        try {
+            const attachment = socket.deserializeAttachment();
+            return isRecord(attachment) && typeof attachment.actorId === "string" ? attachment.actorId : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    #send(socket, message) {
+        try {
+            socket.send(JSON.stringify(message));
+        }
+        catch {
+            this.#report("view");
+            this.#close(socket);
+        }
+    }
+    #close(socket, code = 1011) {
+        try {
+            socket.close(code, "Connection closed");
+        }
+        catch { /* 既に切断済み */ }
+    }
+    #report(phase) {
+        const failure = { phase, roomId: this.ctx.id.toString() };
+        try {
+            if (this.adapter.onError)
+                this.adapter.onError(failure);
+            else
+                console.error("DefGame runtime failure", failure);
+        }
+        catch {
+            console.error("DefGame diagnostic handler failed", failure);
+        }
+    }
+    webSocketClose(socket, code) {
+        this.#close(socket, code === 1005 || code === 1006 || code === 1015 ? 1000 : code);
+    }
+    webSocketError(socket) { this.#close(socket); }
+}

package/dist/worker/cloudflare/types.d.ts

@@ -0,0 +1,99 @@
+import type { GameDefinition } from "../game-definition.js";
+/** ゲームが所有する型をまとめる。runtimeはStateの内部構造を解釈しない。 */
+export interface GameTypes {
+    state: unknown;
+    actorCommand: unknown;
+    systemCommand: unknown;
+    view: unknown;
+    effect: unknown;
+    error: unknown;
+}
+/** アプリが本人確認を済ませた実行元。型そのものに認証能力はない。 */
+export interface VerifiedActor {
+    readonly actorId: string;
+}
+/** ゲームの拒否とインフラ側の拒否を区別する。内部例外はペイロードへ含めない。 */
+export type RuntimeError = {
+    readonly kind: "runtime";
+    readonly code: "RoomNotFound" | "RoomAlreadyExists" | "InvalidRequest" | "NotRoomMember" | "InternalError";
+};
+export type CommandResult<Error> = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly error: RuntimeError | {
+        readonly kind: "game";
+        readonly detail: Error;
+    };
+};
+export type CreateRoomResult = {
+    readonly ok: true;
+    readonly roomId: string;
+} | {
+    readonly ok: false;
+    readonly error: RuntimeError;
+};
+/** 保存状態そのものではなく、ゲームがActorに公開するViewを返す。 */
+export type GetViewResult<View> = {
+    readonly ok: true;
+    readonly view: View;
+} | {
+    readonly ok: false;
+    readonly error: RuntimeError;
+};
+/** 状態と一緒に確定する、1つの現在decisionに対する予約・解除。 */
+export type TimeoutEffect = {
+    readonly type: "schedule";
+    readonly decisionId: string;
+    readonly deadline: number;
+} | {
+    readonly type: "cancel";
+    readonly decisionId: string;
+};
+/** 失敗した区間を通知する。秘密の状態・Command・Effectを自動ログに含めない。 */
+export interface RuntimeFailure {
+    readonly roomId: string;
+    readonly phase: "create" | "command" | "effect" | "effect-feedback" | "view" | "connection";
+}
+/** 純粋なゲームと、アプリ固有の入力・外部処理を共通runtimeへ接続する。 */
+export interface GameAdapter<Env, T extends GameTypes> {
+    readonly game: GameDefinition<T["state"], T["actorCommand"] | T["systemCommand"], string, T["view"], T["effect"], T["error"]>;
+    readonly webSocket: {
+        /** クライアントが指定してよい入力だけCommandにする。手番等の検証はゲームに残す。 */
+        readonly parseCommand: (input: unknown) => T["actorCommand"] | null;
+    };
+    readonly canConnect: (state: T["state"], actorId: string) => boolean;
+    readonly timeout?: {
+        readonly effect: (effect: T["effect"]) => TimeoutEffect | null;
+        readonly command: (decisionId: string) => T["systemCommand"];
+    };
+    /** 保存後のbest-effort処理。結果はruntimeがSystem Commandとして再度dispatchする。 */
+    readonly executeEffect?: (effect: T["effect"], context: {
+        readonly env: Env;
+        readonly roomId: string;
+    }) => Promise<void | {
+        readonly command: T["systemCommand"];
+    }>;
+    /** 同期の診断フック。例外はruntimeが隔離する。配送・再試行の仕組みではない。 */
+    readonly onError?: (failure: RuntimeFailure) => void;
+}
+/** WebSocketの共通envelope。actorIdやoriginはクライアントから受け取らない。 */
+export interface GameCommandRequest<Command> {
+    readonly type: "GameCommandRequest";
+    readonly requestId: string;
+    readonly command: Command;
+}
+export type GameCommandResponse<Error> = CommandResult<Error> & {
+    readonly type: "GameCommandResponse";
+    readonly requestId: string;
+};
+export interface ViewStateEvent<View> {
+    readonly type: "ViewStateEvent";
+    readonly viewState: View;
+}
+export interface ProtocolErrorEvent {
+    readonly type: "ProtocolErrorEvent";
+    readonly error: RuntimeError;
+}
+export type ServerMessage<View, Error> = GameCommandResponse<Error> | ViewStateEvent<View> | ProtocolErrorEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/worker/cloudflare/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/types.ts"],"names":[],"mappings":"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"}

package/dist/worker/cloudflare/types.js

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

package/dist/worker/game-definition.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Worker や simulator が確定したコマンドの実行元。
+ * actorId は認証済みの主体を表し、接続 ID ではない。
+ * 外部リクエストの自己申告をそのまま使わず、system は信頼できる実行側だけが指定する。
+ */
+export type CommandContext<ActorId> = {
+    readonly origin: "actor";
+    readonly actorId: ActorId;
+} | {
+    readonly origin: "system";
+};
+/**
+ * 成功時は次の安定状態と副作用の宣言、失敗時はゲーム上の拒否理由を返す。
+ * 実行側は成功した状態を保存してから外部 Effect を処理する。
+ * 同じストレージ内の Alarm 予約などは、状態と原子的に保存できる。
+ */
+export type TransitionResult<State, Effect, Error> = {
+    readonly ok: true;
+    readonly state: State;
+    readonly effects: readonly Effect[];
+} | {
+    readonly ok: false;
+    readonly error: Error;
+};
+/**
+ * 通信・永続化から独立したゲームそのものの契約。
+ * State の構造や入力待ちの表現は各ゲームが定義し、kernel は task queue を要求しない。
+ */
+export interface GameDefinition<State, Command, ActorId, View, Effect, Error> {
+    /** Session や接続の情報に依存しない、ゲームの初期状態を生成する。 */
+    createInitialState(): State;
+    /**
+     * 実行元とコマンドを再検証し、次の外部入力を待てる安定状態まで遷移する。
+     * 入力 state を変更せず、拒否時は error のみを返す。外部 I/O は行わない。
+     * system 起点でも、そのコマンドが現在の状態で有効かを検証する。
+     */
+    handleCommand(state: State, command: Command, context: CommandContext<ActorId>): TransitionResult<State, Effect, Error>;
+    /**
+     * state を変更せず、Actor に公開できる情報と availableActions を持つ View を生成する。
+     * availableActions は表示補助であり、コマンド実行時の検証を省略する根拠にはしない。
+     */
+    project(state: State, actorId: ActorId): View;
+}
+//# sourceMappingURL=game-definition.d.ts.map

package/dist/worker/game-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-definition.d.ts","sourceRoot":"","sources":["../../src/game-definition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,IAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAC3C;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GACC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK;IACxE,0CAA0C;IAC1C,kBAAkB,IAAI,KAAK,CAAC;IAE5B;;;;OAIG;IACH,aAAa,CACT,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GACjC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE1C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjD"}

package/dist/worker/game-definition.js

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

package/dist/worker/package.json

@@ -0,0 +1 @@
+{"type":"module"}