Function attachTmuxClient

src/testing/tmuxHarness.ts:255–312

(
  session: IsolatedTmuxSession,
  opts?: { timeoutMs?: number },
)

}

export async function attachTmuxClient(
  session: IsolatedTmuxSession,
  opts?: { timeoutMs?: number },
): Promise<TmuxAttachedClient> {
  const attachCommand =
    `tmux -L ${shellQuote(session.socketName)} ` +
    `attach-session -t ${shellQuote(session.sessionName)}`
  const env = getTmuxTestEnv()
  if (!env.TERM || env.TERM === 'dumb') {
    env.TERM = 'xterm-256color'
  }
  const process = spawn(
    'script',
    ['-q', '-e', '-f', '-c', attachCommand, '/dev/null'],
    {
      env,
      stdio: 'pipe',
    },
  )

  if (!process.stdin || !process.stdout || !process.stderr) {
    throw new Error('Failed to spawn attached tmux client')
  }

  let attachOutput = ''
  process.stdout.setEncoding('utf8')
  process.stderr.setEncoding('utf8')
  process.stdout.on('data', chunk => {
    attachOutput += chunk
  })
  process.stderr.on('data', chunk => {
    attachOutput += chunk
  })

  const timeoutMs = opts?.timeoutMs ?? 2000
  const deadline = Date.now() + timeoutMs
  while (Date.now() < deadline) {
    if (process.exitCode !== null) {
      const details =
        attachOutput.trim().length > 0
          ? `: ${attachOutput.trim().replaceAll('\n', ' | ')}`
          : ''
      throw new Error(
        `Attached tmux client exited early (${process.exitCode})${details}`,
      )
    }
    if (countAttachedClients(session) > 0) {
      return { process }
    }
    await delay(20)
  }

  process.kill('SIGTERM')
  throw new Error(
    `Timed out waiting for tmux client attach on socket ${session.socketName}. ` +
      `attach output=${JSON.stringify(attachOutput.trim())}`,
  )
}