def-game 5.1.0-timeout.0 → 6.1.0

package/README.md

@@ -1,121 +1,18 @@
-# def-game V5
+# def-game
 
-ターン制ゲームのルールを通信・永続化から独立させる、TypeScript の最小 contract とメモリ上の simulator です。
+ゲームの状態遷移をCommandに集約し、外部処理をEffectで接続するTypeScriptライブラリです。
+共通runtimeが部屋の保存・WebSocket・Alarmを扱い、ゲームルールと認証・外部サービスとの接続はアプリ側で定義します。
 
-```sh
-npm install def-game@^5
-```
-
-## 公開 API
-
-- `GameDefinition`: 初期状態の生成、コマンドによる状態遷移、Actor 別の projection。
-- `TransitionResult`: 成功時の次状態と Effect、または失敗理由。
-- `CommandContext`: Actor と system の実行元の区別。
-- `GameSimulator`: 同じゲーム定義へコマンドを順に流し、状態・View・Effect を検証する実行器。
-
-型の詳細と契約は [game-definition.ts](src/game-definition.ts)、実行器は [game-simulator.ts](src/game-simulator.ts) を参照してください。
-[シナリオテスト](test/game-simulator.test.cjs) に、2人の入力待ちと system timeout を扱う実行例があります。
-
-## 責務
-
-各ゲームは GameState と Command を定義し、1コマンドで次の外部入力を待てる安定状態まで遷移させます。入力状態は変更せず、失敗時はエラーだけを返します。現在の入力待ちはゲーム自身の状態として表現します。
-
-接続、認証、永続化、時刻の取得、Alarm、外部 I/O は実行側の責務です。実行側が検証済みの Actor または system を context に指定します。リクエストに書かれた実行元をそのまま信用してはいけません。ゲーム側でも実行元と現在の状態に対してコマンドを検証します。
-
-Effect は副作用の宣言です。本番の実行側は次状態を保存してから Effect を実行します。simulator は Effect を実行せず、遷移結果に含めて返します。
-
-projection は秘密情報を除いた Actor 別の View と availableActions を生成します。availableActions は表示補助であり、コマンド実行時の検証を置き換えません。
-
-simulator の getState は検証用の全状態への参照です。呼び出し側も状態を直接変更しないでください。deep clone、freeze、失敗時の rollback は行いません。クライアントへ公開する情報には getView を使用します。
-
-## V4 からの移行
-
-V5 は破壊的変更です。GameRule、GameEngine、TaskQueue に関する型、旧通信型と helper は削除しています。V4 を利用する既存ゲームは移植が完了するまで V4 を使用してください。
-
-- 旧ライフサイクルを GameDefinition の初期化・コマンド処理・projection に移します。
-- task queue に未来の処理を保存する代わりに、ゲーム固有の状態で現在の入力待ちを表現します。
-- 参加・開始などもゲームの Command として扱います。
-- 旧 GameEngine の代わりに GameSimulator でコマンド列を実行します。
-
-## Worker generator（5.0.1）
-
-Hono Worker、SQLite-backed Durable Object、waki.work JWT 認証、Hibernation WebSocket、保存・配信処理を生成します。GameDefinition の契約変更はありません。標準構成は timeout / Effect 実行なしです。開発版では下記の timeout オプションを追加しています。
-
-server package に `def-game.worker.json` を作ります。全パスはこの設定ファイルのディレクトリ基準です。
-
-```json
-{
-  "outputDir": "src/worker",
-  "adapter": "src/worker/game-adapter.ts",
-  "entry": "src/index.ts",
-  "wranglerConfig": "wrangler.jsonc",
-  "name": "my-game",
-  "assets": "../client/public",
-  "compatibilityDate": "2026-09-12"
-}
-```
-
-```sh
-npm install --save-dev def-game@5.0.1 wrangler @cloudflare/workers-types
-npm install hono jose
-npx def-game generate-worker --config def-game.worker.json
-npx def-game generate-worker --config def-game.worker.json --check
-```
-
-生成対象は `outputDir` 内の `index.ts`、`session.ts`、`auth.ts`、`env.ts`、`runtime/parse.ts`、`runtime/game-adapter.ts` と、`entry`、`wranglerConfig` の計8ファイルです。Hono / jose は利用側の runtime dependency で、generator 自体に実行時依存はありません。
-
-生成コードは Node.js 24.20.0、TypeScript 5.6.3、Hono 4.13.7、jose 6.2.12、Wrangler 4.131.1、`@cloudflare/workers-types` 5.20260911.1 の環境で、ビルド・型チェック・HTTP / WebSocket / Durable Object の通信テストを確認しています。
-
-ゲーム側は既存ファイルとして `adapter` を用意し、次を export します。このファイル、domain、shared は生成・上書きしません。
-
-- `gameAdapter`: 生成される `GameAdapter<State, Command, View, Error>` に適合するオブジェクト。
-- `gameAdapter.game`: ゲーム自身の GameDefinition（Effect は `never`）。
-- `parseCreate(input)` / `parseJoin(input)` / `parseCommand(input)`: 未検証入力から command を返す関数。形式不正なら null。WS の関数へ渡るのは envelope 内の command だけです。
-- `canConnect(state, actorId)`: 接続・配信を許可するかの判定。command の認可は GameDefinition が再検証します。
-- 型の export: `State`、`ActorId`（string）、`ServerMessage`、`ProtocolError`、`PublicError`、`CreateSessionResponse`、`JoinSessionResponse`。
-
-公開通信は `GameCommandRequest { requestId, command }`、`GameCommandResponse { requestId, ok, error? }`、`ViewStateEvent { viewState }`、`ProtocolErrorEvent { error }` の type で区別します。HTTP 応答は `CreateSessionResponse` / `JoinSessionResponse` の type と、成功時 `ok: true, sessionId`、失敗時 `ok: false, error` を持ちます。ProtocolError の code は `AuthenticationRequired` / `SessionNotFound` / `NotSessionMember` / `InvalidRequest` / `InternalError`。PublicError はそれとゲームエラーの union です。
+## Getting Started
 
