@quenty/studio-bridge 0.21.1 → 0.22.1

package/dist/src/commands/process/close/close.test.js

@@ -0,0 +1,190 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+vi.mock('../../../process/studio-process-closer.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        listStudioProcessesAsync: vi.fn(),
+        closeStudioProcessAsync: vi.fn(),
+    };
+});
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { closeDeployTargetAsync, processCloseHandlerAsync } from './close.js';
+import { closeStudioProcessAsync, listStudioProcessesAsync, } from '../../../process/studio-process-closer.js';
+const queryStateAsync = async () => ({ placeId: 0 });
+const session = {
+    info: { sessionId: 'test-place-edit', placeName: 'test-place.rbxl' },
+    queryStateAsync,
+};
+describe('processCloseHandlerAsync', () => {
+    beforeEach(() => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            { pid: 10, windowTitle: 'C:\\places\\test-place.rbxl - Roblox Studio' },
+            { pid: 20, windowTitle: 'Other - Roblox Studio' },
+        ]);
+        vi.mocked(closeStudioProcessAsync).mockReset().mockResolvedValue(true);
+    });
+    it('closes the Studio window showing the session place', async () => {
+        const result = await processCloseHandlerAsync(session);
+        expect(closeStudioProcessAsync).toHaveBeenCalledWith(10, {
+            force: undefined,
+        });
+        expect(result).toMatchObject({ success: true, pid: 10 });
+    });
+    it('closes the Studio a single-process playtest runs in', async () => {
+        const server = {
+            info: {
+                sessionId: 'test-place-server',
+                instanceId: 'test-place',
+                context: 'server',
+                placeName: 'Game',
+            },
+            queryStateAsync,
+        };
+        const connection = {
+            listSessions: () => [
+                {
+                    sessionId: 'test-place-server',
+                    instanceId: 'test-place',
+                    context: 'server',
+                    placeName: 'test-place.rbxl',
+                },
+            ],
+        };
+        const result = await processCloseHandlerAsync(server, {}, connection);
+        expect(result).toMatchObject({ success: true, pid: 10 });
+    });
+    it('refuses a multiplayer test process without --pid', async () => {
+        const client = {
+            info: {
+                sessionId: 'test-place-client-player1',
+                instanceId: 'test-place',
+                context: 'client',
+                placeName: 'Game',
+            },
+            queryStateAsync,
+        };
+        const connection = {
+            listSessions: () => ['player1', 'player2'].map((player) => ({
+                sessionId: `test-place-client-${player}`,
+                instanceId: 'test-place',
+                context: 'client',
+                placeName: 'test-place.rbxl',
+                playerName: player,
+            })),
+        };
+        const result = await processCloseHandlerAsync(client, {}, connection);
+        expect(result.success).toBe(false);
+        expect(result.summary).toContain("'studio-bridge playtest stop'");
+        expect(closeStudioProcessAsync).not.toHaveBeenCalled();
+    });
+    it('finds a cloud place by the place id Studio was launched with', async () => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            {
+                pid: 30,
+                windowTitle: 'My Game (abc123) - Roblox Studio',
+                commandLine: 'RobloxStudioBeta.exe roblox-studio:1+placeId:555+universeId:9',
+            },
+        ]);
+        const cloudSession = {
+            info: { sessionId: 'place1-edit', placeName: 'Place1', placeId: 0 },
+            queryStateAsync: async () => ({ placeId: 555 }),
+        };
+        const result = await processCloseHandlerAsync(cloudSession);
+        expect(result).toMatchObject({ success: true, pid: 30 });
+    });
+    it('passes --force through', async () => {
+        await processCloseHandlerAsync(session, { force: true });
+        expect(closeStudioProcessAsync).toHaveBeenCalledWith(10, { force: true });
+    });
+    it('suggests --force when Studio stays open', async () => {
+        vi.mocked(closeStudioProcessAsync).mockResolvedValue(false);
+        const result = await processCloseHandlerAsync(session);
+        expect(result.success).toBe(false);
+        expect(result.summary).toContain('--force');
+    });
+    it('fails without closing when no window shows the place', async () => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            { pid: 20, windowTitle: 'Other - Roblox Studio' },
+        ]);
+        const result = await processCloseHandlerAsync(session);
+        expect(result.success).toBe(false);
+        expect(closeStudioProcessAsync).not.toHaveBeenCalled();
+    });
+    it('asks for --pid when several windows show the place', async () => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            { pid: 10, windowTitle: 'C:\\a\\test-place.rbxl - Roblox Studio' },
+            { pid: 11, windowTitle: 'C:\\b\\test-place.rbxl - Roblox Studio' },
+        ]);
+        const result = await processCloseHandlerAsync(session);
+        expect(result.success).toBe(false);
+        expect(result.summary).toContain('--pid');
+        expect(closeStudioProcessAsync).not.toHaveBeenCalled();
+    });
+    it('closes the process picked with --pid', async () => {
+        const result = await processCloseHandlerAsync(session, { pid: 20 });
+        expect(closeStudioProcessAsync).toHaveBeenCalledWith(20, {
+            force: undefined,
+        });
+        expect(result.success).toBe(true);
+    });
+});
+describe('closeDeployTargetAsync', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'close-test-'));
+        await fs.writeFile(path.join(tempDir, 'deploy.nevermore.json'), JSON.stringify({
+            targets: {
+                test: { universeId: 9, placeId: 555, project: 'test.project.json' },
+            },
+        }));
+        vi.mocked(closeStudioProcessAsync).mockReset().mockResolvedValue(true);
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    it('closes a Studio launched with the target place, connected or not', async () => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            {
+                pid: 40,
+                windowTitle: 'My Game (abc123) - Roblox Studio',
+                commandLine: 'RobloxStudioBeta.exe roblox-studio:1+placeId:555',
+            },
+            { pid: 41, windowTitle: 'Other - Roblox Studio' },
+        ]);
+        const connection = { listInstances: () => [], listSessions: () => [] };
+        const result = await closeDeployTargetAsync(connection, 'test', {}, tempDir);
+        expect(closeStudioProcessAsync).toHaveBeenCalledWith(40, {
+            force: undefined,
+        });
+        expect(result).toMatchObject({
+            success: true,
+            deployTarget: 'test',
+            pid: 40,
+        });
+    });
+    it('closes the connected Studio showing the target place', async () => {
+        vi.mocked(listStudioProcessesAsync).mockResolvedValue([
+            { pid: 50, windowTitle: 'My Game (abc123) - Roblox Studio' },
+        ]);
+        const editSession = {
+            info: {
+                sessionId: 'place1-1a2b-edit',
+                instanceId: 'place1-1a2b',
+                context: 'edit',
+                placeName: 'My Game (abc123)',
+            },
+            queryStateAsync: async () => ({ placeId: 555 }),
+        };
+        const connection = {
+            listInstances: () => [{ instanceId: 'place1-1a2b', placeId: 555 }],
+            listSessions: () => [editSession.info],
+            resolveSessionAsync: vi.fn().mockResolvedValue(editSession),
+        };
+        const result = await closeDeployTargetAsync(connection, 'test', {}, tempDir);
+        expect(connection.resolveSessionAsync).toHaveBeenCalledWith('place1-1a2b', 'edit');
+        expect(result).toMatchObject({ success: true, pid: 50 });
+    });
+});
+//# sourceMappingURL=close.test.js.map

