@zhin.js/plugin-blackjack 0.0.0

package/lib/session-service.js

@@ -0,0 +1,108 @@
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+import { freshDeck } from './engine.js';
+function getModel(db) {
+    const model = db.models.get('bj_sessions');
+    if (!model)
+        throw new Error('bj_sessions not registered');
+    return model;
+}
+export function resolveGameDatabase(feature) {
+    return feature.db;
+}
+export class SessionService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async createSession(message) {
+        const deck = freshDeck();
+        const playerCards = [deck.pop(), deck.pop()];
+        const dealerCards = [deck.pop(), deck.pop()];
+        const now = Date.now();
+        const row = {
+            id: generateSessionId(),
+            adapter: String(message.$adapter),
+            endpoint: message.$endpoint,
+            channel_type: message.$channel.type,
+            channel_id: message.$channel.id,
+            channel_key: channelKey(message),
+            player_id: message.$sender.id,
+            player_name: String(message.$sender.name ?? message.$sender.id),
+            deck_json: JSON.stringify(deck),
+            player_cards_json: JSON.stringify(playerCards),
+            dealer_cards_json: JSON.stringify(dealerCards),
+            board_message_id: '',
+            status: 'active',
+            updated_at: now,
+            created_at: now,
+        };
+        await getModel(this.db).create(row);
+        return row;
+    }
+    async getById(id) {
+        return getModel(this.db).findOne({ id });
+    }
+    async getActiveForUser(channelKeyValue, userId) {
+        const rows = await getModel(this.db).findAll({
+            channel_key: channelKeyValue,
+            player_id: userId,
+            status: 'active',
+        });
+        return rows[0] ?? null;
+    }
+    async getActiveByChannel(channelKeyValue) {
+        const rows = await getModel(this.db).findAll({
+            channel_key: channelKeyValue,
+            status: 'active',
+        });
+        return rows[0] ?? null;
+    }
+    async getActiveByBoardMessageId(messageId) {
+        const rows = await getModel(this.db).findAll({
+            board_message_id: messageId,
+            status: 'active',
+        });
+        return rows[0] ?? null;
+    }
+    async updateSession(id, patch) {
+        await getModel(this.db).updateWhere({ id }, { ...patch, updated_at: Date.now() });
+    }
+    async abortStale(maxAgeMs) {
+        const cutoff = Date.now() - maxAgeMs;
+        const model = getModel(this.db);
+        const rows = await model.findAll({ status: 'active' });
+        let n = 0;
+        for (const row of rows) {
+            if (row.updated_at < cutoff) {
+                await model.updateWhere({ id: row.id }, { status: 'aborted', updated_at: Date.now() });
+                n++;
+            }
+        }
+        return n;
+    }
+}
+export function createServices(db) {
+    return new SessionService(db);
+}
+function parseJsonStringArray(value) {
+    if (Array.isArray(value))
+        return value.filter((x) => typeof x === 'string');
+    if (typeof value !== 'string' || !value)
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed)
+            ? parsed.filter((x) => typeof x === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function parseCards(json) {
+    return parseJsonStringArray(json);
+}
+export function parseDeck(json) {
+    return parseJsonStringArray(json);
+}
+//# sourceMappingURL=session-service.js.map

package/lib/session-service.js.map

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

package/lib/view.d.ts

@@ -0,0 +1,7 @@
+import type { SendContent } from 'zhin.js';
+import type { BjSessionRow } from './models.js';
+export declare function buildBjView(session: BjSessionRow, terminal?: boolean, revealDealer?: boolean, channelType?: string): SendContent;
+export declare function checkNaturalBlackjack(session: BjSessionRow): boolean;
+export declare function naturalOutcome(session: BjSessionRow): 'won' | 'lost' | 'draw' | null;
+export declare function playerBust(session: BjSessionRow): boolean;
+//# sourceMappingURL=view.d.ts.map

package/lib/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,EACrB,QAAQ,UAAQ,EAChB,YAAY,UAAQ,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,WAAW,CAqCb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAIpE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CASpF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAEzD"}

package/lib/view.js

@@ -0,0 +1,64 @@
+import { buildChoiceKeyboard } from '@zhin.js/game-shared';
+import { BJ_PREFIX, formatHand, handValue, isBlackjack, TARGET } from './engine.js';
+import { parseCards } from './session-service.js';
+export function buildBjView(session, terminal = false, revealDealer = false, channelType) {
+    const player = parseCards(session.player_cards_json);
+    const dealer = parseCards(session.dealer_cards_json);
+    const lines = [
+        '🃏 **21 点**',
+        '',
+        `你的牌：${formatHand(player)}`,
+        `庄家：${revealDealer || terminal ? formatHand(dealer) : formatHand(dealer, true)}`,
+        '',
+    ];
+    if (terminal) {
+        if (session.status === 'won')
+            lines.push('🎉 **你赢了！**');
+        else if (session.status === 'lost')
+            lines.push('💀 **你输了**');
+        else
+            lines.push('🤝 **平局**');
+        lines.push('', '点击「再来一局」或发送 `/21点 开始`');
+    }
+    else {
+        lines.push(`目标：尽量接近 ${TARGET} 且不超过。`);
+    }
+    const choices = terminal
+        ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary', keepEnabledWhenTerminal: true }]
+        : [
+            { id: 'hit', label: '➕ 要牌', style: 'primary' },
+            { id: 'stand', label: '✋ 停牌', style: 'secondary' },
+        ];
+    return buildChoiceKeyboard({
+        gamePrefix: BJ_PREFIX,
+        sessionId: session.id,
+        narrative: lines.join('\n'),
+        choices,
+        terminal,
+        fallbackHint: terminal ? '回复 1 再来一局' : '1 要牌 · 2 停牌',
+        interactionProfile: terminal ? 'terminal' : 'gameplay',
+        channelType,
+    });
+}
+export function checkNaturalBlackjack(session) {
+    const player = parseCards(session.player_cards_json);
+    const dealer = parseCards(session.dealer_cards_json);
+    return isBlackjack(player) || isBlackjack(dealer);
+}
+export function naturalOutcome(session) {
+    const player = parseCards(session.player_cards_json);
+    const dealer = parseCards(session.dealer_cards_json);
+    const pbj = isBlackjack(player);
+    const dbj = isBlackjack(dealer);
+    if (!pbj && !dbj)
+        return null;
+    if (pbj && dbj)
+        return 'draw';
+    if (pbj)
+        return 'won';
+    return 'lost';
+}
+export function playerBust(session) {
+    return handValue(parseCards(session.player_cards_json)) > TARGET;
+}
+//# sourceMappingURL=view.js.map

package/lib/view.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zhin.js/plugin-blackjack",
+  "version": "0.0.0",
+  "description": "Zhin.js 21 点（Blackjack）",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "plugin.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "zhin.js": "4.1.0"
+  },
+  "dependencies": {
+    "@zhin.js/game-shared": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "zhin.js": "4.1.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: "@zhin.js/plugin-blackjack"
+description: "21 点 Blackjack"

package/src/bj-command.ts

@@ -0,0 +1,26 @@
+import type { Message, Plugin } from 'zhin.js';
+import { continueGame, handleChoice, startGame } from './game-flow.js';
+import type { SessionService } from './session-service.js';
+
+export const BJ_HELP = [
+  '🃏 **21 点**',
+  '',
+  '尽量让手牌点数接近 21 且不超过，比庄家大即获胜。',
+  '',
+  '• `/21点 开始` — 新局',
+  '• `/21点 继续` — 刷新界面',
+  '• 对局中点击 **要牌** / **停牌**',
+].join('\n');
+
+export async function runBjCommand(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  action: string,
+): Promise<string | undefined> {
+  const a = action.trim().toLowerCase() || 'help';
+  if (a === 'help' || a === '帮助') return BJ_HELP;
+  if (a === 'start' || a === '开始') return startGame(plugin, services, message);
+  if (a === 'continue' || a === '继续') return continueGame(plugin, services, message);
+  return `未知操作「${action}」。发送 \`/21点 帮助\`。`;
+}

package/src/commands.ts

@@ -0,0 +1,117 @@
+import { Message, MessageCommand, getActionFromMessage, type Plugin } from 'zhin.js';
+import {
+  buildChoiceFallbackMap,
+  channelKey,
+  parseChoicePayload,
+  registerGameTextMiddleware,
+  resolveGameChoice,
+  resolveGameTextPayload,
+} from '@zhin.js/game-shared';
+import { BJ_PREFIX, handleChoice } from './game-flow.js';
+import { runBjCommand } from './bj-command.js';
+import type { SessionService } from './session-service.js';
+
+const VALID_CHOICES = ['hit', 'stand', 'restart'] as const;
+
+function registerPattern(
+  plugin: Plugin,
+  pattern: string,
+  desc: string,
+  getServices: () => SessionService | null,
+): void {
+  plugin.addCommand(
+    new MessageCommand(pattern)
+      .desc(desc)
+      .action(async (message, result) => {
+        const services = getServices();
+        if (!services) return '21 点需要启用 database 配置。';
+        const raw = (result.params.action as string | undefined) ?? '';
+        return runBjCommand(plugin, services, message, raw);
+      }),
+  );
+}
+
+export function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerPattern(plugin, '/21点 [action:word]', '21 点（中文）', getServices);
+  registerPattern(plugin, '/bj [action:word]', 'Blackjack (English)', getServices);
+}
+
+async function resolveChoice(
+  message: Message<any>,
+  services: SessionService,
+): Promise<{ sessionId: string; choiceId: string } | null> {
+  return resolveGameChoice({
+    message,
+    gamePrefix: BJ_PREFIX,
+    validChoiceIds: VALID_CHOICES,
+    getById: (id) => services.getById(id),
+    getActiveForUser: (ch, uid) => services.getActiveForUser(ch, uid),
+    getByBoardMessageId: (mid) => services.getActiveByBoardMessageId(mid),
+  });
+}
+
+export function registerInteractive(plugin: Plugin, getServices: () => SessionService | null): void {
+  plugin.registerInteractiveHandler(`${BJ_PREFIX}:`, async (message) => {
+    const services = getServices();
+    if (!services) return false;
+    const choice = await resolveChoice(message, services);
+    if (!choice) return false;
+    const err = await handleChoice(plugin, services, message, choice.sessionId, choice.choiceId);
+    if (err) await message.$reply?.(err);
+    return true;
+  });
+}
+
+export function registerTextFallback(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerGameTextMiddleware(plugin, async (message, next) => {
+    const services = getServices();
+    if (!services) return next();
+
+    const action = getActionFromMessage(message);
+    if (action?.payload.startsWith(`${BJ_PREFIX}:`)) return next();
+
+    const raw = message.$raw?.trim() ?? '';
+    const ch = channelKey(message);
+
+    const payloadFromText = resolveGameTextPayload(raw);
+    if (payloadFromText?.startsWith(`${BJ_PREFIX}:`)) {
+      const parsed = parseChoicePayload(payloadFromText, BJ_PREFIX);
+      if (parsed) {
+        const session = await services.getById(parsed.sessionId);
+        if (session?.channel_key === ch) {
+          const err = await handleChoice(plugin, services, message, parsed.sessionId, parsed.choiceId);
+          if (err) await message.$reply?.(err);
+          return;
+        }
+      }
+    }
+
+    const session = await services.getActiveForUser(ch, message.$sender.id);
+    if (!session) return next();
+
+    if (session.status !== 'active') {
+      const map = buildChoiceFallbackMap(BJ_PREFIX, session.id, [
+        { id: 'restart', label: '再来一局', keepEnabledWhenTerminal: true },
+      ]);
+      const payload = resolveGameTextPayload(raw, map);
+      const parsed = payload ? parseChoicePayload(payload, BJ_PREFIX) : null;
+      if (parsed?.choiceId === 'restart') {
+        const err = await handleChoice(plugin, services, message, parsed.sessionId, 'restart');
+        if (err) await message.$reply?.(err);
+        return;
+      }
+      return next();
+    }
+
+    const map = buildChoiceFallbackMap(BJ_PREFIX, session.id, [
+      { id: 'hit', label: '要牌' },
+      { id: 'stand', label: '停牌' },
+    ]);
+    const payload = resolveGameTextPayload(raw, map);
+    const parsed = payload ? parseChoicePayload(payload, BJ_PREFIX) : null;
+    if (!parsed || parsed.sessionId !== session.id) return next();
+
+    const err = await handleChoice(plugin, services, message, session.id, parsed.choiceId);
+    if (err) await message.$reply?.(err);
+  }, 'bj:text');
+}

