jackwener--opencli/tests/e2e/helpers.ts

/**
 * Shared helpers for E2E tests.
 * Runs the built opencli binary as a subprocess.
 */

import { execFile } from 'node:child_process';
import { promisify } from 'node:util';
import * as path from 'node:path';
import { fileURLToPath } from 'node:url';

const exec = promisify(execFile);
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(__dirname, '../..');
const MAIN = path.join(ROOT, 'dist', 'src', 'main.js');

/**
 * Default stdout cap for `runCli`. `opencli list -f json` already weighs
 * ~1 MB at 1030 entries on v1.8.2 and grows with every new adapter. The
 * execFile default maxBuffer is 1 MB; past it stdout overflows and the
 * helper returns code 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER' instead of the
 * actual exit code.
 */
const DEFAULT_MAX_BUFFER_BYTES = 16 * 1024 * 1024;

export interface CliResult {
  stdout: string;
  stderr: string;
  code: number;
}

/**
 * Run `opencli` as a child process with the given arguments.
 * Without PLAYWRIGHT_MCP_EXTENSION_TOKEN, opencli auto-launches its own browser.
 */
export async function runCli(
  args: string[],
  opts: { timeout?: number; env?: Record<string, string>; maxBuffer?: number } = {},
): Promise<CliResult> {
  // Keep the child timeout below the common 30s Vitest timeout so flaky
  // network commands return a structured non-zero result instead of killing
  // the whole test at the framework layer.
  const timeout = opts.timeout ?? 25_000;
  const maxBuffer = opts.maxBuffer ?? DEFAULT_MAX_BUFFER_BYTES;
  try {
    const runtime = process.env.OPENCLI_TEST_RUNTIME || 'node';
    const { stdout, stderr } = await exec(runtime, [MAIN, ...args], {
      cwd: ROOT,
      timeout,
      maxBuffer,
      env: {
        ...process.env,
        // Prevent chalk colors from polluting test assertions
        FORCE_COLOR: '0',
        NO_COLOR: '1',
        ...opts.env,
      },
    });
    return { stdout, stderr, code: 0 };
  } catch (err: any) {
    return {
      stdout: err.stdout ?? '',
      stderr: err.stderr ?? '',
      code: err.code ?? 1,
    };
  }
}

/**
 * Parse JSON output from a CLI command.
 * Throws a descriptive error if parsing fails.
 */
export function parseJsonOutput(stdout: string): any {
  try {
    return JSON.parse(stdout.trim());
  } catch {
    throw new Error(`Failed to parse CLI JSON output:\n${stdout.slice(0, 500)}`);
  }
}