import assert from 'node:assert/strict'; import test from 'node:test'; import type { DatabaseSync, SQLOutputValue } from 'node:sqlite'; import { applyAction, normalizeAutomaticGame, viewGame, type Action, type Game, type GameView } from '../game/engine'; import { botActions } from '../game/bots'; import { homeworldContext, homeworldGameIntegrity } from '../game/homeworld-game'; import { homeworldForceGroups } from '../game/homeworld-custody'; import { NEXUS_FACTIONS, replaceNexusCard, drawNexusCard, validateNexusCards } from '../game/nexus-cards'; import { guildBetrayalResponders, signGuildBetrayalInvoice } from '../game/nexus-guild-betrayal'; import { guildShipmentIncome } from '../game/shipment-price'; import type { RoomsClock, SeatAuth } from '../db/rooms'; import type * as Rooms from '../db/rooms'; import type { FactionId } from '../game/catalog'; import { unitStore } from './fixture-nexus-room-store'; import { createGuildBetrayalFixture, type GuildBetrayalFixture, type GuildBetrayalFixtureOptions } from './fixture-nexus-guild-betrayal'; const clock: RoomsClock = { now: () => 10000, sleep: async () => {} }; const plain = (value: T): T => JSON.parse(JSON.stringify(value)); type SqlRow = Record; const use = (event: string): Action => ({ type: 'guildBetrayalUse', event }); const pass = (event: string): Action => ({ type: 'guildBetrayalPass', event }); const forged = (payload: object): Action => payload as Action; const sum = (counts: Record) => Object.values(counts).reduce((a, b) => a + b, 0); function player(g: Game, id: string) { const found = g.players.find(p => p.id === id); assert.ok(found, `missing authenticated seat ${id}`); return found; } function credentials(sqlite: DatabaseSync) { return { seats: sqlite.prepare('SELECT * FROM seats ORDER BY room_code,player_id,token_hash').all(), entries: sqlite.prepare('SELECT * FROM room_entry_receipts ORDER BY room_code,player_id,operation_hash').all(), keys: sqlite.prepare('SELECT * FROM seat_recovery_keys ORDER BY room_code,player_id').all(), recoveries: sqlite.prepare('SELECT * FROM seat_recovery_receipts ORDER BY room_code,player_id,operation_hash').all(), }; } function physical(g: Game) { const ids = [...g.deck, ...g.discard, ...g.players.flatMap(p => p.hand), ...(g.auction?.cards.slice(g.auction.index) ?? [])].map(card => card.id).sort(); assert.equal(new Set(ids).size, ids.length, 'every physical Treachery card has one custodian'); return ids; } function forceInventory(g: Game) { homeworldGameIntegrity(g); const homes = g.homeworlds?.custody ? homeworldForceGroups(homeworldContext(g), g.homeworlds.custody) : []; return g.players.map(p => { const visitors = homes.filter(home => home.native !== p.id) .map(home => home.forces[p.id] ?? { normal: 0, elite: 0 }); return { id: p.id, total: p.reserves + p.tanks + sum(p.forces) + visitors.reduce((n, pool) => n + pool.normal + pool.elite, 0), elite: p.elites ? p.elites.reserves + p.elites.tanks + sum(p.elites.forces) + visitors.reduce((n, pool) => n + pool.elite, 0) : 0, }; }); } function delivery(g: Game) { return { players: g.players.map(p => ({ id: p.id, reserves: p.reserves, tanks: p.tanks, forces: p.forces, elites: p.elites ?? null, advisors: p.advisors ?? null, shipped: p.shipped, moved: p.moved })), custody: g.homeworlds?.custody ?? null, }; } interface Fixture extends GuildBetrayalFixture { sqlite: DatabaseSync; restart(): typeof Rooms; hooks: { beforeWrite?: () => Promise }; writes: { expected: number; changes: number }[]; code: string; initial: Game; tokens: string[]; auths: SeatAuth[]; stock: string[]; forceStock: { id: string; total: number; elite: number }[]; credentialRows: { seats: SqlRow[]; entries: SqlRow[]; keys: SqlRow[]; recoveries: SqlRow[] }; unrelatedCode: string; unrelatedToken: string; unrelatedRow: SqlRow | undefined; save(this: void, g: Game): void; } async function fixture(t: test.TestContext, options: GuildBetrayalFixtureOptions = {}): Promise { const store = unitStore(); t.after(() => store.sqlite.close()); const made = await store.rooms.createRoom('Guild Betrayal SQL', 'atreides', options.advanced ?? false, []); const code = made.view.code; const tokens = [made.token]; const factions: FactionId[] = ['guild', options.zero ? 'fremen' : 'emperor', ...(options.allyPayment ? ['harkonnen' as const] : [])]; for (const faction of factions) tokens.push((await store.rooms.joinRoom(code, faction, faction)).token!); const auths = await Promise.all(tokens.map(token => store.rooms.authenticate(code, token))); const madeGame = createGuildBetrayalFixture({ ...options, seatIds: auths.map(auth => auth.playerId) }); const initial = madeGame.game; initial.code = code; initial.host = auths[0].playerId; initial.version = (await store.rooms.readRoom(code)).version; const save = (g: Game) => { assert.equal(store.sqlite.prepare('UPDATE rooms SET state = ?, version = ? WHERE code = ?') .run(JSON.stringify(g), g.version, code).changes, 1); }; save(initial); const unrelated = await store.rooms.createRoom('Unrelated preserved room', 'harkonnen', false, []); const unrelatedRow = store.sqlite.prepare('SELECT * FROM rooms WHERE code = ?').get(unrelated.view.code); const credentialRows = credentials(store.sqlite); const stock = physical(initial); const forceStock = forceInventory(initial); return { ...store, ...madeGame, code, initial, tokens, auths, save, stock, forceStock, credentialRows, unrelatedCode: unrelated.view.code, unrelatedToken: unrelated.token, unrelatedRow }; } const row = (f: Fixture) => f.sqlite.prepare('SELECT * FROM rooms WHERE code = ?').get(f.code); function totalChanges(f: Fixture) { const changes = f.sqlite.prepare('SELECT total_changes() AS changes').get()?.changes; assert.ok(typeof changes === 'number'); return changes; } function protectedRows(f: Fixture) { assert.deepEqual(credentials(f.sqlite), f.credentialRows, 'saved authorization hashes and recovery records stay unchanged'); assert.deepEqual(f.sqlite.prepare('SELECT * FROM rooms WHERE code = ?').get(f.unrelatedCode), f.unrelatedRow); } function inventory(f: Fixture, g: Game) { assert.deepEqual(physical(g), f.stock); assert.deepEqual(forceInventory(g), f.forceStock, 'normal and elite physical force inventory is conserved'); const cards = g.nexusCards?.cards; assert.ok(cards); validateNexusCards(cards, g.players); assert.deepEqual([...cards.deck, ...cards.discard, ...Object.values(cards.hands).filter(card => card !== null)].sort(), [...NEXUS_FACTIONS].sort(), 'one singleton of every Nexus face stays in custody'); protectedRows(f); } async function authenticate(f: Fixture, id: string) { const index = f.auths.findIndex(auth => auth.playerId === id); assert.ok(index >= 0); const auth = await f.restart().authenticate(f.code, f.tokens[index]); assert.equal(auth.playerId, id); assert.equal(auth.tokenHash, f.auths[index].tokenHash); return auth; } async function act(f: Fixture, g: Game, id: string, action: Action) { await f.restart().act(f.code, await authenticate(f, id), g.version, action, clock); return f.restart().readRoom(f.code); } async function restored(f: Fixture, g: Game) { const before = row(f), changes = totalChanges(f); assert.deepEqual(plain(await f.restart().readRoom(f.code)), plain(g)); assert.deepEqual(plain(normalizeAutomaticGame(g)), plain(g), 'normalization cannot answer a human fee choice'); const views: GameView[] = []; for (const auth of f.auths) { const view = await f.restart().readSeatView(f.code, await authenticate(f, auth.playerId)); assert.deepEqual(plain(view), plain(viewGame(g, auth.playerId))); for (const key of ['pendingGuildBetrayal', 'guildBetrayal', 'nexusGuildBetrayalHistory', 'guildBetrayalSourceReceipts']) assert.equal(Object.hasOwn(view, key), false, 'source, invoice and durable receipt remain private'); for (const rival of view.players.filter(p => p.id !== auth.playerId)) { for (const key of ['hand', 'traitors', 'spice']) assert.equal(Object.hasOwn(rival, key), false); } const reaction = view.guildBetrayalReaction; if (reaction) { assert.deepEqual(Object.keys(reaction).sort(), ['event', 'shipper', 'canPass', 'hasPassed', 'canUse', 'blocked'].sort()); const first = views[0]?.guildBetrayalReaction; if (first) assert.deepEqual({ event: reaction.event, shipper: reaction.shipper }, { event: first.event, shipper: first.shipper }); assert.ok(g.players.some(p => p.id === reaction.shipper)); assert.equal(reaction.canUse, auth.playerId === f.holder && g.nexusCards!.cards!.hands[f.holder] === 'guild' && !reaction.hasPassed); if (auth.playerId !== f.holder) assert.equal(reaction.blocked, null); } views.push(view); } await Promise.all([f.restart().continueRoomAutomatic(f.code, clock), f.restart().continueRoomAutomatic(f.code, clock)]); assert.deepEqual(row(f), before, 'refresh/restart cannot consume or settle a held human opportunity'); assert.equal(totalChanges(f), changes, 'refresh/restart does not write any durable table'); inventory(f, g); return views; } async function rejected( f: Fixture, g: Game, auth: SeatAuth, action: Action, version = g.version, expected?: RegExp | { message: string }, ) { const before = row(f), changes = totalChanges(f), state = plain(g); const attempt = f.restart().act(f.code, auth, version, action, clock); if (expected) await assert.rejects(attempt, expected); else await assert.rejects(attempt); assert.equal(totalChanges(f), changes, 'denied mutations cannot change any durable table, including a zero-row credential CAS'); assert.deepEqual(row(f), before, 'saved room state, version and timestamps stay unchanged'); assert.deepEqual(plain(g), state, 'rejected mutation does not alter the supplied source state'); protectedRows(f); } async function passOthers(f: Fixture, g: Game) { for (const p of g.players) { if (p.id === f.holder) continue; const reaction = viewGame(g, p.id).guildBetrayalReaction; if (reaction?.canPass) g = await act(f, g, p.id, pass(reaction.event)); } assert.equal(viewGame(g, f.holder).guildBetrayalReaction?.canPass, true); return g; } async function settleNativeResponses(f: Fixture, g: Game) { const originalDelivery = structuredClone(delivery(g)); for (let step = 0; g.response && step < 16; step++) { const response = g.response; const responder = g.players.find(p => !response.passed.includes(p.id)); assert.ok(responder); g = await act(f, g, responder.id, { type: 'passResponse' }); assert.deepEqual(delivery(g), originalDelivery, 'native income allowance does not replay already delivered forces'); await restored(f, g); } assert.equal(g.response, null, 'all original native response suffixes finish'); return g; } async function allPass(f: Fixture, g: Game) { g = await passOthers(f, g); await restored(f, g); return settleNativeResponses(f, await act(f, g, f.holder, pass(f.event))); } function diverted(f: Fixture, g: Game, allyPayment = 0) { assert.ok(f.price > 0, 'only an already-funded positive fee can be taken'); for (const p of g.players) { const debit = p.id === f.shipper ? f.price - allyPayment : 0; const credit = p.id === f.holder ? f.price : 0; assert.equal(p.spice, player(f.initial, p.id).spice - debit + credit, 'replace the full original receiver, without a second payer or native-income credit'); } if (allyPayment) { const donor = f.donor; assert.ok(donor, 'the split quote retains its authorized donor'); assert.equal(player(g, donor).spice, player(f.initial, donor).spice, 'pledged escrow is not withdrawn twice'); assert.equal(g.aid[donor].amount, f.initial.aid[donor].amount - allyPayment); } const budget = (state: Game) => state.players.reduce((total, p) => total + p.spice, 0) + Object.values(state.aid).reduce((total, aid) => total + aid.amount, 0); assert.equal(budget(g), budget(f.initial), 'full bank/default recipient replacement conserves paid spice plus escrow'); assert.deepEqual(delivery(g), delivery(f.original), 'the exact original cohort is delivered once with native turn flags'); assert.equal(g.nexusCards!.cards!.hands[f.holder], null); assert.equal(g.nexusCards!.cards!.discard.filter(card => card === 'guild').length, 1); assert.equal(g.nexusGuildBetrayalHistory!.length, 1); assert.equal(g.nexusGuildBetrayalHistory![0].recipient, f.holder); assert.equal(g.guildBetrayalSourceReceipts!.length, 1); assert.equal(g.guildBetrayal!.status, 'completed'); assert.equal(viewGame(g, f.holder).guildBetrayalReaction, null); inventory(f, g); } for (const advanced of [false, true]) { for (const scenario of [ { source: 'reserve', payer: 'holder' }, { source: 'reserve', payer: 'other' }, { source: 'reserve', payer: 'guild', allyPayment: 1 }, { source: 'guildTransport', payer: 'guild' }, { source: 'guildTransport', payer: 'guild', homeworlds: true }, { source: 'homeworld', payer: 'holder', homeworlds: true }, { source: 'homeworld', payer: 'other', homeworlds: true, allyPayment: 1 }, { source: 'junction', payer: 'other', homeworlds: true }, { source: 'reserve', payer: 'other', homeworlds: true, occupiedJunction: true }, ] as const) { void test(`SQLite ${advanced ? 'Advanced' : 'Basic'} ${scenario.source} ${scenario.payer}${'homeworlds' in scenario ? ' Homeworld' : ''} funded full fee replacement${'occupiedJunction' in scenario ? ' overrides occupied Junction' : ''} survives authenticated restart`, async t => { const f = await fixture(t, { ...scenario, advanced }); await restored(f, f.initial); const done = await act(f, f.initial, f.holder, use(f.event)); assert.equal(done.version, f.initial.version + 1); diverted(f, done, 'allyPayment' in scenario ? scenario.allyPayment : 0); if ('occupiedJunction' in scenario) { assert.equal(f.initial.homeworlds!.custody!.visitors['homeworld:guild'][f.holder].normal, 1); const nativeIncome = player(f.original, f.guild).spice - player(f.initial, f.guild).spice; assert.ok(nativeIncome > 0 && nativeIncome < f.price, 'the genuine low-Junction native quote only receives part of this fee'); assert.equal(player(f.original, f.holder).spice, player(f.initial, f.holder).spice); assert.equal(player(done, f.guild).spice, player(f.initial, f.guild).spice, 'Betrayal suppresses native low-Junction income'); assert.equal(done.response?.kind === 'guildIncome', false, 'no second income allowance survives the replacement'); } await restored(f, done); const auth = await authenticate(f, f.holder); for (const action of [use(f.event), pass(f.event)]) await rejected(f, done, auth, action); }); } } for (const source of ['reserve', 'guildTransport', 'homeworld', 'junction'] as const) { void test(`SQLite restored ${source} all-pass retains the Nexus and commits the original native payment and custody once`, async t => { const f = await fixture(t, { source, payer: source === 'guildTransport' ? 'guild' : 'other', homeworlds: source === 'homeworld' || source === 'junction' }); await restored(f, f.initial); const done = await allPass(f, f.initial); assert.deepEqual(done.players.map(p => [p.id, p.spice]), f.original.players.map(p => [p.id, p.spice])); assert.deepEqual(done.aid, f.original.aid); assert.deepEqual(delivery(done), delivery(f.original)); assert.equal(done.nexusCards!.cards!.hands[f.holder], 'guild'); assert.equal(done.nexusCards!.cards!.discard.includes('guild'), false); assert.equal(viewGame(done, f.holder).guildBetrayalReaction, null); assert.equal(done.nexusGuildBetrayalHistory!.length, 1); assert.equal(done.nexusGuildBetrayalHistory![0].recipient, null); assert.equal(done.guildBetrayalSourceReceipts!.length, 1); assert.equal(done.guildBetrayal!.status, 'completed'); await restored(f, done); await rejected(f, done, await authenticate(f, f.holder), pass(f.event)); }); } for (const source of ['reserve', 'guildTransport', 'homeworld', 'junction'] as const) { void test(`SQLite simultaneous ${source} Use/final Pass commits one fee and one physical delivery through CAS`, async t => { const f = await fixture(t, { source, payer: source === 'guildTransport' ? 'guild' : 'other', homeworlds: source === 'homeworld' || source === 'junction' }); const pending = await passOthers(f, f.initial); await restored(f, pending); f.writes.length = 0; let arrivals = 0; let release!: () => void; const gate = new Promise(resolve => { release = resolve; }); f.hooks.beforeWrite = async () => { if (++arrivals === 2) release(); await gate; }; let results: PromiseSettledResult[]; try { const auth = await authenticate(f, f.holder); results = await Promise.allSettled([use(f.event), pass(f.event)].map(action => f.restart().act(f.code, auth, pending.version, action, clock).finally(release))); } finally { delete f.hooks.beforeWrite; } assert.equal(arrivals, 2, 'both authenticated mutations reached the actual SQL version fence'); assert.equal(results.filter(result => result.status === 'fulfilled').length, 1); assert.equal(results.filter(result => result.status === 'rejected').length, 1); assert.deepEqual(f.writes.map(write => write.changes).sort((a, b) => a - b), [0, 1]); let done = await f.restart().readRoom(f.code); assert.equal(done.version, pending.version + 1); if (results[0].status === 'fulfilled') diverted(f, done); else { done = await settleNativeResponses(f, done); assert.deepEqual(done.players.map(p => [p.id, p.spice]), f.original.players.map(p => [p.id, p.spice])); assert.deepEqual(delivery(done), delivery(f.original)); assert.equal(done.nexusCards!.cards!.hands[f.holder], 'guild'); } await restored(f, done); }); } void test('SQLite credential reauthentication rejects stale, foreign, unsupported and client-owned fee choices without a write', async t => { const f = await fixture(t); const holder = await authenticate(f, f.holder); const foreign = await f.restart().authenticate(f.unrelatedCode, f.unrelatedToken); const before = row(f), changes = totalChanges(f); await assert.rejects(f.restart().authenticate(f.code, f.unrelatedToken)); await assert.rejects(f.restart().readSeatView(f.code, foreign)); await assert.rejects(f.restart().readSeatView(f.code, { playerId: f.holder, tokenHash: foreign.tokenHash })); assert.equal(totalChanges(f), changes, 'denied authentication and private reads write no durable table'); assert.deepEqual(row(f), before); protectedRows(f); await rejected(f, f.initial, foreign, use(f.event)); await rejected(f, f.initial, { playerId: f.holder, tokenHash: foreign.tokenHash }, use(f.event)); await rejected(f, f.initial, holder, use(f.event), f.initial.version - 1); await rejected(f, f.initial, await authenticate(f, f.guild), use(f.event)); for (const action of [ use(`${f.event}:foreign`), pass(`${f.event}:foreign`), forged({ ...use(f.event), amount: f.price }), forged({ ...use(f.event), recipient: f.holder }), forged({ ...use(f.event), price: 0 }), forged({ ...use(f.event), source: f.source }), forged({ ...pass(f.event), card: 'guild' }), forged({ ...pass(f.event), ignored: true }), { type: 'pledgeAid', amount: 1 } as Action, f.declaration, ]) await rejected(f, f.initial, holder, action); const pending = await passOthers(f, f.initial); if (pending.version !== f.initial.version) await rejected(f, pending, holder, use(f.event), f.initial.version); for (const p of pending.players) { const reaction = viewGame(pending, p.id).guildBetrayalReaction; if (reaction?.hasPassed) await rejected(f, pending, await authenticate(f, p.id), pass(f.event)); } await restored(f, pending); }); void test('SQLite public fee acknowledgement does not identify the held Nexus face or reveal source, route or cost', async t => { const f = await fixture(t, { source: 'homeworld', payer: 'other', homeworlds: true }); const originalViews = await restored(f, f.initial); const before = structuredClone(f.before); before.code = f.code; before.host = f.initial.host; before.version = f.initial.version; const cards = before.nexusCards!.cards!; const index = cards.deck.indexOf('choam'); assert.ok(index >= 0); assert.equal(cards.hands[f.holder], 'guild'); cards.deck[index] = 'guild'; cards.hands[f.holder] = 'choam'; validateNexusCards(cards, before.players); // Change only the private face in the same funded source, not another // randomly played setup with a different payer balance or force history. let alternative = applyAction(before, f.shipper, f.declaration); for (let step = 0; !alternative.pendingGuildBetrayal && step < 20; step++) { const decision = alternative.decision; assert.ok(decision && ['guildShipment', 'homeworldShipmentGuild'].includes(decision.kind)); alternative = applyAction(alternative, decision.player, { type: 'decision', allow: true, ...(decision.kind === 'homeworldShipmentGuild' ? { event: decision.event } : {}), }); } assert.ok(alternative.pendingGuildBetrayal); f.save(alternative); const changedViews = await restored(f, alternative); for (const [index, auth] of f.auths.entries()) { const original = originalViews[index].guildBetrayalReaction; const changed = changedViews[index].guildBetrayalReaction; assert.ok(original); assert.ok(changed); assert.equal(changed.event, original.event, 'the event is selected from the public producer, not the private face'); assert.equal(changed.shipper, original.shipper); assert.equal(changed.canPass, original.canPass); assert.equal(changed.hasPassed, original.hasPassed); assert.equal(changed.canUse, false); if (auth.playerId !== f.holder) assert.deepEqual(plain(changed), plain(original)); } await rejected(f, alternative, await authenticate(f, f.holder), use(f.event)); const done = await allPass(f, alternative); assert.deepEqual(delivery(done), delivery(f.original)); assert.deepEqual(done.players.map(p => [p.id, p.spice]), f.original.players.map(p => [p.id, p.spice])); assert.equal(done.nexusCards!.cards!.hands[f.holder], 'choam'); await restored(f, done); }); for (const advanced of [false, true]) { void test(`SQLite ${advanced ? 'Advanced' : 'Basic'} a re-signed paid cross-planet source cannot replace the native Guild grant`, async t => { const f = await fixture(t, { advanced, source: 'guildTransport', payer: 'other' }); assert.notEqual(f.shipper, f.guild); assert.equal(player(f.initial, f.shipper).ally, f.guild); assert.equal(player(f.initial, f.guild).ally, f.shipper); await restored(f, f.initial); const corrupt = structuredClone(f.initial); player(corrupt, f.shipper).ally = null; player(corrupt, f.guild).ally = null; const pending = corrupt.pendingGuildBetrayal; assert.ok(pending?.continuation.source === 'guildTransport'); assert.ok(pending.invoice.price > 0); assert.equal(pending.continuation.fromReserves, false); assert.notEqual(pending.continuation.frame.to, 'reserves'); assert.deepEqual(pending.continuation, f.initial.pendingGuildBetrayal!.continuation, 'the physically available paid native group, route and tariff are unchanged'); assert.deepEqual(guildBetrayalResponders(corrupt.nexusCards!.cards!, corrupt.players), pending.required); // Amend the saved consistency proof itself, rather than leaving a stale // signature that would reject even without an independent native grant. // No private validator or reconstruction of its source quote is involved. const proof: { players: { id: string; ally: string | null }[] } = JSON.parse(pending.invoice.sourceSignature); for (const seat of proof.players) seat.ally = player(corrupt, seat.id).ally; pending.invoice.sourceSignature = JSON.stringify(proof); const native = pending.continuation.frame; pending.invoice.originalReceiver = guildShipmentIncome({ guild: f.guild, shipper: f.shipper, ally: player(corrupt, f.shipper).ally, cost: native.cost, allyPayment: native.allyPayment, bankOnly: corrupt.karamaShipping?.player === f.shipper, }) > 0 ? f.guild : null; pending.invoice.signature = signGuildBetrayalInvoice(pending.invoice); corrupt.guildBetrayal!.sourceSignature = pending.invoice.sourceSignature; const binding: unknown[] = JSON.parse(pending.signature); binding[0] = pending.invoice.signature; binding[1] = pending.invoice.sourceSignature; pending.signature = JSON.stringify(binding); f.save(corrupt); const before = row(f), changes = totalChanges(f), state = plain(corrupt); const denied = { message: 'Native Guild transport requires the Guild or its reciprocal ally.' }; assert.deepEqual(plain(await f.restart().readRoom(f.code)), state, 'raw restore preserves the damaged source for diagnosis'); assert.throws(() => normalizeAutomaticGame(corrupt), denied); for (const auth of f.auths) await assert.rejects(f.restart().readSeatView(f.code, await authenticate(f, auth.playerId)), denied); for (const action of [pass(f.event), use(f.event)]) await rejected(f, corrupt, await authenticate(f, f.holder), action, corrupt.version, denied); await Promise.allSettled([f.restart().continueRoomAutomatic(f.code, clock)]); assert.equal(totalChanges(f), changes, 'failed read, normalization and authenticated settlement write no durable table'); assert.deepEqual(row(f), before); const saved = await f.restart().readRoom(f.code); assert.deepEqual(plain(saved), state, 'fee, forces, held cards, escrow, histories and room version remain untouched'); assert.deepEqual(plain(corrupt), state); inventory(f, saved); }); } for (const source of ['reserve', 'guildTransport', 'homeworld', 'junction'] as const) { void test(`SQLite malformed or detached ${source} invoice/source rejects all-seat disclosure, normalization and settlement without writes`, async t => { const f = await fixture(t, { source, payer: source === 'guildTransport' ? 'guild' : 'other', homeworlds: source === 'homeworld' || source === 'junction' }); const mutations: { name: string; change(this: void, g: Game): void }[] = [ { name: 'deleted continuation with pending cursor', change: g => { delete g.pendingGuildBetrayal; } }, { name: 'deleted cursor with orphan invoice', change: g => { delete g.guildBetrayal; } }, { name: 'deleted native source receipt collection', change: g => { delete g.guildBetrayalSourceReceipts; } }, { name: 'deleted independent receipt history', change: g => { delete g.nexusGuildBetrayalHistory; } }, { name: 'detached event', change: g => { g.guildBetrayal!.event = null; } }, { name: 'lost pending sequence', change: g => { g.guildBetrayal!.sequence = 0; } }, { name: 'false completion', change: g => { g.guildBetrayal!.status = 'completed'; } }, { name: 'changed charged price', change: g => { g.pendingGuildBetrayal!.invoice.price++; } }, { name: 'changed payer split', change: g => { g.pendingGuildBetrayal!.invoice.ownPayment++; } }, { name: 'foreign payer', change: g => { g.pendingGuildBetrayal!.invoice.shipper = f.holder; } }, { name: 'changed original receiver', change: g => { g.pendingGuildBetrayal!.invoice.originalReceiver = f.shipper; } }, { name: 'changed source signature', change: g => { g.pendingGuildBetrayal!.invoice.sourceSignature += ':forged'; } }, { name: 'changed producer parent', change: g => { g.pendingGuildBetrayal!.signature += ':forged'; } }, { name: 'extra invoice key', change: g => { Object.assign(g.pendingGuildBetrayal!.invoice, { recipient: f.holder }); } }, { name: 'extra continuation key', change: g => { Object.assign(g.pendingGuildBetrayal!.continuation, { action: f.declaration }); } }, { name: 'foreign acknowledgement', change: g => { g.pendingGuildBetrayal!.required.push(f.guild); } }, { name: 'fabricated saved pass', change: g => { g.pendingGuildBetrayal!.passed.push(f.holder); } }, { name: 'missing original upfront funding', change: g => { player(g, f.shipper).spice = 0; } }, { name: 'source custody moved without delivery', change: g => { const p = player(g, f.shipper); if (source === 'guildTransport') { const location = Object.keys(p.forces).find(key => p.forces[key] > 0); assert.ok(location); p.forces[location]--; p.tanks++; } else { assert.ok(p.reserves > 0); p.reserves--; p.tanks++; } } }, { name: 'changed native quoted route', change: g => { const continuation = g.pendingGuildBetrayal!.continuation; switch (continuation.source) { case 'reserve': continuation.shipment.amount++; break; case 'guildTransport': continuation.frame.amount++; break; case 'homeworld': continuation.shipment.amount++; break; case 'junction': continuation.transport.destination += ':foreign'; break; } } }, ]; for (const { name, change } of mutations) { const corrupt = structuredClone(f.initial); change(corrupt); f.save(corrupt); const before = row(f), changes = totalChanges(f); const stock = physical(corrupt); assert.deepEqual(plain(await f.restart().readRoom(f.code)), plain(corrupt), 'raw read does not rewrite a damaged save'); assert.throws(() => normalizeAutomaticGame(corrupt), name); for (const auth of f.auths) await assert.rejects(f.restart().readSeatView(f.code, await authenticate(f, auth.playerId)), name); for (const action of [pass(f.event), use(f.event)]) await rejected(f, corrupt, await authenticate(f, f.holder), action); await Promise.allSettled([f.restart().continueRoomAutomatic(f.code, clock)]); assert.deepEqual(row(f), before, name); assert.equal(totalChanges(f), changes, name); const saved = await f.restart().readRoom(f.code); assert.deepEqual(physical(saved), stock, name); assert.deepEqual(saved.players.map(p => [p.id, p.reserves, p.forces, p.tanks]), corrupt.players.map(p => [p.id, p.reserves, p.forces, p.tanks]), name); protectedRows(f); } }); } void test('SQLite own-payment refund requires already available original funds and cannot bootstrap its upfront debit', async t => { const f = await fixture(t, { payer: 'holder' }); assert.equal(f.shipper, f.holder); assert.ok(player(f.initial, f.holder).spice >= f.price); const corrupt = structuredClone(f.initial); player(corrupt, f.holder).spice = f.price - 1; f.save(corrupt); const before = row(f), changes = totalChanges(f); await rejected(f, corrupt, await authenticate(f, f.holder), use(f.event)); for (const auth of f.auths) await assert.rejects(f.restart().readSeatView(f.code, await authenticate(f, auth.playerId))); assert.deepEqual(row(f), before); assert.equal(totalChanges(f), changes, 'failed upfront funding cannot write any durable table'); protectedRows(f); }); void test('SQLite altered authorized aid escrow cannot charge its donor again or settle an unfunded original invoice', async t => { const f = await fixture(t, { payer: 'guild', allyPayment: 1 }); const donor = f.donor; assert.ok(donor); const mutations: { name: string; change(this: void, g: Game): void }[] = [ { name: 'deleted escrow', change: g => { delete g.aid[donor]; } }, { name: 'empty escrow', change: g => { g.aid[donor].amount = 0; } }, { name: 'foreign donor', change: g => { g.pendingGuildBetrayal!.invoice.donor = f.holder; } }, { name: 'lost authorization', change: g => { player(g, f.shipper).ally = null; } }, ]; for (const { name, change } of mutations) { const corrupt = structuredClone(f.initial); change(corrupt); f.save(corrupt); const before = row(f), changes = totalChanges(f); await rejected(f, corrupt, await authenticate(f, f.holder), use(f.event)); assert.deepEqual(row(f), before, name); assert.equal(totalChanges(f), changes, name); const saved = await f.restart().readRoom(f.code); assert.equal(player(saved, donor).spice, player(corrupt, donor).spice, name); protectedRows(f); } }); void test('SQLite independent completed receipt survives a later actual shipment and conserved Nexus recycling, but cannot be deleted or detached', async t => { const f = await fixture(t, { advanced: false, payer: 'holder' }); let done = await act(f, f.initial, f.holder, use(f.event)); diverted(f, done); await restored(f, done); const firstReceipt = structuredClone(done.nexusGuildBetrayalHistory![0]); const firstSource = structuredClone(done.guildBetrayalSourceReceipts![0]); // Exercise the physical component's real draw/replacement lifecycle, not a // fabricated card or amended invoice. Earlier receipts must not retain a // permanent claim to the present discard position or held face. const recycled = structuredClone(done); assert.ok(recycled.nexusCards?.cards); recycled.nexusCards.cards = drawNexusCard(recycled.nexusCards.cards, f.holder, recycled.players, () => 0); for (let step = 0; step < 48 && recycled.nexusCards.cards.hands[f.holder] !== 'guild'; step++) recycled.nexusCards.cards = replaceNexusCard(recycled.nexusCards.cards, f.holder, recycled.players, () => 0); assert.equal(recycled.nexusCards.cards.hands[f.holder], 'guild'); assert.equal(recycled.nexusCards.cards.discard.includes('guild'), false); f.save(recycled); await restored(f, recycled); await rejected(f, recycled, await authenticate(f, f.holder), use(f.event)); done = await act(f, recycled, f.holder, { type: 'endMovement' }); for (let step = 0; step < 500; step++) { const actor = done.active ? player(done, done.active) : null; const cleanMovement = done.phase === 5 && !done.phaseOpening && !done.response && !done.decision; if (cleanMovement && actor && actor.id !== f.holder && !actor.shipped && actor.reserves > 0 && actor.spice >= 2) break; if (cleanMovement && actor) { done = await act(f, done, actor.id, { type: 'endMovement' }); continue; } let request: { id: string; action: Action } | null = null; for (const p of done.players) { const view = viewGame(done, p.id); const own = view.players.find(seat => seat.id === p.id); assert.ok(own); own.bot = 'Easy'; let action = botActions(view)[0]; if (p.id === f.holder && action?.type === 'nexusCardChoice' && view.nexusCards?.choices.includes('keep')) action = { type: 'nexusCardChoice', turn: view.turn, card: view.nexusCards.card, choice: 'keep', ownRedraws: 0 }; if (action) { request = { id: p.id, action }; break; } } assert.ok(request, 'genuine intervening phases retain a legal authenticated continuation'); done = await act(f, done, request.id, request.action); } assert.equal(done.phase, 5); assert.ok(!done.phaseOpening && !done.response && !done.decision, 'the later producer starts only after genuine intervening opportunities finish'); const laterShipper = done.active; assert.ok(laterShipper, 'the next real movement turn retains its seated actor'); assert.notEqual(laterShipper, f.holder); assert.equal(player(done, laterShipper).shipped, false); const beforeSecond = structuredClone(done); done = await act(f, done, laterShipper, { type: 'ship', territory: 'polar_sink', sector: 0, amount: 1 }); for (let step = 0; !done.pendingGuildBetrayal && step < 16; step++) { const decision = done.decision; if (decision?.kind === 'guildShipment') { done = await act(f, done, decision.player, { type: 'decision', allow: true }); } else { const response = done.response; assert.ok(response, 'the later declaration retains its native permission/rate opportunity'); const responder = done.players.find(p => !response.passed.includes(p.id)); assert.ok(responder); done = await act(f, done, responder.id, { type: 'passResponse' }); } } const reaction = viewGame(done, f.holder).guildBetrayalReaction; assert.ok(reaction, 'a later genuinely declared funded shipment opens its own distinct invoice'); assert.notEqual(reaction.event, f.event); assert.equal(reaction.shipper, laterShipper); assert.equal(done.guildBetrayal!.sequence, 2); assert.deepEqual(done.nexusGuildBetrayalHistory, [firstReceipt]); assert.deepEqual(done.guildBetrayalSourceReceipts, [firstSource]); await restored(f, done); await rejected(f, done, await authenticate(f, f.holder), use(f.event)); const price = done.pendingGuildBetrayal!.invoice.price; const later = await act(f, done, f.holder, use(reaction.event)); assert.equal(later.nexusGuildBetrayalHistory!.length, 2); assert.equal(later.guildBetrayalSourceReceipts!.length, 2); assert.deepEqual(later.nexusGuildBetrayalHistory![0], firstReceipt); assert.deepEqual(later.guildBetrayalSourceReceipts![0], firstSource); assert.equal(player(later, laterShipper).spice, player(beforeSecond, laterShipper).spice - price); assert.equal(player(later, f.holder).spice, player(beforeSecond, f.holder).spice + price); assert.equal(player(later, laterShipper).reserves, player(beforeSecond, laterShipper).reserves - 1); assert.equal(player(later, laterShipper).forces['polar_sink:0'], (player(beforeSecond, laterShipper).forces['polar_sink:0'] ?? 0) + 1); await restored(f, later); for (const event of [f.event, reaction.event]) await rejected(f, later, await authenticate(f, f.holder), use(event)); const mutations: { name: string; change(this: void, g: Game): void }[] = [ { name: 'deleted completed receipt', change: g => { g.nexusGuildBetrayalHistory!.shift(); } }, { name: 'deleted independent source receipt', change: g => { g.guildBetrayalSourceReceipts!.shift(); } }, { name: 'deleted receipt cursor', change: g => { delete g.guildBetrayal; } }, { name: 'deleted receipt collection', change: g => { delete g.nexusGuildBetrayalHistory; } }, { name: 'altered historical charged fee', change: g => { g.nexusGuildBetrayalHistory![0].invoice.price++; } }, { name: 'altered historical recipient', change: g => { g.nexusGuildBetrayalHistory![0].recipient = f.guild; } }, { name: 'detached native source event', change: g => { g.guildBetrayalSourceReceipts![0].event += ':foreign'; } }, { name: 'detached native source binding', change: g => { g.guildBetrayalSourceReceipts![0].receipt += ':foreign'; } }, { name: 'reopened completed physical delivery', change: g => { player(g, laterShipper).shipped = false; } }, ]; for (const { name, change } of mutations) { const corrupt = structuredClone(later); change(corrupt); f.save(corrupt); const before = row(f), changes = totalChanges(f); assert.throws(() => normalizeAutomaticGame(corrupt), name); for (const auth of f.auths) await assert.rejects(f.restart().readSeatView(f.code, await authenticate(f, auth.playerId)), name); await rejected(f, corrupt, await authenticate(f, f.holder), use(reaction.event)); assert.deepEqual(row(f), before, name); assert.equal(totalChanges(f), changes, name); protectedRows(f); } }); for (const advanced of [false, true]) { void test(`SQLite ${advanced ? 'Advanced' : 'Basic'} actual free Fremen shipment has no fee opportunity, award or Nexus consumption`, async t => { const f = await fixture(t, { advanced, zero: true, payer: 'other' }); const before = structuredClone(f.before); before.code = f.code; before.host = f.initial.host; before.version = f.initial.version; f.save(before); const done = await act(f, before, f.shipper, f.declaration); assert.equal(done.pendingGuildBetrayal, null); assert.equal(done.guildBetrayal!.sequence, before.guildBetrayal!.sequence); assert.deepEqual(done.players.map(p => [p.id, p.spice]), before.players.map(p => [p.id, p.spice])); assert.deepEqual(done.nexusCards!.cards, before.nexusCards!.cards); assert.deepEqual(delivery(done), delivery(f.original)); assert.equal(player(done, f.shipper).shipped, true); assert.equal(player(done, f.shipper).reserves, player(before, f.shipper).reserves - 2); await restored(f, done); await rejected(f, done, await authenticate(f, f.holder), use(f.event)); }); }