@quenty/studio-bridge 0.21.1 → 0.22.0

package/dist/src/commands/playtest/player/playtest-players.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The players of a running playtest, read and changed through its server
+ * session.
+ *
+ * StudioTestService only adds players from the server DataModel of a
+ * multiplayer test, and each player is a client in its own Studio process.
+ * Kicking a player leaves that process open, so a player whose client
+ * session is connected leaves through `LeaveTest` instead, which closes it.
+ */
+import type { BridgeConnection, BridgeSession } from '../../../bridge/index.js';
+export interface PlaytestPlayer {
+    name: string;
+    userId: number;
+    displayName: string;
+    /** The player's client session, when it is connected. */
+    sessionId?: string;
+}
+/** The players in the playtest `serverSession` belongs to. */
+export declare function listPlaytestPlayersAsync(connection: BridgeConnection, serverSession: BridgeSession): Promise<PlaytestPlayer[]>;
+/**
+ * Add `count` players to a multiplayer test, resolving with them once they
+ * have joined and their client sessions have connected, or after a timeout.
+ */
+export declare function addPlaytestPlayersAsync(connection: BridgeConnection, serverSession: BridgeSession, count: number): Promise<PlaytestPlayer[]>;
+export interface RemovedPlayer {
+    name: string;
+    /** `left` closed the player's client; `kicked` leaves its window open. */
+    how: 'left' | 'kicked';
+}
+/**
+ * Remove players by name, case-insensitively, resolving once they are gone.
+ * Throws for a name that is not in the playtest, before removing anyone.
+ */
+export declare function removePlaytestPlayersAsync(connection: BridgeConnection, serverSession: BridgeSession, names: string[]): Promise<RemovedPlayer[]>;
+export declare function formatPlayersTable(players: PlaytestPlayer[]): string;
+//# sourceMappingURL=playtest-players.d.ts.map

package/dist/src/commands/playtest/player/playtest-players.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playtest-players.d.ts","sourceRoot":"","sources":["../../../../../src/commands/playtest/player/playtest-players.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAWhF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoID,8DAA8D;AAC9D,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA4C1B;AAYD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAEpE"}

package/dist/src/commands/playtest/player/playtest-players.js

