// Type definitions for execa 0.7
// Project: https://github.com/sindresorhus/execa#readme
// Definitions by: Douglas Duteil <https://github.com/douglasduteil>
//                 BendingBender <https://github.com/BendingBender>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
// TypeScript Version: 2.3

/// <reference types="node" />

import { ChildProcess, ExecOptions, SpawnOptions, SpawnSyncOptions } from "child_process";
import { Stream } from 'stream';

type StdIOOption = 'pipe' | 'ipc' | 'ignore' | number | Stream | undefined | null;

interface ExecaOptions {
    input: string | Buffer | Stream;
    preferLocal: boolean;
    stripEof: boolean;
    extendEnv: boolean;
    argv0: string;
    localDir: string;
    reject: boolean;
    cleanup: boolean;
    stdin: StdIOOption;
    stdout: StdIOOption;
    stderr: StdIOOption;
}

type Options = SpawnOptions & ExecaOptions & ExecOptions;
type SyncOptions = SpawnSyncOptions & ExecaOptions & ExecOptions;

interface ExecaReturns {
    cmd: string;
    code: number;
    failed: boolean;
    killed: boolean;
    signal: string | null;
    stderr: string;
    stdout: string;
    timedOut: boolean;
}

type ExecaError = Error & ExecaReturns;

interface ExecaChildPromise {
    catch<TResult = never>(onrejected?: ((reason: ExecaError) => TResult | PromiseLike<TResult>) | undefined | null): Promise<ExecaReturns | TResult>;
}
type ExecaChildProcess = ChildProcess & ExecaChildPromise & Promise<ExecaReturns>;

declare function execa(file: string, options?: Partial<Options>): ExecaChildProcess;
declare function execa(file: string, args?: string[], options?: Partial<Options>): ExecaChildProcess;
declare namespace execa {
    function stdout(file: string, options?: Partial<Options>): Promise<string>;
    function stdout(file: string, args?: string[], options?: Partial<Options>): Promise<string>;
    function stderr(file: string, options?: Partial<Options>): Promise<string>;
    function stderr(file: string, args?: string[], options?: Partial<Options>): Promise<string>;
    function shell(command: string, options?: Partial<Options>): ExecaChildProcess;
    function sync<T = string>(file: string, options?: Partial<SyncOptions>): ExecaReturns;
    function sync<T = string>(file: string, args?: string[], options?: Partial<SyncOptions>): ExecaReturns;
    function shellSync(command: string, options?: Partial<Options>): ExecaReturns;
}

export = execa;