@photostructure/fs-metadata 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -132,6 +132,18 @@ interface MountPoint {
  * @see {@link OptionsDefault} for the default values
  */
 interface Options {
+    /**
+     * Pre-fetched mount points to use instead of querying the system.
+     *
+     * When provided, functions like {@link getMountPointForPath} and
+     * {@link getVolumeMetadataForPath} will use these mount points for device ID
+     * matching instead of calling {@link getVolumeMountPoints} internally. This
+     * avoids redundant system queries when resolving multiple paths.
+     *
+     * Obtain via `getVolumeMountPoints({ includeSystemVolumes: true })` — system
+     * volumes must be included for device ID matching to work correctly.
+     */
+    mountPoints?: MountPoint[];
     /**
      * Timeout in milliseconds for filesystem operations.
      *
@@ -367,7 +379,7 @@ declare function getVolumeMetadata(mountPoint: string, opts?: Partial<Pick<Optio
  * @param pathname Path to any file or directory
  * @param opts Optional filesystem operation settings
  */
-declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<VolumeMetadata>;
+declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<VolumeMetadata>;
 /**
  * Get the mount point path for an arbitrary file or directory path.
  *
@@ -383,7 +395,7 @@ declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<
  * @param opts Optional settings (timeoutMs, linuxMountTablePaths)
  * @returns The mount point path (e.g., "/", "/System/Volumes/Data", "C:\\")
  */
-declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<string>;
+declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<string>;
 /**
  * Retrieves metadata for all mounted volumes with optional filtering and
  * concurrency control.

package/dist/index.d.mts

@@ -132,6 +132,18 @@ interface MountPoint {
  * @see {@link OptionsDefault} for the default values
  */
 interface Options {
+    /**
+     * Pre-fetched mount points to use instead of querying the system.
+     *
+     * When provided, functions like {@link getMountPointForPath} and
+     * {@link getVolumeMetadataForPath} will use these mount points for device ID
+     * matching instead of calling {@link getVolumeMountPoints} internally. This
+     * avoids redundant system queries when resolving multiple paths.
+     *
+     * Obtain via `getVolumeMountPoints({ includeSystemVolumes: true })` — system
+     * volumes must be included for device ID matching to work correctly.
+     */
+    mountPoints?: MountPoint[];
     /**
      * Timeout in milliseconds for filesystem operations.
      *
@@ -367,7 +379,7 @@ declare function getVolumeMetadata(mountPoint: string, opts?: Partial<Pick<Optio
  * @param pathname Path to any file or directory
  * @param opts Optional filesystem operation settings
  */
-declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<VolumeMetadata>;
+declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<VolumeMetadata>;
 /**
  * Get the mount point path for an arbitrary file or directory path.
  *
@@ -383,7 +395,7 @@ declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<
  * @param opts Optional settings (timeoutMs, linuxMountTablePaths)
  * @returns The mount point path (e.g., "/", "/System/Volumes/Data", "C:\\")
  */
-declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<string>;
+declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<string>;
 /**
  * Retrieves metadata for all mounted volumes with optional filtering and
  * concurrency control.

package/dist/index.d.ts

@@ -132,6 +132,18 @@ interface MountPoint {
  * @see {@link OptionsDefault} for the default values
  */
 interface Options {
+    /**
+     * Pre-fetched mount points to use instead of querying the system.
+     *
+     * When provided, functions like {@link getMountPointForPath} and
+     * {@link getVolumeMetadataForPath} will use these mount points for device ID
+     * matching instead of calling {@link getVolumeMountPoints} internally. This
+     * avoids redundant system queries when resolving multiple paths.
+     *
+     * Obtain via `getVolumeMountPoints({ includeSystemVolumes: true })` — system
+     * volumes must be included for device ID matching to work correctly.
+     */
+    mountPoints?: MountPoint[];
     /**
      * Timeout in milliseconds for filesystem operations.
      *
@@ -367,7 +379,7 @@ declare function getVolumeMetadata(mountPoint: string, opts?: Partial<Pick<Optio
  * @param pathname Path to any file or directory
  * @param opts Optional filesystem operation settings
  */
-declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<VolumeMetadata>;
+declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<VolumeMetadata>;
 /**
  * Get the mount point path for an arbitrary file or directory path.
  *
@@ -383,7 +395,7 @@ declare function getVolumeMetadataForPath(pathname: string, opts?: Partial<Pick<
  * @param opts Optional settings (timeoutMs, linuxMountTablePaths)
  * @returns The mount point path (e.g., "/", "/System/Volumes/Data", "C:\\")
  */
-declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths">>): Promise<string>;
+declare function getMountPointForPath(pathname: string, opts?: Partial<Pick<Options, "timeoutMs" | "linuxMountTablePaths" | "mountPoints">>): Promise<string>;
 /**
  * Retrieves metadata for all mounted volumes with optional filtering and
  * concurrency control.

package/dist/index.mjs

@@ -1457,7 +1457,7 @@ async function getVolumeMetadataForPathImpl(pathname, opts, nativeFn2) {
 }
 async function findMountPointByDeviceId(resolved, resolvedStat, opts, nativeFn2) {
   const targetDev = resolvedStat.dev;
-  const mountPoints = await getVolumeMountPointsImpl(
+  const mountPoints = opts.mountPoints ?? await getVolumeMountPointsImpl(
     { ...opts, includeSystemVolumes: true },
     nativeFn2
   );