@zhin.js/game-kit 2.0.1 → 2.0.2

package/README.md

@@ -11,27 +11,27 @@ pnpm add @zhin.js/game-kit @zhin.js/command @zhin.js/middleware
 
 ## Runtime 插件
 
-游戏包通过 `plugin.ts` 在 generation 生命周期登记大厅元数据，并由约定目录暴露交互：
+游戏包通过 `defineGamePlugin()` 声明数据库表、服务和大厅元数据。数据库双轨、
+服务发布、跨游戏会话协调、超时 cron 与 HMR 清理由 game-kit 统一装配：
 
 ```ts
-import { definePlugin } from '@zhin.js/plugin-runtime';
-import { registerRuntimeGame } from '@zhin.js/game-kit';
+import { defineGamePlugin } from '@zhin.js/game-kit';
 
-export default definePlugin({
+export default defineGamePlugin({
   name: 'my-game',
-  setup(context) {
-    const services = createMyGameServices();
-    context.resources.provide(myGameServicesToken, services);
-    const dispose = registerRuntimeGame({
-      id: 'my-game',
-      title: 'My Game',
-      icon: 'GAME',
-      description: 'A turn-based game',
-      commandPrefix: '/my-game',
-      quickStart: 'start',
-    });
-    context.lifecycle.add(dispose);
+  game: {
+    id: 'my-game',
+    title: 'My Game',
+    icon: 'GAME',
+    description: 'A turn-based game',
+    commandPrefix: '/my-game',
+    quickStart: 'start',
   },
+  tables: ['my_game_sessions'],
+  servicesToken: myGameServicesToken,
+  defineHostTables,
+  createServices,
+  session: (services) => services.sessions,
 });
 ```
 
