Method mkdir

packages/kaos/src/ssh.ts:769–793

(path: string, options?: { parents?: boolean; existOk?: boolean })

  }

  async mkdir(path: string, options?: { parents?: boolean; existOk?: boolean }): Promise<void> {
    const resolved = this._resolvePath(path);
    const parents = options?.parents ?? false;
    const existOk = options?.existOk ?? false;

    if (parents) {
      await this._mkdirRecursive(resolved, existOk);
    } else {
      const exists = await sftpExists(this._sftp, resolved);
      if (exists) {
        if (!existOk) {
          throw new KaosFileExistsError(`${resolved} already exists`);
        }
        // `existOk` only applies when the conflicting path is itself a
        // directory. A regular file sitting at the target path is still
        // a conflict — we must not pretend mkdir succeeded.
        const st = await sftpStat(this._sftp, resolved);
        if (!st.isDirectory()) {
          throw new KaosFileExistsError(`${resolved} already exists but is not a directory`);
        }
        return;
      }
      await sftpMkdir(this._sftp, resolved);
    }
  }

  private async _mkdirRecursive(path: string, existOk: boolean): Promise<void> {
    // Split path into components and create each level.