@photostructure/fs-metadata 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -141,6 +141,12 @@ interface Options {
      * @see {@link LinuxMountTablePathsDefault} for the default values
      */
     linuxMountTablePaths: string[];
+    /**
+     * Filesystem types that indicate network/remote volumes.
+     *
+     * @see {@link NetworkFsTypesDefault} for the default value
+     */
+    networkFsTypes: string[];
     /**
      * Should system volumes be included in result arrays? Defaults to true on
      * Windows and false elsewhere.
@@ -256,17 +262,37 @@ declare function getTimeoutMsDefault(): number;
 /**
  * System paths and globs that indicate system volumes
  */
-declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts"];
+declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/flatpak/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/var/lib/kubelet/**", "/var/lib/lxc/**", "/var/lib/lxd/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts", "**/.DocumentRevisions-V100", "**/.fseventsd", "**/.Spotlight-V100", "**/.Trashes"];
 /**
- * Filesystem types that indicate system volumes
+ * Filesystem types that indicate system/virtual volumes.
+ *
+ * These are pseudo-filesystems that don't represent real storage devices.
+ * See /proc/filesystems for the full list supported by the running kernel.
+ *
+ * @see https://www.kernel.org/doc/html/latest/filesystems/ - Linux kernel filesystem docs
+ * @see https://man7.org/linux/man-pages/man5/proc_filesystems.5.html - /proc/filesystems
  */
-declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "proc", "pstore", "rootfs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs"];
+declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "bpf", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.lxcfs", "fuse.portal", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "nsfs", "proc", "pstore", "ramfs", "rootfs", "rpc_pipefs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs", "tracefs"];
 declare const LinuxMountTablePathsDefault: readonly ["/proc/self/mounts", "/proc/mounts", "/etc/mtab"];
+/**
+ * Network/remote filesystem types.
+ *
+ * These filesystems require network connectivity and may have higher latency
+ * or availability concerns. Used by {@link Options.networkFsTypes}.
+ *
+ * Based on systemd's fstype_is_network() and common FUSE remote filesystems.
+ * @see https://github.com/systemd/systemd/blob/main/src/basic/mountpoint-util.c - fstype_is_network()
+ */
+declare const NetworkFsTypesDefault: readonly ["9p", "afp", "afs", "beegfs", "ceph", "cifs", "ftp", "fuse", "fuse.rclone", "fuse.s3fs", "fuse.sshfs", "gfs", "gfs2", "glusterfs", "lustre", "ncpfs", "ncp", "nfs", "nfs4", "smb", "smbfs", "sshfs", "webdav"];
 /**
  * Should {@link getAllVolumeMetadata} include system volumes by
  * default?
  */
 declare const IncludeSystemVolumesDefault: boolean;
+/**
+ * Default value for {@link Options.skipNetworkVolumes}.
+ */
+declare const SkipNetworkVolumesDefault = false;
 /**
  * Default {@link Options} object.
  *
@@ -367,4 +393,4 @@ declare function getHiddenMetadata(pathname: string): Promise<HiddenMetadata>;
  */
 declare function setHidden(pathname: string, hidden: boolean, method?: HideMethod): Promise<SetHiddenResult>;
 
-export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, type Options, OptionsDefault, type SetHiddenResult, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };
+export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, NetworkFsTypesDefault, type Options, OptionsDefault, type SetHiddenResult, SkipNetworkVolumesDefault, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };

package/dist/index.d.mts

