@jsenv/filesystem 4.3.1 → 4.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/filesystem",
-  "version": "4.3.1",
+  "version": "4.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -33,7 +33,8 @@
   },
   "dependencies": {
     "@jsenv/urls": "2.2.1",
-    "@jsenv/url-meta": "8.1.0",
-    "@jsenv/abort": "4.2.4"
+    "@jsenv/url-meta": "8.2.0",
+    "@jsenv/abort": "4.2.4",
+    "@jsenv/utils": "2.0.1"
   }
 }

package/src/{assertDirectoryPresence.js → assert_directory_presence.js}

@@ -1,8 +1,8 @@
 import { urlToFileSystemPath } from "@jsenv/urls";
 
-import { assertAndNormalizeFileUrl } from "./file_url_validation.js";
-import { statsToType } from "./internal/statsToType.js";
-import { readEntryStat } from "./readEntryStat.js";
+import { assertAndNormalizeFileUrl } from "./path_and_url/file_url_validation.js";
+import { readEntryStat } from "./read_write/stat/read_entry_stat.js";
+import { statsToType } from "./read_write/stat/stats_to_type.js";
 
 export const assertDirectoryPresence = async (source) => {
   const sourceUrl = assertAndNormalizeFileUrl(source);

package/src/{assertFilePresence.js → assert_file_presence.js}

@@ -1,8 +1,8 @@
 import { urlToFileSystemPath } from "@jsenv/urls";
 
-import { assertAndNormalizeFileUrl } from "./file_url_validation.js";
-import { statsToType } from "./internal/statsToType.js";
-import { readEntryStat } from "./readEntryStat.js";
+import { assertAndNormalizeFileUrl } from "./path_and_url/file_url_validation.js";
+import { readEntryStat } from "./read_write/stat/read_entry_stat.js";
+import { statsToType } from "./read_write/stat/stats_to_type.js";
 
 export const assertFilePresence = async (source) => {
   const sourceUrl = assertAndNormalizeFileUrl(source);

package/src/{copyDirectoryContent.js → copy/copy_directory_content.js}

@@ -1,13 +1,13 @@
 import { Abort } from "@jsenv/abort";
 import { urlToFileSystemPath, resolveUrl } from "@jsenv/urls";
 
-import { assertAndNormalizeDirectoryUrl } from "./directory_url_validation.js";
-import { readEntryStat } from "./readEntryStat.js";
-import { readSymbolicLink } from "./readSymbolicLink.js";
-import { readDirectory } from "./readDirectory.js";
-import { copyEntry } from "./copyEntry.js";
-import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js";
-import { statsToType } from "./internal/statsToType.js";
+import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
+import { urlTargetsSameFileSystemPath } from "../path_and_url/url_targets_same_file_system_path.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { readEntryStat } from "../read_write/stat/read_entry_stat.js";
+import { readSymbolicLink } from "../read_write/read_symbolic_link.js";
+import { readDirectory } from "../read_write/read_directory.js";
+import { copyEntry } from "./copy_entry.js";
 
 export const copyDirectoryContent = async ({
   signal = new AbortController().signal,

package/src/copy/copy_directory_content_sync.js

@@ -0,0 +1,90 @@
+import { Abort } from "@jsenv/abort";
+import { urlToFileSystemPath, resolveUrl } from "@jsenv/urls";
+
+import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
+import { urlTargetsSameFileSystemPath } from "../path_and_url/url_targets_same_file_system_path.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { readEntryStatSync } from "../read_write/stat/read_entry_stat_sync.js";
+import { readSymbolicLinkSync } from "../read_write/read_symbolic_link_sync.js";
+import { readDirectorySync } from "../read_write/read_directory_sync.js";
+import { copyEntrySync } from "./copy_entry_sync.js";
+
+export const copyDirectoryContentSync = ({
+  signal = new AbortController().signal,
+  from,
+  to,
+  overwrite,
+  followLink = true,
+} = {}) => {
+  const fromUrl = assertAndNormalizeDirectoryUrl(from);
+  const fromPath = urlToFileSystemPath(fromUrl);
+  let toUrl = assertAndNormalizeDirectoryUrl(to);
+  let toPath = urlToFileSystemPath(toUrl);
+
+  const sourceStats = readEntryStatSync(fromUrl, {
+    nullIfNotFound: true,
+    followLink: false,
+  });
+  if (!sourceStats) {
+    throw new Error(`no directory to copy content from at ${fromPath}`);
+  }
+  if (!sourceStats.isDirectory()) {
+    const sourceType = statsToType(sourceStats);
+    throw new Error(
+      `found a ${sourceType} instead of a directory at ${fromPath}`,
+    );
+  }
+
+  let destinationStats = readEntryStatSync(toUrl, {
+    nullIfNotFound: true,
+    // we force false here but in fact we will follow the destination link
+    // to know where we will actually move and detect useless move overrite etc..
+    followLink: false,
+  });
+  if (followLink && destinationStats && destinationStats.isSymbolicLink()) {
+    const linkTarget = readSymbolicLinkSync(toUrl);
+    toUrl = resolveUrl(linkTarget, toUrl);
+    toPath = urlToFileSystemPath(toUrl);
+    destinationStats = readEntryStatSync(toUrl, {
+      nullIfNotFound: true,
+    });
+  }
+
+  if (destinationStats === null) {
+    throw new Error(`no directory to copy content into at ${toPath}`);
+  }
+  if (!destinationStats.isDirectory()) {
+    const destinationType = statsToType(destinationStats);
+    throw new Error(
+      `destination leads to a ${destinationType} instead of a directory at ${toPath}`,
+    );
+  }
+
+  if (urlTargetsSameFileSystemPath(fromUrl, toUrl)) {
+    throw new Error(
+      `cannot copy directory content, source and destination are the same (${fromPath})`,
+    );
+  }
+
+  const copyOperation = Abort.startOperation();
+  copyOperation.addAbortSignal(signal);
+  try {
+    copyOperation.throwIfAborted();
+    const directoryEntries = readDirectorySync(fromUrl);
+    directoryEntries.forEach((directoryEntry) => {
+      const from = resolveUrl(directoryEntry, fromUrl);
+      const to = resolveUrl(directoryEntry, toUrl);
+      copyOperation.withSignal((signal) => {
+        copyEntrySync({
+          signal,
+          from,
+          to,
+          overwrite,
+          followLink,
+        });
+      });
+    });
+  } finally {
+    copyOperation.end();
+  }
+};

package/src/copy/copy_directory_sync.js

@@ -0,0 +1,9 @@
+import { copyEntrySync } from "./copy_entry_sync.js";
+
+export const copyDirectorySync = ({ from, to, ...options }) => {
+  copyEntrySync({
+    from,
+    to,
+    ...options,
+  });
+};

package/src/{copyEntry.js → copy/copy_entry.js}

@@ -8,19 +8,19 @@ import {
   urlToFileSystemPath,
 } from "@jsenv/urls";
 
-import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js";
-import { statsToType } from "./internal/statsToType.js";
-import { binaryFlagsToPermissions } from "./internal/permissions.js";
-import { assertAndNormalizeFileUrl } from "./file_url_validation.js";
-import { writeDirectory } from "./writeDirectory.js";
-import { readEntryStat } from "./readEntryStat.js";
-import { ensureParentDirectories } from "./ensureParentDirectories.js";
-import { writeEntryPermissions } from "./writeEntryPermissions.js";
-import { writeEntryModificationTime } from "./writeEntryModificationTime.js";
-import { readDirectory } from "./readDirectory.js";
-import { readSymbolicLink } from "./readSymbolicLink.js";
-import { writeSymbolicLink } from "./writeSymbolicLink.js";
-import { removeEntry } from "./removeEntry.js";
+import { assertAndNormalizeFileUrl } from "../path_and_url/file_url_validation.js";
+import { urlTargetsSameFileSystemPath } from "../path_and_url/url_targets_same_file_system_path.js";
+import { readEntryStat } from "../read_write/stat/read_entry_stat.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { binaryFlagsToPermissions } from "../read_write/stat/permissions.js";
+import { writeEntryPermissions } from "../read_write/stat/write_entry_permissions.js";
+import { writeEntryModificationTime } from "../read_write/stat/write_entry_modification_time.js";
+import { writeDirectory } from "../read_write/write_directory.js";
+import { ensureParentDirectories } from "../read_write/ensure_parent_directories.js";
+import { readDirectory } from "../read_write/read_directory.js";
+import { readSymbolicLink } from "../read_write/read_symbolic_link.js";
+import { writeSymbolicLink } from "../read_write/write_symbolic_link.js";
+import { removeEntry } from "../remove/remove_entry.js";
 
 export const copyEntry = async ({
   signal = new AbortController().signal,

package/src/copy/copy_entry_sync.js

@@ -0,0 +1,212 @@
+import { copyFileSync as copyFileSyncNode } from "node:fs";
+import { Abort } from "@jsenv/abort";
+import {
+  resolveUrl,
+  urlToRelativeUrl,
+  ensurePathnameTrailingSlash,
+  urlIsInsideOf,
+  urlToFileSystemPath,
+} from "@jsenv/urls";
+
+import { assertAndNormalizeFileUrl } from "../path_and_url/file_url_validation.js";
+import { urlTargetsSameFileSystemPath } from "../path_and_url/url_targets_same_file_system_path.js";
+import { readEntryStatSync } from "../read_write/stat/read_entry_stat_sync.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { binaryFlagsToPermissions } from "../read_write/stat/permissions.js";
+import { writeEntryPermissionsSync } from "../read_write/stat/write_entry_permissions_sync.js";
+import { writeEntryModificationTimeSync } from "../read_write/stat/write_entry_modification_time_sync.js";
+import { writeDirectorySync } from "../read_write/write_directory_sync.js";
+import { ensureParentDirectoriesSync } from "../read_write/ensure_parent_directories_sync.js";
+import { readDirectorySync } from "../read_write/read_directory_sync.js";
+import { readSymbolicLinkSync } from "../read_write/read_symbolic_link_sync.js";
+import { writeSymbolicLinkSync } from "../read_write/write_symbolic_link_sync.js";
+import { removeEntrySync } from "../remove/remove_entry_sync.js";
+
+export const copyEntrySync = ({
+  signal = new AbortController().signal,
+  from,
+  to,
+  overwrite = false,
+  preserveStat = true,
+  preserveMtime = preserveStat,
+  preservePermissions = preserveStat,
+  allowUseless = false,
+  followLink = true,
+}) => {
+  const fromUrl = assertAndNormalizeFileUrl(from);
+  const fromPath = urlToFileSystemPath(fromUrl);
+  let toUrl = assertAndNormalizeFileUrl(to);
+  let toPath = urlToFileSystemPath(toUrl);
+
+  const sourceStats = readEntryStatSync(fromUrl, {
+    nullIfNotFound: true,
+    followLink: false,
+  });
+  if (!sourceStats) {
+    throw new Error(`nothing to copy at ${fromPath}`);
+  }
+
+  let destinationStats = readEntryStatSync(toUrl, {
+    nullIfNotFound: true,
+    // we force false here but in fact we will follow the destination link
+    // to know where we will actually move and detect useless move overrite etc..
+    followLink: false,
+  });
+
+  if (followLink && destinationStats && destinationStats.isSymbolicLink()) {
+    const linkTarget = readSymbolicLinkSync(toUrl);
+    toUrl = resolveUrl(linkTarget, toUrl);
+    toPath = urlToFileSystemPath(toUrl);
+    destinationStats = readEntryStatSync(toUrl, {
+      nullIfNotFound: true,
+    });
+  }
+
+  if (urlTargetsSameFileSystemPath(fromUrl, toUrl)) {
+    if (allowUseless) {
+      return;
+    }
+    throw new Error(
+      `cannot copy ${fromPath} because destination and source are the same`,
+    );
+  }
+
+  if (sourceStats.isDirectory()) {
+    toUrl = ensurePathnameTrailingSlash(toUrl);
+  }
+
+  const copyOperation = Abort.startOperation();
+  copyOperation.addAbortSignal(signal);
+
+  const visit = async (url, stats) => {
+    copyOperation.throwIfAborted();
+    if (stats.isFile() || stats.isCharacterDevice() || stats.isBlockDevice()) {
+      visitFile(url, stats);
+    } else if (stats.isSymbolicLink()) {
+      visitSymbolicLink(url, stats);
+    } else if (stats.isDirectory()) {
+      visitDirectory(ensurePathnameTrailingSlash(url), stats);
+    }
+  };
+
+  const visitFile = (fileUrl, fileStats) => {
+    const fileRelativeUrl = urlToRelativeUrl(fileUrl, fromUrl);
+    const fileCopyUrl = resolveUrl(fileRelativeUrl, toUrl);
+
+    copyFileSyncNode(
+      urlToFileSystemPath(fileUrl),
+      urlToFileSystemPath(fileCopyUrl),
+    );
+    copyStatsSync(fileCopyUrl, fileStats);
+  };
+
+  const visitSymbolicLink = (symbolicLinkUrl) => {
+    const symbolicLinkRelativeUrl = urlToRelativeUrl(symbolicLinkUrl, fromUrl);
+    const symbolicLinkTarget = readSymbolicLinkSync(symbolicLinkUrl);
+    const symbolicLinkTargetUrl = resolveUrl(
+      symbolicLinkTarget,
+      symbolicLinkUrl,
+    );
+    const linkIsRelative =
+      symbolicLinkTarget.startsWith("./") ||
+      symbolicLinkTarget.startsWith("../");
+
+    let symbolicLinkCopyTarget;
+    if (symbolicLinkTargetUrl === fromUrl) {
+      symbolicLinkCopyTarget = linkIsRelative ? symbolicLinkTarget : toUrl;
+    } else if (urlIsInsideOf(symbolicLinkTargetUrl, fromUrl)) {
+      // symbolic link targets something inside the directory we want to copy
+      // reflects it inside the copied directory structure
+      const linkCopyTargetRelative = urlToRelativeUrl(
+        symbolicLinkTargetUrl,
+        fromUrl,
+      );
+      symbolicLinkCopyTarget = linkIsRelative
+        ? `./${linkCopyTargetRelative}`
+        : resolveUrl(linkCopyTargetRelative, toUrl);
+    } else {
+      // symbolic link targets something outside the directory we want to copy
+      symbolicLinkCopyTarget = symbolicLinkTarget;
+    }
+
+    // we must guess ourself the type of the symlink
+    // because the destination might not exists because not yet copied
+    // https://nodejs.org/dist/latest-v13.x/docs/api/fs.html#fs_fs_symlink_target_path_type_callback
+    const targetStats = readEntryStatSync(symbolicLinkTargetUrl, {
+      nullIfNotFound: true,
+      followLink: false,
+    });
+    const linkType = targetStats && targetStats.isDirectory() ? "dir" : "file";
+
+    const symbolicLinkCopyUrl = resolveUrl(symbolicLinkRelativeUrl, toUrl);
+    writeSymbolicLinkSync({
+      from: symbolicLinkCopyUrl,
+      to: symbolicLinkCopyTarget,
+      type: linkType,
+    });
+  };
+
+  const copyStatsSync = (toUrl, stats) => {
+    if (preservePermissions || preserveMtime) {
+      const { mode, mtimeMs } = stats;
+      if (preservePermissions) {
+        writeEntryPermissionsSync(toUrl, binaryFlagsToPermissions(mode));
+      }
+      if (preserveMtime) {
+        writeEntryModificationTimeSync(toUrl, mtimeMs);
+      }
+    }
+  };
+
+  const visitDirectory = async (directoryUrl, directoryStats) => {
+    const directoryRelativeUrl = urlToRelativeUrl(directoryUrl, fromUrl);
+    const directoryCopyUrl = resolveUrl(directoryRelativeUrl, toUrl);
+
+    writeDirectorySync(directoryCopyUrl);
+    copyDirectoryContentSync(directoryUrl);
+    copyStatsSync(directoryCopyUrl, directoryStats);
+  };
+
+  const copyDirectoryContentSync = async (directoryUrl) => {
+    const names = readDirectorySync(directoryUrl);
+    names.forEach((name) => {
+      const entryUrl = resolveUrl(name, directoryUrl);
+      const stats = readEntryStatSync(entryUrl, {
+        followLink: false,
+      });
+      visit(entryUrl, stats);
+    });
+  };
+
+  try {
+    if (destinationStats) {
+      const sourceType = statsToType(sourceStats);
+      const destinationType = statsToType(destinationStats);
+
+      if (sourceType !== destinationType) {
+        throw new Error(
+          `cannot copy ${sourceType} from ${fromPath} to ${toPath} because destination exists and is not a ${sourceType} (it's a ${destinationType})`,
+        );
+      }
+      if (!overwrite) {
+        throw new Error(
+          `cannot copy ${sourceType} from ${fromPath} to ${toPath} because destination exists and overwrite option is disabled`,
+        );
+      }
+
+      // remove file, link, directory...
+      removeEntrySync(toUrl, {
+        signal: copyOperation.signal,
+        recursive: true,
+        allowUseless: true,
+      });
+    } else {
+      ensureParentDirectoriesSync(toUrl);
+    }
+
+    copyOperation.throwIfAborted();
+    visit(fromUrl, sourceStats);
+  } finally {
+    copyOperation.end();
+  }
+};

package/src/{registerDirectoryLifecycle.js → lifecycle/register_directory_lifecycle.js}

@@ -2,13 +2,14 @@ import { readdirSync, statSync } from "node:fs";
 import { URL_META } from "@jsenv/url-meta";
 import { urlToFileSystemPath, urlToRelativeUrl } from "@jsenv/urls";
 
-import { assertAndNormalizeDirectoryUrl } from "./directory_url_validation.js";
-import { statsToType } from "./internal/statsToType.js";
-import { guardTooFastSecondCallPerFile } from "./internal/guard_second_call.js";
-import { createWatcher } from "./internal/createWatcher.js";
-import { trackResources } from "./internal/track_resources.js";
+import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { guardTooFastSecondCallPerFile } from "./guard_second_call.js";
+import { createWatcher } from "./create_watcher.js";
+import { trackResources } from "./track_resources.js";
 
-const fsWatchSupportsRecursive = process.platform !== "linux";
+const isLinux = process.platform === "linux";
+const fsWatchSupportsRecursive = !isLinux;
 
 export const registerDirectoryLifecycle = (
   source,
@@ -344,10 +345,10 @@ const shouldCallUpdated = (entryInfo) => {
   if (stat.atimeMs < stat.mtimeMs) {
     return true;
   }
-  if (stat.mtimeMs > previousInfo.stat.mtimeMs) {
-    return true;
+  if (isLinux && stat.mtimeMs <= previousInfo.stat.mtimeMs) {
+    return false;
   }
-  return false;
+  return true;
 };
 
 const undefinedOrFunction = (value) => {

package/src/{registerFileLifecycle.js → lifecycle/register_file_lifecycle.js}

@@ -2,11 +2,11 @@ import { statSync } from "node:fs";
 import { dirname, basename } from "node:path";
 import { urlToFileSystemPath } from "@jsenv/urls";
 
-import { assertAndNormalizeFileUrl } from "./file_url_validation.js";
-import { guardTooFastSecondCall } from "./internal/guard_second_call.js";
-import { statsToType } from "./internal/statsToType.js";
-import { createWatcher } from "./internal/createWatcher.js";
-import { trackResources } from "./internal/track_resources.js";
+import { assertAndNormalizeFileUrl } from "../path_and_url/file_url_validation.js";
+import { statsToType } from "../read_write/stat/stats_to_type.js";
+import { trackResources } from "./track_resources.js";
+import { createWatcher } from "./create_watcher.js";
+import { guardTooFastSecondCall } from "./guard_second_call.js";
 
 export const registerFileLifecycle = (
   source,

package/src/{collectDirectoryMatchReport.js → list/collect_directory_match_report.js}

@@ -1,11 +1,11 @@
 import { Abort } from "@jsenv/abort";
-
 import { URL_META } from "@jsenv/url-meta";
 import { urlToRelativeUrl } from "@jsenv/urls";
-import { assertAndNormalizeDirectoryUrl } from "./directory_url_validation.js";
-import { readDirectory } from "./readDirectory.js";
-import { readEntryStat } from "./readEntryStat.js";
-import { comparePathnames } from "./comparePathnames.js";
+
+import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
+import { comparePathnames } from "../path_and_url/compare_pathnames.js";
+import { readDirectory } from "../read_write/read_directory.js";
+import { readEntryStat } from "../read_write/stat/read_entry_stat.js";
 
 export const collectDirectoryMatchReport = async ({
   signal = new AbortController().signal,

package/src/{collectFiles.js → list/collect_files.js}

@@ -2,10 +2,10 @@ import { Abort } from "@jsenv/abort";
 import { URL_META } from "@jsenv/url-meta";
 import { urlToRelativeUrl } from "@jsenv/urls";
 
-import { assertAndNormalizeDirectoryUrl } from "./directory_url_validation.js";
-import { readDirectory } from "./readDirectory.js";
-import { readEntryStat } from "./readEntryStat.js";
-import { comparePathnames } from "./comparePathnames.js";
+import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
+import { comparePathnames } from "../path_and_url/compare_pathnames.js";
+import { readEntryStat } from "../read_write/stat/read_entry_stat.js";
+import { readDirectory } from "../read_write/read_directory.js";
 
 export const collectFiles = async ({
   signal = new AbortController().signal,

package/src/{listFilesMatching.js → list/list_files_matching.js}

@@ -1,4 +1,4 @@
-import { collectFiles } from "./collectFiles.js";
+import { collectFiles } from "./collect_files.js";
 
 export const listFilesMatching = async ({
   directoryUrl = process.cwd(),

package/src/main.js

@@ -1,41 +1,84 @@
+// we might wanna expose the sync versions as follows:
+// readDirectory.sync()
+// +1: very easy to switch between sync/async versions of a given function
+// -1: code splitting
+// -1: unusual
+
+// path_and_url
 export {
   validateDirectoryUrl,
   assertAndNormalizeDirectoryUrl,
-} from "./directory_url_validation.js";
+} from "./path_and_url/directory_url_validation.js";
 export {
   validateFileUrl,
   assertAndNormalizeFileUrl,
-} from "./file_url_validation.js";
-export { assertDirectoryPresence } from "./assertDirectoryPresence.js";
-export { assertFilePresence } from "./assertFilePresence.js";
-export { bufferToEtag } from "./bufferToEtag.js";
-export { collectDirectoryMatchReport } from "./collectDirectoryMatchReport.js";
-export { collectFiles } from "./collectFiles.js";
-export { comparePathnames } from "./comparePathnames.js";
-export { ensureEmptyDirectory } from "./ensureEmptyDirectory.js";
-export { ensureParentDirectories } from "./ensureParentDirectories.js";
-export { ensureWindowsDriveLetter } from "./ensureWindowsDriveLetter.js";
-export { copyEntry } from "./copyEntry.js";
-export { copyDirectoryContent } from "./copyDirectoryContent.js";
-export { getRealFileSystemUrlSync } from "./getRealFileSystemUrlSync.js";
-export { grantPermissionsOnEntry } from "./grantPermissionsOnEntry.js";
-export { listFilesMatching } from "./listFilesMatching.js";
-export { moveDirectoryContent } from "./moveDirectoryContent.js";
-export { moveEntry } from "./moveEntry.js";
-export { readDirectory } from "./readDirectory.js";
-export { readFile } from "./readFile.js";
-export { readFileSync } from "./readFileSync.js";
-export { readEntryModificationTime } from "./readEntryModificationTime.js";
-export { readEntryPermissions } from "./readEntryPermissions.js";
-export { readEntryStat } from "./readEntryStat.js";
-export { readSymbolicLink } from "./readSymbolicLink.js";
-export { registerDirectoryLifecycle } from "./registerDirectoryLifecycle.js";
-export { registerFileLifecycle } from "./registerFileLifecycle.js";
-export { removeEntry } from "./removeEntry.js";
-export { testEntryPermissions } from "./testEntryPermissions.js";
-export { writeDirectory } from "./writeDirectory.js";
-export { writeFile } from "./writeFile.js";
-export { writeFileSync } from "./writeFileSync.js";
-export { writeEntryModificationTime } from "./writeEntryModificationTime.js";
-export { writeEntryPermissions } from "./writeEntryPermissions.js";
-export { writeSymbolicLink } from "./writeSymbolicLink.js";
+} from "./path_and_url/file_url_validation.js";
+export { comparePathnames } from "./path_and_url/compare_pathnames.js";
+export { ensureWindowsDriveLetter } from "./path_and_url/ensure_windows_drive_letter.js";
+
+// list
+export { collectDirectoryMatchReport } from "./list/collect_directory_match_report.js";
+export { collectFiles } from "./list/collect_files.js";
+export { listFilesMatching } from "./list/list_files_matching.js";
+
+// read and write
+export { ensureParentDirectories } from "./read_write/ensure_parent_directories.js";
+export { readDirectory } from "./read_write/read_directory.js";
+export { writeDirectory } from "./read_write/write_directory.js";
+export { readFile } from "./read_write/read_file.js";
+export { writeFile } from "./read_write/write_file.js";
+export { readFileSync } from "./read_write/read_file_sync.js";
+export { writeFileSync } from "./read_write/write_file_sync.js";
+export { readSymbolicLink } from "./read_write/read_symbolic_link.js";
+export { writeSymbolicLink } from "./read_write/write_symbolic_link.js";
+// read and write sync
+export { ensureParentDirectoriesSync } from "./read_write/ensure_parent_directories_sync.js";
+export { readDirectorySync } from "./read_write/read_directory_sync.js";
+export { getRealFileSystemUrlSync } from "./read_write/get_real_file_system_url_sync.js";
+export { readSymbolicLinkSync } from "./read_write/read_symbolic_link_sync.js";
+export { writeDirectorySync } from "./read_write/write_directory_sync.js";
+export { readFileStructureSync } from "./read_write/read_file_structure_sync.js";
+export { writeFileStructureSync } from "./read_write/write_file_structure_sync.js";
+
+// stat
+export { readEntryStat } from "./read_write/stat/read_entry_stat.js";
+export { readEntryModificationTime } from "./read_write/stat/read_entry_modification_time.js";
+export { writeEntryModificationTime } from "./read_write/stat/write_entry_modification_time.js";
+export { readEntryPermissions } from "./read_write/stat/read_entry_permissions.js";
+export { writeEntryPermissions } from "./read_write/stat/write_entry_permissions.js";
+export { grantPermissionsOnEntry } from "./read_write/stat/grant_permissions_on_entry.js";
+export { testEntryPermissions } from "./read_write/stat/test_entry_permissions.js";
+// stat sync
+export { readEntryStatSync } from "./read_write/stat/read_entry_stat_sync.js";
+export { writeEntryModificationTimeSync } from "./read_write/stat/write_entry_modification_time_sync.js";
+
+// move
+export { moveDirectoryContent } from "./move/move_directory_content.js";
+export { moveEntry } from "./move/move_entry.js";
+
+// copy
+export { copyEntry } from "./copy/copy_entry.js";
+export { copyDirectoryContent } from "./copy/copy_directory_content.js";
+export { copyEntrySync } from "./copy/copy_entry_sync.js";
+export { copyDirectorySync } from "./copy/copy_directory_sync.js";
+export { copyDirectoryContentSync } from "./copy/copy_directory_content_sync.js";
+
+// remove
+export { ensureEmptyDirectory } from "./remove/ensure_empty_directory.js";
+export { ensureEmptyDirectorySync } from "./remove/ensure_empty_directory_sync.js";
+export { clearDirectorySync } from "./remove/clear_directory_sync.js";
+export { removeDirectory } from "./remove/remove_directory.js";
+export { removeFile } from "./remove/remove_file.js";
+export { removeEntry } from "./remove/remove_entry.js";
+export { removeDirectorySync } from "./remove/remove_directory_sync.js";
+export { removeFileSync } from "./remove/remove_file_sync.js";
+export { removeEntrySync } from "./remove/remove_entry_sync.js";
+
+// lifecycle
+export { registerDirectoryLifecycle } from "./lifecycle/register_directory_lifecycle.js";
+export { registerFileLifecycle } from "./lifecycle/register_file_lifecycle.js";
+
+// other
+export { assertDirectoryPresence } from "./assert_directory_presence.js";
+export { assertFilePresence } from "./assert_file_presence.js";
+export { bufferToEtag } from "./buffer_to_etag.js";