// ── What one player holds, as that player reads it ──────────────────────── // // Phase 8's half of R2. The admin surface answers *who holds what* against the // authored tables; this answers *what do I hold*, and the two differ in three // ways that are each a test below: // // • the scope is RESOLVED here. A client handed `*` would have to know what // the fleet is to say anything, and then `inScope` exists twice. // • `live` is the PUSHED ledger, never the authored row. A grant is not a // privilege in a game until a sync confirmed it, and phase 7 is careful // never to record a push that silently did nothing — so "waiting" is an // honest answer and the alternative is the site claiming to have given // something it has not. // • an entitlement reaching NOBODY still lists. Authored against the website // account, it exists before a Steam id does, and hiding it until one turns // up is the defect the admin user page shipped in phase 7 (PLAN.md §20.5). const test = require('node:test') const assert = require('node:assert') const { fakeCtx } = require('./_fakes') /** The model, wired to a db module answering from one fixture. */ function modelWith(fixture) { require('../core')._reset() require('../core').init(fakeCtx({ db: { query: () => Promise.resolve([]), pool: {} } })) const db = require('../model/permissions/permissions.db') const model = require('../model/permissions/permissions.model') const originals = {} for (const [name, value] of Object.entries(fixture)) { originals[name] = db[name] db[name] = () => Promise.resolve(value) } return { model, restore: () => Object.assign(db, originals) } } const SERVERS = [ { id: 'main', name: 'Main' }, { id: 'creative', name: 'Creative' }, ] /** One person: in a fleet group, holding one server-scoped grant. */ function fixture({ pushed = [] } = {}) { return { listGroupsForUser: [{ name: 'vip', title: 'VIP', rank: 10, scope: '*', addedAt: '2026-09-01T00:00:00Z' }], listGroupPermissions: [ { groupName: 'vip', permission: 'Kits.VIP' }, { groupName: 'builder', permission: 'buildtools.use' }, ], listGrants: [ { id: 7, userId: 4, permission: 'zonemanager.admin', scope: 'creative', source: 'admin', note: null, grantedAt: '2026-09-02T00:00:00Z', steamId: '7656119', playerName: 'Wanderer' }, ], listPushedForSteamIds: pushed, } } test('a fleet scope resolves to every server; a server scope to one', async () => { const { model, restore } = modelWith(fixture()) try { const held = await model.forPlayer(4, ['7656119'], SERVERS) assert.deepEqual(held.groups[0].reach.map((s) => s.id), ['main', 'creative']) assert.deepEqual(held.grants[0].reach.map((s) => s.id), ['creative']) } finally { restore() } }) test('live is the pushed ledger, per server — not the authored row', async () => { const { model, restore } = modelWith( fixture({ pushed: [{ serverId: 'main', kind: 'member', subject: '7656119', object: 'vip' }] }), ) try { const held = await model.forPlayer(4, ['7656119'], SERVERS) const byId = Object.fromEntries(held.groups[0].reach.map((s) => [s.id, s.live])) assert.equal(byId.main, true, 'the server that confirmed it has it') assert.equal(byId.creative, false, 'the one that has not is waiting, not live') // The grant was never pushed anywhere, and an authored row must not imply one. assert.deepEqual(held.grants[0].reach.map((s) => s.live), [false]) } finally { restore() } }) test('an entitlement is live for the person when it landed on ANY account they hold', async () => { // Two accounts, one membership pushed against the second. The game sees one // player with the rank; so does this. const { model, restore } = modelWith( fixture({ pushed: [{ serverId: 'main', kind: 'member', subject: '7656120', object: 'vip' }] }), ) try { const held = await model.forPlayer(4, ['7656119', '7656120'], SERVERS) assert.equal(held.groups[0].reach.find((s) => s.id === 'main').live, true) } finally { restore() } }) test('a grant and a membership are different rows about the same person', async () => { // `kind` is why the pushed lookup carries it: a membership of `vip` and a // direct grant named `vip` would otherwise be one entry in the map, and the // wrong one would light up. const { model, restore } = modelWith({ listGroupsForUser: [{ name: 'vip', title: 'VIP', rank: 0, scope: '*', addedAt: null }], listGroupPermissions: [], listGrants: [{ id: 1, userId: 4, permission: 'vip', scope: '*', source: 'admin', note: null, grantedAt: null, steamId: '7656119' }], listPushedForSteamIds: [{ serverId: 'main', kind: 'grant', subject: '7656119', object: 'vip' }], }) try { const held = await model.forPlayer(4, ['7656119'], SERVERS) assert.equal(held.grants[0].reach.find((s) => s.id === 'main').live, true) assert.equal(held.groups[0].reach.find((s) => s.id === 'main').live, false) } finally { restore() } }) test('a player with no linked account still sees what they were given', async () => { const { model, restore } = modelWith(fixture()) try { const held = await model.forPlayer(4, [], SERVERS) assert.equal(held.groups.length, 1) assert.equal(held.grants.length, 1) assert.ok( [...held.groups[0].reach, ...held.grants[0].reach].every((s) => s.live === false), 'authored, and reaching nobody — which is the state worth showing', ) } finally { restore() } }) test('only the caller’s own groups carry their permissions, lowered as the store lowers them', async () => { const { model, restore } = modelWith(fixture()) try { const held = await model.forPlayer(4, ['7656119'], SERVERS) // `builder`'s permission is in the group-permission table and this caller is // not in that group; `Kits.VIP` is theirs, and arrives the way a game stores it. assert.deepEqual(held.groups[0].permissions, ['kits.vip']) } finally { restore() } }) test('a fleet with no servers configured reaches nothing and does not throw', async () => { const { model, restore } = modelWith(fixture()) try { const held = await model.forPlayer(4, ['7656119'], []) assert.deepEqual(held.groups[0].reach, []) assert.deepEqual(held.grants[0].reach, []) } finally { restore() } })