Class ManagedChildProcess

src/back/ManagedChildProcess.ts:43–236

/** Manages a single process. Wrapper around node's ChildProcess. */
// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
export class ManagedChildProcess extends EventEmitter {
  // @TODO Add timeouts for restarting and killing the process (it should give up after some time, like 10 seconds) maybe?

  public id: string;
  public info: INamedBackProcessInfo | IBackProcessInfo;
  /** Process that this is wrapping/managing. */
  private process?: ChildProcess;
  /** If the process is currently being restarted. */
  private _isRestarting = false;
  /** Display name of the service. */
  public readonly name: string;
  /** The current working directory of the process. */
  private readonly cwd: string;
  /** If the process is detached (it is not spawned as a child process of this program). */
  private readonly detached: boolean;
  /** If the process should be restarted if it exits unexpectedly. */
  private autoRestart: boolean;
  /** Number of times the process has auto restarted. Used to prevent infinite loops. */
  private autoRestartCount: number;
  /** Whether to run in a shell */
  private readonly shell: boolean;
  /** Launch with these Environmental Variables */
  private readonly env?: NodeJS.ProcessEnv;
  /** A timestamp of when the process was started. */
  private startTime = 0;
  /** State of the process. */
  private state: ProcessState = ProcessState.STOPPED;

  constructor(id: string, name: string, cwd: string, opts: ProcessOpts, info: INamedBackProcessInfo | IBackProcessInfo) {
    super();
    const { detached, autoRestart, noshell, env } = opts;
    this.id = id;
    this.name = name;
    this.cwd = cwd;
    this.detached = !!detached;
    this.autoRestart = !!autoRestart;
    this.autoRestartCount = 0;
    this.info = info;
    this.shell = !noshell;
    this.env = env;
  }

  /** Get the process ID (or -1 if the process is not running). */
  public getPid(): number {
    return this.process ? this.process.pid : -1;
  }

  /** Get the state of the process. */
  public getState(): ProcessState {
    return this.state;
  }

  /** Get the time timestamp of when the process was started. */
  public getStartTime(): number {
    return this.startTime;
  }

  /**