-認証は Cookie `__token` を JWKS / ES256 / issuer / audience / exp で検証し、UUID の sub を ActorId として使います。Static Assets も認証必須。ログイン誘導・refresh は client の責務です。
-
-出力が同一なら変更しません。既存ファイルと差分がある場合は書き込み前に停止します。確認後に `--force` を付けると生成対象8ファイルだけを更新します。`--check` は欠落・差分を非ゼロ終了で報告し、ファイルを変更しません。生成ファイルは Git 管理し、修正は generator / 設定側へ戻してください。Wrangler 設定も全体が生成対象なので、独自 bindings や migrations の追加には generator の対応が必要です。
-
-CLI は dependencies、package scripts、tsconfig を書き換えません。利用側で Worker の型と Hono / jose を設定し、生成された entry を Wrangler から実行します。CLI には Node.js 20 以降が必要です。
-
-## 開発と公開
+Node.js 22以降が必要です。v6.1.0の利用手順です。
 
 ```sh
-npm ci
-npm run typecheck
-npm test
-npm pack
+npx def-game@6.1.0 init-worker --directory my-game --name my-game
+cd my-game
+npm install
+npm run dev
 ```
 
-開発時のテストには Node.js 20 以降を使用してください。npm test はビルドと Node 標準のシナリオテストを実行します。
-
-npm pack / npm publish の前に prepack で型チェック・ビルド・テストが実行されます。build は dist を作り直すため、削除した旧 API の生成物が混入しません。公開対象は dist、bin、templates、package.json、README、LICENSE です。
-
-main にレビュー済みの変更を反映した後、公開する version と認証アカウントを確認し、検証済みのパッケージを npm publish で公開します。
-
-
-## Decision timeout（5.1.0-timeout.0 開発版）
-
-生成設定に `"timeout": true` を追加すると、DO Alarm と system command 配送を生成します。未指定または false なら従来の構成です。開発版は npm 未公開です。
-
-`GameAdapter<State, Command, View, Error, Effect>` に次の任意の接続点を設定します。
-
-```ts
-timeout: {
-  effect: (effect) => /* { type: "schedule", decisionId: string, deadline: number }
-                        または { type: "cancel", decisionId: string } */,
-  command: (decisionId) => /* ゲーム固有の system command */,
-}
-```
-
-ゲームは新しい decision で再利用しない ID と期限を発行します。同じ decision 内の部分完了では Effect を出しません。default action・pending actors・bot policy はゲーム側に残します。runtime は State を解釈せず、1つの現在予約を保存します。独立した複数の同時 decision のスケジューラーではありません。
-
-状態・予約・Alarm は同じ storage transaction で確定します。Alarm は保存済み予約から system command を生成し、古い発火が新しい予約を期限前に処理しないよう再予約します。domain も ID・期限を検証してください。期限を迎えた予約は成功した遷移と同じ transaction で消費し、次の予約があれば置き換えます。失敗は例外として伝播し Cloudflare の有限回の再試行に委ねます。無制限の再試行・外部 Effect の配送は含みません。
-
-このオプションで扱う Effect は timeout の予約・解除のみです。外部通知と異なり、Alarm は状態と原子的に保存するローカルな永続化処理です。外部サービス呼び出しは transaction 内に追加しないでください。
-
-実行環境の検証: Node.js 24、TypeScript 5.6、Hono 4.13、jose 6.2、Wrangler 4.131、Cloudflare Vitest plugin 1.1。標準構成・任意構成の生成一致を generator テストで確認しています。
+`http://127.0.0.1:8787`を開いてください。
+実装前に[設計思想](docs/design-philosophy.md)を読み、接続方法は[runtime API・初期生成の使い方](docs/runtime-api.md)を参照してください。