package/src/engine.ts

@@ -0,0 +1,67 @@
+export const BJ_PREFIX = 'bj';
+export const TARGET = 21;
+
+const RANKS = ['A', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K'] as const;
+const SUITS = ['♠', '♥', '♦', '♣'] as const;
+
+export type Card = `${typeof RANKS[number]}${typeof SUITS[number]}`;
+
+export function freshDeck(): Card[] {
+  const deck: Card[] = [];
+  for (const r of RANKS) {
+    for (const s of SUITS) {
+      deck.push(`${r}${s}` as Card);
+    }
+  }
+  for (let i = deck.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [deck[i], deck[j]] = [deck[j]!, deck[i]!];
+  }
+  return deck;
+}
+
+export function cardValue(rank: string): number {
+  if (rank === 'A') return 11;
+  if (rank === 'J' || rank === 'Q' || rank === 'K') return 10;
+  return Number(rank);
+}
+
+export function handValue(cards: readonly string[]): number {
+  let total = 0;
+  let aces = 0;
+  for (const c of cards) {
+    const rank = c.slice(0, c.length - 1);
+    if (rank === 'A') aces++;
+    total += cardValue(rank);
+  }
+  while (total > TARGET && aces > 0) {
+    total -= 10;
+    aces--;
+  }
+  return total;
+}
+
+export function formatHand(cards: readonly string[], hideSecond = false): string {
+  if (hideSecond && cards.length >= 2) {
+    return `${cards[0]} 🂠 (${handValue([cards[0]!])})`;
+  }
+  return `${cards.join(' ')} (${handValue(cards)})`;
+}
+
+export function isBlackjack(cards: readonly string[]): boolean {
+  return cards.length === 2 && handValue(cards) === TARGET;
+}
+
+export function dealerShouldHit(cards: readonly string[]): boolean {
+  return handValue(cards) < 17;
+}
+
+export function compareHands(player: readonly string[], dealer: readonly string[]): 'won' | 'lost' | 'draw' {
+  const pv = handValue(player);
+  const dv = handValue(dealer);
+  if (pv > TARGET) return 'lost';
+  if (dv > TARGET) return 'won';
+  if (pv > dv) return 'won';
+  if (pv < dv) return 'lost';
+  return 'draw';
+}

package/src/game-flow.ts

@@ -0,0 +1,164 @@
+import type { Adapter, Message, Plugin } from 'zhin.js';
+import { recordGameOutcome } from '@zhin.js/game-shared';
+import {
+  BJ_PREFIX,
+  compareHands,
+  dealerShouldHit,
+  handValue,
+  TARGET,
+} from './engine.js';
+import type { BjSessionRow } from './models.js';
+import type { SessionService } from './session-service.js';
+import { parseCards, parseDeck } from './session-service.js';
+import { buildBjView, naturalOutcome, playerBust } from './view.js';
+
+async function sendOrEditView(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  session: BjSessionRow,
+  terminal = false,
+  revealDealer = false,
+): Promise<void> {
+  const content = buildBjView(session, terminal, revealDealer, message.$channel.type);
+  const adapter = plugin.root.inject(message.$adapter) as Adapter;
+
+  if (session.board_message_id) {
+    const msgId = await adapter.editMessage({
+      messageId: session.board_message_id,
+      context: String(message.$adapter),
+      endpoint: message.$endpoint,
+      id: message.$channel.id,
+      type: message.$channel.type,
+      content,
+    });
+    if (msgId !== session.board_message_id) {
+      await services.updateSession(session.id, { board_message_id: msgId });
+    }
+    return;
+  }
+
+  const msgId = await message.$reply?.(content);
+  if (msgId) await services.updateSession(session.id, { board_message_id: msgId });
+}
+
+async function finishRound(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  session: BjSessionRow,
+  status: BjSessionRow['status'],
+): Promise<void> {
+  await services.updateSession(session.id, { status });
+  const updated = (await services.getById(session.id))!;
+  if (status === 'won') void recordGameOutcome(message, 'blackjack', 'won', 30);
+  else if (status === 'lost') void recordGameOutcome(message, 'blackjack', 'lost');
+  else if (status === 'draw') void recordGameOutcome(message, 'blackjack', 'draw');
+  await sendOrEditView(plugin, services, message, updated, true, true);
+}
+
+async function dealerPlay(
+  deck: string[],
+  dealer: string[],
+): Promise<string[]> {
+  const hand = [...dealer];
+  while (dealerShouldHit(hand)) {
+    const card = deck.pop();
+    if (!card) break;
+    hand.push(card);
+  }
+  return hand;
+}
+
+export async function startGame(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+): Promise<string | undefined> {
+  const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+  const active = await services.getActiveByChannel(ch);
+  if (active) {
+    if (active.player_id === message.$sender.id) {
+      return '你已有进行中的 21 点，发送「21点 继续」刷新。';
+    }
+    return `本频道 ${active.player_name} 正在玩 21 点。`;
+  }
+  const session = await services.createSession(message);
+  const natural = naturalOutcome(session);
+  if (natural) {
+    await finishRound(plugin, services, message, session, natural);
+    return undefined;
+  }
+  await sendOrEditView(plugin, services, message, session);
+  return undefined;
+}
+
+export async function continueGame(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+): Promise<string> {
+  const session = await services.getActiveForUser(
+    `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`,
+    message.$sender.id,
+  );
+  if (!session) return '你没有进行中的 21 点，发送「21点 开始」。';
+  await sendOrEditView(plugin, services, message, session);
+  return '已刷新 21 点界面。';
+}
+
+export async function handleChoice(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  sessionId: string,
+  choiceId: string,
+): Promise<string | null> {
+  const session = await services.getById(sessionId);
+  if (!session) return '对局不存在。';
+  if (session.player_id !== message.$sender.id) return '这是别人的对局。';
+
+  if (session.status !== 'active' && choiceId === 'restart') {
+    await services.updateSession(session.id, { status: 'aborted' });
+    await startGame(plugin, services, message);
+    return null;
+  }
+
+  if (session.status !== 'active') return '对局已结束，请点击再来一局。';
+
+  let deck = parseDeck(session.deck_json);
+  let player = parseCards(session.player_cards_json);
+  let dealer = parseCards(session.dealer_cards_json);
+
+  if (choiceId === 'hit') {
+    const card = deck.pop();
+    if (!card) return '牌堆已空。';
+    player = [...player, card];
+    await services.updateSession(session.id, {
+      deck_json: JSON.stringify(deck),
+      player_cards_json: JSON.stringify(player),
+    });
+    if (playerBust({ ...session, player_cards_json: JSON.stringify(player) })) {
+      await finishRound(plugin, services, message, session, 'lost');
+      return null;
+    }
+    const updated = (await services.getById(session.id))!;
+    await sendOrEditView(plugin, services, message, updated);
+    return null;
+  }
+
+  if (choiceId !== 'stand') return '无效操作。';
+
+  dealer = await dealerPlay(deck, dealer);
+  await services.updateSession(session.id, {
+    deck_json: JSON.stringify(deck),
+    dealer_cards_json: JSON.stringify(dealer),
+  });
+  const outcome = compareHands(player, dealer);
+  const status: BjSessionRow['status'] =
+    outcome === 'won' ? 'won' : outcome === 'lost' ? 'lost' : 'draw';
+  await finishRound(plugin, services, message, session, status);
+  return null;
+}
+
+export { BJ_PREFIX, handValue, TARGET };

package/src/hub-register.ts

@@ -0,0 +1,28 @@
+import { getPlugin } from 'zhin.js';
+import { ensureGameHubService } from '@zhin.js/game-shared';
+import { runBjCommand, BJ_HELP } from './bj-command.js';
+import type { SessionService } from './session-service.js';
+
+export function registerBjHub(getServices: () => SessionService | null): () => void {
+  const plugin = getPlugin();
+  ensureGameHubService(plugin);
+  return plugin.registerGame({
+    id: 'blackjack',
+    title: '21 点',
+    icon: '🃏',
+    description: '经典 Blackjack，要牌或停牌挑战庄家',
+    commandPrefix: '/21点',
+    quickStart: '开始',
+    aliases: ['bj', '21点'],
+    menus: [
+      { id: 'start', label: '🎮 开始新局', style: 'primary' },
+      { id: 'help', label: '📖 玩法说明' },
+    ],
+    runAction: async (actionId, ctx) => {
+      const services = getServices();
+      if (!services) return '21 点需要启用 database 配置。';
+      if (actionId === 'help') return BJ_HELP;
+      return runBjCommand(plugin, services, ctx.message, actionId === 'start' ? '开始' : actionId);
+    },
+  });
+}