@@ -141,6 +141,12 @@ interface Options {
      * @see {@link LinuxMountTablePathsDefault} for the default values
      */
     linuxMountTablePaths: string[];
+    /**
+     * Filesystem types that indicate network/remote volumes.
+     *
+     * @see {@link NetworkFsTypesDefault} for the default value
+     */
+    networkFsTypes: string[];
     /**
      * Should system volumes be included in result arrays? Defaults to true on
      * Windows and false elsewhere.
@@ -256,17 +262,37 @@ declare function getTimeoutMsDefault(): number;
 /**
  * System paths and globs that indicate system volumes
  */
-declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts"];
+declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/flatpak/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/var/lib/kubelet/**", "/var/lib/lxc/**", "/var/lib/lxd/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts", "**/.DocumentRevisions-V100", "**/.fseventsd", "**/.Spotlight-V100", "**/.Trashes"];
 /**
- * Filesystem types that indicate system volumes
+ * Filesystem types that indicate system/virtual volumes.
+ *
+ * These are pseudo-filesystems that don't represent real storage devices.
+ * See /proc/filesystems for the full list supported by the running kernel.
+ *
+ * @see https://www.kernel.org/doc/html/latest/filesystems/ - Linux kernel filesystem docs
+ * @see https://man7.org/linux/man-pages/man5/proc_filesystems.5.html - /proc/filesystems
  */
-declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "proc", "pstore", "rootfs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs"];
+declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "bpf", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.lxcfs", "fuse.portal", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "nsfs", "proc", "pstore", "ramfs", "rootfs", "rpc_pipefs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs", "tracefs"];
 declare const LinuxMountTablePathsDefault: readonly ["/proc/self/mounts", "/proc/mounts", "/etc/mtab"];
+/**
+ * Network/remote filesystem types.
+ *
+ * These filesystems require network connectivity and may have higher latency
+ * or availability concerns. Used by {@link Options.networkFsTypes}.
+ *
+ * Based on systemd's fstype_is_network() and common FUSE remote filesystems.
+ * @see https://github.com/systemd/systemd/blob/main/src/basic/mountpoint-util.c - fstype_is_network()
+ */
+declare const NetworkFsTypesDefault: readonly ["9p", "afp", "afs", "beegfs", "ceph", "cifs", "ftp", "fuse", "fuse.rclone", "fuse.s3fs", "fuse.sshfs", "gfs", "gfs2", "glusterfs", "lustre", "ncpfs", "ncp", "nfs", "nfs4", "smb", "smbfs", "sshfs", "webdav"];
 /**
  * Should {@link getAllVolumeMetadata} include system volumes by
  * default?
  */
 declare const IncludeSystemVolumesDefault: boolean;
+/**
+ * Default value for {@link Options.skipNetworkVolumes}.
+ */
+declare const SkipNetworkVolumesDefault = false;
 /**
  * Default {@link Options} object.
  *
@@ -367,4 +393,4 @@ declare function getHiddenMetadata(pathname: string): Promise<HiddenMetadata>;
  */
 declare function setHidden(pathname: string, hidden: boolean, method?: HideMethod): Promise<SetHiddenResult>;
 
-export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, type Options, OptionsDefault, type SetHiddenResult, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };
+export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, NetworkFsTypesDefault, type Options, OptionsDefault, type SetHiddenResult, SkipNetworkVolumesDefault, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };

package/dist/index.d.ts