@@ -0,0 +1,187 @@
+/**
+ * The players of a running playtest, read and changed through its server
+ * session.
+ *
+ * StudioTestService only adds players from the server DataModel of a
+ * multiplayer test, and each player is a client in its own Studio process.
+ * Kicking a player leaves that process open, so a player whose client
+ * session is connected leaves through `LeaveTest` instead, which closes it.
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { formatTable, } from '@quenty/cli-output-helpers/reporting';
+const PLAYER_CHANGE_TIMEOUT_SEC = 60;
+const CLIENT_SESSION_TIMEOUT_MS = 30_000;
+const SCRIPT_GRACE_MS = 10_000;
+const PLAYER_INFO_FUNCTION = [
+    'local function playerInfo(player)',
+    '\treturn { name = player.Name, userId = player.UserId, displayName = player.DisplayName }',
+    'end',
+].join('\n');
+const LIST_PLAYERS_SCRIPT = [
+    PLAYER_INFO_FUNCTION,
+    'local players = {}',
+    'for _, player in game:GetService("Players"):GetPlayers() do',
+    '\ttable.insert(players, playerInfo(player))',
+    'end',
+    'return players',
+].join('\n');
+function addPlayersScript(count) {
+    return [
+        PLAYER_INFO_FUNCTION,
+        'local Players = game:GetService("Players")',
+        'local before = {}',
+        'for _, player in Players:GetPlayers() do',
+        '\tbefore[player] = true',
+        'end',
+        `game:GetService("StudioTestService"):AddPlayers(${count})`,
+        `local deadline = os.clock() + ${PLAYER_CHANGE_TIMEOUT_SEC}`,
+        'local added = {}',
+        'repeat',
+        '\ttask.wait(0.25)',
+        '\tadded = {}',
+        '\tfor _, player in Players:GetPlayers() do',
+        '\t\tif not before[player] then',
+        '\t\t\ttable.insert(added, playerInfo(player))',
+        '\t\tend',
+        '\tend',
+        `until #added >= ${count} or os.clock() > deadline`,
+        'return added',
+    ].join('\n');
+}
+function kickPlayersScript(names) {
+    return [
+        `local names = ${luaStringList(names)}`,
+        'local Players = game:GetService("Players")',
+        'for _, name in names do',
+        '\tlocal player = Players:FindFirstChild(name)',
+        '\tif player then',
+        '\t\tplayer:Kick("Removed by studio-bridge")',
+        '\tend',
+        'end',
+    ].join('\n');
+}
+function waitForPlayersGoneScript(names) {
+    return [
+        `local names = ${luaStringList(names)}`,
+        'local Players = game:GetService("Players")',
+        `local deadline = os.clock() + ${PLAYER_CHANGE_TIMEOUT_SEC}`,
+        'local remaining',
+        'repeat',
+        '\tremaining = {}',
+        '\tfor _, name in names do',
+        '\t\tif Players:FindFirstChild(name) then',
+        '\t\t\ttable.insert(remaining, name)',
+        '\t\tend',
+        '\tend',
+        '\tif #remaining > 0 then',
+        '\t\ttask.wait(0.25)',
+        '\tend',
+        'until #remaining == 0 or os.clock() > deadline',
+        'return remaining',
+    ].join('\n');
+}
+const LEAVE_TEST_SCRIPT = 'task.defer(function() game:GetService("StudioTestService"):LeaveTest() end)';
+function luaStringList(values) {
+    return `{ ${values.map((value) => JSON.stringify(value)).join(', ')} }`;
+}
+async function runScriptAsync(session, script) {
+    const result = await session.execAsync(script, PLAYER_CHANGE_TIMEOUT_SEC * 1000 + SCRIPT_GRACE_MS);
+    if (!result.success) {
+        throw new Error(result.error ?? 'Player script failed');
+    }
+    return result.returnValues?.[0];
+}
+function toPlayers(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((entry) => ({
+        name: String(entry.name),
+        userId: Number(entry.userId),
+        displayName: String(entry.displayName),
+    }));
+}
+function findClientSession(connection, instanceId, playerName) {
+    const info = connection
+        .listSessions()
+        .find((s) => s.instanceId === instanceId &&
+        s.context === 'client' &&
+        s.playerName === playerName);
+    return info ? connection.getSession(info.sessionId) : undefined;
+}
+function withSessions(connection, instanceId, players) {
+    return players.map((player) => {
+        const session = findClientSession(connection, instanceId, player.name);
+        return session ? { ...player, sessionId: session.info.sessionId } : player;
+    });
+}
+/** The players in the playtest `serverSession` belongs to. */
+export async function listPlaytestPlayersAsync(connection, serverSession) {
+    const players = toPlayers(await runScriptAsync(serverSession, LIST_PLAYERS_SCRIPT));
+    return withSessions(connection, serverSession.info.instanceId, players);
+}
+/**
+ * Add `count` players to a multiplayer test, resolving with them once they
+ * have joined and their client sessions have connected, or after a timeout.
+ */
+export async function addPlaytestPlayersAsync(connection, serverSession, count) {
+    const added = toPlayers(await runScriptAsync(serverSession, addPlayersScript(count)));
+    const { instanceId } = serverSession.info;
+    const deadline = Date.now() + CLIENT_SESSION_TIMEOUT_MS;
+    while (Date.now() < deadline &&
+        added.some((player) => !findClientSession(connection, instanceId, player.name))) {
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    return withSessions(connection, instanceId, added);
+}
+/**
+ * Remove players by name, case-insensitively, resolving once they are gone.
+ * Throws for a name that is not in the playtest, before removing anyone.
+ */
+export async function removePlaytestPlayersAsync(connection, serverSession, names) {
+    const current = await listPlaytestPlayersAsync(connection, serverSession);
+    const found = names.map((name) => {
+        const player = current.find((p) => p.name.toLowerCase() === name.toLowerCase());
+        if (!player) {
+            const known = current.map((p) => p.name).join(', ') || 'none';
+            throw new Error(`No player named '${name}' (players: ${known})`);
+        }
+        return player;
+    });
+    const targets = [...new Set(found)];
+    const removed = [];
+    const toKick = [];
+    for (const player of targets) {
+        const client = player.sessionId
+            ? connection.getSession(player.sessionId)
+            : undefined;
+        if (client) {
+            await runScriptAsync(client, LEAVE_TEST_SCRIPT);
+            removed.push({ name: player.name, how: 'left' });
+        }
+        else {
+            toKick.push(player.name);
+            removed.push({ name: player.name, how: 'kicked' });
+        }
+    }
+    if (toKick.length > 0) {
+        await runScriptAsync(serverSession, kickPlayersScript(toKick));
+    }
+    const remaining = await runScriptAsync(serverSession, waitForPlayersGoneScript(targets.map((p) => p.name)));
+    if (Array.isArray(remaining) && remaining.length > 0) {
+        throw new Error(`Players still in the playtest after ${PLAYER_CHANGE_TIMEOUT_SEC}s: ${remaining.join(', ')}`);
+    }
+    return removed;
+}
+const playerColumns = [
+    { header: 'Player', value: (p) => p.name },
+    { header: 'UserId', value: (p) => String(p.userId) },
+    {
+        header: 'Session',
+        value: (p) => p.sessionId ?? '',
+        format: (v) => OutputHelper.formatHint(v),
+    },
+];
+export function formatPlayersTable(players) {
+    return formatTable(players, playerColumns);
+}
+//# sourceMappingURL=playtest-players.js.map

package/dist/src/commands/playtest/player/playtest-players.js.map

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

package/dist/src/commands/playtest/player/playtest-players.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=playtest-players.test.d.ts.map

package/dist/src/commands/playtest/player/playtest-players.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playtest-players.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/playtest/player/playtest-players.test.ts"],"names":[],"mappings":""}

package/dist/src/commands/playtest/player/playtest-players.test.js

@@ -0,0 +1,89 @@
+import { describe, it, expect, vi } from 'vitest';
+import { addPlaytestPlayersAsync, listPlaytestPlayersAsync, removePlaytestPlayersAsync, } from './playtest-players.js';
+function createSession(sessionId, context, returnValues, playerName) {
+    const scripts = [];
+    return {
+        scripts,
+        info: { sessionId, instanceId: 'place-1a2b', context, playerName },
+        context,
+        execAsync: vi.fn(async (script) => {
+            scripts.push(script);
+            return { success: true, output: [], returnValues: returnValues.shift() };
+        }),
+    };
+}
+function createConnection(sessions) {
+    return {
+        listSessions: () => sessions.map((s) => s.info),
+        getSession: (id) => sessions.find((s) => s.info.sessionId === id),
+    };
+}
+const player = (name, userId) => ({
+    name,
+    userId,
+    displayName: name,
+});
+describe('listPlaytestPlayersAsync', () => {
+    it('pairs each player with its client session', async () => {
+        const server = createSession('place-1a2b-server', 'server', [
+            [[player('Player1', -1), player('Player2', -2)]],
+        ]);
+        const client = createSession('place-1a2b-client-player1', 'client', [], 'Player1');
+        const players = await listPlaytestPlayersAsync(createConnection([server, client]), server);
+        expect(players).toEqual([
+            { ...player('Player1', -1), sessionId: 'place-1a2b-client-player1' },
+            player('Player2', -2),
+        ]);
+    });
+});
+describe('addPlaytestPlayersAsync', () => {
+    it('adds players from the server and reports the ones that joined', async () => {
+        const server = createSession('place-1a2b-server', 'server', [
+            [[player('Player3', -3)]],
+        ]);
+        const client = createSession('place-1a2b-client-player3', 'client', [], 'Player3');
+        const players = await addPlaytestPlayersAsync(createConnection([server, client]), server, 1);
+        expect(server.scripts[0]).toContain('AddPlayers(1)');
+        expect(players).toEqual([
+            { ...player('Player3', -3), sessionId: 'place-1a2b-client-player3' },
+        ]);
+    });
+});
+describe('removePlaytestPlayersAsync', () => {
+    it('has a connected client leave and kicks the rest', async () => {
+        const server = createSession('place-1a2b-server', 'server', [
+            [[player('Player1', -1), player('Player2', -2)]],
+            [],
+            [[]],
+        ]);
+        const client = createSession('place-1a2b-client-player1', 'client', [[]], 'Player1');
+        const removed = await removePlaytestPlayersAsync(createConnection([server, client]), server, ['player1', 'Player2']);
+        expect(removed).toEqual([
+            { name: 'Player1', how: 'left' },
+            { name: 'Player2', how: 'kicked' },
+        ]);
+        expect(client.scripts[0]).toContain('LeaveTest');
+        expect(server.scripts[1]).toContain('"Player2"');
+        expect(server.scripts[1]).not.toContain('"Player1"');
+    });
+    it('removes a player named twice only once', async () => {
+        const server = createSession('place-1a2b-server', 'server', [
+            [[player('Player2', -2)]],
+            [],
+            [[]],
+        ]);
+        const removed = await removePlaytestPlayersAsync(createConnection([server]), server, ['Player2', 'player2']);
+        expect(removed).toEqual([{ name: 'Player2', how: 'kicked' }]);
+    });
+    it('refuses an unknown name before removing anyone', async () => {
+        const server = createSession('place-1a2b-server', 'server', [
+            [[player('Player1', -1)]],
+        ]);
+        await expect(removePlaytestPlayersAsync(createConnection([server]), server, [
+            'Player1',
+            'Nobody',
+        ])).rejects.toThrow("No player named 'Nobody' (players: Player1)");
+        expect(server.scripts).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=playtest-players.test.js.map

package/dist/src/commands/playtest/player/playtest-players.test.js.map

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

package/dist/src/commands/playtest/player/remove/remove.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `playtest player remove` — remove players from the running playtest.
+ */
+import type { BridgeConnection } from '../../../../bridge/index.js';
+import { type RemovedPlayer } from '../playtest-players.js';
+export interface PlaytestPlayerRemoveResult {
+    players: RemovedPlayer[];
+    summary: string;
+}
+interface PlaytestPlayerRemoveArgs {
+    names: string[];
+}
+export declare function playtestPlayerRemoveHandlerAsync(connection: BridgeConnection, names: string[], target?: string): Promise<PlaytestPlayerRemoveResult>;
+export declare function formatPlayerRemoveText(result: PlaytestPlayerRemoveResult): string;
+export declare const playtestPlayerRemoveCommand: import("../../../framework/define-command.js").CommandDefinition<PlaytestPlayerRemoveArgs, PlaytestPlayerRemoveResult>;
+export {};
+//# sourceMappingURL=remove.d.ts.map

package/dist/src/commands/playtest/player/remove/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../../../src/commands/playtest/player/remove/remove.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,0BAA0B,CAAC,CAerC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CASR;AAED,eAAO,MAAM,2BAA2B,wHAqBtC,CAAC"}

package/dist/src/commands/playtest/player/remove/remove.js

@@ -0,0 +1,42 @@
+/**
+ * `playtest player remove` — remove players from the running playtest.
+ */
+import { defineCommand } from '../../../framework/define-command.js';
+import { arg } from '../../../framework/arg-builder.js';
+import { resolvePlaytestServerSessionAsync } from '../../playtest-sessions.js';
+import { removePlaytestPlayersAsync, } from '../playtest-players.js';
+export async function playtestPlayerRemoveHandlerAsync(connection, names, target) {
+    const serverSession = await resolvePlaytestServerSessionAsync(connection, target);
+    const players = await removePlaytestPlayersAsync(connection, serverSession, names);
+    return {
+        players,
+        summary: `Removed ${players.map((p) => p.name).join(', ')}`,
+    };
+}
+export function formatPlayerRemoveText(result) {
+    const kicked = result.players.filter((p) => p.how === 'kicked');
+    if (kicked.length === 0)
+        return result.summary;
+    return `${result.summary}\nKicked ${kicked
+        .map((p) => p.name)
+        .join(', ')}, whose client session was not connected, so its window stays open`;
+}
+export const playtestPlayerRemoveCommand = defineCommand({
+    group: 'playtest player',
+    name: 'remove',
+    description: 'Remove players from the running playtest by name',
+    category: 'execution',
+    safety: 'mutate',
+    scope: 'connection',
+    args: {
+        names: arg.positional({
+            description: 'Player names (e.g. Player2)',
+            array: true,
+        }),
+    },
+    cli: {
+        format: formatPlayerRemoveText,
+    },
+    handler: async (connection, args, targeting) => playtestPlayerRemoveHandlerAsync(connection, args.names, targeting.target),
+});
+//# sourceMappingURL=remove.js.map

package/dist/src/commands/playtest/player/remove/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../../src/commands/playtest/player/remove/remove.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAExD,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC;AAWhC,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,UAA4B,EAC5B,KAAe,EACf,MAAe;IAEf,MAAM,aAAa,GAAG,MAAM,iCAAiC,CAC3D,UAAU,EACV,MAAM,CACP,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAC9C,UAAU,EACV,aAAa,EACb,KAAK,CACN,CAAC;IAEF,OAAO;QACL,OAAO;QACP,OAAO,EAAE,WAAW,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAkC;IAElC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAE/C,OAAO,GAAG,MAAM,CAAC,OAAO,YAAY,MAAM;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CACH,IAAI,CACL,oEAAoE,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAGtD;IACA,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,kDAAkD;IAC/D,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC;YACpB,WAAW,EAAE,6BAA6B;YAC1C,KAAK,EAAE,IAAI;SACZ,CAAC;KACH;IACD,GAAG,EAAE;QACH,MAAM,EAAE,sBAAsB;KAC/B;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAC7C,gCAAgC,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC;CAC7E,CAAC,CAAC"}

package/dist/src/commands/playtest/playtest-sessions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Starting, finding, and ending StudioTestService playtests.
+ *
+ * A playtest opens fresh server (and, in play mode, client) DataModels, and
+ * each connects to the bridge as its own session. Those sessions can't be
+ * matched to the Studio that started them by instance id, since unpublished
+ * places give every DataModel its own. Instead, `startPlaytestAsync` passes a
+ * playtest id as the StudioTestService test args, and each new session is
+ * asked for it back through `GetTestArgs`.
+ */
+import type { BridgeConnection, BridgeSession, EndPlaytestResult, PlaytestEndResult, PlaytestMode, SessionContext } from '../../bridge/index.js';
+export interface StartedPlaytest {
+    playtestId: string;
+    mode: PlaytestMode;
+    /** Set for a multiplayer test. */
+    players?: number;
+    /** The playtest's sessions: always `server`, plus `client` in play mode. */
+    sessions: Partial<Record<SessionContext, BridgeSession>>;
+    /** Every client session, one per player. */
+    clients: BridgeSession[];
+    /** Settles when the playtest ends. Never rejects. */
+    ended: Promise<PlaytestEndResult>;
+}
+/** The sessions a playtest opens, by mode. Run mode has no player, so no client. */
+export declare function getPlaytestContexts(mode: PlaytestMode): SessionContext[];
+/**
+ * Start a playtest from `editSession` and resolve once every session it opens
+ * has connected. With `players`, it is a multiplayer test with a client per
+ * player. Rejects if Studio refuses to start it, e.g. because a playtest is
+ * already running.
+ */
+export declare function startPlaytestAsync(connection: BridgeConnection, editSession: BridgeSession, mode: PlaytestMode, players?: number): Promise<StartedPlaytest>;
+/**
+ * Resolve the server session of a running playtest. `target` names it or
+ * any session of its Studio; otherwise there must be exactly one connected.
+ */
+export declare function resolvePlaytestServerSessionAsync(connection: BridgeConnection, target?: string): Promise<BridgeSession>;
+/**
+ * Explains a missing `server` or `client` session: no playtest is running, a
+ * run-mode playtest has no client, or the playtest's sessions can't connect.
+ * Other errors pass through unchanged.
+ */
+export declare function explainMissingPlaytestContextAsync(connection: BridgeConnection, err: unknown): Promise<unknown>;
+/**
+ * End the playtest `serverSession` belongs to, resolving once the session has
+ * closed with what the playtest reported about itself.
+ */
+export declare function endPlaytestAsync(connection: BridgeConnection, serverSession: BridgeSession): Promise<EndPlaytestResult>;
+//# sourceMappingURL=playtest-sessions.d.ts.map

package/dist/src/commands/playtest/playtest-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playtest-sessions.d.ts","sourceRoot":"","sources":["../../../../src/commands/playtest/playtest-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,uBAAuB,CAAC;AAuB/B,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IACzD,4CAA4C;IAC5C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnC;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,EAAE,CAExE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,aAAa,EAC1B,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CA2F1B;AAyBD;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CA6BxB;AAED;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,CAAC,CAqBlB;AA4BD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAI5B"}