Method kill

packages/nodebox/src/modules/shell.ts:130–151

* Terminates the shell process.

()

   * Terminates the shell process.
   */
  public async kill(): Promise<void> {
    invariant(
      this.id,
      'Failed to run "kill" on a ShellProcess: there is no process running. Did you forget to run it?'
    );

    /**
     * @note Optimistically (and eagerly) transition the shell to the next state.
     * Shell exit only fails on protocol mismatch or when it's already been killed.
     */
    this.state = 'idle';

    /**
     * @todo I wonder if we should support a custom "exitCode" here
     * or a signal.
     */
    await this.channel.send('shell/exit', { id: this.id }).catch((error) => {
      throw new Error(format('Failed to kill shell with ID "%s"', this.id), { cause: error });
    });

    this.id = undefined;
  }
}