package/bin/def-game.cjs

@@ -1,133 +1,17 @@
 #!/usr/bin/env node
 'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
 const { version } = require('../package.json');
-
-const help = `def-game ${version}
-Usage: def-game generate-worker --config <file.json> [--force | --check]
-
-Generate a Hono Worker, SQLite Durable Object, waki.work authentication and Wrangler config.
---force  Replace differing output files (never edits the game adapter).
---check  Verify generated files match without writing anything.
-Node.js 20+ is required. Set timeout: true in the config to generate decision timeout scheduling.`;
-
-function relativeImport(from, target) {
-  let value = path.relative(path.dirname(from), target).split(path.sep).join('/').replace(/\.ts$/, '.js');
-  if (!value.startsWith('.')) value = './' + value;
-  return JSON.stringify(value);
-}
-
 function main(args) {
-  if (args.length === 0 || args[0] === '--help') return console.log(help);
-  if (args[0] === '--version') return console.log(version);
-  if (Number(process.versions.node.split('.')[0]) < 20) throw new Error('Node.js 20+ is required');
-  if (args.shift() !== 'generate-worker') throw new Error('Unknown command. Use --help.');
-  let configPath;
-  let force = false;
-  let check = false;
-  while (args.length) {
-    const arg = args.shift();
-    if (arg === '--config' && !configPath && args[0] && !args[0].startsWith('--')) configPath = args.shift();
-    else if (arg === '--force' && !force) force = true;
-    else if (arg === '--check' && !check) check = true;
-    else throw new Error(`Unknown or repeated option: ${arg}`);
-  }
-  if (!configPath || (force && check)) throw new Error('Provide --config and at most one of --force / --check');
-  configPath = path.resolve(configPath);
-  const root = path.dirname(configPath);
-  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-  if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('Config must be an object');
-  const allowed = new Set(['outputDir', 'adapter', 'entry', 'wranglerConfig', 'name', 'assets', 'compatibilityDate', 'timeout']);
-  if (config.timeout !== undefined && typeof config.timeout !== 'boolean') throw new Error('timeout must be boolean');
-  for (const key of Object.keys(config)) if (!allowed.has(key)) throw new Error(`Unknown config key: ${key}`);
-  const required = (key) => {
-    if (typeof config[key] !== 'string' || !config[key].trim() || config[key].includes('\0')) throw new Error(`Invalid config: ${key}`);
-    return config[key];
-  };
-  const inside = (value) => {
-    if (path.isAbsolute(value)) throw new Error(`Path must be relative: ${value}`);
-    const resolved = path.resolve(root, value);
-    const relative = path.relative(root, resolved);
-    if (!relative || relative === '..' || relative.startsWith('..' + path.sep)) throw new Error(`Path must stay inside config directory: ${value}`);
-    // Do not follow existing symlinks when overwriting output or locating the adapter.
-    let current = root;
-    for (const part of relative.split(path.sep)) {
-      current = path.join(current, part);
-      if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink()) throw new Error(`Symlink is not supported: ${current}`);
-    }
-    return resolved;
-  };
-  const outputDir = inside(required('outputDir'));
-  const adapter = inside(required('adapter'));
-  if (!/\.(ts|js)$/.test(adapter) || !fs.statSync(adapter).isFile()) throw new Error('adapter must be an existing .ts or .js file');
-  const entry = inside(required('entry'));
-  if (!entry.endsWith('.ts')) throw new Error('entry must end with .ts');
-  const wrangler = inside(required('wranglerConfig'));
-  if (!wrangler.endsWith('.jsonc')) throw new Error('wranglerConfig must end with .jsonc');
-  const name = required('name');
-  if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(name)) throw new Error('Invalid Worker name');
-  const assets = required('assets');
-  if (path.isAbsolute(assets)) throw new Error('assets must be relative to the config directory');
-  const date = required('compatibilityDate');
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(date) || !Number.isFinite(Date.parse(date)) || new Date(date).toISOString().slice(0, 10) !== date) {
-    throw new Error('Invalid compatibilityDate');
-  }
-
-  const banner = `// Generated by def-game ${version}. Do not edit; change the generator or its config.\n`;
-  const files = new Map();
-  const add = (file, text) => {
-    if (files.has(file) || file === adapter || file === configPath) throw new Error(`Output path collision: ${file}`);
-    inside(path.relative(root, file));
-    files.set(file, banner + text);
-  };
-  for (const file of ['index.ts', 'session.ts', 'auth.ts', 'env.ts', 'runtime/parse.ts', 'runtime/game-adapter.ts']) {
-    const target = path.join(outputDir, file);
-    const template = config.timeout && ['session.ts', 'runtime/game-adapter.ts'].includes(file) ? path.join('timeout', file) : file;
-    const source = fs.readFileSync(path.join(__dirname, '../templates/worker', template), 'utf8');
-    add(target, source.replaceAll('__ADAPTER_IMPORT__', relativeImport(target, adapter)));
-  }
-  add(entry, `export { default, SessionDurableObject } from ${relativeImport(entry, path.join(outputDir, 'index.ts'))};\n`);
-  const fromWrangler = (target) => path.relative(path.dirname(wrangler), target).split(path.sep).join('/');
-  add(wrangler, JSON.stringify({
-    name,
-    main: fromWrangler(entry),
-    compatibility_date: date,
-    assets: { directory: fromWrangler(path.resolve(root, assets)), binding: 'ASSETS', run_worker_first: true },
-    durable_objects: { bindings: [{ name: 'SESSIONS', class_name: 'SessionDurableObject' }] },
-    migrations: [{ tag: 'v1', new_sqlite_classes: ['SessionDurableObject'] }],
-    vars: {
-      AUTH_ISSUER: 'https://auth.waki.work', AUTH_AUDIENCE: 'waki.work',
-      AUTH_JWKS_URL: 'https://auth.waki.work/.well-known/jwks.json',
-    },
-  }, null, 2) + '\n');
+  if (!args.length || args[0] === '--help') {
+    return console.log(`def-game ${version}
+Usage: def-game init-worker --directory <new-directory> --name <worker-name>
 
-  // Preflight every output before the first write, so conflicts cannot leave half-generated code.
-  const changed = [];
-  for (const [file, contents] of files) {
-    const exists = fs.existsSync(file);
-    if (exists && !fs.statSync(file).isFile()) throw new Error(`Output is not a file: ${file}`);
-    if (exists && fs.readFileSync(file, 'utf8') === contents) continue;
-    if (exists && !force && !check) throw new Error(`Refusing to overwrite ${file}; review the changes and use --force`);
-    changed.push([file, contents]);
-  }
-  if (check) {
-    if (changed.length) throw new Error(`Generated files differ or are missing:\n${changed.map(([file]) => path.relative(root, file)).join('\n')}`);
-    return console.log(`Verified ${files.size} generated files (def-game ${version})`);
+Create an app-owned v6 starter. Existing directories are never overwritten.
+Node.js 22+ is required.`);
   }
