@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/linux/linux-credential-writer.js

@@ -0,0 +1,300 @@
+/**
+ * Inject Roblox authentication credentials into Wine's Credential Manager.
+ *
+ * Studio expects three entries in Windows Credential Manager:
+ * 1. userid: RobloxStudioAuthuserid → numeric user ID
+ * 2. cookie name: RobloxStudioAuthCookies → ".ROBLOSECURITY"
+ * 3. cookie value: RobloxStudioAuth.ROBLOSECURITY{userId} → the actual cookie
+ *
+ * Additionally, Studio 0.710+ uses OAuth2 for startup authentication.
+ * Without a valid refresh token, Studio blocks on a WebView2 login dialog
+ * that doesn't work under Wine. This module obtains a refresh token by
+ * calling Roblox's first-party OAuth authorization endpoint with the
+ * .ROBLOSECURITY cookie, then injects it into the Credential Manager.
+ *
+ * This module:
+ * - Compiles write-cred.c with MinGW (if not already compiled)
+ * - Resolves the user ID from the cookie via Roblox API
+ * - Obtains an OAuth2 refresh token via Roblox's authorization endpoint
+ * - Runs `wine write-cred.exe` to inject all credential entries
+ */
+import * as crypto from 'crypto';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execFileSync } from 'child_process';
+import { execa } from 'execa';
+import { fileURLToPath } from 'url';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { ROBLOX_USERS_API } from './linux-config.js';
+import { buildWineEnv } from './linux-wine-env.js';
+import { COOKIE_NAME } from '@quenty/nevermore-cli-helpers';
+/** Studio's first-party OAuth client ID (extracted from the Studio binary) */
+const STUDIO_OAUTH_CLIENT_ID = '7968549422692352298';
+/** Roblox OAuth API base */
+const ROBLOX_OAUTH_API = 'https://apis.roblox.com/oauth/v1';
+/** Roblox Auth API base (for CSRF tokens) */
+const ROBLOX_AUTH_API = 'https://auth.roblox.com';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Locate write-cred.c source file. Searches several candidate paths
+ * relative to __dirname, which at runtime is dist/src/linux/.
+ */
+async function findWriteCredSourceAsync() {
+    const candidates = [
+        // Alongside compiled JS (if .c was copied to dist)
+        path.join(__dirname, 'write-cred.c'),
+        // Source tree (from dist/src/linux/ → src/linux/)
+        path.resolve(__dirname, '../../../src/linux/write-cred.c'),
+        // Sibling to package root
+        path.resolve(__dirname, '../../linux/write-cred.c'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch {
+            // Try next
+        }
+    }
+    throw new Error('write-cred.c source not found. Ensure the linux module is properly installed.');
+}
+/**
+ * Compile write-cred.exe from bundled C source using MinGW.
+ */
+export async function compileWriteCredAsync(config) {
+    const { writeCredExe } = config;
+    const sourcePath = await findWriteCredSourceAsync();
+    OutputHelper.verbose(`Compiling ${sourcePath} → ${writeCredExe}`);
+    await fs.mkdir(path.dirname(writeCredExe), { recursive: true });
+    try {
+        execFileSync('x86_64-w64-mingw32-gcc', ['-o', writeCredExe, sourcePath, '-lcredui', '-ladvapi32'], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 30000,
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to compile write-cred.exe: ${error instanceof Error ? error.message : error}`);
+    }
+    OutputHelper.verbose('write-cred.exe compiled successfully.');
+}
+/**
+ * Inject all three required credentials into Wine's Credential Manager.
+ */
+export async function injectCredentialsAsync(options) {
+    const { cookie, config } = options;
+    // Always recompile write-cred.exe from source to ensure it matches the
+    // current code (e.g. batch-mode support). A stale binary from a Docker
+    // image may silently ignore extra arguments.
+    await compileWriteCredAsync(config);
+    // Resolve user ID from cookie
+    const userId = await resolveUserIdAsync(cookie);
+    OutputHelper.verbose(`Resolved user ID: ${userId}`);
+    const env = buildWineEnv(config);
+    const writeCredExe = config.writeCredExe;
+    // Initialize or update the Wine prefix. wineboot must run before any wine
+    // command to create the prefix on first use, and must also run in containers
+    // where the prefix was pre-built at image time — the update pass refreshes
+    // stale registry entries and user profile paths for the current environment.
+    const prefixExists = await fs
+        .access(path.join(config.winePrefix, 'system.reg'))
+        .then(() => true, () => false);
+    const winebootFlag = prefixExists ? '-u' : '-i';
+    OutputHelper.verbose(prefixExists
+        ? 'Updating Wine prefix for current environment...'
+        : 'Initializing Wine prefix...');
+    const bootResult = await execa('wineboot', [winebootFlag], {
+        env,
+        reject: false,
+        timeout: 120000,
+    });
+    if (bootResult.exitCode !== 0) {
+        OutputHelper.warn(`wineboot exited with code ${bootResult.exitCode} (non-fatal)`);
+    }
+    // Write all three credential entries in a single Wine invocation
+    const entries = [
+        ['https://www.roblox.com:RobloxStudioAuthuserid', String(userId)],
+        ['https://www.roblox.com:RobloxStudioAuthCookies', COOKIE_NAME],
+        [`https://www.roblox.com:RobloxStudioAuth${COOKIE_NAME}${userId}`, cookie],
+    ];
+    OutputHelper.verbose(`Writing ${entries.length} credential entries...`);
+    const credArgs = entries.flatMap(([target, value]) => [target, value]);
+    const result = await execa('wine', [writeCredExe, ...credArgs], {
+        env,
+        reject: false,
+        timeout: 30000,
+    });
+    if (result.exitCode !== 0) {
+        const stderr = result.stderr || result.stdout || 'unknown error';
+        throw new Error(`Failed to write credentials: ${stderr}`);
+    }
+    // Also write to the Windows Registry path that Studio checks on startup.
+    await writeRegistryAuthAsync(cookie, userId, env);
+    // Obtain and inject an OAuth2 refresh token. Studio 0.710+ may require this
+    // for startup authentication — without it, Studio blocks on a WebView2
+    // login dialog that doesn't work under Wine. Non-fatal: cookie-based
+    // credentials above are sufficient for many Studio versions.
+    try {
+        await injectOAuth2RefreshTokenAsync(cookie, userId, writeCredExe, env);
+    }
+    catch (error) {
+        OutputHelper.warn(`OAuth2 refresh token injection failed (non-fatal): ${error instanceof Error ? error.message : error}`);
+    }
+    OutputHelper.info('Credentials injected into Wine Credential Manager.');
+}
+/**
+ * Write auth data to Wine registry entries that Studio checks on startup.
+ * This bypasses Studio's WebView2 login dialog (which doesn't work on Wine).
+ */
+async function writeRegistryAuthAsync(cookie, userId, env) {
+    const regPath = 'HKCU\\Software\\Roblox\\RobloxStudioBrowser\\roblox.com';
+    const regEntries = [
+        [regPath, COOKIE_NAME, cookie],
+    ];
+    for (const [keyPath, name, value] of regEntries) {
+        OutputHelper.verbose(`Writing registry: ${keyPath}\\${name}`);
+        const result = await execa('wine', ['reg', 'add', keyPath, '/v', name, '/t', 'REG_SZ', '/d', value, '/f'], { env, reject: false, timeout: 15000 });
+        if (result.exitCode !== 0) {
+            OutputHelper.warn(`Failed to write registry entry ${name} (non-fatal): ${result.stderr || result.stdout}`);
+        }
+    }
+    // Also set the user ID so Studio recognizes a configured user
+    const userRegPath = 'HKCU\\Software\\Roblox\\RobloxStudioBrowser';
+    const userIdResult = await execa('wine', [
+        'reg',
+        'add',
+        userRegPath,
+        '/v',
+        'UserId',
+        '/t',
+        'REG_SZ',
+        '/d',
+        String(userId),
+        '/f',
+    ], { env, reject: false, timeout: 15000 });
+    if (userIdResult.exitCode !== 0) {
+        OutputHelper.warn(`Failed to write UserId registry entry (non-fatal): ${userIdResult.stderr || userIdResult.stdout}`);
+    }
+}
+/**
+ * Obtain an OAuth2 refresh token from the .ROBLOSECURITY cookie and inject
+ * it into Wine's Credential Manager. This completes Studio's first-party
+ * OAuth PKCE flow programmatically, bypassing the WebView2 login dialog.
+ */
+async function injectOAuth2RefreshTokenAsync(cookie, userId, writeCredExe, env) {
+    OutputHelper.verbose('Obtaining OAuth2 refresh token...');
+    // Step 1: Get CSRF token (Roblox requires this for mutating API calls)
+    const csrfToken = await getCsrfTokenAsync(cookie);
+    // Step 2: Generate PKCE code verifier and challenge
+    const codeVerifier = crypto
+        .randomBytes(32)
+        .toString('base64url')
+        .slice(0, 43);
+    const codeChallenge = crypto
+        .createHash('sha256')
+        .update(codeVerifier)
+        .digest('base64url');
+    const state = crypto.randomBytes(16).toString('hex');
+    // Step 3: Request authorization code
+    const authResponse = await fetch(`${ROBLOX_OAUTH_API}/authorizations`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-CSRF-TOKEN': csrfToken,
+            Cookie: `${COOKIE_NAME}=${cookie}`,
+        },
+        body: JSON.stringify({
+            clientId: STUDIO_OAUTH_CLIENT_ID,
+            responseTypes: ['Code'],
+            redirectUri: 'roblox-studio-auth:/',
+            scopes: [
+                { scopeType: 'openid', operations: ['read'] },
+                { scopeType: 'credentials', operations: ['read'] },
+                { scopeType: 'profile', operations: ['read'] },
+                { scopeType: 'age', operations: ['read'] },
+                { scopeType: 'roles', operations: ['read'] },
+                { scopeType: 'premium', operations: ['read'] },
+            ],
+            nonce: 'id-roblox',
+            codeChallengeMethod: 's256',
+            codeChallenge,
+            state,
+        }),
+    });
+    if (!authResponse.ok) {
+        const body = await authResponse.text();
+        throw new Error(`OAuth authorization failed: ${authResponse.status} ${body}`);
+    }
+    const authData = (await authResponse.json());
+    const locationUrl = new URL(authData.location);
+    const authCode = locationUrl.searchParams.get('code');
+    if (!authCode) {
+        throw new Error('OAuth authorization response missing code');
+    }
+    OutputHelper.verbose('OAuth authorization code obtained.');
+    // Step 4: Exchange authorization code for tokens
+    const tokenResponse = await fetch(`${ROBLOX_OAUTH_API}/token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+            grant_type: 'authorization_code',
+            code: authCode,
+            code_verifier: codeVerifier,
+            client_id: STUDIO_OAUTH_CLIENT_ID,
+        }).toString(),
+    });
+    if (!tokenResponse.ok) {
+        const body = await tokenResponse.text();
+        throw new Error(`OAuth token exchange failed: ${tokenResponse.status} ${body}`);
+    }
+    const tokenData = (await tokenResponse.json());
+    if (!tokenData.refresh_token) {
+        throw new Error('OAuth token response missing refresh_token');
+    }
+    OutputHelper.verbose(`OAuth refresh token obtained (${tokenData.refresh_token.length} chars).`);
+    // Step 5: Inject the refresh token into Wine's Credential Manager
+    const target = `https://www.roblox.com:RobloxStudioAuthoauth2RefreshToken${userId}`;
+    OutputHelper.verbose(`Writing OAuth2 credential: ${target}`);
+    const result = await execa('wine', [writeCredExe, target, tokenData.refresh_token], { env, reject: false, timeout: 15000 });
+    if (result.exitCode !== 0) {
+        const stderr = result.stderr || result.stdout || 'unknown error';
+        throw new Error(`Failed to write OAuth2 refresh token credential: ${stderr}`);
+    }
+    OutputHelper.verbose('OAuth2 refresh token injected into Wine Credential Manager.');
+}
+/**
+ * Get a CSRF token from Roblox's auth API. The first request returns 403
+ * with the token in the x-csrf-token header.
+ */
+async function getCsrfTokenAsync(cookie) {
+    const response = await fetch(`${ROBLOX_AUTH_API}/v1/authentication-ticket/`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Cookie: `${COOKIE_NAME}=${cookie}`,
+            Referer: 'https://www.roblox.com/',
+        },
+        body: '{}',
+    });
+    const csrfToken = response.headers.get('x-csrf-token');
+    if (!csrfToken) {
+        throw new Error(`Failed to obtain CSRF token: ${response.status} ${response.statusText}`);
+    }
+    return csrfToken;
+}
+/**
+ * Resolve the authenticated user's numeric ID from a .ROBLOSECURITY cookie.
+ */
+async function resolveUserIdAsync(cookie) {
+    const response = await fetch(`${ROBLOX_USERS_API}/v1/users/authenticated`, {
+        headers: {
+            Cookie: `${COOKIE_NAME}=${cookie}`,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to resolve user ID: ${response.status} ${response.statusText}. Is your cookie valid?`);
+    }
+    const data = (await response.json());
+    return data.id;
+}
+//# sourceMappingURL=linux-credential-writer.js.map

package/dist/src/linux/linux-credential-writer.js.map

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

package/dist/src/linux/linux-display-manager.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Manage the Xvfb virtual framebuffer and openbox window manager
+ * required for Studio to render under Wine.
+ */
+import type { LinuxStudioConfig } from './linux-config.js';
+/**
+ * Ensure Xvfb is running on the configured DISPLAY.
+ * If already running, this is a no-op.
+ */
+export declare function ensureDisplayAsync(config: LinuxStudioConfig): Promise<void>;
+/**
+ * Ensure openbox window manager is running on the display.
+ * Required for Studio's modal dialogs to function.
+ */
+export declare function ensureWindowManagerAsync(config: LinuxStudioConfig): Promise<void>;
+/**
+ * Check if Xvfb is running on a given display.
+ */
+export declare function isXvfbRunning(displayNum?: string): boolean;
+/**
+ * Check if openbox is running.
+ */
+export declare function isOpenboxRunning(): boolean;
+//# sourceMappingURL=linux-display-manager.d.ts.map

package/dist/src/linux/linux-display-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-display-manager.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-display-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAkB1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAU1C"}

package/dist/src/linux/linux-display-manager.js

@@ -0,0 +1,92 @@
+/**
+ * Manage the Xvfb virtual framebuffer and openbox window manager
+ * required for Studio to render under Wine.
+ */
+import { execSync } from 'child_process';
+import { execa } from 'execa';
+/**
+ * Ensure Xvfb is running on the configured DISPLAY.
+ * If already running, this is a no-op.
+ */
+export async function ensureDisplayAsync(config) {
+    const display = config.display;
+    const displayNum = display.replace(':', '');
+    if (isXvfbRunning(displayNum)) {
+        return;
+    }
+    // Start Xvfb detached with 1024x768 24-bit color
+    const xvfb = execa('Xvfb', [display, '-screen', '0', '1024x768x24'], {
+        detached: true,
+        stdio: 'ignore',
+        reject: false,
+        env: { ...process.env },
+    });
+    xvfb.unref?.();
+    // Give it a moment to start
+    await sleepAsync(500);
+    if (!isXvfbRunning(displayNum)) {
+        throw new Error(`Failed to start Xvfb on display ${display}`);
+    }
+}
+/**
+ * Ensure openbox window manager is running on the display.
+ * Required for Studio's modal dialogs to function.
+ */
+export async function ensureWindowManagerAsync(config) {
+    if (isOpenboxRunning()) {
+        return;
+    }
+    const openbox = execa('openbox', [], {
+        detached: true,
+        stdio: 'ignore',
+        reject: false,
+        env: {
+            ...process.env,
+            DISPLAY: config.display,
+        },
+    });
+    openbox.unref?.();
+    await sleepAsync(500);
+}
+/**
+ * Check if Xvfb is running on a given display.
+ */
+export function isXvfbRunning(displayNum) {
+    try {
+        if (displayNum) {
+            const output = execSync(`pgrep -a Xvfb`, {
+                encoding: 'utf-8',
+                timeout: 3000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return output.includes(`:${displayNum}`);
+        }
+        execSync('pgrep -x Xvfb', {
+            timeout: 3000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if openbox is running.
+ */
+export function isOpenboxRunning() {
+    try {
+        execSync('pgrep -x openbox', {
+            timeout: 3000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleepAsync(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=linux-display-manager.js.map

package/dist/src/linux/linux-display-manager.js.map

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

package/dist/src/linux/linux-env-guard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Environment guard for `linux *` subcommands.
+ *
+ * These commands require Wine and related tools that are only available inside
+ * the Docker image or a properly configured Linux box.  This guard lets them
+ * fail early with a helpful message instead of crashing mid-way.
+ */
+/**
+ * Checks if the current environment can run linux/* commands.
+ * Returns an error message if not, or undefined if OK.
+ */
+export declare function checkLinuxEnvironmentAsync(): Promise<string | undefined>;
+//# sourceMappingURL=linux-env-guard.d.ts.map

package/dist/src/linux/linux-env-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-env-guard.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-env-guard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CACzD,MAAM,GAAG,SAAS,CACnB,CAiBA"}

package/dist/src/linux/linux-env-guard.js

@@ -0,0 +1,31 @@
+/**
+ * Environment guard for `linux *` subcommands.
+ *
+ * These commands require Wine and related tools that are only available inside
+ * the Docker image or a properly configured Linux box.  This guard lets them
+ * fail early with a helpful message instead of crashing mid-way.
+ */
+import * as os from 'os';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+/**
+ * Checks if the current environment can run linux/* commands.
+ * Returns an error message if not, or undefined if OK.
+ */
+export async function checkLinuxEnvironmentAsync() {
+    if (os.platform() !== 'linux') {
+        return "linux commands require a Linux environment. On Windows/macOS, Studio runs natively — use 'studio-bridge process run' instead.";
+    }
+    try {
+        await execFileAsync('which', ['wine']);
+    }
+    catch {
+        return ('Wine is not installed. These commands require Wine and related tools.\n\n' +
+            "To run scripts, use 'studio-bridge process run' which auto-delegates to Docker.\n" +
+            'To set up a full Wine environment, run inside the Docker image:\n' +
+            '  docker run --rm -it ghcr.io/quenty/nevermore-studio-linux:latest bash');
+    }
+    return undefined;
+}
+//# sourceMappingURL=linux-env-guard.js.map

package/dist/src/linux/linux-env-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-env-guard.js","sourceRoot":"","sources":["../../../src/linux/linux-env-guard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAG9C,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,+HAA+H,CAAC;IACzI,CAAC;IAED,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CACL,2EAA2E;YAC3E,mFAAmF;YACnF,mEAAmE;YACnE,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/linux/linux-env-guard.test.d.ts

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

package/dist/src/linux/linux-env-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-env-guard.test.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-env-guard.test.ts"],"names":[],"mappings":""}

package/dist/src/linux/linux-env-guard.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('os', () => ({
+    platform: vi.fn(),
+}));
+vi.mock('child_process', () => ({
+    execFile: vi.fn(),
+}));
+vi.mock('util', () => ({
+    promisify: (fn) => fn,
+}));
+import { platform } from 'os';
+import { execFile } from 'child_process';
+import { checkLinuxEnvironmentAsync } from './linux-env-guard.js';
+const mockPlatform = vi.mocked(platform);
+const mockExecFile = vi.mocked(execFile);
+describe('checkLinuxEnvironmentAsync', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('returns an error message on non-Linux platforms', async () => {
+        mockPlatform.mockReturnValue('win32');
+        const result = await checkLinuxEnvironmentAsync();
+        expect(result).toBeDefined();
+        expect(result).toContain('linux commands require a Linux environment');
+        expect(result).toContain('studio-bridge process run');
+        expect(mockExecFile).not.toHaveBeenCalled();
+    });
+    it('returns undefined when on Linux with Wine installed', async () => {
+        mockPlatform.mockReturnValue('linux');
+        mockExecFile.mockResolvedValue({
+            stdout: '/usr/bin/wine\n',
+            stderr: '',
+        });
+        const result = await checkLinuxEnvironmentAsync();
+        expect(result).toBeUndefined();
+        expect(mockExecFile).toHaveBeenCalledWith('which', ['wine']);
+    });
+    it('returns an error message on Linux without Wine', async () => {
+        mockPlatform.mockReturnValue('linux');
+        mockExecFile.mockRejectedValue(new Error('not found'));
+        const result = await checkLinuxEnvironmentAsync();
+        expect(result).toBeDefined();
+        expect(result).toContain('Wine is not installed');
+        expect(result).toContain('studio-bridge process run');
+        expect(result).toContain('docker run');
+    });
+});
+//# sourceMappingURL=linux-env-guard.test.js.map

package/dist/src/linux/linux-env-guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-env-guard.test.js","sourceRoot":"","sources":["../../../src/linux/linux-env-guard.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACnB,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE;CAC3B,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEzC,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,0BAA0B,EAAE,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,4CAA4C,CAAC,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,YAAY,CAAC,iBAAiB,CAAC;YAC7B,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,EAAE;SACJ,CAAC,CAAC;QAEV,MAAM,MAAM,GAAG,MAAM,0BAA0B,EAAE,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,YAAY,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,0BAA0B,EAAE,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/linux/linux-fflags.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Write the FFlags required for Studio to render correctly under Wine/Mesa.
+ *
+ * Key flags:
+ * - FFlagDebugGraphicsPreferD3D11: Use D3D11 via WineD3D (avoids Wine's
+ *   EGL swapchain bug that breaks DockWidgets in OpenGL mode)
+ * - FFlagDebugGraphicsDisableVulkan/OpenGL/D3D11FL10: Prevent fallback
+ *   to renderers that don't work under Wine
+ * - FIntStudioLowMemoryThresholdPercentage: Disable OOM warning dialog
+ */
+import type { LinuxStudioConfig } from './linux-config.js';
+/**
+ * Write ClientAppSettings.json with the FFlags needed for Wine rendering.
+ * Merges with any existing flags to avoid clobbering user customizations.
+ */
+export declare function writeFflagsAsync(config: LinuxStudioConfig, extraFlags?: Record<string, boolean | number>): Promise<void>;
+//# sourceMappingURL=linux-fflags.d.ts.map

package/dist/src/linux/linux-fflags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-fflags.d.ts","sourceRoot":"","sources":["../../../src/linux/linux-fflags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAU3D;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,EACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/src/linux/linux-fflags.js

@@ -0,0 +1,33 @@
+/**
+ * Write the FFlags required for Studio to render correctly under Wine/Mesa.
+ *
+ * Key flags:
+ * - FFlagDebugGraphicsPreferD3D11: Use D3D11 via WineD3D (avoids Wine's
+ *   EGL swapchain bug that breaks DockWidgets in OpenGL mode)
+ * - FFlagDebugGraphicsDisableVulkan/OpenGL/D3D11FL10: Prevent fallback
+ *   to renderers that don't work under Wine
+ * - FIntStudioLowMemoryThresholdPercentage: Disable OOM warning dialog
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const DEFAULT_FFLAGS = {
+    FFlagDebugGraphicsPreferD3D11: true,
+    FFlagDebugGraphicsDisableVulkan: true,
+    FFlagDebugGraphicsDisableD3D11FL10: true,
+    FFlagDebugGraphicsDisableOpenGL: true,
+    FIntStudioLowMemoryThresholdPercentage: 0,
+};
+/**
+ * Write ClientAppSettings.json with the FFlags needed for Wine rendering.
+ * Merges with any existing flags to avoid clobbering user customizations.
+ */
+export async function writeFflagsAsync(config, extraFlags) {
+    const settingsDir = path.dirname(config.clientSettingsPath);
+    await fs.mkdir(settingsDir, { recursive: true });
+    // Merge defaults + extras
+    const flags = { ...DEFAULT_FFLAGS, ...extraFlags };
+    await fs.writeFile(config.clientSettingsPath, JSON.stringify(flags, null, 2) + '\n', 'utf-8');
+    OutputHelper.verbose(`Wrote ${Object.keys(flags).length} FFlags to ${config.clientSettingsPath}`);
+}
+//# sourceMappingURL=linux-fflags.js.map

package/dist/src/linux/linux-fflags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-fflags.js","sourceRoot":"","sources":["../../../src/linux/linux-fflags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,cAAc,GAAqC;IACvD,6BAA6B,EAAE,IAAI;IACnC,+BAA+B,EAAE,IAAI;IACrC,kCAAkC,EAAE,IAAI;IACxC,+BAA+B,EAAE,IAAI;IACrC,sCAAsC,EAAE,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,UAA6C;IAE7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,0BAA0B;IAC1B,MAAM,KAAK,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,UAAU,EAAE,CAAC;IAEnD,MAAM,EAAE,CAAC,SAAS,CAChB,MAAM,CAAC,kBAAkB,EACzB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACrC,OAAO,CACR,CAAC;IAEF,YAAY,CAAC,OAAO,CAClB,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,cAAc,MAAM,CAAC,kBAAkB,EAAE,CAC5E,CAAC;AACJ,CAAC"}

package/dist/src/linux/linux-fflags.test.d.ts

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

package/dist/src/linux/linux-fflags.test.d.ts.map

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