Files
Dune/tests/richese-gift-engine.test.ts
T
2026-09-08 07:37:52 +10:00

90 lines
5.0 KiB
TypeScript

import test from 'node:test';
import assert from 'node:assert/strict';
import {applyAction, createGame, newPlayer, viewGame, type Game} from '../game/engine';
import {baseDeck} from '../game/cards';
import {richeseCards} from '../game/richese-cards';
function fixture(advanced = false, phase = 3) {
const g = createGame('GIFTENGINE', newPlayer('r', 'Richese', 'richese'), advanced, ['choam']);
g.players.push(newPlayer('a', 'Ally', 'atreides'), newPlayer('o', 'Observer', 'emperor'));
g.status = 'playing'; g.turn = 2; g.phase = phase; g.active = 'a'; g.order = ['r', 'a', 'o'];
g.players[0].ally = 'a'; g.players[1].ally = 'r';
g.deck = baseDeck(); g.richeseCache = richeseCards();
for (const p of g.players) {p.hand = []; p.spice = 10; p.forces = {};}
return g;
}
function take(g: Game, cardId: string) {
const card = g.richeseCache!.find(c => c.id === cardId)!;
assert.ok(card); g.richeseCache = g.richeseCache!.filter(c => c.id !== cardId);
g.players[0].hand.push(card); return card;
}
function counter(g: Game) {
const index = g.deck.findIndex(c => c.effect === 'karama');
const card = g.deck.splice(index, 1)[0]; g.players[2].hand.push(card); return card;
}
function gift(g: Game, cardId: string) {return applyAction(g, 'r', {type: 'richeseGift', card: cardId});}
const reload = (g: Game): Game => JSON.parse(JSON.stringify(g));
void test('every canonical Richese card transfers once in Basic and Advanced across all nine phases without acquisition effects', () => {
for (const advanced of [false, true]) for (let phase = 0; phase < 9; phase++) for (const card of richeseCards()) {
const g = fixture(advanced, phase); take(g, card.id);
const before = structuredClone(g), next = gift(g, card.id);
assert.deepEqual(g, before);
assert.deepEqual(next.players[0].hand, []);
assert.deepEqual(next.players[1].hand, [card]);
assert.deepEqual(next.deck, g.deck); assert.deepEqual(next.discard, g.discard);
assert.deepEqual(next.richeseCache, g.richeseCache);
assert.deepEqual(next.players.map(p => p.spice), [10, 10, 10]);
assert.equal(next.phase, phase); assert.equal(next.turn, 2);
assert.equal(next.pendingRicheseGift, null);
assert.throws(() => gift(next, card.id));
}
});
void test('pending exact gift is private to its two participants, never leaks card identity in public history, and restores ready flags', () => {
const g = fixture(); const card = take(g, 'richese-distrans'); counter(g);
g.players[0].ready = true; g.players[2].ready = true;
const pending = gift(g, card.id);
assert.equal(pending.response?.kind, 'richeseGift');
for (const id of ['r', 'a']) assert.equal(viewGame(pending, id).richeseGift?.pending?.card?.id, card.id);
assert.equal(viewGame(pending, 'o').richeseGift, null);
assert.equal(JSON.stringify(viewGame(pending, 'o')).includes(card.id), false);
const next = applyAction(reload(pending), 'o', {type: 'passResponse'});
assert.deepEqual(next.players.map(p => p.ready), [true, false, true]);
assert.equal(next.log.some(entry => entry.text.includes(card.name) || entry.text.includes(card.id)), false);
assert.deepEqual(next.players[1].hand, [card]);
});
void test('cancellation retains the exact card and parent decision; same-phase retry remains an explicit unresolved guard', () => {
const g = fixture(); const card = take(g, 'richese-karama'), k = counter(g);
const parent = {kind: 'richeseDeclaration' as const, player: 'r'};
g.decision = parent;
const pending = gift(g, card.id);
assert.equal(pending.decision, null);
const next = applyAction(reload(pending), 'o', {type: 'card', mode: 'cancel', card: k.id});
assert.deepEqual(next.decision, parent); assert.deepEqual(next.players[0].hand, [card]);
assert.deepEqual(next.players[1].hand, []);
assert.throws(() => gift(next, card.id), /awaits a ruling/);
next.phase = 4; next.decision = null;
assert.deepEqual(gift(next, card.id).players[1].hand, [card]);
});
void test('capacity changed during recovery aborts without consuming, discarding or replacing any hand card', () => {
const g = fixture(); const card = take(g, 'richese-karama'); counter(g);
const pending = gift(g, card.id);
pending.players[1].hand = pending.deck.splice(0, 4);
const before = pending.players.map(p => p.hand);
const next = applyAction(reload(pending), 'o', {type: 'passResponse'});
assert.deepEqual(next.players.map(p => p.hand), before);
assert.equal(next.pendingRicheseGift, null);
assert.match(next.log.at(-1)!.text, /became unavailable/);
});
void test('only exact canonical cards held by Richese can be gifted to a mutual ally; all rejected inputs remain unchanged', () => {
for (const mutate of [
(g: Game) => {g.players[0].hand[0].name = 'Forged identity';},
(g: Game) => {g.players[1].ally = null;},
(g: Game) => {g.players[0].hand = [];},
(g: Game) => {g.players[0].faction = 'choam';},
]) {
const g = fixture(); take(g, 'richese-karama'); mutate(g); const before = structuredClone(g);
assert.throws(() => gift(g, 'richese-karama')); assert.deepEqual(g, before);
}
});