expo-media-library 18.2.0 → 18.3.0-canary-20250919-7a31b96

package/CHANGELOG.md

@@ -6,10 +6,17 @@
 
 ### 🎉 New features
 
+- [next] Add `Album.get(title)` ([#39717](https://github.com/expo/expo/pull/39717) by [@Wenszel](https://github.com/Wenszel))
+
 ### 🐛 Bug fixes
 
+- [next][android] Change default root directory to Pictures ([#39716](https://github.com/expo/expo/pull/39716) by [@Wenszel](https://github.com/Wenszel))
+- [next] Fix `asset.getModificationTime` to return milliseconds ([#39715](https://github.com/expo/expo/pull/39715) by [@Wenszel](https://github.com/Wenszel))
+
 ### 💡 Others
 
+- [next] Add documentation ([#39754](https://github.com/expo/expo/pull/39754) by [@Wenszel](https://github.com/Wenszel))
+
 ## 18.2.0 — 2025-09-16
 
 ### 🎉 New features

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '18.2.0'
+version = '18.3.0-canary-20250919-7a31b96'
 
 android {
   namespace "expo.modules.medialibrary"
   defaultConfig {
     versionCode 37
-    versionName "18.2.0"
+    versionName "18.3.0-canary-20250919-7a31b96"
   }
 }
 

package/android/src/main/java/expo/modules/medialibrary/next/MediaLibraryNextModule.kt

@@ -11,6 +11,7 @@ import expo.modules.kotlin.modules.ModuleDefinition
 import expo.modules.kotlin.types.Either
 import expo.modules.kotlin.types.toKClass
 import expo.modules.medialibrary.next.objects.album.Album
+import expo.modules.medialibrary.next.objects.album.AlbumQuery
 import expo.modules.medialibrary.next.objects.asset.Asset
 import expo.modules.medialibrary.next.objects.album.factories.AlbumModernFactory
 import expo.modules.medialibrary.next.objects.album.factories.AlbumLegacyFactory
@@ -38,6 +39,10 @@ class MediaLibraryNextModule : Module() {
     MediaStorePermissionsDelegate(appContext)
   }
 
+  private val albumQuery by lazy {
+    AlbumQuery(context)
+  }
+
   private val albumFactory by lazy {
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
       AlbumModernFactory(assetFactory, context)
@@ -164,29 +169,29 @@ class MediaLibraryNextModule : Module() {
         self.album(album)
       }
 
-      Function("eq") { self: Query, field: AssetField, value: Either<MediaType, Int> ->
-        self.eq(field, MediaStoreQueryFormatter.parse(value))
+      Function("eq") { self: Query, field: AssetField, value: Either<MediaType, Long> ->
+        self.eq(field, MediaStoreQueryFormatter.parse(field, value))
       }
 
-      Function("within") { self: Query, field: AssetField, values: List<Either<MediaType, Int>> ->
-        val stringValues = values.map { value -> MediaStoreQueryFormatter.parse(value) }
+      Function("within") { self: Query, field: AssetField, values: List<Either<MediaType, Long>> ->
+        val stringValues = values.map { value -> MediaStoreQueryFormatter.parse(field, value) }
         self.within(field, stringValues)
       }
 
-      Function("gt") { self: Query, field: AssetField, value: Int ->
-        self.gt(field, MediaStoreQueryFormatter.parse(value))
+      Function("gt") { self: Query, field: AssetField, value: Long ->
+        self.gt(field, MediaStoreQueryFormatter.parse(field, value))
       }
 
-      Function("gte") { self: Query, field: AssetField, value: Int ->
-        self.gte(field, MediaStoreQueryFormatter.parse(value))
+      Function("gte") { self: Query, field: AssetField, value: Long ->
+        self.gte(field, MediaStoreQueryFormatter.parse(field, value))
       }
 
-      Function("lt") { self: Query, field: AssetField, value: Int ->
-        self.lt(field, MediaStoreQueryFormatter.parse(value))
+      Function("lt") { self: Query, field: AssetField, value: Long ->
+        self.lt(field, MediaStoreQueryFormatter.parse(field, value))
       }
 
-      Function("lte") { self: Query, field: AssetField, value: Int ->
-        self.lte(field, MediaStoreQueryFormatter.parse(value))
+      Function("lte") { self: Query, field: AssetField, value: Long ->
+        self.lte(field, MediaStoreQueryFormatter.parse(field, value))
       }
 
       Function("orderBy") { self: Query, sortDescriptorRef: Either<AssetField, SortDescriptor> ->
@@ -221,6 +226,11 @@ class MediaLibraryNextModule : Module() {
       return@Coroutine albumFactory.createFromFilePaths(name, assetPaths)
     }
 
+    AsyncFunction("getAlbum") Coroutine { title: String ->
+      systemPermissionsDelegate.requireSystemPermissions(false)
+      albumQuery.getAlbum(title)
+    }
+
     AsyncFunction("deleteAlbums") Coroutine { albums: List<Album> ->
       systemPermissionsDelegate.requireSystemPermissions(true)
       albums.forEach { album -> album.delete() }

package/android/src/main/java/expo/modules/medialibrary/next/extensions/resolver/AlbumExtensions.kt

@@ -48,6 +48,15 @@ suspend fun ContentResolver.queryAlbumId(relativePath: RelativePath): String? =
     arrayOf(relativePath.value)
   )
 
+suspend fun ContentResolver.queryAlbumId(name: String): String? =
+  queryOne(
+    EXTERNAL_CONTENT_URI,
+    MediaStore.Files.FileColumns.BUCKET_ID,
+    Cursor::getString,
+    "${MediaStore.MediaColumns.BUCKET_DISPLAY_NAME} = ?",
+    arrayOf(name)
+  )
+
 suspend fun ContentResolver.queryAlbumAssetsContentUris(bucketId: String): List<Uri> =
   withContext(Dispatchers.IO) {
     val projection = arrayOf(

package/android/src/main/java/expo/modules/medialibrary/next/extensions/resolver/AssetExtensions.kt

@@ -17,8 +17,8 @@ import kotlinx.coroutines.withContext
 suspend fun ContentResolver.queryAssetDisplayName(contentUri: Uri): String? =
   queryOne(contentUri, MediaStore.MediaColumns.DISPLAY_NAME, Cursor::getString)
 
-suspend fun ContentResolver.queryGetCreationTime(contentUri: Uri): Long? =
-  queryOne(contentUri, MediaStore.MediaColumns.DATE_TAKEN, Cursor::getLong)
+suspend fun ContentResolver.queryAssetCreationTime(contentUri: Uri): Long? =
+  queryOne(contentUri, MediaStore.Images.Media.DATE_TAKEN, Cursor::getLong)
 
 suspend fun ContentResolver.queryAssetModificationTime(contentUri: Uri): Long? =
   queryOne(contentUri, MediaStore.MediaColumns.DATE_MODIFIED, Cursor::getLong)
@@ -38,9 +38,6 @@ suspend fun ContentResolver.queryAssetPath(contentUri: Uri): String? =
 suspend fun ContentResolver.queryAssetBucketId(contentUri: Uri): Int? =
   queryOne(contentUri, MediaStore.MediaColumns.BUCKET_ID, Cursor::getInt)
 
-suspend fun ContentResolver.queryAssetMediaType(contentUri: Uri): Int? =
-  queryOne(contentUri, MediaStore.Files.FileColumns.MEDIA_TYPE, Cursor::getInt)
-
 suspend fun ContentResolver.insertPendingAsset(
   displayName: String,
   mimeType: MimeType,

package/android/src/main/java/expo/modules/medialibrary/next/objects/album/AlbumQuery.kt

@@ -0,0 +1,22 @@
+package expo.modules.medialibrary.next.objects.album
+
+import android.content.Context
+import expo.modules.medialibrary.next.exceptions.ContentResolverNotObtainedException
+import expo.modules.medialibrary.next.extensions.getOrThrow
+import expo.modules.medialibrary.next.extensions.resolver.queryAlbumId
+import java.lang.ref.WeakReference
+
+class AlbumQuery(context: Context) {
+  private val contextRef = WeakReference(context)
+
+  private val contentResolver
+    get() = contextRef
+      .getOrThrow()
+      .contentResolver ?: throw ContentResolverNotObtainedException()
+
+  suspend fun getAlbum(title: String): Album? {
+    val id = contentResolver.queryAlbumId(title)
+      ?: return null
+    return Album(id, contextRef.getOrThrow())
+  }
+}

package/android/src/main/java/expo/modules/medialibrary/next/objects/asset/delegates/AssetLegacyDelegate.kt

@@ -19,7 +19,7 @@ import expo.modules.medialibrary.next.extensions.resolver.queryAssetHeight
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetModificationTime
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetPath
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetWidth
-import expo.modules.medialibrary.next.extensions.resolver.queryGetCreationTime
+import expo.modules.medialibrary.next.extensions.resolver.queryAssetCreationTime
 import expo.modules.medialibrary.next.extensions.safeCopy
 import expo.modules.medialibrary.next.extensions.safeMove
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
@@ -30,6 +30,8 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 import java.io.File
 import java.lang.ref.WeakReference
+import kotlin.time.DurationUnit
+import kotlin.time.toDuration
 
 @DeprecatedSinceApi(Build.VERSION_CODES.Q)
 class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
@@ -50,7 +52,7 @@ class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
 
   override suspend fun getCreationTime(): Long? {
     return contentResolver
-      .queryGetCreationTime(contentUri)
+      .queryAssetCreationTime(contentUri)
       .takeIf { it != 0L }
   }
 
@@ -98,7 +100,10 @@ class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
     MediaType.fromContentUri(contentUri)
 
   override suspend fun getModificationTime(): Long? =
-    contentResolver.queryAssetModificationTime(contentUri).takeIf { it != 0L }
+    contentResolver.queryAssetModificationTime(contentUri)
+      ?.takeIf { it != 0L }
+      ?.toDuration(DurationUnit.SECONDS)
+      ?.inWholeMilliseconds
 
   override suspend fun getMimeType(): MimeType {
     return contentResolver.getType(contentUri)?.let { MimeType(it) }

package/android/src/main/java/expo/modules/medialibrary/next/objects/asset/delegates/AssetModernDelegate.kt

@@ -18,7 +18,7 @@ import expo.modules.medialibrary.next.extensions.resolver.queryAssetHeight
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetModificationTime
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetPath
 import expo.modules.medialibrary.next.extensions.resolver.queryAssetWidth
-import expo.modules.medialibrary.next.extensions.resolver.queryGetCreationTime
+import expo.modules.medialibrary.next.extensions.resolver.queryAssetCreationTime
 import expo.modules.medialibrary.next.extensions.resolver.updateRelativePath
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
 import expo.modules.medialibrary.next.objects.asset.Asset
@@ -28,6 +28,8 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 import java.io.File
 import java.lang.ref.WeakReference
+import kotlin.time.DurationUnit
+import kotlin.time.toDuration
 
 @RequiresApi(Build.VERSION_CODES.Q)
 class AssetModernDelegate(override val contentUri: Uri, context: Context) : AssetDelegate {
@@ -40,7 +42,7 @@ class AssetModernDelegate(override val contentUri: Uri, context: Context) : Asse
 
   override suspend fun getCreationTime(): Long? {
     return contentResolver
-      .queryGetCreationTime(contentUri)
+      .queryAssetCreationTime(contentUri)
       .takeIf { it != 0L }
   }
 
@@ -88,7 +90,10 @@ class AssetModernDelegate(override val contentUri: Uri, context: Context) : Asse
     MediaType.fromContentUri(contentUri)
 
   override suspend fun getModificationTime(): Long? =
-    contentResolver.queryAssetModificationTime(contentUri).takeIf { it != 0L }
+    contentResolver.queryAssetModificationTime(contentUri)
+      ?.takeIf { it != 0L }
+      ?.toDuration(DurationUnit.SECONDS)
+      ?.inWholeMilliseconds
 
   override suspend fun getUri(): Uri {
     // e.g. storage/emulated/0/Android/data/expo/files/[ROOT_ALBUM]/[ALBUM_NAME]

package/android/src/main/java/expo/modules/medialibrary/next/objects/asset/factories/AssetLegacyFactory.kt

@@ -35,7 +35,7 @@ class AssetLegacyFactory(context: Context) : AssetFactory {
     val baseDir = if (relativePath != null) {
       File(relativePath.toFilePath())
     } else {
-      mimeType.externalStoragePublicDirectory()
+      mimeType.externalStorageAssetDirectory()
     }
     baseDir.mkdirs()
 

package/android/src/main/java/expo/modules/medialibrary/next/objects/query/MediaStoreQueryFormatter.kt

@@ -3,18 +3,24 @@ package expo.modules.medialibrary.next.objects.query
 import expo.modules.kotlin.apifeatures.EitherType
 import expo.modules.kotlin.types.Either
 import expo.modules.medialibrary.next.objects.wrappers.MediaType
+import expo.modules.medialibrary.next.records.AssetField
+import kotlin.time.DurationUnit
+import kotlin.time.toDuration
 
 @OptIn(EitherType::class)
 class MediaStoreQueryFormatter {
   companion object {
-    fun parse(value: Either<MediaType, Int>): String {
+    fun parse(field: AssetField, value: Either<MediaType, Long>): String {
       if (value.`is`(MediaType::class)) {
         return parse(value.get(MediaType::class))
       }
-      return parse(value.get(Int::class))
+      return parse(field, value.get(Long::class))
     }
 
-    fun parse(value: Int): String {
+    fun parse(field: AssetField, value: Long): String {
+      if (field == AssetField.MODIFICATION_TIME) {
+        return value.toDuration(DurationUnit.MILLISECONDS).inWholeSeconds.toString()
+      }
       return value.toString()
     }
 

package/android/src/main/java/expo/modules/medialibrary/next/objects/query/Query.kt

@@ -32,7 +32,6 @@ class Query(context: Context) : SharedObject() {
   private val args = mutableListOf<String>()
   private val orderBy = mutableListOf<SortDescriptor>()
 
-  private var album: Album? = null
   private var limit: Int? = null
   private var offset: Int? = null
 

package/android/src/main/java/expo/modules/medialibrary/next/objects/wrappers/MimeType.kt

@@ -24,15 +24,22 @@ value class MimeType(val value: String?) {
   fun isVideo(): Boolean = type == "video"
   fun isAudio(): Boolean = type == "audio"
 
-  fun rootDirectory(): String = when {
+  fun assetRootDirectory(): String = when {
     value == null -> Environment.DIRECTORY_DCIM
     isImage() || isVideo() -> Environment.DIRECTORY_DCIM
     isAudio() -> Environment.DIRECTORY_MUSIC
     else -> Environment.DIRECTORY_DCIM
   }
 
-  fun externalStoragePublicDirectory(): File =
-    Environment.getExternalStoragePublicDirectory(rootDirectory())
+  fun albumRootDirectory(): String = when {
+    value == null -> Environment.DIRECTORY_PICTURES
+    isImage() || isVideo() -> Environment.DIRECTORY_PICTURES
+    isAudio() -> Environment.DIRECTORY_MUSIC
+    else -> Environment.DIRECTORY_PICTURES
+  }
+
+  fun externalStorageAssetDirectory(): File =
+    Environment.getExternalStoragePublicDirectory(assetRootDirectory())
 
   fun mediaCollectionUri(): Uri = when {
     value == null -> EXTERNAL_CONTENT_URI

package/android/src/main/java/expo/modules/medialibrary/next/objects/wrappers/RelativePath.kt

@@ -21,10 +21,11 @@ value class RelativePath(val value: String) {
 
   companion object {
     fun create(mimeType: MimeType, albumName: String? = null): RelativePath {
-      val rootDirectory = mimeType.rootDirectory()
       if (albumName != null) {
+        val rootDirectory = mimeType.albumRootDirectory()
         return RelativePath("$rootDirectory/$albumName/")
       }
+      val rootDirectory = mimeType.assetRootDirectory()
       return RelativePath("$rootDirectory/")
     }
   }

package/build/next/index.d.ts

@@ -11,7 +11,16 @@ export declare class Asset extends ExpoMediaLibraryNext.Asset {
 export declare class Album extends ExpoMediaLibraryNext.Album {
     static create(name: string, assetsRefs: string[] | Asset[], moveAssets?: boolean): Promise<Album>;
     static delete(albums: Album[], deleteAssets?: boolean): Promise<void>;
-    static getAll(): Promise<Album[]>;
+    static get(title: string): Promise<Album | null>;
 }
+/**
+ * Asks the user to grant permissions for accessing media in user's media library.
+ * @param writeOnly
+ * @param granularPermissions - A list of [`GranularPermission`](#granularpermission) values. This parameter has an
+ * effect only on Android 13 and newer. By default, `expo-media-library` will ask for all possible permissions.
+ *
+ * > When using granular permissions with a custom config plugin configuration, make sure that all the requested permissions are included in the plugin.
+ * @return A promise that fulfils with [`PermissionResponse`](#permissionresponse) object.
+ */
 export declare function requestPermissionsAsync(writeOnly?: boolean, granularPermissions?: GranularPermission[]): Promise<PermissionResponse>;
 //# sourceMappingURL=index.d.ts.map

package/build/next/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAG5E,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,cAAc,0BAA0B,CAAC;AAEzC,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;CAAG;AAExD,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAG9D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C;AAED,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAC9B,UAAU,GAAE,OAAc,GACzB,OAAO,CAAC,KAAK,CAAC;IAMjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAGlC;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,GAAE,OAAe,EAC1B,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,GACzC,OAAO,CAAC,kBAAkB,CAAC,CAQ7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAG5E,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,cAAc,0BAA0B,CAAC;AAEzC,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;CAAG;AAExD,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IAEnD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAK9D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C;AAED,qBAAa,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IAEnD,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAC9B,UAAU,GAAE,OAAc,GACzB,OAAO,CAAC,KAAK,CAAC;IAQjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAGjD;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,GAAE,OAAe,EAC1B,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,GACzC,OAAO,CAAC,kBAAkB,CAAC,CAQ7B"}

package/build/next/index.js

@@ -5,20 +5,24 @@ export * from './MediaLibraryNext.types';
 export class Query extends ExpoMediaLibraryNext.Query {
 }
 export class Asset extends ExpoMediaLibraryNext.Asset {
+    // @hidden
     static create(filePath, album) {
         return ExpoMediaLibraryNext.createAsset(filePath, album);
     }
+    // @hidden
     static delete(assets) {
         return ExpoMediaLibraryNext.deleteAssets(assets);
     }
 }
 export class Album extends ExpoMediaLibraryNext.Album {
+    // @hidden
     static create(name, assetsRefs, moveAssets = true) {
         if (Platform.OS === 'ios') {
             return ExpoMediaLibraryNext.createAlbum(name, assetsRefs);
         }
         return ExpoMediaLibraryNext.createAlbum(name, assetsRefs, moveAssets);
     }
+    // @hidden
     static delete(albums, deleteAssets = false) {
         if (Platform.OS === 'ios') {
             return ExpoMediaLibraryNext.deleteAlbums(albums, deleteAssets);
@@ -27,10 +31,20 @@ export class Album extends ExpoMediaLibraryNext.Album {
             return ExpoMediaLibraryNext.deleteAlbums(albums);
         }
     }
-    static getAll() {
-        return ExpoMediaLibraryNext.getAllAlbums();
+    // @hidden
+    static get(title) {
+        return ExpoMediaLibraryNext.getAlbum(title);
     }
 }
+/**
+ * Asks the user to grant permissions for accessing media in user's media library.
+ * @param writeOnly
+ * @param granularPermissions - A list of [`GranularPermission`](#granularpermission) values. This parameter has an
+ * effect only on Android 13 and newer. By default, `expo-media-library` will ask for all possible permissions.
+ *
+ * > When using granular permissions with a custom config plugin configuration, make sure that all the requested permissions are included in the plugin.
+ * @return A promise that fulfils with [`PermissionResponse`](#permissionresponse) object.
+ */
 export async function requestPermissionsAsync(writeOnly = false, granularPermissions) {
     if (!ExpoMediaLibraryNext.requestPermissionsAsync) {
         throw new UnavailabilityError('MediaLibrary', 'requestPermissionsAsync');

package/build/next/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAG1D,cAAc,0BAA0B,CAAC;AAEzC,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;CAAG;AAExD,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,MAAM,CAAC,MAAM,CAAC,QAAgB,EAAE,KAAa;QAC3C,OAAO,oBAAoB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,MAAe;QAC3B,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,UAA8B,EAC9B,aAAsB,IAAI;QAE1B,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,MAAe,EAAE,eAAwB,KAAK;QAC1D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,MAAM,CAAC,MAAM;QACX,OAAO,oBAAoB,CAAC,YAAY,EAAE,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAqB,KAAK,EAC1B,mBAA0C;IAE1C,IAAI,CAAC,oBAAoB,CAAC,uBAAuB,EAAE,CAAC;QAClD,MAAM,IAAI,mBAAmB,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import { PermissionResponse, UnavailabilityError } from 'expo-modules-core';\nimport { Platform } from 'react-native';\n\nimport ExpoMediaLibraryNext from './ExpoMediaLibraryNext';\nimport { GranularPermission } from './types/GranularPermission';\n\nexport * from './MediaLibraryNext.types';\n\nexport class Query extends ExpoMediaLibraryNext.Query {}\n\nexport class Asset extends ExpoMediaLibraryNext.Asset {\n  static create(filePath: string, album?: Album): Promise<Asset> {\n    return ExpoMediaLibraryNext.createAsset(filePath, album);\n  }\n  static delete(assets: Asset[]): Promise<void> {\n    return ExpoMediaLibraryNext.deleteAssets(assets);\n  }\n}\n\nexport class Album extends ExpoMediaLibraryNext.Album {\n  static create(\n    name: string,\n    assetsRefs: string[] | Asset[],\n    moveAssets: boolean = true\n  ): Promise<Album> {\n    if (Platform.OS === 'ios') {\n      return ExpoMediaLibraryNext.createAlbum(name, assetsRefs);\n    }\n    return ExpoMediaLibraryNext.createAlbum(name, assetsRefs, moveAssets);\n  }\n  static delete(albums: Album[], deleteAssets: boolean = false): Promise<void> {\n    if (Platform.OS === 'ios') {\n      return ExpoMediaLibraryNext.deleteAlbums(albums, deleteAssets);\n    } else {\n      return ExpoMediaLibraryNext.deleteAlbums(albums);\n    }\n  }\n  static getAll(): Promise<Album[]> {\n    return ExpoMediaLibraryNext.getAllAlbums();\n  }\n}\n\nexport async function requestPermissionsAsync(\n  writeOnly: boolean = false,\n  granularPermissions?: GranularPermission[]\n): Promise<PermissionResponse> {\n  if (!ExpoMediaLibraryNext.requestPermissionsAsync) {\n    throw new UnavailabilityError('MediaLibrary', 'requestPermissionsAsync');\n  }\n  if (Platform.OS === 'android') {\n    return await ExpoMediaLibraryNext.requestPermissionsAsync(writeOnly, granularPermissions);\n  }\n  return await ExpoMediaLibraryNext.requestPermissionsAsync(writeOnly);\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAG1D,cAAc,0BAA0B,CAAC;AAEzC,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;CAAG;AAExD,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,UAAU;IACV,MAAM,CAAC,MAAM,CAAC,QAAgB,EAAE,KAAa;QAC3C,OAAO,oBAAoB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,UAAU;IACV,MAAM,CAAC,MAAM,CAAC,MAAe;QAC3B,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,KAAM,SAAQ,oBAAoB,CAAC,KAAK;IACnD,UAAU;IACV,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,UAA8B,EAC9B,aAAsB,IAAI;QAE1B,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,UAAU;IACV,MAAM,CAAC,MAAM,CAAC,MAAe,EAAE,eAAwB,KAAK;QAC1D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,UAAU;IACV,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAqB,KAAK,EAC1B,mBAA0C;IAE1C,IAAI,CAAC,oBAAoB,CAAC,uBAAuB,EAAE,CAAC;QAClD,MAAM,IAAI,mBAAmB,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import { PermissionResponse, UnavailabilityError } from 'expo-modules-core';\nimport { Platform } from 'react-native';\n\nimport ExpoMediaLibraryNext from './ExpoMediaLibraryNext';\nimport { GranularPermission } from './types/GranularPermission';\n\nexport * from './MediaLibraryNext.types';\n\nexport class Query extends ExpoMediaLibraryNext.Query {}\n\nexport class Asset extends ExpoMediaLibraryNext.Asset {\n  // @hidden\n  static create(filePath: string, album?: Album): Promise<Asset> {\n    return ExpoMediaLibraryNext.createAsset(filePath, album);\n  }\n\n  // @hidden\n  static delete(assets: Asset[]): Promise<void> {\n    return ExpoMediaLibraryNext.deleteAssets(assets);\n  }\n}\n\nexport class Album extends ExpoMediaLibraryNext.Album {\n  // @hidden\n  static create(\n    name: string,\n    assetsRefs: string[] | Asset[],\n    moveAssets: boolean = true\n  ): Promise<Album> {\n    if (Platform.OS === 'ios') {\n      return ExpoMediaLibraryNext.createAlbum(name, assetsRefs);\n    }\n    return ExpoMediaLibraryNext.createAlbum(name, assetsRefs, moveAssets);\n  }\n\n  // @hidden\n  static delete(albums: Album[], deleteAssets: boolean = false): Promise<void> {\n    if (Platform.OS === 'ios') {\n      return ExpoMediaLibraryNext.deleteAlbums(albums, deleteAssets);\n    } else {\n      return ExpoMediaLibraryNext.deleteAlbums(albums);\n    }\n  }\n\n  // @hidden\n  static get(title: string): Promise<Album | null> {\n    return ExpoMediaLibraryNext.getAlbum(title);\n  }\n}\n\n/**\n * Asks the user to grant permissions for accessing media in user's media library.\n * @param writeOnly\n * @param granularPermissions - A list of [`GranularPermission`](#granularpermission) values. This parameter has an\n * effect only on Android 13 and newer. By default, `expo-media-library` will ask for all possible permissions.\n *\n * > When using granular permissions with a custom config plugin configuration, make sure that all the requested permissions are included in the plugin.\n * @return A promise that fulfils with [`PermissionResponse`](#permissionresponse) object.\n */\nexport async function requestPermissionsAsync(\n  writeOnly: boolean = false,\n  granularPermissions?: GranularPermission[]\n): Promise<PermissionResponse> {\n  if (!ExpoMediaLibraryNext.requestPermissionsAsync) {\n    throw new UnavailabilityError('MediaLibrary', 'requestPermissionsAsync');\n  }\n  if (Platform.OS === 'android') {\n    return await ExpoMediaLibraryNext.requestPermissionsAsync(writeOnly, granularPermissions);\n  }\n  return await ExpoMediaLibraryNext.requestPermissionsAsync(writeOnly);\n}\n"]}

package/build/next/types/Album.d.ts

@@ -2,10 +2,9 @@ import { Asset } from './Asset';
 /**
  * Represents a media album (collection of assets) on the device.
  *
- * An `Album` groups together media assets (images, videos, or audio files).
- * Albums typically correspond to folders in the device’s gallery or media store.
- *
+ * An {@link Album} groups together media assets (images, videos, or audio files).
  * To create a new album, use {@link Album.create}.
+ * To fetch an existing album, use {@link Album.get}.
  */
 export declare class Album {
     /**
@@ -15,11 +14,11 @@ export declare class Album {
     constructor(id: string);
     /**
      * Unique identifier of the album.
-     * Can be used to re-instantiate an `Album` later or to query related objects.
+     * Can be used to re-instantiate an {@link Album} later.
      */
     id: string;
     /**
-     * Retrieves all assets contained in this album.
+     * Retrieves all assets contained in the album.
      * @returns A promise resolving to an array of {@link Asset} objects.
      *
      * @example
@@ -31,6 +30,7 @@ export declare class Album {
     getAssets(): Promise<Asset[]>;
     /**
      * Gets the display title (name) of the album.
+     * Note that album titles are not guaranteed to be unique.
      * @returns A promise resolving to the album’s title string.
      *
      * @example
@@ -42,9 +42,10 @@ export declare class Album {
     getTitle(): Promise<string>;
     /**
      * Permanently deletes the album from the device.
-     * Depending on platform and options, this may also delete contained assets.
-     *
+     * On Android, it deletes the album and all its assets.
+     * On iOS, it deletes the album but keeps the assets in the main library.
      * @returns A promise that resolves once the deletion has completed.
+     * @throws An exception if the deletion fails or the album could not be found.
      *
      * @example
      * ```ts
@@ -53,7 +54,7 @@ export declare class Album {
      */
     delete(): Promise<void>;
     /**
-     * Adds a given asset to this album.
+     * Adds an asset to the album.
      * @param asset - The {@link Asset} to add.
      * @returns A promise that resolves once the asset has been added.
      *
@@ -65,12 +66,12 @@ export declare class Album {
      */
     add(asset: Asset): Promise<void>;
     /**
-     * Creates a new album with a given name and optional assets.
-     * If an album with the same name already exists, behavior may depend on the platform.
+     * A static function. Creates a new album with a given name and assets.
+     * On Android, if assets are provided and `moveAssets` is true, the assets will be moved into the new album. If false or not supported, the assets will be copied.
      *
-     * @param title - Name of the new album.
-     * @param assetsOrPaths - Optional list of {@link Asset} objects or file paths to include.
-     * @param deleteOriginalAsset - Whether to copy assets into the album (if supported). Defaults to `false`.
+     * @param name - Name of the new album.
+     * @param assetsRefs - List of {@link Asset} objects or file paths (file:///...) to include.
+     * @param moveAssets - On Android, whether to move assets into the album.
      * @returns A promise resolving to the created {@link Album}.
      *
      * @example
@@ -79,13 +80,33 @@ export declare class Album {
      * console.log(await album.getTitle()); // "My Album"
      * ```
      */
-    static create(title: string, assetsOrPaths?: (Asset | string)[], deleteOriginalAsset?: boolean): Promise<Album>;
+    static create(name: string, assetsRefs: string[] | Asset[], moveAssets: boolean): Promise<Album>;
     /**
-     * Deletes multiple albums at once.
+     * A static function. Deletes multiple albums at once.
      * @param albums - An array of {@link Album} instances to delete.
-     * @param deleteAssets - If `true`, also deletes assets contained in these albums (if supported).
+     * @param deleteAssets - Whether to delete the assets in the albums as well.
      * @returns A promise that resolves once the albums have been deleted.
+     *
+     * @example
+     * ```ts
+     * const album = await Album.create("My Album", [asset]);
+     * await Album.delete([album]);
+     * ```
+     */
+    static delete(albums: Album[], deleteAssets: boolean): Promise<void>;
+    /**
+     * A static function. Retrieves an album by its title.
+     * @param title - The title of the album to retrieve.
+     * @return A promise resolving to the {@link Album} if found, or `null` if not found.
+     *
+     * @example
+     * ```ts
+     * const album = await Album.get("Camera");
+     * if (album) {
+     *   console.log(await album.getTitle()); // "Camera"
+     * }
+     * ```
      */
-    static deleteMany(albums: Album[], deleteAssets?: boolean): Promise<void>;
+    static get(title: string): Promise<Album | null>;
 }
 //# sourceMappingURL=Album.d.ts.map

package/build/next/types/Album.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Album.d.ts","sourceRoot":"","sources":["../../../src/next/types/Album.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB;;;OAGG;gBACS,EAAE,EAAE,MAAM;IAEtB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;;;;OASG;IACH,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAE7B;;;;;;;;;OASG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,CACX,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,EAClC,mBAAmB,CAAC,EAAE,OAAO,GAC5B,OAAO,CAAC,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAC1E"}
+{"version":3,"file":"Album.d.ts","sourceRoot":"","sources":["../../../src/next/types/Album.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB;;;OAGG;gBACS,EAAE,EAAE,MAAM;IAEtB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;;;;OASG;IACH,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAE7B;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAEhG;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CACjD"}

package/build/next/types/Album.js.map

@@ -1 +1 @@
-{"version":3,"file":"Album.js","sourceRoot":"","sources":["../../../src/next/types/Album.ts"],"names":[],"mappings":"","sourcesContent":["import { Asset } from './Asset';\n\n/**\n * Represents a media album (collection of assets) on the device.\n *\n * An `Album` groups together media assets (images, videos, or audio files).\n * Albums typically correspond to folders in the device’s gallery or media store.\n *\n * To create a new album, use {@link Album.create}.\n */\nexport declare class Album {\n  /**\n   * Reinitialize an instance of an album with a given ID.\n   * @param id - The unique identifier of the album.\n   */\n  constructor(id: string);\n\n  /**\n   * Unique identifier of the album.\n   * Can be used to re-instantiate an `Album` later or to query related objects.\n   */\n  id: string;\n\n  /**\n   * Retrieves all assets contained in this album.\n   * @returns A promise resolving to an array of {@link Asset} objects.\n   *\n   * @example\n   * ```ts\n   * const assets = await album.getAssets();\n   * console.log(assets.length);\n   * ```\n   */\n  getAssets(): Promise<Asset[]>;\n\n  /**\n   * Gets the display title (name) of the album.\n   * @returns A promise resolving to the album’s title string.\n   *\n   * @example\n   * ```ts\n   * const title = await album.getTitle();\n   * console.log(title); // \"Camera\"\n   * ```\n   */\n  getTitle(): Promise<string>;\n\n  /**\n   * Permanently deletes the album from the device.\n   * Depending on platform and options, this may also delete contained assets.\n   *\n   * @returns A promise that resolves once the deletion has completed.\n   *\n   * @example\n   * ```ts\n   * await album.delete();\n   * ```\n   */\n  delete(): Promise<void>;\n\n  /**\n   * Adds a given asset to this album.\n   * @param asset - The {@link Asset} to add.\n   * @returns A promise that resolves once the asset has been added.\n   *\n   * @example\n   * ```ts\n   * const asset = await Asset.create(\"file:///path/to/photo.png\");\n   * await album.add(asset);\n   * ```\n   */\n  add(asset: Asset): Promise<void>;\n\n  /**\n   * Creates a new album with a given name and optional assets.\n   * If an album with the same name already exists, behavior may depend on the platform.\n   *\n   * @param title - Name of the new album.\n   * @param assetsOrPaths - Optional list of {@link Asset} objects or file paths to include.\n   * @param deleteOriginalAsset - Whether to copy assets into the album (if supported). Defaults to `false`.\n   * @returns A promise resolving to the created {@link Album}.\n   *\n   * @example\n   * ```ts\n   * const album = await Album.create(\"My Album\", [asset]);\n   * console.log(await album.getTitle()); // \"My Album\"\n   * ```\n   */\n  static create(\n    title: string,\n    assetsOrPaths?: (Asset | string)[],\n    deleteOriginalAsset?: boolean\n  ): Promise<Album>;\n\n  /**\n   * Deletes multiple albums at once.\n   * @param albums - An array of {@link Album} instances to delete.\n   * @param deleteAssets - If `true`, also deletes assets contained in these albums (if supported).\n   * @returns A promise that resolves once the albums have been deleted.\n   */\n  static deleteMany(albums: Album[], deleteAssets?: boolean): Promise<void>;\n}\n"]}
+{"version":3,"file":"Album.js","sourceRoot":"","sources":["../../../src/next/types/Album.ts"],"names":[],"mappings":"","sourcesContent":["import { Asset } from './Asset';\n\n/**\n * Represents a media album (collection of assets) on the device.\n *\n * An {@link Album} groups together media assets (images, videos, or audio files).\n * To create a new album, use {@link Album.create}.\n * To fetch an existing album, use {@link Album.get}.\n */\nexport declare class Album {\n  /**\n   * Reinitialize an instance of an album with a given ID.\n   * @param id - The unique identifier of the album.\n   */\n  constructor(id: string);\n\n  /**\n   * Unique identifier of the album.\n   * Can be used to re-instantiate an {@link Album} later.\n   */\n  id: string;\n\n  /**\n   * Retrieves all assets contained in the album.\n   * @returns A promise resolving to an array of {@link Asset} objects.\n   *\n   * @example\n   * ```ts\n   * const assets = await album.getAssets();\n   * console.log(assets.length);\n   * ```\n   */\n  getAssets(): Promise<Asset[]>;\n\n  /**\n   * Gets the display title (name) of the album.\n   * Note that album titles are not guaranteed to be unique.\n   * @returns A promise resolving to the album’s title string.\n   *\n   * @example\n   * ```ts\n   * const title = await album.getTitle();\n   * console.log(title); // \"Camera\"\n   * ```\n   */\n  getTitle(): Promise<string>;\n\n  /**\n   * Permanently deletes the album from the device.\n   * On Android, it deletes the album and all its assets.\n   * On iOS, it deletes the album but keeps the assets in the main library.\n   * @returns A promise that resolves once the deletion has completed.\n   * @throws An exception if the deletion fails or the album could not be found.\n   *\n   * @example\n   * ```ts\n   * await album.delete();\n   * ```\n   */\n  delete(): Promise<void>;\n\n  /**\n   * Adds an asset to the album.\n   * @param asset - The {@link Asset} to add.\n   * @returns A promise that resolves once the asset has been added.\n   *\n   * @example\n   * ```ts\n   * const asset = await Asset.create(\"file:///path/to/photo.png\");\n   * await album.add(asset);\n   * ```\n   */\n  add(asset: Asset): Promise<void>;\n\n  /**\n   * A static function. Creates a new album with a given name and assets.\n   * On Android, if assets are provided and `moveAssets` is true, the assets will be moved into the new album. If false or not supported, the assets will be copied.\n   *\n   * @param name - Name of the new album.\n   * @param assetsRefs - List of {@link Asset} objects or file paths (file:///...) to include.\n   * @param moveAssets - On Android, whether to move assets into the album.\n   * @returns A promise resolving to the created {@link Album}.\n   *\n   * @example\n   * ```ts\n   * const album = await Album.create(\"My Album\", [asset]);\n   * console.log(await album.getTitle()); // \"My Album\"\n   * ```\n   */\n  static create(name: string, assetsRefs: string[] | Asset[], moveAssets: boolean): Promise<Album>;\n\n  /**\n   * A static function. Deletes multiple albums at once.\n   * @param albums - An array of {@link Album} instances to delete.\n   * @param deleteAssets - Whether to delete the assets in the albums as well.\n   * @returns A promise that resolves once the albums have been deleted.\n   *\n   * @example\n   * ```ts\n   * const album = await Album.create(\"My Album\", [asset]);\n   * await Album.delete([album]);\n   * ```\n   */\n  static delete(albums: Album[], deleteAssets: boolean): Promise<void>;\n\n  /**\n   * A static function. Retrieves an album by its title.\n   * @param title - The title of the album to retrieve.\n   * @return A promise resolving to the {@link Album} if found, or `null` if not found.\n   *\n   * @example\n   * ```ts\n   * const album = await Album.get(\"Camera\");\n   * if (album) {\n   *   console.log(await album.getTitle()); // \"Camera\"\n   * }\n   * ```\n   */\n  static get(title: string): Promise<Album | null>;\n}\n"]}