-  for (const [file, contents] of changed) {
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    const temp = file + `.def-game-${process.pid}.tmp`;
-    try {
-      fs.writeFileSync(temp, contents, { flag: 'wx' });
-      fs.renameSync(temp, file);
-    } finally {
-      if (fs.existsSync(temp)) fs.unlinkSync(temp);
-    }
-  }
-  console.log(`Generated ${files.size} files; changed ${changed.length} (def-game ${version})`);
+  if (args[0] === '--version') return console.log(version);
+  if (args.shift() !== 'init-worker') throw new Error('Unknown command. Use --help.');
+  return require('./init-worker.cjs')(args);
 }
-
 try { main(process.argv.slice(2)); }
 catch (error) { console.error(`def-game: ${error.message}`); process.exitCode = 1; }

package/bin/init-worker.cjs

@@ -0,0 +1,48 @@
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const { version } = require('../package.json');
+
+module.exports = function initWorker(args) {
+  if (args.length === 1 && args[0] === '--help') {
+    return console.log('Usage: def-game init-worker --directory <new-directory> --name <worker-name>');
+  }
+  if (Number(process.versions.node.split('.')[0]) < 22) throw new Error('init-worker requires Node.js 22+');
+  const options = {};
+  while (args.length) {
+    const key = args.shift();
+    if (!['--directory', '--name'].includes(key) || options[key] || !args[0] || args[0].startsWith('--')) {
+      throw new Error(`Unknown, repeated or incomplete option: ${key}`);
+    }
+    options[key] = args.shift();
+  }
+  if (!options['--directory'] || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(options['--name'] || '')) {
+    throw new Error('Provide --directory and --name (1–63 lowercase letters, digits or hyphens)');
+  }
+  const target = path.resolve(options['--directory']);
+  // Initial generation has no update/force mode: all output belongs to the app.
+  if (fs.existsSync(target) || (() => { try { fs.lstatSync(target); return true; } catch { return false; } })()) {
+    throw new Error(`Destination already exists: ${target}; choose a new directory`);
+  }
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  const stage = fs.mkdtempSync(path.join(path.dirname(target), '.def-game-init-'));
+  try {
+    fs.cpSync(path.join(__dirname, '../templates/starter'), stage, { recursive: true });
+    const packagePath = path.join(stage, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+    pkg.name = options['--name'];
+    pkg.dependencies['def-game'] = version;
+    fs.writeFileSync(packagePath, JSON.stringify(pkg, null, 2) + '\n');
+    const configPath = path.join(stage, 'wrangler.jsonc');
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    config.name = options['--name'];
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    fs.renameSync(path.join(stage, 'gitignore'), path.join(stage, '.gitignore'));
+    // Reserve the destination exclusively before copying; never replace a racing writer.
+    fs.mkdirSync(target);
+    fs.cpSync(stage, target, { recursive: true, force: false, errorOnExist: true });
+  } finally {
+    fs.rmSync(stage, { recursive: true, force: true });
+  }
+  console.log(`Created v6 starter at ${target}\nInstall dependencies, then run npm run dev. See README.md for local alpha installation.`);
+};

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

@@ -0,0 +1,5 @@
+export { SessionRuntime } from "./session-runtime.js";
+export { getRoom, getSystemRoom } from "./room-client.js";
+export type { RoomClient } from "./room-client.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,mBAAmB,YAAY,CAAC"}