@@ -141,6 +141,12 @@ interface Options {
      * @see {@link LinuxMountTablePathsDefault} for the default values
      */
     linuxMountTablePaths: string[];
+    /**
+     * Filesystem types that indicate network/remote volumes.
+     *
+     * @see {@link NetworkFsTypesDefault} for the default value
+     */
+    networkFsTypes: string[];
     /**
      * Should system volumes be included in result arrays? Defaults to true on
      * Windows and false elsewhere.
@@ -256,17 +262,37 @@ declare function getTimeoutMsDefault(): number;
 /**
  * System paths and globs that indicate system volumes
  */
-declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts"];
+declare const SystemPathPatternsDefault: readonly ["/boot", "/boot/efi", "/dev", "/dev/**", "/proc/**", "/run", "/run/credentials/**", "/run/flatpak/**", "/run/lock", "/run/snapd/**", "/run/user/*/doc", "/run/user/*/gvfs", "/snap/**", "/sys/**", "/tmp", "/var/tmp", "**/#snapshot", "/run/docker/**", "/var/lib/docker/**", "/run/containerd/**", "/var/lib/containerd/**", "/run/containers/**", "/var/lib/containers/**", "/var/lib/kubelet/**", "/var/lib/lxc/**", "/var/lib/lxd/**", "/mnt/wslg/distro", "/mnt/wslg/doc", "/mnt/wslg/versions.txt", "/usr/lib/wsl/drivers", "/private/var/vm", "/System/Volumes/Hardware", "/System/Volumes/iSCPreboot", "/System/Volumes/Preboot", "/System/Volumes/Recovery", "/System/Volumes/Reserved", "/System/Volumes/Update", "/System/Volumes/VM", "/System/Volumes/xarts", "**/.DocumentRevisions-V100", "**/.fseventsd", "**/.Spotlight-V100", "**/.Trashes"];
 /**
- * Filesystem types that indicate system volumes
+ * Filesystem types that indicate system/virtual volumes.
+ *
+ * These are pseudo-filesystems that don't represent real storage devices.
+ * See /proc/filesystems for the full list supported by the running kernel.
+ *
+ * @see https://www.kernel.org/doc/html/latest/filesystems/ - Linux kernel filesystem docs
+ * @see https://man7.org/linux/man-pages/man5/proc_filesystems.5.html - /proc/filesystems
  */
-declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "proc", "pstore", "rootfs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs"];
+declare const SystemFsTypesDefault: readonly ["autofs", "binfmt_misc", "bpf", "cgroup", "cgroup2", "configfs", "debugfs", "devpts", "devtmpfs", "efivarfs", "fusectl", "fuse.lxcfs", "fuse.portal", "fuse.snapfuse", "hugetlbfs", "mqueue", "none", "nsfs", "proc", "pstore", "ramfs", "rootfs", "rpc_pipefs", "securityfs", "snap*", "squashfs", "sysfs", "tmpfs", "tracefs"];
 declare const LinuxMountTablePathsDefault: readonly ["/proc/self/mounts", "/proc/mounts", "/etc/mtab"];
+/**
+ * Network/remote filesystem types.
+ *
+ * These filesystems require network connectivity and may have higher latency
+ * or availability concerns. Used by {@link Options.networkFsTypes}.
+ *
+ * Based on systemd's fstype_is_network() and common FUSE remote filesystems.
+ * @see https://github.com/systemd/systemd/blob/main/src/basic/mountpoint-util.c - fstype_is_network()
+ */
+declare const NetworkFsTypesDefault: readonly ["9p", "afp", "afs", "beegfs", "ceph", "cifs", "ftp", "fuse", "fuse.rclone", "fuse.s3fs", "fuse.sshfs", "gfs", "gfs2", "glusterfs", "lustre", "ncpfs", "ncp", "nfs", "nfs4", "smb", "smbfs", "sshfs", "webdav"];
 /**
  * Should {@link getAllVolumeMetadata} include system volumes by
  * default?
  */
 declare const IncludeSystemVolumesDefault: boolean;
+/**
+ * Default value for {@link Options.skipNetworkVolumes}.
+ */
+declare const SkipNetworkVolumesDefault = false;
 /**
  * Default {@link Options} object.
  *
@@ -367,4 +393,4 @@ declare function getHiddenMetadata(pathname: string): Promise<HiddenMetadata>;
  */
 declare function setHidden(pathname: string, hidden: boolean, method?: HideMethod): Promise<SetHiddenResult>;
 
-export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, type Options, OptionsDefault, type SetHiddenResult, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };
+export { type GetVolumeMountPointOptions, type HiddenMetadata, type HideMethod, IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, type MountPoint, NetworkFsTypesDefault, type Options, OptionsDefault, type SetHiddenResult, SkipNetworkVolumesDefault, type StringEnum, type StringEnumKeys, type StringEnumType, SystemFsTypesDefault, SystemPathPatternsDefault, type SystemVolumeConfig, type VolumeHealthStatus, VolumeHealthStatuses, type VolumeMetadata, getAllVolumeMetadata, getHiddenMetadata, getTimeoutMsDefault, getVolumeMetadata, getVolumeMountPoints, isHidden, isHiddenRecursive, optionsWithDefaults, setHidden };

