@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/server/web-socket-protocol.smoke.test.js

@@ -1,196 +0,0 @@
-/**
- * WebSocket smoke test — validates the entire server-side protocol by
- * simulating the plugin with a Node.js WebSocket client. No Studio needed.
- */
-import { describe, it, expect } from 'vitest';
-import { WebSocketServer, WebSocket } from 'ws';
-import { encodeMessage, decodePluginMessage, } from './web-socket-protocol.js';
-/**
- * Helper: start a minimal WebSocket server that behaves like StudioBridge's
- * internal server, returning the port and a promise for the result.
- */
-function createTestServer(expectedSessionId) {
-    const wss = new WebSocketServer({ port: 0, path: `/${expectedSessionId}` });
-    const logLines = [];
-    const resultPromise = new Promise((resolve) => {
-        wss.on('connection', (ws) => {
-            ws.on('message', (raw) => {
-                const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
-                const msg = decodePluginMessage(data);
-                if (!msg)
-                    return;
-                if (msg.sessionId !== expectedSessionId)
-                    return;
-                switch (msg.type) {
-                    case 'hello':
-                        if (msg.payload.sessionId === expectedSessionId) {
-                            ws.send(encodeMessage({
-                                type: 'welcome',
-                                sessionId: expectedSessionId,
-                                payload: { sessionId: expectedSessionId },
-                            }));
-                        }
-                        break;
-                    case 'output':
-                        for (const entry of msg.payload.messages) {
-                            logLines.push(entry.body);
-                        }
-                        break;
-                    case 'scriptComplete':
-                        resolve({
-                            success: msg.payload.success,
-                            logs: logLines.join('\n'),
-                        });
-                        break;
-                }
-            });
-        });
-    });
-    const port = new Promise((resolve) => {
-        wss.on('listening', () => {
-            const addr = wss.address();
-            if (typeof addr === 'object' && addr !== null) {
-                resolve(addr.port);
-            }
-        });
-    });
-    return { wss, port, resultPromise };
-}
-describe('WebSocket protocol smoke test', () => {
-    it('completes full handshake → output → scriptComplete lifecycle', async () => {
-        const sessionId = 'test-session-123';
-        const { wss, port: portPromise, resultPromise, } = createTestServer(sessionId);
-        try {
-            const port = await portPromise;
-            // Simulate the plugin side with a plain WebSocket client
-            const ws = new WebSocket(`ws://localhost:${port}/${sessionId}`);
-            await new Promise((resolve, reject) => {
-                ws.on('open', resolve);
-                ws.on('error', reject);
-            });
-            // 1. Send hello
-            ws.send(JSON.stringify({ type: 'hello', sessionId, payload: { sessionId } }));
-            // 2. Wait for welcome
-            const welcome = await new Promise((resolve) => {
-                ws.on('message', (raw) => {
-                    const data = JSON.parse(typeof raw === 'string' ? raw : raw.toString('utf-8'));
-                    if (data.type === 'welcome') {
-                        resolve(data);
-                    }
-                });
-            });
-            expect(welcome.type).toBe('welcome');
-            expect(welcome.sessionId).toBe(sessionId);
-            expect(welcome.payload.sessionId).toBe(sessionId);
-            // 3. Send some output
-            ws.send(JSON.stringify({
-                type: 'output',
-                sessionId,
-                payload: {
-                    messages: [
-                        { level: 'Print', body: 'Hello from test' },
-                        { level: 'Warning', body: 'Test warning' },
-                    ],
-                },
-            }));
-            // 4. Send scriptComplete
-            ws.send(JSON.stringify({
-                type: 'scriptComplete',
-                sessionId,
-                payload: { success: true },
-            }));
-            // 5. Verify result
-            const result = await resultPromise;
-            expect(result.success).toBe(true);
-            expect(result.logs).toContain('Hello from test');
-            expect(result.logs).toContain('Test warning');
-            ws.close();
-        }
-        finally {
-            wss.close();
-        }
-    });
-    it('handles failed script execution', async () => {
-        const sessionId = 'fail-session';
-        const { wss, port: portPromise, resultPromise, } = createTestServer(sessionId);
-        try {
-            const port = await portPromise;
-            const ws = new WebSocket(`ws://localhost:${port}/${sessionId}`);
-            await new Promise((resolve, reject) => {
-                ws.on('open', resolve);
-                ws.on('error', reject);
-            });
-            ws.send(JSON.stringify({ type: 'hello', sessionId, payload: { sessionId } }));
-            // Wait for welcome before sending more
-            await new Promise((resolve) => {
-                ws.on('message', (raw) => {
-                    const data = JSON.parse(typeof raw === 'string' ? raw : raw.toString('utf-8'));
-                    if (data.type === 'welcome')
-                        resolve();
-                });
-            });
-            ws.send(JSON.stringify({
-                type: 'output',
-                sessionId,
-                payload: {
-                    messages: [{ level: 'Error', body: 'Something went wrong' }],
-                },
-            }));
-            ws.send(JSON.stringify({
-                type: 'scriptComplete',
-                sessionId,
-                payload: { success: false, error: 'Script threw an error' },
-            }));
-            const result = await resultPromise;
-            expect(result.success).toBe(false);
-            expect(result.logs).toContain('Something went wrong');
-            ws.close();
-        }
-        finally {
-            wss.close();
-        }
-    });
-    it('rejects hello with wrong session ID', async () => {
-        const sessionId = 'correct-session';
-        const wss = new WebSocketServer({ port: 0, path: `/${sessionId}` });
-        try {
-            const port = await new Promise((resolve) => {
-                wss.on('listening', () => {
-                    const addr = wss.address();
-                    if (typeof addr === 'object' && addr !== null)
-                        resolve(addr.port);
-                });
-            });
-            let welcomeSent = false;
-            wss.on('connection', (ws) => {
-                ws.on('message', (raw) => {
-                    const data = typeof raw === 'string' ? raw : raw.toString('utf-8');
-                    const msg = decodePluginMessage(data);
-                    if (msg?.type === 'hello' && msg.sessionId === sessionId && msg.payload.sessionId === sessionId) {
-                        welcomeSent = true;
-                        ws.send(encodeMessage({ type: 'welcome', sessionId, payload: { sessionId } }));
-                    }
-                });
-            });
-            const ws = new WebSocket(`ws://localhost:${port}/${sessionId}`);
-            await new Promise((resolve, reject) => {
-                ws.on('open', resolve);
-                ws.on('error', reject);
-            });
-            // Send hello with wrong session ID
-            ws.send(JSON.stringify({
-                type: 'hello',
-                sessionId: 'wrong-session',
-                payload: { sessionId: 'wrong-session' },
-            }));
-            // Give the server time to process
-            await new Promise((resolve) => setTimeout(resolve, 100));
-            expect(welcomeSent).toBe(false);
-            ws.close();
-        }
-        finally {
-            wss.close();
-        }
-    });
-});
-//# sourceMappingURL=web-socket-protocol.smoke.test.js.map

