@jsenv/filesystem 4.14.6 → 4.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/filesystem",
-  "version": "4.14.6",
+  "version": "4.15.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@jsenv/urls": "2.7.1",
+    "@jsenv/urls": "2.7.2",
     "@jsenv/url-meta": "8.5.6",
     "@jsenv/abort": "4.3.1",
     "@jsenv/utils": "2.3.0"

package/src/main.js

@@ -19,12 +19,13 @@ export { comparePathnames } from "./path_and_url/compare_pathnames.js";
 export { compareFileUrls } from "./path_and_url/compare_file_urls.js";
 export { ensureWindowsDriveLetter } from "./path_and_url/ensure_windows_drive_letter.js";
 export { getParentDirectoryUrl } from "./path_and_url/get_parent_directory_url.js";
-export { findAncestorDirectoryUrl } from "./path_and_url/find_ancestor_directory_url.js";
+export { findSelfOrAncestorDirectoryUrl } from "./path_and_url/find_self_or_ancestor_directory_url.js";
 // All other exports are agnostic and focused on the filesystem only
 // "lookupPackageDirectory" is an exception because it related to node module resolution
 // but it's very useful and it's not a problem to have it here (and useful to share this logic)
 export {
   lookupPackageDirectory,
+  createLookupPackageDirectory,
   readPackageAtOrNull,
 } from "./path_and_url/lookup_package_directory.js";
 
@@ -54,6 +55,7 @@ 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";
 export { saveDirectoryContentSync } from "./read_write/save_directory_content_sync.js";
+export { updateJsonFileSync } from "./read_write/update_json_file_sync.js";
 
 // stat
 export { readEntryStat } from "./read_write/stat/read_entry_stat.js";

package/src/path_and_url/{find_ancestor_directory_url.js → find_self_or_ancestor_directory_url.js}

@@ -1,7 +1,10 @@
 import { getParentDirectoryUrl } from "./get_parent_directory_url.js";
 
-export const findAncestorDirectoryUrl = (url, callback) => {
+export const findSelfOrAncestorDirectoryUrl = (url, callback) => {
   url = String(url);
+  if (!url.endsWith("/")) {
+    url = new URL("./", url).href;
+  }
   while (url !== "file:///") {
     if (callback(url)) {
       return url;

package/src/path_and_url/lookup_package_directory.js

@@ -1,13 +1,53 @@
 import { existsSync, readFileSync } from "node:fs";
-import { findAncestorDirectoryUrl } from "./find_ancestor_directory_url.js";
+import { findSelfOrAncestorDirectoryUrl } from "./find_self_or_ancestor_directory_url.js";
+import { getParentDirectoryUrl } from "./get_parent_directory_url.js";
 
 export const lookupPackageDirectory = (currentUrl) => {
-  return findAncestorDirectoryUrl(currentUrl, (ancestorDirectoryUrl) => {
+  return findSelfOrAncestorDirectoryUrl(currentUrl, (ancestorDirectoryUrl) => {
     const potentialPackageJsonFileUrl = `${ancestorDirectoryUrl}package.json`;
     return existsSync(new URL(potentialPackageJsonFileUrl));
   });
 };
 
+export const createLookupPackageDirectory = () => {
+  const cache = new Map();
+  const lookupPackageDirectoryWithCache = (currentUrl) => {
+    const directoryUrls = [];
+    currentUrl = String(currentUrl);
+    if (currentUrl.endsWith("/")) {
+      directoryUrls.push(currentUrl);
+    } else {
+      const directoryUrl = new URL("./", currentUrl).href;
+      directoryUrls.push(directoryUrl);
+      currentUrl = directoryUrl;
+    }
+    while (currentUrl !== "file:///") {
+      const fromCache = cache.get(currentUrl);
+      if (fromCache !== undefined) {
+        return fromCache;
+      }
+      const packageJsonUrlCandidate = `${currentUrl}package.json`;
+      if (existsSync(new URL(packageJsonUrlCandidate))) {
+        for (const directoryUrl of directoryUrls) {
+          cache.set(directoryUrl, currentUrl);
+        }
+        return currentUrl;
+      }
+      const directoryUrl = getParentDirectoryUrl(currentUrl);
+      directoryUrls.push(directoryUrl);
+      currentUrl = directoryUrl;
+    }
+    for (const directoryUrl of directoryUrls) {
+      cache.set(directoryUrl, null);
+    }
+    return null;
+  };
+  lookupPackageDirectoryWithCache.clearCache = () => {
+    cache.clear();
+  };
+  return lookupPackageDirectoryWithCache;
+};
+
 export const readPackageAtOrNull = (packageDirectoryUrl) => {
   try {
     const packageFileContent = readFileSync(

package/src/read_write/update_json_file_sync.js

@@ -0,0 +1,27 @@
+import { readFileSync } from "./read_file_sync.js";
+import { writeFileSync } from "./write_file_sync.js";
+
+export const updateJsonFileSync = (fileUrl, values = {}) => {
+  try {
+    const jsonString = readFileSync(fileUrl, { as: "string" });
+    const json = JSON.parse(jsonString);
+    const newContent = { ...json };
+    for (const key of Object.keys(values)) {
+      const value = values[key];
+      newContent[key] = value;
+    }
+    let jsonFormatted;
+    if (jsonString.startsWith("{\n")) {
+      jsonFormatted = JSON.stringify(newContent, null, "  ");
+    } else {
+      jsonFormatted = JSON.stringify(newContent);
+    }
+    writeFileSync(fileUrl, jsonFormatted);
+  } catch (e) {
+    if (e.code === "ENOENT") {
+      writeFileSync(fileUrl, JSON.stringify(values));
+      return;
+    }
+    throw e;
+  }
+};

package/src/read_write/write_directory_sync.js

@@ -2,7 +2,7 @@ import { urlToFileSystemPath } from "@jsenv/urls";
 import { mkdirSync, statSync, unlinkSync } from "node:fs";
 
 import { assertAndNormalizeDirectoryUrl } from "../path_and_url/directory_url_validation.js";
-import { findAncestorDirectoryUrl } from "../path_and_url/find_ancestor_directory_url.js";
+import { findSelfOrAncestorDirectoryUrl } from "../path_and_url/find_self_or_ancestor_directory_url.js";
 import { readEntryStatSync } from "./stat/read_entry_stat_sync.js";
 import { statsToType } from "./stat/stats_to_type.js";
 
@@ -23,7 +23,7 @@ export const writeDirectorySync = (
     if (e.code === "ENOTDIR") {
       let previousNonDirUrl = destinationUrl;
       // we must try all parent directories as long as it fails with ENOTDIR
-      findAncestorDirectoryUrl(destinationUrl, (ancestorUrl) => {
+      findSelfOrAncestorDirectoryUrl(destinationUrl, (ancestorUrl) => {
         try {
           statSync(new URL(ancestorUrl));
           return true;