@photostructure/fs-metadata 0.9.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photostructure/fs-metadata",
-  "version": "0.9.0",
+  "version": "1.0.1",
   "description": "Cross-platform native filesystem metadata retrieval for Node.js",
   "homepage": "https://photostructure.github.io/fs-metadata/",
   "types": "./dist/index.d.ts",
@@ -96,29 +96,29 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.3.0",
     "@types/semver": "^7.7.1",
     "cross-env": "^10.1.0",
     "del-cli": "^7.0.0",
     "eslint": "9.39.1",
-    "eslint-plugin-regexp": "^2.10.0",
-    "eslint-plugin-security": "^3.0.1",
-    "globals": "^16.5.0",
+    "eslint-plugin-regexp": "^3.0.0",
+    "eslint-plugin-security": "^4.0.0",
+    "globals": "^17.3.0",
     "jest": "^30.2.0",
     "jest-environment-node": "^30.2.0",
     "jest-extended": "^7.0.0",
-    "node-gyp": "^12.1.0",
-    "npm-check-updates": "^19.2.0",
+    "node-gyp": "^12.2.0",
+    "npm-check-updates": "^19.4.1",
     "npm-run-all2": "8.0.4",
     "prebuildify": "^6.0.1",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "prettier-plugin-organize-imports": "4.3.0",
-    "terser": "^5.44.1",
+    "terser": "^5.46.0",
     "ts-jest": "^29.4.6",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typedoc": "^0.28.15",
+    "typedoc": "^0.28.17",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1"
+    "typescript-eslint": "^8.56.1"
   }
 }

package/src/hidden.ts

@@ -54,6 +54,20 @@ export async function isHiddenImpl(
     throw new Error("Invalid pathname: " + JSON.stringify(pathname));
   }
   debug("Normalized path: %s", norm);
+
+  // Root directories are never meaningfully "hidden" on any platform.
+  // Windows sets FILE_ATTRIBUTE_HIDDEN + FILE_ATTRIBUTE_SYSTEM on root drives
+  // (e.g. C:\) as a protective measure, not user intent to hide the directory.
+  // Recovery partitions are hidden at the volume level via diskpart attributes
+  // (NODEFAULTDRIVELETTER / GPT type GUIDs), not file attributes, so any root
+  // directory reachable by path is safe to treat as non-hidden.
+  // See https://learn.microsoft.com/en-us/answers/questions/427448/how-to-properly-hide-a-recovery-partition
+  // and https://en.wikipedia.org/wiki/File_attribute
+  if (isRootDirectory(norm)) {
+    debug("Root directory, returning false");
+    return false;
+  }
+
   debug(
     "LocalSupport: dotPrefix=%s, systemFlag=%s",
     LocalSupport.dotPrefix,
@@ -160,6 +174,17 @@ export async function getHiddenMetadataImpl(
   if (norm == null) {
     throw new Error("Invalid pathname: " + JSON.stringify(pathname));
   }
+  // Root directories are never meaningfully "hidden" on any platform
+  // (see comment in isHiddenImpl for details).
+  if (isRootDirectory(norm)) {
+    return {
+      hidden: false,
+      dotPrefix: false,
+      systemFlag: false,
+      supported: LocalSupport,
+    };
+  }
+
   const dotPrefix = isPosixHidden(norm);
   const systemFlag = await isSystemHidden(norm, nativeFn);
   return {