chore: Mark PrimaryDirectoryPath & StorageVolumesDirectoryPaths as deprecated

- This library shouldn't care about where the media comes from and the fact that `StorageVolumesDirectoryPaths` might not return everything.

Author: cyanChill

CHANGELOG.md

@@ -10,10 +10,13 @@ and this project attempts to adhere to [Semantic Versioning](https://semver.org/
 ### ⚡ Changes
 
 - Bumped AndroidX media3 to `1.6.1` from `1.5.1`.
+- Mark `PrimaryDirectoryPath` & `StorageVolumesDirectoryPaths` as deprecated.
+  - This library shouldn't care about where the media comes from and the fact that `StorageVolumesDirectoryPaths` might not return everything.
+  - Will be removed in `v1.0.0`.
 
 ### Other
 
-- Validate that the New Architecture works in example app.
+- Validate that the New Architecture works in the example app.
   - Required a workaround for CMAKE due to long paths in Windows.
 
 ## [0.8.0] - 2025-02-13

README.md

@@ -40,6 +40,9 @@ const base64Artwork = await getArtwork(uri);
 
 ## Constants
 
+> [!CAUTION]  
+> All exported constants relating to directory paths from this library will be deprecated in `v1.0.0`.
+
 ### MediaMetadataPublicFields
 
 ```ts
@@ -64,15 +67,15 @@ const MusicDirectoryPath: string | null;
 
 Default path to the `Music` folder on device. This is usually `/storage/emulated/0/Music` or `/sdcard/Music` for older devices.
 
-### PrimaryDirectoryPath
+### [Deprecated] PrimaryDirectoryPath
 
 ```ts
 const PrimaryDirectoryPath: string;
 ```
 
 Path to the primary shared/external storage directory. This is usually `/storage/emulated/0`.
 
-### StorageVolumesDirectoryPaths
+### [Deprecated] StorageVolumesDirectoryPaths
 
 ```ts
 const StorageVolumesDirectoryPaths: string[];

src/NativeMetadataRetriever.ts

@@ -7,13 +7,15 @@ export interface Spec extends TurboModule {
      * Path of primary storage volume on device.
      *
      * @example `"/storage/emulated/0"`
+     * @deprecated
      */
     PrimaryDirectoryPath: string;
     /**
      * Array of directory paths for all shared/external storage volumes.
      *
      * @example `["/storage/emulated/0", "/storage/0A08-1F1A"]`
      * @see https://developer.android.com/reference/android/content/Context#getExternalFilesDirs(java.lang.String)
+     * @deprecated
      */
     StorageVolumesDirectoryPaths: string[];
     /**

src/index.ts

@@ -41,6 +41,8 @@ export {
   // System paths.
   /** @deprecated */
   MusicDirectoryPath,
+  /** @deprecated */
   PrimaryDirectoryPath,
+  /** @deprecated */
   StorageVolumesDirectoryPaths,
 };