@jsenv/util/src/writeDirectory.js

Set of functions often needed when using Node.js.

import { promises } from "fs"
import { statsToType } from "./internal/statsToType.js"
import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
import { readFileSystemNodeStat } from "./readFileSystemNodeStat.js"

// https://nodejs.org/dist/latest-v13.x/docs/api/fs.html#fs_fspromises_mkdir_path_options
const { mkdir } = promises

export const writeDirectory = async (
  destination,
  { recursive = true, allowUseless = false } = {},
) => {
  const destinationUrl = assertAndNormalizeDirectoryUrl(destination)
  const destinationPath = urlToFileSystemPath(destinationUrl)

  const destinationStats = await readFileSystemNodeStat(destinationUrl, {
    nullIfNotFound: true,
    followLink: false,
  })

  if (destinationStats) {
    if (destinationStats.isDirectory()) {
      if (allowUseless) {
        return
      }
      throw new Error(`directory already exists at ${destinationPath}`)
    }

    const destinationType = statsToType(destinationStats)
    throw new Error(
      `cannot write directory at ${destinationPath} because there is a ${destinationType}`,
    )
  }

  try {
    await mkdir(destinationPath, { recursive })
  } catch (error) {
    if (allowUseless && error.code === "EEXIST") {
      return
    }
    throw error
  }
}