package/dist/worker/cloudflare/index.js

@@ -0,0 +1,2 @@
+export { SessionRuntime } from "./session-runtime.js";
+export { getRoom, getSystemRoom } from "./room-client.js";

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

@@ -0,0 +1,11 @@
+import type { GameCommandRequest, RuntimeError } from "./types.js";
+/** 配列やnullをオブジェクト入力として扱わない。 */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** envelopeだけを読む。ゲーム固有の入力はadapterのWS parserが検証する。 */
+export declare function parseCommandRequest(raw: string | ArrayBuffer): GameCommandRequest<unknown> | null;
+/** runtimeの拒否理由を共通形式にする。 */
+export declare function failure(code: RuntimeError["code"]): {
+    ok: false;
+    error: RuntimeError;
+};
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,+BAA+B;AAC/B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI,CASjG;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAEtF"}

package/dist/worker/cloudflare/protocol.js

@@ -0,0 +1,24 @@
+/** 配列やnullをオブジェクト入力として扱わない。 */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** envelopeだけを読む。ゲーム固有の入力はadapterのWS parserが検証する。 */
+export function parseCommandRequest(raw) {
+    if (typeof raw !== "string" || new TextEncoder().encode(raw).length > 64 * 1024)
+        return null;
+    try {
+        const value = JSON.parse(raw);
+        if (!isRecord(value) || value.type !== "GameCommandRequest" || typeof value.requestId !== "string"
+            || value.requestId.length === 0 || value.requestId.length > 128
+            || !Object.prototype.hasOwnProperty.call(value, "command"))
+            return null;
+        return { type: "GameCommandRequest", requestId: value.requestId, command: value.command };
+    }
+    catch {
+        return null;
+    }
+}
+/** runtimeの拒否理由を共通形式にする。 */
+export function failure(code) {
+    return { ok: false, error: { kind: "runtime", code } };
+}