package/dist/src/server/web-socket-protocol.smoke.test.js.map

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

package/src/cli/commands/exec-command.ts

@@ -1,48 +0,0 @@
-/**
- * `studio-bridge exec <code>` — execute inline Luau code in Roblox Studio.
- */
-
-import { Argv, CommandModule } from 'yargs';
-import { OutputHelper } from '@quenty/cli-output-helpers';
-import type { StudioBridgeGlobalArgs } from '../args/global-args.js';
-import {
-  executeScriptAsync,
-  resolvePlacePathAsync,
-} from '../script-executor.js';
-
-export interface ExecArgs extends StudioBridgeGlobalArgs {
-  code: string;
-}
-
-export class ExecCommand<T> implements CommandModule<T, ExecArgs> {
-  public command = 'exec <code>';
-  public describe = 'Execute inline Luau code in Roblox Studio';
-
-  public builder = (args: Argv<T>) => {
-    args.positional('code', {
-      describe: 'Luau code to execute',
-      type: 'string',
-      demandOption: true,
-    });
-
-    return args as Argv<ExecArgs>;
-  };
-
-  public handler = async (args: ExecArgs) => {
-    try {
-      const placePath = await resolvePlacePathAsync(args.place);
-
-      await executeScriptAsync({
-        scriptContent: args.code,
-        packageName: 'script',
-        placePath,
-        timeoutMs: args.timeout,
-        verbose: args.verbose,
-        showLogs: args.logs,
-      });
-    } catch (err) {
-      OutputHelper.error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  };
-}

package/src/cli/commands/run-command.ts

@@ -1,63 +0,0 @@
-/**
- * `studio-bridge run <file>` — execute a Luau script file in Roblox Studio.
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { Argv, CommandModule } from 'yargs';
-import { OutputHelper } from '@quenty/cli-output-helpers';
-import type { StudioBridgeGlobalArgs } from '../args/global-args.js';
-import {
-  executeScriptAsync,
-  resolvePlacePathAsync,
-} from '../script-executor.js';
-
-export interface RunArgs extends StudioBridgeGlobalArgs {
-  file: string;
-}
-
-export class RunCommand<T> implements CommandModule<T, RunArgs> {
-  public command = 'run <file>';
-  public describe = 'Execute a Luau script file in Roblox Studio';
-
-  public builder = (args: Argv<T>) => {
-    args.positional('file', {
-      describe: 'Path to a Luau script file',
-      type: 'string',
-      demandOption: true,
-    });
-
-    return args as Argv<RunArgs>;
-  };
-
-  public handler = async (args: RunArgs) => {
-    try {
-      const scriptPath = path.resolve(args.file);
-      let scriptContent: string;
-      try {
-        scriptContent = await fs.readFile(scriptPath, 'utf-8');
-      } catch {
-        OutputHelper.error(`Could not read script file: ${scriptPath}`);
-        process.exit(1);
-      }
-
-      const placePath = await resolvePlacePathAsync(args.place);
-      const packageName = path.basename(
-        args.file,
-        path.extname(args.file)
-      );
-
-      await executeScriptAsync({
-        scriptContent,
-        packageName,
-        placePath,
-        timeoutMs: args.timeout,
-        verbose: args.verbose,
-        showLogs: args.logs,
-      });
-    } catch (err) {
-      OutputHelper.error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  };
-}

package/src/cli/commands/terminal/terminal-command.ts

@@ -1,54 +0,0 @@
-/**
- * `studio-bridge terminal` — interactive REPL mode for executing Luau
- * scripts repeatedly in a persistent Studio session.
- */
-
-import { Argv, CommandModule } from 'yargs';
-import { OutputHelper } from '@quenty/cli-output-helpers';
-import type { StudioBridgeGlobalArgs } from '../../args/global-args.js';
-import { resolvePlacePathAsync } from '../../script-executor.js';
-
-export interface TerminalArgs extends StudioBridgeGlobalArgs {
-  script?: string;
-  'script-text'?: string;
-}
-
-export class TerminalCommand<T> implements CommandModule<T, TerminalArgs> {
-  public command = 'terminal';
-  public describe =
-    'Interactive terminal mode — keep Studio alive and execute scripts via REPL';
-
-  public builder = (args: Argv<T>) => {
-    args.option('script', {
-      alias: 's',
-      describe: 'Path to a Luau script to run on connect',
-      type: 'string',
-    });
-
-    args.option('script-text', {
-      alias: 't',
-      describe: 'Inline Luau code to run on connect',
-      type: 'string',
-    });
-
-    return args as Argv<TerminalArgs>;
-  };
-
-  public handler = async (args: TerminalArgs) => {
-    try {
-      const placePath = await resolvePlacePathAsync(args.place);
-
-      const { runTerminalMode } = await import('./terminal-mode.js');
-      await runTerminalMode({
-        placePath,
-        scriptPath: args.script,
-        scriptText: args['script-text'],
-        timeoutMs: args.timeout,
-        verbose: args.verbose,
-      });
-    } catch (err) {
-      OutputHelper.error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-  };
-}