package/dist/src/commands/process/close/close.test.js.map

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

package/dist/src/commands/process/info/info.d.ts

@@ -1,17 +1,57 @@
 /**
- * `process info` — query the current Studio state (mode, place info)
- * from a connected session.
+ * `process info` — report on one Studio session: its place and run mode, the
+ * playtest running in its Studio, its window, and whether its plugin is
+ * current.
  */
-import type { BridgeSession } from '../../../bridge/index.js';
-import type { StudioState } from '../../../bridge/index.js';
+import type { BridgeConnection, BridgeSession, SessionContext, SessionInfo, SessionOrigin, StudioState } from '../../../bridge/index.js';
+export interface PlaytestInfo {
+    mode: 'play' | 'run';
+    /** Set for a multiplayer test: how many of its clients are connected. */
+    playerCount?: number;
+    sessions: Array<{
+        sessionId: string;
+        context: SessionContext;
+        playerName?: string;
+    }>;
+}
 export interface StateResult {
+    sessionId: string;
+    instanceId: string;
+    context: SessionContext;
+    origin: SessionOrigin;
+    /** The run mode of this session's own DataModel. */
     state: StudioState;
     placeId: number;
     placeName: string;
     gameId: number;
+    /** The camera viewport in pixels. Absent without a camera. */
+    viewportSize?: [number, number];
+    /** Absent from older plugins. */
+    studioVersion?: string;
+    plugin: {
+        version: string;
+        /** The version `studio-bridge plugin install` would install. */
+        expectedVersion: string;
+        upToDate: boolean;
+    };
+    /**
+     * The playtest running in this session's Studio, as seen through the
+     * sessions it opened. Absent when none is running or its sessions are not
+     * connected.
+     */
+    playtest?: PlaytestInfo;
+    /** The Studio window showing the place. Absent when it cannot be told apart. */
+    window?: {
+        pid: number;
+        focused: boolean;
+        minimized: boolean;
+    };
+    connectedAt: string;
     summary: string;
 }