package/dist/worker/cloudflare/room-client.d.ts

@@ -0,0 +1,28 @@
+import type { CommandResult, CreateRoomResult, GetViewResult, VerifiedActor } from "./types.js";
+/** DOの信頼されたRPC面。アプリは外部リクエストを直接この面へ転送しない。 */
+interface RoomTransport<ActorCommand, SystemCommand, Error, View> {
+    create(): Promise<CreateRoomResult>;
+    getView(actor: VerifiedActor): Promise<GetViewResult<View>>;
+    dispatchActor(actor: VerifiedActor, command: ActorCommand): Promise<CommandResult<Error>>;
+    dispatchSystem(command: SystemCommand): Promise<CommandResult<Error>>;
+    fetch(request: Request): Promise<Response>;
+}
+/** 通常のアプリ操作向け参照。System入口を含めない。 */
+export interface RoomClient<ActorCommand, Error, View = unknown> {
+    create(): Promise<CreateRoomResult>;
+    getView(actor: VerifiedActor): Promise<GetViewResult<View>>;
+    dispatchActor(actor: VerifiedActor, command: ActorCommand): Promise<CommandResult<Error>>;
+    connect(actor: VerifiedActor): Promise<Response>;
+}
+/** 対象DOを選び、認証済みActor向けのAPIだけを返す。IDの解決はアプリが行う。 */
+export declare function getRoom<A, S, E, V>(namespace: {
+    get(id: DurableObjectId): RoomTransport<A, S, E, V>;
+}, id: DurableObjectId): RoomClient<A, E, V>;
+/** 認証・権限確認済みのwebhookやマッチングからSystem Commandを渡す参照。 */
+export declare function getSystemRoom<A, S, E, V>(namespace: {
+    get(id: DurableObjectId): RoomTransport<A, S, E, V>;
+}, id: DurableObjectId): {
+    dispatchSystem(command: S): Promise<CommandResult<E>>;
+};
+export {};
+//# sourceMappingURL=room-client.d.ts.map

package/dist/worker/cloudflare/room-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-client.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/room-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhG,4CAA4C;AAC5C,UAAU,aAAa,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI;IAC9D,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5C;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO;IAC7D,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,SAAS,EAAE;IAAE,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,EAAE,EAAE,EAAE,eAAe,GACtF,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAarB;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACtC,SAAS,EAAE;IAAE,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,EAAE,EAAE,EAAE,eAAe,GACtF;IAAE,cAAc,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAG3D"}

