@jsenv/util/src/assertAndNormalizeDirectoryUrl.js

Set of functions often needed when using Node.js.

import { ensureUrlTrailingSlash } from "./internal/ensureUrlTrailingSlash.js"
import { isFileSystemPath } from "./isFileSystemPath.js"
import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"

export const assertAndNormalizeDirectoryUrl = (value) => {
  let urlString

  if (value instanceof URL) {
    urlString = value.href
  } else if (typeof value === "string") {
    if (isFileSystemPath(value)) {
      urlString = fileSystemPathToUrl(value)
    } else {
      try {
        urlString = String(new URL(value))
      } catch (e) {
        throw new TypeError(`directoryUrl must be a valid url, received ${value}`)
      }
    }
  } else {
    throw new TypeError(`directoryUrl must be a string or an url, received ${value}`)
  }

  if (!urlString.startsWith("file://")) {
    throw new Error(`directoryUrl must starts with file://, received ${value}`)
  }

  return ensureUrlTrailingSlash(urlString)
}