-export declare function queryStateHandlerAsync(session: BridgeSession): Promise<StateResult>;
+export declare function queryStateHandlerAsync(session: BridgeSession, connection?: BridgeConnection): Promise<StateResult>;
+/** The playtest of `instanceId`, from the sessions it opened. */
+export declare function describePlaytest(sessions: SessionInfo[], instanceId: string): PlaytestInfo | undefined;
 export declare function formatStateText(result: StateResult): string;
 export declare const infoCommand: import("../../framework/define-command.js").CommandDefinition<unknown, StateResult>;
 //# sourceMappingURL=info.d.ts.map

package/dist/src/commands/process/info/info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/info/info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO3D;AAED,eAAO,MAAM,WAAW,qFAYtB,CAAC"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/info/info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACZ,MAAM,0BAA0B,CAAC;AASlC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,cAAc,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,oDAAoD;IACpD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,gEAAgE;QAChE,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,GACjB,YAAY,GAAG,SAAS,CAoB1B;AAmDD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAiC3D;AAED,eAAO,MAAM,WAAW,qFActB,CAAC"}

package/dist/src/commands/process/info/info.js

@@ -1,31 +1,135 @@
 /**
- * `process info` — query the current Studio state (mode, place info)
- * from a connected session.
+ * `process info` — report on one Studio session: its place and run mode, the
+ * playtest running in its Studio, its window, and whether its plugin is
+ * current.
  */
+import { OutputHelper } from '@quenty/cli-output-helpers';
 import { defineCommand } from '../../framework/define-command.js';
 import { colorizeState } from '../format-state.js';