package/dist/worker/cloudflare/room-client.js

@@ -0,0 +1,21 @@
+/** 対象DOを選び、認証済みActor向けのAPIだけを返す。IDの解決はアプリが行う。 */
+export function getRoom(namespace, id) {
+    const stub = namespace.get(id);
+    return {
+        create: () => stub.create(),
+        getView: actor => stub.getView(actor),
+        dispatchActor: (actor, command) => stub.dispatchActor(actor, command),
+        connect: actor => {
+            if (!actor || typeof actor.actorId !== "string" || !actor.actorId)
+                throw new Error("Verified actor required");
+            return stub.fetch(new Request("https://def-game.internal/connect", {
+                headers: { upgrade: "websocket", "x-def-game-actor-id": actor.actorId },
+            }));
+        },
+    };
+}
+/** 認証・権限確認済みのwebhookやマッチングからSystem Commandを渡す参照。 */
+export function getSystemRoom(namespace, id) {
+    const stub = namespace.get(id);
+    return { dispatchSystem: command => stub.dispatchSystem(command) };
+}

package/dist/worker/cloudflare/session-runtime.d.ts

@@ -0,0 +1,27 @@
+import { DurableObject } from "cloudflare:workers";
+import type { CommandResult, CreateRoomResult, GetViewResult, GameAdapter, GameTypes, VerifiedActor } from "./types.js";
+/**
+ * 1ルームを動かすCloudflare専用runtime。アプリはadapterだけを接続した派生クラスをexportする。
+ * RPCとfetchは信頼されたWorker専用。認証・外部リクエスト保護はWorker入口が担当する。
+ */
+export declare abstract class SessionRuntime<Env, T extends GameTypes> extends DurableObject<Env> {
+    #private;
+    protected abstract readonly adapter: GameAdapter<Env, T>;
+    /** 所有者や参加者を要求せず、ゲームの初期状態だけを保存する。 */
+    create(): Promise<CreateRoomResult>;
+    /** HTTP等からの読み取り。公開内容はprojectが決め、WS接続資格は要求しない。 */
+    getView(actor: VerifiedActor): Promise<GetViewResult<T["view"]>>;
+    /** アプリが認証済みActorと、必要なら外部取得済み情報を渡す入口。 */
+    dispatchActor(actor: VerifiedActor, command: T["actorCommand"]): Promise<CommandResult<T["error"]>>;
+    /** webhook等の認証を済ませたサーバー専用入口。外部本文からoriginをコピーしない。 */
+    dispatchSystem(command: T["systemCommand"]): Promise<CommandResult<T["error"]>>;
+    /** Alarm失敗は例外としてCloudflareの有限回リトライへ返す。 */
+    alarm(): Promise<void>;
+    /** 認証済みWorkerからだけ呼ぶ内部WS入口。一般HTTP Commandの転送は受け付けない。 */
+    fetch(request: Request): Promise<Response>;
+    /** WSの自己申告を実行元にせず、接続に保存したActorでdispatchする。 */
+    webSocketMessage(socket: WebSocket, raw: string | ArrayBuffer): Promise<void>;
+    webSocketClose(socket: WebSocket, code: number): void;
+    webSocketError(socket: WebSocket): void;
+}
+//# sourceMappingURL=session-runtime.d.ts.map

package/dist/worker/cloudflare/session-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../../src/cloudflare/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAgD,aAAa,EAAE,MAAM,YAAY,CAAC;AAMtK;;;GAGG;AACH,8BAAsB,cAAc,CAAC,GAAG,EAAE,CAAC,SAAS,SAAS,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;;IACvF,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEzD,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgBzC,iDAAiD;IAC3C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IActE,wCAAwC;IAClC,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKzG,oDAAoD;IAC9C,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAgFrF,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,uDAAuD;IACjD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBhD,8CAA8C;IACxC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEnF,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAGrD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CACxC"}