@@ -39,9 +39,65 @@ export default definePlugin({
 - `middlewares/` 处理按钮 payload、裸文本答案和旧命令别名。
 - `registerRuntimeGame()` / `getRuntimeGames()` 是大厅 SSOT，dispose 时对称移除。
 - `DEFAULT_GAME_STALE_CRON` 与 `scheduleHostToken` 用于清理超时会话。
+- `defineGamePlugin()` 在存在 `outboundHostToken` 时自动通知超时会话所在频道。
 - 每个游戏包定义自己的 typed service token；`plugin.ts` 提供资源，command/middleware
   通过 Capability Context 的 `use(token)` 消费。禁止以模块变量保存当前 SessionService。
 
+## 会话与事件
+
+游戏 SessionService 继承 `BaseSessionService<TRow>`，只负责构造游戏自己的初始行：
+
+```ts
+class SessionService extends BaseSessionService<MySessionRow> {
+  constructor(database: MyDatabase) {
+    super(database, {
+      gameId: 'my-game',
+      table: 'my_game_sessions',
+      userFields: ['player_id'],
+    });
+  }
+
+  createSession(input: StartInput) {
+    return this.createRow(createInitialRow(input));
+  }
+}
+```
+
+基类统一提供 `getById()`、用户/频道活动会话查询、`updateSession()`、`abortStale()`
+和跨游戏冲突检查。`gameEvents` 发布 `game:start`、`game:end`、
+`turn:change`、`session:timeout`；监听器失败不会回滚已经持久化的会话变化。
+
+SessionService 可用 `projectOutcomes` 把终局行投影为玩家结果。`defineGamePlugin()` 订阅
+`game:end` 并统一写入战绩，game-flow 不再直接触碰战绩数据库。
+
+`GameSessionCoordinator` 使用按 gameId 分组的 generation 栈。热更新先安装新代、再释放
+旧代时，查询始终落到最新服务；dispose 新代后仍可恢复旧代，避免短暂注册空窗。
+
+### 长生命周期与并发
+
+多人或长生命周期游戏继承 `VersionedSessionService<TRow>`。Session 行额外保存
+`revision` 和 `processed_actions`：
+
+```ts
+const result = await sessions.mutateSession(sessionId, {
+  actionId: `${messageId}:attack`,
+  expectedRevision: buttonRevision,
+  apply: (session) => ({
+    hp: session.hp - 10,
+  }),
+});
+```
+
+- `SessionActionGate` 串行化同一进程内针对同一 Session 的操作。
+- `expectedRevision` 提供持久化乐观锁，拒绝旧按钮和跨进程并发覆盖。
+- `processed_actions` 保存有界幂等历史，Adapter 重投不会重复结算。
+- 超时清理以扫描到的 `updated_at` 作为更新条件；扫描后发生的新动作不会被误终结。
+- `DeterministicRandom` 可保存 `state` 并由 `fromState()` 恢复，用于存档续玩、回放和
+  大规模确定性模拟；密钥等安全场景仍必须使用 `secureRandomInt()`。
+
+完整参考实现见
+[`plugins/games/dungeon-expedition`](../../plugins/games/dungeon-expedition/)。
+
 ## 交互消息
 
 ```ts
@@ -75,6 +131,7 @@ const board = buildGridKeyboard({
 ## 数据
 
 - `createInMemoryGameDb()`：测试与无数据库配置时的完整内存实现。
+- `createMemoryGameServices()`：把 typed service factory 接到唯一内存实现。
 - `createHostGameDb()`：把 generation-owned `DatabaseHost` 转成 SessionService 所需接口。
 - `initGameRecordHost()` / `recordGameOutcome()`：统一战绩表与结果写入。
 - `channelKey()` / `generateSessionId()`：稳定会话身份。

package/lib/base-session-service.d.ts

@@ -0,0 +1,54 @@
+import { type GameEventSession, type GameOutcome } from './game-events.js';
+import { type GameSessionProvider } from './session-coordinator.js';
+export interface BaseGameSessionRow extends GameEventSession {
+    id: string;
+    channel_key: string;
+    status: string;
+    updated_at: number;
+    created_at: number;
+    turn?: unknown;
+}
+export interface GameSessionModel<TRow extends BaseGameSessionRow> {
+    findAll(query?: Record<string, unknown>): Promise<TRow[]>;
+    findOne(query?: Record<string, unknown>): Promise<TRow | null>;
+    create(row: TRow): Promise<unknown>;
+    updateWhere(where: Record<string, unknown>, patch: Record<string, unknown>): Promise<unknown>;
+}
+export interface GameSessionDatabase<TRow extends BaseGameSessionRow> {
+    readonly models: {
+        get(name: string): GameSessionModel<TRow> | undefined;
+    };
+}
+export interface BaseSessionServiceOptions<TRow extends BaseGameSessionRow> {
+    readonly gameId: string;
+    readonly table: string;
+    readonly userFields: readonly (keyof TRow & string)[];
+    readonly activeStatus?: string;
+    readonly abortedStatus?: string;
+    readonly projectOutcomes?: (session: Readonly<TRow>, previous: Readonly<TRow>) => readonly GameOutcome[];
+}
+export type SessionTimeoutListener<TRow extends BaseGameSessionRow> = (session: TRow) => void | Promise<void>;
+/**
+ * Shared session lifecycle for every game. Subclasses own row construction and
+ * game-specific tables; this module owns persistence invariants and events.
+ */
+export declare abstract class BaseSessionService<TRow extends BaseGameSessionRow> implements GameSessionProvider {
+    #private;
+    readonly gameId: string;
+    protected constructor(database: GameSessionDatabase<TRow>, options: BaseSessionServiceOptions<TRow>);
+    getById(id: string): Promise<TRow | null>;
+    getActiveByChannel(channelKey: string): Promise<TRow | null>;
+    getActiveForUser(channelKey: string, userId: string): Promise<TRow | null>;
+    getLatestForUser(channelKey: string, userId: string): Promise<TRow | null>;
+    updateSession(id: string, patch: Partial<TRow>): Promise<void>;
+    /**
+     * Persist one transition and emit lifecycle events from the row that was
+     * actually stored. Versioned services use `where` for optimistic locking.
+     */
+    protected commitSession(previous: TRow, patch: Partial<TRow>, where: Record<string, unknown>): Promise<TRow | null>;
+    abortStale(idleMs: number, onTimeout?: SessionTimeoutListener<TRow>): Promise<number>;
+    registerCoordinator(): () => void;
+    protected createRow(row: TRow): Promise<TRow>;
+    protected get model(): GameSessionModel<TRow>;
+}
+//# sourceMappingURL=base-session-service.d.ts.map

package/lib/base-session-service.d.ts.map

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

package/lib/base-session-service.js

@@ -0,0 +1,139 @@
+import { gameEvents, } from './game-events.js';
+import { gameSessionCoordinator } from './session-coordinator.js';
+/**
+ * Shared session lifecycle for every game. Subclasses own row construction and
+ * game-specific tables; this module owns persistence invariants and events.
+ */
+export class BaseSessionService {
+    gameId;
+    #activeStatus;
+    #abortedStatus;
+    #userFields;
+    #projectOutcomes;
+    #model;
+    constructor(database, options) {
+        const model = database.models.get(options.table);
+        if (!model)
+            throw new Error(`${options.table} not registered`);
+        this.#model = model;
+        this.gameId = options.gameId;
+        this.#userFields = options.userFields;
+        this.#projectOutcomes = options.projectOutcomes;
+        this.#activeStatus = options.activeStatus ?? 'active';
+        this.#abortedStatus = options.abortedStatus ?? 'aborted';
+    }
+    async getById(id) {
+        return this.#model.findOne({ id });
+    }
+    async getActiveByChannel(channelKey) {
+        const rows = await this.#model.findAll({
+            channel_key: channelKey,
+            status: this.#activeStatus,
+        });
+        return rows[0] ?? null;
+    }
+    async getActiveForUser(channelKey, userId) {
+        const rows = await this.#model.findAll({
+            channel_key: channelKey,
+            status: this.#activeStatus,
+        });
+        return rows.find((row) => this.#userFields.some((field) => row[field] === userId)) ?? null;
+    }
+    async getLatestForUser(channelKey, userId) {
+        const rows = await this.#model.findAll({ channel_key: channelKey });
+        const matches = rows.filter((row) => this.#userFields.some((field) => row[field] === userId));
+        return matches.reduce((latest, row) => !latest || row.updated_at >= latest.updated_at ? row : latest, null);
+    }
+    async updateSession(id, patch) {
+        const previous = await this.getById(id);
+        if (!previous)
+            return;
+        await this.commitSession(previous, patch, { id });
+    }
+    /**
+     * Persist one transition and emit lifecycle events from the row that was
+     * actually stored. Versioned services use `where` for optimistic locking.
+     */
+    async commitSession(previous, patch, where) {
+        const updatedAt = Date.now();
+        const changed = await this.#model.updateWhere(where, { ...patch, updated_at: updatedAt });
+        if (typeof changed === 'number' && changed === 0)
+            return null;
+        const session = await this.getById(previous.id);
+        if (!session)
+            return null;
+        if (patch.turn !== undefined && patch.turn !== previous.turn) {
+            await gameEvents.emit('turn:change', {
+                gameId: this.gameId,
+                session,
+                previousTurn: previous.turn,
+                turn: patch.turn,
+            });
+        }
+        if (patch.status !== undefined
+            && previous.status === this.#activeStatus
+            && patch.status !== this.#activeStatus) {
+            await gameEvents.emit('game:end', {
+                gameId: this.gameId,
+                session,
+                previousStatus: previous.status,
+                outcomes: this.#projectOutcomes?.(session, previous) ?? [],
+            });
+        }
+        return session;
+    }
+    async abortStale(idleMs, onTimeout) {
+        const cutoff = Date.now() - idleMs;
+        const rows = await this.#model.findAll({ status: this.#activeStatus });
+        let count = 0;
+        for (const row of rows) {
+            if (row.updated_at >= cutoff)
+                continue;
+            // The timestamp condition prevents a cleanup scan from aborting a
+            // session that received a player action after this row was selected.
+            const session = await this.commitSession(row, { status: this.#abortedStatus }, {
+                id: row.id,
+                status: this.#activeStatus,
+                updated_at: row.updated_at,
+            });
+            if (!session)
+                continue;
+            await gameEvents.emit('session:timeout', {
+                gameId: this.gameId,
+                session,
+                idleMs,
+            });
+            // A broken outbound adapter must not prevent later stale sessions from
+            // being finalized. Persistence and lifecycle events already succeeded.
+            if (onTimeout) {
+                try {
+                    await onTimeout(session);
+                }
+                catch {
+                    // Notification is best-effort; the next cleanup pass stays healthy.
+                }
+            }
+            count += 1;
+        }
+        return count;
+    }
+    registerCoordinator() {
+        return gameSessionCoordinator.register(this);
+    }
+    async createRow(row) {
+        const userIds = [];
+        for (const field of this.#userFields) {
+            const value = row[field];
+            if (typeof value === 'string')
+                userIds.push(value);
+        }
+        await gameSessionCoordinator.assertAvailable(this.gameId, row.channel_key, userIds);
+        await this.#model.create(row);
+        await gameEvents.emit('game:start', { gameId: this.gameId, session: row });
+        return row;
+    }
+    get model() {
+        return this.#model;
+    }
+}
+//# sourceMappingURL=base-session-service.js.map

package/lib/base-session-service.js.map

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

package/lib/command-alias.d.ts

@@ -1,5 +1,6 @@
 import { type MiddlewareContext } from '@zhin.js/middleware';
 import type { Message } from '@zhin.js/core/runtime';
+type AliasReply = Parameters<Message['$reply']>[0];
 /**
  * 游戏 legacy 命令别名路由。
  *
@@ -15,7 +16,8 @@ export interface GameCommandAliasRoute {
      * 与 `commands/<cmd>/[action:string=].ts` 的 execute 逻辑保持一致：
      * action 为别名后剩余文本（无参数时为 ''）；返回回复文本，null/undefined 表示放行。
      */
-    run(action: string, input: unknown, context: MiddlewareContext<Message>): Promise<string | null | undefined>;
+    run(action: string, input: unknown, context: MiddlewareContext<Message>): Promise<AliasReply | null | undefined>;
 }
 export declare function defineGameCommandAliasMiddleware(route: GameCommandAliasRoute): Readonly<import("@zhin.js/middleware").MiddlewareDefinition<Message, unknown>>;
+export {};
 //# sourceMappingURL=command-alias.d.ts.map

package/lib/command-alias.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-alias.d.ts","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACvC;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,qBAAqB,kFAmB5E"}
+{"version":3,"file":"command-alias.d.ts","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC3C;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,qBAAqB,kFAmB5E"}

package/lib/command-alias.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-alias.js","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAyB/E,MAAM,UAAU,gCAAgC,CAAC,KAA4B;IAC3E,OAAO,gBAAgB,CAAU;QAC/B,MAAM,EAAE,SAAS;QACjB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI;YACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACtD,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"command-alias.js","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AA2B/E,MAAM,UAAU,gCAAgC,CAAC,KAA4B;IAC3E,OAAO,gBAAgB,CAAU;QAC/B,MAAM,EAAE,SAAS;QACjB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI;YACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACtD,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/lib/command-message.d.ts

@@ -4,6 +4,9 @@
  * Runtime Message: { adapter, target, sender?, metadata? }
  * Classic Message: { $adapter, $endpoint, $channel, $sender }
  */
+import type { SendContent } from '@zhin.js/core';
+/** A game returns semantic content; Runtime owns native rendering and text fallback. */
+export type GameReply = SendContent;
 export interface GameMessageLike {
     $adapter: string;
     $endpoint: string;

package/lib/command-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-message.d.ts","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AA8BD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoBvE"}
+{"version":3,"file":"command-message.d.ts","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AA8BD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoBvE"}

package/lib/command-message.js

@@ -1,9 +1,3 @@
-/**
- * Map Plugin Runtime CommandContext.input → classic Message-like shape used by game SessionService.
- *
- * Runtime Message: { adapter, target, sender?, metadata? }
- * Classic Message: { $adapter, $endpoint, $channel, $sender }
- */
 function isClassicMessage(input) {
     if (!input || typeof input !== 'object')
         return false;

package/lib/command-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-message.js","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,IAAI,IAAI;QAClB,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,OAAO,IAAI,IAAI;QACjB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IAMtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,SAAS,IAAI,CAAC;QACd,QAAQ,IAAI,CAAC;QACb,QAAQ,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE;QAC1C,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE;YAC9C,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"command-message.js","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAsBA,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,IAAI,IAAI;QAClB,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,OAAO,IAAI,IAAI;QACjB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IAMtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,SAAS,IAAI,CAAC;QACd,QAAQ,IAAI,CAAC;QACb,QAAQ,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE;QAC1C,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE;YAC9C,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/lib/define-game-plugin.d.ts

@@ -0,0 +1,32 @@
+import { type DatabaseHost, type PluginMetadata, type PluginSetupContext, type Token } from '@zhin.js/plugin-runtime';
+import { type InMemoryGameDb } from './memory-db.js';
+import { type RuntimeRegisteredGame } from './runtime-hub.js';
+import type { BaseGameSessionRow, BaseSessionService } from './base-session-service.js';
+export interface GamePluginSession<TRow extends BaseGameSessionRow = BaseGameSessionRow> {
+    abortStale(idleMs: number, onTimeout?: (session: TRow) => void | Promise<void>): Promise<number>;
+    registerCoordinator?(): () => void;
+}
+export interface DefineGamePluginOptions<TServices, TRow extends BaseGameSessionRow = BaseGameSessionRow, TConfig = unknown> {
+    readonly name: string;
+    readonly metadata?: PluginMetadata;
+    readonly game: RuntimeRegisteredGame;
+    readonly tables: readonly string[];
+    readonly servicesToken: Token<TServices>;
+    readonly defineHostTables: (host: DatabaseHost) => void;
+    readonly createServices: (database: InMemoryGameDb) => TServices;
+    readonly session: (services: TServices) => GamePluginSession<TRow> | BaseSessionService<TRow>;
+    readonly stale?: {
+        readonly cron?: string;
+        readonly idleMs?: number;
+        readonly description?: string;
+        readonly message?: string | ((session: TRow) => string);
+        readonly onTimeout?: (session: TRow, context: PluginSetupContext<TConfig>) => void | Promise<void>;
+    } | false;
+    readonly setup?: (context: PluginSetupContext<TConfig>, services: TServices) => void | (() => void) | Promise<void | (() => void)>;
+}
+/**
+ * Declarative Plugin Runtime assembly for games. Database selection, service
+ * publication, Hub registration, stale cleanup and HMR disposal live here.
+ */
+export declare function defineGamePlugin<TServices, TRow extends BaseGameSessionRow = BaseGameSessionRow, TConfig = unknown>(options: DefineGamePluginOptions<TServices, TRow, TConfig>): Readonly<import("@zhin.js/plugin-runtime").PluginDefinition<TConfig>>;
+//# sourceMappingURL=define-game-plugin.d.ts.map

package/lib/define-game-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-game-plugin.d.ts","sourceRoot":"","sources":["../src/define-game-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,iBAAiB,CAChC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB;IAEpD,UAAU,CACR,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,mBAAmB,CAAC,IAAI,MAAM,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB,CACtC,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,SAAS,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,CAChB,QAAQ,EAAE,SAAS,KAChB,iBAAiB,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;QACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,CACnB,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3B,GAAG,KAAK,CAAC;IACV,QAAQ,CAAC,KAAK,CAAC,EAAE,CACf,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACpC,QAAQ,EAAE,SAAS,KAChB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO,EAEjB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,yEA+E3D"}

package/lib/define-game-plugin.js

@@ -0,0 +1,87 @@
+import { databaseHostToken, definePlugin, outboundHostToken, scheduleHostToken, } from '@zhin.js/plugin-runtime';
+import { createHostGameDb, createInMemoryGameDb, } from './memory-db.js';
+import { initGameRecordHost, recordGameOutcome, } from './game-records.js';
+import { gameEvents } from './game-events.js';
+import { DEFAULT_GAME_STALE_CRON, DEFAULT_GAME_STALE_IDLE_MS, registerRuntimeGame, } from './runtime-hub.js';
+/**
+ * Declarative Plugin Runtime assembly for games. Database selection, service
+ * publication, Hub registration, stale cleanup and HMR disposal live here.
+ */
+export function defineGamePlugin(options) {
+    return definePlugin({
+        name: options.name,
+        metadata: options.metadata,
+        async setup(context) {
+            let database;
+            if (context.resources.has(databaseHostToken)) {
+                const host = context.resources.use(databaseHostToken);
+                options.defineHostTables(host);
+                database = createHostGameDb(host, options.tables);
+                context.lifecycle.add(initGameRecordHost(host));
+            }
+            else {
+                database = createInMemoryGameDb(options.tables);
+            }
+            const services = options.createServices(database);
+            context.resources.provide(options.servicesToken, services);
+            const session = options.session(services);
+            const disposeCoordinator = session.registerCoordinator?.();
+            if (disposeCoordinator)
+                context.lifecycle.add(disposeCoordinator);
+            context.lifecycle.add(registerRuntimeGame(options.game));
+            context.lifecycle.add(gameEvents.on('game:end', async (event) => {
+                if (event.gameId !== options.game.id || event.outcomes.length === 0)
+                    return;
+                const row = event.session;
+                if (!row.adapter || !row.endpoint || !row.channel_type || !row.channel_id)
+                    return;
+                for (const outcome of event.outcomes) {
+                    await recordGameOutcome({
+                        $adapter: row.adapter,
+                        $endpoint: row.endpoint,
+                        $channel: { type: row.channel_type, id: row.channel_id },
+                        $sender: {
+                            id: outcome.userId,
+                            name: outcome.userName ?? outcome.userId,
+                        },
+                    }, event.gameId, outcome.result, outcome.score);
+                }
+            }));
+            if (options.stale !== false && context.resources.has(scheduleHostToken)) {
+                const stale = options.stale ?? {};
+                const schedule = context.resources.use(scheduleHostToken);
+                context.lifecycle.add(schedule.register({
+                    id: `${options.game.id}/abort-stale`,
+                    cron: stale.cron ?? DEFAULT_GAME_STALE_CRON,
+                    description: stale.description
+                        ?? `Abort stale ${options.name} sessions`,
+                    async execute() {
+                        await session.abortStale(stale.idleMs ?? DEFAULT_GAME_STALE_IDLE_MS, async (row) => {
+                            await stale.onTimeout?.(row, context);
+                            if (!context.resources.has(outboundHostToken))
+                                return;
+                            if (!row.adapter || !row.endpoint
+                                || !row.channel_type || !row.channel_id)
+                                return;
+                            const outbound = context.resources.use(outboundHostToken);
+                            await outbound.send({
+                                adapter: row.adapter,
+                                endpointId: row.endpoint,
+                                channelType: row.channel_type,
+                                channelId: row.channel_id,
+                                content: typeof stale.message === 'function'
+                                    ? stale.message(row)
+                                    : stale.message
+                                        ?? `${options.game.icon} ${options.game.title}对局因长时间无操作已结束。`,
+                            });
+                        });
+                    },
+                }));
+            }
+            const dispose = await options.setup?.(context, services);
+            if (dispose)
+                context.lifecycle.add(dispose);
+        },
+    });
+}
+//# sourceMappingURL=define-game-plugin.js.map

package/lib/define-game-plugin.js.map

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

package/lib/deterministic-random.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Serializable xorshift32 generator for replayable game simulations.
+ * Security-sensitive randomness must continue using secureRandomInt.
+ */
+export declare class DeterministicRandom {
+    #private;
+    private constructor();
+    static fromSeed(seed: string | number): DeterministicRandom;
+    static fromState(state: number): DeterministicRandom;
+    get state(): number;
+    nextUint32(): number;
+    int(maxExclusive: number): number;
+    intInclusive(min: number, max: number): number;
+    item<T>(items: readonly T[]): T;
+}
+//# sourceMappingURL=deterministic-random.d.ts.map

package/lib/deterministic-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-random.d.ts","sourceRoot":"","sources":["../src/deterministic-random.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,mBAAmB;;IAG9B,OAAO;IAIP,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB;IAM3D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAIpD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,UAAU,IAAI,MAAM;IASpB,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAgBjC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAO9C,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;CAMhC"}

package/lib/deterministic-random.js

@@ -0,0 +1,68 @@
+const UINT32_RANGE = 0x1_0000_0000;
+const ZERO_STATE_FALLBACK = 0x6d2b79f5;
+/**
+ * Serializable xorshift32 generator for replayable game simulations.
+ * Security-sensitive randomness must continue using secureRandomInt.
+ */
+export class DeterministicRandom {
+    #state;
+    constructor(state) {
+        this.#state = normalizeState(state);
+    }
+    static fromSeed(seed) {
+        return new DeterministicRandom(typeof seed === 'number' ? seed : hashSeed(seed));
+    }
+    static fromState(state) {
+        return new DeterministicRandom(state);
+    }
+    get state() {
+        return this.#state;
+    }
+    nextUint32() {
+        let value = this.#state;
+        value ^= value << 13;
+        value ^= value >>> 17;
+        value ^= value << 5;
+        this.#state = value >>> 0;
+        return this.#state;
+    }
+    int(maxExclusive) {
+        if (!Number.isSafeInteger(maxExclusive)
+            || maxExclusive <= 0
+            || maxExclusive > UINT32_RANGE) {
+            throw new RangeError('maxExclusive must be an integer between 1 and 2^32');
+        }
+        const limit = Math.floor(UINT32_RANGE / maxExclusive) * maxExclusive;
+        let value;
+        do {
+            value = this.nextUint32();
+        } while (value >= limit);
+        return value % maxExclusive;
+    }
+    intInclusive(min, max) {
+        if (!Number.isSafeInteger(min) || !Number.isSafeInteger(max) || max < min) {
+            throw new RangeError('invalid inclusive random range');
+        }
+        return min + this.int(max - min + 1);
+    }
+    item(items) {
+        if (items.length === 0) {
+            throw new RangeError('cannot choose from an empty array');
+        }
+        return items[this.int(items.length)];
+    }
+}
+function normalizeState(state) {
+    if (!Number.isFinite(state))
+        throw new RangeError('state must be finite');
+    return (state >>> 0) || ZERO_STATE_FALLBACK;
+}
+function hashSeed(seed) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < seed.length; index += 1) {
+        hash ^= seed.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+//# sourceMappingURL=deterministic-random.js.map

package/lib/deterministic-random.js.map

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