@jsenv/filesystem 4.13.3 → 4.13.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/filesystem",
-  "version": "4.13.3",
+  "version": "4.13.4",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/lifecycle/create_watcher.js

@@ -1,4 +1,5 @@
 import { closeSync, openSync, watch } from "node:fs";
+import { generateWindowsEPERMErrorMessage } from "../window_eperm_error.js";
 
 const isWindows = process.platform === "win32";
 
@@ -17,7 +18,10 @@ export const createWatcher = (sourcePath, options) => {
             return;
           }
           console.error(
-            `error while trying to get rid of windows EPERM: ${e.stack}`,
+            generateWindowsEPERMErrorMessage(error, {
+              operation: "watch",
+              path: sourcePath,
+            }),
           );
           throw error;
         }

package/src/read_write/stat/read_entry_stat.js

@@ -7,6 +7,7 @@ import { urlToFileSystemPath } from "@jsenv/urls";
 import { lstat, stat } from "node:fs";
 
 import { assertAndNormalizeFileUrl } from "../../path_and_url/file_url_validation.js";
+import { generateWindowsEPERMErrorMessage } from "../../window_eperm_error.js";
 import { writeEntryPermissions } from "./write_entry_permissions.js";
 
 const isWindows = process.platform === "win32";
@@ -54,7 +55,10 @@ export const readEntryStat = async (
               return stats;
             } catch (e) {
               console.error(
-                `error while trying to fix windows EPERM after stats on ${sourcePath}: ${e.stack}`,
+                generateWindowsEPERMErrorMessage(e, {
+                  operation: "stats",
+                  path: sourcePath,
+                }),
               );
               throw error;
             }

package/src/read_write/stat/read_entry_stat_sync.js

@@ -6,6 +6,7 @@
 import { urlToFileSystemPath } from "@jsenv/urls";
 import { lstatSync, statSync } from "node:fs";
 import { assertAndNormalizeFileUrl } from "../../path_and_url/file_url_validation.js";
+import { generateWindowsEPERMErrorMessage } from "../../window_eperm_error.js";
 import { writeEntryPermissionsSync } from "./write_entry_permissions_sync.js";
 
 const isWindows = process.platform === "win32";
@@ -53,7 +54,10 @@ export const readEntryStatSync = (
               return stats;
             } catch (e) {
               console.error(
-                `error while trying to fix windows EPERM after stats on ${sourcePath}: ${e.stack}`,
+                generateWindowsEPERMErrorMessage(e, {
+                  operation: "stats",
+                  path: sourcePath,
+                }),
               );
               throw error;
             }

package/src/remove/remove_entry.js

@@ -9,6 +9,7 @@ import { closeSync, openSync, rmdir, unlink } from "node:fs";
 import { assertAndNormalizeFileUrl } from "../path_and_url/file_url_validation.js";
 import { readDirectory } from "../read_write/read_directory.js";
 import { readEntryStat } from "../read_write/stat/read_entry_stat.js";
+import { generateWindowsEPERMErrorMessage } from "../window_eperm_error.js";
 
 export const removeEntry = async (
   source,
@@ -168,7 +169,6 @@ const removeDirectory = async (
               console.error(
                 `trying to fix windows EPERM after readir on ${directoryPath}`,
               );
-
               let openOrCloseError;
               try {
                 const fd = openSync(directoryPath);
@@ -182,7 +182,10 @@ const removeDirectory = async (
                   return;
                 }
                 console.error(
-                  `error while trying to fix windows EPERM after readir on ${directoryPath}: ${openOrCloseError.stack}`,
+                  generateWindowsEPERMErrorMessage(openOrCloseError, {
+                    operation: "readdir",
+                    path: directoryPath,
+                  }),
                 );
                 throw error;
               }

package/src/remove/remove_entry_sync.js

@@ -13,6 +13,7 @@ import {
 
 import { assertAndNormalizeFileUrl } from "../path_and_url/file_url_validation.js";
 import { readEntryStatSync } from "../read_write/stat/read_entry_stat_sync.js";
+import { generateWindowsEPERMErrorMessage } from "../window_eperm_error.js";
 
 export const removeEntrySync = (
   source,
@@ -153,7 +154,10 @@ const removeDirectorySync = (
                   return;
                 }
                 console.error(
-                  `error while trying to fix windows EPERM after readir on ${directoryPath}: ${openOrCloseError.stack}`,
+                  generateWindowsEPERMErrorMessage(openOrCloseError, {
+                    path: directoryPath,
+                    operation: "readir",
+                  }),
                 );
                 throw error;
               }

package/src/window_eperm_error.js

@@ -0,0 +1,20 @@
+export const generateWindowsEPERMErrorMessage = (
+  error,
+  { operation, path },
+) => {
+  const pathLengthIsExceedingUsualLimit = String(path).length >= 256;
+  let message = "";
+
+  if (operation) {
+    message += `error while trying to fix windows EPERM after ${operation} on ${path}`;
+  }
+
+  if (pathLengthIsExceedingUsualLimit) {
+    message += "\n";
+    message += `Maybe because path length is exceeding the usual limit of 256 characters of windows OS?`;
+    message += "\n";
+  }
+  message += "\n";
+  message += error.stack;
+  return message;
+};