expo-media-library 18.1.1 → 18.2.0

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 18.2.0 — 2025-09-16
+
+### 🎉 New features
+
+- [next] Add Query ([#39559](https://github.com/expo/expo/pull/39559) by [@Wenszel](https://github.com/Wenszel))
+
 ## 18.1.1 — 2025-09-10
 
 ### 💡 Others

package/android/build.gradle

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

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

@@ -16,10 +16,16 @@ import expo.modules.medialibrary.next.objects.album.factories.AlbumModernFactory
 import expo.modules.medialibrary.next.objects.album.factories.AlbumLegacyFactory
 import expo.modules.medialibrary.next.objects.asset.factories.AssetModernFactory
 import expo.modules.medialibrary.next.objects.asset.factories.AssetLegacyFactory
+import expo.modules.medialibrary.next.objects.query.MediaStoreQueryFormatter
+import expo.modules.medialibrary.next.objects.query.Query
+import expo.modules.medialibrary.next.objects.wrappers.MediaType
 import expo.modules.medialibrary.next.permissions.MediaStorePermissionsDelegate
 import expo.modules.medialibrary.next.permissions.SystemPermissionsDelegate
 import expo.modules.medialibrary.next.permissions.enums.GranularPermission
+import expo.modules.medialibrary.next.records.AssetField
+import expo.modules.medialibrary.next.records.SortDescriptor
 
+@OptIn(EitherType::class)
 class MediaLibraryNextModule : Module() {
   private val context
     get() = appContext.reactContext ?: throw Exceptions.ReactContextLost()
@@ -141,6 +147,63 @@ class MediaLibraryNextModule : Module() {
       }
     }
 
+    Class(Query::class) {
+      Constructor {
+        Query(context)
+      }
+
+      Function("limit") { self: Query, limit: Int ->
+        self.limit(limit)
+      }
+
+      Function("offset") { self: Query, offset: Int ->
+        self.offset(offset)
+      }
+
+      Function("album") { self: Query, album: Album ->
+        self.album(album)
+      }
+
+      Function("eq") { self: Query, field: AssetField, value: Either<MediaType, Int> ->
+        self.eq(field, MediaStoreQueryFormatter.parse(value))
+      }
+
+      Function("within") { self: Query, field: AssetField, values: List<Either<MediaType, Int>> ->
+        val stringValues = values.map { value -> MediaStoreQueryFormatter.parse(value) }
+        self.within(field, stringValues)
+      }
+
+      Function("gt") { self: Query, field: AssetField, value: Int ->
+        self.gt(field, MediaStoreQueryFormatter.parse(value))
+      }
+
+      Function("gte") { self: Query, field: AssetField, value: Int ->
+        self.gte(field, MediaStoreQueryFormatter.parse(value))
+      }
+
+      Function("lt") { self: Query, field: AssetField, value: Int ->
+        self.lt(field, MediaStoreQueryFormatter.parse(value))
+      }
+
+      Function("lte") { self: Query, field: AssetField, value: Int ->
+        self.lte(field, MediaStoreQueryFormatter.parse(value))
+      }
+
+      Function("orderBy") { self: Query, sortDescriptorRef: Either<AssetField, SortDescriptor> ->
+        if (sortDescriptorRef.`is`(AssetField::class)) {
+          val assetField = sortDescriptorRef.get(AssetField::class)
+          val descriptor = SortDescriptor(assetField)
+          return@Function self.orderBy(descriptor)
+        }
+        val descriptor = sortDescriptorRef.get(SortDescriptor::class)
+        return@Function self.orderBy(descriptor)
+      }
+
+      AsyncFunction("exe") Coroutine { self: Query ->
+        return@Coroutine self.exe()
+      }
+    }
+
     AsyncFunction("createAsset") Coroutine { filePath: Uri, album: Album? ->
       systemPermissionsDelegate.requireSystemPermissions(true)
       return@Coroutine assetFactory.create(filePath, album?.getRelativePath())

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

@@ -0,0 +1,6 @@
+package expo.modules.medialibrary.next.exceptions
+
+import expo.modules.kotlin.exception.CodedException
+
+class QueryCouldNotBeExecuted(message: String, cause: Throwable? = null) :
+  CodedException("Could not execute a query $message", cause)

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

@@ -18,25 +18,28 @@ 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.Images.Media.DATE_TAKEN, Cursor::getLong)
+  queryOne(contentUri, MediaStore.MediaColumns.DATE_TAKEN, Cursor::getLong)
 
 suspend fun ContentResolver.queryAssetModificationTime(contentUri: Uri): Long? =
-  queryOne(contentUri, MediaStore.Images.Media.DATE_MODIFIED, Cursor::getLong)
+  queryOne(contentUri, MediaStore.MediaColumns.DATE_MODIFIED, Cursor::getLong)
 
 suspend fun ContentResolver.queryAssetDuration(contentUri: Uri): Long? =
   queryOne(contentUri, MediaStore.Video.VideoColumns.DURATION, Cursor::getLong)
 
 suspend fun ContentResolver.queryAssetWidth(contentUri: Uri): Int? =
-  queryOne(contentUri, MediaStore.Images.Media.WIDTH, Cursor::getInt)
+  queryOne(contentUri, MediaStore.MediaColumns.WIDTH, Cursor::getInt)
 
 suspend fun ContentResolver.queryAssetHeight(contentUri: Uri): Int? =
-  queryOne(contentUri, MediaStore.Images.Media.HEIGHT, Cursor::getInt)
+  queryOne(contentUri, MediaStore.MediaColumns.HEIGHT, Cursor::getInt)
 
 suspend fun ContentResolver.queryAssetPath(contentUri: Uri): String? =
   queryOne(contentUri, MediaStore.Files.FileColumns.DATA, Cursor::getString)
 
 suspend fun ContentResolver.queryAssetBucketId(contentUri: Uri): Int? =
-  queryOne(contentUri, MediaStore.Images.Media.BUCKET_ID, Cursor::getInt)
+  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,

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

@@ -8,6 +8,7 @@ import expo.modules.medialibrary.next.extensions.getOrThrow
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
 import expo.modules.medialibrary.next.objects.asset.delegates.AssetLegacyDelegate
 import expo.modules.medialibrary.next.objects.asset.delegates.AssetModernDelegate
+import expo.modules.medialibrary.next.objects.wrappers.MediaType
 import expo.modules.medialibrary.next.objects.wrappers.MimeType
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
@@ -42,7 +43,7 @@ class Asset(contentUri: Uri, context: Context) : SharedObject() {
   suspend fun getWidth(): Int =
     assetDelegate.getWidth()
 
-  suspend fun getMediaType(): String =
+  suspend fun getMediaType(): MediaType =
     assetDelegate.getMediaType()
 
   suspend fun getModificationTime(): Long? =

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

@@ -3,6 +3,7 @@ package expo.modules.medialibrary.next.objects.asset.delegates
 import android.net.Uri
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
 import expo.modules.medialibrary.next.objects.asset.Asset
+import expo.modules.medialibrary.next.objects.wrappers.MediaType
 import expo.modules.medialibrary.next.objects.wrappers.MimeType
 
 interface AssetDelegate {
@@ -12,7 +13,7 @@ interface AssetDelegate {
   suspend fun getFilename(): String
   suspend fun getHeight(): Int
   suspend fun getWidth(): Int
-  suspend fun getMediaType(): String
+  suspend fun getMediaType(): MediaType
   suspend fun getModificationTime(): Long?
   suspend fun getUri(): Uri
   suspend fun getMimeType(): MimeType

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

@@ -24,6 +24,7 @@ import expo.modules.medialibrary.next.extensions.safeCopy
 import expo.modules.medialibrary.next.extensions.safeMove
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
 import expo.modules.medialibrary.next.objects.asset.Asset
+import expo.modules.medialibrary.next.objects.wrappers.MediaType
 import expo.modules.medialibrary.next.objects.wrappers.MimeType
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
@@ -71,7 +72,7 @@ class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
     val height = contentResolver.queryAssetHeight(contentUri)
       ?: throw AssetPropertyNotFoundException("Height")
     // If height is not saved to the database
-    if (getMediaType().contains("image") && height <= 0) {
+    if (getMediaType() == MediaType.IMAGE && height <= 0) {
       return downloadBitmapAndGet { it.outHeight }
     }
     return height
@@ -80,7 +81,7 @@ class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
   override suspend fun getWidth(): Int {
     val width = contentResolver.queryAssetWidth(contentUri)
       ?: throw AssetPropertyNotFoundException("Width")
-    if (getMediaType().contains("image") && width <= 0) {
+    if (getMediaType() == MediaType.IMAGE && width <= 0) {
       return downloadBitmapAndGet { it.outWidth }
     }
     return width
@@ -93,9 +94,8 @@ class AssetLegacyDelegate(contentUri: Uri, context: Context) : AssetDelegate {
     return extract(options)
   }
 
-  override suspend fun getMediaType(): String =
-    contentResolver.getType(contentUri)
-      ?: throw AssetPropertyNotFoundException("MediaType")
+  override suspend fun getMediaType(): MediaType =
+    MediaType.fromContentUri(contentUri)
 
   override suspend fun getModificationTime(): Long? =
     contentResolver.queryAssetModificationTime(contentUri).takeIf { it != 0L }

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

@@ -22,6 +22,7 @@ import expo.modules.medialibrary.next.extensions.resolver.queryGetCreationTime
 import expo.modules.medialibrary.next.extensions.resolver.updateRelativePath
 import expo.modules.medialibrary.next.objects.wrappers.RelativePath
 import expo.modules.medialibrary.next.objects.asset.Asset
+import expo.modules.medialibrary.next.objects.wrappers.MediaType
 import expo.modules.medialibrary.next.objects.wrappers.MimeType
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
@@ -61,7 +62,7 @@ class AssetModernDelegate(override val contentUri: Uri, context: Context) : Asse
     val height = contentResolver.queryAssetHeight(contentUri)
       ?: throw AssetPropertyNotFoundException("Height")
     // If height is not saved to the database
-    if (getMediaType().contains("image") && height <= 0) {
+    if (getMediaType() == MediaType.IMAGE && height <= 0) {
       return downloadBitmapAndGet { it.outHeight }
     }
     return height
@@ -70,7 +71,7 @@ class AssetModernDelegate(override val contentUri: Uri, context: Context) : Asse
   override suspend fun getWidth(): Int {
     val width = contentResolver.queryAssetWidth(contentUri)
       ?: throw AssetPropertyNotFoundException("Width")
-    if (getMediaType().contains("image") && width <= 0) {
+    if (getMediaType() == MediaType.IMAGE && width <= 0) {
       return downloadBitmapAndGet { it.outWidth }
     }
     return width
@@ -83,9 +84,8 @@ class AssetModernDelegate(override val contentUri: Uri, context: Context) : Asse
     return extract(options)
   }
 
-  override suspend fun getMediaType(): String =
-    contentResolver.getType(contentUri)
-      ?: throw AssetPropertyNotFoundException("MediaType")
+  override suspend fun getMediaType(): MediaType =
+    MediaType.fromContentUri(contentUri)
 
   override suspend fun getModificationTime(): Long? =
     contentResolver.queryAssetModificationTime(contentUri).takeIf { it != 0L }

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

@@ -0,0 +1,25 @@
+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
+
+@OptIn(EitherType::class)
+class MediaStoreQueryFormatter {
+  companion object {
+    fun parse(value: Either<MediaType, Int>): String {
+      if (value.`is`(MediaType::class)) {
+        return parse(value.get(MediaType::class))
+      }
+      return parse(value.get(Int::class))
+    }
+
+    fun parse(value: Int): String {
+      return value.toString()
+    }
+
+    fun parse(value: MediaType): String {
+      return value.toMediaStoreValue().toString()
+    }
+  }
+}

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

@@ -0,0 +1,109 @@
+package expo.modules.medialibrary.next.objects.query
+
+import android.content.Context
+import android.os.Build
+import android.provider.MediaStore
+import expo.modules.kotlin.sharedobjects.SharedObject
+import expo.modules.medialibrary.next.exceptions.ContentResolverNotObtainedException
+import expo.modules.medialibrary.next.extensions.asIterable
+import expo.modules.medialibrary.next.extensions.getOrThrow
+import expo.modules.medialibrary.next.extensions.resolver.extractAssetContentUri
+import expo.modules.medialibrary.next.objects.album.Album
+import expo.modules.medialibrary.next.objects.asset.Asset
+import expo.modules.medialibrary.next.objects.query.builder.QueryLegacyExecutor
+import expo.modules.medialibrary.next.objects.query.builder.QueryModernExecutor
+import expo.modules.medialibrary.next.records.AssetField
+import expo.modules.medialibrary.next.records.SortDescriptor
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.ensureActive
+import kotlinx.coroutines.withContext
+import java.lang.ref.WeakReference
+import kotlin.collections.joinToString
+
+class Query(context: Context) : SharedObject() {
+  private val contextRef = WeakReference(context)
+
+  private val contentResolver
+    get() = contextRef
+      .getOrThrow()
+      .contentResolver ?: throw ContentResolverNotObtainedException()
+
+  private val clauses = mutableListOf<String>()
+  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
+
+  fun eq(field: AssetField, value: String) = apply {
+    clauses.add("${field.toMediaStoreColumn()} = ?")
+    args.add(value)
+  }
+
+  fun within(field: AssetField, values: List<String>) = apply {
+    val questionMarks = values.joinToString(", ") { "?" }
+    clauses.add("${field.toMediaStoreColumn()} IN ($questionMarks)")
+    args.addAll(values)
+  }
+
+  fun gt(field: AssetField, value: String) = apply {
+    clauses.add("${field.toMediaStoreColumn()} > ?")
+    args.add(value)
+  }
+
+  fun gte(field: AssetField, value: String) = apply {
+    clauses.add("${field.toMediaStoreColumn()} >= ?")
+    args.add(value)
+  }
+
+  fun lt(field: AssetField, value: String) = apply {
+    clauses.add("${field.toMediaStoreColumn()} < ?")
+    args.add(value)
+  }
+
+  fun lte(field: AssetField, value: String) = apply {
+    clauses.add("${field.toMediaStoreColumn()} <= ?")
+    args.add(value)
+  }
+
+  fun limit(limit: Int) = apply {
+    this.limit = limit
+  }
+
+  fun album(album: Album) = apply {
+    clauses.add("${MediaStore.MediaColumns.BUCKET_ID} = ?")
+    args.add(album.id)
+  }
+
+  fun offset(count: Int) = apply {
+    this.offset = count
+  }
+
+  fun orderBy(descriptor: SortDescriptor) = apply {
+    orderBy.add(descriptor)
+  }
+
+  suspend fun exe(): List<Asset> = withContext(Dispatchers.IO) {
+    val queryExecutor = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+      QueryModernExecutor(clauses, args, orderBy, limit, offset)
+    } else {
+      QueryLegacyExecutor(clauses, args, orderBy, limit, offset)
+    }
+    val projection = arrayOf(
+      MediaStore.Files.FileColumns._ID,
+      MediaStore.Files.FileColumns.MEDIA_TYPE
+    )
+
+    val cursor = queryExecutor.exe(projection, contentResolver)
+    return@withContext cursor.use {
+      ensureActive()
+      val idColumn = it.getColumnIndexOrThrow(MediaStore.Files.FileColumns._ID)
+      val typeColumn = it.getColumnIndexOrThrow(MediaStore.Files.FileColumns.MEDIA_TYPE)
+      it.asIterable()
+        .map { row -> row.extractAssetContentUri(idColumn, typeColumn) }
+        .map { uri -> Asset(uri, contextRef.getOrThrow()) }
+        .toList()
+    }
+  }
+}

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

@@ -0,0 +1,8 @@
+package expo.modules.medialibrary.next.objects.query.builder
+
+import android.content.ContentResolver
+import android.database.Cursor
+
+fun interface QueryExecutor {
+  suspend fun exe(projection: Array<String>, contentResolver: ContentResolver): Cursor
+}

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

@@ -0,0 +1,73 @@
+package expo.modules.medialibrary.next.objects.query.builder
+
+import android.content.ContentResolver
+import android.database.Cursor
+import android.os.Build
+import android.provider.MediaStore
+import androidx.annotation.DeprecatedSinceApi
+import expo.modules.medialibrary.next.exceptions.QueryCouldNotBeExecuted
+import expo.modules.medialibrary.next.extensions.resolver.EXTERNAL_CONTENT_URI
+import expo.modules.medialibrary.next.records.SortDescriptor
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+@DeprecatedSinceApi(Build.VERSION_CODES.Q)
+class QueryLegacyExecutor(
+  private val clauses: MutableList<String>,
+  private val args: MutableList<String>,
+  private val sortDescriptors: MutableList<SortDescriptor>,
+  private val limit: Int?,
+  private val offset: Int?
+) : QueryExecutor {
+  override suspend fun exe(
+    projection: Array<String>,
+    contentResolver: ContentResolver
+  ): Cursor = withContext(Dispatchers.IO) {
+    val selection = buildSelection()
+    val sortOrder = buildSortOrder()
+    val selectionArgs = args.toTypedArray()
+    return@withContext contentResolver.query(EXTERNAL_CONTENT_URI, projection, selection, selectionArgs, sortOrder)
+      ?: throw QueryCouldNotBeExecuted("Cursor is null")
+  }
+
+  private fun buildSortOrder(): String {
+    var sortOrder = buildOrderBy()
+    sortOrder = addLimit(sortOrder)
+    return addOffset(sortOrder)
+  }
+
+  private fun buildSelection(): String {
+    return clauses.joinToString(" AND ")
+  }
+
+  private fun buildOrderBy(): String? {
+    return if (!sortDescriptors.isEmpty()) {
+      sortDescriptors.joinToString(", ") { it.toMediaStoreQueryString() }
+    } else {
+      null
+    }
+  }
+
+  private fun addLimit(sortOrder: String?): String {
+    return if (limit != null) {
+      requireNotEmptySortOrder(sortOrder) + " LIMIT $limit"
+    } else if (offset != null) {
+      // SQLITE: limit is required to perform offset
+      requireNotEmptySortOrder(sortOrder) + " LIMIT -1"
+    } else {
+      sortOrder ?: ""
+    }
+  }
+
+  private fun requireNotEmptySortOrder(sortOrder: String?): String {
+    return sortOrder ?: MediaStore.Files.FileColumns._ID
+  }
+
+  private fun addOffset(orderBy: String): String {
+    return if (offset != null) {
+      "$orderBy OFFSET $offset"
+    } else {
+      orderBy
+    }
+  }
+}

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

@@ -0,0 +1,72 @@
+package expo.modules.medialibrary.next.objects.query.builder
+
+import android.content.ContentResolver
+import android.content.ContentResolver.QUERY_ARG_LIMIT
+import android.content.ContentResolver.QUERY_ARG_OFFSET
+import android.content.ContentResolver.QUERY_ARG_SQL_SELECTION
+import android.content.ContentResolver.QUERY_ARG_SQL_SELECTION_ARGS
+import android.content.ContentResolver.QUERY_ARG_SQL_SORT_ORDER
+import android.database.Cursor
+import android.os.Build
+import android.os.Bundle
+import androidx.annotation.RequiresApi
+import expo.modules.medialibrary.next.exceptions.QueryCouldNotBeExecuted
+import expo.modules.medialibrary.next.extensions.resolver.EXTERNAL_CONTENT_URI
+import expo.modules.medialibrary.next.records.SortDescriptor
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+@RequiresApi(Build.VERSION_CODES.R)
+class QueryModernExecutor(
+  private var clauses: MutableList<String>,
+  private var args: MutableList<String>,
+  private val sortDescriptors: MutableList<SortDescriptor>,
+  private val limit: Int?,
+  private val offset: Int?
+) : QueryExecutor {
+  override suspend fun exe(
+    projection: Array<String>,
+    contentResolver: ContentResolver
+  ): Cursor = withContext(Dispatchers.IO) {
+    val queryArgs = build()
+    return@withContext contentResolver.query(EXTERNAL_CONTENT_URI, projection, queryArgs, null)
+      ?: throw QueryCouldNotBeExecuted("Cursor is null")
+  }
+
+  private fun build(): Bundle {
+    val selection = buildSelection()
+    val selectionArgs = args.toTypedArray()
+    val sortOrder = buildSortOrder()
+    return Bundle().apply {
+      limit?.let { putInt(QUERY_ARG_LIMIT, it) }
+      offset?.let {
+        // SQLITE: limit is required to perform offset
+        if (limit == null) {
+          putInt(QUERY_ARG_LIMIT, -1)
+        }
+        putInt(QUERY_ARG_OFFSET, it)
+      }
+      selection?.let {
+        putString(QUERY_ARG_SQL_SELECTION, it)
+        putStringArray(QUERY_ARG_SQL_SELECTION_ARGS, selectionArgs)
+      }
+      sortOrder?.let {
+        putString(QUERY_ARG_SQL_SORT_ORDER, it)
+      }
+    }
+  }
+
+  private fun buildSelection(): String? {
+    if (clauses.isEmpty()) {
+      return null
+    }
+    return clauses.joinToString(" AND ")
+  }
+
+  private fun buildSortOrder(): String? {
+    if (sortDescriptors.isEmpty()) {
+      return null
+    }
+    return sortDescriptors.joinToString(", ") { it.toMediaStoreQueryString() }
+  }
+}

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

@@ -0,0 +1,55 @@
+package expo.modules.medialibrary.next.objects.wrappers
+
+import android.net.Uri
+import android.provider.MediaStore
+import expo.modules.kotlin.types.Enumerable
+
+enum class MediaType(val value: String) : Enumerable {
+  AUDIO("audio"),
+  IMAGE("image"),
+  VIDEO("video"),
+  UNKNOWN("unknown");
+
+  fun toMediaStoreValue(): Int {
+    return when (this) {
+      AUDIO -> MediaStore.Files.FileColumns.MEDIA_TYPE_AUDIO
+      IMAGE -> MediaStore.Files.FileColumns.MEDIA_TYPE_IMAGE
+      VIDEO -> MediaStore.Files.FileColumns.MEDIA_TYPE_VIDEO
+      UNKNOWN -> MediaStore.Files.FileColumns.MEDIA_TYPE_NONE
+    }
+  }
+
+  companion object {
+    fun fromString(string: String): MediaType {
+      return when (string.lowercase()) {
+        "audio" -> AUDIO
+        "image" -> IMAGE
+        "video" -> VIDEO
+        else -> UNKNOWN
+      }
+    }
+
+    fun fromMediaStoreValue(mediaStoreValue: Int): MediaType {
+      return when (mediaStoreValue) {
+        MediaStore.Files.FileColumns.MEDIA_TYPE_AUDIO -> AUDIO
+        MediaStore.Files.FileColumns.MEDIA_TYPE_IMAGE -> IMAGE
+        MediaStore.Files.FileColumns.MEDIA_TYPE_VIDEO -> VIDEO
+        else -> UNKNOWN
+      }
+    }
+
+    fun fromContentUri(contentUri: Uri): MediaType {
+      val pathSegments = contentUri.pathSegments
+      if (pathSegments.contains("images")) {
+        return IMAGE
+      }
+      if (pathSegments.contains("video")) {
+        return VIDEO
+      }
+      if (pathSegments.contains("audio")) {
+        return AUDIO
+      }
+      return UNKNOWN
+    }
+  }
+}

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

@@ -0,0 +1,23 @@
+package expo.modules.medialibrary.next.records
+
+import android.provider.MediaStore
+import expo.modules.kotlin.types.Enumerable
+
+enum class AssetField(val key: String) : Enumerable {
+  CREATION_TIME("creationTime"),
+  MODIFICATION_TIME("modificationTime"),
+  MEDIA_TYPE("mediaType"),
+  WIDTH("width"),
+  HEIGHT("height"),
+  DURATION("duration");
+
+  fun toMediaStoreColumn(): String =
+    when (this) {
+      CREATION_TIME -> MediaStore.Images.Media.DATE_TAKEN
+      MODIFICATION_TIME -> MediaStore.Images.Media.DATE_MODIFIED
+      MEDIA_TYPE -> MediaStore.Files.FileColumns.MEDIA_TYPE
+      WIDTH -> MediaStore.MediaColumns.WIDTH
+      HEIGHT -> MediaStore.MediaColumns.HEIGHT
+      DURATION -> MediaStore.Video.VideoColumns.DURATION
+    }
+}

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

@@ -0,0 +1,14 @@
+package expo.modules.medialibrary.next.records
+
+import expo.modules.kotlin.records.Field
+import expo.modules.kotlin.records.Record
+
+data class SortDescriptor(
+  @Field val key: AssetField,
+  @Field val ascending: Boolean? = true
+) : Record {
+  fun toMediaStoreQueryString(): String {
+    val ascendingString = if (ascending ?: true) "ASC" else "DESC"
+    return "${key.toMediaStoreColumn()} $ascendingString"
+  }
+}

package/build/next/ExpoMediaLibraryNext.d.ts

@@ -1,8 +1,11 @@
 import { NativeModule } from 'expo-modules-core';
-import type { Asset, Album } from './MediaLibraryNext.types';
+import { Album } from './types/Album';
+import { Asset } from './types/Asset';
+import { Query } from './types/Query';
 declare class ExpoMediaLibraryNextModule extends NativeModule {
     Asset: typeof Asset;
     Album: typeof Album;
+    Query: typeof Query;
 }
 declare const _default: ExpoMediaLibraryNextModule;
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoMediaLibraryNext.d.ts","sourceRoot":"","sources":["../../src/next/ExpoMediaLibraryNext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,OAAO,0BAA2B,SAAQ,YAAY;IAC3D,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;;AAED,wBAAuF"}
+{"version":3,"file":"ExpoMediaLibraryNext.d.ts","sourceRoot":"","sources":["../../src/next/ExpoMediaLibraryNext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,OAAO,0BAA2B,SAAQ,YAAY;IAC3D,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;;AAED,wBAAuF"}