-export async function queryStateHandlerAsync(session) {
-    const result = await session.queryStateAsync();
+import { listStudioProcessesAsync, matchStudioProcesses, } from '../../../process/studio-process-closer.js';
+import { tryGetStudioWindowStateAsync } from '../../../process/studio-window-state.js';
+import { getPluginBuildVersionAsync } from '../../../plugin/plugin-build-version.js';
+export async function queryStateHandlerAsync(session, connection) {
+    // Listed sessions carry the edit session's place name for a playtest
+    const listed = connection
+        ?.listSessions()
+        .find((s) => s.sessionId === session.info.sessionId);
+    const playtest = connection
+        ? describePlaytest(connection.listSessions(), session.info.instanceId)
+        : undefined;
+    // Each process of a multiplayer test has its own window; otherwise a
+    // playtest shows in the edit window
+    const ownWindow = session.info.context !== 'edit' && playtest?.playerCount !== undefined;
+    const [result, expectedVersion] = await Promise.all([
+        session.queryStateAsync(),
+        getPluginBuildVersionAsync(),
+    ]);
+    const window = await tryGetWindowAsync(ownWindow ? [result.placeName] : [result.placeName, listed?.placeName], ownWindow ? undefined : result.placeId);
     return {
+        sessionId: session.info.sessionId,
+        instanceId: session.info.instanceId,
+        context: session.info.context,
+        origin: session.info.origin,
         state: result.state,
         placeId: result.placeId,
-        placeName: result.placeName,
+        placeName: listed?.placeName || result.placeName,
         gameId: result.gameId,
+        viewportSize: result.viewportSize,
+        studioVersion: result.studioVersion,
+        plugin: {
+            version: session.info.pluginVersion,
+            expectedVersion,
+            upToDate: session.info.pluginVersion === expectedVersion,
+        },
+        playtest,
+        window,
+        connectedAt: new Date(session.info.connectedAt).toISOString(),
         summary: `Mode: ${result.state}, Place: ${result.placeName} (${result.placeId})`,
     };
 }
+/** The playtest of `instanceId`, from the sessions it opened. */
+export function describePlaytest(sessions, instanceId) {
+    const playtestSessions = sessions.filter((s) => s.instanceId === instanceId && s.context !== 'edit');
+    if (playtestSessions.length === 0)
+        return undefined;
+    const clients = playtestSessions.filter((s) => s.context === 'client');
+    const isMultiplayer = clients.some((s) => s.sessionId !== `${instanceId}-client`);
+    return {
+        mode: clients.length > 0 ? 'play' : 'run',
+        playerCount: isMultiplayer ? clients.length : undefined,
+        sessions: playtestSessions.map((s) => ({
+            sessionId: s.sessionId,
+            context: s.context,
+            playerName: s.playerName,
+        })),
+    };
+}
+/**
+ * The Studio window titled with the first of `placeNames` that any window
+ * has, when exactly one does. A multiplayer test's processes title their
+ * windows with their own DataModel's name, and its clients all share one;
+ * a single-process playtest shares the edit window.
+ */
+async function tryGetWindowAsync(placeNames, placeId) {
+    const processes = await listStudioProcessesAsync().catch(() => []);
+    for (const placeName of placeNames) {
+        if (!placeName)
+            continue;
+        const matches = matchStudioProcesses(processes, placeName, placeId);
+        if (matches.length === 0)
+            continue;
+        if (matches.length > 1)
+            return undefined;
+        const pid = matches[0].pid;
+        const state = await tryGetStudioWindowStateAsync(pid);
+        return state ? { pid, ...state } : undefined;
+    }
+    return undefined;
+}
+function formatAge(isoTime) {
+    const seconds = Math.max(0, Math.round((Date.now() - Date.parse(isoTime)) / 1000));
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    return `${Math.floor(seconds / 3600)}h ${Math.floor((seconds % 3600) / 60)}m ago`;
+}
+function formatPlaytest(playtest) {
+    if (!playtest)
+        return 'none running';
+    const kind = playtest.playerCount !== undefined
+        ? `multiplayer, ${playtest.playerCount} player${playtest.playerCount === 1 ? '' : 's'}`
+        : `${playtest.mode} mode`;
+    return `running (${kind}): ${playtest.sessions
+        .map((s) => s.sessionId)
+        .join(', ')}`;
+}
 export function formatStateText(result) {
-    return [
-        `Mode:    ${colorizeState(result.state)}`,
-        `Place:   ${result.placeName}`,
-        `PlaceId: ${result.placeId}`,
-        `GameId:  ${result.gameId}`,
-    ].join('\n');
+    const lines = [
+        `Session:  ${OutputHelper.formatHint(result.sessionId)} (${result.context}, ${result.origin}, connected ${formatAge(result.connectedAt)})`,
+        `Mode:     ${colorizeState(result.state)}`,
+        `Playtest: ${formatPlaytest(result.playtest)}`,
+        `Place:    ${result.placeName} (PlaceId ${result.placeId}, GameId ${result.gameId})`,
+    ];
+    if (result.viewportSize) {
+        lines.push(`Viewport: ${result.viewportSize[0]}x${result.viewportSize[1]}`);
+    }
+    if (result.window) {
+        const { pid, focused, minimized } = result.window;
+        lines.push(`Window:   pid ${pid}, ${minimized ? 'minimized' : 'open'}, ${focused ? 'focused' : 'not focused'}`);
+    }
+    if (result.studioVersion) {
+        lines.push(`Studio:   ${result.studioVersion}`);
+    }
+    lines.push(`Plugin:   ${result.plugin.version || 'unknown'} ${result.plugin.upToDate
+        ? '(up to date)'
+        : OutputHelper.formatWarning(`(out of date, expected ${result.plugin.expectedVersion}; run 'studio-bridge plugin install')`)}`);
+    return lines.join('\n');
 }
 export const infoCommand = defineCommand({
     group: 'process',
     name: 'info',
-    description: 'Query the current Studio state (mode, place info)',
+    description: 'Report on a Studio session: mode, playtest, place, window and plugin version',
     category: 'execution',
     safety: 'read',
     scope: 'session',
@@ -33,6 +137,6 @@ export const infoCommand = defineCommand({
     cli: {
         format: formatStateText,
     },
-    handler: async (session) => queryStateHandlerAsync(session),
+    handler: async (session, _args, connection) => queryStateHandlerAsync(session, connection),
 });
 //# sourceMappingURL=info.js.map

package/dist/src/commands/process/info/info.js.map

@@ -1 +1 @@
-{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../../../src/commands/process/info/info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;IAE/C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,SAAS,MAAM,CAAC,KAAK,YAAY,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,OAAO,GAAG;KACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO;QACL,YAAY,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACzC,YAAY,MAAM,CAAC,SAAS,EAAE;QAC9B,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,YAAY,MAAM,CAAC,MAAM,EAAE;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,mDAAmD;IAChE,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,EAAE;IACR,GAAG,EAAE;QACH,MAAM,EAAE,eAAe;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC;CAC5D,CAAC,CAAC"}
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../../../src/commands/process/info/info.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/process/info/info.test.js

@@ -2,57 +2,159 @@
  * Unit tests for the info (state) command handler.
  */
 import { describe, it, expect, vi } from 'vitest';
-import { queryStateHandlerAsync } from './info.js';
-function createMockSession(stateResult) {
+vi.mock('../../../process/studio-process-closer.js', async (importOriginal) => {
+    const actual = await importOriginal();
     return {
-        queryStateAsync: vi.fn().mockResolvedValue(stateResult),
+        ...actual,
+        listStudioProcessesAsync: vi.fn(async () => [
+            { pid: 42, windowTitle: 'C:/places/TestPlace - Roblox Studio' },
+        ]),
     };
+});
+vi.mock('../../../process/studio-window-state.js', () => ({
+    tryGetStudioWindowStateAsync: vi.fn(async () => ({
+        focused: true,
+        minimized: false,
+    })),
+}));
+vi.mock('../../../plugin/plugin-build-version.js', () => ({
+    getPluginBuildVersionAsync: async () => 'abc123',
+}));
+import { describePlaytest, formatStateText, queryStateHandlerAsync, } from './info.js';
+function sessionInfo(sessionId, context, overrides = {}) {
+    return {
+        sessionId,
+        instanceId: 'test-place-3f9a',
+        context,
+        origin: 'user',
+        placeName: 'TestPlace',
+        pluginVersion: 'abc123',
+        connectedAt: new Date('2026-10-27T18:00:00Z'),
+        ...overrides,
+    };
+}
+function createMockSession(stateResult, infoOverrides = {}) {
+    return {
+        info: sessionInfo('test-place-3f9a-edit', 'edit', infoOverrides),
+        queryStateAsync: vi.fn().mockResolvedValue({
+            state: 'Edit',
+            placeId: 12345,
+            placeName: 'TestPlace',
+            gameId: 67890,
+            ...stateResult,
+        }),
+    };
+}
+function createConnection(sessions) {
+    return { listSessions: () => sessions };
 }
 describe('queryStateHandlerAsync', () => {
-    it('returns state result with summary', async () => {
-        const session = createMockSession({
+    it('reports the session, place and run mode', async () => {
+        const session = createMockSession({ studioVersion: '0.744.0.7440803' });
+        const result = await queryStateHandlerAsync(session);
+        expect(result).toMatchObject({
+            sessionId: 'test-place-3f9a-edit',
+            instanceId: 'test-place-3f9a',
+            context: 'edit',
+            origin: 'user',
             state: 'Edit',
             placeId: 12345,
             placeName: 'TestPlace',
             gameId: 67890,
+            studioVersion: '0.744.0.7440803',
+            connectedAt: '2026-10-27T18:00:00.000Z',
         });
-        const result = await queryStateHandlerAsync(session);
-        expect(result.state).toBe('Edit');
-        expect(result.placeId).toBe(12345);
-        expect(result.placeName).toBe('TestPlace');
-        expect(result.gameId).toBe(67890);
-        expect(result.summary).toContain('Edit');
-        expect(result.summary).toContain('TestPlace');
-        expect(result.summary).toContain('12345');
-    });
-    it('calls session.queryStateAsync', async () => {
-        const session = createMockSession({
-            state: 'Play',
-            placeId: 100,
-            placeName: 'GamePlace',
-            gameId: 200,
+        expect(result.summary).toBe('Mode: Edit, Place: TestPlace (12345)');
+    });
+    it('compares the plugin version with the one the CLI installs', async () => {
+        const current = await queryStateHandlerAsync(createMockSession({}));
+        const stale = await queryStateHandlerAsync(createMockSession({}, { pluginVersion: 'old999' }));
+        expect(current.plugin).toEqual({
+            version: 'abc123',
+            expectedVersion: 'abc123',
+            upToDate: true,
+        });
+        expect(stale.plugin.upToDate).toBe(false);
+        expect(formatStateText(stale)).toContain("out of date, expected abc123; run 'studio-bridge plugin install'");
+    });
+    it("reports the playtest running in the session's Studio", async () => {
+        const session = createMockSession({});
+        const connection = createConnection([
+            session.info,
+            sessionInfo('test-place-3f9a-server', 'server'),
+            sessionInfo('test-place-3f9a-client', 'client', {
+                playerName: 'Player1',
+            }),
+        ]);
+        const result = await queryStateHandlerAsync(session, connection);
+        expect(result.playtest).toEqual({
+            mode: 'play',
+            playerCount: undefined,
+            sessions: [
+                {
+                    sessionId: 'test-place-3f9a-server',
+                    context: 'server',
+                    playerName: undefined,
+                },
+                {
+                    sessionId: 'test-place-3f9a-client',
+                    context: 'client',
+                    playerName: 'Player1',
+                },
+            ],
+        });
+        expect(formatStateText(result)).toContain('Playtest: running (play mode): test-place-3f9a-server, test-place-3f9a-client');
+    });
+    it("finds a playtest's window by its DataModel's name, not the edit window", async () => {
+        const session = createMockSession({ state: 'Server', placeName: 'TestPlace' }, { sessionId: 'test-place-3f9a-server', context: 'server' });
+        const connection = createConnection([
+            sessionInfo('test-place-3f9a-edit', 'edit'),
+            session.info,
+            sessionInfo('test-place-3f9a-client-player1', 'client'),
+            sessionInfo('test-place-3f9a-client-player2', 'client'),
+        ]);
+        const result = await queryStateHandlerAsync(session, connection);
+        expect(result.window?.pid).toBe(42);
+        session.queryStateAsync.mockResolvedValue({
+            state: 'Server',
+            placeId: 0,
+            placeName: 'Server',
+            gameId: 0,
         });
-        await queryStateHandlerAsync(session);
-        expect(session.queryStateAsync).toHaveBeenCalledOnce();
-    });
-    it('handles different state values correctly', async () => {
-        for (const state of ['Edit', 'Play', 'Paused', 'Run', 'Server', 'Client']) {
-            const session = createMockSession({
-                state,
-                placeId: 1,
-                placeName: 'Place',
-                gameId: 2,
-            });
-            const result = await queryStateHandlerAsync(session);
-            expect(result.state).toBe(state);
-            expect(result.summary).toContain(state);
-        }
+        const unmatched = await queryStateHandlerAsync(session, connection);
+        expect(unmatched.window).toBeUndefined();
     });
     it('propagates errors from session', async () => {
-        const session = {
-            queryStateAsync: vi.fn().mockRejectedValue(new Error('Connection lost')),
-        };
+        const session = createMockSession({});
+        session.queryStateAsync.mockRejectedValue(new Error('Connection lost'));
         await expect(queryStateHandlerAsync(session)).rejects.toThrow('Connection lost');
     });
+    it('reports the window showing the place', async () => {
+        const result = await queryStateHandlerAsync(createMockSession({}));
+        expect(result.window).toEqual({ pid: 42, focused: true, minimized: false });
+        expect(formatStateText(result)).toContain('Window:   pid 42, open, focused');
+    });
+    it('leaves the window out when no window shows the place', async () => {
+        const result = await queryStateHandlerAsync(createMockSession({ placeName: 'Elsewhere' }));
+        expect(result.window).toBeUndefined();
+    });
+});
+describe('describePlaytest', () => {
+    it('is absent without playtest sessions', () => {
+        expect(describePlaytest([sessionInfo('test-place-3f9a-edit', 'edit')], 'test-place-3f9a')).toBeUndefined();
+    });
+    it('reports run mode when only the server connected', () => {
+        expect(describePlaytest([sessionInfo('test-place-3f9a-server', 'server')], 'test-place-3f9a')?.mode).toBe('run');
+    });
+    it('counts the players of a multiplayer test', () => {
+        const playtest = describePlaytest([
+            sessionInfo('test-place-3f9a-server', 'server'),
+            sessionInfo('test-place-3f9a-client-player1', 'client'),
+            sessionInfo('test-place-3f9a-client-player2', 'client'),
+            sessionInfo('other-1a2b-server', 'server', { instanceId: 'other' }),
+        ], 'test-place-3f9a');
+        expect(playtest?.playerCount).toBe(2);
+        expect(playtest?.sessions).toHaveLength(3);
+    });
 });
 //# sourceMappingURL=info.test.js.map