package/dist/index.mjs

@@ -587,6 +587,7 @@ var SystemPathPatternsDefault = [
   "/proc/**",
   "/run",
   "/run/credentials/**",
+  "/run/flatpak/**",
   "/run/lock",
   "/run/snapd/**",
   "/run/user/*/doc",
@@ -616,12 +617,21 @@ var SystemPathPatternsDefault = [
   // - Rootless and rootful container storage
   "/run/containers/**",
   "/var/lib/containers/**",
-  // windows for linux:
+  //
+  // Kubernetes: https://kubernetes.io/docs/reference/node/kubelet-files/
+  // - kubelet stores pod data, device plugins, and seccomp profiles
+  "/var/lib/kubelet/**",
+  //
+  // LXC/LXD: https://linuxcontainers.org/
+  // - Linux container storage and configuration
+  "/var/lib/lxc/**",
+  "/var/lib/lxd/**",
+  // WSL (Windows Subsystem for Linux):
   "/mnt/wslg/distro",
   "/mnt/wslg/doc",
   "/mnt/wslg/versions.txt",
   "/usr/lib/wsl/drivers",
-  // MacOS stuff:
+  // macOS system paths:
   "/private/var/vm",
   // macOS swap
   "/System/Volumes/Hardware",
@@ -631,11 +641,20 @@ var SystemPathPatternsDefault = [
   "/System/Volumes/Reserved",
   "/System/Volumes/Update",
   "/System/Volumes/VM",
-  "/System/Volumes/xarts"
+  "/System/Volumes/xarts",
+  // macOS per-volume metadata (Spotlight, FSEvents, versioning, Trash):
+  // https://eclecticlight.co/2021/01/28/spotlight-on-search-how-spotlight-works/
+  "**/.DocumentRevisions-V100",
+  "**/.fseventsd",
+  "**/.Spotlight-V100",
+  "**/.Trashes"
 ];
 var SystemFsTypesDefault = [
   "autofs",
   "binfmt_misc",
+  // BPF filesystem for persistent BPF objects
+  // https://docs.kernel.org/bpf/
+  "bpf",
   "cgroup",
   "cgroup2",
   "configfs",
@@ -644,24 +663,98 @@ var SystemFsTypesDefault = [
   "devtmpfs",
   "efivarfs",
   "fusectl",
+  // LXC container filesystem virtualization
+  // https://linuxcontainers.org/lxcfs/
+  "fuse.lxcfs",
+  // XDG Desktop Portal for Flatpak sandboxed app file access
+  // https://flatpak.github.io/xdg-desktop-portal/
+  "fuse.portal",
   "fuse.snapfuse",
   "hugetlbfs",
   "mqueue",
   "none",
+  // Linux namespace filesystem (internal kernel use)
+  // https://man7.org/linux/man-pages/man7/namespaces.7.html
+  "nsfs",
   "proc",
   "pstore",
+  // RAM-based filesystem (predecessor to tmpfs)
+  // https://www.kernel.org/doc/html/latest/filesystems/ramfs-rootfs-initramfs.html
+  "ramfs",
   "rootfs",
+  // NFS RPC communication pipe filesystem
+  // https://man7.org/linux/man-pages/man8/rpc.gssd.8.html
+  "rpc_pipefs",
   "securityfs",
   "snap*",
   "squashfs",
   "sysfs",
-  "tmpfs"
+  "tmpfs",
+  // Kernel function tracing filesystem
+  // https://www.kernel.org/doc/html/latest/trace/ftrace.html
+  "tracefs"
 ];
 var LinuxMountTablePathsDefault = [
   "/proc/self/mounts",
   "/proc/mounts",
   "/etc/mtab"
 ];
+var NetworkFsTypesDefault = [
+  // Plan 9 filesystem (VM host-guest, also network)
+  // https://www.kernel.org/doc/html/latest/filesystems/9p.html
+  "9p",
+  // Apple Filing Protocol (legacy macOS/netatalk)
+  "afp",
+  // Andrew File System (distributed) - not to be confused with Apple's APFS
+  // https://www.openafs.org/
+  "afs",
+  // BeeGFS parallel filesystem (HPC)
+  // https://www.beegfs.io/
+  "beegfs",
+  // Ceph distributed filesystem
+  // https://docs.ceph.com/
+  "ceph",
+  // Windows/Samba shares (SMB/CIFS)
+  // https://www.samba.org/
+  "cifs",
+  // FTP filesystem mount
+  "ftp",
+  // Generic FUSE (often remote, treated conservatively)
+  "fuse",
+  // rclone cloud storage mount (Google Drive, S3, etc.)
+  // https://rclone.org/commands/rclone_mount/
+  "fuse.rclone",
+  // Amazon S3 FUSE mount
+  // https://github.com/s3fs-fuse/s3fs-fuse
+  "fuse.s3fs",
+  // SSH filesystem
+  // https://github.com/libfuse/sshfs
+  "fuse.sshfs",
+  // Red Hat Global File System (cluster)
+  "gfs",
+  "gfs2",
+  // GlusterFS distributed filesystem
+  // https://www.gluster.org/
+  "glusterfs",
+  // Lustre parallel filesystem (HPC)
+  // https://www.lustre.org/
+  "lustre",
+  // Novell NetWare (legacy)
+  "ncpfs",
+  "ncp",
+  // Network File System
+  // https://man7.org/linux/man-pages/man5/nfs.5.html
+  "nfs",
+  "nfs4",
+  // SMB filesystem
+  "smb",
+  "smbfs",
+  // SSH filesystem (non-FUSE variant)
+  "sshfs",
+  // WebDAV filesystem
+  // https://savannah.nongnu.org/projects/davfs2
+  "webdav"
+];
 var IncludeSystemVolumesDefault = isWindows;
 var SkipNetworkVolumesDefault = false;
 var OptionsDefault = {
@@ -670,6 +763,7 @@ var OptionsDefault = {
   systemPathPatterns: [...SystemPathPatternsDefault],
   systemFsTypes: [...SystemFsTypesDefault],
   linuxMountTablePaths: [...LinuxMountTablePathsDefault],
+  networkFsTypes: [...NetworkFsTypesDefault],
   includeSystemVolumes: IncludeSystemVolumesDefault,
   skipNetworkVolumes: SkipNetworkVolumesDefault
 };
@@ -794,38 +888,15 @@ function isRemoteInfo(obj) {
   const { remoteHost, remoteShare } = obj;
   return isNotBlank(remoteHost) && isNotBlank(remoteShare);
 }
-var NETWORK_FS_TYPE_ARRAY = [
-  "9p",
-  "afp",
-  "afs",
-  "beegfs",
-  "ceph",
-  "cifs",
-  "ftp",
-  "fuse",
-  "gfs2",
-  "glusterfs",
-  "lustre",
-  "ncpfs",
-  "nfs",
-  "nfs4",
-  "smb",
-  "smbfs",
-  "sshfs",
-  "webdav"
-];
-var NETWORK_FS_TYPES = new Set(NETWORK_FS_TYPE_ARRAY);
 var FS_TYPE_ALIASES = /* @__PURE__ */ new Map([
   ["nfs1", "nfs"],
   ["nfs2", "nfs"],
   ["nfs3", "nfs"],
-  ["nfs4", "nfs4"],
   ["fuse.sshfs", "sshfs"],
   ["sshfs.fuse", "sshfs"],
   ["davfs2", "webdav"],
   ["davfs", "webdav"],
   ["cifs.smb", "cifs"],
-  ["smbfs", "cifs"],
   ["cephfs", "ceph"],
   ["fuse.ceph", "ceph"],
   ["fuse.cephfs", "ceph"],
@@ -836,8 +907,12 @@ function normalizeFsType(fstype) {
   const norm = toS(fstype).toLowerCase().replace(/:$/, "");
   return FS_TYPE_ALIASES.get(norm) ?? norm;
 }
-function isRemoteFsType(fstype) {
-  return isNotBlank(fstype) && NETWORK_FS_TYPES.has(normalizeFsType(fstype));
+function isRemoteFsType(fstype, networkFsTypes = NetworkFsTypesDefault) {
+  if (!isNotBlank(fstype)) return false;
+  const normalized = normalizeFsType(fstype);
+  return networkFsTypes.some(
+    (nft) => nft === normalized || normalized.startsWith(nft + ".")
+  );
 }
 function parseURL(s) {
   try {
@@ -846,7 +921,7 @@ function parseURL(s) {
     return;
   }
 }
-function extractRemoteInfo(fsSpec) {
+function extractRemoteInfo(fsSpec, networkFsTypes = NetworkFsTypesDefault) {
   if (fsSpec == null || isBlank(fsSpec)) return;
   if (isWindows) {
     fsSpec = fsSpec.replace(/\\/g, "/");
@@ -895,7 +970,7 @@ function extractRemoteInfo(fsSpec) {
     if (parsed != null) {
       debug("[extractRemoteInfo] parsed URL: %o", parsed);
       const fstype = normalizeFsType(parsed.protocol);
-      if (!isRemoteFsType(fstype)) {
+      if (!isRemoteFsType(fstype, networkFsTypes)) {
         return {
           uri: fsSpec,
           remote: false
@@ -1048,6 +1123,7 @@ function mountEntryToMountPoint(entry) {
   };
 }
 function mountEntryToPartialVolumeMetadata(entry, options = {}) {
+  const networkFsTypes = options.networkFsTypes ?? NetworkFsTypesDefault;
   return {
     mountPoint: entry.fs_file,
     fstype: entry.fs_vfstype,
@@ -1055,7 +1131,7 @@ function mountEntryToPartialVolumeMetadata(entry, options = {}) {
     isSystemVolume: isSystemVolume(entry.fs_file, entry.fs_vfstype, options),
     remote: false,
     // < default to false, but it may be overridden by extractRemoteInfo
-    ...extractRemoteInfo(entry.fs_spec)
+    ...extractRemoteInfo(entry.fs_spec, networkFsTypes)
   };
 }
 function parseMtab(content) {
@@ -1307,9 +1383,9 @@ async function _getVolumeMetadata(o, nativeFn2) {
   debug("[getVolumeMetadata] requesting native metadata");
   const metadata = await (await nativeFn2()).getVolumeMetadata(o);
   debug("[getVolumeMetadata] native metadata: %o", metadata);
-  const remoteInfo = mtabInfo ?? extractRemoteInfo(metadata.uri) ?? extractRemoteInfo(metadata.mountFrom) ?? (isWindows ? parseUNCPath(o.mountPoint) : void 0);
+  const remoteInfo = mtabInfo ?? extractRemoteInfo(metadata.uri, o.networkFsTypes) ?? extractRemoteInfo(metadata.mountFrom, o.networkFsTypes) ?? (isWindows ? parseUNCPath(o.mountPoint) : void 0);
   debug("[getVolumeMetadata] extracted remote info: %o", remoteInfo);
-  remote ||= isRemoteFsType(metadata.fstype) || (remoteInfo?.remote ?? metadata.remote ?? false);
+  remote ||= isRemoteFsType(metadata.fstype, o.networkFsTypes) || (remoteInfo?.remote ?? metadata.remote ?? false);
   debug("[getVolumeMetadata] assembling: %o", {
     status,
     mtabInfo,
@@ -1436,7 +1512,9 @@ function setHidden(pathname, hidden, method = "auto") {
 export {
   IncludeSystemVolumesDefault,
   LinuxMountTablePathsDefault,
+  NetworkFsTypesDefault,
   OptionsDefault,
+  SkipNetworkVolumesDefault,
   SystemFsTypesDefault,
   SystemPathPatternsDefault,
   VolumeHealthStatuses,